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

Experience Data Model （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 ワークスペースを開き、「Data types」タブを選択します。 使用可能なデータタイプのリストが表示されます。 データタイプのリストは、作成方法に基づいて自動的にフィルタリングされます。 デフォルト設定には、Adobeで定義されたデータタイプが表示されます。 リストをフィルタリングして、組織が作成したリストを表示することもできます。

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

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

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

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

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

ここから、次のセクション ​にスキップして、新しいデータタイプにフィールドを追加できます。

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

使用可能なデータタイプのリストは、作成方法に基づいて事前にフィルタリングされています。ラジオボタンを選択して、StandardとCustomのオプションから選択します。 Standard オプションにはAdobeで作成されたエンティティが表示され、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 ワークスペースの機能について詳しくは、Schemas ワークスペースの概要を参照してください。

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