UI でのスキーマの作成と編集 create-edit-schemas-in-ui

Adobe Experience Platform UIを使用して、企業向けのExperience Data Model (XDM)スキーマを作成、編集、管理します。 このガイドでは、標準スキーマとリレーショナルスキーマの作成、スキーマ構造のカスタマイズ、参照 ワークスペースからのスキーマの管理、実稼動用のスキーマの準備の方法について説明します。

IMPORTANT
XDM スキーマは非常にカスタマイズ可能であるため、スキーマを作成する手順は、スキーマをキャプチャするデータの種類によって異なります。 その結果、このドキュメントでは、UIのスキーマで実行できる基本的なインタラクションのみを説明し、クラス、スキーマフィールドグループ、データタイプ、フィールドのカスタマイズなどの関連する手順は除外されます。
スキーマ作成プロセスの完全なツアーについては、​ スキーマ作成チュートリアル ​に従って、完全な例のスキーマを作成し、Schema Editorの多くの機能を理解してください。

前提条件 prerequisites

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

新しいスキーマの作成 create

​ スキーマ ​ ワークスペースで、右上隅の「スキーマを作成」を選択します。 「スキーマタイプを選択」ドロップダウンメニューが表示され、標準または関係 スキーマのオプションが表示されます。

​ スキーマを作成を含むスキーマワークスペースが強調表示され、​ スキーマタイプを選択 ドロップダウンが表示されます。

リレーショナルスキーマを作成 create-relational-schema

AVAILABILITY
Data Mirrorとリレーショナルスキーマは、Adobe Journey Optimizer オーケストレーションキャンペーン​のライセンス保有者が利用できます。 また、ライセンスと機能の有効化に応じて、Customer Journey Analytics ユーザー向けの​ 限定リリース ​としても利用できます。 アクセスについては、Adobe担当者にお問い合わせください。

リレーショナル​を選択して、レコードをきめ細かく制御する、構造化されたリレーショナルスタイルのスキーマを定義します。 リレーショナルスキーマは、プライマリキーの適用、レコードレベルのバージョン管理、プライマリキーと外部キーを介したスキーマレベルの関係をサポートします。 また、変更データキャプチャを使用した増分取り込みに最適化されており、キャンペーンオーケストレーション、Data Distiller、B2Bの実装で使用される複数のデータモデルをサポートしています。

詳しくは、Data Mirrorまたは​ リレーショナルスキーマ ​の概要を参照してください。

手動で作成 create-manually

AVAILABILITY
DDL ファイルのアップロードは、Adobe Journey Optimizer オーケストレーションされたキャンペーンライセンス所有者のみが使用できます。 UIの表示が異なる場合があります。

リレーショナルスキーマの作成 ダイアログが表示されます。 手動で作成​または DDL ファイルをアップロード ​ のいずれかを選択して、スキーマ構造を定義できます。

リレーショナルスキーマを作成 ダイアログで、手動で作成​を選択し、次へ​を選択します。

![ リレーショナルスキーマの作成] ダイアログで手動で作成が選択され、次が強調表示されている(…/…/images/ui/resources/schemas/relational-dialog.png)。

リレーショナルスキーマの詳細 ページが表示されます。 スキーマの表示名とオプションの説明を入力し、終了​を選択してスキーマを作成します。

![ スキーマ表示名]、説明、終了がハイライト表示された関係スキーマの詳細 ページ。(…/…/images/ui/resources/schemas/relational-details.png)

スキーマエディターが開き、スキーマ構造を定義するための空のキャンバスが表示されます。 通常どおりフィールドを追加できます。

バージョン識別子フィールドを追加する add-version-identifier

バージョンの追跡を有効にし、変更データキャプチャをサポートするには、スキーマでバージョン識別子フィールドを指定する必要があります。 スキーマエディターで、プラス( A プラスアイコン。 )を選択します。 スキーマ名の横にあるアイコンをクリックして、新しいフィールドを追加します。

updateSequenceなどのフィールド名を入力し、DateTime​または​ Number ​のデータタイプを選択します。

右側のパネルで、「バージョン識別子」チェックボックスを有効にし、「適用」を選択してフィールドを確定します。

日時フィールド updateSequenceを持つスキーマエディターが追加され、​ バージョン識別子 チェックボックスが選択されました。

IMPORTANT
レコードレベルの更新をサポートし、データキャプチャの取り込みを変更するには、リレーショナルスキーマにバージョン識別子フィールドを含める必要があります。

関係を定義するには、スキーマエディターで「関係を追加」を選択して、スキーマレベルのプライマリ/外部キー関係を作成します。 詳しくは、​ スキーマレベルの関係の追加に関するチュートリアルを参照してください。

次に、​ プライマリキーの定義に進み、必要に応じてフィールドを追加します。 Experience Platform ソースで変更データキャプチャを有効にする方法のガイダンスについては、変更データキャプチャ取り込みガイド ​を参照してください。

NOTE
保存すると、​ スキーマプロパティ ​ サイドバーのType フィールドに、これが​ リレーショナル ​ スキーマであることが示されます。これは、スキーマインベントリビューの詳細サイドバーにも表示されます。
![ スキーマプロパティ ] サイドバーに​ リレーショナル ​ タイプが表示された、空のリレーショナルスキーマ構造を示すスキーマエディターキャンバス。(…/…/images/ui/resources/schemas/relational-empty-canvas.png)

