UI を使用したデータタイプの作成と編集 ui-create-and-edit
エクスペリエンスデータモデル (XDM) では、データタイプは、複数のサブフィールドを含む再利用可能なフィールドです。 スキーマフィールドグループと同様に、複数フィールド構造を一貫して使用できますが、データ型はスキーマ構造の任意の場所に含めることができるのに対して、ルートレベルでのみ追加できるので、より柔軟です。
Adobe Experience Platformには、様々な標準的なデータ型が用意されており、一般的なエクスペリエンス管理の使用例を扱うのに使用できます。 ただし、独自のビジネスニーズに対応するために、独自のカスタムデータタイプを定義することもできます。
このチュートリアルでは、Platform ユーザーインターフェイスでカスタムデータタイプを作成および編集する手順について説明します。
前提条件 prerequisites
このガイドでは、XDM システムに関する十分な知識が必要です。 詳しくは、 XDM の概要 Experience Platformエコシステム内での XDM の役割、および スキーマ構成の基本 データタイプが XDM スキーマに与える影響を説明します。
このガイドは必須ではありませんが、 UI でのスキーマの構成 の様々な機能を身に付ける Schema Editor.
を開きます。 Schema Editor データ型の data-type
Platform UI で、「 」を選択します。 スキーマ 左側のナビゲーションで、 スキーマ ワークスペースに移動して、 データタイプ タブをクリックします。 使用可能なデータタイプのリストが表示されます。 データタイプのリストは、作成方法に基づいて自動的にフィルタリングされます。 デフォルト設定では、Adobeで定義されたデータタイプが表示されます。 また、リストをフィルタリングして、組織で作成したリストを表示することもできます。
ここから、次のオプションを使用できます。
新しいデータタイプの作成 create
次から： データタイプ タブ、選択 データタイプを作成.
The Schema Editor が表示され、キャンバスに新しいデータタイプの現在の構造が表示されます。 エディターの右側で、データタイプの表示名と説明（オプション）を指定できます。 データタイプをスキーマに追加する際には、そのデータタイプが識別される方法なので、データタイプに一意で簡潔な名前を指定してください。
このチュートリアルでは、レストランのプロパティを説明するデータタイプを作成するので、データタイプには「Restaurant」という表示名が付けられます。
ここから、 次のセクション をクリックして、新しいデータ型へのフィールドの追加を開始します。
データタイプをフィルター filter
使用可能なデータタイプのリストは、作成方法に基づいて事前にフィルタリングされています。ラジオボタンを選択して、 標準 および カスタム オプション。 The 標準 「 」オプションは、Adobeで作成されたエンティティと カスタム 「 」オプションは、組織内で作成されたエンティティを表示します。
既存のデータタイプの編集 edit
組織で定義されたカスタムデータタイプのみを編集できます。 選択 カスタム ：組織が所有するカスタムデータタイプのみを表示します。
編集するデータタイプをリストから選択して、右側のパネルを開き、データタイプの詳細を表示します。 詳細パネルから、サンプルファイルをダウンロードしたり、JSON 構造をコピーしたり、データタイプをパッケージに追加したりすることもできます。
右側のパネルでデータタイプの名前を選択し、 Schema Editor.
データタイプにフィールドを追加する add-fields
データタイプへのフィールドの追加を開始するには、 プラス (+) キャンバスのルートレベルフィールドの横にあるアイコン。 新しいフィールドが下に表示され、右側のレールが更新されて新しいフィールドのコントロールが表示されます。
右側のレールのコントロールを使用して、新しいフィールドの詳細を設定します。 次のガイドを参照してください： UI でのフィールドの定義 を参照してください。
Restaurant データ型では、レストランの名前を表す文字列フィールドが必要です。 そのため、 フィールド名 が「名前」に設定され、 タイプ は「文字列". 選択 適用 をクリックして、「 」フィールドに変更を適用します。
必要に応じて、引き続きデータ型にフィールドを追加します。 サンプルの Restaurant データタイプに、ブランド、座席数、フロアスペース用の追加のフィールドが追加されました。
基本フィールドに加えて、カスタムデータタイプ内に追加のデータタイプをネストすることもできます。 例えば、Restaurant データタイプには、プロパティの住所を表すフィールドが必要です。 このシナリオでは、標準のデータタイプ「 」が割り当てられる新しい「住所」フィールドを追加できます。郵送先住所".
データ型は、データ型と同様にデータ型でもあるフィールドを使用でき、それ自体にさらにデータ型を含めることができます。その他のデータ型も使用できます。 これにより、XDM スキーマ全体で共通のデータパターンを抽象化して再利用でき、複雑なデータ構造を簡単に表すことができます。
データタイプへのフィールドの追加が完了したら、「 保存 変更を保存し、データタイプを Schema Library.
データタイプをスキーマに追加する add-data-type
データ型を作成したら、スキーマで使用できます。 XDM スキーマは、クラスと 0 個以上のフィールドグループで構成されるので、データ型で提供されるフィールドを直接スキーマに追加することはできません。 代わりに、クラスまたはフィールドグループに含める必要があります。
最初に、 クラスへのフィールドの追加 または フィールドグループへのフィールドの追加. または、 スキーマへの直接のフィールドの追加 そして、そこから親クラスまたはフィールドグループを選択します。 を選択した場合、 タイプ 新しいフィールドに対して、ドロップダウンメニューからデータタイプの名前を選択します。
複数フィールドオブジェクトのデータ型への変換 convert
複数のサブフィールドを含むオブジェクトタイプフィールドを Schema Editorを使用すると、そのフィールドをデータ型に変換して、別のクラスまたはフィールドグループで同じフィールド構造を使用できます。
オブジェクトタイプフィールドをデータタイプに変換するには、キャンバスでそのフィールドを選択します。 フィールドを変換する前に、 表示名 は、オブジェクトに含まれるデータを記述したもので、これがデータ型の名前になります。 フィールドを変換する準備が整ったら、「 新しいデータ型に変換 をクリックします。
キャンバスで、「オブジェクト」が新しいデータ型に追加されました。 この構造は、 タイプ ドロップダウンを使用して新しいフィールドを定義できます。
次の手順 next-steps
このガイドでは、Platform UI を使用してデータタイプを作成および編集する方法について説明しました。 の機能の詳細については、 スキーマ ワークスペースについては、 スキーマ workspace の概要.
を使用してデータタイプを管理する方法を学ぶには Schema Registry API( データタイプエンドポイントガイド.