在 UI 中创建和编辑类 ui-create-and-edit

在Adobe Experience Platform中,模式的类定义模式将包含的数据(记录或时间序列)的行为方面。 除此之外,类还描述了基于该类的所有架构所需包含的最少数量的公共属性,并提供了一种合并多个兼容数据集的方法。

Adobe提供了多个标准(“核心”)体验数据模型(XDM)类,包括XDM个人资料XDM ExperienceEvent。 除了这些核心类之外,您还可以创建自己的自定义类,以描述组织更具体的用例。

本文档概述了如何在Experience PlatformUI中创建、编辑和管理自定义类。

先决条件 prerequisites

本指南要求您对XDM系统有一定的了解。 请参阅XDM概述,了解XDM在Experience Platform生态系统中的作用以及架构组合的基础知识,了解类对XDM架构的贡献。

虽然本指南并非必需,但建议您也学习有关在UI中撰写架构的教程,以熟悉架构编辑器的各种功能。

快速入门 getting-started

在Platform UI中,从左侧导航中选择​ 架构 ​以打开架构工作区,然后选择​ ​选项卡。 此时将显示可用类的列表。

已突出显示架构工作区类和架构的类选项卡中的类的。

筛选类 filter

系统会根据类的创建方式自动筛选类列表。 默认设置显示由Adobe定义的类。 您还可以筛选列表以显示您的组织创建的那些列表。 选择单选按钮以在标准和自定义选项之间进行选择。 Standard选项显示由Adobe创建的实体,Custom选项显示组织内创建的实体。

已突出显示架构工作区的类选项卡,其中包含标准和自定义。

TIP
使用搜索功能根据类名筛选或查找类。 有关详细信息,请参阅浏览XDM资源指南。

创建新类 create

在Platform UI中创建类的方法有两种:通过​ 创建类 ​或​ 创建架构

创建类

从架构工作区的类选项卡中选择​ 创建类

带有创建类的架构工作区的类选项卡突出显示

出现创建类对话框。 为类输入显示名称和描述,并使用单选按钮选择类的预期行为。 类可以是记录或时间序列类型。 选择​ 创建 ​以确认您的选择并返回类选项卡。

与创建的创建类对话框突出显示。

您创建的类可用,并列在类视图中。

最近创建类突出显示的架构工作区的类选项卡。

创建架构

或者,您也可以通过手动创建架构来创建类。 从架构工作区的类选项卡中选择​ 创建架构

使用创建架构的架构工作区的类选项卡突出显示

在出现的创建架构对话框中选择​ 手动

NOTE
如果使用ML辅助模式创建工作流,则可以上传文件并使用ML算法生成推荐的模式。 在该架构创建工作流中,您不需要为架构指定基类。 要了解ML如何推荐基于csv文件的架构结构,请参阅机器学习辅助架构创建指南

使用工作流选项创建架构对话框并选择高亮显示。

此时将显示架构创建工作流。 在架构详细信息部分中,选择​ 其他。 此时将显示可用类的列表。 选择​ 创建类

在架构详细信息部分中突出显示使用其他创建架构工作流。

出现创建类对话框。 为类输入显示名称和描述,并使用单选按钮选择类的预期行为。 类可以是记录或时间序列类型。 选择​ 创建 ​以确认您的选择并返回类选项卡。

与创建的创建类对话框突出显示。

类列表将在架构详细信息部分中刷新,并且新创建的类将被自动选择。 选择​ 下一步 ​继续创建架构。

已选择新类并突出显示下一步的架构详细信息部分。

选择类后,将显示名称和审阅部分。 在此部分中,您会提供用于标识架构的名称和描述。​AEM架构的基本结构(由类提供)显示在画布中,供您查看和验证选定的类和架构结构。

在文本字段中输入人性化的架构显示名称。 接下来,输入适当的描述以帮助识别您的架构。 当您查看了架构结构并且满意您的设置时,请选择​ 完成 ​以创建您的架构。

高亮显示创建架构工作流的名称和审核部分,该工作流具有架构显示名称、描述和完成。

向类添加字段 add-fields

一旦您在架构编辑器中打开了一个采用自定义类的架构,您就可以开始向该类添加字段。 要添加新字段,请选择架构名称旁边的​ 加号(+) ​图标。

IMPORTANT
在构建实现由您的组织定义的类的架构时,请记住,架构字段组只能与兼容类一起使用。 由于您定义的类是新的,因此​ 添加字段组 ​对话框中列出的字段组不兼容。 相反,您需要创建新的字段组以便与该类一起使用。 下次编写实现新类的架构时,将列出您定义的字段组以供使用。

突出显示添加按钮的架构编辑器。

IMPORTANT
请记住,您添加到类的任何字段都将在使用该类的所有架构中使用。 因此,您应该仔细考虑哪些字段在所有架构用例中将很有用。 如果您考虑添加一个在此类下的某些架构中可能仅能使用的字段,您可能需要考虑通过创建字段组来将其添加到这些架构中。

画布中显示​ 无标题字段 ​占位符,右边栏更新以显示用于配置字段属性的控件。 在​ 分配给 ​下,选择​

架构编辑器画布中的无标题字段,选定并突出显示“分配给类”字段属性。

有关如何配置字段并将其添加到类的特定步骤,请参阅在UI中定义字段的指南。 继续向类添加所需数量的字段。 完成后,选择​ 保存 ​以保存架构和类。

架构编辑器的画布上新创建的架构,突出显示保存。

如果您之前已创建采用此类的架构,则新添加的字段将自动出现在这些架构中。

编辑类(#edit-a-class)

NOTE
只能完全编辑和自定义由您的组织定义的自定义类。 对于由Adobe定义的核心类,只能在单个架构的上下文中编辑其字段的显示名称。 有关详细信息,请参阅有关编辑架构字段的显示名称的部分。
保存自定义类并在数据摄取中使用后,只能对其执行附加更改。 有关详细信息,请参阅架构演变规则

您可以通过架构工作流编辑类,方法是:编辑扩展类的现有架构,或者手动创建架构。 无法直接编辑类。 从架构工作区的浏览选项卡中,选择现有类或​ 创建架构

已突出显示具有现有类和创建架构的架构编辑器。

如果选择创建新架构,请参阅创建架构一节以了解详细信息。 创建完架构(或选择现有架构后)后,将显示架构编辑器。 要更新现有类字段,请从架构结构中选择该字段。 字段的信息将显示在右边栏中。 确保分配给
已选择选项​ ,或者您的更新不会影响该类。

架构编辑器,其中选定字段并突出显示,右边栏显示,突出显示分配给。

对该字段进行任何所需的更改,在右边栏中向下滚动以选择​ 应用 ​以保存更改。

IMPORTANT
您对字段所做的任何更新都将应用于使用该类的所有架构,遵循架构演变规则

架构编辑器,已选定字段并公开右边栏,突出显示应用。

要添加新字段,请按照将字段添加到类指南。 完成后,选择​ 保存 ​以保存架构和类。

已突出显示保存的架构编辑器。

更改架构的类 schema

在保存架构之前,您可以在初始创建过程中随时更改架构的类。 但是,应谨慎执行此操作,因为字段组仅与某些类兼容。 更改类会重置画布和您已添加的任何字段。
有关详细信息,请参阅创建和编辑架构指南。

后续步骤 next-steps

本文档介绍了如何使用Platform UI创建和编辑类。 有关架构工作区的功能的更多信息,请参阅架构工作区概述

要了解如何使用架构注册表API管理类,请参阅类端点指南

recommendation-more-help
62e9ffd9-1c74-4cef-8f47-0d00af32fc07