在UI中定义枚举和建议值

在体验数据模型(XDM)中,可以为字符串字段提供一组预定义的已接受或建议值,以更好地控制将哪些值摄取到该字段或该字段在分段中的行为。

枚举 将可为字符串字段摄取的值限制为预定义集。 如果您尝试将数据摄取到枚举字段,并且该值与其配置中定义的任何数据不匹配,则将拒绝摄取。

与枚举相比, 建议值 选项允许为字符串字段表示一组建议的值,这些值不会限制可摄取的值。 建议的值会影响 分段UI 将字符串字段作为属性包含在内时。

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

该图像显示了在UI中为字符串字段启用的枚举和建议值选项

本文档介绍如何在 模式 UI工作区。 有关枚举和建议值(包括如何在UI中配置它们及其下游效果)的快速概述,请观看以下视频:

定义枚举

选择 枚举和建议值,然后选择 枚举. 此时会显示其他控件,允许您指定枚举的值约束。 要添加约束,请选择 添加行.

显示在UI中选择的枚举选项的图像

列中,您必须提供要将字段限制为的确切值。 您可以选择提供人性化的 显示名称 ,这会影响值在分段中的显示方式。

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

显示UI中字符串字段的枚举值和显示名称的图像

画布会更新以反映所做的更改。 将来浏览此架构时,您可以在右边栏中查看和编辑枚举字段的约束。

定义建议的值

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

显示在UI中选择的建议值选项的图像

显示名称 列中,为您希望在分段UI中显示的值提供一个人类易记的名称。 要添加更多建议值,请选择 添加行 再次,并根据需要重复该过程。 要删除之前添加的行,请选择 删除图标 排旁边。

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

显示UI中字符串字段的枚举值和显示名称的图像

注意

字段的更新建议值大约有五分钟的延迟,才能反映在分段UI中。

管理标准字段的建议值

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

显示UI中字符串字段的枚举值和显示名称的图像

要为标准字段添加新的建议值,请选择 添加行. 要删除您的组织之前添加的建议值,请选择 删除图标 排旁边。

显示UI中字符串字段的枚举值和显示名称的图像

枚举和建议值的演化规则

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

对于枚举和建议的值,以下规则会应用摄取后的规则:

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

合并枚举和建议值的规则

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

如果引用相同的标准字段:

  • 任何其他建议的值包括 已附加 在工会中。
  • 对同一枚举键值的建议值进行了更新,包括 已更新 在工会中。

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

  • 任何其他建议的值包括 已附加 在工会中。
  • 如果在多个架构中定义了相同的其他建议值,则这些值为 合并 在工会中。 换言之,相同的建议值在合并后不会显示两次。

验证限制

由于当前系统限制,在摄取期间系统未验证枚举的情况有两种:

  1. 枚举是在 阵列字段.
  2. 枚举在架构层次结构中定义了多个级别。

后续步骤

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

了解如何在 Schema Editor,请参阅 在UI中定义字段.

在此页面上