浏览UI中的架构资源

在Adobe Experience Platform中,所有Experience Data Model (XDM)架构资源都存储在Schema Library中,包括由Adobe提供的标准资源和由您的组织定义的自定义资源。 在Experience Platform UI中,您可以查看Schema Library中任何现有架构、类、字段组或数据类型的结构和字段。 在规划和准备数据引入时,此功能特别有用,因为UI提供了有关这些XDM资源提供的每个字段的预期数据类型和用例的信息。

本指南介绍如何在Experience Platform UI中探索现有架构、类、字段组、数据类型和关系。

查找架构资源 lookup

在Experience Platform UI的左边栏中选择​架构。 架构工作区提供了​ 浏览 ​选项卡,您可以在其中查看组织中的所有架构。 您还可以使用​字段组数据类型​和​ 关系 ​选项卡查看这些资源。

突出显示带有多个选项卡的架构工作区。

使用​ 架构 ​工作区中的筛选和搜索工具来缩小架构列表并更快地找到特定资源。 筛选器图标( 筛选器图标 )将打开筛选器面板,您可以在其中使用元数据、身份、关系、日期和所有权条件筛选架构。 资源筛选器在​ 浏览 ​和​ 关系 ​选项卡上可用。

突出显示具有完整筛选器面板的架构工作区浏览选项卡。

架构元数据过滤器

按架构的基本特性和组织属性筛选架构。

过滤器
控件类型
描述
显示配置文件
单选按钮
显示全部、已启用或仅显示已禁用。 启用配置文件的架构参与了实时客户配置文件,并支持整个组织的统一客户视图。
架构类型
复选框
按架构源筛选:标准架构(由Adobe提供)、关系架构(结构化、关系数据建模功能)或临时架构(由单个数据集使用的命名空间字段)。
下拉列表
仅显示基于特定类基础构建的架构,例如XDM Individual Profile、XDM ExperienceEvent或您的组织定义的自定义类。
标记
下拉列表
按用户应用的用户定义的标记筛选架构。 选项包括具有任何标记和具有所有标记。 使用标记查找按项目、团队、业务域或支持您的组织架构管理实践的自定义分类组织的架构。

架构属性过滤器

根据架构结构和身份配置缩小结果范围。

过滤器
控件类型
描述
具有关系
是/否复选框
仅显示包含连接到其他架构的关系字段的架构。 关系字段支持跨不同架构的数据连接,并支持复杂的数据建模场景。
具有主标识
是/否复选框
筛选具有指定的主标识字段的架构。 主标识字段是启用用户档案所必需的,并且可用作客户数据统一的基础。
主身份命名空间
下拉列表
查找使用特定身份类型(如电子邮件、ECID、电话或自定义命名空间)作为主要标识符的架构。

时间筛选器和创建者筛选器

根据创建模式和所有权筛选架构。

过滤器
控件类型
描述
创建日期
开始和结束日期选取器
按创建日期范围筛选架构。 找到最近创建的架构或查找在特定项目阶段或时间段内构建的架构。
修改日期
开始和结束日期选取器
按修改日期范围筛选架构。 识别具有最新更新或更改的架构,以支持维护和治理工作流。
创建者
下拉列表
按其原始创建者筛选架构。 查找由特定团队成员、系统或服务帐户构建的架构以支持所有权跟踪和协作。

关系选项卡筛选器

在关系选项卡上查看架构关系时,请使用其他筛选器来浏览架构连接:

过滤器
控件类型
描述
Source架构
下拉列表
显示以所选架构为起点或“源”的关系。
目标架构
下拉列表
显示选定架构为目标或“目标”的关系。
Source类
下拉列表
根据启动模式的类过滤关系。
目标类
下拉列表
显示以特定类的架构结尾的关系。

突出显示筛选字段的架构工作区的“关系”选项卡。

合并多个过滤器

