使用 UI 创建和编辑数据类型 ui-create-and-edit
在Experience Data Model (XDM)中,数据类型是包含多个子字段的可重用字段。 虽然与架构字段组类似,因为它们允许一致地使用多字段结构,但数据类型更灵活,因为它们可以包含在架构结构中的任意位置,而字段组只能在根级别添加。
Adobe Experience Platform提供了许多标准数据类型,可用于涵盖各种常见的体验管理用例。 但是,您还可以定义自己的自定义数据类型,以满足独特的业务需求。
本教程介绍了在Platform用户界面中创建和编辑自定义数据类型的步骤。
先决条件 prerequisites
本指南要求您对XDM系统有一定的了解。 请参阅XDM概述,了解XDM在Experience Platform生态系统中的角色简介,以及架构组合的基础知识,了解数据类型对XDM架构的贡献。
虽然本指南并非必需,但建议您也学习有关在UI中撰写架构的教程,以熟悉Schema Editor的各种功能。
为数据类型打开Schema Editor data-type
在Platform UI中,从左侧导航中选择 架构 以打开架构工作区,然后选择 数据类型 选项卡。 此时将显示可用数据类型的列表。 系统会根据数据类型的创建方式自动筛选数据类型列表。 默认设置显示由Adobe定义的数据类型。 您还可以筛选列表以显示您的组织创建的那些列表。
在此处,您可以选择以下选项:
创建新数据类型 create
从 数据类型 选项卡中,选择 创建数据类型。
此时将显示Schema Editor,显示画布中新数据类型的当前结构。 在编辑器的右侧,您可以为数据类型提供显示名称和可选描述。 请确保为数据类型提供唯一且简洁的名称,以将其添加到架构时采用的方式进行识别。
本教程将创建一个用于描述餐厅属性的数据类型,因此该数据类型的显示名称为“Restaurant”。
从此处,您可以跳到下一部分以开始向新数据类型添加字段。
筛选数据类型 filter
根据如何创建可用的数据类型预先过滤可用的数据类型的列表。选择单选按钮以在标准和自定义选项之间进行选择。 Standard选项显示由Adobe创建的实体,Custom选项显示组织内创建的实体。
编辑现有数据类型 edit
只能编辑由您的组织定义的自定义数据类型。 选择 自定义 以仅显示您的组织拥有的自定义数据类型。
从列表中选择要编辑的数据类型以打开右边栏,显示数据类型的详细信息。 您还可以从详细信息面板下载样例文件、复制JSON结构或将数据类型添加到包中。
在右边栏中选择数据类型的名称,以在Schema Editor中打开其结构。
向数据类型添加字段 add-fields
要开始向数据类型添加字段,请选择画布中根级别字段旁边的 加号(+) 图标。 下面将显示一个新字段,右边栏将更新以显示该新字段的控件。
使用右边栏中的控件配置新字段的详细信息。 有关如何配置字段并将其添加到数据类型的具体步骤,请参阅在UI中定义字段的指南。
Restaurant数据类型需要一个字符串字段来表示餐厅的名称。 因此,字段名称设置为“name”,类型设置为“String”。 选择 应用 以将更改应用到字段。
根据需要继续向数据类型添加更多字段。 示例Restaurant数据类型现在具有额外的品牌、座位容量和占地面积字段。
除了基本字段之外,您还可以将其他数据类型嵌套在自定义数据类型中。 例如,Restaurant数据类型需要一个表示资产的物理地址的字段。 在此方案中,您可以添加新的“地址”字段,该字段被分配了标准数据类型“邮政地址”。
这说明了数据类型在描述数据方面可以有多灵活:数据类型可以应用字段,这些字段也是数据类型,本身可以包含更多数据类型,等等。 这允许您在XDM架构中抽象和重用常见数据模式,使其更易于表示复杂的数据结构。
完成向数据类型添加字段后,选择 保存 以保存更改并将数据类型添加到Schema Library。
将数据类型添加到架构 add-data-type
创建数据类型后,即可开始在架构中使用它。 由于XDM架构由一个类以及零个或多个字段组组成,因此数据类型提供的字段无法直接添加到架构中。 相反,它们必须包含在类或字段组中。
首先执行将字段添加到类或将字段添加到字段组所涉及的步骤。 或者,您可以开始将字段直接添加到架构,然后从中选择父类或字段组。 为新字段选择 类型 时,请从下拉菜单中选择数据类型的名称。
将多字段对象转换为数据类型 convert
当您在Schema Editor中创建具有多个子字段的对象类型字段时,可以将该字段转换为数据类型,以便在不同的类或字段组中使用相同的字段结构。
要将对象类型字段转换为数据类型,请在画布中选择该字段。 在转换字段之前,请确保 显示名称 描述对象将包含的数据,因为这将成为数据类型的名称。 准备转换字段时,在右边栏中选择 转换为新数据类型。
画布将字段的数据类型从“对象”更新为新数据类型。 通过定义新字段时从 类型 下拉列表中选择此数据类型,此结构现在可以在其他类和字段组中重复使用。
后续步骤 next-steps
本指南介绍了如何使用Platform UI创建和编辑数据类型。 有关架构工作区的功能的更多信息,请参阅架构工作区概述。
要了解如何使用Schema Registry API管理数据类型,请参阅数据类型端点指南。