UI에서 XDM 필드 정의

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

전제 조건

이 안내서에서는 XDM 시스템을 작업해야 합니다. 자세한 내용은 XDM 개요 Experience Platform 에코시스템 내에서 XDM의 역할을 소개합니다. 스키마 구성 기본 사항 클래스 및 필드 그룹이 XDM 스키마에 필드를 기여하는 방법을 알아봅니다.

이 안내서에는 필요하지 않지만, 다음 튜토리얼도 따르는 것이 좋습니다. UI에서 스키마 작성 다음과 같은 다양한 기능에 익숙해지다 Schema Editor.

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

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

일단 이 Schema Editor 필드를 추가하거나 편집할 수 있는 컨트롤이 캔버스에 나타납니다. 이러한 컨트롤은 스키마 이름 옆에 나타나고 선택한 클래스나 필드 그룹에 정의된 개체 형식 필드도 나타납니다.

경고

표준 필드 그룹에서 제공하는 객체에 필드를 추가하려고 하면 해당 필드 그룹이 사용자 지정 필드 그룹으로 변환되고 원래 필드 그룹은 더 이상 사용할 수 없습니다. 의 섹션을 참조하십시오. 표준 필드 그룹에 필드 추가 스키마 UI 안내서에서 자세한 내용을 확인하십시오.

리소스에 새 필드를 추가하려면 더하기(+) 캔버스에서 스키마 이름 옆에 있는 아이콘 또는 필드를 정의할 객체 유형 필드 옆에 있는 아이콘.

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

필드의 속성 정의

을(를) 선택한 후 더하기(+) 아이콘, 새 필드 은 고유한 테넌트 ID에 지정된 객체 내에 있는 캔버스에 나타납니다(으로 표시) _tenantId 아래 예에서 ). 스키마에 추가된 모든 사용자 지정 필드는 Adobe 제공 클래스 및 필드 그룹에서 다른 필드와의 충돌을 방지하기 위해 자동으로 이 네임스페이스 내에 배치됩니다.

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

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

그 이름은 camelCase로 작성하면 이상적이다. 영숫자, 대시 또는 밑줄 문자가 포함될 수 있지만 그렇지 않음 밑줄로 시작합니다.
  • 수정: fieldName
  • 허용 가능: field_name2, Field-Name, field-name_3
  • 잘못된: _fieldName
디스플레이 이름 그 필드의 이름입니다.
유형 필드에 포함할 데이터 유형입니다. 이 드롭다운 메뉴에서 다음 중 하나를 선택할 수 있습니다 표준 스칼라 유형 XDM에서 지원하거나 다중 필드 중 하나에서 지원됩니다. 데이터 유형 에 대해 이전에 Schema Registry.

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

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

노트

에 따라 유형 필드에 대해 선택한 경우, 오른쪽 레일에 추가 구성 컨트롤이 나타날 수 있습니다. 의 섹션을 참조하십시오. 유형별 필드 속성 를 참조하십시오.

오른쪽 레일에는 특수 필드 유형을 지정하는 확인란도 제공됩니다. 의 섹션을 참조하십시오. 특수 필드 유형 추가 정보.

필드 구성을 마치면 를 선택합니다 적용.

캔버스가 업데이트되어 필드의 이름과 유형을 보여주며, 오른쪽 레일에 이제 다른 속성 외에 필드의 경로가 나열됩니다.

위의 단계에 따라 스키마에 필드를 더 추가할 수 있습니다. 스키마를 저장하면 기본 클래스와 필드 그룹도 변경 사항이 있을 경우 저장됩니다.

노트

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

유형별 필드 속성

새 필드를 정의할 때 추가 구성 옵션이 유형 필드에 대해 을(를) 선택합니다. 다음 표에서는 호환 유형과 함께 이러한 추가 필드 속성에 대해 설명합니다.

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

특수 필드 유형

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

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

기술적으로 특수 필드 유형은 아니지만 안내서를 방문하는 것이 좋습니다 개체 유형 필드 정의 스키마 구조를 구성하는 경우 중첩된 하위 필드 정의에 대해 자세히 알아보십시오.

다음 단계

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

의 기능에 대한 자세한 내용은 스키마 작업 영역, 자세한 내용은 스키마 작업 공간 개요.

이 페이지에서는