Connecting to Conexiom (extractor)

The Celonis Conexiom extractor integrates the Celonis Platform with Conexiom’s order automation platform to retrieve alerts, documents, buyers, and related data via the REST API, which can then be used for process mining and analysis. It supports the following basic features:

Prerequisites

This section details important prerequisites or prerequisite knowledge for using this extractor.

Conexiom authentication methods

The Conexiom REST API uses the OAuth 2 authentication method. To establish a connection to Conexiom, you must provide the following information:

API URL
HubCo ID
OAuth2 fields: Username, Password, Client ID, and Client Secret.

Available Conexiom endpoints

The default Conexiom extractor allows you to call these endpoints:

Method	Endpoint	Description
GET	Alerts	List of all Alerts for the given HubCo.
GET	Alert per Document	Information about one specific Alert per Alert ID. Depends on endpoint: Alerts
GET	SpokeCos per HubCo	List of all SpokeCos for the given HubCo. Request parameter: lastModifiedFromDate (for Delta Filter)
GET	Documents per SpokeCo	List of all Documents for the given SpokeCo ID. Depends on endpoint: SpokeCos per HubCo Request parameter: ProcessedOnFromDate (for Delta Filter)
GET	Document Data	Information about one specific Document per Document ID. Depends on endpoint: Documents per SpokeCo
GET	Filelist	List of all files for the given Document ID. Depends on endpoint: Documents per SpokeCo
GET	Buyers	List of all buyers for the given SpokeCo ID. Depends on endpoint: SpokeCos per HubCo
GET	Addresses	List of all addresses for the given SpokeCo ID. Depends on endpoint: SpokeCos per HubCo
GET	SpokeCos	Information about one specific SpokeCo per SpokeCo ID. Depends on endpoint: SpokeCos per HubCo

Further Conexiom information

For further information about Conexiom, see: Conexiom Knowledge Base.

Configuring the Conexiom extractor

This section describes the basic setup of configuring the Conexiom extractor. To configure the extractor:

Note

For configuration, the Conexiom extractor has required OAuth2 related fields. For more information, see Conexiom authentication methods.

In the Celonis Platform left navigation, select Data > Data Integration.
On the Data Pools screen, select the data pool where you want to integrate the extractor. This opens the Data Integration window.
Note
If you have not yet configured a data pool for this data set, see Creating and managing data pools
In the Input section, select the Connect to Data Source tile. This opens the Add Data Connection window.
In the Add Data Connection window, select Connect to Data Source. This opens the in-tool connection catalog.
In the connection catalog, select the extractor. This opens the configuration window.
In the configuration window, provide the requested data for each field.
(Optional) Toggle the Advanced settings option to open the advanced configuration options. Read through each option and update as needed.
Select the Test Connection button to confirm the extractor can connect to the host system. If the test fails, adjust the data in the configuration fields as needed.
Once the test connection passes, select the Save button to continue. This returns you to the Data Integration window.

You have now connected the extractor to your host system. To create and execute data jobs, see Extracting and transforming data.