Establishing the connection (REST API for Conigma CCM)

Requirements

Conigma CCM

  • Conigma CCM is installed and configured

  • REST API for Conigma CCM is installed

Connect Server

  • Connect Server is installed and configured

  • The service definition for the Conigma CCM REST API is installed

Network

  • HTTP connections between Connect Server and Conigma CCM are possible (in both directions)

Establishing the connection Connect Server -> Conigma CCM

Preparations

If the base URI of the SAP system is not known, it must first be determined. Proceed as follows.

Call up transaction SICF.

Press F8 or click on "Run".

Now navigate to the service /default_host/gal/conigma/ccm/api/rest/1 and select “Test service” from the context menu. A browser opens with the message "No suitable resource found".

Now copy the URL from the browser and remove all characters starting with the string "/gal/conigma/ccm/api/rest/1". The result is the base URI of the API.

Setting up the connection

Now log in to the Connect Server and open the Connection Designer.

Click on “Add Connection” and choose a name for the new connection (e.g., "conigma_ccm").

Select the service definition "Congima CCM REST API" and maintain title and description

Add the following values of type text to the JSON object:

Name

Type

Value

base_uri

Text

The base URI determined above

sap_client

Text

The SAP client to which the logon is to be made

sap_user

Text

The SAP user used for logon

sap_password

Text

The password used to log in

sap_language

Text

one-digit language code (e.g., "E" for English or "D" for German)

Now click on "Test connection". If the test is successful, you can save the changes. The connection from Connect Server to Conigma CCM is now successfully established.

Establishing the connection Conigma CCM -> Connect Server

Setting up the connection

Open the object type to be synchronized (usually SWFM_CR) in the Conigma Repository Browser.

Switch to the Object Editor tab and click on "Edit".

Scroll all the way down to table "WEBHOOK_DEFINITIONS".

Adjust the hostname and port in the URI column to reach your Connect installation.

Save the changes

To test the setup, run through your workflow and check whether the expected events arrive at the Connect Server (via the console or by checking the execution contexts).