UI에서 스키마 리소스 살펴보기

Adobe Experience Platform에서 XDM(Experience Data Model) 스키마 리소스는 Adobe에서 제공하는 표준 리소스 및 조직에서 정의한 사용자 지정 리소스를 포함하여 Schema Library에 저장됩니다. Experience Platform UI에서는 Schema Library에서 기존 스키마, 클래스, 필드 그룹 또는 데이터 형식의 구조 및 필드를 볼 수 있습니다. UI는 이러한 XDM 리소스에서 제공하는 각 필드의 예상 데이터 유형 및 사용 사례에 대한 정보를 제공하므로 데이터 수집을 계획하고 준비할 때 특히 유용합니다.

이 자습서에서는 Experience Platform UI에서 기존 스키마, 클래스, 필드 그룹 및 데이터 유형을 탐색하는 단계를 다룹니다.

스키마 리소스 조회 lookup

Experience Platform UI의 왼쪽 탐색에서 Schemas​을(를) 선택합니다. Schemas 작업 영역에서는 조직의 모든 스키마를 탐색할 수 있는 Browse 탭과 Classes, Field groups, Data typesRelationships​을(를) 각각 탐색하기 위한 추가 전용 탭을 제공합니다.

여러 탭이 강조 표시된 스키마 작업 영역

필터 아이콘( 필터 아이콘 이미지 )은 나열된 결과를 좁히기 위해 왼쪽 레일에 컨트롤을 표시합니다. 리소스 필터는 BrowseRelationships 탭에서 각각 스키마 및 관계에 사용할 수 있습니다.

Browse 작업 영역의 Schemas 탭에서 스키마 인벤토리를 필터링할 수 있습니다. Included in Profile 전환을 사용하여 실시간 고객 프로필에서 사용할 수 있도록 설정된 스키마만 표시합니다. Show adhoc schemas 토글을 사용하여 단일 데이터 집합에서만 사용할 수 있도록 네임스페이스가 지정된 필드를 사용하여 만든 스키마 목록을 필터링합니다.

필터 패널이 강조 표시된 Schemas 작업 영역 Browse 탭입니다.

Relationship 작업 영역의 Schemas 탭에서 4가지 기준을 기반으로 관계 목록을 필터링할 수 있습니다. 필터에는 Source schema, Destination schema, Source class 및 Destination class이(가) 포함됩니다. 아래 표에는 필터에 대한 설명이 나와 있습니다.

필터
설명
Source schema
선택한 스키마가 시작점이거나 "원본"인 모든 관계를 보려면 Source schema 드롭다운 메뉴에서 스키마를 선택하십시오.
Destination schema
선택한 스키마가 대상 또는 "대상"인 모든 관계를 보려면 Destination schema 드롭다운 메뉴에서 스키마를 선택하십시오.
Source class
시작하는 스키마의 클래스를 기준으로 관계를 필터링하려면 Source class 드롭다운 메뉴에서 클래스를 선택하십시오.
Destination class
특정 클래스의 스키마로 끝나는 관계를 표시하려면 Destination class 드롭다운 메뉴에서 클래스를 선택하십시오.

필터 섹션이 강조 표시된 관계 탭입니다.

검색 창을 사용하여 결과의 범위를 더 좁힐 수도 있습니다.

검색 필드가 강조 표시된 스키마 작업 영역의 찾아보기 탭입니다.

검색 결과에 표시되는 리소스는 제목 일치 항목별로 정렬된 다음 설명 일치 항목별로 정렬됩니다. 이 범주 중 하나에서 단어가 더 많이 일치할수록 높은 리소스가 목록에 나타납니다.

탐색할 리소스를 찾으면 목록에서 해당 이름을 선택하여 캔버스에서 해당 구조를 확인합니다.

스키마, 클래스, 필드 그룹 및 데이터 유형(작업 및 삭제)을 관리합니다 xdm-resource-actions

XDM 리소스를 관리하거나 삭제해야 할 때 또는 작업(예: 삭제)을 사용할 수 없고 그 이유를 파악해야 할 때 이 섹션을 사용합니다.

작업을 찾을 위치(인라인 및 세부 사항 페이지) where-to-find-actions

