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

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

重要

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

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

前提条件

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

新しいスキーマを作成

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

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

これで、ミックスインを追加することで、スキーマの構造を構築する開始を作成できます。

既存のスキーマの編集

メモ

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

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

ヒント

Workspaceの検索およびフィルター機能を使用して、スキーマを簡単に見つけることができます。 詳しくは、XDMリソースのガイドを参照してください。

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

スキーマへの mixin の追加

メモ

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

Schema Editor内でスキーマを開くと、ミックスインを使用してスキーマにフィールドを追加できます。 開始するには、左側のレールで​ミックスイン​の横の追加​​を選択します。

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

検索バーを使用して、目的のMixinを見つけることができます。 名前がクエリと一致するミックスインは、リストの上部に表示されます。 「標準フィールド」の下に、必要なデータ属性を説明するフィールドを含むミックスインが表示されます。

スキーマに追加するミックスインの名前の横にあるチェックボックスを選択します。 リストから複数のミックスインを選択できます。選択した各ミックスインが右側のレールに表示されます。

ヒント

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

ミックスインを選択したら、ミックスイン​追加を選択してスキーマに追加します。

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

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

リアルタイム顧客 プロファイルは、異なるソースからデータを抽出し、各顧客の完全な表示を構築します。スキーマが取り込んだデータをこのプロセスに参加させる場合は、Profileでの使用をスキーマに有効にする必要があります。

重要

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

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

スキーマを有効にして保存すると、無効にできないという警告が表示されます。 続行するには、​を有効にする」を選択します。

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

重要

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

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

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

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

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

メモ

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

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

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

スキーマのクラスを変更

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

警告

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

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

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

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

新しいダイアログが開き、新しいクラスを割り当てるかどうかを確認するメッセージが表示されます。 「割り当て」を選択して確認します。

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

次の手順

このドキュメントでは、プラットフォームUIでのスキーマの作成と編集の基本について説明します。 独自の用途向けのカスタムミックスインやデータタイプの作成など、UIで完全なスキーマを構築するための包括的なワークフローについては、スキーマ作成チュートリアルを確認することを強くお勧めします。

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

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

このページ