UI を使用したデータタイプの作成と編集

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

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

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

前提条件

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

このガイドは必須ではありませんが、 Schema Editor の様々な機能に慣れるために、 UI でのスキーマの構成 に関するチュートリアルに従うことをお勧めします。

データ型の Schema Editor を開きます。

Platform UI で、左のナビゲーションで「スキーマ」を選択して「スキーマ」ワークスペースを開き、「データタイプ」タブを選択します。 使用可能なデータタイプのリストが表示されます。これには、Adobeが定義したデータタイプや、組織が作成したデータタイプが含まれます。

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

新しいデータ型の作成

データ型」タブで、「データ型 を作成」を選択します。

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

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

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

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

メモ

リアルタイム顧客プロファイルで使用可能になっているスキーマで既存のデータ型を使用した場合、その後は、そのデータ型に対して非破壊的な変更のみを加えることができます。 詳しくは、 スキーマ進化のルール を参照してください。

組織で定義されたカスタムデータタイプのみを編集できます。 表示されるリストを絞り込むには、フィルターアイコン( フィルターアイコン )を選択し、所有者 に基づいてフィルタリングするコントロールを表示します。 顧客 を選択して、組織が所有するカスタムデータ型のみを表示します。

編集するデータ型をリストから選択して、右側のパネルを開き、データ型の詳細を表示します。 右側のパネルでデータタイプの名前を選択し、Schema Editor で構造を開きます。

データ型へのフィールドの追加

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

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

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

必要に応じて、引き続きデータ型にフィールドを追加します。 サンプルの Restaurant データタイプに、ブランド、座席数、床面積の追加フィールドが追加されました。

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

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

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

データ型をクラスまたはフィールドグループに追加する

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

まず、 クラスへのフィールドの追加 または フィールドグループへのフィールドの追加 の手順に従います。 新しいフィールドに を選択する場合は、ドロップダウンメニューからデータ型の名前を選択します。

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

Schema Editor 内に複数のサブフィールドを含むオブジェクトタイプフィールドを作成する場合、そのフィールドをデータ型に変換して、同じフィールド構造を別のクラスまたはフィールドグループで使用できます。

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

キャンバスは、フィールドのデータ型を「Object」から新しいデータ型に更新します。 サブフィールドの横には小さなロックアイコンも表示され、個々のフィールドではなく、複数フィールドのデータ型の一部であることを示します。 この構造は、新しいフィールドを定義する際に ドロップダウンからこのデータ型を選択することで、他のクラスやフィールドグループで再利用できるようになりました。

次の手順

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

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

このページ