エクスペリエンスデータモデル (XDM) では、文字列フィールドに受け入れられる値または推奨される値の事前定義セットを指定して、そのフィールドに取り込まれる値やセグメント化での動作をより適切に制御できます。
列挙 文字列フィールドに取り込める値を事前定義済みのセットに制限します。 データを列挙フィールドに取り込もうとしたが、その値が設定で定義された値と一致しない場合、取り込みは拒否されます。
列挙とは異なり、 推奨値 「 」オプションを使用すると、取り込む値を制限しない文字列フィールドの推奨値のセットを示すことができます。 代わりに、推奨値は、 セグメント化 UI 文字列フィールドを属性として含める場合。
条件 新しいフィールドの定義 (Adobe Experience Platformユーザーインターフェイス ) で、タイプをに設定します。 文字列に値を指定しない場合、 enum または 推奨値 そのフィールドの
このドキュメントでは、 スキーマ UI ワークスペース。 UI での列挙の設定方法やその下流の効果など、列挙と推奨される値の概要については、次のビデオを参照してください。
選択 列挙と推奨値を選択し、「 列挙. 追加のコントロールが表示され、列挙の値の制約を指定できます。 制約を追加するには、 行を追加.
以下 値 」列には、フィールドを制限する正確な値を指定する必要があります。 オプションで、人間にやさしい 表示名 制約についても同様です。これは、セグメント化での値の表現方法に影響します。
引き続き 行を追加 目的の制約とオプションのラベルを列挙に追加するには、「 」アイコン () をクリックします。 終了したら、「 」を選択します。 適用 をクリックして、変更をスキーマに適用します。
キャンバスが更新され、変更が反映されます。 このスキーマを将来調査する際は、右側のパネル内の列挙フィールドの制約を表示および編集できます。
選択 列挙と推奨値を選択し、「 推奨値 追加のコントロールを表示します。 ここからを選択します。 行を追加 をクリックして、推奨値の追加を開始します。
以下 表示名 列に、セグメント化 UI に表示する値のわかりやすい名前を指定します。 その他の推奨値を追加するには、「 行を追加 必要に応じて、この手順を繰り返します。 以前に追加した行を削除するには、 問題の行の横に表示されます。
終了したら、「 」を選択します。 適用 をクリックして、変更をスキーマに適用します。
フィールドの更新された推奨値がセグメント化 UI に反映されるまでに、およそ 5 分の遅延があります。
標準 XDM コンポーネントの一部のフィールドには、独自の推奨値 ( 例: eventType
から XDM ExperienceEvent クラス. 標準フィールドの推奨値を追加で作成することはできますが、組織で定義されていない推奨値を変更または削除することはできません。 UI で標準フィールドを表示すると、推奨値は表示されますが、読み取り専用です。
標準フィールドに新しい推奨値を追加するには、 行を追加. 組織で以前に追加された推奨値を削除するには、「 問題の行の横に表示されます。
列挙フィールドを持つスキーマを使用して、データを Platform に取り込んだ後、スキーマ定義に対してさらに変更を加える場合は、システムに既に存在するデータに従う必要があります。 一般に、既存のフィールドに加えた変更は、そのフィールドにのみ適用されます less 制限的な フィールドは、既に存在するよりも制限を厳しくすることはできません。
列挙と推奨値に関しては、次のルールが取り込み後に適用されます。
複数のスキーマが同じ列挙フィールドを異なる設定で使用し、それらのスキーマが和集合に含まれる場合、列挙の違いの紐付け方法に関しては、特定のルールが適用されます。 正確なルールは、同じ標準フィールド ( eventType
) または異なるフィールドグループ内の同じカスタムフィールドパスを参照している場合に、これらのパスを使用します。
同じ標準フィールドを参照する場合:
異なるフィールドグループで同じカスタムフィールドパスを参照する場合:
現在のシステムの制限により、取り込み中に列挙がシステムによって検証されない場合は 2 つあります。
このガイドでは、UI で文字列フィールドの列挙と推奨値を定義する方法について説明しました。 スキーマレジストリ API を使用した列挙と推奨値の管理方法について詳しくは、次を参照してください チュートリアル.
で他の XDM フィールドタイプを定義する方法を学ぶには Schema Editor詳しくは、 UI でのフィールドの定義.