使用 UI 创建和编辑数据类型 ui-create-and-edit

在Experience Data Model (XDM)中,数据类型是包含多个子字段的可重用字段。 虽然与架构字段组类似,因为它们允许一致地使用多字段结构,但数据类型更灵活,因为它们可以包含在架构结构中的任意位置,而字段组只能在根级别添加。

Adobe Experience Platform提供了许多标准数据类型,可用于涵盖各种常见的体验管理用例。 但是,您还可以定义自己的自定义数据类型,以满足独特的业务需求。

NOTE
如果字段被定义为特定数据类型,则无法在另一个架构中创建具有不同数据类型的相同字段。 此限制适用于您组织的租户。

本教程介绍了在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

NOTE
在启用了实时客户档案的架构中使用现有数据类型后,此后只能对该数据类型进行非破坏性更改。 有关详细信息,请参阅架构演变规则

只能编辑由您的组织定义的自定义数据类型。 选择​ 自定义 ​以仅显示您的组织拥有的自定义数据类型。

从列表中选择要编辑的数据类型以打开右边栏,显示数据类型的详细信息。 您还可以从详细信息面板下载样例文件、复制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管理数据类型,请参阅数据类型端点指南

recommendation-more-help
62e9ffd9-1c74-4cef-8f47-0d00af32fc07