Test

The test functionality allows to test the model in the automation environment as a service.

If the test functionality is grayed out, it is most likely that your model is not executable. This can be changed in the process attributes by right clicking on the diagram and selecting Executable under attributes.

Test Mode

When shifting in test mode, the model will become read-only and will display a left panel with the test controls and a test bar at the top.

The square button stops the currently running service.
The play-pause button continue the service at the next step.
The x button closes the test mode.

While in test mode, the test panel on the left will contextually the following information

Mode	Description
Inputs	User input required for the current element. There are 3 modes for providing user inputs that can be switched using the icons:
HTML	A web form when you type the inputs manually. See the Form section below for more information on the different widgets that compose the form.
File	An input to select or drop a file to be used as input for the service. The service accepts JSON, XML or Excel files. A template can be downloaded to have the expected format for each type of file. Note that the Excel file support is limited to models that do not contain collections as input.
Test case	A selector that allows to load a previously saved test case inside the HTML mode to edit and/or submit.
Test Data (Require Automation)	A web form that allows to persist each inputs as test data to be reused across models. Test data is shared across all users and keyed using the data type of the input. Therefore two models using a data type tPerson can be started using the same test data. This form also allows to manage the full life cycle of test data. See the Form section below for more information on the different widgets that allows to define the test data

Mode

Description

Inputs

User input required for the current element. There are 3 modes for providing user inputs that can be switched using the icons:

HTML

A web form when you type the inputs manually. See the Form section below for more information on the different widgets that compose the form.

File

An input to select or drop a file to be used as input for the service. The service accepts JSON, XML or Excel files. A template can be downloaded to have the expected format for each type of file. Note that the Excel file support is limited to models that do not contain collections as input.

Test case

A selector that allows to load a previously saved test case inside the HTML mode to edit and/or submit.

Test Data (Require Automation)

A web form that allows to persist each inputs as test data to be reused across models. Test data is shared across all users and keyed using the data type of the input. Therefore two models using a data type tPerson can be started using the same test data. This form also allows to manage the full life cycle of test data. See the Form section below for more information on the different widgets that allows to define the test data

Trace

The trace view displays the executed service nodes. It is possible to click on them to obtain the detail of the inputs and outputs of each nodes. The inputs and outputs of the nodes are presented in a user readable format and also raw as the events emitted for the ServiceNodeStarted/ServiceNodeFinished events.

The trace view presents the history of everything that already occurred in the service and when the service is stopped waiting for an external trigger (user task, message, breakpoint, …), the trace presents required data to input to continue the service.

Data

This tab presents all the service variables. It is possible to modify them and update them using the Update button when the service is still executing.

Out

When the service completes, the output results are presented. From there, you can save the results as a Test case or download the results as a JSON file.

Breakpoints

Display the configured breakpoints and allows to check an option to skip all breakpoints.

When the service progresses, the taken path is highlighted in green.

Breakpoints

When hovering on the diagram, breakpoints overlay become visible when you mouse-over a supported node. Clicking on these icons will set/clear breakpoints. The following breakpoints can be set:

Before an activity: The service will stop after having executed the input data mapping and before invoking the activity logic. It will be possible to modify values post data mapping.
After an activity: The service will stop after having executed the activity but before executing the output data mapping. It will be possible to modify values returned by the activity before the mapping.
On a sequence flow: The service will stop when navigating the sequence flow. It is possible to change any data variable at this time.

Breakpoints can be added/removed while the test session is active.

In modeling mode, it is also possible to display the breakpoints overlays using the overlay right side panel.

Tokens

Tokens represent currently active tasks of the workflow instance. There can be one or more active token at any point in time during life time of the workflow instance.

The test interface allows to manage tokens within the workflow instance. The main use case is to allow to jump back and forth without the need to go through each activity on the way.

While workflow instance is running, users can:

Move token from one node to another by simply dragging and dropping selected token
Create new tokens on nodes by right clicking on node where the token should be created and select Create Token from the menu
Delete existing tokens from nodes by right clicking on the token and select Delete Token from the menu

Tokens can be created on any type of node, including activities, gateways, events.

Token moves are reflected in the trace view that can become useful set of information when token is moved multiple times to the same node.

Form

The test interface presents in different context a form to input data.

Each input has an associated widget that allows you to enter the data. These widgets follow the data type defined for the input in the model. Note that if no data is entered in a field, the value is considered null except for Text inputs where it is considered an empty string. A null value can also be entered for a Text input by pressing the delete or backspace key.

Structures and collections will also have a caret to the left to their name to allow to expand or collapse them. They also have a null icon that will either be grayed out (the value is not null) or dark (the value is null). Clicking on the null icon nulls out the value of a structure or collection.

The collection input also offers an excel button to import and export the data in the collection as an Microsoft Excel file. Please note that complex data structure will not all be possible to represent in an Excel file.

Data type validation

By default, test is done using the "None" Data type validation. You may change that by going to the Preferences panel.