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

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

Adobeには、XDM Individual ProfileXDM ExperienceEventなど、いくつかの標準(「コア」) Experience Data Model (XDM)クラスが用意されています。 これらのコアクラスに加えて、独自のカスタムクラスを作成して、組織のより具体的なユースケースを説明することもできます。

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

NOTE
XDM アクションは、インベントリ テーブルとリソースの詳細ビュー(More)から使用できます。 完全なアクションは、カスタム(テナント定義)リソースにのみ適用されます。標準リソースのオプションは限られています。 ​ スキーマ、クラス、フィールドグループ、およびデータタイプの管理:アクションと削除を参照してください。

前提条件 prerequisites

このガイドでは、XDM システムに関する実用的な理解が必要です。 Experience Platform エコシステム内でのXDMの役割の概要については、XDMの概要を参照し、クラスがXDM スキーマに貢献する方法については、​ スキーマ構成の基本を参照してください。

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

はじめに getting-started

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

Classes ワークスペース SchemasとClassesのSchemas タブ内のクラスの数が強調表示されています。

フィルタークラス filter

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

ClassesとSchemasがハイライト表示されたStandard ワークスペースのCustom タブ。

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

新しいクラスの作成 create

Experience Platform UIでクラスを作成するには、Create class​または​ Create schema ​を通じて2つの方法があります。

クラスを作成

Create class ワークスペースの「Classes」タブから「Schemas」を選択します。

Classesが強調表示されたSchemas ワークスペースのCreate class タブ

Create class ダイアログが表示されます。 クラスのDisplay nameとDescriptionを入力し、ラジオボタンを使用してクラスの意図された動作を選択します。 クラスのタイプはRecordまたはTime-seriesです。 Create​を選択して選択を確定し、Classes タブに戻ります。

Create classがハイライト表示されたCreate ダイアログ。

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

最近作成されたクラスがハイライト表示されたClasses ワークスペースのSchemas タブ。

スキーマを作成

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

Classesが強調表示されたSchemas ワークスペースのCreate schema タブ

表示される​Manual ダイアログで「Create a schema」を選択します。

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

ワークフローのオプションを含むスキーマを作成ダイアログで、強調表示されたオプションを選択します。

スキーマ作成ワークフローが表示されます。 Schema details セクションで、Other​を選択します。 使用可能なクラスのリストが表示されます。 Create class を選択します。

Create schema セクションでOtherが強調表示されたSchema details ワークフロー。

Create class ダイアログが表示されます。 クラスのDisplay nameとDescriptionを入力し、ラジオボタンを使用してクラスの意図された動作を選択します。 クラスのタイプはRecordまたはTime-seriesです。 Create​を選択して選択を確定し、Classes タブに戻ります。

Create classがハイライト表示されたCreate ダイアログ。

クラスリストがSchema details セクションで更新され、新しく作成したクラスが自動的に選択されます。 スキーマの作成を続行するには、Next​を選択してください。

新しいクラスが選択され、Schema detailsが強調表示されたNext セクション。

クラスを選択すると、Name and review セクションが表示されます。 このセクションでは、スキーマを識別するための名前と説明を指定します。​スキーマのベース構造(クラスから提供される)がキャンバスに表示され、選択したクラスとスキーマ構造を確認および検証できます。

人間に適したSchema display nameをテキストフィールドに入力します。 次に、適切な説明を入力して、スキーマを特定します。 スキーマ構造を確認し、設定に満足したら、Finish​を選択してスキーマを作成します。

Name and review、Create schema、Schema display nameがハイライト表示されたDescription ワークフローのFinish セクション。

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

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

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

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

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

Untitled Field プレースホルダーがキャンバスに表示され、右側のパネルが更新されて、フィールドのプロパティを設定するためのコントロールが表示されます。 Assign to​で、Class​を選択します。

スキーマエディターのキャンバス内の名称未設定のフィールドで、「Classに割り当て」フィールドプロパティが選択され、強調表示されている

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

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

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

クラスの編集 edit-a-class

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

クラスを拡張する既存のスキーマを編集するか、スキーマを手動で作成することで、スキーマワークフローを通じてクラスを編集できます。 クラスを直接編集することはできません。 Browse ワークスペースのSchemas タブ内から、既存のクラスまたは​ Create a schema ​を選択します。

既存のクラスとCreate a schemaが強調表示されたスキーマエディター。

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

フィールドを選択して強調表示し、右側のパネルが表示され、Assign toが強調表示されたスキーマエディター。

フィールドに必要な変更を加え、右側のパネルで下にスクロールして​ Apply ​を選択し、変更を保存します。

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

フィールドが選択され、右側のパネルが表示されているスキーマエディター、Applyを強調表示します。

新しいフィールドを追加するには、​ クラスにフィールドを追加する ガイドに従います。 完了したら、Save​を選択して、スキーマとクラスの両方を保存します。

Saveが強調表示されたスキーマエディター。

スキーマクラスの変更 schema

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

次の手順 next-steps

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

Schema Registry APIを使用してクラスを管理する方法については、​ クラスエンドポイントガイド ​を参照してください。

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