Personal Insights
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 with Google
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.
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
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 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
Hi Wolfgang,
Thanks for the explanation!