Share via


d.velop

d.velop is a provider of ECM solutions (Enterprise Content Management). Use this connector to connect your flow with services from the d.velop platform or your d.velop system.

This connector is available in the following products and regions:

Service Class Regions
Logic Apps Standard All Logic Apps regions except the following:
     -   Azure Government regions
     -   Azure China regions
     -   US Department of Defense (DoD)
Power Automate Premium All Power Automate regions except the following:
     -   US Government (GCC)
     -   US Government (GCC High)
     -   China Cloud operated by 21Vianet
     -   US Department of Defense (DoD)
Power Apps Premium All Power Apps regions except the following:
     -   US Government (GCC)
     -   US Government (GCC High)
     -   China Cloud operated by 21Vianet
     -   US Department of Defense (DoD)
Contact
Name d.velop AG
URL https://d-velop.com
Email support@d-velop.com
Connector Metadata
Publisher d.velop AG
Website https://d-velop.com
Privacy policy https://www.d-velop.com/privacy-policy
Categories Content and Files;Productivity

The d.velop Power Automate connector enables you, to connect systems out of your heterogenous company environment to your d.velop cloud tenant. You will be able to automize eventbased tasks like uploading a document to your d.velop documents, which was generated in a system available in Power Automate. Further possibilities are the digital signature with d.velop sign or starting a process you designed in d.velop documents from a third party application.

Prerequisites

As a prerequisite you need a d.velop cloud tenant to connect to, which implicates at least one registered d.velop cloud account. We recommend you to have at least one d.velop documents repository configured to proceed with.

Start your journey on https://store.d-velop.com. You can create an instance of d.velop documents directly here: https://store.d-velop.com/de/d.velop-documents/10001602.1.

To complete the booking process please following the instructions.

How to get credentials

Assuming, that your d.velop documents application is available at this point, follow the next steps to create an API Key.

  1. Start on your d.velop documents homepage.
  2. Click on the tile configuration.
  3. Navigate to the login settings and click on Settings for login
  4. Click on the fingerprint on the right context menu.
  5. Click on the plus on the right context menu.
  6. Select the user you wish to be used as the service account.
  7. Give it a descriptive name and click on Create.
  8. Click on your newly created entry in the list of API keys. You can now copy the API Key with the copy icon on the right side for further use in your MS Power Automate connector configuration.

You have successfully created an API key. Before you can use this API key, you have to add a trusted app to your d.velop cloud instance on this site https://.d-velop.cloud/integrationplatform/config

Proceed with the following steps:

  1. Click on Manage app trusts to open the configuration dialog on the right side.
  2. Click on Copy app-id. The application name is stored in the clipboard.
  3. Insert the app name in the right field containing Enter app name and click on Add.
  4. Select a Service-User and click on Test. If the test is successful click on Save.

You have added a trusted app, so the communication of the Power Automate Connector should now be successful with your d.velop cloud instance.

Get started with your connector

Store document

Create a new instant cloud flow and select the trigger Manually trigger a flow. After that add a file input and add the action Store document from the d.velop connector. If you have already entered the credentials go ahead with selecting the repository and the category of your destination. Enter your file reference from the trigger and add some attributes for the document which will be stored in d.velop documents. Save the flow and enjoy your fist new functionality.

Start sign process

Create a new instant cloud flow and select the trigger Manually trigger a flow. After that add a file input and add the action Execute an action from d.velop connector. If you have already entered the credentials go ahead with selecting the action Start signature process. Enter your file reference from the trigger and select a recipient and the sign level for the signature. If you like you can enter a custom message or an initiator name. Save the flow and enjoy.

React on d.velop documents import

Create a new automated cloud flow and select the trigger d.velop event (Webhook) from d.velop connector. If you have already entered the credentials go ahead with selecting the trigger d.velop documents – Document or dossier created. If you like you can add some special categories under the advanced options. After that you can use the information from the trigger and send yourself a Microsoft teams chat message with the action Post message in a chat or channel. Save the flow and enjoy.

Known issues and limitations

Not removed webhook registrations in d.velop documents configuration

If you delete a trigger you might see, that the webhook registration in d.velop documents configuration is not deleted. That could be, if you don’t set the trusted app and the service user in the configuration of d.velop connect for integration platform. You will find the configuration under the following url: https://.d-velop.cloud/integrationplatform/config

Infinite loop

You are able to create an infinite loop with the given triggers and actions. If you create an infinite loop you will increase your cost for your d.velop cloud tenant and you will probably overfill your system with unnecessary documents. Please check before activation that you don’t created an infinite loop.

