UI でのクラスの作成と編集 ui-create-and-edit

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

Adobeには、XDM 個別プロファイルや XDM ExperienceEvent など、いくつかの標準(「コア」)Experience Data Model(XDM) クラスが用意されています。 これらのコアクラスに加えて、独自のカスタムクラスを作成して、組織の具体的な使用例を説明することもできます。

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

前提条件 prerequisites

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

このガイドは必須ではありませんが、 UI でのスキーマの構成 を参照して、スキーマエディターの様々な機能について理解してください。

はじめに getting-started

Platform UI で、「 」を選択します。 スキーマ 左側のナビゲーションで、 スキーマ ワークスペースに移動して、 クラス タブをクリックします。 使用可能なクラスのリストが表示されます。

クラスをフィルター filter

クラスのリストは、作成方法に基づいて自動的にフィルタリングされます。 デフォルト設定では、Adobeで定義されたクラスが表示されます。 また、リストをフィルタリングして、組織で作成したリストを表示することもできます。 ラジオボタンを選択して、 標準 および カスタム オプション。 The 標準 「 」オプションは、Adobeで作成されたエンティティと カスタム 「 」オプションは、組織内で作成されたエンティティを表示します。

The クラス タブ スキーマ ワークスペース 標準 および カスタム ハイライト表示されました。

TIP
検索機能を使用して、名前に基づいてクラスをフィルタリングまたは検索します。 次のガイドを参照してください: XDM リソースの調査 を参照してください。

新しいクラスの作成 create

Platform UI でクラスを作成するには、2 つのメソッドがあります。 Adobe Analytics の スキーマ ワークスペース、選択 スキーマを作成、または クラス タブの選択 クラスを作成.

The クラス タブ スキーマ ワークスペース スキーマを作成 および クラスを作成 ハイライト

次を選択した場合、 クラスを作成、 クラスを作成 ダイアログが表示されます。 を入力します。 表示名 および 説明 クラスの場合は、ラジオボタンを使用してクラスの意図した動作を選択します。 クラスは、型、レコード系列、または時系列のいずれかです。 選択 作成 選択を確定し、に戻るには、以下の手順に従います。 クラス タブをクリックします。

The クラスを作成 ~との対話 作成 ハイライト表示されました。

作成したクラスが使用可能になり、 クラス 表示。

The クラス タブ スキーマ 最近作成したクラスがハイライト表示されたワークスペース。

クラスの作成または編集 create-or-edit

または、 スキーマを作成、 スキーマを作成 ワークフローが表示されます。 Adobe Analytics の スキーマの詳細 セクション、選択 その他. 使用可能なクラスのリストが表示されます。 ここから、新しいクラスを基にする既存のクラスを参照およびフィルタリングできます。

NOTE
完全に編集およびカスタマイズできるのは、組織で定義されたカスタムクラスのみです。 Adobeで定義されたコアクラスの場合、各スキーマのコンテキスト内では、フィールドの表示名のみを編集できます。 詳しくは、 スキーマフィールドの表示名の編集 」を参照してください。
カスタムクラスを保存し、データ取り込みで使用した後は、その後は追加的な変更のみおこなうことができます。 詳しくは、 スキーマ進化のルール を参照してください。

The スキーマを作成 を使用したワークフロー その他 で強調表示された スキーマの詳細 」セクションに入力します。

ラジオボタンを選択して、カスタムクラスか標準クラスかに基づいてクラスをフィルタリングします。 また、業種に基づいて使用可能な結果をフィルタリングしたり、検索フィールドを使用して特定のクラスを検索したりできます。

The スキーマを作成 検索バーを含むワークフロー カスタム、および 業界 ハイライト表示されました。

適切なクラスを決定するのに役立つ情報 ( 情報アイコン。 ) とプレビュー ( プレビューアイコン。 ) 個のアイコンをクラスごとに追加します。 情報アイコンをクリックすると、関連付けられているクラスと業界の説明を示すダイアログが開きます。 プレビューアイコンを使用すると、スキーマダイアグラムとそのプロパティを含むクラスのプレビューダイアログが開きます。

スキーマ図とクラスプロパティがハイライト表示された、選択したクラスのプレビュー。

任意の行を選択してクラスを選択し、「 」を選択します。 次へ をクリックして選択を確定します。

The スキーマを作成 使用可能なクラスのテーブルから選択したクラスを持つワークフローと 次へ ハイライト表示されました。

The 名前とレビュー 「 」セクションが表示されます。 この節では、スキーマを識別する名前と説明を指定します。​キャンバスには、選択したクラスとスキーマ構造を確認できるように、スキーマの基本構造(クラスで提供)が表示されます。

クラスの短く、わかりやすい、一意の、わかりやすい名前を スキーマの表示名 テキストフィールド。 次に、適切な説明を入力して、スキーマが定義するデータの動作を識別します。 スキーマの構造を確認し、設定に満足したら、「 」を選択します。 完了 をクリックしてスキーマを作成します。

The 名前とレビュー のセクション スキーマを作成 ワークフローと スキーマの表示名, 説明、および 完了 ハイライト表示されました。

スキーマエディターが表示され、スキーマの構造がキャンバスに表示されます。 これで、以下を開始できます。 クラスへのフィールドの追加.

スキーマエディターとスキーマの構造がキャンバスに表示されます。

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

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

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

「追加」ボタンがハイライトされたスキーマエディター。

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

An 名称未設定フィールド プレースホルダーがキャンバスに表示され、右側のレールが更新されて、フィールドのプロパティを設定するコントロールが表示されます。 の下 割り当て先 ​を選択します。 クラス.

スキーマエディターのキャンバスにある名称未設定フィールドで、「クラスに割り当て」フィールドプロパティが選択され、ハイライト表示されています。

次のガイドを参照してください: UI でのフィールドの定義 を参照してください。 引き続き、必要な数のフィールドをクラスに追加します。 終了したら、「 」を選択します。 保存 をクリックして、スキーマとクラスの両方を保存します。

スキーマエディターのキャンバスに新しく作成されたスキーマ。 保存 ハイライト表示されました。

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

スキーマクラスの変更 schema

スキーマのクラスは、最初の作成プロセス中、保存前の任意の時点で変更できます。 ただし、フィールドグループは特定のクラスとのみ互換性があるので、この操作は慎重におこなう必要があります。 クラスを変更すると、キャンバスと追加したフィールドがリセットされます。
次のガイドを参照してください: スキーマの作成と編集 を参照してください。

次の手順 next-steps

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

スキーマレジストリ API を使用してクラスを管理する方法については、 クラスエンドポイントガイド.

recommendation-more-help
62e9ffd9-1c74-4cef-8f47-0d00af32fc07