Documentation

Workflow Designer Overview

Subscription

The Process Builder’s workflow designer is a graphical interface for creating workflow process definitions. The convenient drag and drop interface makes workflow design easier than writing XML definitions by hand. It’s accessed in the Control Panel → Workflow → Process Builder.

Drag and drop nodes onto the designer canvas.

Tip

Alternatively, you can write or upload XML definitions from the Source View in the Process Builder. See Managing Workflows.

The workflow designer supports all workflow node types:

In addition to the functionality provided by the drag and drop interface, you have the full power of Groovy (a Java-based scripting language) to perform programmatic actions on assets being moved through your workflows.

By default, only one workflow definition is installed: the Single Approver Workflow definition. You can see additional examples in the Liferay source code:

Building Workflows

To build a workflow, navigate to the Global Menu (Global Menu) → Control Panel → Process Builder.

Click the (Add icon) to begin.

Each Workflow Node represents a specific point in an approval process, whether it starts the review process, approves or rejects the asset, or reassigns the task.

Workflow transitions link each node to create the desired flow in the review process. On exiting the first node, processing continues to the next node indicated by the transition.

Ready to work on workflows? Your next step is creating workflow tasks.

Localizing the Workflow

A workflow process’s text is experienced by Users in these ways:

  • Administrators and workflow participants (e.g., workflow task assignees) see the workflow definition’s title in the list of workflows.

  • Workflow participants (e.g., workflow task assignees) see the Node and Transition labels while managing their workflow content (e.g., in My Workflow Tasks).

As of Liferay 7.4 U20, the Workflow text that appears in the UI is translatable.

To translate the workflow,

  1. Open a workflow or add a new one from the Global Menu → Applications → Process Builder.

  2. If it’s a new workflow connect the start node to the end node with a transition.

  3. All of the localizable fields were created in the instance’s default language. To begin translating, click the Language Selector near the workflow’s title field:

    Use the language selector to choose a translation language.

  4. Select the language to begin translating.

  5. Go through the workflow and translate the node labels, transition labels, and the workflow title.

  6. Save the workflow.

Once the workflow definition is published and associated to an asset, participants like workflow task assignees will interact with the workflow in their language.