DDL ファイルのアップロード upload-ddl-file

AVAILABILITY
DDL ファイルのアップロードは、Adobe Journey Optimizer オーケストレーションされたキャンペーンライセンス所有者のみが使用できます。

このワークフローを使用して、DDL ファイルをアップロードしてスキーマを定義します。 リレーショナルスキーマの作成 ダイアログで、DDL ファイルのアップロード​を選択し、システムからローカル DDL ファイルをドラッグするか、ファイルの選択​を選択します。 Experience Platformはスキーマを検証し、ファイルのアップロードが成功した場合は緑色のチェックマークを表示します。 「次へ」を選択して、アップロードを確定します。

![ リレーショナルスキーマの作成] ダイアログで、DDL ファイルのアップロード ​を選択し、​ ファイルの選択 ボタンとドラッグ&ドロップ領域を含むファイルのアップロード領域が表示されます。(…/…/images/ui/resources/schemas/upload-ddl-file.png)

読み込むエンティティとフィールドを選択 ダイアログが表示され、スキーマをプレビューできます。 スキーマ構造を確認し、ラジオボタンとチェックボックスを使用して、各エンティティにプライマリキーとバージョン識別子が指定されていることを確認します。

IMPORTANT
テーブル構造には、プライマリキー​と​ バージョン識別子 ​を含める必要があります(datetimeまたはnumber型のupdateSequence フィールドなど)。
変更データキャプチャの取り込みでは、増分処理を有効にするために、String タイプの_change_request_typeという名前の特別な列も必要です。 このフィールドは、データ変更の種類(例:u (upsert)またはd (delete))を示します。

取り込み中は必要ですが、_change_request_typeなどの制御列はスキーマに保存されず、最終的なスキーマ構造には表示されません。 正しく表示されたら、完了​を選択してスキーマを作成します。

NOTE
DDL アップロードでサポートされる最大ファイルサイズは10 MBです。

![読み込むエンティティとフィールドを選択] ダイアログで読み込まれたフィールドが表示され、完了が強調表示されます。(…/…/images/ui/resources/schemas/entities-and-files-to-import.png)

スキーマエディターでスキーマが開き、保存する前に構造を調整できます。

次に、追加フィールド ​に進み、必要に応じてスキーマレベルの関係を追加します。

Experience Platform ソースで変更データキャプチャを有効にする方法のガイダンスについては、変更データキャプチャ取り込みガイド ​を参照してください。

標準スキーマの作成 create-standard-schema

スキーマタイプメニューから「Standard」を選択します。 「​ スキーマを作成」ダイアログが表示されます。 このダイアログから、スキーマ作成ワークフローを選択します。 フィールドとフィールドグループを追加してスキーマを手動で作成したり、CSV ファイルをアップロードしてスキーマを自動的に生成したりできます。

​ スキーマ作成ワークフローオプションがハイライト表示された​ スキーマ作成 ダイアログ。

[Beta]{class="badge informative"}手動またはML支援のスキーマ作成 manual-or-assisted

マシンラーニングアルゴリズムを使用して、csv ファイルに基づくスキーマ構造を推奨する方法については、機械学習支援スキーマ作成ガイド ​を参照してください。 このUI ガイドでは、手動作成ワークフローに焦点を当てます。

手動スキーマ作成 manual-creation

​ スキーマの作成 ワークフローが表示されます。 スキーマの基本クラスを選択するには、個人プロファイルエクスペリエンスイベント、または​その他、その後​ ​を選択して選択を確定します。 これらのクラスについて詳しくは、XDM個人プロファイル ​およびXDM ExperienceEventのドキュメントを参照してください。

![次の]が強調表示された3つの基本クラス オプションを示す​ スキーマの作成 ワークフロー。(…/…/images/ui/resources/schemas/schema-class-options.png)

その他​を選択すると、使用可能なクラスのリストが表示されます。 ここから、既存のクラスを参照してフィルタリングできます。

その他が選択され、使用可能なクラスのリストが表示された​ スキーマの作成 ワークフロー。

ラジオボタンを選択して、カスタムクラスと標準クラスのどちらに属しているかに基づいてクラスをフィルタリングします。 業界に基づいて使用可能な結果をフィルタリングしたり、検索フィールドを使用して特定のクラスを検索したりすることもできます。

検索バー、​ カスタム ​および業種が強調表示された​ スキーマの作成 ワークフロー。

適切なクラスを決めるには、各クラスの情報とプレビューアイコンがあります。 情報アイコン ( 情報アイコン。 ) クラスとそのクラスが関連付けられている業界の説明を示すダイアログが開きます。

​ クラスの説明と関連する業界を示すクラス情報ツールチップを開いた​ スキーマを作成 ワークフロー。

プレビューアイコン ( ​ プレビューアイコン。 ) スキーマダイアグラムとそのプロパティを含むクラスのプレビューダイアログを開きます。

選択したクラスのスキーマ ダイアグラムとプロパティを表示するクラス プレビューダイアログ。

任意の行を選択してクラスを選択し、次へ​を選択して選択を確定します。

