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

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

Adobeは、XDM 個人プロファイルや XDM エクスペリエンスイベントを含む、いくつかの標準(「コア」)エクスペリエンスデータモデル(XDM)クラスを提供しています。 これらのコアクラスに加えて、独自のカスタムクラスを作成して、組織のより具体的な使用例を記述することもできます。

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

前提条件 prerequisites

このガイドでは、XDM システムに関する十分な知識が必要です。 クラスが XDM スキーマにどのように寄与するかについては、Experience Platformエコシステム内での XDM の役割の概要および スキーマ構成の基本を参照 XDM の概要

このガイドには必須ではありませんが、UI でのスキーマの作成に関するチュートリアルに従って、スキーマエディターの様々な機能を理解することをお勧めします。

はじめに getting-started

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

クラスをフィルター filter

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

標準 と カスタム がハイライト表示された スキーマ ワークスペースの クラス タブ

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

新しいクラスの作成 create

Platform UI でクラスを作成するには、次の 2 つの方法があります。 ​ スキーマ ​ ワークスペースの任意のタブから スキーマを作成 を選択するか、​ クラス ​ タブから クラスを作成 を選択します。

スキーマを作成 と クラスを作成 がハイライト表示された スキーマ ワークスペースの クラス タブ

クラスを作成 を選択すると、​ クラスを作成 ​ ダイアログが表示されます。 クラスの ​ 表示名 ​ と ​ 説明 ​ を入力し、ラジオボタンでクラスの意図した動作を選択します。 クラスは、タイプ、レコード系列、時系列のいずれかになります。 「作成」を選択して選択を確定し、「​ クラス ​」タブに戻ります。

「作成 がハイライト表示された クラスを作成 ダイアログ

作成したクラスが使用可能になり、​ クラス ​ ビューに表示されます。

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

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

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

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

スキーマの詳細 セクションでハイライト表示された その他 を含む スキーマを作成 ワークフロー

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

検索バー、 カスタム 、 業界 がハイライト表示された スキーマを作成 ワークフロー

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

選択したクラスのプレビュー。スキーマダイアグラムとクラスプロパティがハイライト表示されています。

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

![ 使用可能なクラスのテーブルから選択したクラスと ] 次へ ​ がハイライト表示された ​ スキーマを作成 ​ ワークフロー ​

ワークフローの ​ 名前とレビュー ​ セクションが表示されます。 このセクションでは、スキーマを識別するための名前と説明を入力します。​キャンバスにスキーマの基本構造(クラスによって提供される)が表示され、選択したクラスとスキーマ構造を確認できます。

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

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

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

キャンバスに表示されたスキーマの構造を持つスキーマエディター。

クラスへのフィールドの追加 add-fields

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

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

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

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

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

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

フィールドを設定してクラスに追加する方法に関する具体的な手順については、UI でのフィールドの定義に関するガイドを参照してください。 クラスに必要な数のフィールドを追加し続けます。 終了したら、「保存 を選択して、スキーマとクラスの両方を保存します。

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

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

スキーマクラスの変更 schema

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

次の手順 next-steps

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

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

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