UIでのスキーマリソースの確認
Adobe Experience Platformでは、すべてのExperience Data Model （XDM） スキーマリソースがSchema Libraryに保存されます。これには、Adobeが提供する標準リソースと、組織で定義されたカスタムリソースが含まれます。 Experience Platform UIでは、Schema Library内の既存のスキーマ、クラス、フィールドグループ、またはデータタイプの構造とフィールドを表示できます。 UIは、これらのXDM リソースによって提供される各フィールドの想定されるデータタイプとユースケースに関する情報を提供するため、データ取り込みの計画と準備を行う際に特に役立ちます。
このガイドでは、Experience Platform UIで既存のスキーマ、クラス、フィールドグループ、データタイプ、リレーションシップを調べる方法について説明します。
スキーマリソースの検索 lookup
Experience Platform UIで、左側のパネルで「スキーマ」を選択します。 スキーマ ワークスペースには、参照 タブがあり、組織内のすべてのスキーマを表示できます。 クラス、フィールドグループ、データタイプ、および 関係 のタブを使用して、これらのリソースを表示することもできます。
フィルターと検索スキーマ filter-search
スキーマ ワークスペースのフィルタリングツールと検索ツールを使用して、スキーマのリストを絞り込み、特定のリソースをより迅速に検索します。 フィルターアイコン（
スキーマメタデータフィルター
スキーマを、基本特性と組織属性によってフィルタリングします。
スキーマ属性フィルター
スキーマ構造とID設定にもとづいて結果を絞り込むことができます。
時間フィルターとクリエイターフィルター
作成パターンと所有権にもとづいてスキーマをフィルタリングできます。
「関係」タブのフィルター
「関係」タブでスキーマ関係を表示する場合は、追加のフィルターを使用してスキーマ接続を調べます。
複数のフィルターを結合
フィルターを組み合わせてスキーマのリストを絞り込み、特定のリソースをより迅速に検索します。 例えば、先月内に作成されたカスタムタグを含む プロファイル対応標準スキーマを検索したり、電子メールプライマリ IDを使用し、関係フィールドを含むアドホックスキーマを検索したりできます。
適用されたフィルターは、在庫ヘッダー行に取り外し可能なチップとして表示されます。 フィルターを削除するには、そのチップの × を選択します。 アクティブなすべてのフィルターを一度に削除するには、すべてをクリアを選択します。
検索バーを使用して、検索結果をさらに絞り込みます。
検索結果は、リソースのタイトルと説明の一致にもとづいてランク付けされます。 タイトルの一致は説明の一致よりも優先され、より一致する用語を持つリソースは結果リストでより高く表示されます。
探索するリソースが見つかったら、リストから名前を選択して、キャンバスで構造を表示します。
スキーマの参照、整理、管理 browse-organize-manage-schemas
スキーマ ワークスペースを使用して、スキーマを検索、整理、管理します。 スキーマインベントリのフィルタリング、メタデータ列の並べ替え、一般的なスキーマアクションの実行は、インベントリビューから直接実行できます。
メタデータの参照とフィルタリング
スキーマインベントリでは、主要なスキーマメタデータが1つのテーブルビューに表示されます。 個々のスキーマを開かずに、タグ、スキーマタイプ、プロファイルのイネーブルメントステータス、作成日、最終変更日、クラス、ID、関係、動作、その他のメタデータを表示できます。
在庫を並べ替えるには、列ヘッダーを選択します。 同じ列ヘッダーをもう一度選択して、並べ替え順序を反転します。
在庫に1つのページに収まらない結果が含まれている場合は、リストの下部にあるページコントロールを使用して、ページ間を移動します。
スキーマに対するインラインアクション
スキーマ行の省略記号メニューを使用して、インベントリビューから直接、一般的なスキーマアクションを実行します。
アクションは、在庫ビューとリソース詳細ビューの両方から使用できます。 一部のアクションは、カスタム（テナント定義）リソースでのみ使用できます。 Adobeが提供する標準的なリソースでは、操作の選択肢が限られている場合があります。
リソースのタイプと権限に応じて、スキーマのプロパティの編集、データガバナンスラベルの適用、スキーマの削除、タグの管理をスキーマを開かずに実行できます。 追加のアクションには、スキーマのフォルダーへの移動、デプロイメントパッケージへのスキーマの追加、スキーマ JSONのコピー、テスト用のサンプルファイルのダウンロードなどがあります。
各アクションの詳細な手順については、 スキーマアクションガイド を参照してください。
タグとフォルダーを使用したスキーマの移動
タグとフォルダーを使用して、インベントリ内のスキーマを整理および検索します。 タグは、プロジェクト、チーム、データドメインなど、組織で定義されたカテゴリーごとにスキーマをグループ化するのに役立ちます。 フォルダーは、関連するスキーマを整理するための階層構造を提供します。
タグでスキーマをフィルタリングするには、フィルターアイコン（
フォルダー別のスキーマを参照するには、フォルダーを表示アイコン（
タグとフォルダーは在庫フィルタリングシステムと連携し、割り当てられたタグとフォルダーの場所に基づいてスキーマのリストを絞り込むことができます。
Experience Platform全体でのタグの作成と管理について詳しくは、統合タグの管理ガイド を参照してください。
キャンバスでのXDM リソースの探索 explore
リソースを選択すると、その構造がキャンバスで開きます。
サブプロパティを含むすべてのオブジェクトタイプフィールドは、最初にキャンバスに表示されたときに、デフォルトで折りたたまれます。 任意のフィールドのサブプロパティを表示するには、フィールド名の横にあるアイコンを選択します。
標準クラスおよびフィールドグループインジケーター standard-class-and-field-group-indicator
スキーマエディターでは、標準クラスとフィールドグループに南京錠アイコン（
標準クラスは編集できません。 標準フィールドグループを拡張するには、標準フィールドグループにカスタムフィールドを追加のドキュメントを参照してください。
システム生成フィールド system-fields
フィールド名の前にはアンダースコアが付いています（_repoや_idなど）。 これらは、データが取り込まれる際にシステムが自動的に生成して割り当てるフィールドのプレースホルダーを表します。
そのため、Experience Platformに取り込む際には、これらのフィールドのほとんどをデータ構造から除外する必要があります。 このルールの主な例外は_{TENANT_ID} フィールド です。このフィールドは、組織の下で作成されたすべてのXDM フィールドの下に名前空間を設定する必要があります。
データタイプ data-types
キャンバスに表示される各フィールドの対応するデータタイプは、フィールドが取り込む必要のあるデータタイプを一目で示す名前の横に表示されます。
角括弧（[]）が付いたデータ型は、その特定のデータ型の配列を表します。 例えば、String[]というデータ型は、フィールドに文字列値の配列が必要であることを示します。 支払い項目[]のデータ型は、支払い項目 データ型に準拠するオブジェクトの配列を示します。
配列フィールドがオブジェクトタイプに基づいている場合は、キャンバスでそのアイコンを選択して、各配列項目の期待属性を表示できます。
フィールドプロパティ field-properties
キャンバス内の任意のフィールドの名前を選択すると、右側のパネルが更新され、そのフィールドの詳細が フィールドプロパティ の下に表示されます。 これには、フィールドの意図されるユースケースの説明、デフォルト値 （取り込み中に適用されない情報スキーマメタデータ）、パターン、形式、フィールドが必要かどうか、などを含めることができます。 デフォルト値と取り込み検証設定の違いについては、 タイプ固有のフィールドプロパティ を参照してください。 フィールドグループを探索する場合、選択したフィールドのラベル関連の詳細もここに表示されます。構造図の ラベル を参照してください。
検査中のフィールドが列挙フィールドの場合、右側のパネルには、フィールドが受け取ると想定される許容値も表示されます。
ID フィールド identity
ID フィールドを含むスキーマを検査する場合、これらのフィールドは、スキーマに提供するクラスまたはフィールドグループの下の左側のパネルに一覧表示されます。 左側のパネルでID フィールド名を選択すると、ネストの深さに関係なく、カンバス内のフィールドが表示されます。
ID フィールドは、指紋アイコン （
関係フィールド relationship
関係フィールドを含むスキーマを検査する場合、そのフィールドは 関係 の下の左側のパネルに一覧表示されます。 左側のパネルで関係フィールド名を選択すると、ネストの深さに関係なく、カンバス内のフィールドが表示されます。 関係フィールドは、フィールドがリンクする参照スキーマの名前を示す、キャンバス内で一意にハイライト表示されます。 B2B機能を持つ組織の場合、カスタムの関係名を記述でき、このような場合はキャンバスに表示されます。
参照スキーマのプライマリ IDのID名前空間を表示するには、関係フィールドを選択し、 フィールドプロパティ サイドバーで 関係を編集 します。 関係のパラメーターは、表示される関係を編集 ダイアログに表示されます。
XDM スキーマでの関係の使用について詳しくは、UIでの関係の作成に関するチュートリアルを参照してください。
フィールドグループの探索：使用状況とメタデータ explore-field-groups
スキーマ / フィールドグループに移動して、フィールドグループを確認します。 フィールドグループ タブでは、追加の機能により、スキーマ全体でフィールドグループが使用されている場所と、互換性、必須フィールド（取り込み要件を適用する）、ガバナンスシグナルなど、その内容を把握できます。
これらの機能は、変更を加える前に影響を評価し、スキーマの設計中に関連するフィールドグループをより効率的に特定するのに役立ちます。
フィールドグループのスキーマ使用状況の表示 view-schema-usage-for-field-groups
フィールドグループ テーブルから、フィールドグループを選択して、その詳細ビューを開きます。 キャンバスが更新され、フィールドグループ構造が表示され、プロパティパネルには選択したリソースに関する追加情報が表示されます。
このフィールドグループを使用するスキーマ
右側のプロパティパネルの「このフィールドグループを使用したスキーマ」セクションには、現在フィールドグループを含むスキーマが一覧表示されます。
- フィールドグループが3つ以下のスキーマで使用されている場合、すべてのスキーマ名が表示されます。
- 3つ以上のスキーマで使用されている場合は、一部の名前のみが表示され、完全なリストを表示するオプションも表示されます。
スキーマ名を選択して、その詳細ビューを新しいタブで開き、そのスキーマ内でのフィールドグループの実装方法を調べます。
スキーマリストの詳細と完全な表示
インラインで表示できる数よりも多くのスキーマが存在する場合は、詳細を表示を選択して、完全なダイアログを開きます。
このフィールドグループを使用するスキーマ ダイアログが表示され、フィールドグループを使用するスキーマの完全なリストが表示されます。
このフィールドグループ ダイアログを使用する スキーマでは、次の操作を実行できます。
- フィールドグループを使用するすべてのスキーマを参照する
- 大規模な結果セットのページ
- スキーマを選択して、その詳細ビューを新しいタブで開く
スキーマ名、クラス、その他の属性などのスキーマの詳細を表示できます。
このワークフローは、影響分析および探索のみを目的としています。 スキーマやフィールドグループは変更されません。 スキーマ構造を変更するには、UIでのスキーマの作成と編集を参照してください。
フィールドグループのメタデータとフィルタリング field-group-metadata-and-filtering
「フィールドグループ」タブには、フィールドグループを選択する前に見つけて評価するのに役立つメタデータとフィルタリングツールが用意されています。
テーブルとフィルターを参照
フィールドグループのインベントリテーブルには、フィールドグループを適用できるクラスを示す 互換性のあるクラス など、リストビューで直接メタデータを公開する追加の列が含まれています。 フィールドグループは、表すデータ（レコードベースまたは時系列データなど）の動作に基づいて、リストされている互換性のあるクラスのいずれかを使用するスキーマにのみ追加できます。 フィールドグループがすべてのクラスと互換性がある場合、テーブルに All が表示される場合があります。 業界タグは、発見のためのフィールドグループの分類に役立ちます。
リストを絞り込むには、フィルターアイコン（
フィルターパネルでは、次の操作を実行できます。
- 互換性のあるクラス — ドロップダウンを使用して、クラスの互換性でフィールドグループをフィルタリングします
- 業界タグ — チェックボックスを使用して、1つ以上の業界カテゴリでフィルタリングします
参照中に、表の行を選択して、情報パネルをトリガーします。 情報パネルには、互換性のあるクラスや業界タグなどのメタデータが表示されるため、フィールドグループを開かずにキーの詳細を確認できます。
フィールドグループ詳細メタデータ
フィールドグループを開くと、プロパティパネルにリソースに関連する追加のメタデータが表示されます。
プロパティパネルには、次のメタデータを表示できます。
- 互換性のあるクラス — フィールドグループが拡張できるクラス
- 必須属性 — データ取り込み中にフィールドグループによって要求されたときに有効な値を持つ属性。 要件はデータ構造によって異なり、必要な値が欠落または無効なレコードは検証に失敗します
- ラベル — ラベルはフィールドグループレベルで表示されません。 フィールドを選択して、フィールドプロパティ パネルにラベルの詳細を表示します
この情報は、フィールドグループを使用または変更する前に、制約と要件を理解するのに役立ちます。
構造図のラベル
フィールドグループがカンバスで開いている場合、構造内で直接ラベル情報を表示できます。 設定アイコンを選択します（
キャンバスでフィールドを選択すると、そのフィールドに適用されたラベルを含むラベルの詳細がフィールドプロパティ パネルに表示されます。
ラベルはカテゴリ別（IDや機密ラベルなど）にグループ化され、データに適用されるガバナンスやアクセス関連の制約を可視化します。
これらの指標は可視性のためのものであり、スキーマ構造は変更されません。 詳しくは、 スキーマのデータ使用ラベルの管理を参照してください。
次の手順
XDM スキーマと関連するExperience Platform機能を引き続き使用するには、次のリソースを使用します。
- スキーマ ワークスペースと Schema Editor について詳しくは、 スキーマ ワークスペースの概要を参照してください。
- タグの作成と管理について詳しくは、統合タグの管理ガイド を参照してください。
- インベントリ表示、フィルタリング、検索、ワークスペースのナビゲーションパターンに関するガイダンスについては、 データセットのユーザーガイド を参照してください。
- データガバナンスラベルの適用と管理について詳しくは、 データ使用ラベルユーザーガイド を参照してください。