在 UI 中定义枚举和建议值

在Experience Data Model (XDM)中，可以为字符串字段提供一组预定义的接受或建议值，以便更好地控制哪些值被引入到该字段中，或者如何在分段中表现。

枚举 将可为字符串字段摄取的值约束为预定义集。 如果您尝试将数据摄取到枚举字段，但值与其配置中定义的任何值都不匹配，则将拒绝摄取。

与枚举相反， 建议值 选项允许为字符串字段表示一组推荐值，这些值不会限制它可以摄取的值。 相反，建议值会影响中提供的预定义值 分段UI 将字符串字段作为属性包含时。

时间 定义新字段 在Adobe Experience Platform用户界面中，并将类型设置为 字符串，您可以选择定义 枚举 或 建议值 用于该字段。

本文档介绍如何在中定义枚举和建议值 架构 用户界面工作区。 要快速了解枚举和建议值（包括如何在UI中配置它们及其下游影响），请观看以下视频：

定义枚举

选择 枚举和建议值，然后选择 枚举. 将显示其他控件，允许您为枚举指定值约束。 要添加约束，请选择 添加行.

在 值 列中，必须提供要将字段约束到的确切值。 您可以选择提供人性化的 显示名称 约束，这也会影响分段中值的表示方式。

继续使用 添加行 将所需的约束和可选标签添加到枚举，或选择删除图标()以将其删除。 完成后，选择 应用 将更改应用到架构。

画布将更新以反映这些更改。 当您以后探索此架构时，可以查看和编辑右边栏中枚举字段的约束。

定义建议值

选择 枚举和建议值，然后选择 建议值 以显示其他控件。 从此处选择 添加行 以开始添加建议值。

在 显示名称 列中，为您希望在分段UI中显示的值提供人类友好的名称。 要添加更多建议值，请选择 添加行 再次尝试，并根据需要重复该过程。 要删除以前添加的行，请选择 相关行的旁边。

完成后，选择 应用 将更改应用到架构。

管理标准字段的建议值

标准XDM组件中的某些字段包含自己的建议值，例如 eventType 从 XDM ExperienceEvent 类. 虽然可以为标准字段创建其他建议值，但无法修改或删除任何未由组织定义的建议值。 在UI中查看标准字段时，其建议值会显示，但为只读。

要为标准字段添加新的建议值，请选择 添加行. 要删除贵组织之前添加的建议值，请选择 相关行的旁边。

枚举和建议值的演化规则

使用具有枚举字段的架构将数据摄取到Platform后，对架构定义所做的任何进一步更改都必须符合系统中已存在的数据。 通常，对现有字段进行的更改只能使该字段成为必填字段 更少 限制性。 不能使字段的限制比它已有的更严格。

对于枚举和建议值，以下规则适用于摄取后：

• 您 可以 为具有现有建议值的标准和自定义字段添加建议值。
• 您 可以 从具有现有建议值的自定义字段中移除建议值。
• 您 可以 为现有的自定义枚举字段添加新的枚举值。
• 您 可以 将自定义字段的枚举值仅切换为建议值，或将其转换为没有枚举或建议值的字符串。 此开关一经应用便无法撤消。
• 您 无法 从标准字段中移除枚举或建议值。
• 您 无法 向没有现有枚举的字段添加枚举值。
• 您 无法 删除自定义字段少于所有现有枚举值。
• 您 无法 从建议值切换到枚举。

枚举和建议值的合并规则

如果多个架构使用具有不同配置的同一枚举字段，并且这些架构包含在合并中，则在如何协调枚举差异时将会应用某些规则。 确切的规则取决于引用同一标准字段的架构(如 eventType)，或者如果它们在不同字段组中引用相同的自定义字段路径。

如果引用同一标准字段：

• 任何其他建议值包括 已附加 在联盟里。
• 对同一枚举键的建议值进行的更新如下 已更新 在联盟里。

如果在不同字段组中引用相同的自定义字段路径：

• 任何其他建议值包括 已附加 在联盟里。
• 如果在多个架构中定义了相同的附加建议值，则这些值为 已合并 在联盟里。 换句话说，相同的建议值在合并后不会显示两次。

验证限制

由于当前系统的限制，在两种情况下，系统会在引入期间不验证枚举：

1. 枚举定义在 数组字段.
2. 枚举在架构层次结构中的多个级别上定义。

后续步骤

本指南介绍了如何在UI中定义字符串字段的枚举和建议值。 有关如何使用架构注册表API管理枚举和建议值的信息，请参阅以下内容 教程.

了解如何在中定义其他XDM字段类型 Schema Editor，请参阅 在UI中定义字段.