Get Started

DMN in the Cloud

In a Nutshell

This service allows you to create, edit and execute DMN decision tables in the Camunda cloud.

You can use those decision tables in your application by calling the REST API.

Advantages:

  • The decision logic is not buried in source code.
  • Anyone can look at the decision logic and immediately understand it.
  • The decision logic can be changed without touching your application.
  • You can use the same decision logic in different contexts (Frontend, Backend etcetera).
  • All decision table executions are being logged in the decision history, providing you with helpful information like usage statistics.

This service is available without any costs, but is not intended to be used in productive applications. There are no guarantees for availability, correctness or data protection.

If you would like to use this service in a productive application, please participate in this survey or contact us.

How to use it

Create a Table

You can create a new table directly in the browser. If you like, you can download the DMN file and store it locally.

Alternatively, you can download the Camunda modeler and create the table on your local machine, then upload your local DMN file.

DMN is a powerful industry standard for expressing decision logic. For learning DMN, check out this DMN tutorial and the DMN reference guide.

Before actually deploying your table, you can test it with sample input data.

The buttons for download and upload are at the lower left corner of the table editor. For upload, you can also drag and drop your local DMN file on the table editor.

Deploy your Table

When you click on "Deploy", your decision table will be deployed in the Camunda cloud. You will receive two unique identifiers:

Public Key

The public key is what you need in order to execute your decision table via the REST API.

You will therefore store the key in your application's source code, which means that others might be able to retrieve it. That's why we call this key "public". It is up to you to hide the key from your users, if you don't want them to be able to access the decision table directly.

You can also use (and share) this public key for loading tables in the viewer. In the viewer, they can be inspected and tested, but not changed. You can add the public key to the Viewer URL and share the resultung deep link with others:

https://dmn.camunda.cloud/view/?key={key}

Private ID

The private ID enables you to load an already deployed table in the editor, then change and redeploy it. This will override the previous version of the table and result in a new private ID, however the public key stays the same.

This allows you to change the decision logic without touching the application that uses it. Since this may break your application, we call this ID "private" and advise you to think twice before sharing it. You can add the private ID to the Editor URL and share the resultung deep link with others:

https://dmn.camunda.cloud/edit/?key={id}

Sample success message. Don't forget to store your public key and private ID.

Execute your Table

You can execute your table from any application with a POST request:

POST: https://dmn.camunda.cloud/api/v1/decision/{Key}

The body of your request is a JSON array, with each object representing an input value:

{
  "weather" :
    {
      "type": "string",
      "value": "sunny"
    }
}

You will receive a JSON array will the resulting output values, as well as all rules that matched:

{
  "outputs": {
    "idea": {
      "type": "string",
      "values": [
        "Go running"
      ]
    }
  },
  "rules": [
    {
      "ruleId": "row-266764221-13",
      "outputs": {
        "idea": {
          "type": "string",
          "value": "Go running"
        }
      }
    }
  ]
}

Check out our examples to see how it works.

Inspect the History

Each execution of your table is being logged in the Camunda history:

  • Timestamp of the execution
  • Input values
  • Output values
  • Rules that applied

You can inspect each history entry by loading the table in the viewer, using the public key.

Whenever you change your table and redeploy it, all history entries will be deleted.

This button at the lower right corner of the table will toggle the heatmap, showing which rules have matched most often.

About Camunda

Camunda is a software vendor that specializes in Business Process Management (BPM). Our core product, Camunda BPM, allows modeling and execution of processes with BPMN 2.0, cases with CMMN 1.1 and decisions with DMN 1.1. Check out our website and learn more about Camunda BPM.

Terms of Use

This service is available without any costs.

This service is not intended to be used in productive applications. There are no guarantees for availability, correctness or data protection. If you would like to use this service in a productive application, please participate in this survey or contact us.