在 UI 中创建和编辑架构

本指南概述了如何在Adobe Experience Platform UI中为您的组织创建、编辑和管理Experience Data Model (XDM)架构。

IMPORTANT
XDM架构极具可自定义性,因此,创建架构所涉及的步骤可能会因您希望架构捕获的数据类型而异。 因此,本文档仅介绍您可以在UI中使用架构进行的基本交互,并排除自定义类、架构字段组、数据类型和字段等相关步骤。
要全面了解架构创建过程,请随同阅读 架构创建教程 以创建完整的示例架构并熟悉 Schema Editor.

先决条件 prerequisites

本指南要求您对XDM系统有一定的了解。 请参阅 XDM概述 介绍XDM在Experience Platform生态系统中的作用,以及 模式组合基础 有关如何构建架构的概述。

创建新架构 create

NOTE
本节介绍如何在UI中手动创建新架构。 如果您正在将CSV数据摄取到Platform,则可以选择 将该数据映射到由AI生成的推荐创建的XDM架构 (目前为测试版)无需自己手动创建架构。

在 架构 工作区,选择 创建架构 在右上角。

架构工作区具有 创建架构 突出显示。

此 创建架构 此时会出现工作流。 您可以通过选择以下任一选项来选择架构的基类 个人资料体验事件,或 其他,后接 下一个 确认您的选择。 请参阅 XDM个人资料XDM ExperienceEvent 文档,以了解有关这些类的详细信息。

此 创建架构 工作流包含三个类选项和 下一个 突出显示。

选择类后, 名称和审核 部分。 在此部分中,您会提供用于标识架构的名称和描述。​AEM架构的基本结构(由类提供)显示在画布中,供您查看和验证选定的类和架构结构。

输入人性化的 架构显示名称 在文本字段中。 接下来,输入适当的描述以帮助识别您的架构。 查看了架构结构并对设置感到满意后,选择 完成 以创建您的架构。

此 名称和审核 的部分 创建架构 使用的工作流 架构显示名称, 描述、和 完成 突出显示。

此 架构 浏览 选项卡。 您最近创建的架构现已列在架构库中,并可在以下位置进行编辑: Schema Editor.

“架构”工作区的“浏览”选项卡显示最近创建的架构。

编辑现有架构 edit

NOTE
一旦架构被保存并用于数据摄取,则只能对其执行额外的更改。 请参阅 模式演化规则 以了解更多信息。

要编辑现有架构,请选择 浏览 选项卡,然后选择要编辑的方案的名称。 您还可以使用搜索栏缩小可用选项列表的范围。

突出显示架构的架构工作区。

TIP
您可以使用工作区的搜索和筛选功能来帮助更轻松地查找架构。 请参阅指南,网址为 探索XDM资源 以了解更多信息。

选择架构后, Schema Editor 随画布中显示的架构结构一起显示。 您现在可以 添加字段组 到架构(或 添加单个字段 来自这些组), 编辑字段显示名称,或 编辑现有自定义字段组 如果架构使用任何。

更多操作 more

在架构编辑器中,您还可以执行快速操作以复制架构的JSON结构,或者删除架构(如果尚未为实时客户配置文件启用)或者具有关联的数据集。 选择 更多 ,以显示包含快速操作的下拉菜单。

复制JSON结构功能允许您查看在仍在构建架构和数据管道时样本有效负载的外观。 对于模式中存在复杂的对象映射结构(如标识映射)的情况,此变量特别有用。

架构编辑器中,突出显示了“更多”按钮,并显示了下拉选项。

显示名称切换 display-name-toggle

为方便起见,架构编辑器在原始字段名称和更易于用户识别的显示名称之间提供了切换开关。 这种灵活性可提高字段可发现性和架构的编辑。 此切换开关位于架构编辑器视图的右上角。

NOTE
从字段名称到显示名称的更改纯粹是修饰性的,不会更改任何下游资源。

架构编辑器 显示字段的显示名称 突出显示。

标准字段组的显示名称由系统生成,但可以自定义,如中所述 显示名称 部分。 显示名称会反映在多个UI视图中,包括映射和数据集预览。 默认设置为off,并按其原始值显示字段名。

将字段组添加到架构 add-field-groups

