Technical Articles
Use SAP Document Management service (DMS), Application Option to Store Document Files
Blogs for DMS series:
- Use SAP Document Management service (DMS), Integration Option to Store Document Files
- Use SAP Document Management service (DMS), Application Option to Store Document Files
Introduction of DMS
SAP Document Management Service is a content management solution on the Cloud Foundry environment of SAP BTP.
You can consume the SAP Document Management Service in different ways:
-
SAP Document Management, integration option lets you build document management capabilities for your business applications.
-
SAP Document Management, application option is a standalone, ready-to-use web application that provides document management capabilities for your enterprise content.
-
SAP Document Management, repository option lets you securely store and manage your documents.
Document Management, repository option isn’t an independent offering. You can use it for storage purposes along with Document Management, integration option or Document Management, application option.
You can purchase Document Management, integration option or application option, for storage purposes, you can either connect to your own storage or use Document Management, repository option.
Your own storage should be CMIS-compliant, on-premise, or cloud repository.
Thus, you can consume the DMS by the following combination:
-
Document Management, integration option + your own storage
-
Document Management, integration option + Document Management, repository option
-
Document Management, application option + your own storage
-
Document Management, application option + Document Management, repository option
Usage of Document Management, repository option
Usage of Document Management, repository option is defined as an internal method. The Document Management Service, Repository Option can’t be used as a standalone. It must be used with one of two options: Document Management Service, Application Option or Document Management Service, Integration Option.
As it’s a commercial entitlement, no tiles appear in the cloud cockpit’s. You should assign the entitlements of the Document Management, repository option
to the same subaccount where Document Management, integration option
or Document Management, application option
instance is created.
In the global account, assign the entitlement to your subaccount:
Usage of Document Management, application option
Step 1: Subscribe to the Document Management, application option
In the subaccount, find the tile in the Service Marketplace:
Create an instance:
Step 2: Grant User Access
Create a new Role Collection, add corresponding scopes into it and assign the Role Collection to yourself:
-
SDMWeb_Admin
-
SDMWeb_User
-
SDMWeb_Migration
Role Role Capabilities SDM_Admin and SDMWeb_Admin Provide admin capabilities to a user. With admin capabilities, a user can add, sync, update, and delete repositories. SDM_User and SDMWeb_User Provide capabilities to use the web UI of Document Management Service, Application Option. SDM_MigrationAdmin and SDMWeb_Migration Provide admin capabilities to use the web UI for Document Management Migration. With admin capabilities, you can initiate the migration, check the status, and also download the logs.
Step 3: Connect to Document Management, Repository Option
In the Document Management, application option instance, select Go to Application.
You can see three different tiles:
-
Document Management that takes you to the web application for managing files and folders
-
Document Management Admin that helps the admin to manage repositories.
-
Document Management Service Migration to manage migration scenarios
Open the Document Management Admin
tile, connect to Document Management, Repository Option by adding a repository:
Parameter Required Values Repository Type Yes Internal Display Name Yes Name of the repository that appears in the application. Description Optional Description of the repository. Hashing Algorithm Optional Lists the supported hashing algorithms to generate content hash for your documents. Choose None if you don’t want to generate hash. Versioning Optional Enable the option if you want to maintain multiple versions of your documents. Virus Scan Optional Enable the option to scan the documents before you upload them. You can upload files of size up to 400 MB. Disable for large files Optional The option is available only if you enable virus scan. Enable the option to disable virus scan for file size greater than 400 MB. Collaboration Optional Enable the option to create collaboration repositories. For more information, see .
Step 4: Consume Document Management, application option
Open the Document Management
tile, try to add folder or files as you like:
Step 5: Collaboration Repositories
Collaboration repository can create Share
folder which is set as private by default. Then you can configure the access control to share with your collaborator.
More detailed information: https://help.sap.com/viewer/f6e70dd4bffa4b65965b43feed4c9429/Cloud/en-US/926d32b7cd5145acb93c4317f58e2751.html
Create a shared repository by checking Collaboration
attribute as below:
Create a shared folder in the root path:
Add user to your shared folder:
Step 6: Access Application Option Repository Using API
You can access repositories onboarded via Document Management Service, Application Option through API by connecting to the instance of Document Management Service, Integration Option.
Create a Service Instance and Service Key for Document Management Service, Integration Option. For more information, see .
In the SAP BTP cockpit, choose Connectivity -> Destinations -> New Destination -> Service Instance.
Select the Service Instance that you created in the drop-down list. Enter the Name and Description.
Choose Next -> Save.
Open the Document Management Service admin view.
Choose the icon to edit your repository.
In the dialog box that appears, enter the destination name that you created in the field Service Instance Destination.
Choose Save to update your repository.
Consume API to connect your repository. For more information, see .
For example:
More details: https://help.sap.com/viewer/f6e70dd4bffa4b65965b43feed4c9429/Cloud/en-US/e5f4e592f37748759ecd551f3afcd364.html
References
if we configure S/4HANA DMS with SAP BTP DMS for attachments in our business objects (product, article, purchase order ...)
how can we have a URL like https:<base_url>/article/<image_id>.png
let's say I have 20000 images for my products (articles), we would like to be able to dynamically build our URL like appending the article number to a base URL, like any content server
the CMIS generates ugly long URL
I don't think SAP BTP DMS can offer that, a tools like ECM maybe would ?
thanks
Hi Alexandre,
Have you tried to move the parameters in the URL to the body in the format of form-data
that is the problem with this API, you need to know the repo ID (could be harcoded) and the object ID
we just need API where we pass a filename, otherwise we will need a cross-reference table of object id and file name per products by example, no super convenient
alex
Hi Tia Xu ,
In the repository type,does internal means SAP based storage service and external means Amazon S3 ,blobstore...
Is it possible to use Amazon S3 as the repository and store data in it.Or is the service similar to the S3 or an extension of the S3.
Will the repository changes on change in the deployed platform(like AWS,Azure,GCP...) .
Please help me with this,I am trying to understand the storage of data in DMS and how it is different from Amazon S3.
Thanks & Regards,
Keerthana
Hi Keerthana,
I hope this answers your question:
There are two types of repositories in Document Management Service:
Internal Repositories
Document Management Service's cloud repository.
If you want to add internal repositories, you need the Document Management Service, Repository Option entitlement.
An additional charge is applied for storage.
External Repositories
OpenText or SAP S/4HANA DMS repositories are examples of third-party CMIS-compliant repositories.
The repository provider is responsible for providing their own repository, so there are no storage charges.
Cheers,
Raj
Hi Tia/All,
One question, there is someway to use document service application option as content server in S4HANA without using integration service?
Context: We are on SAP RISE project. In the sap rise contract we have DMS BTP application option but not integration option, this has been done as an alternative to our current content server in sap ecc, but looking in forums and help documenation it seems that the integration service is mandatory to use DMS as content server alternative.
Is this right? 🙁
Thanks in advance!!!!!