Configure the Celonis Process Mining Connector

Configuration

Add the External System type to the Extended configuration on the system administration

  1. Log in to the /sysadmin/admin section of Celonis Process Management (Requires System Administration access).
  2. Switch to "Editor" mode.
  3. Go to the Admin area. admin
  4. Navigate to Extended configuration . extended configuration
  5. Select New and then add a type for an external system with a preferred name, such as Celonis Process Mining Connector.
  6. Set the following attributes:
    • Name: The preferred name, such as "Celonis Connector".
    • Description: This service is used to export Celonis Process Management processes both to and from Celonis.
  7. Click the Add button in the "Settings" group of the details content for the service type.
    1. A new window will open. Select the data tab in the top navigation of the window.
    2. Select the Celonis service data or search for it using the field at the top of the window. service-type-data-window
    3. If you cannot find the Celonis service in this list, the service was probably not shipped with your Celonis Process Management version. Contact your Celonis Process Management system administrator if this occurs.
    4. Note that you can alternatively upload a .SYEX -file on the upload tab on the top of the window.
  8. Activate the external configuration: activate
  9. Click Apply changes . Apply changes

Add a configured external system linked to the active service

  1. Select External systems from the main navigation bar.
  2. Add a new external system with a Type of "Celonis Connector".
  3. Enter a name for the service. It is recommended you name the service the same as the Team to which you want to connect this entry (e.g. Celonis Team 1).
  4. Add the URL data for the instance of the microservice. settings
    1. Service URL: Enter the URL of the service. It should look similar to the URL in the in the screenshot.
    2. Service UI URL: Ener the URL of the UI which the service uses. It should also look similar to the URL in the screenshot.
    3. Celonis Team URL: Enter the URL of your Celonis Team. The pattern of the URL should be similar to the one in the screenshot.

Connect the external system on the storage

NOTE: Multiple storages can be connected to one instance of the service.

  1. Select Home from the main navigation bar.
  2. Select a Storage Collection or create a new one.
  3. Select Storages from the main navigation menu.
  4. Choose an existing storage or create a new one.
  5. Under the External Systems group, select the configured external system from the Celonis Synchronization Service dropdown. choose external system
  6. Note that you can connect multiple Celonis Teams to the Storage.

Setting an API Key

  1. Select Home from the main navigation bar.
  2. Navigate to the storage for which you activated the Celonis Process Mining Connector.
  3. Open the user flyout in the upper right corner of your view.
  4. In the flyout select the Settings tab.
  5. At the bottom of the flyout, use the Custom User Settings section to enter a valid Celonis API Key for you services. For further information on how to generate a Celonis API Key, go to https://(YourCelonisTeamDomain)/help/display/CIBC/User+Profile . enter celonis api key

Result after adding the external system

  • Adding the external system to your repository will result in the following:
    • All the required configurations will be added to Celonis Process Management:
      • Option to add an API Key in the user flyout.
      • Option to add an API Key in the User facet of the Admin area.
      • Two new service buttons for each added Celonis Team to push and/or pull processes from Celonis Process Management to Celonis.
      • New entries in the navigation facet of the Admin area.

Optional / additional configuration

If you want to customize the new created buttons for your team(s):

  1. Navigate into the Admin area.
  2. Select the Navigation facet.
  3. Extend the Toolbar list.
  4. Extend the Services (Graphic) list.
  5. You will now see a list of items with the type "Open dialog button" . Select the button you want to edit.
  6. Edit the button label or translate the the label into a different language. edit-and-translate-buttons