使用可能なクラスのテーブルから選択されたクラスと次が強調表示された​ スキーマの作成 ワークフロー。

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

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

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

スキーマエディターが表示され、キャンバスにスキーマの構造が表示されます。 必要に応じて、​ クラスにフィールドを追加できるようになりました

​ スキーマエディターに、新しく作成されたスキーマのベース構造がキャンバスに表示されます。

既存のスキーマの編集 edit

NOTE
スキーマを保存してデータ取り込みに使用すると、追加の変更のみを行うことができます。 詳しくは、​ スキーマ進化のルール ​を参照してください。

既存のスキーマを編集するには、「参照」タブを選択し、編集するスキーマの名前を選択します。 検索バーを使用して、使用可能なオプションのリストを絞り込むこともできます。

​ スキーマワークスペース 選択および編集用にハイライト表示されたスキーマ名を含む「を参照」タブ。

TIP
ワークスペースの検索およびフィルタリング機能を使用すると、スキーマを見つけやすくなります。 詳しくは、XDM リソースの探索に関するガイドを参照してください。

スキーマを選択すると、キャンバスにスキーマの構造が表示されたSchema Editorが表示されます。 次の節で説明するツールとオプションを使用して、スキーマをカスタマイズできるようになりました。

スキーマのカスタマイズ customize-schema

スキーマエディターでスキーマを開いたら、構造、フィールド、表示プロパティをカスタマイズできます。 この節では、特定の要件に合わせてスキーマをカスタマイズするために使用できる主なカスタマイズオプションについて説明します。

次のリンクを使用して、このセクション内の主要なカスタマイズタスクに直接移動します。

表示名切り替え display-name-toggle

スキーマエディターには、元のフィールド名と、より読みやすい表示名を切り替えるための切り替えスイッチが用意されています。 この柔軟性により、フィールドの検出性が向上し、スキーマを編集できます。 トグルは、スキーマエディタービューの右上にあります。

NOTE
フィールド名から表示名への変更は、純粋に表面的なものであり、下流のリソースは変更されません。

​ フィールドの表示名を表示がハイライト表示されたスキーマエディター。

標準フィールドグループの表示名はシステムで生成されますが、表示名 セクションの説明に従ってカスタマイズできます。 表示名は、マッピングやデータセットのプレビューなど、複数のUI ビューに反映されます。 デフォルト設定はオフで、フィールド名は元の値で表示されます。

スキーマへのフィールドグループの追加 add-field-groups

NOTE
この節では、既存のフィールドグループをスキーマに追加する方法について説明します。 新しいカスタムフィールドグループを作成する場合は、代わりに​ フィールドグループの作成と編集に関するガイドを参照してください。

Schema Editor内のスキーマを開いたら、フィールドグループを使用してスキーマにフィールドを追加できます。 開始するには、左側のパネルの​ フィールドグループ ​の横にある​ 追加 ​を選択します。

左側のパネルの​ フィールドグループ ​ セクションに追加 ボタンが強調表示されたスキーマエディター。

ダイアログが表示され、スキーマに選択できるフィールドグループのリストが表示されます。 フィールドグループは1つのクラスとしか互換性がないので、スキーマで選択したクラスに関連付けられているフィールドグループのみが一覧表示されます。 デフォルトでは、リストされたフィールドグループは、組織内での使用頻度に基づいて並べ替えられます。

​ 「​ フィールドグループを追加」ダイアログに、使用可能なフィールドグループが人気度列で並べ替えられて表示されます。

追加するフィールドの一般的なアクティビティまたはビジネス領域がわかっている場合は、左側のパネルで1つ以上の業界垂直型カテゴリを選択して、表示されるフィールドグループのリストをフィルタリングします。

左側のパネルで業種のフィルターを選択し、業種列を強調表示した​ フィールドグループを追加 ダイアログ。

NOTE
XDMでの業界固有のデータモデリングのベストプラクティスについて詳しくは、業界データモデル ​に関するドキュメントを参照してください。

検索バーを使用して、目的のフィールドグループを見つけることもできます。 クエリと一致する名前のフィールドグループがリストの上部に表示されます。 標準フィールド​の下に、目的のデータ属性を記述するフィールドを含むフィールドグループが表示されます。

検索バーがアクティブな​ フィールドグループを追加 ダイアログと標準フィールド ​の結果が表示されます。

スキーマに追加するフィールドグループの名前の横にあるチェックボックスを選択します。 リストから複数のフィールドグループを選択し、選択した各フィールドグループを右側のパネルに表示できます。

​ チェックボックスを使用して選択したフィールドグループと、右側のパネルに表示されている選択したグループを含む​ フィールドグループを追加 ダイアログ。

TIP
リストされているフィールドグループの場合、情報アイコン( 情報アイコン ​ )にカーソルを合わせるか、フォーカスを合わせると、フィールドグループがキャプチャするデータの種類の簡単な説明を表示できます。 プレビューアイコン( ​ プレビューアイコン ​ )を選択して、フィールドグループが提供するフィールドの構造をスキーマに追加する前に表示することもできます。

フィールドグループを選択したら、フィールドグループを追加​を選択してスキーマに追加します。

