UI에서 열거형 및 제안 값 정의 enums-and-suggested-values
XDM(Experience Data Model)에서 문자열 필드에는 해당 필드에 수집되는 값이나 세그먼테이션에서 작동 방식을 보다 잘 제어할 수 있도록 사전 정의된 허용 또는 제안 값 집합이 제공될 수 있습니다.
열거형 은(는) 문자열 필드에 대해 수집할 수 있는 값을 사전 정의된 집합으로 제한합니다. 열거형 필드에 데이터를 수집하려고 하는데 값이 해당 구성에 정의된 값과 일치하지 않으면 수집이 거부됩니다.
열거형과 달리 제안 값 옵션을 사용하면 수집할 수 있는 값을 제한하지 않는 문자열 필드의 권장 값 집합을 표시할 수 있습니다. 대신 제안된 값은 문자열 필드를 특성으로 포함할 때 세그먼테이션 UI에서 사용할 수 있는 사전 정의된 값에 영향을 줍니다.
Adobe Experience Platform 사용자 인터페이스에서 새 필드를 정의하고 형식을 String (으)로 설정하면 해당 필드에 대해 enum 또는 제안 값을(를) 정의할 수 있는 옵션이 제공됩니다.
이 문서에서는 스키마 UI 작업 영역에서 열거형 및 제안 값을 정의하는 방법을 다룹니다. UI에서 열거형을 구성하는 방법 및 다운스트림 효과를 포함하여 열거형 및 제안된 값에 대한 빠른 개요는 다음 비디오를 시청하십시오.
열거형 정의 enum
열거형 및 제안 값 을 선택한 다음 열거형 을 선택합니다. 열거형에 대한 값 제약 조건을 지정할 수 있는 추가 컨트롤이 나타납니다. 제약 조건을 추가하려면 행 추가 를 선택하십시오.
값 열 아래에서 필드를 제한할 정확한 값을 입력해야 합니다. 원할 경우 제약 조건에 대해 사용자에게 친숙한 표시 이름 을 제공할 수 있습니다. 이는 세그먼테이션에서 값이 표시되는 방식에 영향을 줍니다.
행 추가 를 사용하여 원하는 제약 조건 및 선택적 레이블을 열거형에 추가하거나 이전에 추가한 행 옆에 있는 삭제 아이콘(
변경 사항을 반영하도록 캔버스가 업데이트됩니다. 나중에 이 스키마를 탐색할 때 오른쪽 레일 내에서 열거형 필드에 대한 제약 조건을 보고 편집할 수 있습니다.
제안 값 정의 suggested-values
열거형 및 제안 값 을 선택한 다음 제안 값 을 선택하여 추가 컨트롤을 표시합니다. 제안 값을 추가하려면 행 추가 를 선택하십시오.
표시 이름 열 아래에서 세분화 UI에 표시할 값에 대해 사용자에게 친숙한 이름을 제공하십시오. 제안된 값을 더 추가하려면 행 추가 를 다시 선택하고 필요에 따라 프로세스를 반복합니다. 이전에 추가한 행을 제거하려면 해당 행 옆에 있는
완료되면 적용 을 선택하여 스키마에 변경 내용을 적용합니다.
표준 필드에 대한 제안 값 관리
표준 XDM 구성 요소의 일부 필드에는 XDM ExperienceEvent 클래스의 eventType과(와) 같이 제안된 자체 값이 포함되어 있습니다. 표준 필드에 대해 추가 제안 값을 생성할 수 있지만 조직에서 정의하지 않은 제안 값은 수정하거나 제거할 수 없습니다. UI에서 표준 필드를 볼 때 제안된 값이 표시되지만 읽기 전용입니다.
표준 필드에 대해 제안된 새 값을 추가하려면 행 추가 를 선택하십시오. 조직에서 이전에 추가한 제안 값을 제거하려면 해당 행 옆에 있는
열거형 및 제안된 값에 대한 진화 규칙 evolution
열거형 필드가 있는 스키마를 사용하여 데이터를 Platform으로 수집한 후 스키마 정의에 대한 추가 변경 사항은 시스템에 이미 있는 데이터를 준수해야 합니다. 일반적으로 기존 필드를 변경하면 해당 필드만 적게 제한할 수 있습니다. 필드는 이미 있는 것보다 더 제한적으로 만들 수 없습니다.
열거형 및 제안 값과 관련하여 다음 규칙이 사후 수집을 적용합니다.
- 기존의 제안 값을 사용하여 표준 및 사용자 지정 필드에 대해 제안된 값을 추가할 수 있습니다.
- 기존의 제안 값이 있는 사용자 지정 필드에서 제안 값을 CAN 제거합니다.
- 기존 사용자 지정 열거형 필드에 새 열거형 값을 CAN 추가할 수 있습니다.
- 사용자 지정 필드의 열거형 값을 제안 값으로만 전환하거나 열거형 또는 제안 값이 없는 문자열로 변환할 수 CAN. 이 스위치는 일단 적용되면 실행 취소할 수 없습니다.
- 표준 필드에서 열거형이나 제안 값을 제거할 수 없습니다.
- 기존 열거형이 없는 필드에 열거형 값을 추가할 수 없습니다.
- 사용자 지정 필드에 대한 기존 열거형 값 중 일부를 제거할 수 없습니다.
- CANNOT 은(는) 제안 값에서 열거형으로 전환할 수 없습니다.
열거형 및 제안 값에 대한 규칙 병합 merging
여러 스키마가 구성이 다른 동일한 열거형 필드를 사용하고 이러한 스키마가 유니온에 포함된 경우, 열거형 차이가 조정되는 방식과 관련하여 특정 규칙이 적용됩니다. 정확한 규칙은 스키마가 동일한 표준 필드(예: eventType)를 참조하는지 또는 스키마가 다른 필드 그룹의 동일한 사용자 지정 필드 경로를 참조하는지 여부에 따라 다릅니다.
동일한 표준 필드를 참조하는 경우:
- 추가로 제안된 값은 유니온에 APPEND 입니다.
- 동일한 열거형 키의 제안 값에 대한 업데이트는 유니온의 UPDATED 입니다.
다른 필드 그룹의 동일한 사용자 정의 필드 경로를 참조하는 경우:
- 추가로 제안된 값은 유니온에 APPEND 입니다.
- 두 개 이상의 스키마에 동일한 추가 제안 값이 정의된 경우 해당 값은 유니온의 MERGED 입니다. 즉, 병합 후 동일한 제안 값이 두 번 나타나지 않습니다.
유효성 검사 제한 사항
현재 시스템 제한으로 인해 수집 중에 시스템에서 열거형의 유효성을 검사하지 않는 두 가지 경우가 있습니다.
- 열거형은 배열 필드에 정의되어 있습니다.
- 열거형은 스키마 계층 구조 내에서 두 개 이상의 수준으로 정의됩니다.
다음 단계
이 안내서에서는 UI에서 문자열 필드에 대한 열거형 및 제안 값을 정의하는 방법을 다룹니다. 스키마 레지스트리 API를 사용하여 열거형 및 제안 값을 관리하는 방법에 대한 자세한 내용은 다음 자습서를 참조하십시오.
Schema Editor에서 다른 XDM 필드 유형을 정의하는 방법은 UI의 필드 정의에 대한 개요를 참조하세요.