UI에서 스키마 생성 및 편집 create-edit-schemas-in-ui
이 안내서에서는 Adobe Experience Platform UI에서 조직에 대한 XDM(Experience Data Model) 스키마를 만들고, 편집하고, 관리하는 방법에 대한 개요를 제공합니다.
전제 조건 prerequisites
이 안내서에서는 XDM 시스템에 대한 작업 이해가 필요합니다. Experience Platform 에코시스템 내에서 XDM의 역할에 대한 소개는 XDM 개요를, 스키마 구성 방법에 대한 개요는 스키마 구성의 기본 사항을 참조하십시오.
새 스키마 만들기 create
스키마 작업 영역의 오른쪽 상단에서 스키마 만들기 를 선택합니다.
스키마 만들기 워크플로가 나타납니다. 개인 프로필, 경험 이벤트 또는 기타 를 선택한 후 다음 을 선택하여 스키마의 기본 클래스를 선택하여 선택을 확인할 수 있습니다. 이러한 클래스에 대한 자세한 내용은 XDM 개별 프로필 및 XDM ExperienceEvent 설명서를 참조하십시오.
클래스를 선택하면 이름 및 검토 섹션이 나타납니다. 이 섹션에서는 스키마를 식별하기 위한 이름과 설명을 제공합니다. 선택한 클래스와 스키마 구조를 검토하고 확인할 수 있도록 스키마의 기본 구조(클래스에서 제공)가 캔버스에 표시됩니다.
텍스트 필드에 사용자에게 친숙한 스키마 표시 이름을(를) 입력하십시오. 그런 다음 스키마를 식별하는 데 도움이 되는 적절한 설명을 입력합니다. 스키마 구조를 검토하고 설정이 마음에 들면 완료 를 선택하여 스키마를 만듭니다.
스키마 표시 이름, 설명 및 마침이 강조 표시된 스키마 만들기 워크플로의 이름 및 검토 섹션.
스키마 찾아보기 탭이 나타납니다. 최근에 만든 스키마가 이제 스키마 라이브러리에 나열되며 Schema Editor에서 편집할 수 있습니다.
기존 스키마 편집 edit
기존 스키마를 편집하려면 찾아보기 탭을 선택한 다음 편집할 스키마 이름을 선택합니다. 검색 창을 사용하여 사용 가능한 옵션 목록의 범위를 좁힐 수도 있습니다.
스키마를 선택하면 캔버스에 스키마 구조가 표시된 Schema Editor이(가) 나타납니다. 이제 스키마에 필드 그룹을 추가(또는 해당 그룹에서 개별 필드를 추가)하거나, 필드 표시 이름을 편집 또는 기존 사용자 정의 필드 그룹을 편집할 수 있습니다.
기타 액션 more
스키마 편집기 내에서 빠른 작업을 수행하여 스키마의 JSON 구조를 복사하거나, 실시간 고객 프로필에 대해 활성화되지 않았거나 관련 데이터 세트가 있는 경우 스키마를 삭제할 수도 있습니다. 빠른 작업으로 드롭다운을 표시하려면 보기 맨 위에서 자세히를 선택하십시오.
JSON 구조 복사 기능을 사용하면 스키마 및 데이터 파이프라인을 작성하는 동안 샘플 페이로드가 어떻게 표시되는지 확인할 수 있습니다. 특히 ID 맵과 같은 스키마에 복잡한 객체 맵 구조가 있는 경우에 유용합니다.
표시 이름 전환 display-name-toggle
편의상, 스키마 편집기에서는 원래 필드 이름과 사람이 읽을 수 있는 더 많은 표시 이름 사이를 변경하는 토글을 제공합니다. 이러한 유연성을 통해 필드 검색 기능을 개선하고 스키마를 편집할 수 있습니다. 토글은 스키마 편집기 보기의 오른쪽 상단에 있습니다.
![필드 표시 이름 표시]가 강조 표시된 스키마 편집기 입니다.
표준 필드 그룹의 표시 이름은 시스템에서 생성되지만 표시 이름 섹션에 설명된 대로 사용자 지정할 수 있습니다. 표시 이름은 매핑 및 데이터 세트 미리보기를 비롯한 여러 UI 보기에 반영됩니다. 기본 설정은 꺼져 있으며 필드 이름을 원래 값으로 표시합니다.
스키마에 필드 그룹 추가 add-field-groups
Schema Editor 내에서 스키마를 열면 필드 그룹을 사용하여 스키마에 필드를 추가할 수 있습니다. 시작하려면 왼쪽 레일에서 필드 그룹 옆에 있는 추가 를 선택하십시오.
![필드 그룹] 섹션의 추가가 강조 표시된 스키마 편집기.(https://experienceleague.adobe.com/images/ui/resources/schemas/add-field-group-button.png?lang=ko)
스키마에 대해 선택할 수 있는 필드 그룹 목록을 표시하는 대화 상자가 나타납니다. 필드 그룹은 하나의 클래스와만 호환되므로 스키마의 선택한 클래스와 연결된 필드 그룹만 나열됩니다. 기본적으로 나열된 필드 그룹은 조직 내에서 사용 인기에 따라 정렬됩니다.
추가할 필드의 일반 활동 또는 비즈니스 영역을 알고 있는 경우 왼쪽 레일에서 하나 이상의 수직 범주를 선택하여 표시된 필드 그룹 목록을 필터링합니다.
![필드 그룹 추가] 대화 상자는 산업 필터 및 산업 열을 강조 표시하며 강조 표시되었습니다.(https://experienceleague.adobe.com/images/ui/resources/schemas/industry-filter.png?lang=ko)
검색 창을 사용하여 원하는 필드 그룹을 찾을 수도 있습니다. 쿼리와 이름이 일치하는 필드 그룹이 목록 맨 위에 나타납니다. 표준 필드 아래에 원하는 데이터 특성을 설명하는 필드가 포함된 필드 그룹이 표시됩니다.
![필드 그룹 추가] 대화 상자에 표준 필드 검색 기능이 강조 표시되어 있습니다.(https://experienceleague.adobe.com/images/ui/resources/schemas/field-group-search.png?lang=ko)
스키마에 추가하려는 필드 그룹의 이름 옆에 있는 확인란을 선택합니다. 목록에서 여러 필드 그룹을 선택할 수 있으며, 선택한 각 필드 그룹이 오른쪽 레일에 표시됩니다.
필드 그룹을 선택한 후 필드 그룹 추가 를 선택하여 스키마에 추가합니다.
Schema Editor이(가) 필드 그룹이 제공한 필드가 캔버스에 표시된 상태로 다시 나타납니다.
스키마에 필드 그룹을 추가한 후 필요에 따라 선택적으로 기존 필드를 제거하거나 새 사용자 정의 필드를 추가할 수 있습니다.
필드 그룹에서 추가된 필드 제거 remove-fields
스키마에 필드 그룹을 추가한 후에는 필요하지 않은 모든 필드를 제거할 수 있습니다.
다음 예제에서는 표준 필드 그룹 인구 통계 세부 정보 을(를) 스키마에 추가했습니다. taxId과(와) 같은 단일 필드를 제거하려면 캔버스에서 필드를 선택한 다음 오른쪽 레일에서 제거 를 선택하십시오.
제거할 필드가 여러 개인 경우 필드 그룹을 전체적으로 관리할 수 있습니다. 캔버스에서 그룹에 속하는 필드를 선택한 다음 오른쪽 레일에서 관련 필드 관리 를 선택합니다.
![관련 필드 관리]이(가) 강조 표시된 Schema Editor입니다.(https://experienceleague.adobe.com/images/ui/resources/schemas/manage-related-fields.png?lang=ko)
해당 필드 그룹의 구조를 보여 주는 대화 상자가 나타납니다. 여기에서 제공된 확인란을 사용하여 필요한 필드를 선택하거나 선택 취소할 수 있습니다. 만족하면 확인 을 선택하세요.
스키마 구조에 선택한 필드만 있는 캔버스가 다시 나타납니다.
필드 그룹에 사용자 정의 필드 추가 add-fields
스키마에 필드 그룹을 추가한 후 해당 그룹에 대한 추가 필드를 정의할 수 있습니다. 그러나 한 스키마의 필드 그룹에 추가된 모든 필드는 해당 필드 그룹을 사용하는 다른 모든 스키마에도 표시됩니다.
또한 사용자 정의 필드를 표준 필드 그룹에 추가하면 해당 필드 그룹이 사용자 정의 필드 그룹으로 변환되고 원래 표준 필드 그룹은 더 이상 사용할 수 없습니다.
표준 필드 그룹에 사용자 지정 필드를 추가하려면 아래 섹션에서 구체적인 지침을 참조하세요. 사용자 정의 필드 그룹에 필드를 추가하는 경우 필드 그룹 UI 안내서에서 사용자 정의 필드 그룹 편집에 대한 섹션을 참조하십시오.
기존 필드 그룹을 변경하지 않으려면 새 사용자 지정 필드 그룹을 만들기하여 대신 추가 필드를 정의할 수 있습니다.
스키마에 개별 필드 추가 add-individual-fields
특정 사용 사례에 대한 전체 필드 그룹을 추가하지 않으려면 스키마 편집기를 사용하여 개별 필드를 스키마에 직접 추가할 수 있습니다. 대신 표준 필드 그룹의 개별 필드를 추가하거나 사용자 정의 필드를 추가할 수 있습니다.
표준 필드 추가 add-standard-fields
해당 필드 그룹을 미리 알 필요 없이 표준 필드 그룹의 필드를 스키마에 직접 추가할 수 있습니다. 스키마에 표준 필드를 추가하려면 캔버스에서 스키마 이름 옆에 있는 더하기(+) 아이콘을 선택합니다. 제목 없는 필드 자리 표시자가 스키마 구조와 오른쪽 레일 업데이트에 표시되어 필드를 구성할 컨트롤을 표시합니다.
필드 이름 에서 추가하려는 필드 이름을 입력하세요. 시스템은 쿼리와 일치하는 표준 필드를 자동으로 검색하고 해당 필드가 속한 필드 그룹을 포함하여 권장 표준 필드 에 나열합니다.
일부 표준 필드는 동일한 이름을 공유하지만 구조는 출신 필드 그룹에 따라 달라질 수 있습니다. 표준 필드가 필드 그룹 구조의 상위 오브젝트 내에 중첩된 경우 하위 필드가 추가되면 상위 필드도 스키마에 포함됩니다.
표준 필드 옆에 있는 미리 보기 아이콘(
캔버스는 필드 그룹 구조 내에 중첩된 상위 필드를 포함하여 스키마에 추가된 표준 필드를 표시하도록 업데이트됩니다. 필드 그룹의 이름은 왼쪽 레일의 필드 그룹 아래에 나열됩니다. 같은 필드 그룹의 필드를 더 추가하려면 오른쪽 레일에서 관련 필드 관리 를 선택하십시오.
사용자 정의 필드 추가 add-custom-fields
표준 필드의 워크플로우와 마찬가지로 사용자 정의 필드를 스키마에 직접 추가할 수도 있습니다.
스키마의 루트 수준에 필드를 추가하려면 캔버스에서 스키마 이름 옆에 있는 더하기(+) 아이콘을 선택합니다. 제목 없는 필드 자리 표시자가 스키마 구조와 오른쪽 레일 업데이트에 표시되어 필드를 구성할 컨트롤을 표시합니다.
추가하려는 필드 이름을 입력하면 일치하는 표준 필드 검색이 자동으로 시작됩니다. 대신 새 사용자 지정 필드를 만들려면 (새 필드) 이(가) 추가된 최상위 옵션을 선택하십시오.
필드에 대한 표시 이름 및 데이터 유형을 제공한 후 다음 단계는 상위 XDM 리소스에 필드를 할당하는 것입니다. 스키마에서 사용자 지정 클래스를 사용하는 경우 대신 필드를 할당된 클래스에 추가 또는 필드 그룹하도록 선택할 수 있습니다. 그러나 스키마에서 표준 클래스를 사용하는 경우 사용자 지정 필드만 필드 그룹에 할당할 수 있습니다.
필드를 사용자 정의 필드 그룹에 할당 add-to-field-group
할당 대상 에서 필드 그룹 을 선택합니다. 스키마에서 표준 클래스를 사용하는 경우 이 옵션만 사용할 수 있으며 기본적으로 이 옵션이 선택되어 있습니다.
그런 다음 연결할 새 필드에 대한 필드 그룹을 선택해야 합니다. 제공된 텍스트 입력 시 필드 그룹의 이름을 입력하십시오. 입력과 일치하는 기존 사용자 정의 필드 그룹이 있는 경우 드롭다운 목록에 표시됩니다. 또는 고유한 이름을 입력하여 대신 새 필드 그룹을 만들 수 있습니다.
목록에서 필드 그룹을 선택한 후 적용 을 선택합니다.
새 필드가 캔버스에 추가되고 표준 XDM 필드와의 충돌을 방지하기 위해 테넌트 ID 아래에 네임스페이스가 지정됩니다. 새 필드를 연결한 필드 그룹은 왼쪽 레일의 필드 그룹 아래에도 나타납니다.
필드를 사용자 정의 클래스에 할당 add-to-class
할당 대상 에서 클래스 을 선택합니다. 아래의 입력 필드가 현재 스키마의 사용자 지정 클래스 이름으로 바뀌어 새 필드가 이 클래스에 할당됨을 나타냅니다.
원하는 대로 필드 구성을 계속하고 완료되면 적용 을 선택합니다.
새 필드에 대해
새 필드가 캔버스에 추가되고 표준 XDM 필드와의 충돌을 방지하기 위해 테넌트 ID 아래에 네임스페이스가 지정됩니다. 왼쪽 레일에서 클래스 이름을 선택하면 새 필드가 클래스 구조의 일부로 표시됩니다.
표준 필드 그룹 구조에 사용자 정의 필드 추가 custom-fields-for-standard-groups
작업 중인 스키마에 표준 필드 그룹에서 제공하는 개체 유형 필드가 있는 경우 해당 표준 개체에 사용자 지정 필드를 추가할 수 있습니다.
시작하려면 표준 필드 그룹에서 제공한 개체의 루트 옆에 있는 더하기(+) 아이콘을 선택합니다.
표준 필드 그룹을 변환할지 여부를 확인하는 경고 메시지가 나타납니다. 계속하려면 필드 그룹 만들기 계속 을(를) 선택하십시오.
캔버스는 새 필드에 대한 제목 없는 자리 표시자와 함께 다시 나타납니다. 표준 필드 그룹의 이름이 원래 버전에서 수정되었음을 나타내기 위해 "(Extended)"와 함께 추가되었습니다. 여기에서 오른쪽 레일의 컨트롤을 사용하여 필드의 속성을 정의합니다.
변경 사항을 적용하면 표준 개체 내의 테넌트 ID 네임스페이스 아래에 새 필드가 표시됩니다. 이 중첩된 네임스페이스는 동일한 필드 그룹을 사용하는 다른 스키마의 변경 사항을 방지하기 위해 필드 그룹 자체 내에서 필드 이름 충돌을 방지합니다.
실시간 고객 프로필용으로 스키마 활성화 profile
실시간 고객 프로필은(는) 서로 다른 소스의 데이터를 병합하여 각 개별 고객에 대한 전체 보기를 만듭니다. 스키마에 의해 캡처된 데이터를 이 프로세스에 참여시키려면 Profile에서 사용할 스키마를 활성화해야 합니다.
스키마를 활성화하려면 왼쪽 레일에서 스키마 이름을 선택한 다음 오른쪽 레일에서 프로필 전환을 선택합니다.
스키마를 활성화하고 저장한 후에는 비활성화할 수 없다는 경고가 표시되는 팝오버가 나타납니다. 계속하려면 사용 을 선택하세요.
프로필 토글이 활성화된 상태로 캔버스가 다시 나타납니다.
프로세스를 완료하려면 저장 을 선택하여 스키마를 저장합니다.
이제 실시간 고객 프로필에서 스키마를 사용할 수 있습니다. Platform이 이 스키마를 기반으로 데이터 세트에 데이터를 수집하면 해당 데이터가 통합 프로필 데이터에 통합됩니다.
스키마 필드의 표시 이름 편집 display-names
클래스를 할당하고 스키마에 필드 그룹을 추가하면 표준 또는 사용자 지정 XDM 리소스에서 해당 필드를 제공했는지 여부에 관계없이 스키마 필드의 표시 이름을 편집할 수 있습니다.
스키마 필드의 표시 이름을 편집하려면 캔버스에서 필드를 선택합니다. 오른쪽 레일에서 표시 이름 에 새 이름을 입력하십시오.
오른쪽 레일에서 적용 을 선택하면 캔버스가 업데이트되어 필드의 새 표시 이름이 표시됩니다. 저장 을 선택하여 스키마에 변경 내용을 적용합니다.
스키마 클래스 변경 change-class
스키마가 저장되기 전에 초기 작성 프로세스 동안 언제든지 스키마 클래스를 변경할 수 있습니다.
클래스를 재할당하려면 캔버스의 왼쪽에서 할당 을 선택하세요.
조직에서 정의한 모든 클래스("Customer"인 소유자)와 Adobe에서 정의한 표준 클래스를 포함하여 사용 가능한 모든 클래스의 목록을 표시하는 대화 상자가 나타납니다.
목록에서 클래스를 선택하여 대화 상자의 오른쪽에 설명을 표시합니다. 클래스 구조 미리 보기 를 선택하여 클래스와 연결된 필드 및 메타데이터를 볼 수도 있습니다. 계속하려면 클래스 할당 을 선택하십시오.
새 클래스를 지정할지 확인하는 대화 상자가 열립니다. 할당 을(를) 선택하여 확인합니다.
수업 변경을 확인한 후 캔버스가 재설정되고 모든 작곡 진행이 손실됩니다.
다음 단계 next-steps
이 문서에서는 Platform UI에서 스키마를 만들고 편집하는 기본 사항에 대해 설명합니다. 고유한 사용 사례에 대한 사용자 지정 필드 그룹 및 데이터 형식 만들기를 포함하여 UI에서 전체 스키마를 구축하기 위한 포괄적인 워크플로에 대해 스키마 만들기 자습서를 검토하는 것이 좋습니다.
스키마 작업 영역의 기능에 대한 자세한 내용은 스키마 작업 영역 개요를 참조하십시오.
Schema Registry API에서 스키마를 관리하는 방법을 알아보려면 스키마 끝점 안내서를 참조하십시오.