Camunda-Connector

This repository provides a Camunda Connector for integrating the Yuuvis® Momentum DMS API into Camunda workflows, along with an example BPMN model. The connector simplifies communication between a Yuuvis® Momentum system and the Camunda workflow engine by offering a set of pre-configured endpoints.

How it works

To install this connector: add a connector template to your BPMN project in the camunda modeler and use the contents of the yM-DMS Connector.json file. Now you are ready to use the connector in your BPMN diagrams by adding an Yuuvis Momentum Connector Task. For more information about the DMS API please have a look here: https://help.optimal-systems.com/yuuvis/Momentum/24wi/index.html#_operations_on_dms_objects

Authentication

Currently only basic authentication is supported. You can set the username and password when configuring an Connector task. Please use secrets and do not put any credentials directly into your running processes. The host URL refers to your yM instance, for example: [https://www.myYMsystem.com]. The parameter X-ID-TENANT-NAME must match the tenant of the authenticated user.

Whats included in this repo

• yM-DMS Connector.json is a template for a connector in the camunda modeler (https://modeler.camunda.io/)
• yM-Demo.bpmn is a sample BPMN model that demonstrates how to use the connector in practice. It integrates with a Java-based JobWorker DemoWorker.java to create the metadata and upload a document via the DMS Core API (https://help.optimal-systems.com/yuuvis/Momentum/25sp/tutorials/importing_documents_via_core_api.html#_importing_documents_via_core_api_importing_a_single_document)
• Upload Document.form is a form to upload a file. It is used in the yM-Demo model.