Schema Editor を使用した 2 つのスキーマ間における 1 対 1 の関係を定義 relationship-ui
様々なチャネルでの顧客とブランドとの関係を理解する能力は、Adobe Experience Platform の重要な部分です。 Experience Data Model (XDM) スキーマの構造内でこれらの関係を定義すると、顧客データに関する複雑なインサイトを得ることができます。
スキーマの関係は、結合スキーマと Real-Time Customer Profile を使用して推論できますが、同じクラスを共有するスキーマにのみ適用されます。 異なるクラスに属する2つのスキーマ間の関係を確立するには、他の関連スキーマのIDを参照するソーススキーマに専用の関係フィールドを追加する必要があります。
このドキュメントでは、Experience Platform ユーザーインターフェイスのスキーマエディターを使用して、2つのスキーマ間の関係を定義するためのチュートリアルを提供します。 API を使用してスキーマ関係を定義する手順については、スキーマレジストリ API を使用した関係の定義についてのチュートリアルを参照してください。
はじめに
このチュートリアルでは、XDM SystemとExperience Platform UIのスキーマエディターに関する実務的な理解が必要です。 このチュートリアルを始める前に、次のドキュメントを確認してください。
- Experience PlatformのXDM システム : Experience PlatformでのXDMとその実装の概要。
- スキーマ構成の基本:XDM スキーマの構築ブロックの紹介。
- を使用してスキーマを作成する Schema Editor: Schema Editorの操作の基本を説明するチュートリアル。
ソースと参照スキーマの定義
この関係で定義される 2 つのスキーマが既に作成されていると想定されます。 このチュートリアルでは、デモンストレーションの目的で、組織のロイヤルティプログラム(「Loyalty Members」スキーマで定義)のメンバーと、お気に入りのホテル(「Hotels」スキーマで定義)の関係を作成します。
スキーマ関係は、参照スキーマ内の別のフィールドを指す ソーススキーマ 内の専用フィールドで表されます。 次の手順では、「Loyalty Members」がソーススキーマになり、「Hotels」が参照スキーマとして機能します。
次の節では、関係が定義される前に、このチュートリアルで使用する各スキーマの構造について説明します。
Loyalty Members スキーマ
ソーススキーマ「Loyalty Members」は、ロイヤルティプログラムのメンバーを表すフィールドを含むXDM Individual Profile クラスに基づいています。 これらのフィールドの1つであるpersonalEmail.addessは、電子メール 名前空間のスキーマのプライマリ IDとして機能します。 スキーマのプロパティで見られるように、このスキーマはReal-Time Customer Profileで使用できるように有効になっています。
Hotels スキーマ
参照スキーマ「Hotels」は、カスタム「Hotels」クラスに基づいており、ホテルを説明するフィールドが含まれています。 関係に参加するには、参照スキーマにもプライマリ IDが定義され、 プロファイル に対して有効になっている必要があります。 この場合、_tenantId.hotelIdは、カスタム ID名前空間「Hotel ID」を使用して、スキーマのプライマリ IDとして機能します。
関係フィールドグループの作成
2つのスキーマ間の関係を定義するには、ソーススキーマに、参照スキーマのプライマリ IDを示す専用フィールドが必要です。 このフィールドをソーススキーマに追加するには、新しいスキーマフィールドグループを作成するか、既存のスキーマフィールドグループを拡張します。
Loyalty Members スキーマの場合、ロイヤルティメンバーが会社訪問に好むホテルを示す新しいpreferredHotel フィールドが追加されます。 まず、ソーススキーマの名前の横にあるプラスアイコン(+)を選択します。
新しいフィールドプレースホルダーがキャンバスに表示されます。 フィールドプロパティで、フィールドのフィールド名と表示名を指定し、そのタイプを「文字列」に設定します。 割り当てで、拡張する既存のフィールドグループを選択するか、一意の名前を入力して新しいフィールドグループを作成します。 この場合、新しい「Preferred Hotel」フィールドグループが作成されます。
完了したら、適用を選択します。
更新されたpreferredHotel フィールドは、カスタムフィールドであるため、_tenantId オブジェクトの下にあるキャンバスに表示されます。 保存を選択して、スキーマの変更を確定します。
ソーススキーマで関係フィールドを定義 relationship-field
ソーススキーマに専用の参照フィールドが定義されたら、それを関係フィールドとして指定できます。
キャンバスで「preferredHotel」フィールドを選択し、フィールドプロパティ サイドバーで「関係を追加」を選択します。
関係を追加 ダイアログが表示されます。 このダイアログから、関係フィールドの設定に必要なパラメーターを設定できます。 Real-Time CDP B2C ユーザーの場合、ソースと参照スキーマの間に1対1のリレーションシップを のみ 設定できます。
参照スキーマのドロップダウンを使用し、関係の参照スキーマを選択します(この例では「Hotels」)。
参照スキーマのID名前空間(この場合は「Hotel ID」)は、参照ID名前空間の下に自動的に入力されます。 完了したら、適用を選択します。
preferredHotel フィールドが、参照スキーマの名前を示すリレーションシップとしてキャンバス内でハイライト表示されるようになりました。 保存を選択して変更を保存し、ワークフローを完了します。
既存の関係フィールドの編集 edit-relationship
参照スキーマを変更するには、既存の関係を持つフィールドを選択し、フィールドプロパティ サイドバーの 関係を編集 を選択します。
関係を編集 ダイアログが表示されます。 ここから、関係フィールドの定義に記載されているプロセスに従うか、関係を削除できます。 「関係を削除」を選択して、参照スキーマとの関係を削除します。
関係のフィルターと検索 filter-and-search
スキーマ ワークスペースの「関係」タブから、スキーマ内の特定の関係をフィルタリングして検索できます。 このビューを使用すると、関係をすばやく検索して管理できます。 フィルターオプションの詳細な手順については、 スキーマリソースの探索に関するドキュメントを参照してください。
次の手順
このチュートリアルでは、Schema Editorを使用して2つのスキーマ間に1対1の関係を作成しました。 API を使用して関係を定義する手順については、スキーマレジストリ API を使用した関係の定義についてのチュートリアルを参照してください。