​ フィールドグループを選択し、​ フィールドグループを追加を強調表示した​ フィールドグループを追加 ダイアログ。

Schema Editorが再び表示され、キャンバスに表示されるフィールドグループが提供するフィールドが表示されます。

新しく追加されたフィールドグループのフィールドをキャンバスに表示するスキーマエディター。

NOTE
スキーマエディター内では、標準(Adobeで生成された)クラスとフィールドグループが、南京錠アイコン 南京錠アイコン ​ で示されます。南京錠は、クラス名またはフィールドグループ名の横にある左側のパネルと、システム生成リソースの一部であるスキーマダイアグラム内の任意のフィールドの横に表示されます。
左側のパネルの標準フィールドグループ名の横に南京錠アイコンが強調表示されたスキーマエディター。

スキーマにフィールドグループを追加した後、必要に応じて、オプションで既存のフィールド ​を削除するか、新しいカスタムフィールド ​をそれらのグループに追加できます。

フィールドグループから追加されたフィールドの削除 remove-fields

フィールドグループをスキーマに追加したら、フィールドグループからグローバルにフィールドを削除するか、現在のスキーマからローカルにフィールドを非表示にすることができます。 これらのアクションの違いを理解することは、意図しないスキーマの変更を避けるために非常に重要です。

IMPORTANT
削除​を選択すると、フィールドグループ自体からフィールドが削除され、そのフィールドグループを使用する​すべての スキーマに影響を与えます。
フィールドグループを含むすべてのスキーマからフィールドを​削除しない限り、このオプションを使用しないでください

フィールドグループからフィールドを削除するには、キャンバスでフィールドを選択し、右側のパネルで​ 削除 ​を選択します。 次の例は、デモグラフィックの詳細 グループのtaxId フィールドを示しています。

​ キャンバスでフィールドが選択され、右側のパネルで削除が強調表示されたスキーマエディター。

フィールドグループ自体から削除せずにスキーマから複数のフィールドを非表示にするには、関連フィールドを管理 オプションを使用します。 キャンバスのグループから任意のフィールドを選択し、右側のパネルで「関連フィールドを管理」を選択します。

​ キャンバスでフィールドグループフィールドを選択し、右側のパネルで関連フィールドを管理を強調表示したスキーマエディター。

フィールドグループの構造を示すダイアログが表示されます。 チェックボックスを使用して、含めるフィールドを選択または選択解除します。

選択したフィールドと確認がハイライト表示された関連フィールドの管理 ダイアログ。

確認​を選択して、キャンバスを更新し、選択したフィールドを反映します。

![関連フィールドの管理] ダイアログでフィールドの表示の変更を確認した後、更新されたスキーマ構造を表示するスキーマエディターキャンバス。(…/…/images/ui/resources/schemas/fields-added.png)

フィールドを削除または非推奨にする際のフィールドの動作 field-removal-deprecation-behavior

各アクションの範囲を理解するには、次の表を使用します。

アクション
現在のスキーマにのみ適用
フィールドグループを変更
他のスキーマに影響します
説明
フィールドを削除
×
フィールドグループからフィールドを削除します。 これにより、そのグループを使用するすべてのスキーマから削除されます。
関連フィールドの管理
×
×
現在のスキーマからのみフィールドを非表示にします。 フィールドグループは変更されません。
非推奨フィールド
×
フィールドグループで、フィールドを非推奨(廃止予定)とマークします。 このスキーマは使用できなくなりました。
NOTE
この動作は、レコードベースとイベントベースの両方のスキーマで一貫しています。

フィールドグループへのカスタムフィールドの追加 add-fields

スキーマにフィールドグループを追加した後、そのグループの追加フィールドを定義できます。 ただし、1つのスキーマのフィールドグループに追加されたフィールドは、同じフィールドグループを使用する他のすべてのスキーマにも表示されます。

さらに、カスタムフィールドが標準フィールドグループに追加されると、そのフィールドグループはカスタムフィールドグループに変換され、元の標準フィールドグループは使用できなくなります。

カスタムフィールドを標準フィールドグループに追加する場合は、特定の手順については、以下のを参照してください。 カスタムフィールドグループにフィールドを追加する場合は、フィールドグループ UI ガイドの​ カスタムフィールドグループの編集の節を参照してください。

既存のフィールドグループを変更しない場合は、新しいカスタムフィールドグループを作成して、代わりに追加フィールドを定義できます

スキーマへのフィールドの追加 add-fields-to-schema

スキーマエディターには、スキーマ構造にフィールドを追加する複数の方法があります。 それぞれの企業の要件に最適な手法を選択してください。

スキーマにフィールドを追加する特定の方法については、次のリンクを参照してください。

スキーマへの個々のフィールドの追加 add-individual-fields

特定のユースケースでフィールドグループ全体を追加しない場合は、スキーマエディターを使用して、個々のフィールドをスキーマに直接追加できます。 標準フィールドグループ ​から個別のフィールドを追加するか、独自のカスタムフィールドを追加できます。

IMPORTANT
スキーマエディターでは、個々のフィールドをスキーマに直接追加することができますが、XDM スキーマ内のすべてのフィールドをクラスまたはクラスと互換性のあるフィールドグループで提供する必要があるという事実は変わりません。 以下の節で説明するように、すべての個々のフィールドは、スキーマに追加されたときに、キーステップとしてクラスまたはフィールドグループに関連付けられます。