NOTE
本节介绍如何将现有字段组添加到架构。 如果要创建新的自定义字段组,请参阅上的指南 创建和编辑字段组 而是。

一旦您在 Schema Editor中,您可以使用字段组向架构中添加字段。 要开始,请选择 添加 旁边 字段组 在左边栏中。

具有的架构编辑器 添加 从 字段组 部分突出显示。

此时将显示一个对话框,其中显示了可为架构选择的字段组的列表。 由于字段组仅与一个类兼容,因此将仅列出与架构的选定类关联的字段组。 默认情况下,列出的字段组将根据其在您组织内的使用流行程度排序。

此 添加字段组 对话框上突出显示 热门程度 高亮显示的列。

如果您知道要添加字段的常规活动或业务领域,请在左边栏中选择一个或多个垂直行业的类别,以筛选显示的字段组列表。

此 添加字段组 对话框上突出显示 行业 筛选器和 行业 高亮显示的列。

NOTE
有关在XDM中进行行业特定数据建模的最佳实践的更多信息,请参阅 行业数据模型.

您还可以使用搜索栏帮助查找所需的字段组。 名称与查询匹配的字段组显示在列表顶部。 下 标准字段,将显示包含描述所需数据属性的字段的字段组。

此 添加字段组 与 标准字段 搜索功能突出显示。

选中要添加到架构的字段组名称旁边的复选框。 您可以从列表中选择多个字段组,每个选定的字段组都显示在右边栏中。

此 添加字段组 对话框,其中复选框选择功能突出显示。

TIP
对于任何列出的字段组,您可以将光标悬停在信息图标( ),以查看字段组捕获的数据类型的简短描述。 您还可以选择预览图标( ),以查看字段组提供的字段结构,然后您决定将其添加到架构。

选择字段组后,选择 添加字段组 以将其添加到架构中。

此 添加字段组 已选择字段组且 添加字段组 突出显示。

此 Schema Editor 此时会重新显示,画布中会显示字段组提供的字段。

此 Schema Editor 并显示模式示例。

