Create and edit classes in the UI ui-create-and-edit

In Adobe Experience Platform, a schema’s class defines the behavioral aspects of the data that the schema will contain (record or time-series). In addition to this, classes describe the smallest number of common properties that all schemas based on that class would need to include and provide a way for multiple compatible datasets to be merged.

Adobe provides several standard (“core”) Experience Data Model (XDM) classes, including XDM Individual Profile and XDM ExperienceEvent. In addition to these core classes, you can also create your own custom classes to describe more specific use cases for your organization.

This document provides an overview of how to create, edit, and manage custom classes in the Experience Platform UI.

Prerequisites prerequisites

This guide requires a working understanding of XDM System. Refer to the XDM overview for an introduction to the role of XDM within the Experience Platform ecosystem, and the basics of schema composition to learn how classes contribute to XDM schemas.

While not required for this guide, it is recommended that you also follow the tutorial on composing a schema in the UI to familiarize yourself with the various capabilities of the Schema Editor.

Getting started getting-started

In the Platform UI, select Schemas in the left navigation to open the Schemas workspace, then select the Classes tab. A list of available classes are displayed.

Filter classes filter

The list of classes are automatically filtered based on how they were created. The default setting displays the classes defined by Adobe. You can also filter the list to show those created by your organization. Select the radio button to choose between the Standard and Custom options. The Standard option shows entities created by Adobe and the Custom option displays entities created within your organization.

Create a new class create

There are two methods to create a class in the Platform UI. From any tab in the Schemas workspace, select Create schema, or from the Classes tab select Create class.

If you select Create class, the Create class dialog appears. Enter a Display name and Description for your class and choose the intended behavior of your class with the radio buttons. Classes can be of the type, record series, or time series. Select Create to confirm your choices and return to the Classes tab.

The class you have created is available and listed in the Classes view.

Create or edit a class create-or-edit

Alternatively, if you choose to manually create a schema, you can create or edit an existing class as part of that workflow. Select Create schema followed by Manual in the Create a schema dialog that appears.

The schema creation workflow appears. In the Schema details section, select Other. A list of available classes appears. From here you can browse and filter pre-existing classes on which to base your new class.

Select a radio button to filter the classes based on whether they are custom or standard classes. You can also filter the available results based on their industry, or search for a specific class using the search field.

To help you decide on the appropriate class, there are info ( ) and preview ( ) icons for each class. The info icon opens a dialog that provides a description of the class and the industry that it is associated with. The preview icon opens a preview dialog for the class that contains a schema diagram and its properties.

Select any row to choose a class, then select Next to confirm your choice.

The Name and review section of the workflow appears. In this section, provide a name and description to identify your schema. ​The schema’s base structure (provided by the class) is shown in the canvas for you to review and verify your selected class and schema structure.

Enter a short, descriptive, unique, and user-friendly name for the class in the Schema display name text field. Next, enter a suitable description to identify the behavior of the data that the schema defines. When you have reviewed your schema structure and are happy with your settings, select Finish to create your schema.

The Schema Editor appears, with the schema’s structure shown in the canvas. You can now start adding fields to the class.

Add fields to a class add-fields

Once you have a schema that employs a custom class open in the Schema Editor, you can start adding fields to the class. To add a new field, select the plus (+) icon next to the schema’s name.

An Untitled Field placeholder appears in in the canvas, and the right rail updates to show controls to configure the field’s properties. Under Assign to, select Class.

See the guide on defining fields in the UI for specific steps on how to configure and add the field to the class. Continue to add as many fields as required to the class. When finished, select Save to save both the schema and the class.

If you have previously created schemas that employ this class, the newly added fields will automatically appear in those schemas.

Change the class of a schema schema

You can change the class of the schema at any point during the initial creation process before it has been saved. This should be done with caution however, as field groups are only compatible with certain classes. Changing the class resets the canvas and any fields you have added.
See the guide on creating and editing schemas for more information.

Next steps next-steps

This document covered how to create and edit classes using the Platform UI. For more information on the capabilities of the Schemas workspace, see the Schemas workspace overview.

To learn how to manage classes using the Schema Registry API, see the classes endpoint guide.