スキーマへの標準フィールドの追加 add-standard-fields

標準フィールドグループのフィールドを、対応するフィールドグループを事前に把握することなく、スキーマに直接追加できます。 スキーマに標準フィールドを追加するには、キャンバス内のスキーマ名の横にあるプラス(+)アイコンを選択します。 名称未設定のフィールド プレースホルダーがスキーマ構造に表示され、右側のパネルが更新されて、フィールドを設定するためのコントロールが表示されます。

右側のパネルに名称未設定のフィールド ​ プレースホルダーが追加され、フィールド設定コントロールが表示されているスキーマエディターのキャンバス。

フィールド名​で、追加するフィールドの名前を入力します。 クエリに一致する標準フィールドが自動的に検索され、それらが属するフィールドグループを含む​ 推奨される標準フィールド ​に一覧表示されます。

​ スキーマエディターの右側のパネルに、入力されたフィールド名クエリに一致する推奨される標準フィールド ​が表示されています。

一部の標準フィールドは同じ名前を共有していますが、その構造は、元のフィールドグループによって異なる場合があります。 標準フィールドがフィールドグループ構造の親オブジェクト内にネストされている場合、子フィールドが追加されると、親フィールドもスキーマに含まれます。

標準フィールドの横にあるプレビューアイコン( ​ プレビューアイコン ​ )を選択して、フィールドグループの構造を表示し、ネストする方法をより詳細に把握します。 標準フィールドをスキーマに追加するには、プラスアイコン( ​ プラスアイコン ​ )を選択します。

標準フィールドのプレビューが開き、追加アイコンがハイライト表示されたスキーマエディターフィールド設定パネル。

キャンバスが更新され、スキーマに追加された標準フィールド(フィールドグループ構造内でネストされている親フィールドを含む)が表示されます。 フィールドグループの名前は、左側のパネルの​ フィールドグループ ​の下にも表示されます。 同じフィールドグループからさらにフィールドを追加する場合は、右側のパネルで「関連フィールドを管理」を選択します。

​ スキーマエディターのキャンバスに、スキーマ構造に追加された標準フィールドが表示され、親フィールドが表示され、フィールドグループが左側のパネルに表示されます。

スキーマへのカスタムフィールドの追加 add-custom-fields

標準フィールドのワークフローと同様に、独自のカスタムフィールドをスキーマに直接追加することもできます。

スキーマのルートレベルにフィールドを追加するには、キャンバス内のスキーマ名の横にあるプラス(+)アイコンを選択します。 名称未設定のフィールド プレースホルダーがスキーマ構造に表示され、右側のパネルが更新されて、フィールドを設定するためのコントロールが表示されます。

右側のパネルのルートレベルとフィールド設定コントロールに名称未設定フィールド ​のプレースホルダーが追加されたスキーマエディターキャンバス。

追加するフィールド名を入力すると、システムは一致する標準フィールドの検索を自動的に開始します。 代わりに新しいカスタムフィールドを作成するには、(新しいフィールド ​)​が追加された最上位オプションを選択します。

​ カスタムフィールド名が入力されたスキーマエディターの右側のパネルと、フィールド名の候補で新しいフィールド ​ オプションが強調表示されています。

フィールドの表示名とデータタイプを指定したら、次の手順では、フィールドを親XDM リソースに割り当てます。 スキーマでカスタムクラスを使用している場合は、代わりに割り当てられたクラス ​または​ フィールドグループ ​にフィールドを追加することを選択できます。 ただし、スキーマで標準クラスを使用している場合は、カスタムフィールドをフィールドグループにのみ割り当てることができます。

カスタムフィールドグループへのフィールドの割り当て add-to-field-group

NOTE
この節では、カスタムフィールドグループにフィールドを割り当てる方法のみを説明します。 代わりに新しいカスタムフィールドを使用して標準フィールドグループを拡張する場合は、標準フィールドグループへのカスタムフィールドの追加の節を参照してください。

割り当て​で、フィールドグループ​を選択します。 スキーマで標準クラスを使用している場合、これは使用可能な唯一のオプションであり、デフォルトで選択されています。

次に、関連付ける新しいフィールドのフィールドグループを選択する必要があります。 指定したテキスト入力で、フィールドグループの名前を入力します。 入力に一致する既存のカスタムフィールドグループがある場合、それらはドロップダウンリストに表示されます。 または、一意の名前を入力して、新しいフィールドグループを作成することもできます。

​ スキーマエディターの右側のパネルで「割り当て」フィールドグループオプションが選択され、フィールドグループ名の入力フィールドが強調表示されている

WARNING
既存のカスタムフィールドグループを選択した場合、そのフィールドグループを使用する他のスキーマも、変更を保存した後に新しく追加されたフィールドを継承します。 このため、この種類の伝播が必要な場合にのみ、既存のフィールドグループを選択します。 それ以外の場合は、代わりに新しいカスタムフィールドグループを作成することをお勧めします。

リストからフィールドグループを選択したら、適用​を選択します。

​ スキーマエディターの右側のパネルに、適用が強調表示された新しいカスタムフィールド設定が表示されています。

