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

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

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

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

前提条件 prerequisites

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

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

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

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

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

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

「Data types」タブから「Create data type」を選択します。

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

オブジェクトタイプのフィールドをデータタイプに変換するには、キャンバスでフィールドを選択します。 フィールドを変換する前に、オブジェクトに含まれるデータを説明する Display name を指定してください。これがデータタイプの名前になるからです。 フィールドを変換する準備が整ったら、右側のパネルで「Convert to new data type」を選択します。

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

次の手順 next-steps

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

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