Debug a form

You can debug a form, including capture forms (Scan create new job, Scan, Document review, Validation and Verification).

Note The Debug option is not available for Document and Folder forms.

To debug a form, perform the following steps.

  1. Launch the form in a debug mode

  2. Set breakpoints

  3. View action inputs/outputs

Launch a form in a debug mode

When you launch a form in debug mode, the primary form is loaded as per the runtime behavior.

  1. Navigate to User interface > Forms.

    A list of forms is displayed.

  2. On the context menu of the form to debug, click Debug.

    Alternatively click Debug on the form Action bar.

    The form opens in the debug mode in a new browser window. The Form initialization pop-up appears. A list of form and global variables set as initialization variables in the form appear. A dropdown (if available) only shows the selected value and not all possible values.

  3. You can add a breakpoint to any action, such as .Net action with a button click event. To add a breakpoint on form load, select Pause before executing form loaded event actions.
  4. Update the values of the initialization data.
  5. Click OK.

Set breakpoints

A breakpoint is an intentional stop or pause in a program and is used for debugging purposes. It is also sometimes referred to as a pause. For example, you can set an event at a breakpoint on a form. You cannot set breakpoints on the Before render and After render form events or on Begin condition, Else condition and End condition actions.

  1. In the Debug window, click for Breakpoints.

    The Add breakpoint dialog box is displayed. A tree of the form with all corresponding controls, events and actions associated with each, is displayed as shown below.

    • Form

      • Events

        • Configured Action 1

        • Configured Action 2

    • Control 1

      • Events

        • Configured Action 1

        • Configured Action 2

    • Control 2

      • Events

  2. Add the breakpoints.

    The selected breakpoints are added to the Selected items list .

  3. Click Done.
  4. To skip an action within a form execution, click for Actions to skip.

    The Form action dialog box is displayed.

  5. Add the actions.

    The selected actions are added to the Selected items list.

  6. Click Done.

    The status of the actions is updated to skipped in the stack trace.

    Note When you are loading and debugging the form for the first time, if you select Pause before executing form loaded event actions the first action cannot be skipped. You need to restart debugging and then add the actions to be skipped.

    Panel Description


    The controls of the current form appear in this panel.


    Variable values panel

    Lists the form and global variables, and form controls.

    Note You can view and update the variables and controls in this panel. You can also view the controls which are in hidden state.


    Stacktrace panel

    Lists the actions in the order of execution.


    Breakpoints panel

    Lists the events for which you have set the breakpoints.

  7. Once a breakpoint is set, you can invoke the events on the form load.
    • To invoke any breakpoints on the "On load" event of the form, refresh the main page.

    • To invoke an event on a control, interact with the form itself. For example, click a button or select a row within the table.

    Once the event is invoked, the Stacktrace panel displays the possible actions. The status of the actions is updated as they are executed until it reaches the first breakpoint. You can choose to continue execution or step over an action.



    Continues execution to the next enabled breakpoint.


    Step over

    Executes current action and stops at the next action in order.



    Clears the stack trace panel.



    The list of actions for execution.

    You can determine what path was taken when using conditions in a debug mode. When you configure your form to have a Begin condition and an Else condition, these are reflected in the stack trace so that you can determine where the logic was executed.

    Note You can have a Begin condition within a Begin condition for nested logic.

    When you click on the Begin condition, you can view the outcome whether it is true or false. For example, in the following scenario, the outcome of BeginCondition1 is false and the outcome of BeginCondition2 is true.

    Form debug condition

View action inputs/outputs

When you reach a breakpoint, you can expand any server side action, such as .Net action and view and update the values of controls, form and global variables and continue execution.

You can expand a Table control to see all rows and columns.

A Redirect action does not redirect but when executed displays a message stating where it would have redirected to.

To update the value (for example, to update the value of a form variable), perform the following steps.

  1. Click the Form variables tab.
  2. Select the variable and click Edit.
  3. Change the value as needed, and click OK.
    Note You can update global variables and form controls in a similar manner. However, you cannot update array form variables and advanced form controls.