组合筛选器以缩小架构列表并更快地找到特定资源。 例如,您可以找到具有上个月内创建的自定义标记的启用配置文件的标准架构,或找到使用电子邮件主标识并包含关系字段的临时架构。

架构工作区中的增强型筛选器面板,显示同时应用的多个筛选器类型。

应用的过滤器在清单标题行中显示为可移动芯片。 要删除筛选器,请选择其芯片上的​×。 要一次删除所有活动的筛选器,请选择​全部清除

使用搜索栏进一步缩小结果的范围。

突出显示搜索字段的架构工作区的“浏览”选项卡。

搜索结果根据资源标题和描述中的匹配项排名。 标题匹配项优先于描述匹配项,具有更多匹配项的资源显示在结果列表中的较高位置。

找到要浏览的资源后,从列表中选择其名称,以在画布中查看其结构。

浏览、组织和管理架构 browse-organize-manage-schemas

使用架构工作区查找、组织和管理架构。 您可以直接从清单视图中筛选架构清单、对元数据列排序和执行常见架构操作。

浏览和筛选元数据

架构清单在单个表视图中显示关键架构元数据。 您可以查看标记、架构类型、配置文件启用状态、创建日期、上次修改日期、类、身份、关系、行为和其他元数据,而无需打开单个架构。

要对库存进行排序,请选择列标题。 再次选择相同的列标题以反转排序顺序。

如果清单中包含的结果多于单个页面所能容纳的结果,请使用列表底部的页面控件在页面之间导航。

显示标记、架构类型、配置文件启用、创建日期、上次修改时间、类、身份、关系和行为列的架构工作区架构清单。

对架构执行内联操作

使用架构行的省略号菜单,直接从清单视图执行常见的架构操作。

库存视图和资源详细信息视图均提供操作。 某些操作仅适用于自定义(租户定义的)资源。 Adobe提供的标准资源可能具有有限的操作选项。

架构行的省略号菜单显示内联操作,例如编辑、删除、应用标签和管理标签。

根据资源类型和权限,您可以编辑架构属性、应用数据管理标签、删除架构和管理标记,而无需打开架构。 其他操作包括将架构移动到文件夹、将架构添加到部署包、复制架构JSON和下载示例文件以进行测试。

NOTE
仅使用示例文件测试架构结构。 不包括生产数据。

有关每个操作的详细说明,请参阅架构操作指南

使用标记和文件夹导航架构

使用标记和文件夹在清单中组织和查找架构。 标记可帮助您按项目、团队、数据域或您的组织定义的其他类别对架构进行分组。 文件夹提供了用于组织相关架构的层次结构。

要按标记筛选架构,请选择筛选器图标( 筛选器图标 )以打开筛选器面板。 然后,从​ 具有任何标记 ​下拉列表中选择一个或多个标记。

按架构清单中的用户定义的标记筛选架构以查找特定架构。

要按文件夹浏览架构,请选择显示文件夹图标( 显示文件夹图标 )。 文件夹层次结构将显示在左边栏中。 选择一个文件夹以查看其关联的架构。

在左边栏中导航文件夹层次结构以浏览和查找架构。

标记和文件夹可与清单过滤系统配合使用,允许您根据架构的分配标记和文件夹位置来缩小架构列表。

有关在Experience Platform中创建和管理标记的信息,请参阅管理统一标记指南

在画布中浏览XDM资源 explore

选择资源后,其结构将在画布中打开。

显示Commerce数据类型的数据类型工作区画布。

默认情况下,包含子属性的所有对象类型字段在首次出现在画布中时会折叠。 要显示任何字段的子属性,请选择其名称旁边的图标。

已展开字段和子属性突出显示的数据类型工作区画布。

标准类和字段组指示器 standard-class-and-field-group-indicator

在架构编辑器中,标准类和字段组显示挂锁图标( 挂锁图标。 )。 图标可标识具有编辑限制的Adobe生成的资源。 它显示在左边栏中的类和字段组名称旁边,以及架构图中Adobe生成资源的字段旁边。

