ドキュメント Experience Platform エクスペリエンスデータモデル（XDM）ガイド

UI でのスキーマリソースの調査

Last update: Tue Sep 24 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

トピック：

作成対象：

開発者

Adobe Experience Platformでは、Adobeが提供する標準リソースや組織で定義されるカスタムリソースなど、すべてのエクスペリエンスデータモデル（XDM）スキーマリソースが Schema Library に保存されます。 Experience PlatformUI では、Schema Library ージ内の既存のスキーマ、クラス、フィールドグループ、データタイプの構造とフィールドを確認できます。 UI は、これらの XDM リソースで提供される各フィールドの想定されるデータタイプとユースケースに関する情報を提供するので、データ取り込みを計画および準備する際に特に役立ちます。

このチュートリアルでは、Experience PlatformUI で既存のスキーマ、クラス、フィールドグループおよびデータタイプを調べる手順を説明します。

スキーマリソースの検索 lookup

Platform UI の左側のナビゲーションで「スキーマ」を選択します。スキーマワークスペースには、組織内のすべてのスキーマを調べる参照タブと、それぞれ クラス、フィールドグループ、データタイプ、関係を調べる専用のタブが用意されています。

複数のタブがハイライト表示されたスキーマワークスペース。

フィルターアイコン（）をクリックすると、左側のパネルにコントロールが表示され、リストされた結果を絞り込むことができます。リソースフィルターは、「参照」タブと「関係 タブのスキーマと関係に対して それぞれ使用きす。

スキーマワークスペースの参照タブで、スキーマインベントリをフィルタリングできます。 リアルタイム顧客プロファイル で使用するために有効になっているスキーマのみを表示するには、「プロファイルに含まれる」切替スイッチを使用します。 アドホックスキーマを表示 切替スイッチを使用して、単一のデータセットでのみ使用するために名前空間が設定されたフィールドで作成されたスキーマのリストをフィルタリングします。

フィルターパネルがハイライト表示されたスキーマワークスペース参照タブ。

スキーマワークスペースの関係タブでは、4 つの条件に基づいて関係のリストをフィルタリングできます。フィルターには、Source スキーマ、宛先スキーマ、Source クラス、および宛先クラスが含まれます。次の表にフィルターの説明を示します。

フィルター

説明

Source スキーマ

選択したスキーマが開始点（「ソース」）であるすべての関係を表示するには、Source schema ドロップダウンメニューからスキーマを選択します。

宛先スキーマ

選択したスキーマがターゲットまたは「宛先」であるすべての関係を表示するには、宛先スキーマドロップダウンメニューからスキーマを選択します。

Source クラス

開始スキーマのクラスに基づいて関係をフィルタリングするには、Source クラスドロップダウンメニューからクラスを選択します。

宛先クラス

特定のクラスのスキーマで終わる関係を表示するには、「宛先クラス」ドロップダウンメニューからクラスを選択します。

フィルターセクションがハイライト表示された「関係」タブ。

検索バーを使用して、結果をさらに絞り込むこともできます。

検索フィールドがハイライト表示されたスキーマワークスペースの「参照」タブ。

検索結果に表示されるリソースは、タイトル一致順、説明一致順に並べ替えられます。次に、これらのカテゴリのいずれかに一致する単語が多いほど、リストにリソースが高く表示されます。

参照するリソースが見つかったら、その名前をリストから選択して、キャンバスに構造を表示します。

キャンバスでの XDM リソースの参照 explore

リソースを選択すると、その構造がキャンバスで開きます。

Commerceデータ型を表示するデータ型ワークスペース・キャンバス。

サブプロパティを含むすべてのオブジェクトタイプフィールドは、キャンバスに初めて表示されたときに、デフォルトで折りたたまれます。任意のフィールドのサブプロパティを表示するには、名前の横にあるアイコンを選択します。

展開されたフィールドとサブプロパティがハイライト表示されたデータタイプワークスペースキャンバス。

標準クラスおよびフィールドグループインジケーター standard-class-and-field-group-indicator

