Schema Editor を使用した 2 つのスキーマ間における 1 対 1 の関係を定義
作成対象:
- 開発者
様々なチャネルでの顧客とブランドとの関係を理解する能力は、Adobe Experience Platform の重要な部分です。Experience Data Model (XDM)スキーマの構造でこれらの関係を定義すると、顧客データに対する複雑なインサイトを得ることができます。
スキーマの関係は、結合スキーマと Real-Time Customer Profile を使用して推論できますが、同じクラスを共有するスキーマにのみ適用されます。 異なるクラスに属する 2 つのスキーマ間の関係を確立するには、専用の関係フィールドをソーススキーマに追加する必要があります。このスキーマは、他の関連スキーマの ID を参照します。
このドキュメントでは、Experience Platform ユーザーインターフェイスのスキーマエディターを使用して、2 つのスキーマ間の関係を定義するチュートリアルを提供します。 API を使用してスキーマ関係を定義する手順については、スキーマレジストリ API を使用した関係の定義についてのチュートリアルを参照してください。
はじめに
このチュートリアルでは、Experience Platform UI の XDM System とスキーマエディターに関する十分な知識が必要です。 このチュートリアルを始める前に、次のドキュメントを確認してください。
- Experience Platformの XDM システム:XDM と Experience Platform での実装の概要です。
- スキーマ構成の基本: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
カスタムの「Hotel ID」 ID 名前空間を使用して、スキーマのプライマリ ID として機能します。
関係フィールドグループの作成
2 つのスキーマ間の関係を定義するには、ソーススキーマに、参照スキーマのプライマリ ID を示す専用フィールドが必要です。 このフィールドをソーススキーマに追加するには、新しいスキーマフィールドグループを作成するか、既存のスキーマフィールドグループを拡張します。
Loyalty Members スキーマの場合、新しい preferredHotel
フィールドが追加され、企業訪問に対するロイヤルティメンバーの優先ホテルを示します。 まず、ソーススキーマ名の横にあるプラスアイコン(+)を選択します。
新規フィールドプレースホルダーがキャンバスに表示されます。 「フィールドプロパティ」で、フィールド名とフィールドの表示名を指定し、タイプを「 文字列 」に設定します。 「割り当て先」で、拡張する既存のフィールドグループを選択するか、一意の名前を入力して新しいフィールドグループを作成します。 この場合、新しい「Preferred Hotel」フィールドグループが作成されます。
完了したら、「適用」を選択します。
更新された preferredHotel
フィールドは、カスタムフィールドなので、_tenantId
オブジェクトの下のキャンバスに表示されます。 「保存」を選択して、スキーマに対する変更を最終決定します。
ソーススキーマで関係フィールドを定義
ソーススキーマに専用の参照フィールドが定義されたら、それを関係フィールドとして指定できます。
キャンバスで「preferredHotel
」フィールドを選択し、フィールドプロパティ サイドバーで 関係を追加 を選択します。
関係を追加 ダイアログが表示されます。 このダイアログから、関係フィールドを設定するために必要なパラメーターを設定できます。 Real-Time CDP B2C ユーザーの場合は、ソーススキーマと参照スキーマの間に 1 対 1 の関係を のみ 設定できます。
参照スキーマ のドロップダウンを使用し、関係の参照スキーマを選択します(この例では「Hotels」)。
参照スキーマの ID 名前空間(この場合は「Hotel ID」)は、参照 ID 名前空間 の下に自動的に入力されます。 終了したら「適用」を選択します。
キャンバスで「preferredHotel
」フィールドが関係としてハイライト表示され、参照スキーマの名前が表示されるようになりました。 「保存」を選択して変更を保存し、ワークフローを完了します。
既存の関係フィールドを編集
参照スキーマを変更するには、既存の関係を持つフィールドを選択し、フィールドプロパティ サイドバーで 関係を編集 を選択します。
関係を編集 ダイアログが表示されます。 ここから、 関係フィールドの定義で説明されているプロセスに従うか、関係を削除できます。 「関係を削除」を選択して、参照スキーマへの関係を削除します。
関係のフィルタリングと検索
スキーマ ワークスペースの「 関係 」タブから、スキーマ内の特定の関係をフィルタリングして検索できます。 このビューを使用すると、関係をすばやく見つけて管理できます。 フィルタリングオプションの手順について詳しくは、 スキーマリソースの調査に関するドキュメントを参照してください。
次の手順
このチュートリアルでは、Schema Editor を使用して 2 つのスキーマ間に 1 対 1 の関係を正常に作成しました。 API を使用して関係を定義する手順については、スキーマレジストリ API を使用した関係の定義についてのチュートリアルを参照してください。