Close Window action
Use the Close Window action in active links.
The Close Window action closes the current or all open windows. This action only closes windows, and does not save updated values or push them to the parent window. If the window to be closed is a dialog box and you want to write the data from the dialog box to the parent form, use the Close Window action in combination with the Open Window and Commit Changes action, as follows:
- In the Open Window active link action (Open Window action) specify the data to be transferred to the parent form with the Field Mapping Mode set to On Close.
- Call the Commit Changes active link action (Commit Changes action) before the Close Window action to save the specified data to the parent form.
You can create buttons to implement these actions. See Using buttons to control window close actions.
To define the Close Window active link action
- Right-click the If Action or the Else Action panel header.
- Select Add Action > Close Window.
- From the State list, select Close Current or Close All:
- Close Current — Only the current window the active link is running from closes when the active link executes.
- Close All — All open windows close when the active link executes.
- Save the active link.
Using buttons to control window close actions
When developing a dialog box, create buttons that predictably exit the dialog box and accomplish the actions that you want to occur. To do so, add a button field to the display-only dialog box form, and then create active links that execute when the button is clicked. For example, create any or all of the following buttons:
- OK — Use the Commit Changes action followed by the Close Window action to transfer field values from the dialog box to the parent form, and then close the dialog box.
- Cancel — Use the Close Window action to close the dialog box without transferring any data to the parent form.
- Apply — Use the Commit Changes action to transfer field values from the dialog box to the parent form, but leave the dialog box open.
If you do not create these buttons, the user can only exit the dialog box by clicking the X icon in the top right corner of the dialog box. Clicking the X icon results in unsaved changes and might bypass other workflow actions that should occur.
For more information about using a display-only form as a dialog box, see Using a display-only form as a dialog box.