UI でのスキーマの作成と編集

このガイドでは、Adobe Experience Platform UI で組織の Experience Data Model(XDM) スキーマを作成、編集、管理する方法の概要を説明します。

重要

XDM スキーマは非常にカスタマイズ可能なので、スキーマの作成に必要な手順は、スキーマが取得するデータの種類に応じて異なる場合があります。 その結果、このドキュメントでは、UI のスキーマで実行できる基本的なインタラクションのみを扱い、クラス、スキーマフィールドグループ、データタイプ、フィールドのカスタマイズなどの関連手順を除外します。

スキーマ作成プロセスの完全なツアーについては、 スキーマ作成チュートリアル 完全なサンプルスキーマを作成し、の多くの機能に慣れるには、以下を実行します。 Schema Editor.

前提条件

このガイドでは、XDM システムに関する十分な知識が必要です。 詳しくは、 XDM の概要 Experience Platformエコシステム内での XDM の役割、および スキーマ構成の基本 スキーマの構築方法の概要を示します。

新しいスキーマの作成

内 スキーマ ワークスペース、選択 スキーマを作成 をクリックします。 表示されるドロップダウンで、次の中から選択できます XDM 個人プロファイル および XDM ExperienceEvent をスキーマの基本クラスとして使用します。 または、 参照 使用可能なクラスの完全なリストから選択する場合、または 新しいカスタムクラスの作成 代わりに、

クラスを選択すると、 Schema Editor が表示され、スキーマの基本構造(クラスで指定)がキャンバスに表示されます。 ここから、右側のレールを使用して 表示名 および 説明 スキーマの

これで、次の方法でスキーマの構造の構築を開始できます。 スキーマフィールドグループの追加.

既存のスキーマの編集

メモ

スキーマを保存し、データ取り込みで使用した後は、追加的な変更のみを加えることができます。 詳しくは、 スキーマ進化のルール を参照してください。

既存のスキーマを編集するには、 参照 タブをクリックし、編集するスキーマの名前を選択します。

ヒント

ワークスペースの検索およびフィルタリング機能を使用すると、スキーマを見つけやすくなります。 詳しくは、 XDM リソースの調査 を参照してください。

スキーマを選択すると、 Schema Editor が表示され、スキーマの構造がキャンバスに表示されます。 次の操作を実行できます。 フィールドグループを追加 スキーマ ( または 個々のフィールドを追加 これらのグループから ) フィールドの表示名を編集または 既存のカスタムフィールドグループの編集 スキーマが適用する場合。

スキーマへのフィールドグループの追加

メモ

この節では、既存のフィールドグループをスキーマに追加する方法について説明します。 新しいカスタムフィールドグループを作成する場合は、 フィールドグループの作成と編集 代わりに、

以下の Schema Editorに値を入力する場合は、フィールドグループを使用してスキーマにフィールドを追加できます。 開始するには、 追加 次の フィールドグループ をクリックします。

ダイアログが開き、スキーマ用に選択できるフィールドグループのリストが表示されます。 フィールドグループは 1 つのクラスとのみ互換性があるので、スキーマの選択されたクラスに関連付けられているフィールドグループのみが表示されます。 デフォルトでは、リストに表示されるフィールドグループは、組織内での使用頻度に基づいて並べ替えられます。

追加するフィールドの一般的なアクティビティまたはビジネス領域がわかっている場合は、左側のレールから業種別のカテゴリを 1 つ以上選択して、表示されるフィールドグループのリストをフィルタリングします。

メモ

XDM での業界固有のデータモデリングのベストプラクティスについて詳しくは、 業界データモデル.

また、検索バーを使用して、目的のフィールドグループを見つけることもできます。 クエリと名前が一致するフィールドグループがリストの上部に表示されます。 の下 標準フィールド、目的のデータ属性を記述するフィールドを含むフィールドグループが表示されます。

スキーマに追加するフィールドグループの名前の横にあるチェックボックスを選択します。 リストから複数のフィールドグループを選択できます。選択した各フィールドグループが右側のパネルに表示されます。

ヒント

リストに表示されたフィールドグループで、情報アイコン () をクリックすると、フィールドグループが取り込むデータの種類に関する簡単な説明が表示されます。 プレビューアイコン () を使用して、スキーマに追加する前にフィールドグループが提供するフィールドの構造を表示できます。

