[DMN Modeler] Features for Confluence Admins

Features described on this page

Feature

Hosting Type

Release Version

Blogpost

App Configurations

Server | DATA CENTER Cloud

2.0.0-ENTERPRISE

https://blog.viadee.de/en/bpmn-modeler-enterprise-3.15

Diagram Settings

Server | DATA CENTER Cloud

2.0.0-ENTERPRISE

https://blog.viadee.de/en/bpmn-modeler-enterprise-3.15

Space Permissions

Server | DATA CENTER Cloud

1.1.0-ENTERPRISE

https://blog.viadee.de/en/bpmn-modeler-enterprise-3.15

Usage Analysis and Upgrade of Existing Diagrams

Server | DATA CENTERCloud

1.1.0-ENTERPRISE

https://blog.viadee.de/en/bpmn-modeler-enterprise-3.15

GitLab Connection

Server | DATA CENTER Cloud

2.0.0-ENTERPRISE

https://blog.viadee.de/en/bpmn-modeler-enterprise-3.15

https://blog.viadee.de/en/gitlab-synchronization-with-bpmn-and-dmn-modeler-enterprise

Bitbucket Server Connection

Server | DATA CENTER

2.0.0-ENTERPRISE

https://blog.viadee.de/en/bpmn-modeler-enterprise-3.12.0

https://blog.viadee.de/en/bpmn-modeler-enterprise-3.15

GitHub Connection

Server | DATA CENTERCloud

2.19.0-ENTERPRISE

 

App Configurations SERVER | DATA CENTER CLOUD

|Since 2.0.0-ENTERPRISE|

The DMN Modeler Enterprise provides additional functionality for Confluence administrators. To access, got to "Confluence administration" → "Manage Apps", select DMN Modeler Enterprise, and click "Configure".


Diagram Settings SERVER | DATA CENTER CLOUD

|Since 2.0.0-ENTERPRISE|

 

 


Space Permissions SERVER | DATA CENTER CLOUD

|Since 1.1.0-ENTERPRISE|

Under the Space Permissions Tab, you have the option to restrict the use of DMN Modeler Enterprise to certain spaces. This way, the creation and editing of DMN diagrams is only permitted in the whitelisted Confluence spaces.

 


Usage Analysis and Upgrade of Existing Diagrams
SERVER | DATA CENTER Cloud

|Since 1.1.0-ENTERPRISE|

In the Upgrade Tab you can upgrade all macros created with our DMN Modeler Free to DMN Modeler Enterprise macros. With one click, a bulk upgrade is started. Please note, that this upgrade might take a while depending on the number of diagrams.

The usage analysis searches your Confluence instance for instances of DMN Modeler Free and Enterprise macros and displays the results in a table. This can be used to get an overview, for example before or after starting the upgrade.

Important: After completing the Upgrade procedure, it is necessary to perform a Content Re-Indexing.

 

 

 

 

 


GitLab Connection SERVER | DATA CENTER CLOUD

|Since 2.0.0-ENTERPRISE|

To enable users of the DMN Modeler Enterprise to import diagrams from GitLab and push diagrams to GitLab, you need to establish a connection between the Add-On and GitLab. This involves setting up an OAuth2 connection between the two systems. To do so, follow these steps:

  1. Create an OAuth2 App in GitLab:

    • Log in to GitLab as an administrator.

    • Go to Admin Area > Applications > New Application.

    • Select “Add new Application”, give it a name, and use the redirect URI provided in the DMN Modeler Enterprise Add-Ons's App Configuration. Add the scope api to leverage the GitLab connection fully.

    • Store the OAuth app's secret securely

    For more detailed guidance, refer to the GitLab OAuth App Documentation.

  2. Configure the Connection in Confluence:

    • If you are using a Confluence SERVER | DATA CENTER instance, you must provide the following environment variables containing Base64-encoded 32-byte encryption keys to store your configuration securely:

      • GITLAB_OAUTH_CID_KEY

      • GITLAB_OAUTH_CSC_KEY

      • GITLAB_OAUTH_AT_KEY

    • Enter your GitLab Base URL, application ID, and secret into the corresponding fields in Confluence and save them.

    • Click on Test Connection. This will open GitLab in a new browser tab, prompting you to sign in. Then, the OAuth app will ask you to authorize access to repositories.

    • After granting authorization, you should see a success message. If there is an issue, you will receive feedback on what went wrong.

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 


Bitbucket Server Connection SERVER | DATA CENTER

|Since 2.0.0-ENTERPRISE|

To enable users of the DMN Modeler Enterprise to import diagrams from Atlassian Bitbucket (Server), you need to set up an Application Link between your Confluence and Bitbucket.

To do this, sign into your Confluence as administrator, go to General Configuration> Application links > New Link and enter your Bitbucket base URL. Follow the setup wizard.

It is important for the DMN Modeler, that you choose the Oauth (impersonation) option. Otherwise it will not be able to pull files from Bitbucket.

For more information on this refer to the official Atlassian documentation

Once you established the Application link, open the configuration of the DMN Modeler Enterprise . Under Bitbucket Connection, you can click the Refresh Button to see all your available applications. Choose the desired one for Bitbucket. You must provide the following environment variable containing a Base64-encoded 32-byte encryption key to store your configuration securely:

  • BITBUCKET_OAUTH_CID_KEY

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 


GitHub Connection Server | DATA CENTER Cloud

|Since 2.19.0-ENTERPRISE|

To enable users of the DMN Modeler Enterprise to import diagrams from GitHub and push diagrams to GitHub, you need to establish a connection between the Add-On and GitHub. This involves setting up an OAuth2 connection between the two systems. To do so, follow these steps:

  1. Create an OAuth2 App in GitHub:

    • Log in to GitHub as an administrator.

    • Go to your Organization > Settings > Developer Settings > OAuth Apps

    • Select “New Org Oauth Application”, give it a name, and use the redirect URI provided in the DMN Modeler Enterprise Add-Ons's App Configuration.

      • The Homepage URL is of no relevance.

    • Generate a new client secret and store it securely.

    For more detailed guidance, refer to the GitHub OAuth App Documentation

  2. Configure the Connection in Confluence:

    • If you are using a Confluence SERVER | DATA CENTER instance, you must provide the following environment variables containing Base64-encoded 32-byte encryption keys to store your configuration securely:

      • GITHUB_OAUTH_CID_KEY

      • GITHUB_OAUTH_CSC_KEY

      • GITHUB_OAUTH_AT_KEY

    • Enter your application ID and secret into the corresponding fields in Confluence and save them.

    • Click on Test Connection. This will open GitHub in a new browser tab, prompting you to sign in. Then, the OAuth app will ask you to authorize access to repositories.

    • After granting authorization, you should see a success message. If there is an issue, you will receive feedback on what went wrong.