Skip to Content
Personal Insights
Author's profile photo Alex Dong

Utilizing CMIS Workbench together with BTP DMS

How to know my attachments have been uploaded into BTP DMS?

If you have set up BTP DMS following my blog post “Start with SAP BTP Document Management Service (DMS)” you probably can utilize SAP Fiori as frontend UI to check the files you uploaded from SAP S/4 HANA side for example. But without SAP Fiori you can still achieve this via CMIS Workbench as an easier way. I will show you step by step within this blog post.

What is CMIS Workbench?

As mentioned before, SAP BTP DMS follows the standard protocal called Content Management Interoperability Services (CMIS). Never mind if you don’t have time to read through the definition. Just in short: it is similar to other protocals in digital world, such as https, odata, 5G and SAP BTP DMS is following the same standard – CMIS. As CMIS is open source you can leverage CMIS workbench as the frontend layer also.

Search%20with%20Google

Search with Google

How to Start with CMIS Workbench?

  1. Go here to download ZIP filer for CMIS workbench. Choose the one shown in the following screenshot.
  2. Install Java environment. I recommend you use SAP Machine. Very dummy one but I like it very much.
  3. Extract the ZIP file and go into the folder. Click the workbench.bat file if you use windows. If you use Mac, open your terminal and go into the same folder, run ./workbench.sh.
  4. You should see the workbench start. What you need to do is put your connection information as the screenshot shows. Put the API endpoint with a surfix /browser and the access token to “Username”. Leave Password empty. Remember check “OAuth 2.0 (Bearer Token). You can copy the access token from postman. Click “Load Repositories” and you should connect to your BTP DMS instance successfully. If you have question regarding the token, go back my blog post.
  5. Choose the repository you used to connect to SAP S/4 HANA and click “Login”. Then you will see all the content under the repository.

If you noticed, the last screenshot contains exactly the same content information i used in my Fiori application within my last blog post. This means no matter how UI changes the BTP DMS instance together with the API plays the most important role.

So now you can get to check whether your files have been uploaded successfully or not into your SAP BTP DMS repository, as it follows the CMIS standard. But suggestion is to use SAP Fiori resuable component as it is subject to SAP’s continuous support and maintainence, and what’s more it can be embedded into any custom Fiori application.

Please discover for more content under BTP DMS tag as always.

Assigned Tags

      3 Comments
      You must be Logged on to comment or reply to a post.
      Author's profile photo Ayush Rathod
      Ayush Rathod

      Hi,

      I am following sap help doc (https://help.sap.com/docs/document-management-service/sap-document-management-service/integrating-sap-s-4hana-with-google-workspace-using-sap-document-management-service)  to integrate S4HANA on premise with google workspace.

      i have created external repository as per the blog but when i am testing CMIS API (https://help.sap.com/docs/document-management-service/sap-document-management-service/supporting-cmis-apis)  through SAP API hub or using CMIS workbench facing issue like.

      Case -1  SAP API hub- when i am trying to run (https://api.sap.com/api/CreateDocumentApi/tryout)  it is giving 500 error as u can see in below image

      Case 2- using CMIS workbench below image with error

      please suggest any resolution

       

      Thanks and regards,

      Ayush

       

      Author's profile photo Wolfgang Fuchs
      Wolfgang Fuchs

      Hy Ayush,

       

      as we just started using DMS, Integration Option, i may can give you a solution.

      First of all, this blog helped me getting connected to the Repository: Query on CMIS Repository #1 | SAP Blogs

      For our case, the real important part starts nearly at the end of this mentioned blog. Because we only want to connect .

      CMIS%20Workbench%20connect

      CMIS Workbench connect

       

      The most important part here is that you use your bearer token as Username. then you will get connected. Thats the only difference to your screenshot above.

      How to retrieve token is the main part now, the rest is as it is shown in this picture.

       

      Best regards,

      Wolfgang

      Author's profile photo Alex Dong
      Alex Dong
      Blog Post Author

      Hi Wolfgang,

       

      Thanks for the explanation!