在用户界面中定义XDM字段
此 Schema Editor 在Adobe Experience Platform用户界面中,您可以在自定义体验数据模型(XDM)类和架构字段组中定义自己的字段。 本指南介绍在UI中定义XDM字段的步骤,包括每种字段类型的可用配置选项。
先决条件
本指南要求您对XDM系统有一定的了解。 请参阅 XDM概述 介绍XDM在Experience Platform生态系统中的作用,以及 模式组合基础 了解类和字段组如何向XDM架构贡献字段。
虽然本指南并非必需,但建议您也按照以下内容阅读本教程: 在UI中组合架构 熟悉 Schema Editor.
选择要向其添加字段的资源 select-resource
要在UI中定义新的XDM字段,您必须首先在 Schema Editor. 根据您在以下位置当前可用的架构: Schema Library,您可以选择 创建新架构 或 选择要编辑的现有架构.
一旦拥有 Schema Editor 打开,画布中会显示用于添加字段的控件。 这些控件显示在架构的名称旁边,以及在所选类或字段组下定义的任何对象类型字段旁边。
要向资源添加新字段,请选择 加(+) 图标(位于画布中的架构名称旁边),或位于要定义其下的字段的对象类型字段旁边。
根据您是将字段直接添加到架构还是其组成类和字段组,添加字段所需的步骤会有所不同。 本文档的其余部分侧重于如何配置字段的属性,而不管该字段在架构中的显示位置如何。 有关可向架构添加字段的不同方式的更多信息,请参阅架构UI指南中的以下部分:
定义字段的属性 define
选择 加(+) 图标,一个 无标题的字段 占位符显示在画布中。
在右边栏中,在 字段属性,您可以配置新字段的详细信息。 每个字段都需要以下信息:
字段的唯一描述性名称。 请注意,保存架构后,无法更改字段名称。 此值用于标识和引用代码和其他下游应用程序中的字段
理想情况下,名称应以camelCase编写。 它可包含字母数字、短划线或下划线字符,但它 可能不会 从下划线开始。
- 正确:
fieldName
- 可接受:
field_name2
,Field-Name
,field-name_3
- 不正确:
_fieldName
要了解有关 特定类型的字段属性,请参阅定义字段概述。
您还可以选择为每个字段提供说明和注释。 使用 描述 字段,用于添加上下文并描述映射数据类型的功能。 这有助于提高实施的可维护性和可读性。 您还可以添加注释以补充初始描述。 这应该提供更细粒度和更具体的信息,以帮助开发人员在代码库的上下文中有效理解、维护和利用映射。 |
配置完字段后,选择 应用.
画布将更新以显示新添加的字段,该字段位于为您唯一租户ID命名的一个对象中(显示为 _tenantId
(如下例所示)。 添加到架构的所有自定义字段都会自动放置在此命名空间中,以防止与Adobe提供的类和字段组中的其他字段冲突。 现在,右边栏会列出字段的路径及其其他属性。
您可以继续按照上述步骤向架构添加更多字段。 保存架构后,如果对其进行了任何更改,也会保存其基类和字段组。
特定于类型的字段属性 type-specific-properties
定义新字段时,其他配置选项可能会显示在右边栏中,具体取决于 类型 为字段选择。 下表概述了这些附加字段属性及其兼容类型:
{width="100" modal="regular"}
注意:任何通过API创建的映射数据类型(不是String或Integer类型)将显示为'复杂'数据类型。 无法创建'复杂’数据类型。
默认值在摄取时不会保存在数据集中,因为它们可能会随着时间的推移而更改。 从数据集中读取数据时,下游平台服务和应用程序会推断架构中设置的默认值。 例如,在使用查询服务查询数据时,如果属性的值为NULL,但缺省值设置为
5
在架构级别,查询服务应返回 5
而不是NULL。 请注意,此行为当前在所有AEP服务中并不一致。从预定义的字符串格式列表中选取值必须符合的格式。 可用的格式包括:
特殊字段类型 special
右边栏提供了多个复选框,用于为所选字段指定特殊角色。 其中一些选项的用例涉及有关数据建模策略以及如何使用下游平台服务的重要注意事项。
要了解有关这些特殊类型的更多信息,请参阅以下文档:
虽然从技术上讲不是特殊字段类型,但还是建议您在以下位置访问指南: 定义对象类型字段 了解有关在架构结构中定义嵌套子字段的更多信息。
后续步骤
本指南概述了如何在UI中定义XDM字段。 请记住,字段只能通过使用类和字段组添加到架构中。 要详细了解如何在UI中管理这些资源,请参阅有关创建和编辑的指南 类 和 字段组.
欲知关于 架构 工作区,请参见 架构 工作区概述.