Erstellen eine benutzerdefinierten Definition für berechnete Attribute

Mithilfe der Kundenprofile CreateCalculatedAttributeDefinitionAPIkönnen Sie programmgesteuert Ihr eigenes berechnetes Attribut erstellen, das auf einem benutzerdefinierten Objekttyp basiert.

In diesem Thema zeigen wir, wie Sie mithilfe einer benutzerdefinierten JSON Datei ein berechnetes Attribut erstellen.

Schritt 1: Erstellen Sie eine JSON Datei

Erstellen Sie eine JSON Datei mit dem folgenden Inhalt:

{
   "DomainName": "your-domain-name", 
   "CalculatedAttributeName": "your-calculated-attribute-name",
   "DisplayName": "your-display-name",
   "Description": "your-description",
   "AttributeDetails": {
      "Attributes": [
	     {
		    "Name": "your-attribute-name"
	     }
	   ],
	   "Expression": "{your-object-type.your-attribute-name}"
   },
	"Statistic": "your-statistic",
	"Conditions": {
	   "Range": {
	      "Value": your-range-value,
		  "Unit": "days"
		},
		"ObjectCount": your-object-count,
		"Threshold": {
		   "Value": "your-threshold-value",
		   "Operator": "your-threshold-operator"
		}
   }  
}   

Folgen Sie diesen Richtlinien, um die JSON mit Ihren eigenen Werten anzupassen:

• Attribute: Sollte den Namen des Felds aus Ihrem Objekttyp enthalten, den Sie für das berechnete Attribut verwenden möchten. Zwei Attribute in dieser Liste werden unterstützt.

• Ausdruck: Grundlegende, zwischen Attributen auszuführende mathematische Ausdrücke werden unterstützt. Wenn Sie nur ein Attribut haben, sollte dieses Feld „{ObjectTypeName.AttributeName}“ sein. Wenn Sie einen eigenen mathematischen Ausdruck haben wollen, sollte dieses Feld beide Attribute enthalten.

• Statistik: Dies ist die Operation, die ausgeführt wird, wenn Sie eine der Berechnungen aufrufenAPIs, die den Aggregationsvorgang tatsächlich durchführt. Die meisten sind selbsterklärend, aber wir haben Erklärungen für diejenigen hinzugefügt, bei denen dies nicht der Fall ist.

  Unterstützte Statistiken

  • FIRST_OCCURRENCE gibt das Attribut zurück, das im Ausdruck des frühesten aufgenommenen Objekts angegeben ist.

  • LAST_OCCURRENCE gibt das Attribut zurück, das im Ausdruck des zuletzt aufgenommenen Objekts angegeben ist.

  • COUNT gibt die Anzahl der ausgewählten Daten zurück.

  • SUM gibt die Summe der ausgewählten Daten zurück.

  • MINIMUM gibt das Minimum der ausgewählten Daten zurück.

  • MAXIMUM gibt das Maximum der ausgewählten Daten zurück.

  • AVERAGE gibt den Durchschnittswert der ausgewählten Daten zurück.

  • MAX_OCCURRENCE gibt den am häufigsten vorkommenden Wert zurück, der im Ausdruck angegeben ist.

• Bereich: Derzeit können unterstützte DAYS und berechnete Attribute auf Daten von bis zu 366 Tagen basieren.

• ObjectCount: Gibt an, auf wie vielen Objekten die Berechnung der berechneten Attribute basieren soll. Werte von 1 bis 100 werden unterstützt.

• Threshold: Sie können einen Schwellenwert verwenden, wenn Sie anstatt des exakt berechneten Attributwerts beispielsweise wissen möchten, ob dieser über einem bestimmten Wert liegt.

  Der Schwellenwert kann eine beliebige Zeichenfolge sein, und die folgenden Schwellenwertoperatoren werden unterstützt.

  • GREATER_THAN

  • LESS_THAN

  • EQUAL_TO

  • NOT_EQUAL_TO

Schritt 2: Rufen Sie den CreateCalculatedAttributeDefinition API

Nachdem Sie die JSON Datei mit Ihren Werten erstellt und angepasst haben, rufen Sie die auf CreateCalculatedAttributeDefinitionAPI, wie im folgenden Beispiel gezeigt:

aws customer-profiles create-calculated-attribute-definition --cli-input-json file:///custom_calculated_attribute_cli.json --region region_name

Sie können außerdem den folgenden Endpunkt verwenden:

https://profile.your-region.amazonaws.com/domains/your-domain-name/calculated-attributes