Define Configuration Schema
- Last UpdatedFeb 21, 2025
- 6 minute read
To define a configuration schema, ensure that you have the Creator privilege and have the Standard locked for editing:
-
In Content Discovery sidebar, select Manage Schema. Then, right-click Configuration Schema and click Add Configuration Schema.

-
Enter the identifier, name and description, and click Create.

-
The details of the new configuration schema are available on the Details tab.

Note: When a Configuration Schema is created, Configuration, which is the default extension point, is created. You may delete it, if required, by clicking the cross (X) sign. Or, you can change its name and use it. However, you will not be able to change its ID.
-
Click Extension Point+ to create an extension point.
-
Enter the identifier, name and description, and click Create.

The newly created tab (of the extension point) contains only the capability to add a section.

-
Click the downward arrow to view the properties.

-
In the Applicable Class Library Concepts & Entities section, click Add to select the concepts to which the extension point applies. Configuration Schema defines extension properties for Class Library definitions. These properties manage the behaviour of the schema when applied to the Class Library definitions. Configuration Schema is used on these Class Library Concepts, such as Classes, Permissible Attributes or Naming Templates. If you do not select a Class Library Concept, the extension point is applied to the Class Library root folder.

-
Click Add after selecting the required concept from the dropdown. You may continue to add more. Alternatively, click Add and Close to close the window.

-
In the General Properties section, select the Derivable check box if you wish the properties to be inherited by the child items of the selected Class Library Concepts.
-
Set the Sort Order. When you use the extension point as a separate tab, the value for this field defines the order in which the tabs appear.
-
Enter an Aspect if you have an enumerated list associated with the Configuration Schema.
-
Click Section+ to create a section.

-
Enter the identifier, name and description, and click Create.

-
Click the downward arrow to expand Section properties. Go to the Layout Characteristics section. These settings control how the extension properties appear in Class Library Concepts.

-
Then, click +Group to create a group. Enter the identifier, name and description, and click Create. Alternatively, click the downward arrow in the new section to view properties.

-
View and edit the group settings in the Edit Group Settings window.
-
In the Repetitions section, enter the number of occurrences in the Min Occurs and Max Occurs fields, respectively.

-
Select the Render as Table check box if you wish to render the Group in the tabular format.
-
Enter Page Size.
-
Enter the required Layout Characteristics. Then, click Save.
-
Click +Property to create a property for the group.

-
Enter the identifier, name and description, and click Create.

-
View and edit the property settings in the Edit Property Settings window.

-
In the Property Characteristics section tab, go to the Value Characteristics section. Select the required Data Type from the dropdown.
-
Enter the Size for the Data Type. For example, if you select Data Type as String, enter the acceptable number of characters in Size.
-
Provide Default Value. When the user does not enter any value, the application inserts this as the default value.
-
Provide the lower and upper limits for the value in the Min Value and Max Value, respectively.
-
Select the Value Required check box if it is mandatory for the user to input a value.
-
Select the Unique Value check box if the value must be unique.
-
Select the Multi-Value check box if you have provided a range of values, and given the lower and upper limits in the Min Value and Max Value fields, respectively.
-
Enter the character that acts as a separator for the values in the Values Delimiter field. This value is mandatory if you select the Multi-Value check box.
-
Adjust Layout Characteristics. These settings will help display the extension on your Class Library Concepts.
-
Select the Render in New Row check box if you wish the property to appear as a new row.
-
Enter the value for the Span Columns and Span Rows fields, respectively, for the row width and height. If you leave the fields blank, the application selects the default row width and height.
-
Select the Group Title Suffix. Enter a name for grouping in the Entity Property Name field. These values are used for validation and referencing.
-
In the General Properties section, select the Derivable check box if you wish the properties to be inherited by the child items of the selected Class Library Concepts.
-
Set the Sort Order. When you use the extension point as a separate tab, the value for this field defines the order in which the tabs appear.
-
Enter an Aspect if you have an enumerated list associated with the Configuration Schema. Then, click Save.
-
Switch to the Valid Values tab. Click the Add (
) button.
-
If you wish to define a specific set of properties in the Add a Property Valid Value window, enter the identifier, name and description, and click Create.

-
Observe the values appear on the Valid Values tab. Repeat steps 21 through 40 if you need to add more properties and their values.

-
Click Save after you have added the required values.
-
Optionally, to reorder the list of properties, click the drag handles (
). You may also click the Show Preview (
) button to test the user experience.