フィールドグループを選択したら、「 」を選択します。 フィールドグループを追加 スキーマに追加します。

この Schema Editor フィールドグループが指定したフィールドがキャンバスに表示された状態で再表示されます。

スキーマにフィールドグループを追加した後、オプションで 既存のフィールドを削除 または 新しいカスタムフィールドを追加 必要に応じて、これらのグループに追加します。

フィールドグループから追加されたフィールドを削除

スキーマにフィールドグループを追加した後、不要なフィールドを削除できます。

メモ

フィールドグループからフィールドを削除しても、作業中のスキーマにのみ影響し、フィールドグループ自体には影響しません。 1 つのスキーマ内のフィールドを削除した場合、同じフィールドグループを使用する他のすべてのスキーマでも、これらのフィールドを引き続き使用できます。

次の例では、標準フィールドグループが 人口統計の詳細 がスキーマに追加されました。 次のような単一のフィールドを削除するには taxIdをクリックし、キャンバスのフィールドを選択して、「 」を選択します。 削除 をクリックします。

単一のフィールドを削除

削除するフィールドが複数ある場合は、フィールドグループ全体を管理できます。 キャンバスでグループに属するフィールドを選択し、「 」を選択します。 関連するフィールドの管理 をクリックします。

関連するフィールドの管理

該当するフィールドグループの構造を示すダイアログが表示されます。 ここから、提供されたチェックボックスを使用して、必要なフィールドを選択または選択解除できます。 満足したら、「 」を選択します。 確認.

フィールドグループからフィールドを選択

キャンバスが再び表示され、選択したフィールドのみがスキーマ構造に存在します。

追加されたフィールド

フィールドグループにカスタムフィールドを追加する

スキーマにフィールドグループを追加した後、そのグループの追加フィールドを定義できます。 ただし、あるスキーマ内のフィールドグループに追加されたフィールドは、同じフィールドグループを使用する他のすべてのスキーマにも表示されます。

また、標準フィールドグループにカスタムフィールドを追加すると、そのフィールドグループはカスタムフィールドグループに変換され、元の標準フィールドグループは使用できなくなります。

標準フィールドグループにカスタムフィールドを追加する場合は、 以下の節 を参照してください。 カスタムフィールドグループにフィールドを追加する場合は、 カスタムフィールドグループの編集 」を参照してください。

既存のフィールドグループを変更しない場合は、 新しいカスタムフィールドグループを作成する を使用して、追加のフィールドを定義します。

スキーマへの個々のフィールドの追加

スキーマエディターを使用すると、特定の使用例に対してフィールドグループ全体が追加されるのを避けたい場合に、個々のフィールドを直接スキーマに追加できます。 以下が可能です。 標準フィールドグループから個々のフィールドを追加 または 独自のカスタムフィールドの追加 代わりに、

重要

スキーマエディターでは機能的に個々のフィールドを直接スキーマに追加できますが、XDM スキーマ内のすべてのフィールドは、そのクラスまたはそのクラスと互換性のあるフィールドグループによって提供される必要があるという事実は変わりません。 以下の節で説明するように、個々のフィールドは、スキーマに追加する際に、キーステップとしてフィールドグループに関連付けられます。

標準フィールドを追加

事前に対応するフィールドグループを把握しておく必要なく、標準フィールドグループのフィールドを直接スキーマに追加できます。 標準フィールドをスキーマに追加するには、プラス (+) アイコンをクリックします。 An 名称未設定フィールド プレースホルダーがスキーマ構造に表示され、右側のレールが更新されて、フィールドを設定するコントロールが表示されます。

フィールドプレースホルダー

の下 フィールド名​追加するフィールドの名前を入力します。 クエリに一致する標準フィールドが自動的に検索され、以下にリストされます。 推奨される標準フィールド(所属するフィールドグループを含む)

推奨される標準フィールド

一部の標準フィールドは同じ名前を共有しますが、構造は、その標準フィールドの元のフィールドグループによって異なる場合があります。 標準フィールドがフィールドグループ構造内の親オブジェクト内にネストされている場合、子フィールドが追加されると、親フィールドもスキーマに含まれます。

