UI에서 XDM 필드 정의

Adobe Experience Platform 사용자 인터페이스의 Schema Editor을 사용하면 XDM(사용자 지정 경험 데이터 모델) 클래스 및 혼합에서 자신의 필드를 정의할 수 있습니다. 이 안내서에서는 각 필드 유형에 대해 사용 가능한 구성 옵션을 포함하여 UI에서 XDM 필드를 정의하는 단계를 설명합니다.

전제 조건

이 가이드를 사용하려면 XDM 시스템에 대한 작업 이해가 필요합니다. Experience Platform 에코시스템 내의 XDM 역할에 대한 소개를 보려면 XDM 개요, 클래스 및 혼합이 XDM 스키마에 필드를 기여하는 방법에 대해 알아보려면 스키마 작성 기본 사항을 참조하십시오.

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

에 필드를 추가할 리소스를 선택합니다.

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

Schema Editor이(가) 열려 있으면 왼쪽 레일을 사용하여 필드를 정의할 클래스나 믹싱을 선택합니다. 리소스가 조직에서 정의한 사용자 지정 리소스인 경우 필드를 추가하거나 편집할 수 있는 컨트롤이 캔버스에 표시됩니다. 이러한 컨트롤은 스키마 이름 옆에 나타나고 선택한 클래스 또는 mixin 아래에 정의된 모든 개체 유형 필드도 나타납니다.

노트

선택한 클래스 또는 혼합이 Adobe에서 제공하는 핵심 리소스이면 편집할 수 없으므로 위에 표시된 컨트롤이 나타나지 않습니다. 필드를 추가하려는 스키마가 핵심 XDM 클래스를 기반으로 하고 사용자 정의 믹스를 포함하지 않는 경우 새 믹신을 만들어 대신 스키마에 추가할 수 있습니다.

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

리소스에 대한 필드 정의

plus (+) 아이콘을 선택하면 고유한 테넌트 ID에 이름이 지정된 루트 수준 개체(아래 예제의 _tenantId로 표시됨) 내에 있는 캔버스에 새 필드​가 나타납니다. 사용자 정의 클래스 및 혼합을 통해 스키마에 추가되는 모든 필드는 Adobe에서 제공하는 클래스 및 혼합에서 다른 필드와의 충돌을 방지하기 위해 이 네임스페이스 내에 자동으로 배치됩니다.

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

필드 속성 설명
필드 이름 필드의 고유한 수사적 이름입니다. 스키마를 저장한 후에는 필드 이름을 변경할 수 없습니다.

그 이름은 낙타케이스로 쓰는 것이 이상적이다. 여기에는 영숫자, 대시 또는 밑줄 문자가 포함될 수 있지만 은 밑줄로 시작할 수 없습니다.
  • 정답: fieldName
  • 허용 가능: field_name2, Field-Name, field-name_3
  • 오답: _fieldName
표시 이름 그 필드의 인간적인 이름.
유형 필드에 포함할 데이터의 유형입니다. 이 드롭다운 메뉴에서 XDM에서 지원하는 표준 스칼라 형식 또는 이전에 Schema Registry에 정의된 다중 필드 데이터 유형 중 하나를 선택할 수 있습니다.

고급 유형 검색을 선택하여 기존 데이터 유형을 검색 및 필터링하고 원하는 유형을 더 쉽게 찾을 수도 있습니다.

필드의 의도한 사용 사례에 대해 더 많은 컨텍스트를 제공하기 위해 선택적 사람이 읽을 수 있는 설명​을 필드에 제공할 수도 있습니다.

노트

필드에 대해 선택한 Type​에 따라 오른쪽 레일에 추가 구성 컨트롤이 나타날 수 있습니다. 이러한 컨트롤에 대한 자세한 내용은 유형별 필드 속성의 섹션을 참조하십시오.

오른쪽 레일에는 특수 필드 유형을 지정하는 확인란도 제공됩니다. 자세한 내용은 특수 필드 유형의 섹션을 참조하십시오.

필드 구성이 완료되면 적용​을 선택합니다.

캔버스가 업데이트되어 필드의 이름 및 유형이 표시되고 오른쪽 레일에는 다른 속성과 함께 필드의 경로가 나열됩니다.

위 단계를 계속 수행하여 스키마에 필드를 더 추가할 수 있습니다. 스키마가 저장되면 기본 클래스와 믹스도 변경 내용이 있는 경우 저장됩니다.

노트

한 스키마의 mixins 또는 클래스에 대한 모든 변경 사항은 해당 스키마를 사용하는 다른 모든 스키마에 반영됩니다.

유형별 필드 속성

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

필드 속성 호환 가능한 유형 설명
기본값 String, Double, Long, 정수 , ShortShort,Byte,Boolean 수집 중에 다른 값이 제공되지 않을 경우 이 필드에 할당되는 기본값입니다. 이 값은 필드의 선택한 유형을 준수해야 합니다.
패턴 문자열 통합 중에 수락하려면 이 필드의 값이 일치해야 하는 정규 표현식입니다.
형식 문자열 값이 준수해야 하는 문자열에 대해 사전 정의된 형식 목록에서 선택합니다. 사용 가능한 포맷은 다음과 같습니다.
최소 길이 문자열 통합 중에 값을 수락하려면 문자열에 포함해야 하는 최소 문자 수입니다.
최대 길이 문자열 통합 중에 값을 수락하려면 문자열에 포함해야 하는 최대 문자 수입니다.
최소 값 이중 섭취 중 수락할 Double에 대한 최소값입니다. 인제스트된 값이 여기에 입력한 값과 정확히 일치하는 경우 값이 허용됩니다. 이 제약 조건을 사용할 때는 "배타적 최소값" 제약 조건을 비워두어야 합니다.
최대 값 이중 섭취 중 수락할 Double의 최대값입니다. 인제스트된 값이 여기에 입력한 값과 정확히 일치하는 경우 값이 허용됩니다. 이 제약 조건을 사용할 때는 "배타적 최대값" 제약 조건을 비워두어야 합니다.
독점적 최소값 이중 섭취 중 수락할 Double의 최대값입니다. 인제스트된 값이 여기에 입력한 값과 정확히 일치하는 경우 값이 거부됩니다. 이 제약 조건을 사용할 때는 "최소 값"(비배타적) 제약 조건을 비워두어야 합니다.
독점적 최대값 이중 섭취 중 수락할 Double의 최대값입니다. 인제스트된 값이 여기에 입력한 값과 정확히 일치하는 경우 값이 거부됩니다. 이 제약 조건을 사용할 때는 "최대값"(비배타적) 제약 조건을 비워두어야 합니다.

특수 필드 유형

오른쪽 레일에는 선택한 필드에 특수 역할을 지정할 수 있는 여러 개의 확인란이 있습니다. 이러한 옵션 중 일부에 대한 사용 사례에는 데이터 모델링 전략과 다운스트림 플랫폼 서비스를 사용하려는 방법에 대한 중요한 고려 사항이 포함됩니다.

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

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

다음 단계

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

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

이 페이지에서는