浏览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。
筛选器图标(
在Browse工作区的Schemas选项卡上,您可以筛选架构清单。 使用 Included in Profile 切换开关可仅显示已启用在实时客户个人资料中使用的架构。 使用 Show adhoc schemas 切换筛选创建的架构列表,这些架构的字段已命名为仅供单个数据集使用。
在Relationship工作区的Schemas选项卡上,您可以根据四个条件筛选关系列表。 这些筛选器包括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功能的组织,可以编写自定义关系名称,并在这些情况下显示在画布上。
要查看引用架构的主要标识的标识命名空间,请选择关系字段,然后在 Edit relationship 侧边栏中选择Field properties。 关系的参数显示在显示的Edit relationship对话框中。
有关在XDM架构中使用关系的详细信息,请参阅有关在UI中创建关系的教程。
后续步骤
本文档介绍了如何在Experience Platform UI中探索现有XDM资源。 有关Schemas工作区和Schema Editor的不同功能的详细信息,请参阅Schemas工作区概述。