UI でのスキーマリソースの調査
Adobe Experience Platformでは、すべての Experience Data Model(XDM) スキーマリソースは、 Schema Library：組織が定義したAdobeおよびカスタムリソースによって提供される標準リソースを含みます。 Experience PlatformUI で、 Schema Library. UI は、これらの XDM リソースが提供する各フィールドの期待されるデータタイプと使用例に関する情報を提供するので、データ取得の計画と準備をおこなう際に特に役立ちます。
このチュートリアルでは、Experience PlatformUI の既存のスキーマ、クラス、フィールドグループ、データタイプを調べる手順を説明します。
スキーマリソースの検索 lookup
Platform UI で、「 」を選択します。 スキーマ をクリックします。 The スキーマ workspace には、 参照 タブをクリックし、組織内のすべてのスキーマを参照します。また、参照用の専用タブも追加されています。 クラス, フィールドグループ、および データタイプ それぞれ。
フィルターアイコン (
例えば、リストをフィルターして、Adobeが提供する標準データ型のみを表示するには、「 」を選択します。 データタイプ および Adobe の下に タイプ および 所有者 各セクションに割り当てられます。
The プロファイルに含まれる toggle を使用すると、結果をフィルタリングして、で使用可能になっているスキーマで使用されているリソースのみを表示できます。 リアルタイム顧客プロファイル. The アドホックスキーマを表示 切り替えは、1 つのデータセットでのみ使用するために名前空間が設定されたフィールドを使用して作成されたスキーマのリストをフィルターします。
リソースを クラス, フィールドグループ または データタイプ タブ、 Adobe 標準のリソースのみを表示するか、 顧客 ：組織が作成したリソースのみを表示します。
検索バーを使用して、結果をさらに絞り込むこともできます。
検索結果に表示されるリソースは、タイトルの一致順に並べられ、次に説明の一致順に並べられます。 次に、これらのカテゴリに一致する単語が多いほど、リソースがリストに表示されます。
参照するリソースが見つかったら、リストからその名前を選択して、キャンバスに構造を表示します。
キャンバスでの XDM リソースの参照 explore
リソースを選択すると、その構造がキャンバスに表示されます。
サブプロパティを含むすべてのオブジェクトタイプフィールドは、最初にキャンバスに表示されたときに、デフォルトで折りたたまれます。 任意のフィールドのサブプロパティを表示するには、名前の横にあるアイコンを選択します。
標準クラスおよびフィールドグループのインジケーター standard-class-and-field-group-indicator
スキーマエディター内で、標準 (Adobe生成 ) のクラスとフィールドグループに南京錠アイコン (
詳しくは、 標準フィールドグループにカスタムフィールドを追加する ガイダンスに関するドキュメント。 標準クラスは編集できません。
システム生成フィールド system-fields
一部のフィールド名の前には、アンダースコアが付いています ( 例： _repo および _id. これらは、データの取り込み時にシステムが自動的に生成し、割り当てるフィールドのプレースホルダーを表します。
したがって、これらのフィールドのほとんどは、Platform に取り込む際に、データの構造から除外する必要があります。 このルールの主な例外は、 _{TENANT_ID} フィールド：組織の下で作成するすべての XDM フィールドは、の下に名前空間化する必要があります。
データタイプ data-types
キャンバスに表示される各フィールドについて、名前の横に対応するデータ型が表示され、フィールドの取得に必要なデータのタイプが一目で示されます。
角括弧 ([]) は、その特定のデータ型の配列を表します。 例えば、 文字列[] は、フィールドに文字列値の配列が必要であることを示します。 次のようなデータタイプ 支払い項目[] に準拠するオブジェクトの配列を示します 支払い項目 データタイプ。
配列フィールドがオブジェクトタイプに基づいている場合、キャンバスでそのアイコンを選択して、各配列項目に対して期待される属性を表示できます。
フィールドのプロパティ field-properties
キャンバスで任意のフィールドの名前を選択すると、右側のレールが更新され、そのフィールドの詳細が以下に表示されます。 フィールドのプロパティ. これには、フィールドの意図した使用例の説明、デフォルト値、パターン、形式、必須フィールドかどうかなどが含まれます。
検査中のフィールドが列挙フィールドの場合、右側のレールには、フィールドが受け取ると想定される有効な値も表示されます。
ID フィールド identity
ID フィールドを含むスキーマを検査する場合、これらのフィールドは、スキーマに提供するクラスまたはフィールドグループの下の左側のレールに表示されます。 左側のレールで ID フィールド名を選択して、フィールドがネストされている深さに関係なく、キャンバスにフィールドを表示します。
キャンバス上で ID フィールドが指紋アイコン (
関係フィールド relationship
関係フィールドを含むスキーマを調べる場合、フィールドは左側のレールの下に一覧表示されます。 関係. 左側のレールで関係フィールド名を選択して、フィールドがネストされている深さに関係なく、キャンバスにフィールドを表示します。
また、関係フィールドはキャンバスで一意にハイライト表示され、フィールドがリンクする参照スキーマの名前が表示されます。 関係フィールドの名前を選択した場合は、参照スキーマのプライマリ ID の ID 名前空間を右側のパネルに表示できます。
次の手順
このドキュメントでは、Experience PlatformUI で既存の XDM リソースを参照する方法を説明しました。 の様々な機能の詳細 スキーマ ワークスペースと Schema Editorを参照し、 スキーマ workspace の概要.