スキーマエディター内では、標準（Adobe生成）のクラスおよびフィールドグループは、南京錠アイコン（。南京錠は、クラスまたはフィールドグループ名の横の左側のパネルに表示されるほか、システム生成リソースの一部であるスキーマ図のフィールドの横にも表示されます。

南京錠アイコンがハイライトされたスキーマエディター

詳しくは、標準フィールドグループへのカスタムフィールドの追加ドキュメントを参照してください。標準クラスは編集できません。

システム生成フィールド system-fields

フィールド名の前には、_repo や _id のようにアンダースコアが付いているものもあります。これらは、データの取り込み時にシステムが自動的に生成して割り当てるフィールドのプレースホルダーを表します。

したがって、これらのフィールドのほとんどは、Platform に取り込む際にデータの構造から除外する必要があります。このルールの主な例外は、組織の下で作成されたすべての XDM フィールドの下に名前空間を設定する必要がある _{TENANT_ID} フィールドです。

データタイプ data-types

キャンバスに表示される各フィールドに対応するデータタイプが名前の横に表示され、フィールドが取り込みに必要なデータのタイプを一目で示します。

キャンバスに表示される郵送先住所データタイプは、関連するデータタイプがハイライト表示されています。

角かっこ（[]）が付いたデータ型は、その特定のデータ型の配列を表します。例えば、String[] というデータタイプは、フィールドが文字列値の配列を想定していることを示します。 Payment Item[] のデータタイプは、Payment Item データタイプに準拠するオブジェクトの配列を示します。

配列フィールドがオブジェクトタイプに基づいている場合、キャンバスでそのアイコンを選択して、各配列項目に期待される属性を表示できます。

配列フィールドがハイライト表示され、各配列項目に期待される属性が表示されたキャンバス内のオブジェクト。

フィールドプロパティ field-properties

キャンバスで任意のフィールドの名前を選択すると、右側のパネルが更新され、フィールドプロパティ の下にそのフィールドに関する詳細が表示されます。これには、フィールドの意図されたユースケースの説明、デフォルト値、パターン、形式、フィールドが必須かどうかなどが含まれます。

フィールドプロパティがハイライト表示されたCommerce データタイプから選択されたフィールド。

検査しているフィールドが列挙フィールドの場合、右側のパネルには、フィールドが受け取ると予想される許容値も表示されます。

選択したフィールドと、フィールドプロパティパネルで列挙値と表示名がハイライト表示されているスキーマエディター

ID フィールド identity

ID フィールドを含むスキーマを検査すると、これらのフィールドは、スキーマに提供するクラスまたはフィールドグループの下の左側のパネルに表示されます。左側のパネルで ID フィールド名を選択すると、ネストの深さに関係なく、キャンバスにフィールドが表示されます。

キャンバス内で ID フィールドが指紋アイコン（）でハイライト表示されます。 ID フィールドの名前を選択すると、ID 名前空間や、フィールドがスキーマのプライマリ ID かどうかなどの追加情報が表示されます。

左側のパネルでスキーマの ID がハイライト表示されたスキーマエディター、スキーマ図でフィールドがハイライト表示されたスキーマエディター、フィールドプロパティで ID 名前空間がハイライト表示されたスキーマエディター。

NOTE

ID フィールドとそのダウンストリーム Platform サービスとの関係について詳しくは、ID フィールドの定義に関するガイドを参照してください。

関係フィールド relationship

関係フィールドを含むスキーマを検査する場合、そのフィールドは関係の下の左側のパネルに表示されます。左側のパネルで関係フィールド名を選択すると、ネストの深さに関係なく、キャンバスにフィールドが表示されます。関係フィールドもキャンバス内で一意にハイライト表示され、フィールドのリンク先の参照スキーマの名前が表示されます。 B2B 機能を持つ組織の場合、カスタム関係名を書き込むことができ、この場合はキャンバスに表示されます。

関係フィールドと関係を編集がハイライト表示されたスキーマエディター。