기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# 사용자 지정 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을 사용자 지정하려면 다음 지침을 따르세요.
+ **속성**: 여기에는 계산된 속성에 사용할 객체 유형의 필드 이름이 포함되어야 합니다. 이 목록에서 참조되는 두 가지 속성이 지원됩니다.
+ **표현식**: 속성 간에 수행할 수 있는 기본 수학 표현식이 지원됩니다. 속성이 하나뿐인 경우에는 이 필드가 `{ObjectTypeName.AttributeName}`이어야 하고, 그렇지 않으며 수학 표현식을 염두에 두고 있는 경우 이 필드에 두 속성이 모두 포함되어야 합니다.
+ **통계**: 실제로 집계 작업을 수행하는 계산 API 중 하나를 호출할 때 수행되는 작업입니다. 대부분은 설명이 필요 없지만, 그렇지 않은 항목에 대한 설명을 추가했습니다.

  **지원되는 통계**
  + `FIRST_OCCURRENCE`는 가장 먼저 수집된 객체의 표현식에 지정된 속성을 반환합니다.
  + `LAST_OCCURRENCE`는 가장 최근에 수집된 객체의 표현식에 지정된 속성을 반환합니다.
  + `COUNT`는 선택한 데이터의 개수를 반환합니다.
  + `SUM`은 선택한 데이터의 합계를 반환합니다.
  + `MINIMUM`은 선택한 데이터의 최소값을 반환합니다.
  + `MAXIMUM`은 선택한 데이터의 최대값을 반환합니다.
  + `AVERAGE`는 선택한 데이터의 평균을 반환합니다.
  + `MAX_OCCURRENCE`는 표현식에 지정된 것 중 가장 자주 발생하는 값을 반환합니다.
+ **범위**:
  + 단위: 현재 DAYS 단위만 지원합니다.
  + ValueRange: ValueRange의 시작 또는 종료 필드에 양수를 지정하여 시작할 일수를 나타내고 음수는 향후 시작할 일수를 나타냅니다.
  + TimestampSource: 날짜를 구문 분석해야 하는 JSON 객체의 필드를 지정하는 표현식입니다. 표현식은 "{ObjectTypeName.<JSON 포인터 형식>}\\"의 타임스탬프 필드 위치입니다. 예를 들어 객체 유형이 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
```