UI を使用したデータタイプの作成と編集 ui-create-and-edit

エクスペリエンスデータモデル（XDM）では、データタイプは、複数のサブフィールドを含む再利用可能なフィールドです。 複数フィールド構造を一貫して使用できるという点では、スキーマフィールドグループに似ていますが、データタイプは、スキーマ構造の任意の場所に含めることができるのに対して、フィールドグループはルートレベルでのみ追加できるので、より柔軟です。

Adobe Experience Platformには、一般的なエクスペリエンス管理の様々なユースケースに対応するために使用できる、多くの標準データタイプが用意されています。 ただし、独自のビジネスニーズに対応するために、独自のカスタムデータタイプを定義することもできます。

このチュートリアルでは、Platform ユーザーインターフェイスでカスタムデータタイプを作成および編集する手順を説明します。

前提条件 prerequisites

このガイドでは、XDM システムに関する十分な知識が必要です。 Experience Platformエコシステムにおける XDM の役割の概要については XDM の概要を、データタイプが XDM スキーマにどのように寄与するかについては スキーマ構成の基本を参照してください。

このガイドには必要ありませんが、UI でのスキーマの作成に関するチュートリアルに従って、Schema Editor の様々な機能を理解することをお勧めします。

データタイプの Schema Editor を開く data-type

Platform UI で、左側のナビゲーションで スキーマ を選択して ​ スキーマ ​ ワークスペースを開き、「データタイプ」タブを選択します。 使用可能なデータタイプのリストが表示されます。 データタイプのリストは、作成方法に基づいて自動的にフィルタリングされます。 デフォルト設定には、Adobeで定義されたデータタイプが表示されます。 また、リストをフィルタリングして、組織で作成したリストを表示することもできます。

![ 左側のナビゲーションで ​ スキーマ ​ がハイライト表示され ]​ データタイプ ​ を含む ​ スキーマ ワークスペース。

ここから、次のオプションを使用できます。

新しいデータタイプの作成 create

データタイプ タブから、「データタイプを作成」を選択します。

Schema Editor が表示され、キャンバスに新しいデータタイプの現在の構造が表示されます。 エディターの右側で、データタイプの表示名と説明（オプション）を入力できます。 スキーマに追加する際にデータタイプを識別する方法と同様に、データタイプに一意で簡潔な名前を指定します。

このチュートリアルでは、レストランプロパティを説明するデータタイプを作成するので、データタイプには「Restaurant」という表示名が付きます。

ここから、 次のセクションに進んで、新しいデータタイプへのフィールドの追加を開始できます。

データタイプのフィルタリング filter

使用可能なデータタイプのリストは、作成方法に基づいて事前にフィルタリングされています。ラジオボタンを選択して、「​ 標準 ​」オプションと「​ カスタム ​ オプションの中から選択します。 「​ 標準 ​」オプションにはAdobeが作成したエンティティが表示され、「​ カスタム ​」オプションには組織内で作成したエンティティが表示されます。

既存のデータタイプの編集 edit

編集できるのは、組織で定義されたカスタムデータタイプのみです。 組織が所有するカスタムデータタイプのみを表示する場合は、「カスタム」を選択します。

編集するデータタイプをリストから選択して右側のパネルを開き、データタイプの詳細を表示します。 詳細パネルから、サンプルファイルをダウンロードしたり、JSON 構造をコピーしたり、データタイプをパッケージに追加したりすることもできます。

右側のパネルでデータタイプの名前を選択して、Schema Editor で構造を開きます。

![ データタイプ ​ カスタム ​ とデータタイプ ] 名前 ​ がハイライト表示された ​ スキーマ ​ ワークスペースの ​ データタイプ ​ タブ ​

データタイプへのフィールドの追加 add-fields

データタイプへのフィールドの追加を開始するには、キャンバスのルートレベルフィールドの横にある プラス（+） アイコンを選択します。 下に新しいフィールドが表示され、右側のパネルが更新されて、新しいフィールドのコントロールが表示されます。

右側のパネルのコントロールを使用して、新しいフィールドの詳細を設定します。 フィールドを設定してデータタイプに追加する方法に関する具体的な手順については、UI でのフィールドの定義に関するガイドを参照してください。

レストラン データタイプには、レストランの名前を表す文字列フィールドが必要です。 そのため、​ フィールド名 ​ は「名前」に設定され、​ タイプ ​ は「​ 文字列 ​」に設定されます。 「適用」を選択して、フィールドに変更を適用します。

必要に応じて、データタイプにさらにフィールドを追加します。 レストラン データタイプの例には、ブランド、座席数およびフロアスペース用の追加フィールドが含まれるようになりました。

基本フィールドに加えて、カスタムデータタイプ内に追加のデータタイプをネストすることもできます。 例えば、Restaurant データタイプには、プロパティの物理アドレスを表すフィールドが必要です。 このシナリオでは、標準のデータタイプ「​ 郵送先住所 ​」が割り当てられた新しい「住所」フィールドを追加できます。

これは、データ型がデータを記述する際にどのように柔軟かを示しています。データ型は、フィールドを使用して、データ型を構成することもでき、フィールド自体にさらにデータ型を含めることもできます。 これにより、XDM スキーマ全体で一般的なデータパターンを抽象化して再利用できるので、複雑なデータ構造を簡単に表すことができます。

データタイプへのフィールドの追加が完了したら、「保存 を選択して変更を保存し、データタイプを Schema Library に追加します。

スキーマへのデータタイプの追加 add-data-type

データタイプを作成したら、スキーマでそのデータタイプの使用を開始できます。 XDM スキーマはクラスと 0 個以上のフィールドグループで構成されるので、データタイプによって提供されるフィールドをスキーマに直接追加することはできません。 代わりに、クラスまたはフィールドグループに含める必要があります。

まず、 クラスへのフィールドの追加または フィールドグループへのフィールドの追加の手順に従います。 または、 スキーマに直接フィールドを追加を開始し、そこから親クラスまたはフィールドグループを選択することもできます。 新しいフィールドの タイプ を選択する際に、ドロップダウンメニューからデータタイプの名前を選択します。

複数フィールドオブジェクトのデータ型への変換 convert

Schema Editor に複数のサブフィールドを持つオブジェクトタイプフィールドを作成する場合、そのフィールドをデータタイプに変換することで、同じフィールド構造を異なるクラスやフィールドグループで使用できるようになります。

オブジェクトタイプのフィールドをデータタイプに変換するには、キャンバスでフィールドを選択します。 フィールドを変換する前に、表示名 が、オブジェクトに格納されるデータを説明したものであることを確認してください。これがデータタイプの名前になります。 フィールドを変換する準備が整ったら、右側のパネルで 新しいデータタイプに変換 を選択します。

キャンバスは、フィールドのデータタイプを「Object」から新しいデータタイプに更新します。 この構造は、新しいフィールドを定義する際に タイプ ドロップダウンからこのデータタイプを選択することで、他のクラスやフィールドグループで再利用できるようになりました。

次の手順 next-steps

このガイドでは、Platform UI を使用してデータタイプを作成および編集する方法について説明しました。 ​ スキーマ ​ ワークスペースの機能について詳しくは、​ スキーマ ​ ワークスペースの概要を参照してください。

Schema Registry API を使用してデータタイプを管理する方法については、 データタイプエンドポイントガイドを参照してください。