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 つの方法があります。

クラスを作成

スキーマ ワークスペースの ​ クラス ​ タブから ​ クラスを作成 ​ を選択します。

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

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

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

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

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

スキーマを作成

または、スキーマを手動で作成してクラスを作成することもできます。 スキーマ ワークスペースの ​ クラス ​ タブから ​ スキーマを作成 ​ を選択します。

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

表示される スキーマを作成 ダイアログで ​ 手動 ​ を選択します。

NOTE
ML で支援されるスキーマ作成ワークフローを使用する場合は、ファイルをアップロードし、ML アルゴリズムを使用して推奨スキーマを生成できます。 そのスキーマ作成ワークフローでは、スキーマの基本クラスを指定する必要はありません。 ML が CSV ファイルに基づいてスキーマ構造をレコメンデーションする方法については、 機械学習を利用したスキーマ作成ガイドを参照してください。

ワークフローオプションと「選択」がハイライト表示されたスキーマを作成ダイアログ

スキーマ作成ワークフローが表示されます。 「​ スキーマの詳細 ​」セクションで、「その他」を選択します。 使用可能なクラスのリストが表示されます。 クラスを作成 を選択します。

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

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

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

「​ スキーマの詳細 ​」セクションでクラスリストが更新され、新しく作成したクラスが自動的に選択されます。 「次へ」を選択して、スキーマの作成を続行します。

新しいクラスが選択され、「次へ がハイライト表示された スキーマの詳細 セクション。

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

テキストフィールドに、人間にとってわかりやすい ​ スキーマ表示名 ​ を入力します。 次に、スキーマの識別に役立つ適切な説明を入力します。 スキーマ構造をレビューし、設定に満足したら、「完了」を選択してスキーマを作成します。

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

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

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

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

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

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

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

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

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

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

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

クラスの編集(#edit-a-class)

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

クラスを編集するには、スキーマワークフローを使用して、クラスを拡張する既存のスキーマを編集するか、スキーマを手動で作成します。 クラスを直接編集することはできません。 ​ スキーマ ​ ワークスペースの ​ 参照 ​ タブ内から、既存のクラスまたは スキーマを作成 を選択します。

既存のクラスと「スキーマを作成 がハイライト表示されたスキーマエディター

新しいスキーマを作成する場合は、 スキーマの作成の節を参照してください。 スキーマの作成が完了したら(または既存のスキーマを選択した後)、スキーマエディターが表示されます。 既存のクラスフィールドを更新するには、スキーマ構造からフィールドを選択します。 フィールドの情報が右側のパネルに表示されます。 ​ 割り当て先 ​ を確認します。
オプション クラス が選択されています。選択されていない場合、更新してもクラスに影響はありません。

選択されたフィールドとハイライトされたフィールド、右側のパネルが表示されたスキーマエディター。ハイライト表示は 割り当て先 です。

フィールドに必要な変更を加え、右側のレールを下にスクロールして「適用」を選択し、変更を保存します。

IMPORTANT
フィールドに加える更新は、 スキーマ進化のルールに従って、そのクラスを使用するすべてのスキーマに適用されます。

選択したフィールドと右側のパネルが表示されたスキーマエディター、「適用 をハイライト表示

新しいフィールドを追加するには、「 クラスへのフィールドの追加ガイドに従ってください。 終了したら、「保存 を選択して、スキーマとクラスの両方を保存します。

「保存 がハイライト表示されたスキーマエディタ 。

スキーマクラスの変更 schema

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

次の手順 next-steps

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

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

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