新しいフィールドがキャンバスに追加され、標準XDM フィールドとの競合を避けるために、​ テナント IDの下に名前空間が設定されます。 新しいフィールドを関連付けたフィールドグループは、左側のパネルの​ フィールドグループ ​の下にも表示されます。

​ スキーマエディターのキャンバスに、テナント ID名前空間の下に追加された新しいカスタムフィールドが表示され、関連付けられたフィールドグループが左側のパネルに表示されます。

NOTE
選択したカスタムフィールドグループによって提供される残りのフィールドは、デフォルトでスキーマから削除されます。 これらのフィールドの一部をスキーマに追加する場合は、グループに属するフィールドを選択し、右側のパネルで「関連フィールドを管理」を選択します。

カスタムクラスへのフィールドの割り当て add-to-class

割り当て」で、「クラス」を選択します。 以下の入力フィールドは、現在のスキーマのカスタムクラスの名前に置き換えられ、新しいフィールドがこのクラスに割り当てられることを示します。

新しいフィールド割り当てに選択されている​ クラス ​ オプション。

必要に応じてフィールドの設定を続行し、完了したら​ 適用 ​を選択します。

​ スキーマエディターの右側のパネルに、適用が強調表示されたカスタムクラスに割り当てられた新しいフィールドが表示されています。

新しいフィールドがキャンバスに追加され、標準XDM フィールドとの競合を避けるために、​ テナント IDの下に名前空間が設定されます。 左側のパネルでクラス名を選択すると、クラスの構造の一部として新しいフィールドが表示されます。

​ カスタムクラスの構造に適用された新しいフィールド。キャンバスに表示されます。

標準フィールドグループへのカスタムフィールドの追加 custom-fields-for-standard-groups

作業中のスキーマに、標準フィールドグループによって提供されるオブジェクトタイプフィールドがある場合は、独自のカスタムフィールドをその標準オブジェクトに追加できます。

WARNING
1つのスキーマのフィールドグループに追加されたフィールドは、同じフィールドグループを使用する他のすべてのスキーマにも表示されます。 さらに、カスタムフィールドが標準フィールドグループに追加されると、そのフィールドグループはカスタムフィールドグループに変換され、元の標準フィールドグループは使用できなくなります。
この機能のベータ版に参加すると、以前にカスタマイズした標準フィールドグループを知らせるダイアログが表示されます。 Acknowledge​を選択すると、リストされたリソースはカスタムフィールドグループに変換されます。
以前にカスタマイズされた標準フィールドグループが一覧表示され、Acknowledgeがハイライト表示されているベータ版コンバージョン確認ダイアログ。

開始するには、標準フィールドグループによって提供されるオブジェクトのルートの横にあるプラス(+)アイコンを選択します。

標準フィールドグループオブジェクトの横にプラスアイコンが強調表示されたスキーマエディターキャンバスで、カスタムフィールドを追加します。

警告メッセージが表示され、標準フィールドグループを変換するかどうかを確認するメッセージが表示されます。 「フィールドグループの作成を続行」を選択して続行します。

​ スキーマエディターの警告ダイアログで、標準フィールドグループを変換するための確認を求めるメッセージが表示され、​ フィールドグループの作成を続行が強調表示されます。

新しいフィールドの名称未設定のプレースホルダーがキャンバスに再表示されます。 標準フィールドグループの名前には、元のバージョンから変更されたことを示す「(Extended)」が追加されています。 ここから、右側のパネルのコントロールを使用して、フィールドのプロパティを定義します。

標準フィールドグループの名前がExtended サフィックスで変更され、名称未設定のプレースホルダーフィールドが追加されたスキーマエディターキャンバス。

変更を適用すると、標準オブジェクト内のテナント ID名前空間の下に新しいフィールドが表示されます。 このネストされた名前空間は、同じフィールドグループを使用する他のスキーマの変更が壊れるのを防ぐために、フィールドグループ自体内でのフィールド名の競合を防ぎます。

変換された標準フィールドグループ内のテナント ID名前空間の下に追加された新しいカスタムフィールドを示すスキーマエディターキャンバス。

スキーマフィールドの表示名の編集 display-names

クラスを割り当ててスキーマにフィールドグループを追加したら、それらのフィールドが標準またはカスタム XDM リソースによって提供されているかどうかに関係なく、スキーマの任意のフィールドの表示名を編集できます。

NOTE
標準クラスまたはフィールドグループに属するフィールドの表示名は、特定のスキーマのコンテキストでのみ編集できることに注意してください。 つまり、1つのスキーマ内の標準フィールドの表示名を変更しても、同じ関連クラスまたはフィールドグループを使用する他のスキーマには影響しません。
スキーマのフィールドの表示名を変更すると、その変更は、スキーマに基づく既存のデータセットにすぐに反映されます。

フィールドの表示名を表示​に切り替えて、フィールド名を表示名に変更します。 スキーマフィールドの表示名を編集するには、キャンバスでフィールドを選択します。 右側のパネルで、表示名​の下に新しい名前を入力します。

​ キャンバスで選択されたフィールドと、右側のパネルで強調表示された表示名 フィールドを含むスキーマエディター。

