在体验数据模型(XDM)中,可以为字符串字段提供一组预定义的已接受或建议值,以更好地控制将哪些值摄取到该字段或该字段在分段中的行为。
枚举 将可为字符串字段摄取的值限制为预定义集。 如果您尝试将数据摄取到枚举字段,并且该值与其配置中定义的任何数据不匹配,则将拒绝摄取。
与枚举相比, 建议值 选项允许为字符串字段表示一组建议的值,这些值不会限制可摄取的值。 建议的值会影响 分段UI 将字符串字段作为属性包含在内时。
When 定义新字段 在Adobe Experience Platform用户界面中,并将类型设置为 字符串,则您可以选择定义 枚举 或 建议值 对于该字段。
本文档介绍如何在 模式 UI工作区。 有关枚举和建议值(包括如何在UI中配置它们及其下游效果)的快速概述,请观看以下视频:
选择 枚举和建议值,然后选择 枚举. 此时会显示其他控件,允许您指定枚举的值约束。 要添加约束,请选择 添加行.
在 值 列中,您必须提供要将字段限制为的确切值。 您可以选择提供人性化的 显示名称 ,这会影响值在分段中的显示方式。
继续使用 添加行 要向枚举添加所需的约束和可选标签,或选择删除图标()以将其删除。 完成后,选择 应用 以将更改应用到架构。
画布会更新以反映所做的更改。 将来浏览此架构时,您可以在右边栏中查看和编辑枚举字段的约束。
选择 枚举和建议值,然后选择 建议值 以显示其他控件。 从此处选择 添加行 以开始添加建议的值。
在 显示名称 列中,为您希望在分段UI中显示的值提供一个人类易记的名称。 要添加更多建议值,请选择 添加行 再次,并根据需要重复该过程。 要删除之前添加的行,请选择 排旁边。
完成后,选择 应用 以将更改应用到架构。
字段的更新建议值大约有五分钟的延迟,才能反映在分段UI中。
标准XDM组件中的某些字段包含它们自己的建议值,例如 eventType
从 XDM ExperienceEvent 类. 虽然您可以为标准字段创建其他建议值,但您无法修改或删除组织未定义的任何建议值。 在UI中查看标准字段时,其建议值虽然显示但为只读值。
要为标准字段添加新的建议值,请选择 添加行. 要删除您的组织之前添加的建议值,请选择 排旁边。
在使用具有枚举字段的架构将数据摄取到平台后,对架构定义所做的任何进一步更改都必须符合系统中已有的数据。 通常,对现有字段所做的更改只能使该字段 减少 限制。 字段的限制不能比现有字段更严格。
对于枚举和建议的值,以下规则会应用摄取后的规则:
如果多个架构使用具有不同配置的相同枚举字段,并且这些架构包含在并集中,则当涉及如何协调枚举差异时,某些规则将会应用。 具体规则取决于引用相同标准字段的架构(如 eventType
),或者他们引用不同字段组中的相同自定义字段路径。
如果引用相同的标准字段:
如果在不同的字段组中引用相同的自定义字段路径:
由于当前系统限制,在摄取期间系统未验证枚举的情况有两种:
本指南介绍了如何在UI中为字符串字段定义枚举和建议值。 有关如何使用架构注册表API管理枚举和建议值的信息,请参阅以下内容 教程.
了解如何在 Schema Editor,请参阅 在UI中定义字段.