Help Center>Foundation Help

Applies to:

  • Winshuttle Foundation

5-1. Add approval and revision workflow loop

In this step we will add an Approval loop to the workflow.

On this page

  1. Add an Approval
  2. Create a view for form resubmission
  3. Add a cancellation check box

Prerequisite: Use the solution(s) you have created in in the previous phases of the tutorial.

Add an Approval

Back to top

  1. In Composer, click the Workflow tab.
  2. On the ribbon, click Loop Block.

  3. In the workflow Canvas area, click and draw to draw the loop. (This will open the New Loop Wizard.)
  4. Winshuttle Composer New Loop wizard
  5. In the New Loop Wizard, enter the following information:
  6. Winshuttle Composer New Loop wizard example
    • Name: The name for the Loop Block. Enter Master Data Approval Loop.
    • Approval Type: Click the arrow, and then select Sequential Approval from the menu.
    • Approver Swim Lanes: Click the arrow, and then select the Masterdata Swim Lane from the menu. Note: You can add multiple approver swimlanes.
    • Reject to Swim Lane: Click the arrow, and then select the Originator Swim Lane from the menu.

  7. Click OK. You should see a tab in the workflow Canvas named Master Data Approval Loop.

Create a view for form re-submission

Back to top

For the last part of this phase, features will be added to enable the originator to cancel a rejected request.

To do this, a new view called Resubmit will be added to the form. Then a group and checkbox will be added to the view so the form can be canceled by the originator if the form is not approved.

(To save some effort we'll simply duplicate the Originator View, rename the duplicated view to Resubmit, and then make the necessary additions to the Resubmit view.)

  1. In Composer, click the Form tab.
  2. In the Canvas area, on the view tab bar, right-click the Originator view, and then click Duplicate Orignator.

  3. Click the newly added tab to select it.
  4. In the Properties pane, on the Properties tab, type Resubmit for both the name and label of the new view.
  5. Tip: Change the Label first because the Name will be updated automatically with the appropriate underscore ( _ ) characters. This ensures there are no spaces in the technical name.

Add a cancellation check box

Back to top

In the last part, a cancellation checkbox and some formatting applied (for improved usability) to the Resubmit view created in the previous section.

  1. Make sure you are in the Resubmit view.
  2. On the ribbon, click New Group, and then click No, this View Only.
  3. The new added group appears at the bottom of the form. Scroll to the bottom of the form, right-click the new group, and then click Move Up. Repeat this until the new group is located just above the Requester Information group, as shown below:

  4. Click the new group added in the previous step. In the Properties pane, under General Settings, type Cancel Request in the Label. (The Name will automatically update). Then set the following properties under General Settings:
    • Read Only: Set to False.
    • Show Labels: Set to True.
    • Columns: Set to 1.
    • Show Header: Set to True.
    • Collapsible: Set to Non-collapsible.
    • Tip: You can change the name and label at the same time by clicking Group Label (click to Edit) in the group name.

  5. In the Properties pane, click Elements.
  6. Make sure the Cancel Request group is selected, and then click Checkbox.

  7. In the form Canvas, click the newly added checkbox.
  8. In the Properties pane for the checkbox, under General Settings, set the properties for the checkbox as follows:

    Tip: Change the Label first, and the Name field will be updated automatically with the appropriate underscore ( _ ) characters added.

    • Name: Enter Do_you_want_to_cancel_this_request?
    • Label: Enter Do you want to cancel this request?
    • Column Span: 1
  9. Click the checkbox. Under General Settings, set the following properties:
    • Required: False
    • Read Only: False
  10. To make the cancellation text more noticeable, we will increase the size of the text. Click the text to select it.
  11. On the ribbon, click the Grow Label Size icon 3 times.

    The end result should look something like this:

  12. Save your work.
  13. Click on the Workflow Tab, and then select the Master Data Approval Loop.
  14. Click the Activity node that was automatically placed in the Originator swimlane. Name the Activity Resubmit.

  15. Scroll down the properties. Under the Form heading, assign the newly created view to the Resubmit activity.

  16. Click anywhere on the Master Data Approval Loop canvas, and then click [...] to open the Condition for the loop.
  17. Notice that Composer automatically creates a condition for the loop to end based on selections made in previous steps, i.e. the loop will end when the Master Data approval task is approved.
  18. Add another condition that cancels the request and process if the Originator checks a box to cancel the request. To do this, click in the box, and then choose the ‘Or’ Operator.
  19. Choose the field named Do_you_want_to_cancel_this_request_form. Add the Equal operator and set the type to true.

  20. Save, deploy and test the solution.