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 Systems によって定義されたデータ型が表示されます。 また、リストをフィルタリングして、組織によって作成されたものを表示することもできます。

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

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

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

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

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

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

フィルターデータタイプ filter

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

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

組織で定義されたカスタム データ タイプのみを編集できます。 [ Custom ] を選択すると、組織が所有するカスタム データ タイプのみが表示されます。

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

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

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

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

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

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

続行必要に応じて、データ型にフィールドを追加します。 サンプルのレストラン データ タイプに、ブランド、座席数、およびフロア面積の追加フィールドが追加されました。

基本フィールドに加えて、カスタムデータ型内に追加のデータ型を入れ子にすることもできます。 たとえば、レストラン データ型には、プロパティの住所を表すフィールドが必要です。 このシナリオでは、標準データ型 "Postal 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 を使用してデータタイプを管理する方法については、​ データタイプエンドポイントガイド ​ を参照してください。