プレビューアイコン (プレビューアイコン) をクリックし、標準フィールドの横に表示されます。 標準フィールドをスキーマに追加するには、プラスアイコン (プラスアイコン) をクリックします。

標準フィールドを追加

キャンバスが更新され、フィールドグループ構造内でネストされている親フィールドを含む、スキーマに追加された標準フィールドが表示されます。 フィールドグループの名前も、以下に表示されます。 フィールドグループ をクリックします。 同じフィールドグループからさらにフィールドを追加する場合は、 関連するフィールドの管理 をクリックします。

追加された標準フィールド

カスタムフィールドの追加

標準フィールドのワークフローと同様に、独自のカスタムフィールドを直接スキーマに追加することもできます。

スキーマのルートレベルにフィールドを追加するには、プラス (+) アイコンをクリックします。 An 名称未設定フィールド プレースホルダーがスキーマ構造に表示され、右側のレールが更新されて、フィールドを設定するコントロールが表示されます。

ルートカスタムフィールド

追加するフィールドの名前を入力すると、一致する標準フィールドの検索が自動的に開始されます。 代わりに新しいカスタムフィールドを作成するには、 (新規フィールド).

新しいフィールド

ここから、フィールドの表示名とデータタイプを指定します。 の下 フィールドグループを割り当て​に値を入力する場合は、新しいフィールドを関連付けるフィールドグループを選択する必要があります。 以前にフィールドグループの名前を入力したことがある場合は、その名前を入力します 作成されたカスタムフィールドグループ ドロップダウンリストに表示されます。 または、フィールドに一意の名前を入力して、新しいフィールドグループを作成することもできます。

フィールドグループを選択

警告

既存のカスタムフィールドグループを選択した場合、そのフィールドグループを使用する他のスキーマも、変更を保存した後で、新しく追加されたフィールドを継承します。 このため、このタイプの伝播を行う場合は、既存のフィールド・グループを選択する必要があります。 それ以外の場合は、代わりに新しいカスタムフィールドグループを作成する必要があります。

終了したら、「 」を選択します。 適用.

フィールドを適用

新しいフィールドがキャンバスに追加され、名前空間がユーザーの下に表示されます テナント ID 標準 XDM フィールドとの競合を避けるために使用します。 新しいフィールドを関連付けたフィールドグループも、の下に表示されます。 フィールドグループ をクリックします。

テナント ID

メモ

選択したカスタムフィールドグループで提供されている残りのフィールドは、デフォルトでスキーマから削除されます。 これらのフィールドの一部をスキーマに追加する場合は、グループに属するフィールドを選択し、「 」を選択します。 関連するフィールドの管理 をクリックします。

標準フィールドグループの構造にカスタムフィールドを追加する

作業中のスキーマに、標準フィールドグループによって提供されるオブジェクトタイプのフィールドがある場合、独自のカスタムフィールドをその標準オブジェクトに追加できます。

警告

あるスキーマ内のフィールドグループに追加されたフィールドは、同じフィールドグループを使用する他のすべてのスキーマにも表示されます。 また、標準フィールドグループにカスタムフィールドを追加すると、そのフィールドグループはカスタムフィールドグループに変換され、元の標準フィールドグループは使用できなくなります。

この機能をベータ版に参加した場合は、以前にカスタマイズした標準フィールドグループを示すダイアログが表示されます。 次を選択したら、 確認​を指定した場合、一覧に表示されるリソースはカスタムフィールドグループに変換されます。

標準フィールドグループを変換するための確認ダイアログ

まず、プラス (+) アイコンをクリックし、標準フィールドグループで提供されるオブジェクトのルートの横に表示されます。

標準オブジェクトにフィールドを追加

標準フィールドグループを変換するかどうかを確認する警告メッセージが表示されます。 選択 引き続きフィールドグループを作成します をクリックして続行します。

フィールドグループのコンバージョンを確認

キャンバスが再び表示され、新しいフィールド用の名称未設定のプレースホルダーが表示されます。 標準フィールドグループの名前には、拡張)」という名前に変更され、元のバージョンから変更されたことを示します。 ここから、右側のレールのコントロールを使用して、フィールドのプロパティを定義します。

標準オブジェクトに追加されたフィールド