리소스 삭제, 내보내기 또는 복사와 같은 작업을 수행하려면 다음 진입점 중 하나를 사용합니다.

Browse, Classes, Field groupsData types 탭에서 관리 작업을 다음 두 위치에서 사용할 수 있습니다.

  • 테이블의 인라인: 각 리소스 행에는 사용 가능한 작업에 직접 액세스할 수 있는 작업 메뉴(예: )가 있습니다.

각 리소스에 대해 줄임표 메뉴에서 사용할 수 있는 인라인 작업을 표시하는 스키마 인벤토리.

  • 리소스 세부 사항 보기: 세부 사항 보기의 전체 작업에 액세스하려면 사용자 지정(테넌트 정의) 리소스를 선택해야 합니다. 표준(Adobe 제공) 리소스에는 제한된 작업이 있으며, 삭제, JSON 구조 복사 또는 패키지에 추가와 같은 옵션이 표시되지 않습니다. 인벤토리에서 사용자 지정 리소스를 선택하여 세부 정보 보기를 연 다음 페이지 헤더의 More 메뉴를 사용하여 사용 가능한 동일한 작업에 액세스합니다.

삭제, JSON 구조 복사 및 샘플 파일 다운로드와 같은 사용 가능한 작업과 함께 추가 메뉴를 표시하는 리소스 세부 정보 보기 헤더입니다.

이러한 작업은 지원되는 리소스 유형(스키마, 클래스, 필드 그룹 및 데이터 유형)에 대한 두 진입점 모두에서 일관됩니다.

사용 가능한 작업 available-actions

리소스 유형 및 권한에 따라, 다음 작업을 사용할 수 있습니다.

  • Delete — 제한에서 허용하는 경우 조직에서 사용자 지정 리소스를 영구적으로 제거합니다. 삭제가 차단되면 제약 조건을 참조하세요.
  • Download sample file — 리소스 구조를 기반으로 샘플 데이터 파일을 생성합니다. 단계별: 샘플 XDM 데이터 생성.
  • Copy JSON structure — 재사용, 내보내기 또는 검사를 위해 리소스 정의를 JSON 형식으로 복사합니다. 단계별: XDM 스키마 내보내기.
  • Add to package — 샌드박스 간 내보내기 또는 가져오기를 위해 샌드박스 패키지에 리소스를 포함합니다. 단계별: 개체를 패키지로 내보내기.

다음은 다양한 리소스 유형에 적용됩니다.

  • 사용자 지정(테넌트 정의) 스키마, 클래스, 필드 그룹 및 데이터 형식의 경우 위의 모든 작업을 사용할 수 있습니다.

  • 표준(Adobe 정의) 클래스, 필드 그룹 및 데이터 형식의 경우:

    • Download sample file​만 사용할 수 있습니다.
    • 삭제, JSON 구조 복사패키지에 추가​를 사용할 수 없습니다.

비헤이비어 삭제 delete-behavior

더 이상 필요하지 않은 사용자 지정 리소스를 제거하려면 Delete 작업을 사용하십시오.

IMPORTANT
리소스를 삭제하면 조직에서 영구적으로 제거되며 실행 취소할 수 없습니다. 사용, 권한 또는 시스템 제한으로 인해 일부 리소스를 삭제할 수 없습니다.

리소스를 삭제하려면

  1. 테이블에서 리소스를 찾거나 해당 세부 사항 보기를 엽니다.
  2. 작업 메뉴( 또는 More)를 선택합니다.
  3. Delete​를 선택합니다.
  4. Delete​을(를) 다시 선택하여 대화 상자에서 작업을 확인합니다.

리소스는 확인 후 조직에서 영구적으로 제거됩니다.

리소스에 대해 삭제를 사용할 수 없는 경우 작업을 수행할 수 없는 이유를 설명하는 도구 설명이 있는 옵션이 비활성화되어 표시됩니다.

제한 사항을 설명하는 인라인 삭제 작업 도구 설명이 사용되지 않는 스키마 인벤토리.

제한(데이터 세트, 프로필, RBAC, 테넌트 및 전역) delete-constraints

