Troubleshooting
This topic describes possible sources of errors and how you can track down the cause of a problem.
To simplify troubleshooting, you can enable logs for workflows in the configuration settings, see Workflow in the Configuration topic of the Core Administrator Guide.
There are two types of errors:
- Records are displayed incorrectly.
- Commands are executed incorrectly.
Common Errors and Causes
| Scenario | Error | Cause / Solution |
|---|---|---|
| Level | Level not opened from a command | Define the input criteria. |
| Enter the level number in the command. | ||
| Records | Too many records | The index or key length is missing. |
| None / too few records | The level is not opened as a child. | |
| The key used to select records is too long causing records to be excluded. | ||
| Check that you are using the correct index to select records. | ||
| The record parameter is of the wrong type. | ||
| The wrong records are displayed | The order in which the actions are carried out is wrong; the process is called first and then the parameter entered. | |
| Too many records displayed when accessing the level a second time | The parameter stack was not cleared. | |
| Parameters | Parameters are empty | Info Area and Field entered incorrectly or left blank. |
| Wrong parameter entered. | ||
| Mathematical and string operations do not work | The parameter is of the wrong type. | |
| Buttons | Default buttons are unavailable | Many default buttons are level-dependent and cannot be used in the workflow. In many cases you can define the same functionality yourself. |
| Actions are not carried out when the button is clicked | Wrong button ID. Check that the ID of the button is the same as the value entered in the command. | |
| Trigger | Triggers are not executed | The trigger format is spelled incorrectly. Open the trigger in the Trigger info area, and copy the trigger's name using Ctrl+C. Enter the name in the workflow using Ctrl+V. |
| The source info area has not been specified. | ||
| Actions | The result is incorrect for commands that trigger several actions | Spread the actions over several commands, and execute these one after another. Test where the error lies and fix the problem. |
Making Values Visible
When troubleshooting, make sure you keep track of which values are stored in the records and parameters after each step.
To display the values:
| Records | Select View > All Mask Fields from the menu. |
| Record Parameters | Define a process with this parameter as an input parameter. |
| Field parameters | Display the parameter using the Set Text action. |