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.
How to Start with CMIS Workbench?
- Go here to download ZIP filer for CMIS workbench. Choose the one shown in the following screenshot.
- Install Java environment. I recommend you use SAP Machine. Very dummy one but I like it very much.
- 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.
- 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.
- 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.