変更を適用すると、新しいフィールドが標準オブジェクト内のテナント ID 名前空間の下に表示されます。 このネストされた名前空間は、同じフィールドグループを使用する他のスキーマでの変更が壊れるのを防ぐために、フィールドグループ内のフィールド名の競合を防ぎます。

標準オブジェクトに追加されたフィールド

リアルタイム顧客プロファイルのスキーマの有効化

リアルタイム顧客プロファイル 異なるソースのデータを結合して、各顧客の完全なビューを構築します。 スキーマによって取得されたデータをこのプロセスに参加させる場合は、で使用するスキーマを有効にする必要があります。 Profile.

重要

のスキーマを有効にするには Profileに値を入力する場合は、プライマリ ID フィールドを定義する必要があります。 詳しくは、 ID フィールドの定義 を参照してください。

スキーマを有効にするには、まず左側のパネルでスキーマの名前を選択してから、 プロファイル 右側のパネルを切り替えます。

スキーマを有効にして保存すると、無効にできなくなることを警告するポップオーバーが表示されます。 選択 有効にする をクリックして続行します。

キャンバスが再び表示され、 プロファイル オン/オフを切り替えます。

重要

スキーマはまだ保存されていないので、スキーマをリアルタイム顧客プロファイルに参加させることに変更した場合、戻り値のポイントになりません。有効なスキーマを保存すると、無効にできなくなります。 を選択します。 プロファイル スキーマを無効にするには、再度切り替えます。

処理を終了するには、「 」を選択します。 保存 スキーマを保存します。

これで、スキーマがリアルタイム顧客プロファイルで使用できるようになります。 Platform がこのスキーマに基づいてデータをデータセットに取り込むと、そのデータは統合プロファイルデータに取り込まれます。

スキーマフィールドの表示名を編集

クラスを割り当て、フィールドグループをスキーマに追加したら、標準の XDM リソースで提供されているかカスタム XDM リソースで提供されているかに関係なく、スキーマのフィールドの表示名を編集できます。

メモ

標準のクラスまたはフィールドグループに属するフィールドの表示名は、特定のスキーマのコンテキストでのみ編集できます。 つまり、あるスキーマで標準フィールドの表示名を変更しても、同じ関連付けられたクラスまたはフィールドグループを使用する他のスキーマには影響しません。

スキーマのフィールドの表示名を変更すると、その変更は、そのスキーマに基づく既存のデータセットに直ちに反映されます。

スキーマフィールドの表示名を編集するには、キャンバスでフィールドを選択します。 右側のレールで、の下に新しい名前を入力します。 表示名.

選択 適用 右側のレールで、キャンバスが更新されて、フィールドの新しい表示名が表示されます。 選択 保存 をクリックして、変更をスキーマに適用します。

スキーマのクラスの変更

スキーマが保存される前の初期構成プロセス中の任意の時点で、スキーマのクラスを変更できます。

警告

スキーマのクラスの再割り当ては、非常に注意しておこなう必要があります。 フィールドグループは特定のクラスとのみ互換性があるので、クラスを変更するとキャンバスと追加したフィールドがリセットされます。

クラスを再割り当てするには、 割り当て をクリックします。

組織で定義されたクラス(所有者は「 」)を含む、使用可能なすべてのクラスのリストを表示するダイアログが表示されます顧客") およびAdobeで定義された標準クラス。

リストからクラスを選択し、ダイアログの右側に説明を表示します。 また、 クラス構造をプレビュー をクリックして、クラスに関連付けられているフィールドとメタデータを確認します。 選択 クラスを割り当て をクリックして続行します。

新しいクラスを割り当てるかどうかを確認する新しいダイアログが開きます。 選択 割り当て をクリックして確定します。

クラスの変更を確認した後、キャンバスがリセットされ、構成の進行状況がすべて失われます。

次の手順

このドキュメントでは、Platform UI でのスキーマの作成と編集の基本について説明します。 次の項目を確認することを強くお勧めします。 スキーマ作成チュートリアル :UI で完全なスキーマを構築するための包括的なワークフロー。一意の使用例のカスタムフィールドグループとデータタイプの作成を含みます。

の機能の詳細については、 スキーマ ワークスペース ( スキーマ workspace の概要.

でスキーマを管理する方法については、以下を参照してください。 Schema Registry API( スキーマエンドポイントガイド.

このページ