Skip to main content
Version: On prem: 15.0.2

Data objects

A Data object type is a template for data objects with certain common characteristics. All data objects of a specific type will share combined properties and general attributes specified by the data object type. You can view data objects in the Tree structure and in the Data object types view.

note

In Omada Identity, all data objects are located in the same global tree structure. For more information, refer to the Tree structure section in the documentation.

Data object types can be used for different purposes and processes, if relevant. For example, a folder in the system is a data object type called Folder, and it is used every time a new folder is created.

All processes created in are based on a data object type. Normally, you create a new data object type for each new process. As you will most often need a new data object type for each new process, the data object type can be created when you create your process template. It is, however, also possible to create it in advance.

The Data object types view is available under Setup > Administration > Process configuration.

Data object type classes

There are two classes of data object type:

  • System data object types - A data object type which is predefined in the system. System data object types are universally used, such as in Activities, Users, Folders, and so on. They are identified in the Data object types view by their ID numbers which values are always less than 100.

  • User-defined data object types - A data object type created by a user, as opposed to the system. They are identified in the Data object types view by their ID numbers which values are equal or superior to 100.

Data object types as targets

Data object types that play the role of target of a process will contain all the properties required to collect information or present information during a process.

Data object types are used as workflow targets, which means that they collect data during the execution of an instance of a process, part of which will be used to update or change master data.

Create Data object types

Follow these steps to create new data object type:

  1. Go to the Data object types view.

  2. Click New.

    • Enter singular and plural forms of the data object type in the Name field.

    • State the purpose of the data object type in the Description field.

    • Leave the System name blank to use the system generated name.

  3. Click Apply. Some default values will be automatically filled in. Enable the Properties button.

  4. Click the Properties button to choose the properties for your data object type (or create new ones).

Advanced fields

Once you have followed the basic creation steps, here are the remaining fields and their functions:

FieldDescription
Display name formatClick to open the Display name format builder dialog box and define a display name from the available properties.

The value selected for the Display name format determines what will be displayed in the Tree structure and in views. By default, the data object type name is displayed. Only the properties added to the data object type are available.
Default location for data objectsYou can leave the recommended path for the data object or select a different one in the tree structure.
Key propertyYou can specify a property which can be used for mapping fields. This is used in connection with data exchange and for certain properties, code methods. You select the property from the dropdown list. Otherwise, it will map to the selected display name.

The values on the dropdown list reflect the properties which have been added to the data object type.
Status propertyYou can select a set property which will enable you to define and see what the status of your process is by allowing you to map the values of a set property to transition points in a process.

Map status flow from the Process template dialog box.
Number sequenceWhen you click Apply the system automatically creates a number sequence and a form. If you want to use a different sequence, which starts from a different value, click in the Number sequence field to select it from the dropdown list.

The list of sequences are retrieved from and maintained in the Sequences view.
FormThe Form is the data object form used for viewing a data object of a specific type.
Allow for childrenSelect this checkbox to allow other data objects to be placed below this one in the Tree structure, like a folder.
Require process to create and modify objectsSelect this checkbox if it should only be possible to create and edit data objects through a process. This is checked by default. When checked, this data object type cannot be queried through OData.
Object versioningSelect this checkbox if you want data objects of this type to be given a version number.
Object archivingBy default the Object archiving checkbox is selected.
Enable this type for ODataSelect this checkbox to allow OData API to query the data objects of that type. When checked, this data object type can only be queried if Require process to create and modify objects is unchecked.

NOTE: This setting does not impact Omada Identity internal operations via OData API.
Delete object versions after (days)By default, the object versions are set to be deleted after 365 days. You can change that value in this field.
tip

It is also possible to create Data object types as a part of creating a Process template.