Delete​과(와) 같은 작업을 사용할 수 없거나 사용할 수 없는 경우 일반적으로 다음 조건 중 하나로 인해 발생합니다.

  • 권한(RBAC): 관리 작업을 수행하려면 Manage Schemas​과 같은 필수 권한이 있어야 합니다. 권한이 없으면 도구 설명에 작업이 비활성화된 상태로 표시됩니다. 권한 구성 방법을 알아보려면 액세스 제어 UI 개요를 참조하세요.

  • 데이터 집합 연결: 하나 이상의 데이터 집합에서 사용하는 리소스(데이터 집합과 연결된 스키마 등)는 삭제할 수 없습니다. 데이터 집합 종속성을 식별하고 제거하려면 데이터 집합 삭제를 참조하십시오.

  • 프로필 활성화: 실시간 고객 프로필에 대해 활성화된 스키마를 삭제할 수 없습니다. 프로필 활성화가 스키마에 미치는 영향에 대한 자세한 내용은 실시간 고객 프로필 활성화 계획을 참조하세요.

  • 테넌트와 전역 리소스: 테넌트 정의(사용자 지정) 리소스는 삭제할 수 있지만(제약 조건에 따라) 표준(Adobe 제공) 클래스, 필드 그룹 및 데이터 형식은 삭제할 수 없습니다.

이러한 제한 사항은 UI에 직접 반영됩니다. 작업을 사용할 수 없으면 비활성화된 것으로 표시되며 특정 제한 사항을 설명하는 도구 설명이 포함됩니다.

리소스를 삭제할 수 없는 경우 위의 조건을 검토하여 권한을 업데이트해야 하는지, 종속성을 제거해야 하는지 또는 데이터 모델을 조정해야 하는지 확인하십시오.

캔버스에서 추가 스키마 편집 워크플로에 대한 내용은 UI에서 스키마 만들기 및 편집을 참조하십시오.

캔버스에서 XDM 리소스 살펴보기 explore

리소스를 선택하면 해당 구조가 캔버스에서 열립니다.

Commerce 데이터 형식을 표시하는 데이터 형식 작업 영역 캔버스입니다.

하위 속성을 포함하는 모든 오브젝트 유형 필드는 캔버스에 처음 나타날 때 기본적으로 축소됩니다. 필드의 하위 속성을 표시하려면 해당 이름 옆에 있는 아이콘을 선택합니다.

확장된 필드 및 하위 속성이 강조 표시된 데이터 형식 작업 영역 캔버스입니다.

표준 클래스 및 필드 그룹 표시기 standard-class-and-field-group-indicator

스키마 편집기 내에서 표준(Adobe에서 생성한) 클래스와 필드 그룹은 자물쇠 아이콘( 자물쇠 아이콘)으로 표시됩니다. 구문을 사용하는 키-값 쌍으로 전달됩니다. 자물쇠는 클래스 또는 필드 그룹 이름 옆의 왼쪽 레일과 시스템 생성 리소스의 일부인 스키마 다이어그램의 필드 옆에 나타납니다.

자물쇠 아이콘이 강조 표시된 스키마 편집기

지침은 표준 필드 그룹에 사용자 지정 필드 추가 설명서를 참조하십시오. 표준 클래스는 편집할 수 없습니다.

시스템 생성 필드 system-fields

일부 필드 이름은 밑줄(_repo_id)로 표시됩니다. 이는 데이터가 수집될 때 시스템이 자동으로 생성하고 지정하는 필드의 자리 표시자를 나타냅니다.

따라서 Experience Platform으로 수집할 때 이러한 필드의 대부분을 데이터 구조에서 제외해야 합니다. 이 규칙의 주요 예외는 _{TENANT_ID} 필드입니다. 조직에서 만든 모든 XDM 필드는 아래에 네임스페이스가 지정되어야 합니다.

데이터 유형 data-types

캔버스에 표시된 각 필드의 이름 옆에는 해당 데이터 형식이 표시되어 필드에 수집될 데이터 형식을 한눈에 나타냅니다.

연결된 데이터 형식이 강조 표시된 우편 주소 데이터 형식입니다.

