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

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

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

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

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

步驟 1：建立 JSON 檔案

使用下列內容建立檔案：


{
"DomainName": "your-domain-name", 
   "CalculatedAttributeName": "your-calculated-attribute-name",
   "UseHistoricalData": true,
   "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": {
        "ValueRange"
        {
            "Start": your-range-start
            "End": your-range-end
        },
        "TimestampSource": "{your-object-type.your-timestamp-source}",          
        "Unit": "days"
        },
        "ObjectCount":  your-object-count,
        "Threshold": {
           "Value": "your-threshold-value",
           "Operator": "your-threshold-operator"
        }
   }  
}

若要使用您自己的值來自訂 JSON，請遵循下列指示：

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

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

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

    支援的統計

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

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

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

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

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

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

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

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

  • 範圍：

    • 單位：目前僅支援 DAYS 單位。

    • ValueRange：在 ValueRange 的開始或結束欄位中指定正數，以指定應從幾天前開始，或使用負數指定應從未來幾天開始。

    • TimestampSource：指定 JSON 物件中應剖析日期欄位的運算式。運算式應遵循以下結構：\"{ObjectTypeName.<Location of timestamp field in JSON pointer format>}\"。例如，如果您的物件類型是 MyType，而來源 JSON 為 {"generatedAt": {"timestamp": "1737587945945"}}，則 TimestampSource 應為 "{MyType.generatedAt.timestamp}"。

  • ObjectCount：指出應根據計算屬性計算的物件數目。

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

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

    • GREATER_THAN

    • LESS_THAN

    • EQUAL_TO

    • NOT_EQUAL_TO

  • UseHistoricalData：建立計算屬性前擷取的歷史資料是否應包含在計算中。

步驟 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