UI でのクラスの作成と編集 ui-create-and-edit
Adobe Experience Platformでは、スキーマのクラスは、スキーマに含まれるデータの行動的側面(レコードまたは時系列)を定義します。 これに加えて、クラスは、そのクラスに基づくすべてのスキーマに含める必要のある共通のプロパティの最小数を記述し、複数の互換性のあるデータセットを結合する方法を提供します。
Adobeには、XDM Individual ProfileやXDM ExperienceEventなど、いくつかの標準(「コア」) Experience Data Model (XDM)クラスが用意されています。 これらのコアクラスに加えて、独自のカスタムクラスを作成して、組織のより具体的なユースケースを説明することもできます。
このドキュメントでは、Experience Platform UIでカスタムクラスを作成、編集、管理する方法の概要を説明します。
前提条件 prerequisites
このガイドでは、XDM システムに関する実用的な理解が必要です。 Experience Platform エコシステム内でのXDMの役割の概要については、XDMの概要を参照し、クラスがXDM スキーマに貢献する方法については、 スキーマ構成の基本を参照してください。
このガイドでは必須ではありませんが、UIでのスキーマの作成に関するチュートリアルに従って、スキーマエディターのさまざまな機能を理解することをお勧めします。
はじめに getting-started
Experience Platform UIで、左側のナビゲーションで「スキーマ」を選択して スキーマ ワークスペースを開き、「クラス」タブを選択します。 使用可能なクラスのリストが表示されます。
フィルタークラス filter
クラスのリストは、作成方法に基づいて自動的にフィルタリングされます。 デフォルト設定には、Adobeで定義されたクラスが表示されます。 リストをフィルタリングして、組織が作成したリストを表示することもできます。 ラジオボタンを選択して、標準と カスタム のオプションから選択します。 標準 オプションにはAdobeで作成されたエンティティが表示され、 カスタム オプションには組織内で作成されたエンティティが表示されます。
![標準と カスタム がハイライト表示された スキーマ ワークスペースの クラス タブ。]
新しいクラスの作成 create
Experience Platform UIでクラスを作成するには、クラスを作成または スキーマを作成 する2つの方法があります。
クラスを作成
スキーマ ワークスペースの「 クラス 」タブから「クラスを作成」を選択します。
![ クラスを作成]が強調表示された スキーマ ワークスペースの クラス タブ (…/…/images/ui/resources/classes/create-class.png)
「 クラスを作成」ダイアログが表示されます。 クラスの表示名と説明を入力し、ラジオボタンでクラスの意図された動作を選択します。 クラスのタイプは、 レコード または時系列です。 「作成」を選択して選択を確定し、「 クラス 」タブに戻ります。
作成したクラスは使用可能で、 クラス ビューに表示されます。
スキーマを作成
または、スキーマを手動で作成してクラスを作成することもできます。 スキーマ ワークスペースの「 クラス 」タブから「スキーマを作成」を選択します。
表示される「 スキーマを作成」ダイアログで「手動」を選択します。
スキーマ作成ワークフローが表示されます。 「 スキーマの詳細」セクションで、「その他」を選択します。 使用可能なクラスのリストが表示されます。 「クラスを作成」を選択します。
「 クラスを作成」ダイアログが表示されます。 クラスの表示名と説明を入力し、ラジオボタンでクラスの意図された動作を選択します。 クラスのタイプは、 レコード または時系列です。 「作成」を選択して選択を確定し、「 クラス 」タブに戻ります。
クラスリストが スキーマの詳細 セクションで更新され、新しく作成したクラスが自動的に選択されます。 スキーマの作成を続行するには、次へを選択してください。
クラスを選択すると、「名前とレビュー」セクションが表示されます。 このセクションでは、スキーマを識別するための名前と説明を指定します。 選択したクラスとスキーマ構造を確認および検証するために、スキーマのベース構造(クラスによって提供)がキャンバスに表示されます。
人間に適した スキーマ表示名をテキストフィールドに入力します。 次に、適切な説明を入力して、スキーマを特定します。 スキーマ構造を確認し、設定に満足したら、終了を選択してスキーマを作成します。
![ スキーマ表示名]、説明、完了がハイライト表示された スキーマを作成 ワークフローの名前とレビュー セクション。(…/…/images/ui/resources/classes/schema-details.png)
クラスへのフィールドの追加 add-fields
スキーマエディターでカスタムクラスを使用するスキーマを開いたら、クラスへのフィールドの追加を開始できます。 新しいフィールドを追加するには、スキーマ名の横にあるプラス(+) アイコンを選択します。
「名称未設定のフィールド」プレースホルダーがキャンバスに表示され、右側のパネルが更新されて、フィールドのプロパティを設定するためのコントロールが表示されます。 「割り当て」で、「クラス」を選択します。
フィールドを設定してクラスに追加する方法について詳しくは、UIでのフィールドの定義に関するガイドを参照してください。 必要な数のフィールドをクラスに追加します。 完了したら、保存を選択して、スキーマとクラスの両方を保存します。
このクラスを使用するスキーマを以前に作成した場合、新しく追加されたフィールドは、それらのスキーマに自動的に表示されます。
クラスの編集 edit-a-class
クラスを拡張する既存のスキーマを編集するか、スキーマを手動で作成することで、スキーマワークフローを通じてクラスを編集できます。 クラスを直接編集することはできません。 スキーマ ワークスペースの参照 タブ内から、既存のクラスを選択するか、スキーマを作成します。
新しいスキーマを作成する場合は、 スキーマの作成の節を参照してください。 スキーマの作成が完了すると(または既存のスキーマを選択した後)、スキーマエディターが表示されます。 既存のクラスフィールドを更新するには、スキーマ構造からフィールドを選択します。 フィールドの情報は右側のパネルに表示されます。 割り当て先を確認
オプション クラスが選択されているか、更新がクラスに影響を与えません。
フィールドに必要な変更を加え、右側のパネルで下にスクロールして、適用を選択して変更を保存します。
新しいフィールドを追加するには、 クラスにフィールドを追加する ガイドに従います。 完了したら、保存を選択して、スキーマとクラスの両方を保存します。
スキーマクラスの変更 schema
スキーマのクラスは、最初の作成プロセスの任意の時点で保存する前に変更できます。ただし、フィールドグループは特定のクラスとのみ互換性があるため、注意して行う必要があります。クラスを変更すると、キャンバスと追加したフィールドがリセットされます。
詳しくは、 スキーマの作成と編集に関するガイドを参照してください。
次の手順 next-steps
このドキュメントでは、Experience Platform UIを使用してクラスを作成および編集する方法について説明しました。 スキーマ ワークスペースの機能について詳しくは、 スキーマ ワークスペースの概要を参照してください。
Schema Registry APIを使用してクラスを管理する方法については、 クラスエンドポイントガイド を参照してください。