The Call Routine action (previously known as Call Another Action Set) is used to run the actions of another control.
This is allows you to reuse the same actions from different controls, without the need to duplicate them.
- Select A Routine: select a control with the action set you wish to call. The event the action is in will be listed in brackets.
- Jump to this action set: this will take the user to the control with the action set.
- Wait for the App Routine to finish before continuing (slower): If unchecked, then the routine will be run in the background and a notification will indicate when it is complete. Warning, if actions after the Call Routine action relies on its output, do not uncheck this.
Example: Imagine four buttons that can save a record:
- Save and return
- Save and new
- Duplicate Save button at the top of the screen
All of these buttons have the same actions except for minor differences. You can put the common save actions in the first button, and then use Call Another Action Set from the other three buttons with additional actions to handle their special cases. This way, if there is any change to the core save process, you will only need to update it in one place.
You may notice that one of the options in the dropdown has routines underneath an App heading. These are App Routines defined within the app.
Using the example from the Create App Routine article, you can setup the Call Routine action as shown:
- Select a Routine: Choose an active app routine defined in the current app. For App Routines with multiple revisions, the published revision is shown.
- Input Action Results: Select the value you wish to send to the App Routine. This value can be selected from an action result, a control, a session variable, or manually inputted.
- Wait for the App Routine to finish before continuing (slower): Unchecking this in our scenario wouldn't make sense, since we are expecting a result.
- Output Action Results: Select where you wish to store the output results of the App Routine.