UIでのクラスの作成と編集

Experience Data Model(XDM)では、スキーマに含めるデータの行動面(レコードまたは時系列)を定義するクラスです。 これに加えて、クラスは、そのクラスに基づくすべてのスキーマに含める必要のある共通のプロパティの最小数を記述し、複数の互換性のあるデータセットを結合する方法を提供します。

Adobeは、XDM Individual ProfileやXDM ExperienceEventを含むいくつかの標準("core")XDMクラスを提供しています。 これらのコアクラスに加えて、独自のカスタムクラスを作成し、貴社の具体的な使用例を説明することもできます。

このドキュメントでは、Adobe Experience PlatformUIでカスタムクラスを作成、編集、管理する方法の概要を説明します。

前提条件

このガイドでは、XDMシステムに関する十分な理解が必要です。 Experience Platformエコシステム内でのXDMの役割の紹介については、XDM overviewを参照し、XDMスキーマにクラスがどのように貢献するかについては、スキーマ構成の基本を参照してください。

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

新しいクラスの作成

スキーマ​ワークスペースで、「スキーマを作成」を選択し、ドロップダウンから「参照」を選択します。

使用可能なクラスのリストから選択できるダイアログが表示されます。 ダイアログの上部で、「新しいクラスを作成」を選択します。 次に、新しいクラスに、表示名(クラスを説明、一意、わかりやすい名前)、説明、およびスキーマが定義するデータの動作(「Record」または「Time-series」)を付けます。

終了したら、「クラスを割り当て」を選択します。

Schema Editorが表示され、作成したカスタムクラスに基づく新しいスキーマがキャンバスに表示されます。 まだフィールドがクラスに追加されていないので、スキーマには_idフィールドのみが含まれます。これは、Schema Registry内のすべてのリソースに自動的に適用される、システム生成の一意の識別子を表します。

重要

組織で定義されたクラスを実装するスキーマを構築する場合、mixin は互換性のあるクラスでのみ使用できることに注意してください。定義したクラスは新しいので、mixin​ダイアログに追加は互換性のあるミックスインが一覧に表示されません。 代わりに、そのクラスで使用する新しいミックスイン](/docs/experience-platform/xdm/ui/resources/mixins.html?lang=ja#create)を[作成する必要があります。 次に新しいクラスを実装するスキーマを作成すると、定義したミックスインが一覧表示され、使用できます。

クラスにフィールドを追加する開始が可能になりました。これは、そのクラスを使用するすべてのスキーマが共有します。

既存のクラスを編集

メモ

組織で定義されたカスタムクラスのみを完全に編集およびカスタマイズできます。 Adobeが定義するコアクラスの場合、各フィールドの表示名だけを、個々のスキーマのコンテキスト内で編集できます。 詳しくは、スキーマフィールドの表示名の編集の節を参照してください。

カスタムクラスを保存してデータ取り込みで使用した後は、それ以降は追加の変更のみを行うことができます。 詳しくは、スキーマ展開のルールを参照してください。

既存のクラスを編集するには、「参照」タブを選択し、編集するクラスを使用するスキーマの名前を選択します。

ヒント

Workspaceの検索およびフィルター機能を使用して、スキーマを簡単に見つけることができます。 詳しくは、XDMリソースのガイドを参照してください。

Schema Editorが表示され、スキーマの構造がキャンバスに表示されます。 これで、クラスにフィールドを追加する開始が可能になりました。

クラス追加のフィールド

スキーマエディターでカスタムクラスを使用するスキーマを開くと、フィールドを開始してクラスに追加できます。 新しいフィールドを追加するには、スキーマ名の横にあるプラス(+)アイコンを選択します。

重要

クラスに追加するフィールドは、そのクラスを使用するすべてのスキーマで使用されることに注意してください。 したがって、どのフィールドがスキーマの使用例で役立つかを慎重に検討する必要があります。 このクラスの一部のスキーマでのみ使用されるフィールドを追加しようと思う場合は、代わりにmixinを作成して、これらのスキーマに追加することを検討してください。

キャンバスに​新しいフィールド​が表示され、右側のパネルが更新され、フィールドのプロパティを構成するコントロールが表示されます。 フィールドを設定してクラスに追加する手順については、UIでのフィールドの定義のガイドを参照してください。

引き続き、必要な数のフィールドをクラスに追加します。 終了したら、「保存」を選択して、スキーマとクラスの両方を保存します。

このクラスを使用するスキーマを以前に作成したことがある場合、新しく追加されたフィールドがこれらのスキーマに自動的に表示されます。

スキーマクラスの変更

スキーマのクラスは、最初の作成プロセスで保存前の任意の時点で変更できます。 詳しくは、スキーマの作成と編集のガイドを参照してください。

次の手順

このドキュメントでは、プラットフォームUIを使用してクラスを作成および編集する方法について説明します。 スキーマワークスペースの機能について詳しくは、スキーマワークスペースの概要を参照してください。

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

このページ