Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.
Berechnete Attribute von Amazon Connect Connect-Kundenprofilen APIs
Sie können das folgende berechnete Attribut „Kundenprofile“ verwenden APIs
CreateCalculatedAttributeDefinition
Erstellen eines neuen berechneten Attributs. Hierfür ist ein vorhandener Objekttyp in der Domain erforderlich. Sie können Attribute, die Sie aus einem einzelnen Quellobjekt abrufen möchten sowie die mathematischen Operationen, die insgesamt angewendet werden sollen, den Zeitraum und die Anzahl der Objekte definieren.
Nach der Erstellung werden neue Objektdaten, die in Customer Profiles aufgenommen werden, in das berechnete Attribut mit einbezogen, das dann mithilfe der GetCalculatedAttributeForProfile-API für ein Profil abgerufen werden kann. Sobald ein berechnetes Attribut definiert wurde, wird es für alle Profile innerhalb einer Domain verfügbar. Jedes berechnete Attribut kann nur auf ein ObjectType und höchstens zwei Felder aus diesem Feld verweisen ObjectType.
Anforderung
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": {}
}
Antwort
{
"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": {}
}
Anforderungstext
-
CalculatedAttributeName
Der eindeutige (pro Domain) Name des berechneten Attributs.
-
Typ: Zeichenfolge
-
Längenbeschränkungen: Minimale Länge beträgt 1 Zeichen. Maximale Länge beträgt 64 Zeichen.
-
Pattern:
^[a-zA-Z0-9_-]+$ -
Erforderlich: Ja
-
-
DisplayName
Der Anzeigename des berechneten Attributs.
-
Längenbeschränkungen: Minimale Länge beträgt 1 Zeichen. Maximale Länge beträgt 64 Zeichen.
-
Pattern:
^[a-zA-Z_][a-zA-Z_0-9-\s]*$ -
Erforderlich: Nein
-
-
Beschreibung
Die Beschreibung des berechneten Attributs.
-
Typ: Zeichenfolge
-
Längenbeschränkungen: Minimale Länge beträgt 1 Zeichen. Höchstlänge = 1 000 Zeichen.
-
Erforderlich: Nein
-
-
AttributeDetails
Einzelheiten zu den in der Definition verwendeten Attributen und den mathematischen Operationen zwischen den Attributen. Beachten Sie die folgenden Komponenten:
-
Attribute
Eine Liste von Attributelementen, die im mathematischen Ausdruck angegeben sind.
-
AttributeItem
Die Details zu einem einzelnen Attributelement, das im mathematischen Ausdruck angegeben ist.
-
Name
-
Der Name eines Attributs, das in einem Profilobjekttyp definiert ist.
-
Typ: Zeichenfolge
-
-
-
-
Expression
Mathematischer Ausdruck, der für Attributelemente in der Attributliste ausgeführt wird. Jedes Element im Ausdruck sollte der Struktur von\ "{folgenObjectTypeName. AttributeName}\“.
-
Beispiel:
{ObjA.AttributeA} - {ObjA.AttributeB} -
Typ: Zeichenfolge
-
Wir unterstützen ausschließlich die folgenden mathematischen Operationen:
+ - * / -
Nach der Erstellung einer berechneten Attributdefinition kann der Ausdruck nicht mehr geändert werden
-
-
-
Bedingungen
Definiert die Kriterien und den Schwellenwert für die Aggregation von berechneten Attributen.
-
Typ: Bedingungsobjekt
-
Bereich
-
ObjectCount
-
Threshold
-
-
-
Bereich
Der relative Zeitraum, während dem Daten in der Aggregation berücksichtigt werden.
-
Typ: Range-Objekt
-
Wert: Der Zeitraum für die angegebenen Einheiten
-
Einheit: Zeiteinheit
-
Gültige Werte: Tage
-
-
-
Erforderlich: Ja
-
Anfänglicher Geltungsbereich: Maximal 366 Tage
-
-
ObjectCount
Die Anzahl der für das berechnete Attribut verwendeten Profilobjekte.
-
Typ: Zahl
-
Range: 1 bis 100
-
Erforderlich: Nein
-
-
Threshold
Die Vergleichslogik zur Generierung eines berechneten Attributs „true/false“.
-
Typ: Threshold-Objekt
-
Wert
-
Der Schwellenwert.
-
Typ: Zeichenfolge
-
Erforderlich: Nein
-
-
Operator
-
Der Operator des Schwellenwerts
-
Typ: ENUM
-
Zulässige Werte:
-
GREATER_THAN
-
LESS_THAN
-
EQUAL_TO
-
NOT_EQUAL_TO
-
-
-
-
Erforderlich: Nein
-
-
Statistik
Der für das berechnete Attribut auszuführende Aggregationsvorgang.
-
Typ: ENUM
-
Zulässige Werte:
-
FIRST_OCCURRENCE
-
LAST_OCCURRENCE
-
COUNT
-
SUM
-
MINIMUM
-
MAXIMUM
-
AVERAGE
-
MAX_OCCURRENCE
-
-
