Schema Editor を使用した 2 つのスキーマ間における 1 対 1 の関係を定義 relationship-ui

様々なチャネルでの顧客とブランドとの関係を理解する能力は、Adobe Experience Platform の重要な部分です。 Experience Data Model (XDM) スキーマの構造内でこれらの関係を定義すると、顧客データに関する複雑なインサイトを得ることができます。

スキーマの関係は、結合スキーマと Real-Time Customer Profile を使用して推論できますが、同じクラスを共有するスキーマにのみ適用されます。 異なるクラスに属する2つのスキーマ間の関係を確立するには、他の関連スキーマのIDを参照するソーススキーマに専用の関係フィールドを追加する必要があります。

NOTE
ソース スキーマと宛先スキーマの両方が同じクラスに属している場合は、専用の関係フィールドを​ not ​使用する必要があります。 この場合、結合スキーマ UIを使用して、関係を確認します。 この方法に関する説明は、結合スキーマ UI ガイドの関係の表示 セクションにあります。

このドキュメントでは、Experience Platform ユーザーインターフェイスのスキーマエディターを使用して、2つのスキーマ間の関係を定義するためのチュートリアルを提供します。 API を使用してスキーマ関係を定義する手順については、スキーマレジストリ API を使用した関係の定義についてのチュートリアルを参照してください。

NOTE
Adobe Real-Time Customer Data Platform B2B editionで多対1のリレーションシップを作成する手順については、B2B リレーションシップの作成に関するガイドを参照してください。

はじめに

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

ソースと参照スキーマの定義

この関係で定義される 2 つのスキーマが既に作成されていると想定されます。 このチュートリアルでは、デモンストレーションの目的で、組織のロイヤルティプログラム(「Loyalty Members」スキーマで定義)のメンバーと、お気に入りのホテル(「Hotels」スキーマで定義)の関係を作成します。

IMPORTANT
関係を確立するには、両方のスキーマでプライマリ IDを定義し、Real-Time Customer Profileに対して有効にする必要があります。 それに応じてスキーマを設定する方法に関するガイダンスが必要な場合は、スキーマ作成チュートリアルの「​ プロファイル ​で使用するためのスキーマの有効化」の節を参照してください。

スキーマ関係は、参照スキーマ​内の別のフィールドを指す​ ソーススキーマ ​内の専用フィールドで表されます。 次の手順では、「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として機能します。

​ プロファイルを有効にする

NOTE
カスタム ID名前空間の作成方法については、ID サービスのドキュメント ​を参照してください。

関係フィールドグループの作成

NOTE
この手順は、ソーススキーマに、参照スキーマのプライマリ IDへのポインターとして使用する専用の文字列型フィールドがない場合にのみ必要です。 このフィールドがソーススキーマで既に定義されている場合は、次の関係フィールドを定義する手順に進んでください。

2つのスキーマ間の関係を定義するには、ソーススキーマに、参照スキーマのプライマリ IDを示す専用フィールドが必要です。 このフィールドをソーススキーマに追加するには、新しいスキーマフィールドグループを作成するか、既存のスキーマフィールドグループを拡張します。

Loyalty Members スキーマの場合、ロイヤルティメンバーが会社訪問に好むホテルを示す新しいpreferredHotel フィールドが追加されます。 まず、ソーススキーマの名前の横にあるプラスアイコン(+)を選択します。

新しいフィールドプレースホルダーがキャンバスに表示されます。 フィールドプロパティ​で、フィールドのフィールド名と表示名を指定し、そのタイプを「文字列」に設定します。 割り当て​で、拡張する既存のフィールドグループを選択するか、一意の名前を入力して新しいフィールドグループを作成します。 この場合、新しい「Preferred Hotel」フィールドグループが作成されます。

完了したら、適用​を選択します。

更新されたpreferredHotel フィールドは、カスタムフィールドであるため、_tenantId オブジェクトの下にあるキャンバスに表示されます。 保存​を選択して、スキーマの変更を確定します。

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

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

NOTE
関係は、文字列または文字列配列フィールドでのみサポートできます。

キャンバスで「preferredHotel」フィールドを選択し、フィールドプロパティ サイドバーで「関係を追加」を選択します。

​ フィールドプロパティのサイドバーで「関係を追加」がハイライト表示されたスキーマエディター。

関係を追加 ダイアログが表示されます。 このダイアログから、関係フィールドの設定に必要なパラメーターを設定できます。 Real-Time CDP B2C ユーザーの場合、ソースと参照スキーマの間に1対1のリレーションシップを​ のみ ​設定できます。

NOTE
Real-Time CDP B2B editionにアクセスできる場合は、カンバスの右パネルのコントロールを使用してリレーションシップフィールドを定義したり、同じダイアログ ​を使用して多対1のリレーションシップを構築したりできます。

関係を追加ダイアログ。

参照スキーマ​のドロップダウンを使用し、関係の参照スキーマを選択します(この例では「Hotels」)。

NOTE
プライマリ IDを含むスキーマのみが、参照スキーマドロップダウンメニューに含まれます。 この保護機能により、まだ適切に設定されていないスキーマとの関係を誤って作成するのを防ぐことができます。

参照スキーマのID名前空間(この場合は「Hotel ID」)は、参照ID名前空間​の下に自動的に入力されます。 完了したら、適用​を選択します。

関係パラメーターが設定され、適用が強調表示された関係を追加ダイアログ。

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

関係の参照と保存が強調表示されたスキーマエディター。

既存の関係フィールドの編集 edit-relationship

参照スキーマを変更するには、既存の関係を持つフィールドを選択し、フィールドプロパティ サイドバーの​ 関係を編集 ​を選択します。

関係を編集するスキーマエディターがハイライト表示されます。

関係を編集 ダイアログが表示されます。 ここから、関係フィールドの定義に記載されているプロセスに従うか、関係を削除できます。 「関係を削除」を選択して、参照スキーマとの関係を削除します。

関係を編集ダイアログ。

​ スキーマ ​ ワークスペースの「関係」タブから、スキーマ内の特定の関係をフィルタリングして検索できます。 このビューを使用すると、関係をすばやく検索して管理できます。 フィルターオプションの詳細な手順については、​ スキーマリソースの探索に関するドキュメントを参照してください。

​ スキーマワークスペースの「関係」タブ。

次の手順

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

recommendation-more-help
experience-platform-help-xdm