Running transformations
After publishing custom transformations to the OCPM Data Pool, run them to create objects and events from your custom object types and custom event types, or to update existing objects and events to which you’ve added new attributes and relationships.
Celonis stores custom transformations in the data job test:ocpm-data-job when you publish to the development environment, and in ocpm-data-job when you publish to the production environment. These data jobs are in the global scope for the OCPM Data Pool. The jobs contain the Celonis-supplied transformations as well as your custom transformations, so you can use these instructions to run or re-run the supplied transformations if you didn’t run them already.
We automatically disable transformations that haven't been validated and transformations that have failed validation, so they won't run as part of your data jobs. In the Transformations page in the Objects and Events UI, you can check which transformations have passed validation, failed validation, or not been validated yet.
If you have any problems, check the solutions in Troubleshooting transformations.
From the Celonis navigation bar, select Data > Objects and Events.
Select Dashboard in the Objects and Events navigation panel to go to the dashboard.
Select OCPM Data Pool to go to the data pool. You can also select Data > Data Integration from the Celonis navigation bar and pick the OCPM Data Pool from the list of data pools.
In the OCPM Data Pool, click the Data Jobs area.
Select test:ocpm-data-job to create objects and events in the development environment, or ocpm-data-job to create objects and events in the production environment.
In the list of transformations, select the name of any transformation if you want to review its details.
When you’re ready to run your transformations, click Execute Data Job. In the confirmation window, you can select just a subset of the transformations if you want to.
Tip
If there's a Celonis object type or event type that you don’t need, or don’t have data for, or are building with data from a set of transformations for another source system, you can disable the transformation for it in the Objects and Events environment. If you disable a transformation that you previously ran, the data for that object type or event type is removed from the table when you run the data job.
Click Execute Selection to run the selected transformations - if you don’t make a selection, they’ll all run.
In the Data Jobs area in the OCPM Data Pool, the data job displays the status and execution time so far, and there’s a button if you want to stop the job running.
You can monitor the status of the running transformations in the Logs tab for the data job. When the transformations have finished running, the status should show as "Successful". You can also see the status of the last run for each individual transformation in the Transformations page in the Objects and Events UI, and get a link to the logs to check on any errors.
When you're ready to run your data jobs regularly, set up schedules for them. Scheduling data jobs for object-centric process mining tells you how.
The transformations populate the tables in the Celonis database in the OCPM Data Pool with your business data to create objects and events. When you run test:ocpm-data-job, you’ll get a test copy in tables with the prefix "t". When you run ocpm-data-job, you’ll get the objects and events in your production environment.
To view your objects and events and analyze your business processes with them, see Using objects and events for process mining. To use custom object types and custom event types, you’ll need to create custom perspectives following the instructions in Creating custom perspectives and event logs.