Common errors and remedies

HTTP status code 404

HTTP status code 404 could be returned if the environment cannot be reached or a slash ( / ) was specified after the d.velop cloud domain address. Remove the slash behind the d.velop cloud domain. If you rather cannot connect to your environment, please contact the d.velop support under support@d-velop.com.

HTTP status code 403

HTTP status code 403 could be returned if the user behind the API-Key does not have enough rights to execute the selected action or trigger. Please go into your d.velop cloud domain and add the necessary rights for the user. If you don’t know which rights are necessary, ask your administrator of the d.velop cloud tenant.

FAQ

Where can I get the API-Key?

Assuming, that your d.velop documents application is available at this point, follow the next steps to create an API Key.

  1. Start on your d.velop documents homepage.
  2. Click on the tile configuration.
  3. Navigate to the login settings and click on Settings for login
  4. Click on the fingerprint on the right context menu.
  5. Click on the plus on the right context menu.
  6. Select the user you wish to be used as the service account.
  7. Give it a descriptive name and click on Create.
  8. Click on your newly created entry in the list of API keys. You can now copy the API Key with the copy icon on the right side for further use in your MS Power Automate connector configuration. You have successfully created an API key.

Where can I get the d.velop cloud domain address?

During the booking process you defined an address which ends with .d-velop.cloud. Normally you or the administrator of the booked d.velop cloud tenant got an e-mail with all information about the booked tenant. You will reach your d.velop cloud instance over this http address. The format of the address is always: https://.d-velop.cloud Important: Don’t add a slash as suffix!

Where can I book a d.velop cloud tenant?

To book a d.velop cloud tenant, please visit https://store.d-velop.com and navigate to the product d.velop documents. Alternative you can directly visit https://store.d-velop.com/de/d.velop-documents/10001602.1. Here you can book your favorite pricing tier. To complete the booking process please follow the instructions.

Creating a connection

The connector supports the following authentication types:

Default Parameters for creating connection. All regions Not shareable

Default

Applicable: All regions

Parameters for creating connection.

This is not shareable connection. If the power app is shared with another user, another user will be prompted to create new connection explicitly.

Name Type Description Required
API key securestring API key for the connection to d.velop cloud instance True
d.velop cloud domain string https://<d.velop cloud domain>.d-velop.cloud True

Throttling Limits

Name Calls Renewal Period
API calls per connection 100 60 seconds

Actions

Create dossier

Create a dossier in d.velop documents.

Execute an action

Executes the selected action in the selected d.velop environment.

Store document

Store a document in d.velop documents.

Update document

Update a document in d.velop documents.

Update dossier

Update a dossier in d.velop documents.

Create dossier

Create a dossier in d.velop documents.

Parameters

Name Key Required Type Description
Repository
repositoryId True string

Select a repository of your d.velop documents environment.

Category
categoryId True string

Select the destination category.

body
body True dynamic

Returns

The outputs of this operation are dynamic.

Execute an action

Executes the selected action in the selected d.velop environment.

Parameters

Name Key Required Type Description
Action
actionId True string

Select an action of your d.velop environment.

body
body True dynamic

Returns

The outputs of this operation are dynamic.

Store document

Store a document in d.velop documents.

Parameters

Name Key Required Type Description
Repository
repositoryId True string

Select a repository of your d.velop documents environment.

Category
categoryId True string

Select the destination category.

body
body True dynamic

Returns

The outputs of this operation are dynamic.

Update document

Update a document in d.velop documents.

Parameters

Name Key Required Type Description
Repository
repositoryId True string

Select a repository of your d.velop documents environment.

Category
categoryId True string

Select the destination category.

body
body True dynamic

Returns

The outputs of this operation are dynamic.

Update dossier

Update a dossier in d.velop documents.

Parameters

Name Key Required Type Description
Repository
repositoryId True string

Select a repository of your d.velop documents environment.

Category
categoryId True string

Select the destination category.

body
body True dynamic

Returns

The outputs of this operation are dynamic.

Triggers

d.velop event (Webhook)

Triggers when the defined event occurs.

d.velop event (Webhook)

Triggers when the defined event occurs.

Parameters

Name Key Required Type Description
Trigger
triggerId True string

Select event for your trigger.

type
conditionType string

Condition which can restrict the trigger.

conditionValue
conditionValue array of string

Returns

The outputs of this operation are dynamic.