Versions Compared

Old Version 1

changes.mady.by.user Megan Ellis

Saved on

compared with

New Version 2

changes.mady.by.user Megan Ellis

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Approval workflows are everyday actions that businesses perform on a routine basis. This tutorial will show how easy it is to create an Approval Workflow using . We will use an example of a services Purchase Order workflow to demonstrate design patterns and  features. If you need basic help using the Workflow Designer, please refer to the Build a Workflow guide, and then return here.

...

What are we going to build?

Many companies offer software services to their new and existing clients. This tutorial will produce a Purchase Order workflow for services that follows this business scenario:

  • A sales person accesses the company's Purchase Order form, fills in the customer's email address and other required information, signs it and clicks Continue.
  •  sends a customized email to the customer that contains a link to the PO.  
  • The customer clicks on the link, reviews the Purchase Order, approves and signs it or sends it back to the company for corrections
  • The workflow is routed back to the sales person.
  • The sales person reviews the PO, and sends it to his manager for approval. The manager receives an email.
  • The manager clicks on the link in the notification email, logs onto to review the PO via the Task List. He approves or sends it back to the sales person for corrections.
  • If approved by the manager and the total amount of the PO is greater than $10,000.00, the workflow is routed to the VP for final approval.

What You Will Need

You need either a frevvo Online account (request a demo if you don't already have an account), or afrevvo On Premise software installation. If you are using On Premise software you will also need to create a tenant, add a designer user to that tenant and configure email. 

...

  1. Click the add new user icon which will bring up the Add New User form

  2. Enter "jim" as the User Name then enter all the required information.

  3. Leave the Reports To field empty. 

  4. Select VP from the Role dropdown. Click Submit.

  5. You should be back on the user list. Logout. 

Create a frevvo

...

Portal

A space portal is a built-in portal website that's very simple to create and makes it easy to test your forms and workflow(s). We will create a space  portal to test the remaining examples. The Task Notification emails for the remaining Purchase Order examples will send the user to their Task List in your spaceportal.

Info
titleDefault Space

The Tenant Admin can set a Default Space Portal on the Manage Tenant page. Task Notifications will then link the user directly to their task or task list in your Default Space portal without the need to configure the URLs in the workflow properties.

  1. Login to your tenant as the designer user.
  2. Open the Workflow Tutorial project.
  3. Find the Purchase Order Workflow in the list.
  4. Click the  Action Menu and select  Deploy to remove the development watermark and deploy your workflow to production.
  5. Click the Spaces Portals link at left. Click the  Add icon.
  6. Enter a Space Portal Id i.e. workflowtutorial and a Space Portal Name i.e. Workflow Tutorial Space Tutorial Portal and click Create. You will be directed to the Space Portal Editor. Click Save. 
  7. From the Action Menu, select Share. Copy the URL, paste it into a new browser window, and bookmark it. We will use it in Step 9 below.

We will add our workflow to the space portal a little later.

1 - Create the Workflow

...

  1. On the Client Approval step, click the Assignment tab. Remove your email and enter the template {ClientEmail} into the Assign to Email property. ClientEmail is the field in Step 1 where the sales person enters the email address of the customer.   sends  the PO to the email address entered in that field. This is an example of a template. Note the control name is encased in curly braces. Type the subject for the email - "Purchase Order from frevvo". Copy the text below into the message field to replace the existing message. This is the email the customer receives.

    Code Block
    {ClientName},
<br/><br/>
Please review and sign this Purchase Order from frevvo Inc. by clicking on <a href="{task.perform.url}">this link</a>.
<br/><br/>
Thank You.

  2. Click the Sales Review step and notice that you remain on the Assignments tab. Type {SalesID} in the Assign to User property on the panel. To customize the task notification email the sales person receives: 

    1. Type "Review PO from {ClientName}" in the subject field.  

    2. Leave the default message. 

      Info

      If a Default SpacePortal has been set, {task.perform.url} will send the user to the task in your space portal and you do not need to customize the URL.

      Optional (if no Default Space portal Set): Click on the Assignment Tab. Do not make any changes to the Subject under Task Notification Email instruction. In the Message field, replace the {task.perform.url} template with the URL to the Space Portal we created above. Make sure the space portal URL is included between the double quotes. Append /tasklist to the end of the URL. The message shown below will send the user to their Task List in a space portal with an id of workflowtutorial.

      Code Block
       You can access your task by clicking <a href="https://app.frevvo.com:443/frevvo/web/tn/mycompany/u/85a7dee1-e4cc-4c31-bcc6-d6929fb4d2b2/spaceportal/workflowtutorial/tasklist">this link</a>

  3. Click the Manager Approval Step. Type "{subject.reports.to}" in the Assign to User property. Type "Approval needed for PO from {ClientCompany}" in the Subject field. Leave the default message, or customize as described above.

  4. Click the VP Approval Step. The role you set in the Workflow Design Wizard is still correct. To customize the task notification email the VP receives, Type "VP Approval needed for PO from {ClientCompany}" in the Subject field. Leave the default message, or customize as described above.

...

Let's set up the permissions on the workflow, the user experience after they click "submit", and an email that will automatically send a PDF snapshot of workflow to the Salesperson and Client when the workflow is complete. We will also configure Searchable Fields so we can search and filter our submissions in the frevvo Submissions repository.

Access Control

Change the visibility of the workflow to public so the customer (anonymous user) can access it. To do this: 

  1. Go to the Settings editing mode.

  2. Click the Access Control tab.

  3. Under Who can start the workflow check the radio button for 'Anyone (login not required)'.

Note

The Workflow Visibility does not have to be set to Anyone (login not required) when you have a step in your workflow that is assigned to an email address and is performed by an anonymous user. Any of the Workflow Visibility options will work.

Set up Searchable Fields

In order to be able to use data from the PO workflow to search submissions and tasks, we will define the fields that we want to use as search criteria using the Setup Searchable fields wizard. For example, if we define the control named ClientCompany as a searchable field then we can search for Purchase Orders that were submitted by a particular company. 

  1. In Settings editing mode, click the Searchable Fields tab.

  2. Minimally, move the Client Company, Client Name and Total Amount fields from the Available Fields column to the Searchable Fields column. Add/remove any other fields that you want to define as Searchable Fields.

Image Modified

Workflow Actions

The Workflow Actions customize the message(s) the client will see when they click the Send to frevvo, Inc button.

...

Go to the Action Menu in the top right and select  Save and Close.


7 - Add Workflow to

Space and

Portal and Test

Before we test, let's add the workflow to the space portal you created above. 

Add Workflow to

Space

Portal

  1. From the Forms & Workflow list, click the  Action Menu for your workflow and select Share.
  2. Click Raw form/workflow link to display the raw URL. Copy the portion of the URL starting with /frevvo/... (this is the relative URL)
  3. Go to the Spaces Portals tab and edit the space portal you created earlier.
  4. Click Edit on the Space portal Tabs.

  5. Add a Tab by typing * Workflow Tutorial into the Edit Space portal Menu dialogue. 

    Code Block
    * Workflow Tutorial

  6. Add your workflow to the tab by typing ** Purchase Order Workflow | <your relative raw URL>

    Code Block
    ** Purchase Order Workflow | /frevvo/web/tn/example/u/8e31e94a-cec0-4544-84fd-e7cd21c75512/app/_qJzwYdPwEemwR6ZLVqxI8w/flowtype/_FwuVYPp6EemxPqwlgCNmrA?_method=post&embed=true

  7. Save your Spaceportal.

Test the Workflow

  • Click the link to your space portal that you bookmarked earlier. Login as the designer.

  • Select the Purchase Order from the Workflow Tutorial tab.

  • Fill in the PO with a Total Amount value that is equal to or greater than $10,000.00. Sign as the sales person. Click the Send to client button.
  • Log out of your spaceportal.
  • Check the email account for the customer. Access the email with the subject "Purchase Order from frevvo", click the link provided.
  • Approve and sign the PO as the customer. 
  • Click the Send to frevvo, Inc button.
  • Log into your  space portal as the designer@<your tenant>. Select Task List from the Important Items tab.
  • Click the Perform icon. Review the PO then click Send to Manager. Logout of your spaceportal.
  • Login to your space portal as jerry@<your tenant>. Select Task List from the Important Items tab. 

  • Click the Perform icon. Add a comment and sign as the manager. Click Finish or Send to VP. Logout of your spaceportal.

  • Login to your space portal as ed@<your tenant. Select Task List from the Important Items tab
  • Click the Perform icon. Add a comment and sign as the VP. Click Finish. Logout of your spaceportal.
  • The sales person (designer) and the customer will receive an email with the signed PO. Check the PDF to make sure the VP approval is included.
  • Run the workflow again with a Total Amount that is less than $10000.00. The workflow is finished after the Manager Approval step.The sales person and client receive an email with the signed PDF.

...

What happens if the manager or VP need more information or corrections made to the PO before approving? They can send the PO back to an earlier step by clicking the reject button. When a task is rejected, the user who it is being sent back to receives an email informing them of the reason for the rejection.

The  designer configures which steps display a Reject button via the Setup Approval/Rejection wizard. Simply check/uncheck the Reject to here or Reject from here checkboxes for each step in the workflow. The reject button label can also be modified on any step. 

You can reject from or to a step performed by an anonymous user (our Client Approval step). For example, clicking the Reject button on this step allows the customer to send the PO back to the sales person (designer) for corrections. Once the corrections are made, the workflow is sent back to the customer for another review and the workflow continues to completion if the customer approves.

Modify the Workflow 

Log into your tenant as the designer user. Edit the Workflow Tutorial project, then edit the Purchase Order Workflow. You can change the button label on any step where Reject from here is checked.

  1. Click the PO step then click on the Rejection tab in the Step Properties wizard.
    1. Check "Reject to here" and uncheck "Reject form here". Since this is the first step in the workflow, there are no steps before it to reject to. If you leave it checked, it will be ignored.
  2. Click the Client Approval step. 
    1. Check Reject to here and Reject from here.
    2. Change the Reject Button Label to "Send PO back for revision".
  3. Click the Sales Review step. You will still be on the Rejection tab.
    1. Check Reject from here and Reject to here.
  4. Click the Manager Approval step. You will still be on the Rejection tab.
    1. Verify that Reject from here and Reject to here are checked.  The manager can reject the workflow back to the sales person and the VP can reject the workflow back to the manager step.
    2. Change the Reject Button Label to "Reject PO".

    3. Optional (if no Default Space portal is set.): Replace the {task.perform.url} template in the Rejection email body to the URL of your  space portal with /tasklist appended to it. Here is an example.

      Code Block
      languagexml
      titleReject Email Message
      <p>This workflow was rejected back to you for further action.</p><p>The workflow was rejected by {subject.first.name} {subject.last.name} at step: {flow.activity.name}. The reason was: {flow.activity.reject.reason}.</p><p>
You can access your task by clicking <a href="https://app.frevvo.com:443/frevvo/web/tn/mycompany/u/85a7dee1-e4cc-4c31-bcc6-d6929fb4d2b2/spaceportal/workflowtutorial/tasklist">this link</a></p>
      Info

      If a Default SpacePortal has been set, {task.perform.url} will send the user to the task in your space portal and you do not need to customize the URL. This also applies to the instructions below.

  5. Click the VP Approval step. You will still be on the Rejection tab.
    1. Check Reject from here and uncheck Reject to here.  Since this is the last step in the workflow, there are no steps after it that can reject back to it. If you leave it checked, it will be ignored.
    2. Change the Reject Button Label to "Reject PO".

    3. Optional (if no Default Space portal is set.): Replace the {task.perform.url} template in the Rejection email body to the URL of your  space portal with /tasklist appended to it. Here is an example.

      Code Block
      languagexml
      titleReject Email Message
      <p>This workflow was rejected back to you for further action.</p><p>The workflow was rejected by {subject.first.name} {subject.last.name} at step: {flow.activity.name}. The reason was: {flow.activity.reject.reason}.</p><p>
You can access your task by clicking <a href="https://app.frevvo.com:443/frevvo/web/tn/mycompany/u/85a7dee1-e4cc-4c31-bcc6-d6929fb4d2b2/spaceportal/workflowtutorial/tasklist">this link</a></p>
  6.  save your changes.
  7. Logout of your  tenant.

Test the Changes

  • Click the link to your space portal that you bookmarked earlier. Login as the designer user.

  • Select the Purchase Order from the Workflow Tutorial tab.

  • Fill in the PO with a Total Amount value that is equal to or greater than $10,000.00. There is no Reject button on this step. Sign as the sales person. Click the Send to client button.

  • Log out of your spaceportal.

  • Check the email account for the customer. Access the email with the subject "Purchase Order from frevvo", click the link provided.

  • Notice the reject button with the label Send PO back for revision. Click on this button.

  • Click the down arrow for the To dropdown on the Rejection screen. Select the step in the workflow to send the workflow back to - in our case - PO - (designer) who is the sales person.
  • Provide an explanation for rejecting the PO in the Reason box. Click Submit.
  • The message "Task successfully rejected" displays.
  • Check the email for the sales person (designer user). Notice the email with the title "You have a new task for Purchase Order Workflow". This is the Rejection email.
  • Open this email. The step of the workflow where the rejection was performed and the reason for the rejection is shown in the body of the email. Click the link to the workflow embedded in the rejection email. The rejection email subject and body can be customized to reflect whatever you want to say.

  • Log into your space portal as the sales person (designer user). The Sales Person's (designer user) Task List displays. Click the Perform icon, review the PO, make a change, sign then click Send to client. Logout.

  • Check the email account for the customer. Access the email with the subject "Purchase Order from frevvo", click the link provided.
  • Approve the corrected PO, sign and click the Send to frevvo, Inc button.

  • Login to your space portal as the sales person (designer user). Select Task List from the Important Items tab.  Click the Perform icon. Review the PO. Click Send to Manager. Logout.

  • Login to your  space portal as jerry@<your tenant>. Select Task List from the Important Items tab. Click the Perform icon. Notice the Reject PO button on this step.

  • Approve the PO as the manager, sign then click Finish or Send to VP. Logout.

  • Login to your  space portal as ed@<your tenant>.  Select Task List from the Important Items tab.  Click the Perform icon. Notice the Reject PO button on this step.

  • Click Reject PO. A list of steps that you can send the task back to displays when you click the down arrow in the To dropdown. In this example, the VP can reject the task back to the manager Jerry or the sales person (desiger user).

  • Select Manager Approval (jerry) from the dropdown then fill in a reason for the rejection - "Does this project conflict with the Sales Conference in LA". Click Submit. The message "Task successfully rejected" displays.

  • Click theInbox icon. The task is removed from the VP's Task List. Logout.

  • The manager receives an email with the subject "You have a new task for {your workflow name}". Note the reason for the rejection is included in the email body. Click the link in the Rejection email.

  • Login to your space portal as jerry@<your tenant>. The Sales Person's (designer user) Task List displays. Click the Perform icon. Change the comment to inform the VP that the project does not conflict with the conference. sign and click Finish or Send to VP. Logout.

  • Login to your space portal as ed@<your tenant>. Select Task List from the Important Items tab. Click the Perform icon.

  • Approve, sign then click Finish. Logout. The sales person (designer) and the customer will receive an email with the signed PO.

...

The Save/Load property adds a Save button to a workflow step. If the sales person cannot complete the PO in one session, they can partially fill the purchase order form, save it, then return to complete it at a later date. We will add the Save button to the PO step in this example. Also, we will take this opportunity to view the audit trail - a  feature that is available for any task in the Task List. The audit trail is very useful when you want to view the task's history.

Modify the Workflow

  1. Login to your tenant as the designer user.
  2. Edit the Workflow Tutorial project, then edit the Purchase Order Workflow.
  3. Go to Settings mode in the Guided Designer navigation bar. Check the Save/Load property. 


  4. Go to Workflow editing mode in the Guided Designer navigation bar. Click the PO Step.
  5. Check Saved to the Task List.
  6. Change the label of the Save button by typing "Save for Later" in the Save Label field. 
  7. Repeat steps 4, 5 and 6 for the Sales Review, Manager and VP Approval steps.
  8. Click on the Client Approval step. Verify that the Save/Load property is unchecked.
  9.  save your changes.  
  10. Logout of the workflow designer.

Test the Changes

  • Click the link to your space portal that you bookmarked earlier. Login as the designer user.
  • Select the Purchase Order Workflow from the Workflow Tutorial tab. Fill in a few fields on the PO. Note the Save button is added.
  • Click Save for Later. The "Save successful" message displays.
  • Click Task List on the Important Items tab.
  • Since the sales person only has one task in the Task List, the saved task will display. However, if you have many tasks in the list and you only want to see the partially completed ones, click the Saved Task icon at the top.
     
  • Click the Perform icon. Fill in some more fields. Click Save for Later.
  • You can click the Save button as many times as you want. Clicking the view task history icon will show the audit trail for the task. You will see an entry for each time the task was saved. The task shown in the image was saved 3 times and is currently locked by the sales person (max).

  • When all the fields in the PO are filled in, click Send.
  • Run the rest of the workflow as described in the previous examples. You will see the Save button on any of the steps that require the user to log into .

10 - Save to User

Manager Jerry is going to the Sales Conference in LA. As he is preparing to leave the office, a PO requiring his approval comes in. Example 9 will show you how Jerry can quickly reassign the PO to another manager, Sue, so he can leave for the conference.


Modify the PO Step

  1. Login to your tenant as the designer user.
  2. Edit the Workflow Tutorial Project, then edit the Purchase Order Workflow.
  3. Click the PO step, then go to the Forms editing mode.

  4. Add a text control named "ManagerID" with a label "Manager ID" to the Sales Information Section. Uncheck the Visible property. 

  5. Drop a Dropdown control under the Manager Approval Section. Change the Decorator property to the blank option in the Decorator dropdown on the Properties panel.
  6. Set the label and name of the control to "Managers".
    1. Uncheck the visible property

    2. Add two managers to the dropdown control's Option's property. The option syntax is value=label. Value must be the manager's  username and the label can be a more user friendly label such as the manager's first and last name.   

      jerry=Jerry Mouse
      sue=Sue Blue 

  7. Click the Properties Style tab and set the control width to half the width of the form.
  8. Drop a Message control to the right of the Managers dropdown.

  9. Add this text to the message control's Message property.

    Code Block
    To reassign your approval task to another manager, select that manager from the Managers dropdown and click the Save button.
  10. Set the Name property to ReassignMsg. Uncheck the visible property

Modify/Add Rules

We will create a rule that show the Manager Dropdown and the reassign Message controls only when the workflow is on the Manager Approval step.

  1. Go to the Rules editing mode.

    Expand
    titleClick here to see how to create this rule

    The Visual Rule Builder consists of 3 wizards:

    • Condition wizard - describe the conditions under which a set of actions should be executed
    • Action wizard - declare the actions that should be taken when the condition is true
    • Else Action wizard - declare the actions that should be taken when the condition is false
    1. Find the rule named "On Approval Step (Manager Approval)" and edit it.
    2. Click on any action to open the Visual Rule Builder.
    3. Click Add Action - this is the Action wizard where you set up actions that will happen if the condition is true
    4. Set the Managers control to visible
    5. Add another action to set the Reassign Message control to visible
    6. Click Next then click Add Action - this is the else action wizard where you set up actions that will happen if the condition is false
    7. Set the Managers control to hidden
    8. Add another action to set the Reassign Message control to hidden
    9. Click Finish

  2. Edit the rule "Populate Sales Person" and add this action line under the SalesID to userID() line:

    Expand
    titleClick here to see how to Modify the Populate Sales Person Rule
    1. Click the on the Set SalesID to userID().
    2. Click Add Action
    3. Select ManagerID from the first dropdown
    4. Select to from the second dropdown
    5. Type user in the Expression box - a list of Rule Builder functions for User details will display
    6. Scroll down and select the userManagerID function.
    7. Add the closing parenthesis and tab out of the Expressions box.
    8. Click Finish

  3. Add a new rule to copy the selection from the Managers dropdown into the ManagerID control. Remember we have set up the ManagerID template to route this step of the workflow to the user name specified in the ManagerID control.

    Expand
    titleClick here to see how to create the rule in the Visual Rule Builder

    The Visual Rule Builder consists of 3 wizards:

    • Condition wizard - describe the conditions under which a set of actions should be executed.
    • Action wizard - declare the actions that should be taken when the condition is true.
    • Else Action wizard - declare the actions that should be taken when the condition is false.
    1. Click the to add the rule.
    2. Name it Reassign to User
    3. Click the Rule Builder button then click Add Condition - this is the Condition wizard
    4. Select Managers from the first dropdown.
    5. Select is filled from the second dropdown
    6. Click Next then click Add Action - this is the Action wizard where you set up actions that will happen if the condition is true
    7. To set the value of the ManagerID control to the value of the Managers control:
      1. Select ManagerID from the first dropdown.
      2. Select to from the second dropdown
      3. Begin typing "man" in the Expression field. A list of the fields in the workflow that begin with the letters "man" display. Select the Managers field from this list.
    8. This rule does not require an else action. Click Finish

  4. Save your changes.

Modify the Workflow

  1. Click the Manager Approval step.
    1. On the General Setting tab, check the Save to User property and verify that the Save/Load property is checked. 
    2. Change the label of the Save button to Save.
    3. On the Assignment tab, change the User property from {subject.reports.to} to {ManagerID}  - this must now be set to a dynamically populated control in the PO form.
  2. Save your changes.


Test the Changes

  • Test the workflow to the step for Manger Approval
  • When performing the task from Jerry's Task List, select the other manager (sue) from the Manager's dropdown. You do not have to sign it.
  • Click the Save button. The task will be removed from Jerry's Task List.
  • Login as the other manager (Sue). The PO Manager Approval task is now on her task list.
  • Perform that task. The workflow will be routed to the VP if the amount of the PO is greater than or equal to > $10,000.00.  If the amount is under $10,000.00, the workflow will complete.

11 - Save to Role

In some cases, you may want multiple actions taken during a step in the workflow. Let's say you want to collect comments about the PO from more than one VP in the company. The PO can be routed to the first VP (Ed) who will comment, click Save and the approval task will be assigned to the Task List of all users with the VP role. A second VP can then perform the task from their Task List add their comment, click Save. The last VP to comment signs to complete the workflow.

In this example, we will drop the comment control in the VP section of the PO into a repeat control so more than one manager can comment and add some message controls to clarify the instructions. Our workflow must use the Save to Role feature so the saved task is assigned to all users with the VP role that we specified for the VP step. 


Modify the PO Step

  1. Login to your tenant as the designer user.
  2. Edit the Workflow Tutorial Project, then edit the Purchase Order Workflow.

  3. Go to the Forms editing mode.

  4. Drop a Message control inside the VP Approval section above the VP Comments text area.

  5. Put the following text into the message control's Message property 

    Code Block
    If you want another VP to comment:
        <ol>
        <li>Add your comment below</li>
        <li>Click the save button to return this PO onto the task list of all employees with the VP role</li>
       </ol>
       Other VPs can add comments by clicking the + icon.

  6. Drop a Message control inside the VP Approval section, below the VP Comments text area

    1. Select "Warning" from the Message Type dropdown.

    2. Put the following text into the message control's Message property. 

      Code Block
      The last VP to comment must sign the approval.

  7.  Click the Comments control inside the VP Approval section

    1. Type "Enter both your name and comments" into the Placeholder property

  8. Drop a Repeat control inside the VP Approval section immediately above the VP Comments text area.

  9. Drag the VP Comments text area into the repeat control
    1. Click to select the VP Comments text area control
    2. Set the Min property to 0
    3. Set the Max property to 4
  10. Click on the VP Approval section
  11. Type f-page-break in the CSS Class property for the VP Approval section. This css class will put the VP Approval on a new page in the workflow PDF.
  12. Save your changes.

Modify the VP Approval Step

  1. Click the VP Approval step
    1. Check the Save to Role property.
    2. Verify that the Save/Load property is checked.
    3. Change the label of the Save button to Save.
  2. Click the  save and close icon to save the changes to the workflow. 

Test the Changes 

  • Test the workflow to the step for VP Approval. Be sure to make the amount of the PO greater than or equal to $10,000.00 so the workflow navigates to the VP step.
  • You should be logged in as the user, ed for the VP step.
  • Add a VP Comment. Do not sign it.
  • Click the Save button. Logout. Notice the task remains on Ed's Task List. All users with the VP role will receive a task notification letting them know the PO is available on their tasks lists again. For this example, users ed and jim receive a Task Notification email.
  • Login as the other VP user (jim) and view Jim's Task List
  • Perform the task.
  • Click the icon to add another comment and sign the section.
  • Click Finish.
  • Logout of your spaceportal.
  • Check the workflow PDF attached to the final email. Verify that the VP Approval section is on a new page in the PDF.

12 - Workflow Escalation

If workflow tasks are not completed within a certain specified time, you can remind the user via an email(s) that there is a deadline for task completion and you can reassign the task to another user when the deadline expires. In this example, we will use the Escalation feature to set a five minute deadline for manager Jerry to approve the PO. He will receive two emails in that time frame reminding him that he has a task that requires his attention. When the five minute deadline expires, Jerry will receive an email informing him that the task has been reassigned to manager Sue. 


Modify the Workflow

  1. Login to your frevvo tenant as the designer user.

  2. Open the Workflow Tutorial project, then edit the Purchase Order Workflow.

  3. Click the Manager Approval step and select the Escalations tab.
  4. Set up the Deadline:
    1. Click on the Add Escalation button

    2. Select Complete Within from the dropdown in the Condition field. Enter "5" on the minutes box that displays.

  5. Setup the Reassignment:
    1. Click on the Action tab. Select the Reassign Task option.
    2. Select "User" from the Reassign To dropdown. Type "sue" in the Select User Assignee's text box. Note the list of users that begin with the letter s displays as you type.
  6. Setup the email that will inform Jerry that the deadline has expired for the PO task. 
    1. Click on the Notifications Tab. Change the No Notification slider to on.
    2. Select "Current Owners" from the Send To dropdown. Current Owners will notify users who currently have the task on their Task List via email.

    3. Replace the template {flow.activity.assignee} with {flow.activity.escalation.reassignee} in the Email message. This change will put the name of the manager the task was reassigned to (Sue) in the message to Jerry. 

  7. Setup the Reminder emails to be sent. For Example, we want a total of two reminder emails to be sent  - one every two minutes during the 5 minute time period.  

    1. Click on the Reminders Tab. Change the Reminders are Off slider to on.

    2. Enter "2" in the Every text box. Select "Minutes" from the Time Unit dropdown.

    3. Slide the  "Limit Reminder" to on.  Enter "2" in the Occurrences(s)  text box.

    4. Leave the text of the Reminder message at the default.

  8. Click the  save and close icon to save the changes to the workflow.

...

Test the Changes:

  • Test the workflow to the Client Approval step. Approve the PO.
  • Logon as the sales person (designer).
  • Click the Important Items tab then click the Task List.

  • Click the quick view icon. The Quick Approval screen will display.

     

  • If the client did not approve the PO and sent it back to frevvo with comments, the Sales Person can click the Details button to view those remarks.
  • Notice the text we added as the Quick Approval summary appears at the top.
  • Add a comment and click Approve. You will see the message "Task Successfully Approved".
  • Notice the Sales Approval section displays on the Sales Review, Manager and VP Approval steps.
  • Complete the workflow.

14 - Page Break for Mobile

What do you have to do to run the PO workflow on a tablet or smartphone? Nothing!  automatically breaks up the form into steps and adds Back and Next buttons.  uses the device’s features, such as specialized keyboards, to create a user-friendly mobile experience. 

You can use the PageBreak control to customize the mobile page breaks on the PO step into small logical pieces. For example, our PO has Instructions, Sales Information, Client Information and Client Services Order sections. In this example, we will use the PageBreak control to display the Instructions, Sales and Client Information sections on the same screen on a tablet and and on two separate screens on a smartphone. We will add another PageBreak control to display the Client Services Order section on a separate screen on both devices.

Modify the PO Step

  1. Login to your frevvo tenant as the designer user.

  2. Open the Workflow Tutorial project, then edit the Purchase Order Workflow.

  3. Go to the Forms editing mode.
  4. PageBreak controls in your workflow display by default. If you want to hide them while you are developing your workflow, click the show/hide page breaks icon in the action menu.
  5. Drag a PageBreak control from the palette and drop it below the Sales Information section. Click on it and uncheck Tablet. This PageBreak control will only be recognized on a smartphone. 
  6. Drop a PageBreak control from the palette and drop it between the Client Information and Client Services Order sections.

  7. Leave the Phone and Tablet checkboxes checked.

  8. Click the  save and test icon. The Save and Test feature saves the changes to your workflow and allows designers to test forms/workflows without leaving the Workflow designer.   

Test the Changes

  1. When you click the  save and test icon, you will see the desktop view. The Instructions, Sales Information, Client Information and the Client Services Order sections display on the same screen. 

  2. Click the Tablet icon at the top. The Instruction, Sales Information and Client Information display on the same screen, as expected, since the first PageBreak was setup to be recognized on the phone and not the tablet. The second PageBreak was setup to be recognized by the phone and the tablet so you will have to click Next, to see the Client Services section.

  3. Click the Phone icon at the top. You will see the Instructions and Sales Information sections only. The first PageBreak was setup to be recognized on the phone so you will have to click Next, to see the Client Information section.  The second PageBreak was setup to be recognized by the phone and the tablet so you will have to click Next, to see the Client Services Order section.
  4. Close the Test window. Click the  save and close icon to save the changes to the workflow.

Feature - Screenflow & Fast Finish (Employee Onboarding Workflow)

In this example, we will switch to an Employee On-boarding workflow to demonstrate the Fast Finish feature that allows the user to fast forward through a screenflow. A screenflow is a type of workflow where all the steps are filled in by the same user. Fast Finish is very useful if your screenflow contains a lot of steps. Let's consider this scenario:

A new employee starts their first day at your company and needs to provide their information. The employee is handed an iPad with a link to an Employee Onboarding workflow that is used to collect basic information, W-4 allowances and Education information. When completed, the new employee clicks the Continue button and the workflow is routed to their manager for approval. If approved by the manager, the workflow is routed to HR for final processing.

Imagine the employee completes the workflow through the Confirmation step and then decides to navigate back to make a change to the Employee Information step. Without a fast finish button the screenflow will make the user review each step (Employee Info, W-4, Education Info and Confirmation) in order to submit the forms to the manager for approval. Adding Fast Finish allows the new employee to click on the Finish button and (if all required fields are complete and valid in all other workflow steps) immediately submit the forms to the manager for approval.

We will use the Navigation toolbar at the top to navigate back and forth between the steps of the workflow. We will configure Fast Finish on the first three steps. We will also need to add another role, HR and another user, Pam who has the HR role, to test it.

Add a Role and User

  1. Login as your tenant admin.

  2. Create a new role -  HR.

  3. Add a new user pam and give her the role HR. Logout.  

Review the Workflow

  1. Login as the designer.  Open the Workflow Tutorial project.
  2. Edit the Employee OnBoarding workflow.
  3. Click on the Employee step.
    1. Notice the Fast Finish property is checked in General settings on the Property panel.
  4. Click on the Allowances step.
    1. Notice the Fast Finish property is checked in General settings on the Property panel.
    2. Notice the Task Assignment is empty. Since this step is unassigned, it will function as a screenflow and be performed by the user who completed the previous step.
  5. Click on the Education step.
    1. Notice the Fast Finish property is checked in General settings on the Property panel.
    2. Notice the Task Assignment is empty. Since this step is unassigned, it will also function as a screenflow.

  6. Click cancel changes icon to exit back to the Form and Workflows Home Page.

Test this Feature

  1. Click the  Test icon for the Employee OnBoarding Workflow.

  2. The Employee Information step prefills the user name and uses the Geo-location feature to capture the user's location.  All browsers will show a pop up asking the user's permission to use their location. Click  to give permission.

  3. Fill in the other required fields. Click Continue.

  4. Fill in the W-4 Allowances. Notice the Total Allowances field is updating as you enter values for the other allowances. this calculation is done using a business rule. Sign then click Continue.
  5. Fill in the Education Information step. Notice if you check "yes"  for the "Permission to access college transcript" question a table requesting additional information displays. This is controlled by a show/hide business rule. Click Continue.
  6. On the Confirmation step, click Review Your W-4 form. The W - 4 will open in a separate browser tab merged with the data you entered.  This is an example of the  Pixel-perfect PDF generation feature.
  7. While reviewing the PDF, you realize you made a mistake when entering your social security number.  Close the PDF. 
  8. Click the Employee Information step in the Navigation toolbar at the top.
  9. Make a change to the SSN. Click the Finish button.
  10. The workflow will skip the Allowances and Education information steps and return you immediately to the Confirmation step.
  11. Review the PDF to verify the updated SSN is now displaying. Close the PDF.
  12. Sign then click Send to Manager.
  13. Logout as the designer.
  14. Login as Jerry. Perform the task. Add a comment and sign. Click Send to HR.
  15. Logout as jerry.
  16. Login as Pam and complete the workflow. 
  17. Logout of .

Feature - Summary Step

In this example, we will look at the Summary step on the Employee On-boarding workflow. This will simply display a Summary view of all the data that has been entered into the various steps of the workflow prior to the Summary step. Previously completed steps in a workflow can be viewed by all users but editing data is only allowed for the currently logged in user. Clicking on the Details button navigates to the selected step for viewing/editing. 

We will change the Navigation property to a different format and use the Summary step to navigate back to a previous step.  

Review the Workflow

  1. Login as the designer.  Open the Workflow Tutorial project.
  2. Edit the Employee OnBoarding Workflow.
  3. Click on the toolbar to display the workflow properties.
  4. Click the Summary Fields tab on the Properties panel. Designers select the workflow fields to display in the Summary step using this wizard. Note most of the fields in the workflow have been selected to display in the Summary Step.
  5. Clicking on the Searchable fields tab shows the First and Last Name fields in Step 1 have been setup as Searchable Fields. They can now be used as search criteria when searching submissions.
  6. Notice the Summary step between the Education and Confirmation Step. The Summary step displays the fields selected with the Setup Searchable and Summary Fields wizard and all the data that has been entered into these fields prior to the Summary step. Clicking on the Details button navigates the user to the selected step for viewing/editing.

  7. Click cancel changes to exit back to the Form and Workflows Home Page.  

Test this Feature

  1. Click the Test icon for the Employee OnBoarding Workflow.
  2. On the Summary step, click the Details button on a previous step to view the entered data.
  3. Change a value in one of the fields.
  4. Click the Continue or Finish button on the rest of the steps.
  5. Complete the workflow.

Feature - Save on Navigate

Imagine a large workflow with many steps - let's say 30. You are filling in the screens and when you get to screen 25 you accidentally close your browser! None of the entered information is saved and you will have to begin all over again. The Save on Navigate feature will prevent this situation by automatically save the workflow to your Task List. When you click the Perform icon to open up the task returns you to the last step where data was being entered. If you navigate to previous steps, all entered data displays.

Review the Workflow

  1. Login as the designer.  Open the Workflow Tutorial project.
  2. Edit the Employee OnBoarding workflow.
  3. Click Settings in the Guided Designer toolbar to display the workflow property panel. Notice the Navigation property is set to Navigation Toolbar and the Save on Navigate checkbox is checked to turn the feature on.

  4. Click cancel changes to exit back to the Forms and Workflows Home Page.    

Test this Feature

  1. Click the Test icon for the Employee OnBoarding Workflow.
  2. Fill in the Employee Information and Personal Allowances steps in the workflow.
  3. Fill in the first column of the first row of table on the Education step.
  4. Close the browser.
  5. Open the browser again and login as the designer.
  6. Click My Tasks. The unfinished task will be on your Task List.
  7. Click the  Perform icon. returns you to the step where you left off. If you navigate to the Employee and Allowances steps, you will see that the information was saved but the data that you entered into the first column of the table on the Education step is not.
  8. Continue entering data from this point to complete the workflow.




...