Testflow Configuration

This node holds settings for the workflow test. It replaces the config files that have been used previously.
The execution of the node does nothing, only the settings entered in the dialog will be read later-on by the testing framework. When the workflow is execute as a test workflow, this node is always reset prior to execution. By using flow variable connections from this node you can ensure that certain nodes are always reset, even if they are (accidently) saved in executed state.

Options

Workflow settings

Owner's mail address
Enter the e-mail address of the workflow owner here. A mail will be sent to this address if the workflow test fails. You can enter multiple addresses by separating them with commas.
Execution timeout
Set a timeout after which execution of the workflow is canceled and an error is reported.
Maximum number of hilited rows
Sets the maximum number of rows that are hilited per data table. This limit is only for preventing excessive memory usage in case of very large tables because the hilited row keys are all kept in memory.
Test in streaming mode
If checked, the workflow will also be tested in streaming mode, i.e. a Test Streaming Executor will be selected for each node and executed. Please note that the streaming mode must additionally be allowed in the global Testrun Configuration! Otherwise the streaming test will be skipped.
Test nodes in components
If checked, nodes inside components will be listed in (and configurable via) the Node settings tab. Conversely, if unchecked, nodes inside components are not listed and will be ignored for testing. Instead, the component itself can then be found and configured in the Node settings tab.
Require workflow version
If set, the node will fail on execution if the workflow file was not in the specified version. This is useful for ensuring that a workflow stays in a specific previous version to ensure backwards compatibility with node settings written with that version. This makes sure that the node settings were not overwritten by a newer KNIME version, which would defeat the purpose of the workflow test.

Note that version numbers from the drop-down don't necessarily correspond to KNIME releases; these version strings are used internally in the framework and are written to the workflow.knime.

Supported table backends
These checkboxes allow to disable the testflow execution on certain table backends. The default is to support all table backends but there might be certain scenarios in which a testflow doesn't support one of the backends because of slightly different behavior. In such a case it is advised to create a dedicated testflow for each of the backends.
Log Errors, Warnings, Infos
These lists contains error, warning, or info messages that must be present in the log file after the workflows has been fully executed. Usually these are messages written by a NodeLogger.
You can also use regular expression for log messages in case there are slight variations. By default the message is treated as a plain string. By enclosing parts of the string by _!_ you can enter regular expressions in between, e.g. File _!_.+_!_ not found.
Log Optional
These lists contains optional error, warning, or info messages that can be present in the log file after the workflows has been fully executed. Usually these are messages written by a NodeLogger.
You can also use regular expression for log messages in case there are slight variations. By default the message is treated as a plain string. By enclosing parts of the string by _!_ you can enter regular expressions in between, e.g. File _!_.+_!_ not found.

Node settings

Node is expected to fail
If the node selected in the list above is expected to fail for a successful test, check this option.
Required error message
Enter the error message on the node selected above that must be present after the workflow has been fully executed. If it is not present the test fails.
This field is pre-filled with the current error message of the selected node (if there is any), indicated by the gray text color. If you want to really use this message click in the text field, and possibly edit it. Once the text color is black, the message is used.
You can also use regular expression for required error messages in case there are slight variations. By default the message is treated as a plain string. By enclosing parts of the string by _!_ you can enter regular expressions in between, e.g. File _!_.+_!_ not found.
Required warning message
Enter the error message on the node selected above that must be present after the workflow has been fully executed. If it is not present the test fails.
This field is pre-filled with the current error message of the selected node (if there is any), indicated by the gray text color. If you want to really use this message click in the text field, and possibly edit it. Once the text color is black, the message is used.
Also warning messages can contain regular expressions, see above.

Input Ports

This node has no input ports

Output Ports

This node has no output ports

Views

This node has no views

Workflows

Links

Developers

You want to see the source code for this node? Click the following button and we’ll use our super-powers to find it for you.