翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# Amazon Connect Customer Profiles のカスタムの計算属性定義を作成する
<a name="customerprofiles-calculated-attributes-creating-definition"></a>

Customer Profiles の [CreateCalculatedAttributeDefinition](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_CreateCalculatedAttributeDefinition.html) API を使用すると、カスタムオブジェクトタイプに基づいて独自の計算された属性をプログラムで作成できます。

このトピックでは、カスタム JSON ファイルを使用して計算された属性を作成する方法を示します。

## ステップ 1: JSON ファイルを作成する
<a name="step1-calculate-attribute-api"></a>

次の内容を含む 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 を独自の値でカスタマイズするには、以下のガイドラインに従います。
+ **属性**:これには、計算された属性に使用するオブジェクトタイプのフィールドの名前が含まれている必要があります。このリストで参照されている 2 つの属性がサポートされています。
+ **式**: 属性間で実行する基本的な数式がサポートされています。属性が 1 つしかない場合はこのフィールドに `{ObjectTypeName.AttributeName}`、それ以外の数式を念頭に置いている場合は、このフィールドには両方の属性を含める必要があります。
+ **統計**: これは、実際に集計操作を実行する計算 API のいずれかを呼び出す時に実行される操作です。ほとんどは一目瞭然ですが、そうでないものについては説明を追加しました。

  **サポート対象の統計情報**
  + `FIRST_OCCURRENCE` は、最も古い取り込みオブジェクトの式で指定された属性を返します。
  + `LAST_OCCURRENCE` は、最新の取り込みオブジェクトの式で指定された属性を返します。
  + `COUNT` は、選択したデータからカウントを返します。
  + `SUM` は、選択したデータの合計を返します。
  + `MINIMUM` は、選択したデータから最小値を返します。
  + `MAXIMUM` は、選択したデータから最大値を返します。
  + `AVERAGE` は、選択したデータから平均を返します。
  + `MAX_OCCURRENCE` は、式で指定されている最も頻繁に出現する値を返します。
+ **範囲**:
  + 単位: 現在は DAYS 単位のみをサポートしています。
  + ValueRange: ValueRange の開始または終了フィールドに、開始する日付までの日数を示す正の数値と、開始する将来の日付までの日数を示す負の数値を指定します。
  + TimestampSource: 日付を解析する JSON オブジェクトのフィールドを指定する式。式は \$1"\$1ObjectTypeName.<Location of timestamp field in JSON pointer format>\$1\$1" の構造に従う必要があります。例えば、オブジェクトタイプが MyType で、ソース JSON が `{"generatedAt": {"timestamp": "1737587945945"}}` の場合、TimestampSource は `"{MyType.generatedAt.timestamp}"` である必要があります。
+ **ObjectCount**: 計算された属性計算の基準となるオブジェクトの数を示します。
+ **しきい値**: 正確に計算された属性値の代わりに、例えば特定の値よりも大きいかどうかを知りたい場合は、しきい値を使用できます。

  しきい値には任意の文字列を指定でき、次のしきい値演算子がサポートされています。
  + `GREATER_THAN`
  + `LESS_THAN`
  + `EQUAL_TO`
  + `NOT_EQUAL_TO`
+ UseHistoricalData: 計算属性の作成前に取り込まれた履歴データを計算に含めるかどうか。

## ステップ 2: CreateCalculatedAttributeDefinition API を呼び出す
<a name="step2-calculated-attribute-api"></a>

値を使用して JSON ファイルを作成し、カスタマイズしたら、次の例に示すように [CreateCalculatedAttributeDefinition](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_CreateCalculatedAttributeDefinition.html) 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
```