Open Another Form

This action opens another form from the same solution or a form from your disk.

About group identifies the selected action.

  • Name: allows you to define a custom action name. This makes actions easily recognizable on the solution's list of actions. By default, the action name is taken from its type.
  • Description: custom information about the action. Enter a description to explain the purpose and role of action in a solution.
  • Action type: read-only information about the selected action type.

Settings group includes the following options:

  • Navigate back to previously opened form: reopens the preceding form when the Open Another Form action is run.

  • Open form: defines a form to be opened when the Open Another Form action is run.

There are four ways to open a form:

  • Enter the absolute file path.

  • Select an existing form from the solution.

  • Click Open to locate the file on the disk.

  • Use a data source to define the file path dynamically

Form data sources group helps you manage variable values when switching between forms.

  • Reset variable values: By default, if a form object's content is a variable value, switching to another form retains its current value. If you enable the Reset variable values option, the value of the variable resets to its initial value after you open another form.

  • Note

    The Open another form action only keeps the values of variables that are in use as object data sources. If the variables are only listed in the Dynamic Data Manager, their values are not transferred.

    Note

    If the variable has no initial value, the object appears empty.

    Example 87. Example

    This option can be useful for data management solutions. When editing the data, you want to keep the existing values. When adding new data, you need to reset the values. If you use the first form for data editing and the second form for adding new data, you keep the Reset variable values option disabled for the data editing form, and enable this option for the data adding form.

Action Execution and Error Handling

Each action can be set as a conditional action. Conditional actions only run when the defined conditions allow them to be run. To define these conditions, click Show execution and error handling options.

Execution options are:

  • Enabled: specifies if the action is enabled or disabled. Only enabled actions will execute. This functionality may be used while testing a form.
  • Condition: defines one-line programming expression that must provide a Boolean value (true or false). When the result of the expression is true, the action will execute. Condition offers a way to avoid executing actions every time.

Error handling options are:

  • Ignore failure: specifies whether an error should be ignored. If enabled, the execution of actions continues even if the current action fails.

    Note

    Nested actions that depend on the current action do not execute in case of a failure. The execution of actions continues with the next action on the same level as the current action. The error is logged but does not break the execution of the action.

    • Example

    At the end of printing, you might want to send the status update to an external application using the HTTP Request action. If the printing action fails, action processing stops. In order to execute the reporting even after the failed print action, the Print Label action must have the option Ignore failure enabled.

  • Save error to variable: allows you to select or create a variable to save the error to. The same cause of the error is also saved to internal variables ActionLastErrorId and ActionLastErrorDesc.