Sample Classes for Using Document Management Service, Integration Option in the SAP BTP ABAP Environment

Find the collection of sample classes documented here that helps you to use SAP Document Management Service, Integration option, in the SAP BTP, ABAP environment.

Description

Document Management Service, Integration Option lets you build document management capabilities for your business applications using the integration component or the easy-to-use, reusable UI component. The following examples can be used for the SAP BTP, ABAP environment. The classes follow the CMIS specification. For more information, see the Content Management Interoperability Services (CMIS) website.

Prerequisites

Please complete the following steps before using the classes:

1. Create a service-instance of SAP Document Management, Integration option. For more information, see Initial Setup for Document Management Service, Integration Option on SAP Help Portal.
2. Onboard a repository. For more information, see SAP API Business Hub - Administrative Operations.
3. Install CMIS Workbench, and connect to your repository. (Only for development tasks.)
4. Connect to an ABAP BTP instance, and create a Communication Arrangement for SAP_COM_0668.

Using CMIS workbench to work with Document Management Service, Integration Option

• Download CMIS workbench

Download the latest version of CMIS workbench from Apache, or download the version with login tabs for CP Document Service and SAP Document Center.

• Create the service-key for your Document Management Service, Integration Option service-instance, with SERVICE_INSTANCE being the name of your instance and SERVICE-KEY is any string

cf create-service-key SERVICE-INSTANCE SERVICE-KEY

• Get the uaa.url, uaa.clientid, uaa.clientsecret and endpoints.ecmservice from your service key

cf service-key SERVICE-INSTANCE SERVICE-KEY

• Fetch JWT token from postman

 POST : <uaa.url>/oauth/token?grant_type=client_credentials
 Type : Basic auth
 Username : <uaa.clientid>
 Password : <uaa.clientsecret>

• Open CMIS workbench and connect to a repository

URL : <endpoints.ecmservice>/browser
Binding: Browser
Authentication : OAuth 2.0 ( Bearer Token )
Username : <Bearer token from previous step>

• Click on load repository and start creating folders and documents

Download and Installation

1. Create a Communication Arrangement for SAP_COM_0668 with the Document Management Service, Integration Option service-key in the ABAP BTP instance.
2. Clone the repository or use the abapGit client to import the sources into your SAP system.
3. Change the Repository Id to the one created by you.

Sample Code Description:

Class name	Description
z_cl_get_cmis_client	Gets the if_cmis_client_object.
zcl_get_repositories	Gets all the repositories of the service-instance.
zcl_create_actions	Creates a folder and a document.
zcl_delete_action	Deletes folder, document, does cancel check-out for PWC and deletes a custom type.
zcl_get_type	Returns a simple type.
zcl_query_action	Runs a query and prints the results.
zcl_type_action	Shows how to fetch a type from the repository and to create a custom type.
zcl_versioning_demo	Shows how to create versions. It will only work in a versioned repository.
zcl_append_content_stream	Shows how to append a content-stream. For non-versioned repository, call append content-stream directly after create document.

Note:

1. When a Communication Arrangement for SAP_COM_0668, is created, an internal Communication System named 'ZSAP_COM_0668' is created.
2. Actions like creating a major version, append content-stream,etc, will be supported only by certain repositories. Please consult with your repository vendor.
3. The classes CL_CMIS_CLIENT_FACTORY2, CL_CMIS_CLIENT_FACTORY (deprecated) and IF_CMIS_CLIENT talks directly to the Document Management Service, Integration Option service-instance. The api calls are metered by the service-instance.
4. By design, one instance of Document Management Service, Integration Option service-instance is connected to one SAP BTP ABAP instance.
5. You can update the Communication Scenario to connect it with a new Document Management Service, Integration Option service-instance.
6. We have docmented the important methods. If you want more methods to be documented, please reach out to us via support and mention which method you want us to document.

How to obtain support

Create an issue in this repository if you find a bug or have questions about the content. You can also create an incident with the component BC-SRV-MCM-SER or BC-CP-CF-SDM-INT.

For additional support, ask a question in SAP Community.

Contributing

This project can be updated by SAP employees.

License

Copyright (c) 2021 SAP SE or an SAP affiliate company. All rights reserved. This project is licensed under the Apache Software License, version 2.0 except as noted otherwise in the LICENSE file.