Skip to main content

Running Workflows in UI​

You can run workflows from the Conductor UI in the following places:

  • (before v5.1.2) Run Workflow in the left navigation menu
  • (before v5.1.2) The Run tab in a workflow definition’s visual diagram editor

UI screen for before v5.1.2, with Run Workflow in the left navigation menu and Run tab in a workflow definition’s visual diagram editor.

  • (from v5.1.2) The Execute button in a workflow definition’s visual diagram editor

UI screen for after v5.1.2, with Execute button in a workflow definition’s visual diagram editor.

  • Run Workflow in the top navigation menu in Executions > Workflow
  • Run Workflow in the top navigation menu in Definitions > Workflow

UI screen for Run Workflow in the top navigation menu in Executions > Workflow.

Run workflow

To run a workflow:

  1. Select the Workflow name and Version. If the version is unspecified, the latest version will run.

  2. Enter the Input params.

    {
    “key”: “value”,
    “someKey”: 2
    }
  3. (Optional) Enter the Idempotency key, Correlation id, and Task to domain mapping.

    Example task to domain mapping

    {
    "task_x": "someDomain"
    }
  4. Select Run Workflow in the top right corner.

Run a workflow in the Conductor UI.

The workflow (execution) ID for the current execution will appear at the top of the page. Select the workflow (execution) ID to view the execution details.

Workflow run history

The Run Workflow page has a panel for the workflow run history.

Screenshot of the Workflow run history section in the Conductor UI.

The workflow run history contains all workflow executions initiated from the UI. You can select the Execution name or Execution link to jump to the execution details screen.

You can also select the Restore Form Values button to load a past execution’s configuration values into the UI form and rerun the workflow.

Restore a previous workflow execution configuration to run it again.

To clear the workflow run history, select Reset > Confirm.

Run tasks

If you want to test the behavior of single tasks inside a workflow, you can use the Test Task feature on the Conductor UI.

To test a task:

  1. Go to Definitions > Workflow.
  2. Select a workflow that you want to test.
  3. In the workflow diagram, select a task that you want to test.
  4. Select Test Task in the right-side panel.

    Test Task UI

  5. Using either the Form or JSON display, enter the input parameters for the task.
  6. (Optional) Enter the Domain for the task if task-to-domain is used.
  7. Select Run Test.

Test Task Procedure.

Once completed, the task output will appear. These tests are essentially single-task workflows, and you can select the workflow (execution) ID to view the full execution details.

View execution after testing task.