带有挂锁图标的架构编辑器突出显示

不能编辑标准类。 要扩展标准字段组,请参阅将自定义字段添加到标准字段组文档。

系统生成的字段 system-fields

某些字段名称的前面带有下划线,如_repo_id。 这些表示系统将在摄取数据时自动生成和分配的字段的占位符。

因此,在摄取到Experience Platform时,应该从数据结构中排除这些字段中的大多数。 此规则的主要例外是_{TENANT_ID}字段,在您的组织下创建的所有XDM字段都必须在此字段下命名空间。

数据类型 data-types

对于画布中显示的每个字段,其对应的数据类型会显示在名称旁边,这概览field希望摄取的数据类型。

画布上显示的“邮政地址”数据类型及其关联的数据类型突出显示。

任何附加了方括号([])的数据类型均表示该特定数据类型的数组。 例如,String[]​的数据类型指示该字段需要字符串值的数组。 付款项[]​的数据类型表示符合付款项数据类型的对象数组。

如果数组字段基于对象类型,则可以在画布中选择其图标,以显示每个数组项的预期属性。

画布中的对象,其数组字段突出显示,并显示每个数组项的预期属性。

字段属性 field-properties

当您选择画布中任何字段的名称时,右边栏会更新,以在​ 字段属性 ​下显示有关该字段的详细信息。 这可以包括字段预期用例、默认值(摄取期间未应用的信息架构元数据)、模式、格式、字段是否为必填字段等的描述。 请参阅特定类型的字段属性,了解​ 默认值 ​与摄取验证设置有何不同。 浏览字段组时,所选字段的标签相关详细信息也会显示在此处;请参阅结构视图中的标签

从Commerce数据类型中选择的字段具有突出显示的字段属性。

如果您要检查的字段是枚举字段,则右边栏还会显示该字段预期接收的可接受值。

架构编辑器,在字段属性边栏中选择了字段,并且枚举值和显示名称高亮显示。

身份标识字段 identity

检查包含身份字段的架构时,这些字段在左边栏中列在提供给架构的类或字段组下。 选择左边栏中的身份字段名称以显示画布中的字段,无论其嵌套深度如何。

在画布中用指纹图标( 指纹图标图像 )突出显示身份字段。 如果选择身份字段的名称,则可以查看其他信息,如身份命名空间,以及该字段是否为架构的主要身份。

架构编辑器在左边栏中突出显示了架构的标识,在架构图表中突出显示了字段,在字段属性中突出显示了标识命名空间。

NOTE
有关标识字段及其与下游Experience Platform服务的关系的详细信息,请参阅定义标识字段指南。

关系字段 relationship

如果要检查包含关系字段的架构,则该字段将列在左边栏中的​ 关系 ​下。 选择左边栏中的关系字段名称以显示画布中的字段,无论其嵌套深度如何。 关系字段在画布中也以唯一方式高亮显示,显示字段链接到的引用架构的名称。 对于具有B2B功能的组织,可以编写自定义关系名称,并在这些情况下显示在画布上。

架构编辑器突出显示了关系字段和编辑关系。

要查看引用架构的主要标识的标识命名空间,请选择关系字段,然后在字段属性侧边栏中​编辑关系。 关系的参数显示在显示的编辑关系对话框中。

显示具有关系参数的“编辑关系”对话框。

有关在XDM架构中使用关系的详细信息,请参阅有关在UI中创建关系的教程。

浏览字段组:使用情况和元数据 explore-field-groups

导航到​架构 > 字段组​以浏览字段组。 在​ 字段组 ​选项卡中,其他功能可帮助您了解字段组在架构中的使用位置及其包含的内容,例如兼容性、必填字段(强制执行引入要求)和治理信号。

这些功能可帮助您在进行更改之前评估影响,并在架构设计期间更有效地识别相关字段组。

查看字段组的架构用法 view-schema-usage-for-field-groups

