edoc CMIS archivelink Administration Guide

Configure CMIS integration in SAP Cloud ERP

You can use edoc CMIS archivelink to take advantage of the standard CMIS integration in SAP Cloud ERP. With the standard CMIS integration, documents attached to business transactions in the ERP system are archived in an external ECM repository. In this process, SAP Cloud ERP communicates with the external ECM repository via CMIS.

Before you begin

First, you must establish a working connection to your ECM system using edoc CMIS archivelink and have the necessary rights and permissions in SAP BTP, SAP CBC, and SAP Cloud ERP.

To ensure that communication between the systems works properly, you must establish a direct connection to your ECM system in SAP BTP via edoc CMIS archivelink and adjust the configuration in SAP CBC.

Create a subaccount, space, and DMS instance in SAP BTP Cockpit

If you are not yet using an instance of Document Management Service, Integration Option, you must first create the instance. The following step-by-step guide walks you through the process from the beginning, including creating a subaccount and Cloud Foundry spaces. If necessary, refer to the vendor’s documentation for details.

Here's how

  1. Open the SAP BTP Cockpit.

  2. Navigate to the subaccount you want, or create a new subaccount.

  3. If you don't already have one, create a Cloud Foundry space.

  4. Create an instance and a key for Document Management Service, Integration Option, using the standard plan.

Create a destination in SAP BTP Cockpit

Destinations are used to establish a connection to edoc CMIS archivelink from SAP BTP. Create a new destination for edoc CMIS archivelink.

Here's how

  1. Open the SAP BTP Cockpit.

  2. Under Connectivity > Destinations, create a new destination.

  3. Enter a name for the destination. Write down the name.

  4. In the URL field, enter the base URL of the edoc platform followed by the path to the edoc CMIS archivelink, and add /cmis/browser.

  5. Under Authentication, select the BasicAuthentication option.

  6. Under User, enter the ID of the repository that you configured in edoc CMIS archivelink.

  7. In the Password field, enter the token that was displayed when you initially saved the repository in edoc CMIS archivelink.

Create the repository in “Document Management Service, Integration Option”

Document Management Service, Integration Option provides its own CMIS API, which you can use to connect your own CMIS repositories. First, create a new repository. Specify the destination of edoc CMIS archivelink and the repository ID of the repository you have already created in edoc CMIS archivelink.

Here's how

  1. Use the service key for Document Management Service, Integration Option instance to perform repository onboarding for an external repository.

  2. While onboarding, enter the name of the destination you created earlier under Connection > destinationName.

  3. Make a note of the repository ID, which begins with Z, for example, ZC.

Establish the connection between SAP Cloud ERP and “Document Management Service, Integration Option”

To enable SAP Cloud ERP to use the external repository of Document Management Service, Integration Option, you must create a communication system and a communication agreement.

Here's how

  1. Create a communication system in your SAP Cloud ERP using the login credentials from the service key:

    1. Under Hostname, enter the value listed in the service key under ecmservice > url.

    2. Under OAuth 2.0 Settings > Client Redirect URI, enter the entry from the service key under uaa > url.

    3. Under OAuth 2.0 Settings > Authorization Endpoint, enter the entry from the service key under uaa > url.

    4. Under OAuth 2.0 Settings > Token Endpoint, enter the entry from the service key under uaa > url with the suffix /oauth/token.

    5. Add the OAuth 2.0 authentication method under Users for Outbound Communication, and enter the client ID and client secret in the service key under uaa.

  2. In your SAP Cloud ERP, create a communication agreement for SAP_COM_0597 for the communication system. Enter the ID of the repository you created earlier in the communication agreement.

  3. In SAP CBC, under Configuration > Maintain storage categories deactivate the HCP-DS category and activate the SCP-DM category.

Documents associated with business objects are archived in your ECM system.


See also

Last updated: