Skip to main content

Celonis Product Documentation

Extending Celonis object types

You can add custom attributes and custom object to object relationships to extend the Celonis object types. The relationships can be to other Celonis object types, or to custom object types that you’ve created. You can’t extend the Celonis event types.

Modeling objects and events helps you choose whether to use a Celonis object type as it's supplied, extend a Celonis object type by adding extra attributes and relationships for your business needs, or create your own custom object type.

When you publish your extensions to Celonis object types, Celonis automatically updates the tables in the underlying database in the OCPM Data Pool. The extensions also appear in supplied or custom perspectives where the object type is linked - you don’t need to edit the perspectives. Apps that use the perspectives won’t make use of your extensions until you edit the app package in Studio to reflect them, and reload the perspective.

You’ll need to create and run custom SQL transformations to map your extracted business data into your custom attributes and relationships. Creating custom transformations has the instructions to do this. When you’ve done that, you can use the extended objects and events with Celonis features and apps.

Follow these steps to extend Celonis object types:

  1. From the Celonis navigation bar, select Data > Objects and Events.

  2. Select Objects in the top navigation bar to view the existing object types for your Celonis team. Use the search box to search for any object type. From any object type, you can click View in Graph to explore the object type and its related objects visually, and see how it’s used.

  3. Select the name of any object type in the list to see its attributes, relationships to other objects, and relationships to events, and the transformations that you’ve already installed for it. Select Object details and then Relationships to objects, and verify that each attribute or object to object relationship that you want to create isn’t already present.

  4. To add your custom attributes, select Object details.

    1. Click Add to add a new attribute to the object.

    2. Give the attribute a name. You can't use spaces or special characters. Upper and lower case letters and numbers are allowed. There's a length limit of 40 characters.

    3. Select the data type for the property from the Data Type dropdown. The available data types are String, Boolean, Datetime, Integer, and Floating Point.

  5. To add your custom object to object relationships, select Relationships to objects.

    1. Click Add to add a new object to object relationship.

    2. In the search box, start typing all or part of the name of the object type that you want to link to this object, and pick the object type from the list.

    3. Use the Cardinality dropdown to say whether this relationship is one to one (1:1), one to many (1:m), many to one (m:1), or many to many (m:n).

    4. If the relationship is unidirectional, where the first object type has a record of the relationship but the second object type involved in it doesn’t, use the dropdown to select this instead of the default bidirectional relationship.

    5. Give each side of the relationship a name. We’ve prefilled this with the name of the related object, but you can change this if you want. You can't use spaces or special characters. Upper and lower case letters and numbers are allowed. There's a length limit of 40 characters.

    6. If you want to change which object type you implement the relationship transformation on, set this with the sliders. For a one to many or many to one relationship, the “many” side has to have the relationship data. For a one to one or many to many relationship, it can be either. We default to the first object, but you might want to change it if the second object is a custom object, and you’d rather create the transformation there.

  6. Click Save to apply the extensions to the object type.

  7. Select Publish > Publish to development to synchronize your changes to the development environment.

Next, follow the steps in Creating custom transformations to populate your new attributes and relationships with data.