右側のパネルで「適用」を選択すると、キャンバスが更新され、フィールドの新しい表示名が表示されます。 保存​を選択して、変更をスキーマに適用します。

​ スキーマエディターのキャンバスに、更新されたフィールド表示名が表示され、保存が強調表示されています。

スキーマを管理 manage-schemas

スキーマ管理タスクは、Experience Platform UIの2つの主要な場所から使用できます。 スキーマの作業場所に基づいて、適切なワークフローを選択します。

参照ビューでのスキーマの管理 manage-from-browse

この節では、参照 タブから使用できるスキーマアクションについて説明します。スキーマの検出、フィルタリング、および整理について詳しくは、XDM リソースの探索を参照してください。

​ スキーマワークスペース 省略記号メニューがスキーマ行に対して開かれている「を参照」タブ。インラインアクション(編集、削除、​ ラベルを適用、​ タグを管理)が表示されている。

次の節では、参照 タブで使用できるスキーマ管理アクションについて説明します。 これらのアクションには、各スキーマ行の横にある省略記号(。…)メニューからアクセスできます。

アクション
説明
​ スキーマプロパティの編集
スキーマエディターを開かずに、表示名、説明、タグなどの基本的なスキーマ情報を変更します。 詳細な手順については、​ スキーマプロパティの編集を参照してください。
​ スキーマの削除
組織からスキーマを削除します。 リアルタイム顧客プロファイルに対して有効になっていないスキーマと、関連するデータセットがないスキーマでのみ使用できます。 詳細な手順については、​ スキーマの削除を参照してください。
​ ラベルの適用 (データガバナンス)
プライバシーポリシーとコンプライアンス要件に従って、データ使用ラベルを割り当て、スキーマを分類します。 スキーマレベルで適用されたラベルは、そのスキーマから作成されたすべてのデータセットに反映されます。 詳細な手順については、​ データガバナンスラベルの適用を参照してください。
​ データセットを作成
選択したスキーマから新しいデータセットを作成します。 詳細な手順については、​ データセットの作成を参照してください。
​ タグの管理
スキーマの整理に使用するユーザー定義タグを追加または削除します。 詳細な手順については、​ タグの管理を参照してください。
​ フォルダーに移動
スキーマをフォルダー階層に移動します。 詳細な手順については、​ フォルダーへの移動を参照してください。
​ パッケージに追加
環境をまたいでデプロイするためのサンドボックスツールパッケージにスキーマを含めます。 詳細な手順については、​ パッケージに追加を参照してください。
JSON構造をコピー
スキーマの完全なJSON表現をクリップボードにコピーします。 詳細な手順については、JSON構造をコピーを参照してください。
​ サンプルファイルをダウンロード ​
スキーマ構造に準拠したサンプルデータファイルを生成してダウンロードします。 詳細な手順については、​ サンプルファイルのダウンロード ​を参照してください。
NOTE
サンプルファイルはスキーマ構造をテストするためのもので、実稼動データを含めないでください。

スキーマプロパティの編集 edit-schema-properties

スキーマがあらかじめ入力されており、スキーマエディターに直接アクセスできます。

スキーマを削除 delete-schema

組織からスキーマを削除します。 削除は、リアルタイム顧客プロファイルに対して有効になっていない、関連するデータセットがないスキーマでのみ使用できます。 削除すると、スキーマを復元できません。

データガバナンスラベルを適用 apply-data-governance-labels

スキーマワークスペース ​ ラベル ​ タブに移動します。 完全な手順については、​ スキーマのデータ使用ラベルの管理 ドキュメントを参照してください。

データセットの作成 create-dataset

AVAILABILITY
このアクションは、標準(非リレーショナル)スキーマでのみ使用できます。

ソーススキーマ名が事前入力された​スキーマからデータセットを作成 ダイアログを開きます。 データセット 名前​とオプションで​ 説明 ​を入力し、データセットを作成​を選択してデータセットを作成します。

​ 「​ スキーマからデータセットを作成」ダイアログ。ハイライトされた名前および説明 フィールドと、​ データセットを作成 ボタン ​

データセットを作成すると、​ データセット ​ ワークスペースで開きます。

タグの管理 manage-tags

​ タグの追加または削除 ダイアログを開きます。このダイアログでは、ユーザー定義のタグをスキーマに割り当てたり削除したりできます。 スキーマに割り当てられたタグは、スキーマインベントリに表示され、フィルタリングに使用できます。 タグベースの整理について詳しくは、XDM リソースの探索を参照してください。

フォルダーに移動 move-to-folder

宛先フォルダーを選択するか、新しいフォルダーを作成できる移動 ダイアログを開きます。 フォルダーに整理されたスキーマは、左側のパネルのフォルダー階層に表示されます。 フォルダーベースの組織について詳しくは、XDM リソースの探索を参照してください。

パッケージに追加 add-to-package

環境をまたいでデプロイするためのサンドボックスツールパッケージにスキーマを含めます。 スキーマは、パッケージの適格性要件を満たす必要があります。 スキーマを含むパッケージは、サンドボックス間でエクスポートおよびインポートできます。

JSON 構造をコピー copy-json-structure

スキーマの完全なJSON表現をクリップボードにコピーします。 出力は、スキーマレジストリに保存されているスキーマ構造と一致し、API操作またはスキーマ共有に使用できます。

