---
id: designer-test
title: "Test flows"
summary: "Write tests for a flow as a test flow with Flow test case components, run them, and read the results."
audience: user
keywords: "test, test flow, flow test case, test results, success on exception"
---
# Test flows

A test flow tests a logical flow. It is a flow like any other, built in the same designer, so a test can send data
through a flow, call its ports or check a database afterwards.

## Create a test flow

In the logical flow's properties, click **Create new test flow** next to **Test flow**. The test flow is created and
linked. You can also create one with **New test flow** in the Flow explorer and link it afterwards.

When a flow has a linked test flow, **Open test flow** opens it from the flow's menu.

## Write tests

Each **Flow test case** component is one test. Connect its **Test to start** pin to the steps of the test.

| Field | What it does |
|---|---|
| **Execute test** | Switch a test off without deleting it |
| **Success on exception** | The test passes when it throws an error; use it to test failures |

A test fails when one of its steps throws an error, unless **Success on exception** is set.

## Run and read results

Start the test flow with **Start** (F5). The test cases run one after another. When they finish, **Test results**
opens with one row per test: executions, failures, duration, the error message and passed or failed.

Earlier runs stay available: open **Test results** → **View** in the test flow's properties and pick a run.