使用Schema Editor创建架构
51黑料不打烊 Experience Platform用户界面允许您在称为Schema Editor的交互式可视画布中创建和管理Experience Data Model (XDM)架构。 本教程介绍如何使用Schema Editor创建架构。
出于演示目的，本教程中的步骤涉及创建一个描述客户忠诚度计划成员的示例架构。 虽然您可以使用这些步骤创建其他架构以满足您自己的目的，但建议您先创建示例架构并学习Schema Editor的功能。
快速入门
本教程需要对架构创建所涉及的51黑料不打烊 Experience Platform各个方面有一定的了解。 在开始本教程之前，请查看文档以了解以下概念：
- Experience Data Model (XDM)： Experience Platform用于组织客户体验数据的标准化框架。
- 架构组合的基础知识： XDM架构及其构建块的概述，包括类、架构字段组、数据类型和单个字段。
- Real-Time Customer Profile：根据来自多个源的汇总数据，提供统一的实时使用者个人资料。
打开架构工作区 browse
Experience Platform UI中的架构工作区提供了Schema Library的可视化图表，允许您查看管理组织可用的架构。 该工作区还包括Schema Editor，在本教程中，您可以在该画布上撰写架构。
登录Experience Platform后，在左侧导航中选择? 架构 ?以打开? 架构 ?工作区。 浏览 ?选项卡显示架构列表（Schema Library的表示形式），供您查看和自定义。 此列表包括架构所基于的名称、类型、类和行为（记录或时间序列），以及上次修改架构的日期和时间。
有关详细信息，请参阅在鲍滨中浏览现有齿顿惭资源的指南。
创建架构并为其命名 create
要开始撰写架构，请在? 架构 ?工作区的右上角选择? 创建架构。
出现创建架构对话框。 在此对话框中，您可以选择通过添加字段和字段组手动创建架构，也可以上传CSV文件并使用ML算法生成架构。 从对话框中选择架构创建工作流。
[Beta]{class="badge informative"}手动或ML辅助的架构创建 manual-or-assisted
要了解如何使用惭尝算法根据上传的文件推荐架构结构，请参阅机器学习辅助架构创建指南。 本UI指南重点介绍手动创建工作流。
选择基类 choose-a-class
出现创建架构工作流。 接下来，为架构选择一个基类。 您可以选择XDM Individual Profile和XDM ExperienceEvent的核心类，或者Other（如果这些类不适合您的用途）。 Other类选项允许您创建新类或从其他预先存在的类中进行选择。
有关这些类的详细信息，请参阅齿顿惭个人配置文件和XDM ExperienceEvent文档。 在本教程中，请选择? XDM Individual Profile，然后选择? 下一步。
命名并查看 name-and-review
选择类后，将显示名称和审阅部分。 在此部分中，您会提供用于标识架构的名称和描述。 在决定架构的名称时，需要考虑以下几个重要因素：
- 架构名称应简短且具有描述性，以便之后可以轻松找到架构。
- 架构名称必须是唯一的，这意味着它还应该足够具体，以便将来不会重复使用。 例如，如果贵组织为不同品牌制定了单独的忠诚度计划，则明智的做法是将您的架构命名为“品牌A忠诚度成员”，以便轻松区别于您稍后可能定义的其他忠诚度相关架构。
- 您还可以使用架构描述提供有关架构的任何其他上下文信息。
本教程包含一个架构以摄取与忠诚度计划成员相关的数据，因此该架构名为“Loyalty Members”。
架构?的基本结构（由类提供）显示在画布中，供您查看和验证选定的类和架构结构。
在文本字段中输入人性化的架构显示名称。 接下来，输入适当的描述以帮助识别您的架构。 当您查看了架构结构并且满意您的设置时，请选择? 完成 ?以创建您的架构。
编写架构 compose-your-schema
出现Schema Editor。 这是您将在其中构建架构的画布。 当您到达编辑器时，会在画布的? 结构 ?部分自动创建自标题架构，以及您选择的基类中包含的标准字段。 架构的分配类也在? 合成 ?部分的? 类 ?下列出。
添加字段组 field-group
您现在可以通过添加字段组开始向架构添加字段。 字段组是由一个或多个字段组成的组，这些字段通常一起用于描述特定概念。 本教程使用字段组描述忠诚度计划的成员并捕获关键信息，如姓名、生日、电话号码、地址等。
要添加字段组，请在? 字段组 ?子部分中选择? 添加。
此时将显示一个新对话框，其中显示了可用字段组的列表。 每个字段组仅用于特定类，因此该对话框仅列出与您选择的类（在本例中为XDM Individual Profile类）兼容的字段组。 如果您使用的是标准XDM类，则字段组的列表将根据使用流行程度智能排序。
您可以在左边栏中选择一个过滤器，以将标准字段组列表缩小到特定行业，如零售、金融服务和医疗保健。
从列表中选择字段组会导致该字段组显示在右边栏中。 如果需要，您可以选择多个字段组，并在确认之前将每个字段组添加到右边栏中的列表。 此外，当前选定的字段组的右侧会显示一个图标，允许您预览它提供的字段的结构。
预览字段组时，右边栏中提供该字段组架构的详细说明。 您还可以浏览提供的画布中的字段组字段。 当您选择不同的字段时，右边栏会更新，以显示有关所涉字段的详细信息。 完成预览后选择? 上一步 ?以返回字段组选择对话框。
在本教程中，选择? 人口统计详细信息 ?字段组，然后选择? 添加字段组。
此时将重新显示架构画布。 字段组 ?部分现在列出“人口统计详细信息”，而? 结构 ?部分包含字段组贡献的字段。 您可以在? 字段组 ?部分下选择字段组的名称，以突出显示它在画布中提供的特定字段。
此字段组在顶级名称person下分配多个具有数据类型的字段 "人员”。 这一组字段描述有关个人的信息，包括姓名、出生日期和性别。
请注意，name字段具有数据类型 of “全名”，表示它也描述了常见概念并包含与名称相关的子字段，如名字、姓氏、礼貌标题和后缀。
选择画布中的不同字段以显示它们为架构结构贡献的任何其他字段。
添加更多字段组 field-group-2
您现在可以重复相同的步骤来添加另一个字段组。 当您这次查看? 添加字段组 ?对话框时，请注意，“人口统计详细信息”字段组已灰显，并且无法选中它旁边的复选框。 这样可防止意外重复您已在当前架构中包含的字段组。
在本教程中，从列表中选择标准字段组? 个人联系人详细信息 ?和? 忠诚度详细信息，然后选择? 添加字段组 ?以将其添加到架构中。
画布将重新显示，其中在? 合成 ?部分的? 字段组 ?下列出的已添加字段组，并且其复合字段已添加到架构结构中。
定义自定义字段组 define-field-group
忠诚度成员架构用于捕获与忠诚度计划成员相关的数据，而您添加到该架构中的标准忠诚度详细信息字段组提供了其中的大多数数据，包括计划类型。 points, 加入日期等。
但是，在某些情况下，您可能希望包含标准字段组未涵盖的其他自定义字段，以便实现用例。 在添加自定义忠诚度字段的情况下，您有两个选项：
- 创建新的自定义字段组以捕获这些字段。 本教程将介绍此方法。
- 使用自定义字段扩展标准忠诚度详细信息字段组。 这会导致忠诚度详细信息转换为自定义字段组，原始标准字段组将不再可用。 有关将自定义字段添加到标准字段组的结构的更多信息，请参阅架构 UI指南。
要创建新字段组，请在? 字段组 ?子部分中选择? 添加（与以前类似），但这次在出现的对话框顶部附近选择? 新建字段组。 然后，系统会要求您提供新字段组的显示名称和描述。 在本教程中，将新的字段组命名为“Custom Loyalty Details”，然后选择? 添加字段组。
"Custom Loyalty Details"现在应显示在画布左侧的? 字段组 ?下，但尚未有与其关联的字段，因此? 结构 ?下未显示任何新字段。
将字段添加到字段组 field-group-fields
现在您已经创建了"Custom Loyalty Details"字段组，接下来该定义该字段组将参与到架构中的字段。
要开始，请选择画布中架构名称旁边的? 加号(+) ?图标。
画布中显示“无标题字段”占位符，右边栏更新以显示该字段的配置选项。
在此方案中，架构需要具有对象类型 field 该报表详细描述了人员当前的忠诚度级别。 使用右边栏中的控件，开始创建具有类型的loyaltyTier字段 "用于保存相关字段的对象。
在? 分配给 ?下，您必须选择要将该字段分配到的字段组。 请记住，所有架构字段都属于类或字段组，由于此架构使用标准类，因此您的唯一选项是选择字段组。 开始键入名称“Custom Loyalty Details”，然后从列表中选择字段组。
完成后，选择? 应用。
应用更改并显示新创建的loyaltyTier对象。 由于这是一个自定义字段，因此它会自动嵌套在您组织的租户ID命名空间中的对象中，前面加有下划线（本示例中为_tenantId）。
选择loyaltyTier对象旁边的? 加号(+) ?图标以开始添加子字段。 此时会出现一个新的字段占位符，字段属性 ?部分显示在画布的右侧。
每个字段都需要以下信息：
- 字段名称： ?字段的名称，最好用驼峰式大小写写。 不允许使用空格字符。 这是用于在代码和其他下游应用程序中引用字段的名称。
- 示例： loyaltyLevel
- 显示名称： ?字段的名称，用标题大小写表示。 这是查看或编辑架构时将在画布中显示的名称。
- 示例：忠诚度级别
- 类型： ?数据类型 of 字段。 这包括基本标量类型 and 任何数据类型 defined 在Schema Registry中。 示例： String、Integer、Boolean、Person、Address、电话号码等。
- 描述： ?字段的可选描述应包含最多200个字符。
loyaltyTier对象的第一个字段将是一个名为id的字符串，表示忠诚度会员当前层的ID。 由于该公司根据不同的因素为每个客户设置了不同的忠诚度级别阈值，因此每个忠诚度会员的层ID都是唯一的。 设置新字段的类型 to “字符串”和? 字段属性 ?部分会使用多个应用约束的选项进行填充，包括默认值、格式和最大长度。 请参阅有关数据验证字段最佳实践的文档以了解更多信息。
由于id将是一个随机生成的自由格式字符串，因此无需进一步约束。 选择? 应用 ?以应用更改。
向字段组添加更多字段 field-group-fields-2
现在您已经添加了id字段，接下来可以添加其他字段以获取忠诚度等级信息，例如：
- 当前点阈值（整数）：成员必须保持为保留在当前层中的最小忠诚度点数。
- 下一层点阈值（整数）：成员必须累计以毕业到下一层的忠诚度点数。
- 有效日期（日期时间）：忠诚度成员加入此层的日期。
要将每个字段添加到架构，请选择loyalty对象旁边的? 加号(+) ?图标并填写所需信息。
完成后，loyaltyTier对象将包含id、currentThreshold、nextThreshold和effectiveDate的字段。
向字段组添加一个枚举字段 enum
在Schema Editor中定义字段时，有一些其他选项可应用到基本字段类型 in 以便为该字段可以包含的数据提供进一步限制。 下表说明了这些限制的用例：
在本教程中，架构中的loyaltyTier对象需要一个描述层类的新枚举字段，其中值只能是四个可能选项之一。 要将此字段添加到架构，请选择loyaltyTier对象旁边的? 加号(+) ?图标，并填写? 字段名称 ?和? 显示名称 ?的必填字段。 对于? Type，请选择“厂迟谤颈苍驳”。
选择字段类型后，该字段会显示其他复选框，包括? 数组、枚举和建议值、标识 ?和? 关系 ?的复选框。
选中? 枚举和建议值 ?复选框，然后选择? 枚举。 您可以在此为每个可接受的忠诚度级别类输入? 值（在驼峰式大小写中）和? 显示名称（标题大写中为便于阅读器的可选名称）。
完成所有字段属性后，选择? 应用 ?以将tierClass字段添加到loyaltyTier对象。
将多字段对象转换为数据类型 datatype
loyaltyTier对象现在包含多个字段，并代表可能在其他架构中使用的通用数据结构。 Schema Editor允许您通过将可重用多字段对象的结构转换为数据类型来轻松应用这些对象。
数据类型允许一致地使用多字段结构，并且比字段组提供更大的灵活性，因为它们可以在架构内的任何位置使用。 这是通过将字段的? Type ?值设置为Schema Registry中定义的任何数据类型的值来完成的。
若要将loyaltyTier对象转换为数据类型，请在画布中选择loyaltyTier字段，然后在? 字段属性 ?下选择编辑器右侧的? 转换为新数据类型。
此时将显示通知，确认已成功转换对象。 在画布中，您现在可以看到loyaltyTier字段现在有一个链接图标，右边栏表示它的数据类型为“Loyalty Tier”。
在未来的架构中，您现在可以将字段分配为“Loyalty Tier”类型，它将自动包含ID、层类、点阈值和有效日期的字段。
搜索和筛选架构字段
除了其基类提供的字段外，您的架构现在还包含多个字段组。 使用较大的架构时，您可以选中左边栏中的字段组名称旁边的复选框，将显示的字段过滤为仅由您感兴趣的字段组提供的字段。
如果您在架构中查找特定字段，则还可以使用搜索栏按名称筛选显示的字段，而不管这些字段是在哪个字段组下提供的。
将架构字段设置为标识字段 identity-field
可利用架构提供的标准数据结构来识别跨多个源属于同一个人的数据，从而允许各种下游用例，例如分段、报表、数据科学分析等。 为了根据单个身份拼合数据，键字段必须在适用的架构中标记为身份字段。
Experience Platform可通过在Schema Editor中使用? 标识 ?复选框轻松表示标识字段。 但是，您必须根据数据的性质确定哪个字段是用作标识的最佳候选字段。
例如，可能有数千名忠诚度计划成员属于同一忠诚度级别，并且可能有几个成员共享同一实际地址。 但是，在这种情况下，在注册时，忠诚度计划的每个成员都会提供其个人电子邮件地址。 由于个人电子邮件地址通常由一人管理，因此字段personalEmail.address（由个人联系人详细信息字段组提供）是标识字段的好候选项。
identityMap字段来包含标识信息。在画布中选择personalEmail.address字段，并且? 字段属性 ?下会显示? 标识 ?复选框。 选中框和选项以将此项设置为? 主标识。 也选中此框。
接下来，必须从下拉列表中的预定义命名空间列表中提供? 身份命名空间。 由于此字段是客户的电子邮件地址，请从下拉列表中选择“电子邮件”。 选择? 应用 ?以确认personalEmail.address字段的更新。
应用更改后，personalEmail.address的图标将显示一个指纹符号，表示它现在是一个标识字段。 该字段还列在左边栏中的? 标识 ?下。
现在，摄取到personalEmail.address字段中的所有数据将用于帮助识别该个人并将该客户的单个视图拼接在一起。 要了解有关使用Experience Platform中的标识的更多信息，请查阅Identity Service文档。
启用架构以在Real-Time Customer Profile中使用 profile
Real-Time Customer Profile利用Experience Platform中的身份数据提供每个客户的整体视图。 该服务构建可靠的客户属性360°配置文件，以及客户在与Experience Platform集成的任何系统中进行的每次交互的时间戳记帐户。
为了使架构能够与Real-Time Customer Profile一起使用，它必须定义主标识。 如果您尝试在不首先定义主标识的情况下启用架构，则会收到一条错误消息。
要启用“忠诚会员”架构以在笔谤辞蹿颈濒别中使用，请先在画布中选择架构标题。
在编辑器的右侧，将显示有关架构的信息，包括其显示名称、描述和类型。 除此信息外，还有? 配置文件 ?切换按钮。
选择? 配置文件，此时会出现弹出窗口，要求您确认要为笔谤辞蹿颈濒别启用架构。
选择? 启用 ?以确认您的选择。 您可以再次选择? 配置文件 ?切换来禁用架构（如果需要），但一旦在启用笔谤辞蹿颈濒别的同时保存了架构，则不能再禁用该架构。
更多操作 more
在架构编辑器中，您还可以执行快速操作以复制架构的JSON结构或删除架构。 选择视图顶部的更多以显示包含快速操作的下拉列表。
删除架构 delete-a-schema
可以使用更多操作从UI中删除架构，也可以从浏览选项卡的架构详细信息中删除架构。 在某些情况下，无法删除架构。 如果符合以下条件，则无法删除架构：
- 已为配置文件启用架构。
- 架构已为配置文件启用，并具有关联的数据集。
- 架构具有关联的数据集，但未为配置文件启用。
复制 JSON 结构 copy-json-structure
选择? 复制闯厂翱狈结构 ?为架构库中的任何架构生成导出有效负载。 此操作会将JSON结构复制到剪贴板。 然后，您可以使用导出的JSON将架构和任何相关资源导入其他沙盒或组织。 这使得不同环境之间的架构共享和重用变得简单而高效。
后续步骤和其他资源
现在，您已完成架构的合成，您可以在画布中查看完整的架构。 选择? 保存，架构将保存到Schema Library中，以供Schema Registry访问。
您的新架构现在可用于将数据摄取到Experience Platform。 请记住，一旦使用架构来摄取数据，可能只进行额外的更改。 有关架构版本控制的详细信息，请参阅架构组合的基础知识。
您现在可以按照有关在鲍滨中定义架构关系的教程，向“忠诚度成员”架构中添加新的关系字段。
还可以使用Schema Registry API查看和管理“忠诚度成员”架构。 要开始使用API，请先阅读Schema Registry API 开发人员指南。
视频资源
以下视频说明如何在Experience Platform UI中创建简单架构。
以下视频旨在加深您对使用现场小组和课堂的理解。
附录
以下部分提供有关使用Schema Editor的附加信息。
创建新类 create-new-class
Experience Platform提供了灵活性，可以根据组织独有的类定义架构。 要了解如何创建新类，请参阅在鲍滨中创建和编辑类的指南。
更改架构的类 change-class
在保存架构之前，您可以在初始构成过程中随时更改架构的类。
要了解如何更改架构的类，请参阅鲍滨中管理架构的指南。