从​ 字段组 ​表中,选择一个字段组以打开其详细信息视图。 画布将更新以显示字段组结构,而属性边栏会显示有关所选资源的其他信息。

使用此字段组的架构

在右侧属性边栏中,使用此字段组​ ​架构列出了当前包含该字段组的架构。

字段组属性边栏显示使用此字段组部分的架构。

  • 如果字段组由三个或更少架构使用,则会显示所有架构名称。
  • 如果它被三个以上的架构使用,则只显示一些名称,以及用于查看完整列表的选项。

选择架构名称以在新选项卡中打开其详细信息视图,并检查字段组在该架构中的实施方式。

查看更多和完整的架构列表

如果存在的架构多于可以内联显示的架构,请选择​ 查看更多 ​以打开完整的对话框。

使用此字段组的架构中的“查看更多”选项。

此时将显示​ 使用此字段组 ​的架构对话框,其中显示了使用该字段组的架构的完整列表。

使用此字段组的架构对话框显示架构列表和列。

在使用此字段组​ ​架构中,您可以:

  • 浏览使用字段组的所有架构
  • 浏览大型结果集
  • 选择架构以在新选项卡中打开其详细信息视图

您可以查看架构详细信息,如架构名称、类和其他属性。

此工作流仅用于​影响分析和探索。 它不会修改架构或字段组。 要更改架构结构,请参阅在UI中创建和编辑架构

字段组元数据和筛选 field-group-metadata-and-filtering

字段组​选项卡提供元数据和筛选工具,帮助您在选择字段组之前查找和评估这些字段组。

浏览表和过滤器

字段组清单表包括直接在列表视图中公开元数据的其他列,如​兼容类,指示字段组可以应用于哪些类。 字段组只能根据它们代表的数据的行为(例如,基于记录的或时间序列数据),添加到使用列出的兼容类之一的架构中。 当字段组与所有类兼容时,表可能会显示​全部行业标记​帮助对要发现的字段组进行分类。

要优化列表,请选择过滤器图标( 过滤器图标图像 )以打开左边栏中的过滤器面板。 下图显示了在左边栏中打开的过滤器面板。

显示兼容类、行业标签和过滤器面板的“字段组”选项卡。

在过滤器面板中,您可以:

  • 兼容类 — 使用下拉菜单按类兼容性筛选字段组
  • 行业标记 — 使用复选框按一个或多个行业类别进行筛选

浏览时,在表中选择一行以触发信息边栏。 信息边栏显示元数据,例如兼容的类和行业标记,因此无需打开字段组即可查看关键详细信息。

字段组详细信息元数据

打开字段组时,属性边栏显示与资源关联的其他元数据。

属性边栏可以显示以下元数据:

  • 兼容类 — 字段组可以扩展的类
  • 必需属性 — 数据摄取期间字段组需要时,必须具有有效值的属性。 要求取决于数据结构,具有缺少的或无效的必需值的记录无法验证
  • 标签 — 标签未显示在字段组级别。 选择一个字段以在​ 字段属性 ​边栏中查看标签详细信息

此信息可帮助您了解在使用或修改字段组之前的限制和要求。

结构视图中的标签

当在画布中打开字段组时,您可以直接在结构中查看标签信息。 选择设置图标( 设置图标。 ) 在画布工具栏中启用​ 在树上显示标签 ​以在画布中的字段上显示标签指示符。

显示树显示选项对话框的字段组画布突出显示“在树上显示标签”。

选择画布中的字段以查看​ 字段属性 ​边栏中的标签详细信息,包括应用于该字段的标签。

字段组画布在字段属性边栏中显示字段标签和标签详细信息。

标签按类别(例如,身份和敏感标签)分组,可显示应用于数据的治理或与访问相关的限制。

这些指标仅用于可见性,不会更改架构结构。 有关详细信息,请参阅管理架构的数据使用标签

后续步骤

使用以下资源继续使用XDM架构和相关Experience Platform功能:

recommendation-more-help
experience-platform-help-xdm