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

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

Adobeは、次のようないくつかの標準(「コア」)XDM クラスを提供します XDM Individual Profile および XDM ExperienceEvent. これらのコアクラスに加えて、独自のカスタムクラスを作成して、組織の具体的な使用例を説明することもできます。

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

前提条件

このガイドでは、XDM システムに関する十分な知識が必要です。 詳しくは、 XDM の概要 Experience Platformエコシステム内での XDM の役割、および スキーマ構成の基本 クラスが XDM スキーマにどのように貢献するかを学ぶため。

このガイドは必須ではありませんが、 UI でのスキーマの構成 の様々な機能を身に付ける Schema Editor.

新しいクラスの作成

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

使用可能なクラスのリストから選択できるダイアログが表示されます。 ダイアログの上部で、「 」を選択します。 新しいクラスを作成. 次に、新しいクラスに、表示名(クラスを説明する短く、一意で、わかりやすいクラス名)、説明、スキーマが定義するデータの動作 (レコード"または"時系列") です。

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

この Schema Editor が表示され、作成したカスタムクラスに基づく新しいスキーマがキャンバスに表示されます。 クラスにはまだフィールドが追加されていないので、スキーマには _id フィールド: Schema Registry.

重要

組織で定義されたクラスを実装するスキーマを構築する場合、スキーマフィールドグループは互換性のあるクラスでのみ使用できることに注意してください。 定義したクラスは新しいので、互換性のあるフィールドグループは「 フィールドグループを追加 ダイアログ。 代わりに、 新しいフィールドグループを作成 そのクラスで使用する 次に新しいクラスを実装するスキーマを作成すると、定義したフィールドグループが一覧表示され、使用できます。

これで、 クラスへのフィールドの追加:クラスを使用するすべてのスキーマで共有されます。

既存のクラスの編集

重要

2022 年 4 月 30 日以降に作成されたカスタムクラスは直接編集できず、現在修正が進行中です。 回避策として、次の操作を実行できます。 カスタムフィールドグループの作成 を再利用し、拡張するカスタムクラスを使用する各スキーマに対して再利用します。 2022 年 4 月 30 日より前に作成されたカスタムクラスは、この制限の影響を受けません。

メモ

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

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

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

ヒント

ワークスペースの検索およびフィルタリング機能を使用すると、スキーマを見つけやすくなります。 詳しくは、 XDM リソースの調査 を参照してください。

この Schema Editor が表示され、スキーマの構造がキャンバスに表示されます。 これで、 クラスへのフィールドの追加.

クラスにフィールドを追加する

重要

2022 年 4 月 30 日以降に作成されたカスタムクラスは直接編集できず、現在修正が進行中です。 回避策として、次の操作を実行できます。 カスタムフィールドグループの作成 を再利用し、拡張するカスタムクラスを使用する各スキーマに対して再利用します。 2022 年 4 月 30 日より前に作成されたカスタムクラスは、この制限の影響を受けません。

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

重要

クラスに追加するフィールドは、そのクラスを使用するすべてのスキーマで使用されます。 したがって、すべてのスキーマの使用例で役立つフィールドを慎重に検討する必要があります。 このクラスの一部のスキーマでのみ使用される可能性のあるフィールドを追加する場合は、次の方法でそれらのスキーマに追加することを検討してください。 フィールドグループの作成 代わりに、

A 新しいフィールド がキャンバスに表示され、右側のレールが更新されて、フィールドのプロパティを設定するコントロールが表示されます。 詳しくは、 UI でのフィールドの定義 を参照してください。

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

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

スキーマクラスの変更

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

次の手順

このドキュメントでは、Platform UI を使用してクラスを作成および編集する方法について説明しました。 の機能の詳細については、 スキーマ ワークスペース ( スキーマ workspace の概要.

を使用してクラスを管理する方法を学ぶには Schema Registry API( クラスエンドポイントガイド.

このページ