Workflows

Last update: Edit

1 Introduction

Workflow is a visual language in Mendix Studio and Mendix Studio Pro that allows you to to solve your business problems that involve processes. It is fully integrated with other visual languages, such as the microflow editor and page editor.

The main difference between workflows and microflows is a waiting aspect – the workflow is paused until it gets an input from an end-user. For example, an employee sends a travel request (triggering the start of the workflow) and then the workflow is paused until a manager approves the request by clicking a button.

To view the workflows of your app in Studio, click the Workflows icon in the left menu bar:

Workflow Icon

Workflows are a visual way of processing logic in your application. A workflow looks like a flow chart. On a new workflow a start event (a starting point of the workflow) and an end event (an endpoint of the workflow) are created by default. You can add various activities to a flow of a workflow that is called a path.

Workflow Example

2 Workflow App Template

You can use workflow-specific app templates as a starting point for using workflows. For example, you can configure an approval request form for end-users based on which the app is be created. It contains preconfigured elements, such as dashboards, admin pages, dashboards, and a workflow that you can afterwards customize even more. You can discover these templates when creating a new app.

3 Performing Basic Functions

You can perform the following basic functions when working on workflows:

3.1 Opening a Workflow

To open a workflow in Studio, do the following:

  1. Click the workflow icon in the left menu bar.

  2. In the displayed list of workflows, select the one you want to open and click it:

The selected workflow is opened.

3.2 Adding a Workflow

To add a workflow to your app in Studio, do the following:

  1. Click the workflow icon in the left menu bar.

  2. Select the module you would like to add a new workflow to and click the plus icon next to this module:

    New Workflow

    For more information on what modules are, see Domain Model.

  3. In the Create new workflow dialog box, fill in the name of the workflow and select a workflow entity (for more information on type of entities, see the Entities and Their Types section in Domain Model):

    Create New Workflow

  4. Click Create.

The workflow is created.

3.3 Duplicating a Workflow

To duplicate a workflow, do the following:

  1. Click the Workflows icon in the left menu bar.

  2. In the side panel, click the ellipsis icon and select Duplicate in the drop-down menu:

    Duplicate a Workflow

The workflow is duplicated.

3.4 Copying and Pasting a Workflow

To copy and paste a workflow, do the following:

  1. Click the Workflows icon in the left menu bar.

  2. In the side panel, click the ellipsis icon and select Copy to clipboard in the drop-down menu:

    Copy a Workflow

  3. Open the Studio app where you want to paste the workflow and press Ctrl +V or Cmd +V.

Your workflow is pasted. For more information on copy/paste function in Studio, see the Copy/Paste Workflows, Pages, Microflows, and Enumerations section in General Info.

3.5 Deleting a Workflow

To delete a workflow in Studio, do one of the following:

  1. Open the workflow you want to delete and follow the steps below:
    1. Open the Properties tab.
    2. Click Delete at the bottom of the Properties tab.
  2. Click the workflows icon in the left menu bar and do the following:
    1. In the side panel, click the ellipsis icon and select Delete in the drop-down menu:

The selected workflow is deleted.

3.6 Adding Elements to a Workflow

To add an element to a workflow, do the following:

  1. Open the Toolbox tab.
  2. Select an element you would like to add and drag and drop this element in the workflow path.

The selected element is added.

4 Toolbox Elements

The Toolbox tab contains elements that you can drag and drop on a path. Below is a categorized overview of all elements. The following sections are used:

4.1 General

Elements in the General section help you control the workflow path, for example, add parallel paths or end them:

General Section

The elements of this section are described in the table below:

Element Description
Start event The starting point of a workflow. Workflows are triggered either by the Call workflow on-click event on pages or by the Workflow call action in microflows.
Click the start event to open workflow properties.
Decision Makes a choice based on a condition and follows one and only one of the outgoing paths.
Jump activity Allows you to jump to other activities in the workflow.
Parallel split Adds two or more parallel paths to your workflow.
End activity Ends the path of the workflow

4.2 User Actions

User task – a central element in a workflow that allows you to assign a task to a certain user or a group of users using filters or microflows.

User Actions

4.3 System Actions

Call microflow activity calls a selected microflow. You can use this activity to add application logic to the path of the workflow that does not need user interaction.

System Actions

5 Read More