UI で列挙と推奨値を定義

最終更新日: 2023-11-14
  • トピック:
  • Schemas
    このトピックの詳細を表示
  • 作成対象:
  • Developer
    User
    Admin
    Leader

エクスペリエンスデータモデル (XDM) では、文字列フィールドに受け入れられる値または推奨される値の事前定義セットを指定して、そのフィールドに取り込まれる値やセグメント化での動作をより適切に制御できます。

Enums 文字列フィールドに取り込める値を事前定義済みのセットに制限します。 データを列挙フィールドに取り込もうとしたが、その値が設定で定義された値と一致しない場合、取り込みは拒否されます。

列挙とは異なり、 推奨値 「 」オプションを使用すると、取り込む値を制限しない文字列フィールドに対して、推奨値のセットを示すことができます。 代わりに、推奨値は、 セグメント化 UI 文字列フィールドを属性として含める場合。

条件 新しいフィールドの定義 (Adobe Experience Platformユーザーインターフェイス ) で、タイプをに設定します。 文字列に値を指定しない場合、 enum または 推奨値 そのフィールドに対して

UI の文字列フィールドに対して「列挙と推奨値」オプションが有効になっていることを示す画像

このドキュメントでは、 スキーマ UI ワークスペース。 UI での列挙の設定方法やその下流の効果など、列挙と推奨される値の概要については、次のビデオを参照してください。

列挙を定義

選択 列挙と推奨値​を選択し、「 Enums. 追加のコントロールが表示され、列挙の値の制約を指定できます。 制約を追加するには、「 」を選択します。 行を追加.

UI で選択された「列挙」オプションを示す画像

の下 」列には、フィールドを制限する正確な値を指定する必要があります。 オプションで、人間にやさしい 表示名 制約についても同様です。これは、セグメント化での値の表現方法に影響します。

引き続き 行を追加 目的の制約とオプションのラベルを列挙に追加するには、「 」アイコン (削除アイコンの画像) をクリックします。 終了したら、「 」を選択します。 適用 をクリックして、変更をスキーマに適用します。

UI の文字列フィールドに入力された列挙値と表示名を示す画像

キャンバスが更新され、変更が反映されます。 このスキーマを将来調査する際は、右側のパネル内の列挙フィールドの制約を表示および編集できます。

推奨値の定義

選択 列挙と推奨値​を選択し、「 推奨値 追加のコントロールを表示します。 ここからを選択します。 行を追加 をクリックして、推奨値の追加を開始します。

UI で「推奨値」オプションが選択されている画像

の下 表示名 列に、セグメント化 UI に表示する値のわかりやすい名前を指定します。 その他の推奨値を追加するには、「 行を追加 必要に応じて、この手順を繰り返します。 以前に追加した行を削除するには、 削除アイコン 問題の行の横に表示されます。

終了したら、「 」を選択します。 適用 をクリックして、変更をスキーマに適用します。

UI の文字列フィールドに入力された列挙値と表示名を示す画像

メモ

フィールドの更新された推奨値がセグメント化 UI に反映されるまでに、およそ 5 分の遅延があります。

標準フィールドの推奨値の管理

標準 XDM コンポーネントの一部のフィールドには、独自の推奨値 ( 例: eventType から XDM ExperienceEvent クラス. 標準フィールドの推奨値を追加で作成することはできますが、組織で定義されていない推奨値を変更または削除することはできません。 UI で標準フィールドを表示すると、推奨値は表示されますが、読み取り専用です。

UI の文字列フィールドに入力された列挙値と表示名を示す画像

標準フィールドに新しい推奨値を追加するには、「 行を追加. 組織で以前に追加された推奨値を削除するには、「 」を選択します 削除アイコン 問題の行の横に表示されます。

UI の文字列フィールドに入力された列挙値と表示名を示す画像

列挙と推奨値の変化ルール

列挙フィールドを持つスキーマを使用して、データを Platform に取り込んだ後、スキーマ定義に対してさらに変更を加える場合は、システムに既に存在するデータに従う必要があります。 一般に、既存のフィールドに加えた変更は、そのフィールドにのみ適用されます より小さい 制限的な フィールドは、既に存在するよりも制限を厳しくすることはできません。

列挙と推奨値に関しては、次のルールが取り込み後に適用されます。

  • あなた 可能 標準フィールドとカスタムフィールドに、既存の推奨値を持つ推奨値を追加します。
  • あなた 可能 既存の推奨値を持つカスタムフィールドから推奨値を削除します。
  • あなた 可能 既存のカスタム列挙フィールドに新しい enum 値を追加します。
  • あなた 可能 カスタムフィールドの enum 値を推奨値のみに切り替えるか、列挙値や推奨値のない文字列に変換します。 このスイッチは、適用後は元に戻すことができません。
  • あなた CANNOT 標準フィールドから列挙値または推奨値を削除します。
  • あなた CANNOT 既存の列挙を持たないフィールドに列挙値を追加します。
  • あなた CANNOT カスタムフィールドの既存の enum 値よりも少ない数の値を削除します。
  • あなた CANNOT 推奨値から列挙に切り替えます。

列挙と推奨値の結合ルール

複数のスキーマが同じ列挙フィールドを異なる設定で使用し、それらのスキーマが和集合に含まれる場合、列挙の違いの紐付け方法に関しては、特定のルールが適用されます。 正確なルールは、同じ標準フィールド ( eventType) または異なるフィールドグループ内の同じカスタムフィールドパスを参照している場合に、これらのパスを使用します。

同じ標準フィールドを参照する場合:

  • その他の推奨値は次のとおりです。 追加 組合内で
  • 同じ列挙キーの推奨値に対して行われた更新は次のとおりです 更新済み 組合内で

異なるフィールドグループで同じカスタムフィールドパスを参照する場合:

  • その他の推奨値は次のとおりです。 追加 組合内で
  • 複数のスキーマで同じ追加の推奨値が定義されている場合、それらの値は次のようになります。 マージ済み 組合内で つまり、マージ後に同じ推奨値が 2 回表示されることはありません。

検証の制限

現在のシステムの制限により、取り込み中に列挙がシステムによって検証されない場合は 2 つあります。

  1. 列挙は 配列フィールド.
  2. 列挙は、スキーマ階層内で複数のレベルで定義されています。

次の手順

このガイドでは、UI で文字列フィールドの列挙と推奨値を定義する方法について説明しました。 スキーマレジストリ API を使用した列挙と推奨値の管理方法について詳しくは、次を参照してください チュートリアル.

で他の XDM フィールドタイプを定義する方法を学ぶには Schema Editor詳しくは、 UI でのフィールドの定義.

このページ