Skip to main content

[en] Test Tool Test Tool

[en] One Tool Example

[en] Test has a One Tool Example. Visit Sample Workflows to learn how to access this and many other examples directly in Alteryx Designer.

[en] Use Test to verify data or processes in a workflow. Since the Test tool accepts multiple inputs, with a single Test tool you can create multiple tests and test multiple sets of data and processes. The tool notifies you with a descriptive error message if your test criteria are not met.

[en] Use the Test tool to verify data before writing results to a database.

[en] Configure the Tool

[en] When the tool is first placed on the canvas, an empty list is displayed in the Configuration window.

[en] Because this tool includes an expression editor, an additional input anchor displays when the tool is used in an app or macro workflow. Use the Interface tools to connect to a Question anchor.

[en] Add New Test

[en] To add a new test to the list...

  1. [en] Select Add to open the AddTest window.

  2. [en] Enter a test name in TestName.

  3. [en] Select InputConnection, and select the input connection to test.

  4. [en] Select TestType, and select a test.

    • [en] RecordCountMatchesSpecificValue: The test fails if the record count does not match the value entered in the Test Value field.

    • [en] RecordCountMatchesOtherInput'sRecordCount: The test fails if the record count in each input does not match the value entered in the Test Value field.

    • [en] Expression is True for All Records: The test fails if one or more records do not match the expression entered in the Test Value field.

    • [en] Expression is True for First Record: The test fails if the first record does not match the expression entered in the Test Value field.

  5. [en] In Test Value, enter the value or use the dropdown to select the input you want to test.

  6. [en] If Test Type is an expression, select the ellipses icon (...)to create an expression. Visit Expression Editor for more information.

  7. [en] Select OK to confirm your new test.

[en] Edit Existing Test

[en] To edit an existing test...

  1. [en] In the list, select the test and select Edit to open the EditTest window. You can also double-click the test.

  2. [en] Adjust the fields as desired.

  3. [en] Select OK to confirm changes, or Cancel to revert to the original test configuration.

[en] Delete Test

[en] To delete an existing test...

  1. [en] In the list, select the test.

  2. [en] Select Delete. The test is deleted without a confirmation screen.

[en] Errors in the Workflow

[en] Before you run the workflow, use Don't report errors if there are other errors in the workflow to determine the error behavior of the workflow. The option is checked by default, so test errors only report if there are no other errors in the workflow.

[en] If you want to see errors from the Test tool regardless of other errors in the workflow (for example, if you have known errors that you use for validation), you can uncheck the option to have the Test tool produce errors, regardless of errors being present in the rest of the workflow.

: