UI에서 XDM 필드 정의

Adobe Experience Platform 사용자 인터페이스의 Schema Editor을(를) 사용하면 사용자 지정 XDM(경험 데이터 모델) 클래스와 스키마 필드 그룹 내에서 고유한 필드를 정의할 수 있습니다. 이 안내서에서는 각 필드 유형에 사용할 수 있는 구성 옵션을 포함하여 UI에서 XDM 필드를 정의하는 단계를 다룹니다.

전제 조건

이 안내서에서는 XDM 시스템에 대한 작업 이해가 필요합니다. Experience Platform 에코시스템 내에서 XDM의 역할에 대한 소개와 스키마 컴포지션의 기본 사항을(를) 참조하여 클래스와 필드 그룹이 XDM 스키마에 필드를 기여하는 방법을 알아보십시오. XDM 개요.

이 안내서에서는 필요하지 않지만 UI에서 스키마 작성에 대한 자습서를 따라 Schema Editor의 다양한 기능을 숙지하는 것이 좋습니다.

필드를 추가할 리소스 선택 select-resource

UI에서 새 XDM 필드를 정의하려면 먼저 Schema Editor 내에서 스키마를 열어야 합니다. 현재 Schema Library에서 사용할 수 있는 스키마에 따라 새 스키마를 만들거나 편집할 기존 스키마를 선택할 수 있습니다.

Schema Editor을(를) 열면 필드를 추가할 컨트롤이 캔버스에 나타납니다. 이러한 컨트롤은 선택한 클래스 또는 필드 그룹 아래에 정의된 개체 유형 필드뿐 아니라 스키마 이름 옆에 나타납니다.

리소스에 새 필드를 추가하려면 캔버스에서 스키마 이름 옆에 있는 더하기(+) 아이콘을 선택하거나 아래에 필드를 정의할 개체 유형 필드 옆에 있는 아이콘을 선택합니다.

필드를 스키마에 직접 추가하는지 또는 구성 클래스 및 필드 그룹에 추가하는지에 따라 필드를 추가하는 데 필요한 단계가 달라집니다. 이 문서의 나머지 부분에서는 스키마에서 필드가 나타나는 위치에 관계없이 필드의 속성을 구성하는 방법을 중점적으로 다룹니다. 스키마에 필드를 추가할 수 있는 다양한 방법에 대한 자세한 내용은 스키마 UI 안내서의 다음 섹션을 참조하십시오.

필드의 속성 정의 define

더하기(+) 아이콘을 선택하면 캔버스에 Untitled field 자리 표시자가 나타납니다.

Field properties 아래의 오른쪽 레일에서 새 필드의 세부 정보를 구성할 수 있습니다. 각 필드에 다음 정보가 필요합니다.

각 필드에 대한 설명 및 메모를 제공하도록 선택할 수도 있습니다. Description 필드를 사용하여 컨텍스트를 추가하고 맵 데이터 형식의 기능을 설명합니다. 이는 구현의 유지 관리 및 가독성에 기여합니다. 초기 설명을 보완하기 위해 메모를 추가할 수도 있습니다. 개발자가 코드 베이스의 컨텍스트 내에서 맵을 효과적으로 이해, 유지 관리 및 활용하는 데 도움이 되는 보다 세분화되고 구체적인 정보를 제공해야 합니다. |

필드 구성을 마치면 Apply​을(를) 선택합니다.

캔버스는 고유한 테넌트 ID로 네임스페이스가 지정된 개체 내에 있는 새로 추가된 필드를 표시하도록 업데이트됩니다(아래 예에서 _tenantId(으)로 표시됨). Adobe에서 제공한 클래스 및 필드 그룹의 다른 필드와의 충돌을 방지하기 위해 스키마에 추가되는 모든 사용자 지정 필드는 이 네임스페이스 내에 자동으로 배치됩니다. 이제 오른쪽 레일에 다른 속성 외에도 필드의 경로가 나열됩니다.

위의 단계에 따라 스키마에 필드를 추가할 수 있습니다. 스키마가 저장되면 해당 기본 클래스와 필드 그룹도 변경된 경우 저장됩니다.

유형별 필드 속성 type-specific-properties

새 필드를 정의할 때 해당 필드에 대해 선택한 Type​에 따라 오른쪽 레일에 추가 구성 옵션이 나타날 수 있습니다. 다음 표에서는 이러한 추가 필드 속성과 해당 호환 유형에 대해 설명합니다.

Pattern, Format, 길이 또는 숫자 경계와 같은 속성은 구성된 경우 수집 중에 적용됩니다. Default value​은(는) 다릅니다. 정보 스키마 메타데이터를 기록하며 수집된 데이터의 유효성을 검사하거나 채우지 않습니다. 아래의 Default value 행과 표 다음에 나오는 메모를 참조하십시오.

필드 속성

호환 가능한 유형

설명

Map value type

Map

Type 드롭다운 옵션에서 맵 값을 선택한 경우에만 Map value type 속성이 UI에 표시됩니다. 맵의 문자열 및 정수 값 형식 중에서 선택할 수 있습니다.
{width="100" modal="regular"}
참고: API를 통해 만들어진 모든 맵 데이터 형식이 String 또는 Integer 유형이 아닌 경우 ‘Complex’ 데이터 형식으로 표시됩니다. UI를 통해 ‘Complex’ 데이터 형식을 만들 수 없습니다.

Pattern

String

수집 중에 수락하려면 이 필드의 값이 준수해야 하는 정규 표현식입니다.

Format

String

값이 준수해야 하는 문자열의 사전 정의된 형식 목록에서 선택합니다. 사용 가능한 형식은 다음과 같습니다.

• date-time
• email
• hostname
• ipv4
• ipv6
• uri
• uri-reference
• url-template
• json-pointer

Minimum length

String

수집 중에 값을 수락하기 위해 문자열에 포함해야 하는 최소 문자 수입니다.

Maximum length

String

수집 중에 값을 수락하기 위해 문자열에 포함해야 하는 최대 문자 수입니다.

Minimum value

Double

수집 중에 수락될 Double의 최소값입니다. 수집된 값이 여기에 입력한 값과 정확히 일치하는 경우 값이 수락됩니다. 이 제약 조건을 사용할 때는 “Exclusive minimum value” 제약 조건을 비워 두어야 합니다.

Maximum value

Double

수집 중에 수락할 Double의 최대값입니다. 수집된 값이 여기에 입력한 값과 정확히 일치하는 경우 값이 수락됩니다. 이 제약 조건을 사용할 때는 “Exclusive maximum value” 제약 조건을 비워 두어야 합니다.

Exclusive minimum value

Double

수집 중에 수락할 Double의 최대값입니다. 수집한 값이 여기에 입력한 값과 정확히 일치하는 경우 값이 거부됩니다. 이 제약 조건을 사용할 때는 “Minimum value”(비제외) 제약 조건을 비워 두어야 합니다.

Exclusive maximum value

Double

수집 중에 수락할 Double의 최대값입니다. 수집한 값이 여기에 입력한 값과 정확히 일치하는 경우 값이 거부됩니다. 이 제약 조건을 사용할 때는 “Maximum value”(비제외) 제약 조건을 비워 두어야 합니다.

Default value

JSON 스키마 default을(를) 지원하는 스키마 편집기의 스칼라 유형(String 및 Boolean)

JSON 스키마 default 의미 체계에 정렬되고 스키마 정의에 저장된 정보 메타데이터입니다. 구성된 값은 수집 또는 데이터 준비 흐름 동안 자동으로 적용되지 않습니다. 생략된 필드는 데이터 흐름에서 명시적으로 매핑되거나 변환되지 않는 한 존재하지 않습니다. 필수 필드 정의를 참조하세요.

특수 필드 유형 special

오른쪽 레일은 선택한 필드에 대해 특수 역할을 지정하는 데 사용할 수 있는 몇 가지 확인란을 제공합니다. 이러한 옵션 중 일부의 사용 사례에는 데이터 모델링 전략과 다운스트림 Experience Platform 서비스를 사용하는 방법에 관한 중요한 고려 사항이 포함됩니다.

이러한 특수 유형에 대한 자세한 내용은 다음 설명서를 참조하십시오.

기술적으로 특별한 필드 유형은 아니지만 스키마 구조가 중첩된 하위 필드를 정의하는 방법에 대해 자세히 알아보려면 개체 유형 필드 정의에 대한 안내서를 참조하는 것이 좋습니다.

다음 단계

이 안내서에서는 UI에서 XDM 필드를 정의하는 방법에 대한 개요를 제공했습니다. 필드는 클래스 및 필드 그룹을 사용하여 스키마에만 추가할 수 있습니다. UI에서 이러한 리소스를 관리하는 방법에 대한 자세한 내용은 클래스 및 필드 그룹 만들기 및 편집에 대한 안내서를 참조하세요.

Schemas 작업 영역의 기능에 대한 자세한 내용은 Schemas 작업 영역 개요를 참조하십시오.