浏览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的左侧导航中选择Schemas。 Schemas工作区提供了一个 Browse 选项卡来浏览您组织中的所有架构,以及额外的专用选项卡来分别浏览Classes、Field groups、Data types和Relationships。
筛选器图标(
在Schemas工作区的Browse选项卡上,您可以筛选架构清单。 使用 Included in Profile 切换开关可仅显示已启用在实时客户个人资料中使用的架构。 使用 Show adhoc schemas 切换筛选创建的架构列表,这些架构的字段已命名为仅供单个数据集使用。
在Schemas工作区的Relationship选项卡上,您可以根据四个条件筛选关系列表。 这些筛选器包括Source schema、Destination schema、Source class和Destination class。 下表提供了这些过滤器的说明。
您还可以使用搜索栏进一步缩小结果的范围。
搜索结果中显示的资源首先按标题匹配项排序,然后按说明匹配项排序。 反过来,这两个类别中的匹配词越多,列表中显示的资源就越多。
找到要浏览的资源后,从列表中选择其名称,以在画布中查看其结构。
管理架构、类、字段组和数据类型:操作和删除 xdm-resource-actions
当您需要管理或删除XDM资源,或者操作(例如删除)不可用并且需要了解原因时,可使用此部分。
在何处查找操作(内联与详细信息页面) where-to-find-actions
要执行删除、导出或复制资源等操作,请使用以下入口点之一:
在Browse、Classes、Field groups和 Data types 选项卡上,管理操作在两个位置可用:
- 在表中内联:每个资源行都包含一个操作菜单(例如,…),该菜单提供对可用操作的直接访问。
- 资源详细信息视图:要访问详细信息视图中的完整操作,必须选择 自定义(租户定义的) 资源。 标准(Adobe提供)资源的操作有限,不会显示“删除”、“复制JSON结构”或“添加到包”等选项。 从库存中选择自定义资源以打开其详细信息视图,然后使用页眉中的 More 菜单访问相同的可用操作。
对于支持的资源类型(架构、类、字段组和数据类型),这些操作在两个入口点之间是一致的。
可用操作 available-actions
根据资源类型和您的权限,以下操作可能可用:
以下内容适用于不同的资源类型:
-
对于 自定义(租户定义的) 架构、类、字段组和数据类型,上述所有操作可能都可用。
-
对于 标准(Adobe定义) 类、字段组和数据类型:
- 只有 Download sample file 可用。
- 删除、复制JSON结构和 添加到包 不可用。
删除行为 delete-behavior
当您想要删除不再需要的自定义资源时,请使用 Delete 操作。
要删除资源,请执行以下操作:
- 在表中找到资源或打开其详细信息视图。
- 选择操作菜单(…或More)。
- 选择 Delete。
- 再次选择 Delete 以确认对话框中的操作。
确认后,该资源将从您的组织中永久移除。
如果资源无法删除,则该选项显示为禁用,并带有工具提示来说明无法执行该操作的原因。
约束(数据集、配置文件、RBAC、租户与全局) delete-constraints
如果诸如 Delete 之类的操作不可用或已禁用,则通常是由于以下情况之一造成的:
-
权限(RBAC):您必须具有执行管理操作所需的权限(如Manage Schemas)。 如果缺少权限,则使用工具提示显示操作被禁用。 要了解如何配置权限,请参阅访问控制UI概述。
-
数据集关联:无法删除一个或多个数据集使用的资源(例如与数据集关联的架构)。 要识别和移除数据集依赖项,请参阅删除数据集。
-
配置文件启用:无法删除为实时客户配置文件启用的架构。 有关配置文件启用如何影响架构的指导,请参阅规划实时客户配置文件启用。
-
租户与全局资源:可以删除租户定义的(自定义)资源(受约束约束),但无法删除标准(Adobe提供的)类、字段组和数据类型。
这些约束直接反映在UI中。 当某个操作不可用时,它会显示为已禁用,并包含说明特定限制的工具提示。
如果无法删除资源,请查看上述条件以确定是否需要更新权限、删除依赖项或调整数据模型。
有关画布中的其他架构编辑工作流,请参阅在UI中创建和编辑架构。
在画布中浏览XDM资源 explore
选择资源后,其结构将在画布中打开。
默认情况下,包含子属性的所有对象类型字段在首次出现在画布中时会折叠。 要显示任何字段的子属性,请选择其名称旁边的图标。
标准类和字段组指示器 standard-class-and-field-group-indicator
在架构编辑器中,标准(Adobe生成的)类和字段组以挂锁图标(
有关指导,请参阅将自定义字段添加到标准字段组文档。 不能编辑标准类。
系统生成的字段 system-fields
某些字段名称的前面带有下划线,如_repo和_id。 这些表示系统将在摄取数据时自动生成和分配的字段的占位符。
因此,在摄取到Experience Platform时,应该从数据结构中排除这些字段中的大多数。 此规则的主要例外是_{TENANT_ID}字段,在您的组织下创建的所有XDM字段都必须在此字段下命名空间。
数据类型 data-types
对于画布中显示的每个字段,其对应的数据类型会显示在名称旁边,这概览field希望摄取的数据类型。
任何附加了方括号([])的数据类型均表示该特定数据类型的数组。 例如,String[]的数据类型表示该字段需要字符串值的数组。 Payment Item[]的数据类型表示符合Payment Item数据类型的对象数组。
如果数组字段基于对象类型,则可以在画布中选择其图标,以显示每个数组项的预期属性。
Field properties field-properties
当您选择画布中任何字段的名称时,右边栏会更新以在 Field properties 下显示有关该字段的详细信息。 这可以包括字段的预期用例、默认值、模式、格式、字段是否为必填等的描述。 浏览字段组时,所选字段的标签相关详细信息也会显示在此处;请参阅结构视图中的标签。
如果您要检查的字段是枚举字段,则右边栏还会显示该字段预期接收的可接受值。
身份标识字段 identity
检查包含身份字段的架构时,这些字段在左边栏中列在提供给架构的类或字段组下。 选择左边栏中的身份字段名称以显示画布中的字段,无论其嵌套深度如何。
在画布中用指纹图标(
关系字段 relationship
如果要检查包含关系字段的架构,则该字段将列在左边栏中的 Relationships 下。 选择左边栏中的关系字段名称以显示画布中的字段,无论其嵌套深度如何。 关系字段在画布中也以唯一方式高亮显示,显示字段链接到的引用架构的名称。 对于具有B2B功能的组织,可以编写自定义关系名称,并在这些情况下显示在画布上。
要查看引用架构的主要标识的标识命名空间,请选择关系字段,然后在Field properties侧边栏中选择Edit relationship。 关系的参数显示在显示的Edit relationship对话框中。
有关在XDM架构中使用关系的详细信息,请参阅有关在UI中创建关系的教程。
浏览字段组:使用情况和元数据 explore-field-groups
导航到Schemas > Field groups以浏览字段组。 在 Field groups 选项卡中,其他功能可帮助您了解字段组在架构中的使用位置及其包含的内容,例如兼容性、必填字段(强制执行引入要求)和治理信号。
这些功能可帮助您在进行更改之前评估影响,并在架构设计期间更有效地识别相关字段组。
查看字段组的架构用法 view-schema-usage-for-field-groups
从 Field groups 表中,选择一个字段组以打开其详细信息视图。 画布将更新以显示字段组结构,而属性边栏会显示有关所选资源的其他信息。
使用此字段组的架构
在右侧属性边栏中,Schemas using this field group部分列出了当前包含字段组的架构。
- 如果字段组由三个或更少架构使用,则会显示所有架构名称。
- 如果它被三个以上的架构使用,则只显示一些名称,以及用于查看完整列表的选项。
选择架构名称以在新选项卡中打开其详细信息视图,并检查字段组在该架构中的实施方式。
查看更多和完整的架构列表
如果存在比内联显示的模式更多的模式,请选择 View more 以打开完整的对话框。
此时将显示 Schemas using this field group 对话框,其中显示了使用该字段组的架构的完整列表。
在 Schemas using this field group 对话框中,您可以:
- 浏览使用字段组的所有架构
- 浏览大型结果集
- 选择架构以在新选项卡中打开其详细信息视图
您可以查看架构详细信息,如架构名称、类和其他属性。
此工作流仅用于影响分析和探索。 它不会修改架构或字段组。 要更改架构结构,请参阅在UI中创建和编辑架构。
字段组元数据和筛选 field-group-metadata-and-filtering
Field groups选项卡提供元数据和筛选工具,帮助您在选择字段组之前查找和评估字段组。
浏览表和过滤器
字段组清单表包括直接在列表视图中公开元数据的其他列,如Compatible classes,它指示字段组可以应用于哪些类。 字段组只能根据它们代表的数据的行为(例如,基于记录的或时间序列数据),添加到使用列出的兼容类之一的架构中。 当字段组与所有类兼容时,表可能会显示All。 Industry tags帮助对要发现的字段组进行分类。
要优化列表,请选择过滤器图标(
在过滤器面板中,您可以:
- Compatible classes — 使用下拉菜单按类兼容性筛选字段组
- Industry tags — 使用复选框按一个或多个行业类别进行筛选
浏览时,在表格中选择一行以更新信息边栏。 信息边栏显示元数据,例如兼容的类和行业标记,因此无需打开字段组即可查看关键详细信息。
字段组详细信息元数据
打开字段组时,属性边栏显示与资源关联的其他元数据。
属性边栏可以显示以下元数据:
- Compatible classes — 字段组可以扩展的类
- Required attributes — 当字段组在数据引入期间要求时,必须具有有效值的属性。 要求取决于数据结构,具有缺少的或无效的必需值的记录无法验证
- Labels — 标签未显示在字段组级别。 选择一个字段以在 Field properties 边栏中查看标签详细信息
此信息可帮助您了解在使用或修改字段组之前的限制和要求。
结构视图中的标签
当在画布中打开字段组时,您可以直接在结构中查看标签信息。 选择设置图标(
选择画布中的字段以查看 Field properties 边栏中的标签详细信息,包括应用于该字段的标签。
标签按类别(例如,身份和敏感标签)分组,可显示应用于数据的治理或与访问相关的限制。
这些指标仅用于可见性,不会更改架构结构。 有关详细信息,请参阅管理架构的数据使用标签。
后续步骤
本文档介绍了如何在Experience Platform UI中探索现有XDM资源。 有关Schemas工作区和Schema Editor的不同功能的详细信息,请参阅Schemas工作区概述。