대괄호([])가 추가된 모든 데이터 형식은 해당 특정 데이터 형식의 배열을 나타냅니다. 예를 들어, 데이터 형식 String[]​은(는) 필드에 문자열 값의 배열이 필요함을 나타냅니다. Payment Item[]​의 데이터 형식은 Payment Item 데이터 형식을 준수하는 개체 배열을 나타냅니다.

배열 필드가 오브젝트 유형을 기반으로 하는 경우 캔버스에서 해당 아이콘을 선택하여 각 배열 항목에 대한 예상 속성을 표시할 수 있습니다.

캔버스에서 배열 필드가 강조 표시되어 있고 각 배열 항목의 예상 특성이 표시된 개체입니다.

Field properties field-properties

캔버스에서 필드 이름을 선택하면 오른쪽 레일이 업데이트되어 Field properties 아래에 해당 필드에 대한 세부 정보가 표시됩니다. 여기에는 필드의 의도된 사용 사례, 기본값, 패턴, 형식, 필드가 필요한지 여부 등에 대한 설명이 포함될 수 있습니다.

필드 속성이 강조 표시된 Commerce 데이터 형식에서 선택한 필드입니다.

검사하려는 필드가 열거형 필드인 경우 오른쪽 레일에는 필드에서 받을 수 있는 값도 표시됩니다.

필드가 선택되어 있고 열거형 값과 표시 이름이 필드 속성 레일에서 강조 표시된 스키마 편집기.

ID 필드 identity

ID 필드가 포함된 스키마를 검사할 때 이러한 필드는 스키마에 제공하는 클래스 또는 필드 그룹 아래의 왼쪽 레일에 나열됩니다. 중첩된 깊이에 관계없이 캔버스에 필드를 표시하려면 왼쪽 레일에서 ID 필드 이름을 선택합니다.

캔버스에서 ID 필드가 지문 아이콘( 지문 아이콘 이미지 )으로 강조 표시됩니다. ID 필드의 이름을 선택하면 ID 네임스페이스 및 필드가 스키마의 기본 ID인지 여부와 같은 추가 정보를 볼 수 있습니다.

스키마 ID가 왼쪽 레일에서 강조 표시된 스키마 편집기, 스키마 다이어그램에서 강조 표시된 필드, 필드 속성에서 강조 표시된 ID 네임스페이스가 있습니다.

NOTE
ID 필드 및 다운스트림 Experience Platform 서비스와의 관계에 대한 자세한 내용은 ID 필드 정의에 대한 안내서를 참조하십시오.

관계 필드 relationship

관계 필드가 포함된 스키마를 검사하는 경우 필드가 Relationships 아래의 왼쪽 레일에 나열됩니다. 중첩된 깊이에 관계없이 캔버스에 필드를 표시하려면 왼쪽 레일에서 관계 필드 이름을 선택합니다. 캔버스에서는 관계 필드도 고유하게 강조 표시되어 필드가 연결하는 참조 스키마의 이름을 표시합니다. B2B 기능이 있는 조직의 경우 사용자 지정 관계 이름을 쓸 수 있으며, 이러한 경우 캔버스에 표시됩니다.

관계 필드 및 관계 편집이 강조 표시된 스키마 편집기입니다.

참조 스키마의 기본 ID에 대한 ID 네임스페이스를 보려면 관계 필드를 선택한 다음 Edit relationship 사이드바에서 Field properties을(를) 선택합니다. 관계의 매개 변수가 표시되는 Edit relationship 대화 상자에 표시됩니다.

관계 매개 변수가 표시된 관계 편집 대화 상자입니다.

XDM 스키마에서의 관계 사용에 대한 자세한 내용은 UI에서 관계 만들기에 대한 자습서를 참조하십시오.

다음 단계

이 문서에서는 Experience Platform UI에서 기존 XDM 리소스를 탐색하는 방법을 다룹니다. Schemas 작업 영역과 Schema Editor의 다양한 기능에 대한 자세한 내용은 Schemas 작업 영역 개요를 참조하십시오.

recommendation-more-help
62e9ffd9-1c74-4cef-8f47-0d00af32fc07