UI でのスキーマの作成と編集 create-edit-schemas-in-ui
このガイドでは、Adobe Experience Platform UI で組織の Experience Data Model (XDM)スキーマを作成、編集、管理する方法の概要について説明します。
前提条件 prerequisites
このガイドでは、XDM システムに関する十分な知識が必要です。 を参照してください。 XDM の概要 を参照してください。Experience Platformエコシステム内での XDM の役割の概要および スキーマ構成の基本 を参照してください。
新しいスキーマの作成 create
が含まれる スキーマ ワークスペース、選択 スキーマを作成 右上隅
この スキーマを作成 ワークフローが表示されます。 次のいずれかを選択することで、スキーマの基本クラスを選択できます 個人プロファイル, エクスペリエンスイベント、または その他、続いて 次 をクリックして選択内容を確定します。 を参照してください。 XDM 個人プロファイル および XDM ExperienceEvent これらのクラスの詳細については、を参照してください。
クラスを選択すると、 名前とレビュー セクションが表示されます。 このセクションでは、スキーマを識別するための名前と説明を指定します。キャンバスにスキーマの基本構造(クラスによって提供される)が表示され、選択したクラスとスキーマ構造を確認できます。
人間に優しい スキーマの表示名 「」テキストフィールドに入力します。 次に、スキーマの識別に役立つ適切な説明を入力します。 スキーマ構造をレビューし、設定に満足したら、次を選択します 終了 スキーマを作成します。
この スキーマ 参照 タブが表示されます。 最近作成したスキーマがスキーマライブラリに一覧表示され、で編集できるようになりました Schema Editor.
既存のスキーマの編集 edit
既存のスキーマを編集するには、 参照 タブをクリックし、編集するスキーマの名前を選択します。 検索バーを使用して、使用可能なオプションのリストを絞り込むこともできます。
スキーマを選択すると、 Schema Editor は、キャンバスに表示されるスキーマの構造と共に表示されます。 これで、 フィールドグループの追加 スキーマに追加(または 個々のフィールドの追加 (これらのグループから)、 フィールドの表示名の編集、または 既存のカスタムフィールドグループの編集 スキーマで使用されている場合。
その他のアクション more
また、スキーマエディター内でクイックアクションを実行して、スキーマの JSON 構造をコピーしたり、リアルタイム顧客プロファイルが有効になっていない場合や関連付けられたデータセットがある場合はスキーマを削除したりできます。 を選択 詳細 ビューの上部に、クイックアクションを含むドロップダウンを表示します。
JSON 構造をコピー機能を使用すると、スキーマとデータパイプラインを作成している間、サンプルペイロードがどのように見えるかを確認できます。 これは、ID マップなど、スキーマ内に複雑なオブジェクトマップ構造がある場合に特に便利です。
表示名の切替 display-name-toggle
スキーマエディターでは、便宜上、元のフィールド名と、より人間が読み取り可能な表示名との間で変更する切替スイッチを提供しています。 この柔軟性により、フィールドの検出性が向上し、スキーマを編集できます。切替スイッチは、スキーマエディタービューの右上にあります。
標準フィールドグループの表示名はシステムで生成されますが、の説明に従ってカスタマイズできます。 表示名 セクション。 表示名は、マッピングやデータセットのプレビューを含む、複数の UI 表示に反映されます。 デフォルト設定はオフで、フィールド名は元の値で表示されます。
スキーマへのフィールドグループの追加 add-field-groups
内でスキーマを開いたら Schema Editorの場合、フィールドグループを使用してスキーマにフィールドを追加できます。 開始するには、を選択します 追加 次の フィールドグループ 左パネルで。
ダイアログが表示され、スキーマに対して選択できるフィールドグループのリストが表示されます。 フィールドグループは 1 つのクラスにのみ適合するので、スキーマの選択されたクラスに関連付けられているフィールドグループのみが表示されます。 デフォルトでは、リストに表示されるフィールドグループは、組織内での使用率に基づいて並べ替えられます。
追加するフィールドの一般的なアクティビティまたはビジネス領域がわかっている場合は、左側のパネルで 1 つ以上の業種カテゴリを選択して、表示されるフィールドグループのリストをフィルタリングします。
また、検索バーを使用して、目的のフィールドグループを見つけることもできます。 クエリと名前が一致するフィールドグループがリストの上部に表示されます。 次の下 標準フィールド、目的のデータ属性を説明するフィールドを含むフィールドグループが表示されます。
スキーマに追加するフィールドグループ名の横にあるチェックボックスをオンにします。 リストから複数のフィールドグループを選択でき、選択した各フィールドグループが右側のパネルに表示されます。
フィールドグループを選択したら、 フィールドグループの追加 をクリックしてスキーマに追加します。
この Schema Editor キャンバスに表示される、フィールドグループで提供されたフィールドと共に再び表示されます。
フィールドグループをスキーマに追加した後、オプションで次の操作を実行できます 既存のフィールドを削除 または 新しいカスタムフィールドを追加 必要に応じて、これらのグループに追加します。
フィールドグループから追加されたフィールドを削除 remove-fields
フィールドグループをスキーマに追加した後、不要なフィールドを削除できます。
次の例では、標準フィールドグループです 人口統計の詳細 スキーマに追加されました。 単一のフィールド(例:)を削除するには taxId
をクリックし、キャンバスでフィールドを選択して、を選択します 削除 右側のパネルの
削除するフィールドが複数ある場合は、フィールドグループ全体を管理できます。 キャンバスでグループに属するフィールドを選択してから、を選択します 関連フィールドを管理 右側のパネルの
問題のフィールドグループの構造を示すダイアログが表示されます。 ここから、用意されているチェックボックスを使用して、必要なフィールドを選択または選択解除できます。 内容を確認して、 確認.
キャンバスが再び表示され、選択したフィールドのみがスキーマ構造に存在します。
フィールドグループへのカスタムフィールドの追加 add-fields
フィールドグループをスキーマに追加した後は、そのグループの追加フィールドを定義できます。 ただし、1 つのスキーマのフィールドグループに追加されたフィールドは、同じフィールドグループを使用する他のすべてのスキーマにも表示されます。
また、標準フィールドグループにカスタムフィールドが追加されると、そのフィールドグループはカスタムフィールドグループに変換され、元の標準フィールドグループは使用できなくなります。
標準フィールドグループにカスタムフィールドを追加する場合は、 下のセクション (具体的な説明について)。 カスタムフィールドグループにフィールドを追加する場合は、の節を参照してください。 カスタムフィールドグループの編集 フィールドグループ UI ガイドの「」。
既存のフィールドグループを変更しない場合は、次のことができます 新しいカスタムフィールドグループの作成 をクリックして、追加のフィールドを代わりに定義します。
スキーマへの個々のフィールドの追加 add-individual-fields
特定の使用例でフィールドグループ全体を追加したくない場合は、スキーマエディターを使用して、個々のフィールドをスキーマに直接追加できます。 次のことができます 標準フィールドグループからの個々のフィールドの追加 または 独自のカスタムフィールドを追加 その代わり。
標準フィールドを追加 add-standard-fields
標準フィールドグループからスキーマに直接フィールドを追加でき、対応するフィールドグループを事前に知る必要はありません。 標準フィールドをスキーマに追加するには、プラス(+) アイコンが、キャンバスでスキーマ名の隣に表示されます。 An 名称未設定フィールド プレースホルダーがスキーマ構造に表示されます。また、右側のパネルが更新されて、フィールドを設定するためのコントロールが表示されます。
次の下 フィールド名 追加するフィールドの名前の入力を開始します。 クエリに一致する標準フィールドが自動的に検索され、の下に一覧表示されます 推奨標準フィールド(所属するフィールドグループを含む)。
一部の標準フィールドは同じ名前を共有しますが、構造は元のフィールドグループによって異なる場合があります。 標準フィールドがフィールドグループ構造内の親オブジェクト内にネストされている場合、子フィールドが追加されると、親フィールドもスキーマに含まれます。
プレビューアイコン( )を選択し、標準フィールドの横に表示して、フィールドグループの構造を確認し、ネストの方法をより深く理解します。 標準フィールドをスキーマに追加するには、プラスアイコン( )に設定します。
キャンバスが更新され、スキーマに追加された標準フィールドが表示されます。これには、フィールドグループ構造内にネストされた親フィールドも含まれます。 フィールドグループの名前は、の下にもリストされます。 フィールドグループ 左パネルで。 同じフィールドグループからさらにフィールドを追加する場合は、 関連フィールドを管理 右側のパネルの
カスタムフィールドを追加 add-custom-fields
標準フィールドのワークフローと同様に、独自のカスタムフィールドをスキーマに直接追加することもできます。
スキーマのルートレベルにフィールドを追加するには、プラス(+) アイコンが、キャンバスでスキーマ名の隣に表示されます。 An 名称未設定フィールド プレースホルダーがスキーマ構造に表示されます。また、右側のパネルが更新されて、フィールドを設定するためのコントロールが表示されます。
追加するフィールドの名前の入力を開始すると、一致する標準フィールドの検索が自動的に開始されます。 代わりに新しいカスタムフィールドを作成するには、が付加された上部のオプションを選択します (新しいフィールド).
フィールドに表示名とデータタイプを指定したら、次にフィールドを親 XDM リソースに割り当てます。 スキーマでカスタムクラスを使用する場合は、次を選択できます 割り当てられたクラスにフィールドを追加 または フィールドグループ その代わり。 ただし、スキーマで標準クラスを使用している場合は、カスタムフィールドをフィールドグループに割り当てるだけです。
カスタムフィールドグループへのフィールドの割り当て add-to-field-group
次の下 割り当て先 を選択 フィールドグループ. スキーマで標準クラスを使用する場合、これが唯一の利用可能なオプションであり、デフォルトで選択されています。
次に、関連付ける新規フィールドのフィールドグループを選択する必要があります。 提供されたテキスト入力でフィールドグループの名前を入力し始めます。 入力と一致する既存のカスタムフィールドグループがある場合は、ドロップダウンリストに表示されます。 または、一意の名前を入力して、新しいフィールドグループを作成することもできます。
リストからフィールドグループを選択したら、次を選択します。 適用.
新しいフィールドがキャンバスに追加され、の下に名前空間が設定されます。 テナント ID 標準 XDM フィールドとの競合を避けるために使用します。 新しいフィールドを関連付けたフィールドグループも、の下に表示されます フィールドグループ 左パネルで。
フィールドをカスタムクラスに割り当てる add-to-class
次の下 割り当て先 を選択 クラス. の下の入力フィールドは、現在のスキーマのカスタムクラスの名前に置き換えられ、新しいフィールドがこのクラスに割り当てられることを示します。
必要に応じてフィールドの設定を続け、を選択します。 適用 終了したとき。
新しいフィールドがキャンバスに追加され、の下に名前空間が設定されます。 テナント ID 標準 XDM フィールドとの競合を避けるために使用します。 左側のパネルでクラス名を選択すると、クラスの構造の一部として新しいフィールドが表示されます。
標準フィールドグループの構造へのカスタムフィールドの追加 custom-fields-for-standard-groups
作業中のスキーマに、標準フィールドグループが提供するオブジェクトタイプのフィールドがある場合、独自のカスタムフィールドを標準オブジェクトに追加できます。
開始するには、プラス(+) アイコン(標準フィールドグループで提供されるオブジェクトのルートの隣)。
標準フィールドグループを変換するかどうかを確認する警告メッセージが表示されます。 を選択 フィールドグループの作成を続行 をクリックして続行します。
キャンバスが再び表示され、新しいフィールドには名称未設定のプレースホルダーが表示されます。 標準フィールドグループの名前には、「(拡張)」で始まり、元のバージョンから変更されたことを示します。 ここから、右側のパネルのコントロールを使用してフィールドのプロパティを定義します。
変更を適用すると、標準オブジェクト内のテナント ID 名前空間の下に新しいフィールドが表示されます。 このネストされた名前空間は、同じフィールドグループを使用する他のスキーマでの変更が壊れるのを防ぐために、フィールドグループ自体の中でのフィールド名の競合を防ぎます。
リアルタイム顧客プロファイルのスキーマの有効化 profile
リアルタイム顧客プロファイル 異なるソースのデータを結合して、個々の顧客の完全なビューを構築します。 スキーマで取得されたデータをこのプロセスに関与させる場合は、で使用できるようにスキーマを有効にする必要があります Profile.
スキーマを有効にするには、まず、左側のパネルでスキーマの名前を選択し、 Profile 右側のパネルで切り替えます。
ポップオーバーが表示され、スキーマを有効にして保存すると、無効にできないことを警告します。 を選択 Enable (有効) 続行します。
キャンバスが再表示され、 Profile 有効に切り替えます。
プロセスを完了するには、次を選択します 保存 スキーマを保存します。
これで、スキーマをリアルタイム顧客プロファイルで使用できるようになります。 Platform がこのスキーマに基づいてデータセットにデータを取り込むと、そのデータは統合されたプロファイルデータに組み込まれます。
スキーマフィールドの表示名の編集 display-names
クラスを割り当て、スキーマにフィールドグループを追加すると、フィールドが標準またはカスタムの XDM リソースによって提供されているかどうかに関係なく、スキーマのフィールドの表示名を編集できます。
スキーマフィールドの表示名を編集するには、キャンバスでフィールドを選択します。 右側のパネルで、の下に新しい名前を入力します 表示名.
を選択 適用 右側のパネルでキャンバスが更新され、フィールドの新しい表示名が表示されます。 を選択 保存 変更をスキーマに適用します。
スキーマのクラスの変更 change-class
スキーマが保存される前の初期作成プロセス中の任意の時点で、スキーマのクラスを変更できます。
クラスを再割り当てするには、を選択します。 割り当て キャンバスの左側にあります。
組織で定義されたものを含め、使用可能なすべてのクラスのリストを表示するダイアログが表示されます(所有者は「顧客``)と、Adobeで定義された標準クラス。
リストからクラスを選択して、ダイアログの右側に説明を表示します。 以下を選択することもできます。 クラス構造をプレビュー クラスに関連付けられているフィールドとメタデータを表示します。 を選択 クラスを割り当て 続行します。
新しいダイアログが開き、新しいクラスを割り当てることを確認するように求められます。 を選択 割り当て を確認します。
クラスの変更を確認すると、キャンバスがリセットされ、すべてのコンポジションの進行状況が失われます。
次の手順 next-steps
このドキュメントでは、Platform UI でのスキーマの作成と編集の基本について説明しました。 を確認することを強くお勧めします。 スキーマ作成のチュートリアル 一意のユースケースのカスタムフィールドグループとデータタイプの作成を含む、UI で完全なスキーマを作成するための包括的なワークフロー。
の機能について詳しくは、を参照してください スキーマ ワークスペース、を参照 スキーマ workspace の概要.
でスキーマを管理する方法を説明します Schema Registry API、 スキーマエンドポイントガイド.