f$ActionDialog (f$AktionsDialog)

f$ActionDialog (f$AktionsDialog)

Activate a dialog previously opened with f$DialogOpen. Contrary to f$Dialog and f$DialogExecute, this command does not have a return value. The rule-based controls continue immediately. It is therefore not possible to evaluate return values for this dialog. In order to manage actions, buttons in the dialog can be equipped with an action (execute a decision table). The dialog is closed when pressing buttons with a return value. The full functionality of the watching logic (Watch-DT) is available.

The following behavior is applicable when working with multiple dialogs: dialogs activated with f$Dialog or f$DialogExecute ensure that the other visible dialogs are inactive until the current dialog is closed. Dialogs launched with f$ActionDialog can be used simultaneously.

The following approach is recommended:

Open a main dialog with f$Dialog or f$DialogExecute. If an additional dialog is required in an action or watching logic and is to function independently, then this additional dialog must be opened with f$ActionDialog. Should however the operation of the main dialog be blocked until the data for the additional dialog is entered, then it should be opened with f$Dialog or f$DialogExecute.

Note: all dialogs are closed automatically when closing the rule-based controls. If the main dialog is accidentally opened with f$ActionDialog and there is no other place in the rule-based controls to ensure the logic is stopped, then the action dialog closes since the rule-based controls are also closing.

See f$DialogOpen for details and examples.