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

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

前提条件

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

新しいスキーマの作成

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

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

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

既存のスキーマの編集

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

標準フィールドを追加

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

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

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

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

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

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

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

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

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

フィールドに表示名とデータ型を指定した後、次の手順では、フィールドを親 XDM リソースに割り当てます。 スキーマでカスタムクラスを使用する場合、 割り当てられたクラスにフィールドを追加 または フィールドグループ 代わりに、 ただし、スキーマで標準クラスを使用する場合、カスタムフィールドをフィールドグループに割り当てることのみ可能です。

フィールドをカスタムフィールドグループに割り当てる

の下 割り当て先​を選択します。 フィールドグループ. スキーマで標準のクラスを使用する場合、これは唯一の使用可能なオプションで、デフォルトで選択されます。

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

リストからフィールドグループを選択した後、「 」を選択します。 適用.

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

フィールドをカスタムクラスに割り当てる

の下 割り当て先​を選択します。 クラス. 以下の入力フィールドは、現在のスキーマのカスタムクラスの名前に置き換えられ、新しいフィールドがこのクラスに割り当てられることを示します。

必要に応じてフィールドの設定を続行し、「 」を選択します。 適用 終了したとき。

新しいフィールドがキャンバスに追加され、名前空間がユーザーの下に表示されます テナント ID 標準 XDM フィールドとの競合を避けるために使用します。 左側のレールでクラス名を選択すると、新しいフィールドがクラスの構造の一部として表示されます。

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

スキーマのクラスの変更

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

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

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

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

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

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

次の手順

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

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

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

Business.Adobe.com リソース