selectAction()
Last updated 17/01/2025
The selectAction() function will select an action to take place of the current action without leaving the current menu item.
To demonstrate
selectAction()
two processes will be created called Process A and Process B. A button will be added to Process A which will reference a
function that will select Process B. This is done by passing in the action ID for Process B into the selectAction()
function.
info
The Action Navigation application is created to demonstrate the
selectAction()
function, the creation of this application is documented in the Introduction chapter so you can perform the tutorial.Create Process A
1. Select Tasks in the menu.2. Select Processes in the sub-menu.
Figure 1 - Processes menu item
3. Click the Add Item button.
4. Type Process A in the Title field.
Figure 2 - Add Process A
5. Click the Screen Fields tab.
Figure 3 - Screen Fields tab
6. Click the Add Screen Fields button.
Figure 4 - Add Screen Fields button
7. Type This is Process A in the Caption field.
8. Click the lookup icon in the Display Type field and select _Label.
info
The label field is to help you to know where you are navigating as we go further in the action navigation documentation.
Figure 5 - Add This is Process A screen field
9. Click the Save button in the form app bar.
Figure 6 - Save button
10. Click the Save button in the form app bar above the list.
Figure 7 - Save button
Create Process B
1. Click the Add Item button.
Figure 8 - Add Item button
2. Type Process B in the Title field.
Figure 9 - Add Process B
3. Click the Screen Fields tab.
Figure 10 - Screen Fields tab
4. Click the Add Screen Fields button.
Figure 11 - Add Screen Fields button
5. Type This is Process B in the Caption field.
6. Click the lookup icon in the Display Type field and select _Label.
Figure 12 - Add the This is Process B screen field
7. Click the Save button in the form app bar.
Figure 13 - Save button
8. Click the Save button in the form app bar above the list.
Figure 14 - Save button
Create a Menu Item for Process A
A menu item needs to be created that references Process A.
1. Select Visual in the Menu.2. Select Menus in the sub-menu.
Figure 15 - Menus menu item
3. Click the Add Item button.
4. Type Process A in the Caption field.
5. Click the lookup icon in the Action field and select ProcessA (Process).
Figure 16 - Add Process A menu item
6. Click the Save button in the form app bar.
Figure 17 - Save button
Add the ToProcessB Function
The
ToProcessB()
function will use Five's inbuilt selectAction()
function on the Five
object and pass in the action ID for the Process B process.
1. Select Logic in the menu.
2. Select Functions in the sub-menu.
Figure 18 - Functions menu item
3. Click the Add Item button.
4. Type ToProcessB in the Function ID field.
5. Click in the Code field to open the Code Editor.
Figure 19 - Add ToProcessB function
6. Copy and paste the code block below into the editor.
note
The code block needs to be pasted over the boiler template that Five has created by default in the editor.
tip
'ProcessB'
passed into selectAction()
is the action ID for the Process B process!
Selects the Action ProcessB
function ToProcessB(five, context, result) {
five.selectAction('ProcessB');
return five.success(result);
}
Figure 20 - Save button
8. Click the Save button in the form app bar
Figure 21 - Save button
Edit Process A
Process A needs to be edited to add a button, this button will have an On Click event that will reference the ToProcessB function. When the button is clicked, Process B will be selected and the user will be navigated to Process B without leaving the Process A menu item.
1. Select Tasks in the menu.2. Select Processes in the sub-menu.
Figure 22 - Processes menu item
3. Select the Process A record in the list.
4. Click the Screen Fields tab.
Figure 23 - Screen Fields tab
5. Click the Add Screen Fields button.
Figure 24 - Add Screen Fields button
6. Type To Process B in the Caption field.
7. Click the lookup icon in the Display Type field and select _Button.
info
A _Button display type requires a function attached to the On Click event for the button to be functional.
Figure 25 - Add the To Process B screen field
8. Click the Events tab.
Figure 26 - Events tab
9. Click the lookup icon in the On Click field and select ToProcessB.
Figure 27 - On Click field
10. Click the Save button in the form app bar.
Figure 28 - Save button
11. Click the Save button in the form app bar above the list.
Figure 29 - Save button
How This Will Work in an Application
Once you deploy/run your application, you will be positioned on the Process A menu item which references Process A. Process A has the To Process B button that has the ToProcessB function attached to the On Click event, so that when the button is clicked the event will execute the function to select the Process B process.
1. Click the To Process B button.
Figure 30 - To Process B button
info
You will now be on Process B without leaving the Process A menu item.
Figure 31 - Process B