浏览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的左边栏中选择架构。 架构工作区提供了 浏览 选项卡,您可以在其中查看组织中的所有架构。 您还可以使用类、字段组、数据类型和 关系 选项卡查看这些资源。
筛选和搜索架构 filter-search
使用 架构 工作区中的筛选和搜索工具来缩小架构列表并更快地找到特定资源。 筛选器图标(
架构元数据过滤器
按架构的基本特性和组织属性筛选架构。
架构属性过滤器
根据架构结构和身份配置缩小结果范围。
时间筛选器和创建者筛选器
根据创建模式和所有权筛选架构。
关系选项卡筛选器
在关系选项卡上查看架构关系时,请使用其他筛选器来浏览架构连接:
合并多个过滤器
组合筛选器以缩小架构列表并更快地找到特定资源。 例如,您可以找到具有上个月内创建的自定义标记的启用配置文件的标准架构,或找到使用电子邮件主标识并包含关系字段的临时架构。
应用的过滤器在清单标题行中显示为可移动芯片。 要删除筛选器,请选择其芯片上的×。 要一次删除所有活动的筛选器,请选择全部清除。
使用搜索栏进一步缩小结果的范围。
搜索结果根据资源标题和描述中的匹配项排名。 标题匹配项优先于描述匹配项,具有更多匹配项的资源显示在结果列表中的较高位置。
找到要浏览的资源后,从列表中选择其名称,以在画布中查看其结构。
浏览、组织和管理架构 browse-organize-manage-schemas
使用架构工作区查找、组织和管理架构。 您可以直接从清单视图中筛选架构清单、对元数据列排序和执行常见架构操作。
浏览和筛选元数据
架构清单在单个表视图中显示关键架构元数据。 您可以查看标记、架构类型、配置文件启用状态、创建日期、上次修改日期、类、身份、关系、行为和其他元数据,而无需打开单个架构。
要对库存进行排序,请选择列标题。 再次选择相同的列标题以反转排序顺序。
如果清单中包含的结果多于单个页面所能容纳的结果,请使用列表底部的页面控件在页面之间导航。
对架构执行内联操作
使用架构行的省略号菜单,直接从清单视图执行常见的架构操作。
库存视图和资源详细信息视图均提供操作。 某些操作仅适用于自定义(租户定义的)资源。 Adobe提供的标准资源可能具有有限的操作选项。
根据资源类型和权限,您可以编辑架构属性、应用数据管理标签、删除架构和管理标记,而无需打开架构。 其他操作包括将架构移动到文件夹、将架构添加到部署包、复制架构JSON和下载示例文件以进行测试。
有关每个操作的详细说明,请参阅架构操作指南。
使用标记和文件夹导航架构
使用标记和文件夹在清单中组织和查找架构。 标记可帮助您按项目、团队、数据域或您的组织定义的其他类别对架构进行分组。 文件夹提供了用于组织相关架构的层次结构。
要按标记筛选架构,请选择筛选器图标(
要按文件夹浏览架构,请选择显示文件夹图标(
标记和文件夹可与清单过滤系统配合使用,允许您根据架构的分配标记和文件夹位置来缩小架构列表。
有关在Experience Platform中创建和管理标记的信息,请参阅管理统一标记指南。
在画布中浏览XDM资源 explore
选择资源后,其结构将在画布中打开。
默认情况下,包含子属性的所有对象类型字段在首次出现在画布中时会折叠。 要显示任何字段的子属性,请选择其名称旁边的图标。
标准类和字段组指示器 standard-class-and-field-group-indicator
在架构编辑器中,标准类和字段组显示挂锁图标(
不能编辑标准类。 要扩展标准字段组,请参阅将自定义字段添加到标准字段组文档。
系统生成的字段 system-fields
某些字段名称的前面带有下划线,如_repo和_id。 这些表示系统将在摄取数据时自动生成和分配的字段的占位符。
因此,在摄取到Experience Platform时,应该从数据结构中排除这些字段中的大多数。 此规则的主要例外是_{TENANT_ID}字段,在您的组织下创建的所有XDM字段都必须在此字段下命名空间。
数据类型 data-types
对于画布中显示的每个字段,其对应的数据类型会显示在名称旁边,这概览field希望摄取的数据类型。
任何附加了方括号([])的数据类型均表示该特定数据类型的数组。 例如,String[]的数据类型指示该字段需要字符串值的数组。 付款项[]的数据类型表示符合付款项数据类型的对象数组。
如果数组字段基于对象类型,则可以在画布中选择其图标,以显示每个数组项的预期属性。
字段属性 field-properties
当您选择画布中任何字段的名称时,右边栏会更新,以在 字段属性 下显示有关该字段的详细信息。 这可以包括字段预期用例、默认值(摄取期间未应用的信息架构元数据)、模式、格式、字段是否为必填字段等的描述。 请参阅特定类型的字段属性,了解 默认值 与摄取验证设置有何不同。 浏览字段组时,所选字段的标签相关详细信息也会显示在此处;请参阅结构视图中的标签。
如果您要检查的字段是枚举字段,则右边栏还会显示该字段预期接收的可接受值。
身份标识字段 identity
检查包含身份字段的架构时,这些字段在左边栏中列在提供给架构的类或字段组下。 选择左边栏中的身份字段名称以显示画布中的字段,无论其嵌套深度如何。
在画布中用指纹图标(
关系字段 relationship
如果要检查包含关系字段的架构,则该字段将列在左边栏中的 关系 下。 选择左边栏中的关系字段名称以显示画布中的字段,无论其嵌套深度如何。 关系字段在画布中也以唯一方式高亮显示,显示字段链接到的引用架构的名称。 对于具有B2B功能的组织,可以编写自定义关系名称,并在这些情况下显示在画布上。
要查看引用架构的主要标识的标识命名空间,请选择关系字段,然后在字段属性侧边栏中编辑关系。 关系的参数显示在显示的编辑关系对话框中。
有关在XDM架构中使用关系的详细信息,请参阅有关在UI中创建关系的教程。
浏览字段组:使用情况和元数据 explore-field-groups
导航到架构 > 字段组以浏览字段组。 在 字段组 选项卡中,其他功能可帮助您了解字段组在架构中的使用位置及其包含的内容,例如兼容性、必填字段(强制执行引入要求)和治理信号。
这些功能可帮助您在进行更改之前评估影响,并在架构设计期间更有效地识别相关字段组。
查看字段组的架构用法 view-schema-usage-for-field-groups
从 字段组 表中,选择一个字段组以打开其详细信息视图。 画布将更新以显示字段组结构,而属性边栏会显示有关所选资源的其他信息。
使用此字段组的架构
在右侧属性边栏中,使用此字段组 的 架构列出了当前包含该字段组的架构。
- 如果字段组由三个或更少架构使用,则会显示所有架构名称。
- 如果它被三个以上的架构使用,则只显示一些名称,以及用于查看完整列表的选项。
选择架构名称以在新选项卡中打开其详细信息视图,并检查字段组在该架构中的实施方式。
查看更多和完整的架构列表
如果存在的架构多于可以内联显示的架构,请选择 查看更多 以打开完整的对话框。
此时将显示 使用此字段组 的架构对话框,其中显示了使用该字段组的架构的完整列表。
在使用此字段组 的 架构中,您可以:
- 浏览使用字段组的所有架构
- 浏览大型结果集
- 选择架构以在新选项卡中打开其详细信息视图
您可以查看架构详细信息,如架构名称、类和其他属性。
此工作流仅用于影响分析和探索。 它不会修改架构或字段组。 要更改架构结构,请参阅在UI中创建和编辑架构。
字段组元数据和筛选 field-group-metadata-and-filtering
字段组选项卡提供元数据和筛选工具,帮助您在选择字段组之前查找和评估这些字段组。
浏览表和过滤器
字段组清单表包括直接在列表视图中公开元数据的其他列,如兼容类,指示字段组可以应用于哪些类。 字段组只能根据它们代表的数据的行为(例如,基于记录的或时间序列数据),添加到使用列出的兼容类之一的架构中。 当字段组与所有类兼容时,表可能会显示全部。 行业标记帮助对要发现的字段组进行分类。
要优化列表,请选择过滤器图标(
在过滤器面板中,您可以:
- 兼容类 — 使用下拉菜单按类兼容性筛选字段组
- 行业标记 — 使用复选框按一个或多个行业类别进行筛选
浏览时,在表中选择一行以触发信息边栏。 信息边栏显示元数据,例如兼容的类和行业标记,因此无需打开字段组即可查看关键详细信息。
字段组详细信息元数据
打开字段组时,属性边栏显示与资源关联的其他元数据。
属性边栏可以显示以下元数据:
- 兼容类 — 字段组可以扩展的类
- 必需属性 — 数据摄取期间字段组需要时,必须具有有效值的属性。 要求取决于数据结构,具有缺少的或无效的必需值的记录无法验证
- 标签 — 标签未显示在字段组级别。 选择一个字段以在 字段属性 边栏中查看标签详细信息
此信息可帮助您了解在使用或修改字段组之前的限制和要求。
结构视图中的标签
当在画布中打开字段组时,您可以直接在结构中查看标签信息。 选择设置图标(
选择画布中的字段以查看 字段属性 边栏中的标签详细信息,包括应用于该字段的标签。
标签按类别(例如,身份和敏感标签)分组,可显示应用于数据的治理或与访问相关的限制。
这些指标仅用于可见性,不会更改架构结构。 有关详细信息,请参阅管理架构的数据使用标签。
后续步骤
使用以下资源继续使用XDM架构和相关Experience Platform功能:
- 若要了解有关 架构 工作区和 Schema Editor 的更多信息,请参阅架构工作区概述。
- 有关创建和管理标记的信息,请参阅管理统一标记指南。
- 有关清单视图、筛选、搜索和工作区导航模式的指导,请参阅数据集用户指南。
- 有关应用和管理数据管理标签的信息,请参阅数据使用标签用户指南。