浏览UI中的架构资源
在Adobe Experience Platform中,所有Experience Data Model (XDM)架构资源都存储在Schema Library中,包括由Adobe提供的标准资源和由您的组织定义的自定义资源。 在Experience PlatformUI中,您可以查看Schema Library中任何现有架构、类、字段组或数据类型的结构和字段。 在规划和准备数据引入时,此功能特别有用,因为UI提供了有关这些XDM资源提供的每个字段的预期数据类型和用例的信息。
本教程介绍了在Experience PlatformUI中浏览现有架构、类、字段组和数据类型的步骤。
查找架构资源 lookup
在Platform UI的左侧导航中选择 架构。 架构工作区提供了 浏览 选项卡以浏览组织中的所有架构,还提供了额外的专用选项卡,分别用于浏览 类、字段组、数据类型 和 关系。
筛选器图标( )在左边栏中显示控件,以缩小列出的结果的范围。 资源筛选器分别可用于 浏览 和 关系 选项卡上的架构和关系。
在架构工作区的浏览选项卡上,您可以筛选架构清单。 使用 包含在配置文件 切换可仅显示已启用以便在实时客户配置文件中使用的架构。 使用 显示临时架构 切换开关筛选使用仅供单个数据集使用的命名空间字段创建的架构列表。
在架构工作区的关系选项卡上,您可以根据四个条件筛选关系列表。 这些筛选器包括Source架构、目标架构、Source类和目标类。 下表提供了这些过滤器的说明。
您还可以使用搜索栏进一步缩小结果的范围。
搜索结果中显示的资源首先按标题匹配项排序,然后按说明匹配项排序。 反过来,这两个类别中的匹配词越多,列表中显示的资源就越多。
找到要浏览的资源后,从列表中选择其名称,以在画布中查看其结构。
在画布中浏览XDM资源 explore
选择资源后,其结构将在画布中打开。
默认情况下,包含子属性的所有对象类型字段在首次出现在画布中时会折叠。 要显示任何字段的子属性,请选择其名称旁边的图标。
标准类和字段组指示器 standard-class-and-field-group-indicator
在架构编辑器中,标准(Adobe生成的)类和字段组以挂锁图标( 的问题。挂锁显示在左边栏中的类或字段组名称旁边,以及架构图中作为系统生成资源一部分的任意字段旁边。
有关指导,请参阅将自定义字段添加到标准字段组文档。 不能编辑标准类。
系统生成的字段 system-fields
某些字段名称的前面带有下划线,如_repo
和_id
。 这些表示系统将在摄取数据时自动生成和分配的字段的占位符。
因此,在摄取到Platform中时,应该从数据的结构中排除这些字段中的大多数。 此规则的主要例外是_{TENANT_ID}
字段,在您的组织下创建的所有XDM字段都必须在此字段下命名空间。
数据类型 data-types
对于画布中显示的每个字段,其对应的数据类型会显示在名称旁边,这概览field希望摄取的数据类型。
任何附加了方括号([]
)的数据类型均表示该特定数据类型的数组。 例如,String[] 的数据类型指示该字段需要字符串值的数组。 付款项[] 的数据类型表示符合付款项数据类型的对象数组。
如果数组字段基于对象类型,则可以在画布中选择其图标,以显示每个数组项的预期属性。
字段属性 field-properties
当您选择画布中任何字段的名称时,右边栏会更新,以在 字段属性 下显示有关该字段的详细信息。 这可以包括字段的预期用例、默认值、模式、格式、字段是否为必填等的描述。
如果您要检查的字段是枚举字段,则右边栏还会显示该字段预期接收的可接受值。
标识字段 identity
检查包含身份字段的架构时,这些字段在左边栏中列在提供给架构的类或字段组下。 选择左边栏中的身份字段名称以显示画布中的字段,无论其嵌套深度如何。
在画布中用指纹图标( )突出显示身份字段。 如果选择身份字段的名称,则可以查看其他信息,如身份命名空间,以及该字段是否为架构的主要身份。
关系字段 relationship
如果要检查包含关系字段的架构,则该字段将列在左边栏中的 关系 下。 选择左边栏中的关系字段名称以显示画布中的字段,无论其嵌套深度如何。 关系字段在画布中也以唯一方式高亮显示,显示字段链接到的引用架构的名称。 对于具有B2B功能的组织,可以编写自定义关系名称,并在这些情况下显示在画布上。
要查看引用架构的主要标识的标识命名空间,请选择关系字段,然后在字段属性侧边栏中 编辑关系。 关系的参数显示在显示的编辑关系对话框中。
有关在XDM架构中使用关系的详细信息,请参阅有关在UI中创建关系的教程。
后续步骤
本文档介绍了如何在Experience PlatformUI中探索现有XDM资源。 有关架构工作区和Schema Editor的不同功能的详细信息,请参阅架构工作区概述。