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で、左側のナビゲーションで「Schemas」を選択してSchemas ワークスペースを開き、「Classes」タブを選択します。 使用可能なクラスのリストが表示されます。
フィルタークラス filter
クラスのリストは、作成方法に基づいて自動的にフィルタリングされます。 デフォルト設定には、Adobeで定義されたクラスが表示されます。 リストをフィルタリングして、組織が作成したリストを表示することもできます。 ラジオボタンを選択して、StandardとCustomのオプションから選択します。 Standard オプションにはAdobeで作成されたエンティティが表示され、Custom オプションには組織内で作成されたエンティティが表示されます。
新しいクラスの作成 create
Experience Platform UIでクラスを作成するには、Create classまたは Create schema を通じて2つの方法があります。
クラスを作成
Create class ワークスペースの「Classes」タブから「Schemas」を選択します。
Create class ダイアログが表示されます。 クラスのDisplay nameとDescriptionを入力し、ラジオボタンを使用してクラスの意図された動作を選択します。 クラスのタイプはRecordまたはTime-seriesです。 Createを選択して選択を確定し、Classes タブに戻ります。
作成したクラスが使用可能で、Classes ビューに表示されます。
スキーマを作成
または、スキーマを手動で作成してクラスを作成することもできます。 Create schema ワークスペースの「Classes」タブから「Schemas」を選択します。
表示されるManual ダイアログで「Create a schema」を選択します。
スキーマ作成ワークフローが表示されます。 Schema details セクションで、Otherを選択します。 使用可能なクラスのリストが表示されます。 Create class を選択します。
Create class ダイアログが表示されます。 クラスのDisplay nameとDescriptionを入力し、ラジオボタンを使用してクラスの意図された動作を選択します。 クラスのタイプはRecordまたはTime-seriesです。 Createを選択して選択を確定し、Classes タブに戻ります。
クラスリストがSchema details セクションで更新され、新しく作成したクラスが自動的に選択されます。 スキーマの作成を続行するには、Nextを選択してください。
クラスを選択すると、Name and review セクションが表示されます。 このセクションでは、スキーマを識別するための名前と説明を指定します。スキーマのベース構造(クラスから提供される)がキャンバスに表示され、選択したクラスとスキーマ構造を確認および検証できます。
人間に適したSchema display nameをテキストフィールドに入力します。 次に、適切な説明を入力して、スキーマを特定します。 スキーマ構造を確認し、設定に満足したら、Finishを選択してスキーマを作成します。
クラスへのフィールドの追加 add-fields
スキーマエディターでカスタムクラスを使用するスキーマを開いたら、クラスへのフィールドの追加を開始できます。 新しいフィールドを追加するには、スキーマ名の横にあるプラス(+) アイコンを選択します。
Untitled Field プレースホルダーがキャンバスに表示され、右側のパネルが更新されて、フィールドのプロパティを設定するためのコントロールが表示されます。 Assign toで、Classを選択します。
フィールドを設定してクラスに追加する方法について詳しくは、UIでのフィールドの定義に関するガイドを参照してください。 必要な数のフィールドをクラスに追加します。 完了したら、Saveを選択して、スキーマとクラスの両方を保存します。
このクラスを使用するスキーマを以前に作成した場合、新しく追加されたフィールドは、それらのスキーマに自動的に表示されます。
クラスの編集 edit-a-class
クラスを拡張する既存のスキーマを編集するか、スキーマを手動で作成することで、スキーマワークフローを通じてクラスを編集できます。 クラスを直接編集することはできません。 Browse ワークスペースのSchemas タブ内から、既存のクラスまたは Create a schema を選択します。
新しいスキーマを作成する場合は、 スキーマの作成の節を参照してください。 スキーマの作成が完了すると(または既存のスキーマを選択した後)、スキーマエディターが表示されます。 既存のクラスフィールドを更新するには、スキーマ構造からフィールドを選択します。 フィールドの情報は右側のパネルに表示されます。 Assign toを確認
オプション Classが選択されているか、更新がクラスに影響しません。
フィールドに必要な変更を加え、右側のパネルで下にスクロールして Apply を選択し、変更を保存します。
新しいフィールドを追加するには、 クラスにフィールドを追加する ガイドに従います。 完了したら、Saveを選択して、スキーマとクラスの両方を保存します。
スキーマクラスの変更 schema
スキーマのクラスは、最初の作成プロセスの任意の時点で保存する前に変更できます。 ただし、フィールドグループは特定のクラスとのみ互換性があるため、注意して行う必要があります。 クラスを変更すると、キャンバスと追加したフィールドがリセットされます。
詳しくは、 スキーマの作成と編集に関するガイドを参照してください。
次の手順 next-steps
このドキュメントでは、Experience Platform UIを使用してクラスを作成および編集する方法について説明しました。 Schemas ワークスペースの機能について詳しくは、Schemas ワークスペースの概要を参照してください。
Schema Registry APIを使用してクラスを管理する方法については、 クラスエンドポイントガイド を参照してください。