As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
Atributos calculados dos perfis de clientes do Amazon Connect APIs
Você pode usar o seguinte atributo calculado de Perfis de Cliente APIs
CreateCalculatedAttributeDefinition
Crie um novo atributo calculado. Isso requer um tipo de objeto existente no domínio. Você pode definir os atributos que deseja extrair de um único objeto de origem e as operações matemáticas a serem aplicadas a eles de forma agregada, bem como o intervalo de tempo e a contagem de objetos.
Após a criação, novos dados de objetos ingeridos no Customer Profiles serão incluídos no atributo calculado, que pode ser recuperado para um perfil usando a API GetCalculatedAttributeForProfile
. A definição de um atributo calculado o disponibiliza para todos os perfis em um domínio. Cada atributo calculado só pode referenciar um ObjectType e no máximo dois campos a partir desse campo ObjectType.
Solicitação
POST /domains/
DomainName
/calculated-attributes/CalculatedAttributeName
{
"CalculatedAttributeName": "string",
"DisplayName": "string",
"Description": "string",
"AttributeDetails": {
"Attributes": [
{
"Name": "string"
}
...
],
"Expression": "string",
},
"Statistic": "AVERAGE" | "COUNT" | "SUM" | "FIRST_OCCURRENCE" | "LAST_OCCURRENCE" | "MINIMUM" | "MAXIMUM" | "MAX_OCCURRENCE",
"Conditions": {
"Range": {
"Value": "number",
"Units": "string"
},
"ObjectCount": "number",
"Threshold": {
"Value": "string",
"Operator": "EQUAL_TO" | "GREATER_THAN" | "LESS_THAN" | "NOT_EQUAL_TO"
}
},
"Tags": {}
}
Resposta
{
"CalculatedAttributeName": "string",
"DisplayName": "string",
"Description": "string",
"AttributeDetails": {
"Attributes": [
{
"Name": "string"
}
...
],
"Expression": "string",
},
"Statistic": "AVERAGE" | "COUNT" | "SUM" | "FIRST_OCCURRENCE" | "LAST_OCCURRENCE" | "MINIMUM" | "MAXIMUM" | "MAX_OCCURRENCE"
"Conditions": {
"Range": {
"Value": "number",
"Units": "string"
},
"ObjectCount": "number",
"Threshold": {
"Value": "string",
"Operator": "EQUAL_TO" | "GREATER_THAN" | "LESS_THAN" | "NOT_EQUAL_TO"
}
},
"CreatedAt": number,
"LastUpdatedAt": number,
"Tags": {}
}
Corpo da solicitação
-
CalculatedAttributeName
O nome exclusivo (por domínio) do atributo calculado.
-
Tipo: String
-
Restrições de Tamanho: tamanho mínimo 1. Comprimento máximo de 64.
-
Padrão:
^[a-zA-Z0-9_-]+$
-
Exigido: Sim
-
-
DisplayName
O nome de exibição do atributo calculado.
-
Restrições de Tamanho: tamanho mínimo 1. Comprimento máximo de 64.
-
Padrão:
^[a-zA-Z_][a-zA-Z_0-9-\s]*$
-
Obrigatório: não
-
-
Descrição
A descrição do atributo calculado.
-
Tipo: String
-
Restrições de Tamanho: tamanho mínimo 1. Tamanho máximo de 1.000.
-
Obrigatório: não
-
-
AttributeDetails
Detalhes dos atributos usados na definição e das operações matemáticas envolvidas entre os atributos. Consulte os seguintes componentes:
-
Atributos.
Uma lista de itens de atributos especificados na expressão matemática.
-
AttributeItem
Os detalhes de um item de atributo especificado na expressão matemática.
-
Name
-
O nome de um atributo definido em um tipo de objeto de perfil.
-
Tipo: string
-
-
-
-
Expressão
Expressão matemática executada em itens de atributos fornecidos na lista de atributos. Cada elemento na expressão deve seguir a estrutura de\ "{ObjectTypeName. AttributeName}\”.
-
Exemplo:
{ObjA.AttributeA} - {ObjA.AttributeB}
-
Tipo: String
-
Só oferecemos suporte às seguintes operações matemáticas:
+ - * /
-
Você não poderá fazer modificações na expressão depois que uma definição de atributo calculado for criada
-
-
-
Condições
Define os critérios e o limite calculados da agregação de atributos.
-
Tipo: objeto Conditions
-
Intervalo
-
ObjectCount
-
Limite
-
-
-
Intervalo
O período de tempo relativo durante o qual os dados são incluídos na agregação.
-
Tipo: objeto Range
-
Valor: o período das unidades especificadas
-
Unidade: unidade de tempo
-
Valores válidos: dias
-
-
-
Obrigatório: sim
-
Escopo inicial: máximo de 366 dias
-
-
ObjectCount
O número de objetos de perfil usados para o atributo calculado.
-
Tipo: número
-
Alcance: de 1 a 100
-
Obrigatório: não
-
-
Limite
A lógica de comparação para gerar um atributo calculado verdadeiro/falso.
-
Tipo: objeto Threshold
-
Valor
-
O valor do limite.
-
Tipo: String
-
Obrigatório: Não
-
-
Operador
-
O operador do limite
-
Tipo: ENUM
-
Valores válidos:
-
GREATER_THAN
-
LESS_THAN
-
EQUAL_TO
-
NOT_EQUAL_TO
-
-
-
-
Obrigatório: não
-
-
Estatística
A operação de agregação a ser executada para o atributo calculado.
-
Tipo: ENUM
-
Valores válidos:
-
FIRST_OCCURRENCE
-
LAST_OCCURRENCE
-
CONTAGEM
-
SUM
-
MINIMUM
-
MAXIMUM
-
AVERAGE
-
MAX_OCCURRENCE
-
-