3.9 - Testing a Process

Test Mode allows you to quickly test Processes from within the Build Tab without the need to deploy the Process to an Atom and wait for results to be posted back to the Manage Tab. It is intended to provide immediate feedback on Process configuration for use during initial development or production debugging. Test Mode provides results and detailed logging information for each step to assist with troubleshooting. To activate Test Mode, open a Process and click Test Mode in the top right corner of the screen. To exit Test Mode and return to Edit Mode, simply click the Test Mode link again.

There are a few important things to understand about Test Mode:

When executing a Process in Test Mode, the Process actually runs. Data actually runs through the Process so records will be moved, created, modifying, deleted, etc. according to the Process configuration.
You must deploy an Atom on which the Process can execute. However the Process does not need to be deployed to that Atom (more on Deploying Processes).
When entering Test Mode, the Process will be saved automatically.
The log and data files produced during a Test Mode execution are temporary. Once you exit Test Mode, this information is lost. Test Mode executions are not displayed in the Manage Tab.
Test Mode is limited to a maximum of 10 files (Documents) and a maximum aggregate data size of 1 MB across all 10 Documents. If more than 10 files or Documents are retrieved by the Inbound Connector, only the first 10 will be used. However if more than 1 MB of total data is retrieved, an error message will be produced. Configure filters and/or other selection criteria in the Inbound Connector Operation or Profile to limit the number and size of data read into the Process.

How to Use Test Mode

Open a Process and click Test Mode
Under Test Configuration, select the Atom on which the Process should execute
Click the Execute () button

As the Process executes you can watch the progression of Documents through the Process steps. Once the Process has finished, you can view the log and data files produced. Under, Test Data along the left side of the screen, you can view log information for the overall execution by clicking the Show Process Log . To view data and log files for a specific Document, select a Document from the list below and then click a Process step. This will display the log information for that particular step. Connector steps also have a Data tab that displays the inbound/outbound Documents along with any Connector-specific tracking information and a link to view the actual data contents ().

Logs are Temporary!
The log and data files produced during a Test Mode execution are temporary. Once you exit Test Mode, this information is lost. Test Mode executions are not displayed in the Manage Tab.

Troubleshooting

Inbound Documents that processed successfully will be marked as successful () and each of its Process steps will be highlighted in green. Documents that errored are marked as failed () and one of the Process steps will be highlighted in red.

If an error occurred during the execution, a dialog will be display containing the error message:

To view more information, view the Process Log and/or Document logs by selecting the failed Document and then clicking the Process step highlighted in red. In the log, look for the entry section marked as SEVERE and click Details link for more information. Depending on the error message, you may need to review the inbound data to look for bad data or exit Test Mode and modify the Process configuration.