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 を使用した関係の定義についてのチュートリアルを参照してください。

はじめに

このチュートリアルでは、Experience Platform UI の XDM System とスキーマエディターに関する十分な知識が必要です。 このチュートリアルを始める前に、次のドキュメントを確認してください。

ソースおよび参照スキーマの定義

この関係で定義される 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 オブジェクトの下のキャンバスに表示されます。 「保存」を選択して、スキーマに対する変更を最終決定します。

ソーススキーマで関係フィールドを定義 relationship-field

ソーススキーマに専用の参照フィールドが定義されたら、それを関係フィールドとして指定できます。

キャンバスで「preferredHotel」フィールドを選択し、「フィールドのプロパティ の下を下にスクロールして、「関係」チェックボックスを表示します。 このチェックボックスを選択すると、関係フィールドを設定するために必要なパラメーターが表示されます。

参照スキーマ のドロップダウンを選択し、関係の参照スキーマを選択します（この例では「Hotels」）。 参照 ID 名前空間 で、参照スキーマの ID フィールド（この場合は「Hotel ID」）の名前空間を選択します。 終了したら「適用」を選択します。

キャンバスで「preferredHotel」フィールドが関係としてハイライト表示され、参照スキーマの名前が表示されるようになりました。 「保存」を選択して変更を保存し、ワークフローを完了します。

次の手順

このチュートリアルでは、Schema Editor を使用して 2 つのスキーマ間に 1 対 1 の関係を正常に作成しました。 API を使用して関係を定義する手順については、スキーマレジストリ API を使用した関係の定義についてのチュートリアルを参照してください。