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

このガイドでは、Adobe Experience Platform UIで組織のエクスペリエンスデータモデル(XDM)スキーマを作成、編集、管理する方法の概要を説明します。

重要

XDMスキーマは非常にカスタマイズ可能なので、スキーマの作成手順は、スキーマに取り込むデータの種類に応じて異なる場合があります。 その結果、このドキュメントでは、UIのスキーマで実行できる基本的なインタラクションについてのみ説明し、クラス、スキーマフィールドグループ、データタイプ、フィールドのカスタマイズなどの関連手順は除外します。

スキーマ作成プロセスの完全なツアーについては、『スキーマ作成のチュートリアル』に従って、完全なサンプルスキーマを作成し、Schema Editorの多くの機能に慣れてください。

前提条件

このガイドでは、XDMシステムに関する十分な知識が必要です。 Experience Platformエコシステム内でのXDMの役割の概要については、XDMの概要を、スキーマの構築方法の概要については、スキーマ構成の基本を参照してください。

新しいスキーマの作成

「スキーマ」ワークスペースで、右上隅の「スキーマ​を作成」を選択します。 表示されるドロップダウンで、XDM Individual Profile​と​XDM ExperienceEvent​のどちらをスキーマの基本クラスにするかを選択できます。 または、「参照」を選択して、使用可能なクラスの完全なリストから選択するか、代わりに新しいカスタムクラスを作成します。

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

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

既存のスキーマの編集

メモ

データ取り込みでスキーマを保存して使用した後は、追加的な変更のみを加えることができます。 詳しくは、スキーマ進化のルールを参照してください。

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

ヒント

ワークスペースの検索およびフィルタリング機能を使用すると、スキーマを見つけやすくなります。 詳しくは、XDMリソースのガイドを参照してください。

スキーマを選択すると、キャンバスにスキーマの構造が表示されたSchema Editorが表示されます。 スキーマが使用する場合は、フィールドグループをスキーマに追加したり、フィールドの表示名を編集したり、既存のカスタムフィールドグループを編集したりできるようになりました。

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

メモ

この節では、既存のフィールドグループをスキーマに追加する方法について説明します。 新しいカスタムフィールドグループを作成する場合は、代わりにフィールドグループの作成と編集に関するガイドを参照してください。

Schema Editor内でスキーマを開いたら、フィールドグループを使用してスキーマにフィールドを追加できます。 開始するには、左側のレールで、「フィールドグループ」の横にある「追加」を選択します。

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

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

メモ

XDMでの業界固有のデータモデリングのベストプラクティスについて詳しくは、業界データモデルに関するドキュメントを参照してください。

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

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

ヒント

リストに表示されたフィールドグループに対して、情報アイコン()にマウスポインターを置くか、情報アイコン()にフォーカスすると、フィールドグループが取り込むデータの種類に関する簡単な説明が表示されます。 また、プレビューアイコン()を選択して、フィールドグループをスキーマに追加する前に提供されたフィールドの構造を確認することもできます。

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

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

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

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

重要

Profileのスキーマを有効にするには、プライマリIDフィールドが定義されている必要があります。 詳しくは、IDフィールドの定義に関するガイドを参照してください。

スキーマを有効にするには、まず左側のレールでスキーマの名前を選択し、次に右側のレールで「プロファイル」切り替えを選択します。

スキーマが有効化および保存されると、無効にできないという警告を示すポップオーバーが表示されます。 「有効」を選択して続行します。

「プロファイル」切り替えを有効にしてキャンバスが再び表示されます。

重要

スキーマはまだ保存されていないので、スキーマをリアルタイム顧客プロファイルに参加させることについての考えを変更した場合、戻り値ポイントはありません。有効なスキーマを保存すると、無効にできなくなります。 「プロファイル」切り替えをもう一度選択して、スキーマを無効にします。

プロセスを終了するには、「保存」を選択してスキーマを保存します。

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

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

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

メモ

標準のクラスまたはフィールドグループに属するフィールドの表示名は、特定のスキーマのコンテキストでのみ編集できます。 つまり、1つのスキーマ内の標準フィールドの表示名を変更しても、同じ関連付けられたクラスまたはフィールドグループを使用する他のスキーマには影響しません。

スキーマのフィールドの表示名を変更すると、その変更は、そのスキーマに基づく既存のデータセットに即座に反映されます。

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

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

スキーマのクラスの変更

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

警告

スキーマのクラスの再割り当ては、細心の注意を払っておこなう必要があります。 フィールドグループは、特定のクラスとのみ互換性があるので、クラスを変更するとキャンバスと追加したフィールドがリセットされます。

クラスを再割り当てするには、キャンバスの左側で「割り当て」を選択します。

ダイアログが開き、組織で定義されたクラス(所有者は「Customer」)と、Adobeで定義された標準クラスを含む、使用可能なすべてのクラスのリストが表示されます。

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

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

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

次の手順

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

スキーマワークスペースの機能について詳しくは、スキーマワークスペースの概要を参照してください。

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

このページ