建立自訂 Amazon Connect Customer Profiles 計算的屬性定義 - Amazon Connect
步驟 1：建立JSON檔案步驟 2：呼叫 CreateCalculatedAttributeDefinition

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

建立自訂 Amazon Connect Customer Profiles 計算的屬性定義

使用客戶設定檔 CreateCalculatedAttributeDefinition API，您可以根據自訂物件類型，以程式設計方式建立自己的計算屬性。

在本主題中，我們會示範如何使用自訂JSON檔案建立計算屬性。

步驟 1：建立JSON檔案

建立具有下列內容JSON的檔案：


{
   "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"
		}
   }  
}

若要JSON使用您自己的值自訂 ，請遵循下列準則：

  • 屬性：這應包含您要用於計算屬性之物件類型中的欄位名稱。支援此清單中參照的兩個屬性。

  • 運算式：支援在屬性之間執行的基本數學運算式。如果您只有一個屬性，則此欄位應該是 {ObjectTypeName.AttributeName}，否則如果您有數學運算式，則此欄位應包含這兩個屬性。

  • 統計資料 ：這是當您呼叫APIs其中一個實際執行彙總操作的 計算時所執行的操作。大多數都是不言自明的，但我們已經為那些不清楚的添加了解釋。

    支援的統計

    • FIRST_OCCURRENCE 傳回在最早擷取物件的運算式中指定的屬性。

    • LAST_OCCURRENCE 傳回在最新擷取物件的運算式中指定的屬性。

    • COUNT 從選擇的資料傳回計數。

    • SUM 從選擇的資料傳回總和。

    • MINIMUM 從選擇的資料傳回最小值。

    • MAXIMUM 從選擇的資料傳回最大值。

    • AVERAGE 從選擇的資料傳回平均值。

    • MAX_OCCURRENCE 返回表達式中所指定，出現最頻繁的值。

  • 範圍 ：目前支援DAYS和計算的屬性最多可以 366 天的資料為基礎。

  • ObjectCount：指示計算的屬性計算應依據多少物件。支援的值為 1-100。

  • Threshold：如果您想知道它是否大於特定值，而不是確切的計算屬性值，則可以使用閾值。

    閾值可以是任何字串，且支援下列閾值運算子。

    • GREATER_THAN

    • LESS_THAN

    • EQUAL_TO

    • NOT_EQUAL_TO

步驟 2：呼叫 CreateCalculatedAttributeDefinition API

使用值建立並自訂JSON檔案後，請呼叫 CreateCalculatedAttributeDefinition API，如下列範例所示：

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

也可以使用以下端點：

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