Set-up workflow staging points for the Form starting with draft(optional), submit, approve, reject through to completion, by using the Workflow menu item.
The option also allows you to
- indicate if the attachments user control is to be made available in the footer and at what stage it should appear
- enable backward navigation
- control button display and button icons
- etc.
After selecting the Workflow option from the FAB workbench the below screen is presented without any data. To populate your requirements select a template.
After choosing one of the templates the screen is automatically updated with the information that best suits the template that you have chosen. This can then be edited according to specific requriements. In the below screenshot 'Draft and Submit' was chosen followed by 'One Level Approval' resulting in the data shown.
In the above screen the fields represent the following:
Current Status:
blank - form is on the screen but has not yet been saved
non blank - the form has been saved and it is at the 'Curent Status' stage
Action Text:
These are the words that display on the button e.g. 'Draft'
Agent Only:
This option allows the approver access to the form at the Current Status.
Owner Only:
This option allows the submitter access to the form at the Current Status.
UI5 Icon:
This is the small icon that displays to the left of the button text.
Button Type:
Emphasized = blue
Accept = green
Reject = red
Bypass Validations:
Tick this option to avoid the system doing validations. It may be useful when validations may not be required or when testing the flow only.
Go Back:
Tick this option if after completion of the form you want the screen refreshed to ......
Attachments:
Tick this option to indicate to FAB that the attachments option with icon must be made available in the footer of the form.
Validation Function:
The Validation Function allows you to enter a JavaScript function name, which must exist in a 'Script' element of the Form. This function is called when the Form is attempted to be submitted (if the ByPass Validations setting on the action is false). The function allows client-side validations to be performed before sending the data to the back-end. If the function returns false, the call to the back-end is aborted.
Generally, most validations are done on the back-end in SAP (via implementation class and method VALIDATIONS_ON_SAVE). This Validation function allows some checks to be made before sending the data to the back-end.
Success Function:
The Success Function is a JavaScript function which must exist in a Script element in the Form. The function is called after the call to the back-end is successful and allows a deviation from the default behavior (which is usually to exit the form) [if Go Back is true on the action].
Implement this function if you do not want to go back to the main menu when the action is successful, but rather go back to the previous Page and refresh the list on that Page. It can be useful where an app has two pages - the first one being a list, and the second the main detail page.
Step-by-step guide
Related articles
0 Comments