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

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

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

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

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

前提条件 prerequisites

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

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

はじめに getting-started

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

​ スキーマ ​ ワークスペース ​ クラス ​および​ スキーマ ​の​ クラス ​ タブ内のクラスの数が強調表示されました。

フィルタークラス filter

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

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

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

新しいクラスの作成 create

Experience Platform UIでクラスを作成するには、クラスを作成​または​ スキーマを作成 ​する2つの方法があります。

クラスを作成

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

![ クラスを作成]が強調表示された​ スキーマ ​ ワークスペースの​ クラス ​ タブ (…/…/images/ui/resources/classes/create-class.png)

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

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

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

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

スキーマを作成

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

​ スキーマの作成が強調表示された​ スキーマ ​ ワークスペースの​ クラス ​ タブ ​

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

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

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

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

​ スキーマの詳細 セクションでその他が強調表示された​ スキーマの作成 ワークフロー。

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

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

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

新しいクラスが選択され、次のが強調表示された​ スキーマの詳細 セクション。

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

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

![ スキーマ表示名]、説明、完了がハイライト表示された​ スキーマを作成 ワークフローの名前とレビュー セクション。(…/…/images/ui/resources/classes/schema-details.png)

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

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

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

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

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

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

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

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

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

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

クラスの編集 edit-a-class

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

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

既存のクラスと​ スキーマの作成が強調表示されたスキーマエディター。

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

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

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

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

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

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

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

スキーマクラスの変更 schema

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

次の手順 next-steps

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

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

recommendation-more-help
experience-platform-help-xdm