You can bring in the processes and IT systems you modeled in Celonis Process Management into Ardoq. Specifically, the integration focuses on retrieving the following components and relationships:

As well as the related IT systems (or applications):

You will need to create an API token in CPM for Ardoq to be able to import your process and IT system data.

Your choice of token permissions will determine the data available to Ardoq. If your token has the author permissions, Ardoq will retrieve the latest version of any process or IT system, including unpublished versions. If your token only has reader permissions, Ardoq will retrieve only the latest published data.

If you're only interested in validated published versions of your processes, we recommend using the reader permissions for your token.

From the main menu in Ardoq, select Home > Import and integration then navigate to Celonis Process Management. On the next page, select the Connections tab, then select Create new connection and fill in the required details:

Once completed, the connection will automatically appear in the CPM exporter connection field.

Your process modelling in CPM will depend on your organization, but will ultimately use several levels of hierarchy to represent processes, sub-processes, and activities (or tasks).

We recommend that you follow the Business Process Management metamodel structure when bringing processes and activities from Celonis Process Management.

All types imported from Celonis Process Management will have a parent ID field that will allow you to create a parent-child relationships to build out your process or IT system hierarchy.

A process category can only be a child of another process category.

A process can be a child of a process category or another process. When it is a child of a process category, its parent ID field will refer to the process category ID of its parent. However, when the parent of a process is another process, the parent ID field [will be empty] and the process-to-process relationship will instead come from the Process → Supported Process table.

An activity (or task) can only have a process as a parent. Configure an activity's parent ID to point to the process ID in the Processes table when mapping in Ardoq.

An example imported data set from CPM into Ardoq shows the relationship between processes (in red) to their activities (in purple) to their related IT system (in green).

If you had used the Ardoq-to-CPM Exporter to bring your applications from Ardoq into CPM, then the applications that were exported will contain the Ardoq OID as part of their attributes.

When you re-import these applications back into Ardoq from CPM, you will need to tell Ardoq to check these OIDs against existing OIDs to avoid duplicating components in your Applications workspace.

This can be done in the following way:

When you perform the import, the values in the Ardoq OID column will be compared to the OIDs in the workspace you are importing into. If OID values match, that application will be updated; if they do not or the OID coming from CPM is empty, a new component will be created.