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

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

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

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

先决条件 prerequisites

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

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

快速入门 getting-started

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

已突出显示Classes工作区Schemas和Classes的Schemas选项卡中的类数。

筛选类 filter

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

突出显示带有Classes和Schemas的Standard工作区的Custom选项卡。

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

创建新类 create

在Experience Platform UI中通过​ Create class ​或​ Create schema ​创建类的方法有两种。

创建类

从​ Create class ​工作区的Classes选项卡中选择Schemas。

突出显示了Classes的Schemas工作区的Create class选项卡

出现Create class对话框。 为类输入Display name和Description,然后使用单选按钮选择类的预期行为。 类可以是Record或Time-series类型。 选择​ Create ​以确认您的选择并返回到Classes选项卡。

与Create class的Create对话框突出显示。

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

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

创建架构

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

突出显示了Classes的Schemas工作区的Create schema选项卡

在出现的​ Manual ​对话框中选择Create a schema。

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

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

此时将显示架构创建工作流。 在Schema details部分中,选择​Other。 此时将显示可用类的列表。 选择 Create class

在Create schema部分中高亮显示具有Other的Schema details工作流。

出现Create class对话框。 为类输入Display name和Description,然后使用单选按钮选择类的预期行为。 类可以是Record或Time-series类型。 选择​ Create ​以确认您的选择并返回到Classes选项卡。

与Create class的Create对话框突出显示。

类列表将在Schema details部分中刷新,并且新创建的类将被自动选中。 选择​ Next ​以继续创建架构。

选择了新类并突出显示Schema details的Next节。

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

在文本字段中输入人性化的Schema display name。 接下来,输入适当的描述以帮助识别您的架构。 当您查看了架构结构并对设置感到满意时,请选择​ Finish ​以创建您的架构。

突出显示了Name and review、Create schema和Schema display name的Description工作流的Finish部分。

向类添加字段 add-fields

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

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

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

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

画布中显示​ Untitled Field ​占位符,右边栏更新以显示用于配置字段属性的控件。 在​ Assign to ​下,选择​Class

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

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

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

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

编辑类 edit-a-class

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

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

架构编辑器已突出显示现有类和Create a schema。

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

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

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

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

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

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

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

更改架构的类 schema

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

后续步骤 next-steps

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

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

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