サンプルファイルをダウンロード download-sample-file

スキーマ構造に準拠したサンプルデータファイルを生成してダウンロードします。 このファイルには、スキーマで定義された各フィールドの値の例が含まれています。 サンプルファイルは、スキーマ構造のテストのみを目的としており、実稼動データを含めないでください。

スキーマエディターでのスキーマの管理 manage-from-editor

スキーマエディター内で、スキーマのJSON構造をコピーするためのクイックアクションを実行したり、スキーマがリアルタイム顧客プロファイルに対して有効になっておらず、関連するデータセットがない場合にスキーマを削除したりできます。 ビューの上部にある詳細を選択して、クイックアクションを含むドロップダウンを表示します。

詳細 ボタンが強調表示され、クイックアクションドロップダウンが表示されたスキーマエディター。

JSON構造のコピー機能を使用すると、スキーマとデータパイプラインの構築中にサンプルペイロードがどのように表示されるかを確認できます。 この機能は、ID マップなど、スキーマ内に複雑なオブジェクトマップ構造がある場合に特に便利です。

スキーマの最終版 finalize-schema

スキーマ構造とフィールドのカスタマイズが完了したら、実稼動用に準備するために追加の手順を実行する必要がある場合があります。 これらの最後の設定手順により、スキーマがExperience Platform サービスと適切に統合されます。

リアルタイム顧客プロファイルのスキーマを有効にする profile

​ リアルタイム顧客プロファイル ​は、様々なソースからデータを統合して、個々の顧客の全体像を構築します。 スキーマによってキャプチャされたデータをこのプロセスに参加させるには、Profileで使用するスキーマを有効にする必要があります。

IMPORTANT
Profileのスキーマを有効にするには、プライマリ ID フィールドが定義されている必要があります。 詳しくは、ID フィールドの定義に関するガイドを参照してください。

スキーマを有効にするには、左側のパネルでスキーマの名前を選択してから、右側のパネルで「プロファイル」トグルを選択します。

左側のパネルでスキーマ名が選択され、右側のパネルで​ プロファイル ​の切り替えが強調表示されたスキーマエディター。

ポップオーバーが表示され、スキーマを有効にして保存すると、無効にできないことを警告します。 続行するには、有効にする​を選択します。

![ 「有効化」ボタンが強調表示されたプロファイル ]の有効化の確認ポップオーバー。(…/…/images/ui/resources/schemas/profile-confirm.png)

​ プロファイル ​切り替えが有効になっている状態で、キャンバスが再び表示されます。

IMPORTANT
スキーマはまだ保存されていないため、スキーマをリアルタイム顧客プロファイルに参加させる方法を変更する場合は、この点が返されない場合です。有効なスキーマを保存すると、無効にできなくなります。 「プロファイル」トグルをもう一度選択して、スキーマを無効にします。

プロセスを完了するには、保存​を選択してスキーマを保存します。

​ スキーマエディターの右側のパネルに、​ プロファイル ​の切り替えスイッチが有効な状態で表示されています。

スキーマは、リアルタイム顧客プロファイルで使用できるようになりました。 Experience Platformがこのスキーマに基づいてデータセットにデータを取り込むと、そのデータは統合されたプロファイルデータに組み込まれます。

スキーマのクラスを変更する change-class

スキーマが保存される前の初期作成プロセス中の任意の時点で、スキーマのクラスを変更できます。

WARNING
スキーマのクラスの再割り当ては、細心の注意を払って行う必要があります。 フィールドグループは特定のクラスにのみ適合するので、クラスを変更すると、キャンバスと追加したフィールドがリセットされます。

クラスを再割り当てするには、キャンバスの左側にある「割り当て」を選択します。

左側に「割り当て」ボタンが強調表示されたスキーマエディターのキャンバス。

ダイアログが表示され、使用可能なすべてのクラスのリストが表示されます。これには、組織で定義されたクラス(「Customer」の所有者)と、Adobeで定義された標準クラスが含まれます。

リストからクラスを選択して、ダイアログの右側にその説明を表示します。 クラス構造をプレビュー​を選択して、クラスに関連付けられているフィールドとメタデータを表示することもできます。 「クラスを割り当て」を選択して続行します。

選択したクラスの説明が表示され、​ クラスを割り当てが強調表示された利用可能なクラスを表示する​ クラスを割り当て ダイアログ。

新しいクラスを割り当てることを確認するダイアログが開きます。 「割り当て」を選択して確定します。

​ 「割り当て」ボタンが強調表示されたクラスの割り当て確認ダイアログ。

クラスの変更を確認した後、キャンバスがリセットされ、すべてのコンポジションの進行状況が失われます。

次の手順 next-steps

このドキュメントでは、Experience Platform UIでのスキーマの作成と編集の基本について説明します。 独自のユースケースに対するカスタムフィールドグループとデータタイプの作成を含む、UIで完全なスキーマを構築するための包括的なワークフローについては、​ スキーマ作成チュートリアル ​を確認することを強くお勧めします。

​ スキーマ ​ ワークスペースの機能について詳しくは、​ スキーマ ​ ワークスペースの概要を参照してください。

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

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