UI でのスキーマの作成と編集

手動でのスキーマ作成

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

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

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

適切なクラスを決定できるように、各クラスには情報アイコンとプレビューアイコンがあります。 情報アイコン（ ）をクリックすると、関連付けられているクラスと業界の説明を提供するダイアログが開きます。

プレビューアイコン（ ）を選択すると、スキーマ図とそのプロパティを含むクラスのプレビューダイアログが開きます。

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

[ 使用可能なクラスのテーブルから選択したクラスと ] 次へ ​ がハイライト表示された ​ スキーマを作成

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

テキストフィールドに、人間にとってわかりやすい ​ スキーマ表示名 ​ を入力します。 次に、スキーマの識別に役立つ適切な説明を入力します。 スキーマ構造をレビューし、設定に満足したら、「完了」を選択してスキーマを作成します。

スキーマエディターが表示され、キャンバスにスキーマの構造が表示されます。 必要に応じて、 クラスへのフィールドの追加を開始できます。

既存のスキーマの編集

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

スキーマを選択すると、キャンバスにスキーマの構造が表示された Schema Editor が表示されます。 スキーマが使用している場合は、スキーマへの フィールドグループの追加または 個々のフィールドの追加これらのグループから）、 フィールド表示名の編集または 既存のカスタムフィールドグループの編集を実行できるようになりました。

その他のアクション

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

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

表示名の切替

スキーマエディターでは、便宜上、元のフィールド名と、より人間が読み取り可能な表示名との間で変更する切替スイッチを提供しています。 この柔軟性により、フィールドの検出性が向上し、スキーマを編集できます。切替スイッチは、スキーマエディタービューの右上にあります。

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

スキーマへのフィールドグループの追加

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

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

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

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

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

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

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

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

フィールドグループから追加されたフィールドを削除

フィールドグループをスキーマに追加した後、不要なフィールドを削除できます。

次の例では、標準フィールドグループ 人口統計の詳細 がスキーマに追加されています。 taxId などの 1 つのフィールドを削除するには、キャンバスでフィールドを選択し、右側のパネルで 削除 を選択します。

削除するフィールドが複数ある場合は、フィールドグループ全体を管理できます。 キャンバスでグループに属するフィールドを選択し、右側のパネルで 関連フィールドを管理 を選択します。

問題のフィールドグループの構造を示すダイアログが表示されます。 ここから、用意されているチェックボックスを使用して、必要なフィールドを選択または選択解除できます。 内容を確認して、「確認」を選択します。

キャンバスが再び表示され、選択したフィールドのみがスキーマ構造に存在します。

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

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

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

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

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

スキーマへの個々のフィールドの追加

特定の使用例でフィールドグループ全体を追加したくない場合は、スキーマエディターを使用して、個々のフィールドをスキーマに直接追加できます。 代わりに 標準フィールドグループから個々のフィールドを追加するまたは 独自のカスタムフィールドを追加することができます。

標準フィールドを追加

標準フィールドグループからスキーマに直接フィールドを追加でき、対応するフィールドグループを事前に知る必要はありません。 標準フィールドをスキーマに追加するには、キャンバスでスキーマ名の横にあるプラス（+）アイコンを選択します。 名称未設定フィールド プレースホルダーがスキーマ構造に表示されます。また、右側のパネルが更新されて、フィールドを設定するためのコントロールが表示されます。

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

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

標準フィールドの横にあるプレビューアイコン（ ）を選択すると、そのフィールドグループの構造が表示され、ネストの仕組みをより深く理解できます。 標準フィールドをスキーマに追加するには、プラスアイコン（ ）を選択します。

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

カスタムフィールドを追加

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

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

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

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

カスタムフィールドグループへのフィールドの割り当て

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

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

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

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

フィールドをカスタムクラスに割り当てる

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

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

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

標準フィールドグループの構造へのカスタムフィールドの追加

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

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

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

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

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

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

リアルタイム顧客プロファイルは、異なるソースのデータを結合して、個々の顧客の完全なビューを構築します。 スキーマで取得されたデータをこのプロセスに参加させる場合は、スキーマを Profile で使用できるようにする必要があります。

スキーマを有効にするには、まず、左側のパネルでスキーマの名前を選択し、次に、右側のパネルで プロファイル 切り替えスイッチを選択します。

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

​ プロファイル ​ 切り替えを有効にした状態でキャンバスが再び表示されます。

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

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