NOTE
在架构编辑器中,标准(Adobe生成的)类和字段组用挂锁图标( 挂锁图标。 的问题。挂锁显示在左边栏中的类或字段组名称旁边,以及架构图中作为系统生成资源一部分的任意字段旁边。
突出显示挂锁图标的架构编辑器

将字段组添加到架构后,您可以选择执行以下操作 删除现有字段添加新自定义字段 根据您的需要,将这些用户组添加到。

移除从字段组添加的字段 remove-fields

将字段组添加到架构后,您可以删除任何不需要的字段。

NOTE
从字段组中删除字段仅影响正在处理的架构,不影响字段组本身。 如果删除一个架构中的字段,则这些字段在使用相同字段组的所有其他架构中仍然可用。

在以下示例中,标准字段组 人口统计详细信息 已添加到架构。 要删除单个字段,如 taxId,选择画布中的字段,然后选择 移除 在右边栏中。

此 Schema Editor 替换为 移除 突出显示。 此操作删除单个字段。

如果要删除多个字段,则可以整体管理字段组。 在画布中选择属于该组的字段,然后选择 管理相关字段 在右边栏中。

此 Schema Editor 替换为 管理相关字段 突出显示。

此时将显示一个对话框,其中显示了相关字段组的结构。 在此,您可以使用提供的复选框选择或取消选择所需的字段。 如果满意,请选择 确认.

此 管理相关字段 包含选定字段和的对话框 确认 突出显示。

画布会重新显示,架构结构中仅显示选定的字段。

已添加字段

将自定义字段添加到字段组 add-fields

将字段组添加到架构后,您可以为该组定义其他字段。 但是,在一个架构中添加到字段组的任何字段也将出现在使用该字段组的所有其他架构中。

此外,如果将自定义字段添加到标准字段组,则该字段组将转换为自定义字段组,并且原始标准字段组将不再可用。

如果要将自定义字段添加到标准字段组,请参阅 以下部分 以获取特定说明。 如果要将字段添加到自定义字段组,请参阅以下章节: 编辑自定义字段组 在字段组UI指南中。

如果不想更改任何现有的字段组,您可以 创建新的自定义字段组 以定义其他字段。

将单个字段添加到架构 add-individual-fields

如果要避免为特定用例添加整个字段组,可使用架构编辑器将单个字段直接添加到架构。 您可以 从标准字段组添加单个字段添加您自己的自定义字段 而是。

IMPORTANT
尽管架构编辑器在功能上允许您直接将单个字段添加到架构,但这不会更改XDM架构中的所有字段必须由其类或与该类兼容的字段组提供的事实。 如以下各节所述,作为添加到架构的关键步骤,所有单个字段仍与类或字段组关联。

添加标准字段 add-standard-fields

您可以将标准字段组中的字段直接添加到架构中,而无需预先知道其对应的字段组。 要将标准字段添加到架构,请选择加号(+)图标图标。 An 无标题的字段 架构结构和右边栏更新中显示占位符,以显示用于配置该字段的控件。

字段占位符

字段名称,开始键入要添加的字段的名称。 系统会自动搜索与查询匹配的标准字段,并在下面列出它们 推荐的标准字段,包括它们所属的字段组。

推荐的标准字段

虽然某些标准字段具有相同的名称,但它们的结构可能会因它们来自的字段组而异。 如果标准字段嵌套在字段组结构的父对象中,则添加子字段时,该父字段也将包含在架构中。

选择预览图标( “预览”图标 ),以查看其字段组的结构,并更好地了解其嵌套方式。 要将标准字段添加到架构,请选择加号图标( 加号图标 )。

添加标准字段

画布将更新以显示添加到架构的标准字段,包括嵌套在字段组结构下的任何父字段。 字段组的名称也会列在 字段组 在左边栏中。 如果要从同一字段组添加更多字段,请选择 管理相关字段 在右边栏中。

已添加标准字段

添加自定义字段 add-custom-fields

与标准字段的工作流类似,您还可以将自己的自定义字段直接添加到架构。

要将字段添加到架构的根级别,请选择加号(+)图标图标。 An 无标题的字段 架构结构和右边栏更新中显示占位符,以显示用于配置该字段的控件。

根自定义字段

开始键入要添加的字段的名称,系统会自动开始搜索匹配的标准字段。 要创建新的自定义字段,请选择附加了的顶部选项 (新建字段).

新建字段

在为该字段提供显示名称和数据类型后,下一步是将该字段分配给父XDM资源。 如果您的架构使用自定义类,则可以选择 将字段添加到分配的类字段组 而是。 但是,如果您的架构使用标准类,则只能将自定义字段分配给字段组。

将字段分配给自定义字段组 add-to-field-group

NOTE
本节仅介绍如何将字段分配给自定义字段组。 如果要改用新的自定义字段扩展标准字段组,请参阅 将自定义字段添加到标准字段组.

分配给,选择 字段组. 如果您的架构使用标准类,则这是唯一可用的选项,默认情况下处于选中状态。

接下来,必须为要关联的新字段选择字段组。 在提供的文本输入中开始键入字段组的名称。 如果您有任何与输入匹配的现有自定义字段组,则它们将显示在下拉列表中。 或者,您可以键入唯一名称来创建新的字段组。

选择字段组

WARNING
如果选择现有的自定义字段组,则采用该字段组的任何其他架构在保存更改后也将继承新添加的字段。 因此,如果您希望进行这种类型的传播,请仅选择现有的字段组。 否则,您应该选择创建新的自定义字段组。

从列表中选择字段组后,选择 应用.

应用字段

新字段将添加到画布中,并在 租户ID 以避免与标准XDM字段冲突。 与新字段关联的字段组也会显示在 字段组 在左边栏中。

租户 ID

NOTE
默认情况下,所选自定义字段组提供的其余字段将从架构中删除。 如果要将其中一些字段添加到架构,请选择属于该组的字段,然后选择 管理相关字段 在右边栏中。

将字段分配给自定义类 add-to-class

分配给,选择 . 下面的输入字段被替换成当前架构的自定义类的名称,这表示新字段将被分配给此类。

此 类 为新字段分配选择的选项。

继续根据需要配置字段并选择 应用 完成后。

应用 被选定为新字段。

新字段将添加到画布中,并在 租户ID 以避免与标准XDM字段冲突。 在左边栏中选择类名称会显示作为类结构一部分的新字段。

应用于自定义类结构的新字段,在画布中表示。

向标准字段组的结构中添加自定义字段 custom-fields-for-standard-groups

如果您正在处理的架构具有由标准字段组提供的对象类型字段,则可以将自己的自定义字段添加到该标准对象。

WARNING
在一个架构中添加到字段组的任何字段也将出现在使用该字段组的所有其他架构中。 此外,如果将自定义字段添加到标准字段组,则该字段组将转换为自定义字段组,并且原始标准字段组将不再可用。
如果您参加了此功能的Beta版,您将看到一个对话框,告知您之前自定义的标准字段组。 选择后 确认,则列出的资源将转换为自定义字段组。
用于转换标准字段组的确认对话框

要开始,请选择加号(+)图标,该图标位于标准字段组提供的对象的根目录旁边。

将字段添加到标准对象

出现警告消息,提示您确认是否要转换标准字段组。 选择 继续创建字段组 以继续。

确认字段组转换

画布会重新显示,新字段的占位符无标题。 请注意,标准字段组的名称已附加"(扩展)”以指示它已从原始版本修改。 从此处,使用右边栏中的控件来定义字段的属性。

添加到标准对象的字段

应用更改后,新字段将显示在标准对象内的租户ID命名空间下。 此嵌套命名空间可防止字段组自身内的字段名称冲突,以避免破坏使用同一字段组的其他架构中的更改。

添加到标准对象的字段

为实时客户配置文件启用架构 profile

Real-time Customer Profile 合并来自不同来源的数据,以构建每个客户的完整视图。 如果您希望架构捕获的数据参与此过程,则必须启用架构以便用于 Profile.

IMPORTANT
要为以下项启用架构: Profile,则必须定义主标识字段。 请参阅指南,网址为 定义标识字段 以了解更多信息。

要启用架构,请在左边栏中选择架构的名称,然后选择 个人资料 在右边栏中切换。

此时会出现一个弹出窗口,警告您一旦启用并保存架构,就无法禁用该架构。 选择 启用 以继续。

画布将重新出现,并且 个人资料 切换已启用。

IMPORTANT
由于架构尚未保存,如果您改变主意,让架构参与Real-time Customer Profile,则无法返回此值:保存启用的架构后,无法再禁用它。 选择 个人资料 再次切换可禁用架构。

要完成该过程,请选择 保存 以保存架构。

该架构现已启用以用于Real-time Customer Profile。 当Platform根据此架构将数据摄取到数据集时,该数据将合并到您的合并用户档案数据中。

编辑架构字段的显示名称 display-names

分配类并将字段组添加到架构后,可以编辑架构中任何字段的显示名称,无论这些字段是由标准资源还是自定义XDM资源提供。

NOTE
请记住,属于标准类或字段组的字段的显示名称只能在特定架构的上下文中编辑。 换句话说,在一个架构中更改标准字段的显示名称不会影响使用相同关联类或字段组的其他架构。
更改架构字段的显示名称后,这些更改将立即反映在基于该架构的任何现有数据集中。

要编辑架构字段的显示名称,请在画布中选择该字段。 在右边栏中,在下提供新名称 显示名称.

选择 应用 之后,画布会更新以显示字段的新显示名称。 选择 保存 将更改应用到架构。

更改架构的类 change-class

在保存架构之前,您可以在初始构成过程中随时更改架构的类。

WARNING
为架构重新分配类应极其谨慎。 字段组仅与某些类兼容,因此更改该类将重置画布和您已添加的所有字段。

要重新分配类,请选择 分配 在画布的左边。

此时将出现一个对话框,显示所有可用类的列表,包括您的组织定义的任何类(所有者为''客户以及Adobe定义的标准类。

从列表中选择一个类以在对话框的右侧显示其说明。 您还可以选择 预览类结构 查看与类关联的字段和元数据。 选择 分配类 以继续。

此时将打开一个新对话框,要求您确认是否分配一个新类。 选择 分配 以确认。

确认类更改后,画布将重置,并且所有合成进度都将丢失。

后续步骤 next-steps

本文档介绍了在Platform UI中创建和编辑架构的基础知识。 强烈建议您查阅 架构创建教程 用于在UI中构建完整模式的全面工作流程,包括为独特用例创建自定义字段组和数据类型。

欲知关于 架构 工作区,请参见 架构 工作区概述.

要了解如何在中管理架构,请参阅 Schema Registry API,请参见 架构端点指南.

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