Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
Attributs calculés des profils clients Amazon Connect APIs
Vous pouvez utiliser l'attribut calculé des profils clients suivant APIs
CreateCalculatedAttributeDefinition
Créez un nouvel attribut calculé. Cela nécessite un type d'objet existant dans le domaine. Vous pouvez définir les attributs que vous souhaitez extraire d'un seul objet source et les opérations mathématiques à leur appliquer de manière agrégée, ainsi que la plage de temps et le nombre d'objets.
Après la création, les nouvelles données d'objet ingérées dans Profils des clients seront incluses dans l'attribut calculé, qui peut être récupéré pour un profil à l'aide de l'API GetCalculatedAttributeForProfile. La définition d'un attribut calculé le rend disponible pour tous les profils d'un domaine. Chaque attribut calculé ne peut référencer qu'un seul champ ObjectType et au plus deux à partir de celui-ci ObjectType.
Demande
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": {}
}
Réponse
{
"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": {}
}
Corps de la demande
-
CalculatedAttributeName
Le nom unique (par domaine) de l'attribut calculé.
-
Type : chaîne
-
Contraintes de longueur : longueur minimum de 1. Longueur maximale de 64.
-
Modèle :
^[a-zA-Z0-9_-]+$ -
Obligatoire : oui
-
-
DisplayName
Le nom d'affichage de l'attribut calculé.
-
Contraintes de longueur : longueur minimum de 1. Longueur maximale de 64.
-
Modèle :
^[a-zA-Z_][a-zA-Z_0-9-\s]*$ -
Obligatoire : non
-
-
Description
La description de l'attribut calculé.
-
Type : chaîne
-
Contraintes de longueur : longueur minimum de 1. Longueur maximum de 1 000.
-
Obligatoire : non
-
-
AttributeDetails
Les détails des attributs utilisés dans la définition et des opérations mathématiques impliquées entre les attributs. Consultez les composants suivants :
-
Attributs
Une liste des éléments d'attribut spécifiés dans l'expression mathématique.
-
AttributeItem
Les détails d'un élément d'attribut unique spécifié dans l'expression mathématique.
-
Nom
-
Le nom d'un attribut défini dans un type d'objet de profil.
-
Type : String
-
-
-
-
Expression
L'expression mathématique exécutée sur les éléments d'attribut fournis dans la liste d'attributs. Chaque élément de l'expression doit suivre la structure de \ "{ObjectTypeName. AttributeName} \ ».
-
Exemple:
{ObjA.AttributeA} - {ObjA.AttributeB} -
Type : chaîne
-
Nous prenons uniquement en charge les opérations mathématiques suivantes :
+ - * / -
Vous ne pouvez pas modifier l'expression une fois qu'une définition d'attribut calculée est créée
-
-
-
Conditions
Définit les critères et seuils d'agrégation d'attributs calculés.
-
Type : objet de conditions
-
Range
-
ObjectCount
-
Seuil
-
-
-
Range
La période relative pendant laquelle les données sont incluses dans l'agrégation.
-
Type : objet Range
-
Valeur : durée des unités spécifiées
-
Unité : unité de temps
-
Valeurs valides : jours
-
-
-
Obligatoire : oui
-
Portée initiale : 366 jours maximum
-
-
ObjectCount
Le nombre d'objets de profil utilisés pour l'attribut calculé.
-
Type : nombre
-
Plage : 1 à 100
-
Obligatoire : non
-
-
Threshold
La logique de comparaison pour générer un attribut calculé true/false.
-
Type : objet Threshold
-
Valeur
-
La valeur du seuil
-
Type : chaîne
-
Obligatoire : non
-
-
Opérateur
-
L'opérateur du seuil
-
Type : ENUM
-
Valeurs valides :
-
GREATER_THAN
-
LESS_THAN
-
EQUAL_TO
-
NOT_EQUAL_TO
-
-
-
-
Obligatoire : non
-
-
Statistique
L'opération d'agrégation à effectuer pour l'attribut calculé.
-
Type : ENUM
-
Valeurs valides :
-
FIRST_OCCURRENCE
-
LAST_OCCURRENCE
-
COUNT
-
SUM
-
MINIMUM
-
MAXIMUM
-
AVERAGE
-
MAX_OCCURRENCE
-
-
