Versions Compared

Key

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

...

Easy Heading Free
headingIndent0
navigationIndent0
expandOptiondisable-expand-collapse
selectorh1
wrapNavigationTexttrue
navigationExpandOptiondisable-expand-collapse

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

Frevvoproduct
. We will

...

Frevvoproduct

...

  • A screenflow - allows you to collect a lot of information in a series of small steps
  • A workflow where one of the steps is performed by someone outside the company (anonymous)
  • An Approval workflow where one of the steps is only routed for additional approvals if certain conditions are met.

If you need basic help using the

Frevvoproduct
Workflow Designer, please refer to the Getting Started with Workflows guide, and then return here.

What are we going to build?

...

use an example of a services Purchase Order workflow to demonstrate design patterns and 

Frevvoproduct
features. If you need basic help using the
Frevvoproduct
Workflow Designer, please refer to the Getting Started with Workflows 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.
  • Frevvoproduct
     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
    Frevvoproduct
    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.

Image Modified

...

width375px

On This Page:

...

What You

...

Will Need

You need either a Live Forms Online account -- signup for a 30 day trial if you don't already have an account. Or use a working Live Forms In-house software installation. If you are using In-house software you will also need to create a tenant, add a designer user to that tenant and configure email

Example

...

There are 2

Frevvoproduct
 projects that can be downloaded to help with this tutorial:

...

Project

Download this example project (WorkflowTutorial_project.zip) that contains completed workflow examples as well as the forms you need to build the workflow yourself using the steps below.

Upload the project to your 

Frevvoproduct
 user account. Follow these steps:

  1. Log  Browse the appropriate URL below and log into your tenant as the designer user.Open a tab in your browser. Browse one of the following URLs:
    1. Cloud: https://app.frevvo.com/frevvo/web/login
    2. In-house: http://<server>:<port>/frevvo/web/login
  2. Click the  Add icon at the top of the Projects Home Page and select  Upload Project.
  3. Browse for the downloaded project zipfile (PurchaseOrderCompleted_project.zip or PurchaseOrderWorkflowTutorial_project.zip).
  4. Do not check the Replace or Copy checkboxes.
  5. Click the Upload button.

The project is uploaded and immediately appears in your list of projects. 

Example 1 - Purchase Order screenflow

Let's begin by creating a simple screenflow consisting of the Client and Services forms that the sales person will use to create the Purchase Order. A screenflow is a type of workflow where all the steps are filled in by the same 

Frevvoproduct
 user. The Client form contains a read-only information section (first name, last name, and email) that will be automatically populated with the sales person's information using a business rule and a second section to collect information about the customer requesting the services. The Services form contains fields to describe the requested services and business rules to calculate the cost. 

We will add a form action to customize the message displayed to the sales person when the workflow is completed.

Create the Purchase Order screenflow

To create this workflow, follow these instructions:

...

If the Palette is contracted, click in the header to expand it. Drag the Client form from the Palette and drop it on the workflow designer canvas into the Guide box. This form will be the first step in the workflow. Click the step, then the step name on the properties panel to rename it 'Client.'

...

Drag the Services form from the palette and drop it below the Client form when you see the Image Removed "green flashing bulls eye". The Services form will be the second step in the screenflow. Change the step name to 'Services.'

Click on the Image Removed section in the left side panel to customize the message the sales person will see when the workflow is completed: 

...

The Workflow Step Properties window opens to the Workflow Actions tab. Click the radio button 'Display Message When User Submits a Workflow.' Copy the message below into the Message box then click Finish. 

Code Block
The Purchase Order for {ClientName} at {ClientCompany} is complete.

{ClientName} and {ClientCompany} are examples of templates. Templates are specified by surrounding the name of a control in your form with curly braces. 

Frevvoproduct
 will use the values entered into the Client Name and Client Company fields at runtime. You can also select a template by using the drop down arrow in the top right corner of the message box, or by using typeahead starting with a '{' followed by the first few letters of the template name. A suggestion menu will appear for you to choose the template you want.

Image Removed

...

At this point, your workflow should look like this:

...

Click the Image Removed save/exit icon to save your work.

Info

If you want to see the details of the forms, click on a step in the workflow designer then click the Image RemovedEdit icon on that step. The form will display in the forms designer. You can view the business rules by clicking on the Image Removed Rules icon.

Test Example 1:

...

Example 2 - Send the PO for Signature

This workflow sends the Purchase Order electronically to the customer for their review and signature.

  • The customer's email address is entered by the sales person on the first step.
  • An email is sent to the customer with a link to the PO.
  • The customer clicks the link to review the PO, approves and signs it or sends it back to the sales person for corrections.
  • Frevvoproduct
    sends a copy of the signed PDF to the sales person by email. 

...

Set Up Roles and Users

We need to create several roles and users assigned to those roles in order to complete all of the steps in this tutorial. Users and Roles can only be created by the tenant admin.

Create the VP Role

  1. Login to 

    Frevvoproduct
     as the tenant admin. 

  2. Click the Manage Roles link.

  3. Click theImage Addedplus icon.

  4. Type "VP" into the role name and click Submit.

Create Users

We'll create a few users and assign some of them roles and supervisors.

Add "jerry"
  1. Log on to 

    Frevvoproduct
     as the tenant admin.

  2. Click Manage Users on the Manage tenant page

  3. Click the Image Addedadd new user icon which will bring up the Add New User form

  4. Enter "jerry" as the User Name then enter all the required information - leave the Reports To and Roles fields empty. Click Submit.

Edit "designer"
  1. You should be back on the user list - click the Image Addededit user icon for the designer user.
  2. Select jerry from the Reports To dropdown. Click Submit.

Add "ed"
  1. Click the Image Addedadd new user icon which will bring up the Add New User form

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

  3. Leave the Reports To field empty

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

Add "sue"
  1. Click the Image Addedadd new user icon which will bring up the Add New User form

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

  3. Leave the Reports To and Role fields empty. Click Submit.

Add "jim"
  1. Click the Image Addedadd 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. 

1 - Create the Workflow

First, build the workflow using the Workflow Design Wizard, which provides an easy way to quickly create all of your approval steps and business rules to route them at once.

Let's begin by using the built-in Workflow Design Wizard to create the steps of our workflow and automatically add routing and business rules. 

  1. Click the name of the Workflow Tutorial project (or click the Image Added Action Menu and select Image Added Open.) to go to the Forms and Workflows homepage.
  2. Click the Image AddedAdd icon and select Image AddedCreate a New Workflow. The Workflow Design Wizard will open.
    Image Added
  3. Enter a Name and Description for your workflow, i.e. Name: "My Purchase Order Workflow," Description: "Example PO workflow for tutorial." Click Next.
    Image Added
  4. Notice that the first step is already created for us. Rename it to "PO." Then, instead of the default "Create New Form," select the existing form "PO" form from the Step Type dropdown.
    Image Added
  5. Click the Image AddedAdd icon to add Step 2.
    1. Rename the new step "Client Approval"
    2. Leave the default Step Type set to "Approval Step"
    3. Leave the default Assignment Type "To an Email Address." You will see that the email field defaults to your email - leave that as is for now. We will change it to a template later.
  6. Click the Image AddedAdd icon to add Step 4.
    1. Rename the new step "Sales Review"
    2. Leave the default Step Type set to "Approval Step"
    3. Change the Assignment Type to "To a User." Add yourself as the user. We will change it to a template later.
  7. Click the Image AddedAdd icon to add Step 4.
    1. Rename the new step "Manager Approval"
    2. Leave the default Step Type set to "Approval Step"
    3. Change the Assignment Type to "To a User." Add yourself as the user. We will change it to a template later.
  8. Click the Image AddedAdd icon to add Step 5.
    1. Rename the new step "VP Approval"
    2. Leave the default Step Type set to "Approval Step"
    3. Change the Assignment Type to "To a Role." Add the role VP (you will have to create this role in your tenant first.)

Image Added

Click Finish. Your initial workflow should look like this:

Image Added

Tip

The Workflow Design Wizard added some controls and business rules for you, which saves a lot of time! These can also help you to understand the actions of business rules so that you can change them or add your own. Open the PO step by clicking the pencil icon. Scroll down and notice that the wizard added approval sections for Client Approval, Sales Review, Manager Approval, and VP Approval. The Client Approval has a Wet Signature control and a Date control. All the other approval sections are Text/Signature Image Signed sections because they will be performed by authenticated users. 

Now look at the business rules by clicking the Rules Icon. Some of these came over with the PO Step, but the rules to show/hide the approval sections on each approval step were added by the Workflow Design Wizard. 

Visit the Workflow Design Wizard documentation for more details about how it streamlines workflow creation!


2 - Customize the PO & Client Approval Steps

This workflow sends the Purchase Order electronically to the customer for their review and signature.

  • The customer's email address is entered by the sales person on the first step.
  • An email is sent to the customer with a link to the PO.
  • The customer clicks the link to review the PO, approves and signs it or sends it back to the sales person for corrections.
  • Frevvoproduct
    sends a copy of the signed PDF to the sales person by email. 

Note, the customer does not have to be logged into a

Frevvoproduct
 tenant (anonymous) to perform the Approval step. 

We will create a new workflow that can be modified for subsequent examples in this tutorial. The workflow will have:

...

need to customize:

  • The Approval Section on the PO form.
  • The Task Assignment that sends the step that the customer signs.

  • Customized messages for Task notification emails to the customer and sales person.

  • A document action to send an email to the sales person and the client. A signed PO is attached to the email when the workflow is completed.

You will need at least one valid email address to test this workflow.  

Create the Purchase Order workflow:

We will replace the Client and Services steps with a single step using a form named PO. The PO form contains these additions:

...

Add Rules

First, let's add a rule to make the client signature

...

required

...

Follow these instructions:

...

Drag the PO form from the Palette and drop it into the Guide box on the workflow designer canvas. The PO form will be the first step in the workflow. Change the step name to 'PO.'

  1. Click on the PO step. Click the Image Removedtab in the Properties panel. Make sure the printable property is checked on this step. We are creating our workflow using the linked steps design pattern. Checking the printable property on the original form guarantees that the original form and any linked steps in the workflow are included in the pdf.
  2. Type "Send to client" in the Continue Label property. Click Submit.

...

  1. Change the name to 'Client Approval.'
  2. Type 'Send to frevvo, Inc' into the Continue label property to change the text to something more meaningful.

  3. Click the Rejection tab, uncheck the Reject to here and Reject from here checkboxes. The Reject button feature will be discussed in a later example.

...

Frevvoproduct

...

Below the Task Notification Email instruction on the same tab, 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.

...

We will use the Visual Rule Builder to add a business rule to the PO. This rule hides the Instruction section on the Client Approval step. The Instructions should only show on the steps performed by company employees logged into

Frevvoproduct
. It will also show the Agreement (Client Approval) section on the Client Approval and subsequent workflow steps and hide it on the first step. We want the Agreement section to display on the Client Approval step of the workflow where the Client Approves or Rejects the PO. If the Client approves the PO, then the business rule will make the Client Signature field required.

...

titleClick here to see how to create this rule

The Visual Rule Builder consists of 3 wizards:

...

  1. Click the PO step then click the Image Removedblue pencil icon to edit it
  2. Click the Image RemovedRule icon on the Workflow Designer toolbar
  3. Click the Image Removedto add the rule.
  4. Name it Show/Hide Client Approval/Instruction Sections, make Client Signature Required if Approved
  5. Click the Rule Builder button then click Add Condition - this is the Condition wizard
  6. Select current step from the first dropdown.
  7. Select is on or after from the second dropdown
  8. Select Client Approval from the third dropdown
  9. Click Next then click Add Action - this is the Action wizard where you set up actions that will happen if the condition is true
  10. Set the Agreement section to visible
  11. Add another action to set the Instructions section to hidden
  12. Add another action to set the Client Signature field to required
  13. 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
  14. Set the Agreement section to hidden
  15. Add another action to set the Instructions section to visible
  16. Add another action to set the Client Signature field to optional
  17. Click Finish

The Rule should look like this on the Rule Editor page:

Image Removed

...

Enter {SalesEmail} and {ClientEmail} in the To: field. Separate them with a comma. Ex: {SalesEmail},{ClientEmail}

when the client approves the PO.

  1. Click on the PO Step, and then click Edit.
  2. Drag the Agreement Section inside the Client Approval Section.
    Image Added
  3. Click the Rules icon to open the Rules Editor. Notice that several rules already exist; some were present on the PO form that we used. Others were added by the Workflow Design Wizard. The descriptions tell you each rule's purpose.

    Expand
    titleMore info about 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


  4. Add a Rule. Name the rule "Set Client Signature to Required." Add a description "Set Client Signature to Required when approved."
    1. Set the Condition to "ClientApprovalCheck" "is filled."
    2. Set the Action to "signature_ClientApproval" "to required."
    3. Set the Else Action to "signature_ClientApproval" "to optional."
      Image Added

Next we'll update the rule "On Approval Step (Client Approval)" to hide the Instruction section on the Client Approval step.The Instructions should only show on the steps performed by company employees logged into

Frevvoproduct
. This rule was built by the Workflow Design Wizard, so it already makes the Client Approval section required on the Client Approval and optional on all other steps. Since the Instructions section can work under the same condition, we'll just add it to this existing rule.

  1. Find the rule named On Approval Step (Client Approval)

  2. Click any pencil icon on the actions.

  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 Instructions section to hidden.

  5. 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.

  6. Set the Instructions section to visible.
    The Rule should look like this on the Rule Editor page:

    Image Added
  7. Click save to save your rules and go back to the workflow designer.

Messages

  1. Click on the Client Approval step, and then click the Image Added Step Properties icon. On the Step Properties wizard that pops up, pick the Messages tab.

  2. Copy the message below into the Pending Message box. 

    Code Block
    The Purchase Order for {ClientName} at {ClientCompany} has been sent to the client for approval.

    {ClientName} and {ClientCompany} are examples of templates. Templates are specified by surrounding the name of a control in your form with curly braces. 

    Frevvoproduct
     will use the values entered into the Client Name and Client Company fields at runtime. You can also select a template by using the drop down arrow in the top right corner of the message box, or by using typeahead starting with a '{' followed by the first few letters of the template name. A suggestion menu will appear for you to choose the template you want.

    Image Added

  3. Keep the popup window open - we'll use it for the next step.

Task Assignment & Continue Button

  1. Click the Setting tab (on the Client Approval Step Properties popup)
    1. Type 'Send to frevvo, Inc' into the Continue label property to change the text to something more meaningful.

    2. Click the Rejection tab, uncheck the Reject to here and Reject from here checkboxes. The Reject button feature will be discussed in a later example.
  2. Click on the Assignment tab of the Properties window. 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. 

    Frevvoproduct
     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.

    Image Added

  3. Click Submit.

Document Action, Workflow Action and Access Control

  1. In this example, the workflow will end after the client approves. The sales person receives an email with a copy of the workflow PDF attached. Follow these steps to configure this email.
    1. Click the header in the Workflow Designer, then click the Image Addedsection in the properties panel. The Workflow Properties window will appear on the Document Actions tab.
    2. Click the Send Email radio button.
      1. Enter {SalesEmail} and {ClientEmail} in the To: field. Separate them with a comma. Ex: {SalesEmail},{ClientEmail}

      2. Enter "Purchase Order for {ClientName} at {ClientCompany}" in the subject field.
      3. Copy the text below into the message field to replace the existing message.

        Code Block
        The Purchase Order from {ClientName} at {ClientCompany} is attached. Please review. 
        <br/>
        Thank You.


      4. Select PDF from the Send Snapshot dropdown. This adds a PDF to the email after the customer approves it or requests corrections.
      5. Do not check the Send Data checkbox. Check the Attachments checkbox. These selections ensure the workflow xml will not be attached to the email but any attachments that are uploaded will.

  2. Customize the message the client will see when they click the Send to frevvo, Inc button.
    1. Click on the Image RemovedImage Added tab.

    2. Click the Display Message when user submits workflow radio button. Enter "The Purchase Order for {ClientName} at {ClientCompany} was sent to frevvo, Inc.".

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

    Image Removed

    Image Added tab.

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

    2. Click Submit.

  4. At this point, your workflow should look like this:  
    Image Removed
  5. Click theImage Removed save and exit icon to save your work
    1. .

Note
    • If you want to see the details of the forms, click on a step in the workflow then click the Edit icon on that step. The form will display in the forms designer. You can view the business rules by clicking on the  Rules icon.
    • 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.

Test

...

the Workflow

  • Click the Image Removed Image Added save/exit icon then the Image Removed Image AddedTest icon. Click the Image RemovedImage Addedblue right arrow to expand the Instructions section. This section is only visible to internal employees of the company.
  • Fill in the first step of the PO and sign.
  • Click the Send to client button. You will see your customized pending message. 

  • Log out of

    Frevvoproduct

  • Frevvoproduct
     sends a notification email with your customized subject/message to the email address specified in the Primary Contact Email Address field on the first step. 

  • Open the customer's email with a "Purchase Order from frevvo" subject. Click on the link provided.

  • The customer will see the completed PO and a section where they can sign to approve the PO or send it back if corrections are needed. In this example, the Reject button does not show as it is not configured for this workflow step.

  • Approve the PO for now. We will cover rejecting the PO in a later section. Sign as the customer. Verify the Date Signed field is populated with the current date after signing.

  • Click the Send to frevvo, Inc button. You will see your customized message.  

  • The sales person and the client receive an email "Purchase Order for {ClientName} at {ClientCompany}" as the subject.

  • Open one of the emails and click on the pdf. Verify the (In order to see the finished products of these customizations, you will need to complete the next steps as well. For steps assigned to you, you will be prompted on the screen that you are eligible to perform the next step. Accept it, click "Sign this Section on the required approval section. For the VP step, log in as a user with the VP role (or give yourself this role) and sign the approval section.) Once you submit the final step, you will see your custom message.

  • The sales person and the client receive an email "Purchase Order for {ClientName} at {ClientCompany}" as the subject.

  • Open one of the emails and click on the PDF. Verify the Sales Information, Client Information, Client Services details and the Agreement section with the customer's signature are included.

...

3 -

...

Customize the Sales Review Step

Now that we have a workflow that sends the PO to the customer for approval, we can quickly modify it to send the customize sending the Approved PO back to the sales person after signing. The sales person receives an email with a link to their task list. The
Frevvoproduct
 Task List is like an email inbox where users can find all the tasks requiring their attention. In this example, the sales person will access their Task List, review the signed PO and complete the workflow.  

The PO form has a hidden field that is populated with the

Frevvoproduct
 user id of the sales person by a business rule. We will add a step to the workflow set an assignment on the Sales Review step that uses the information in this field to route the workflow back to the sales person. We can also customize the Task List notification email that the sales person receives.

Also, 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/Summary fields wizard. 

Modify the workflow

...

Set up Searchable Fields

  1. Login to your
    Frevvoproduct
    tenant as the designer user.
  2. Edit the Purchase Order Workflow Tutorial project.
  3. Click the name of the workflow you want to modify. Change the name to Purchase Order Workflow Purchase Order Workflow to open the Workflow Designer.

  4. Set up the fields from the workflow to use as task and submission search criteria. 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. Click the Setup the Searchable fields link on the Workflow Properties panel. 
    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.
    3. Click Submit.
       
    Add the Sales

Assign the Sales Review

step:

Step

  1. Click on the
  2. PO form
  3. Sales Review step, and then click the 
  4. Image Removed Link
  5. Image Added Step Properties icon.
  6. A linked copy of the PO form,  a double box, will be added to the workflow. Drag this step below the Client Approval step. Drop it when you see the Image Removed "green flashing bulls eye".
  7. Click on the linked PO step. Click theImage Removed Edit Step Properties icon then click on the General Settings tabChange the name to "Sales Review" in the Name field.
  8. Click on the Assignment Tab. Type {SalesID}
  9. Click on the Assignment Tab. Type {SalesID} in the Assign to User property on the panel.
  10. To customize the task notification email the sales person receives: 

  11. Below the Task Notification Email instruction message type
    1. Type "Review PO from {ClientName}" in the subject field.

  12. You can select the control name from the dropdown on the right side of the subject field. 
    1.   

    2. Leave the default message. 

  13. Click on the Messages tab. Type "Thank you! Your PO has been sent back to frevvo Inc." in the Pending Message property. This is the message the client will see when they click the Send to frevvo, Inc button on the previous step.
  14. Type "Client: {ClientCompany}" in the Task Information property. The Task Information helps the sales person identify the task on the Task List.

  15. Click Submit

Edit Workflow Actions

  1. Click the workflow header, then click the  tab on the properties panel. Click on the Display Message wizard. Change the email message back to

    Code Block
    The Purchase Order for {ClientName} at {ClientCompany} is complete.

    Click Submit.

    At this point, your workflow should look like this:
    Image Removed

  2. Click the  save/exit icon to save your changes. 

Test

...

the Changes

  • Click the Test icon or the  Save and Test icon from the Workflow designer.
  • Fill in the PO and sign as the sales person. Click the Send to client button.
  • Log out of 
    Frevvoproduct
    .
  • Check the email account for the customer. Access the notification email, click on the link provided.
  • Approve the PO. Sign as the customer. 
  • Click the Send to frevvo, Inc button. You will see your customized pending message. 
  • Check the sales person's email account. Click the link in the notification email.
  • Log into
    Frevvoproduct
     as the designer.
  • The Sales person (designer) is taken directly to the task. The link in the email is built with will the {task.perform.url} that bypasses the Task List.

  • Review the PO and click the Finish button.Continue button. (In order to see the finished products of these customizations, you will need to complete the next steps as well. For steps assigned to you, you will be prompted on the screen that you are eligible to perform the next step. Accept it, click "Sign this Section on the required approval section. For the VP step, log in as a user with the VP role (or give yourself this role) and sign the approval section.) 
  • Check the email account for the sales person. Verify that the PDF shows the Client and Sales information, the Client Service Order details and the Signed Agreement section.   

  • Logout

4 - Create a Live Forms Space

A space is a built-in portal that's very simple to create and makes it easy to test your forms and workflow(s). We will create a

Frevvoproduct
space 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 space.

...

  1. Login to your tenant as the designer user.
  2. Open the Purchase Order 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 link at left. Click the  Add icon.
  6. Enter a Space Id i.e. workflowtutorial and a Space Name i.e. Workflow Tutorial Space and click Create. You will be directed to the Space Editor. Click Save.
  7. Click the  Action Menu and select Share. Copy the share URL for your space. Bookmark it in a different tab of your browser. Save the URL. You will need it for the Task Notification email messages in Example 4.
  8. Logout.

...

5 - Customize the Manager Approval Step

In this example, we will add another linked step to route the workflow to the sales person's manager for approval. We will need to add a Manager Approval section to our PO step then update a business rule to hide this section until the Manager Approval step is performed. A customized Task Notification email will alert the manager that there is a task requiring his attention. 
We will need to create a new You already created the user (jerry) in 
Frevvoproduct
 and edit edited the designer user to specify jerry as the manager the designer user reports to. Then we We can route the workflow to the manager using {subject.report.to}. This is an example of built-in data that 
Frevvoproduct
 makes available for every transaction.

Create/Modify Users:

Users can only be created by the tenant administrator.  The steps are: 

  1. Log on to 

    Frevvoproduct
     as the tenant admin.

  2. Click Manage Users on the Manage tenant page

  3. Click the Image Removedadd new user icon which will bring up the Add New User form

  4. Enter "jerry" as the User Name then enter all the required information - leave the Reports To and Roles fields empty. Click submit

  5. You should be back on the user list - click the Image Removededit user icon for the designer user.

  6. Select jerry from the Reports To dropdown. Click Submit.

Modify the PO step:

Log back into your tenant as the designer user.
Add the Manager Approval section: 
  1. Open the Purchase Order project.
  2. Edit the Purchase Order Workflow.
  3. Click the Image Removed icon to edit the PO step.
  4. Drop a Section control to the bottom of the form
    1. Click on the section label and change it  to "Manager Approval". The control name will automatically become ManagerApproval.

    2. Uncheck the Visible, Required and Printable property checkboxes.

    3. Click the Security tab

    4. Set the Signature property to "Text/Signature Image"

    5. Check the Must Sign property

    6. Drop a textarea control inside the section 

    7. Name it "ManagerComments"

    8. Click Image Removedsave/exit icon to save the changes to the PO form.

Modify the workflow:

Create a new linked step from the PO step.

...

Drag it to the end of the workflow. Drop it when you see the Image Removed "green flashing bulls eye".

...

Click on the linked PO step, then click the  Image Removedtab in the Properties panel. Change the step name to "Manager Approval." 

...

Click on the Assignment Tab. Type "{subject.reports.to}" in the Assign to User property. 

To customize the task notification email the manager receives,

...

Modify the Manage Approval Step

Log back into your tenant as the designer user.
  1. Click on the Manager Approval step, then click the Image AddedStep Properties icon.
  2. Click on the Assignment Tab. Type "{subject.reports.to}" in the Assign to User property. 

  3. To customize the task notification email the manager receives,

    1. Type "Approval needed for PO from {ClientCompany}" in the Subject field.

      Info

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


    2. Optional (if no Default Space set): Replace the {task.perform.url} template with the URL to the Space we created above. Make sure the space 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 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/space/workflowtutorial/tasklist">this link</a>


  4. Click on the Messages tab. Type "PO sent for your Manager's Approval"  in the Pending Message property. 

  5. Type "Client:  {ClientCompany}" in the Task Information property.

  6. Click Submit

Modify the Sales Review step

  1. Click to select the Sales Review step. Click the Image AddedEdit Step Properties icon then click on the General Settings tab.

  2. Type "Send to Manager" in the Continue Label property.

    Info

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


  3. Optional (if no Default Space 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 we created above. Make sure the space 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 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/space/workflowtutorial/tasklist">this link</a>
    Info

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

  4. Click on the Messages tab. Type "PO sent for your Manager's Approval"  in the Pending Message property. 

  5. Type "Client:  {ClientCompany}" in the Task Information property.

  6. Click Submit

  7. Click to select the Sales Review step. 

  8. Click the Image RemovedEdit Step Properties icon then click on the General Settings tab.
  9. Type "Send to Manager" in the Continue Label property.
  10. Click on the Assignment Tab.

  11. 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 we created above. Make sure the space 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 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/space/workflowtutorial/tasklist">this link</a>
    Info

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

  12. Click Submit
  13. At this point, your workflow should look like this:
    Image Removed
  14. Click the Image Removedsave/exit icon to save your changes.
Create the Show/Hide Manager Step Rule

...

We will create a rule that hides the Manager Approval step (section) until the workflow gets to the Manager step. The rule shows the Manager Approval section on the Manager step and on any steps after it.

...

Edit the workflow

...

Click on the PO Step

...

Click the Image Removed rules icon on the toolbar.

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. Click the Image Removedto add the rule.
  2. Name it Show/Hide Manager Approval Step
  3. Click the Run Builder button then click Add Condition - this is the Condition wizard
  4. Select current step from the first dropdown.
  5. Select is on or after from the second dropdown
  6. Select Manager Approval from the third dropdown
  7. Click Next then click Add Action - this is the Action wizard where you set up actions that will happen if the condition is true
  8. Set the Manager Approval section to visible
  9. Add another action to set the Manager Approval section to required
  10. Add another action to set the Manager Approval section to printable
  11. 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
  12. Set the Manager Approval section to hidden
  13. Add another action to set the Manager Approval section to optional
  14. Add another action to set the Manager Approval section to not printable
    Image Removed
  15. Click Finish.

...

Click Image Removedsave/exit icon to save the changes to the PO form. Save the workflow.

...

Test Example 4:

...

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

...

Select the Purchase Order Workflow from the Purchase Order tab. Fill in the PO and sign as the sales person. Click the Send to client button.

...


  1. Click Submit

Click the Image Addedsave/exit icon to save your changes. Log out of the designer.

Test the Changes

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

  • Select the Purchase Order Workflow from the Workflow Tutorial tab. Fill in the PO and sign as the sales person. Click the Send to client button.

  • Logout of the space
  • 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. 
  • Check the sales person's email account. Find the notification email with the subject "Review PO from {ClientName}" and click the link.
  • Login to your 
    Frevvoproduct
    space as the designer@<your tenant>. The Sales person (designer) is taken directly to the Task List.
  • Review the PO then click Send to Manager.
  • Check the manager's email account for the notification email with a subject "Approval needed for PO from {ClientCompany}". Click the link in the email.
  • Login to your 
    Frevvoproduct
    space as jerry@<your tenant>. Jerry is taken directly to his Task List in the space. Find the tasks for the Purchase Order Workflow in the Task List. Click the Image Added Perform icon. Note the Manager Approval section displays as specified by the Show/Hide rule.
  • Add a comment and sign as the manager. Click Continue. (In order to see the finished products of these customizations, you will need to complete the next steps as well. For steps assigned to you, you will be prompted on the screen that you are eligible to perform the next step. Accept it, click "Sign this Section on the required approval section. For the VP step, log in as a user with the VP role (or give yourself this role) and sign the approval section.) 
  • Logout of the space.
  • The sales person and the client receive emails with the signed/approved PDF. Verify that the PDF shows the Client/Sales information, the Client Service Order details, the Signed Agreement and Manager Approval sections.

6 - Customize the VP Approval Step

In this example, we will route the workflow to the VP for approval. A customized Task Notification email will alert the VP that there is a task requiring his attention. 

Modify the VP Approval Step

  1. Click on the VP Approval step then click the Image AddedEdit Step Properties icon. 
  2. Click on the Assignment tab. To customize the task notification email the VP receives, Type "VP Approval needed for PO from {ClientCompany}" in the Subject field.

    1. Optional (if no Default Space Set): In the Message field, replace the {task.perform.url} template with the URL to the Space we created above. Make sure the space 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 with an id of workflowtutorial. Click Finish.

      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/space/workflowtutorial/tasklist">this link</a>


  3. Click on the Messages section in the Properties panel. Click on the Message Tab. Set the Pending Message property to "PO sent for VP Approval". 
  4. Type "Client: {ClientCompany}" in the Task Information property. 
  5. Click Submit.

Modify the Manager Approval Step

  1. Click to select the Manager Approval step.
    1. Set the Continue Label property to "Send to VP". Click Submit.
  2. Click the Image Added save/exit icon to save your changes. 
  3. Logout of the designer.

Test the Changes:


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

  • Select the Purchase Order from the Workflow Tutorial tab.

  • Fill in the PO and sign as the sales person. Click the Send to client button.
  • Log out of your
    Frevvoproduct
    space.
  • 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. 
  • Check the sales person's email account. Find the notification email with the subject "Review PO from {ClientName}" and click the link.
  • Login to your 
    Frevvoproduct
    space as the designer@<your tenant>.

...

  • You will be taken directly to the Sales person's (designer)

...

  • Task List. Click the Image AddedPerform icon. The red Perform icon indicates that the task has been assigned to a specific user. In this case, the sales person (designer user). Review the PO then click Send to Manager. Logout of your
    Frevvoproduct
    space.
  • Check the manager's email

...

  • for the notification email with a subject "Approval needed for PO from {ClientCompany}". Click the link in the email.
  • Login to your 
    Frevvoproduct
    space as jerry@<your tenant>.

...

  • You will be taken directly to

...

  • Jerry's Task List

...

  • .

...

  • Click the Image AddedPerform icon. Note the Manager Approval section displays as specified by the Show/Hide rule.
  • Add a comment and sign as the manager. Click

...

  • Send to VP.

...

  • Logout of

...

Example 5 - PO for VP Approval

In this example, we will add another linked step to route the workflow to the VP for approval. We will need to add a VP Approval section to our PO step then update a business rule to hide this section until the VP Approval step is performed. A customized Task Notification email will alert the VP that there is a task requiring his attention. 

...

Frevvoproduct

...

Frevvoproduct

...

Create the VP role:

Roles can only be created by the tenant administrator.  The steps are:

  1. Login to 

    Frevvoproduct
     as the tenant admin. 

  2. Click the Manage Roles link.

  3. Click theImage Removedplus icon.

  4. Type "VP" into the role name and click Submit

Create a user with the role of VP:

  1. Click Manage Users on the Manage tenant page

  2. Click the Image Removedadd new user icon which will bring up the Add New User form

  3. Enter "ed" as the User Name then enter all the required information.

  4. Leave the Reports To field empty

  5. Select the VP role from the role dropdown. Click Submit.

  6. You should be back on the user list. Logoff.

Modify the PO step:

Log back into your tenant as the designer user.
Add the VP section: 

...

  • your
    Frevvoproduct
    space.

...

The sales person and the client receive emails with the signed/approved pdf. Verify that the pdf shows the Client/Sales information, the Client Service Order details, the Signed Agreement and Manager Approval sections.

  • Check the VP emails with the title "VP Approval needed for PO from {ClientCompany}". Click the link in the email.
  • Login to your 
    Frevvoproduct
    space as the ed@<your tenant>.. You will be taken directly to the VP's Task List. Click the Image AddedPerform icon. The blue perform icon indicates that the task has been assigned to a role. The task will be locked when the first user assigned the VP role clicks the Perform icon.
  • Note the Manager Approval and VP Approval sections display as specified by the Show/Hide rules.
  • Enter a comment for the VP, sign and click Finish. Logout of the
    Frevvoproduct
    space.
  • The sales person and customer receive emails with the signed/approved PDF. Verify that the PDF shows the Client/Sales information, the Client Service Order details, the Signed Agreement,Manager Approval and VP sections.

Info

Since we have seen working examples of how the Task Notification emails work, we will bypass them for the Manager and VP steps when testing workflows going forward.

7 - PO Conditional Routing

In 

Frevvoproduct
, preconditions are used to add logic to your workflow to skip or perform a step when the condition is true. We will add a precondition on the VP Approval step to route the workflow to the VP only if the Total Amount of the PO is greater than or equal to $10000.00. When the VP approves, the workflow will be completed and the sales person and client receive emails with the signed PDF.

If the amount of the PO is less than $10,000.00 then the VP step will be skipped and the workflow will end with the Manager Approval step. The sales person and the client will get the email with the signed PDF.

You can type the JavaScript for the precondition or let

Frevvoproduct
create it for you using the Precondition Rule Builder.

Modify the Workflow

We will use the Precondition Rule Builder to create the JavaScript for the precondtion. Follow these steps:
  1. Login to your
    Frevvoproduct
    tenant as the designer user.
  2. Open the Workflow Tutorial project, then edit the Purchase Order Workflow.
  3. Click

...

  1. on the Manager Approval step then click on the General Settings section of the Properties panel. Change the text of the Continue button to say Finish or Send to VP. Click Submit.
  2. Click on the

...

  1. "VP Approval"

...

Modify the workflow:

...

To customize the task notification email the VP receives, Type "VP Approval needed for PO from {ClientCompany}" in the Subject field. In the Message field, replace the {task.perform.url} template with the URL to the Space we created above. Make sure the space 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 with an id of workflowtutorial. Click Finish.

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/space/workflowtutorial/tasklist">this link</a>

...

  1. Set the Continue Label property to "Send to VP". 

...

Create the Show/Hide VP Section Rule:

...

We will create a rule that hides the VP Approval step (section) until the workflow gets to the VP step. The rule shows the VP Approval section only when the workflow is on the VP Approval step.

...

Edit the workflow

...

Click on the PO Step

...

Click the Image Removed rules icon on the toolbar.

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. Click the Image Removedto add the rule.
  2. Name it Show/Hide VP Approval Step
  3. Click the Rule Builder button then click Add Condition - this is the Condition wizard
  4. Select current step from the first dropdown.
  5. Select is from the second dropdown
  6. Select VP Approval from the third dropdown
  7. Click Next then click Add Action - this is the Action wizard where you set up actions that will happen if the condition is true
  8. Set the VP Approval section to visible
  9. Add another action to set the VP Approval section to required
  10. Add another action to set the VP Approval section to printable
  11. 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
  12. Set the VP Approval section to hidden
  13. Add another action to set the VP Approval section to optional
  14. Add another action to set the VP Approval section to not printable
  15. Click Finish

Image Removed

...

Click the Image Removed save/exit icon to save the changes to the workflow.

...

Test Example 5:

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

  • Select the Purchase Order from the Purchase Order tab.

  • Fill in the PO and sign as the sales person. Click the Send to client button.
  • Log out of your
    Frevvoproduct
    space.
  • 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. 
  • Check the sales person's email account. Find the notification email with the subject "Review PO from {ClientName}" and click the link.
  • Login to your 
    Frevvoproduct
    space as the designer@<your tenant>. You will be taken directly to the Sales person's (designer) Task List. Click the Image RemovedPerform icon. The red Perform icon indicates that the task has been assigned to a specific user. In this case, the sales person (designer user). Review the PO then click Send to Manager. Logout of your
    Frevvoproduct
    space.
  • Check the manager's email for the notification email with a subject "Approval needed for PO from {ClientCompany}". Click the link in the email.
  • Login to your 
    Frevvoproduct
    space as jerry@<your tenant>. You will be taken directly to Jerry's Task List. Click the Image RemovedPerform icon. Note the Manager Approval section displays as specified by the Show/Hide rule.
  • Add a comment and sign as the manager. Click Send to VP. Logout of your
    Frevvoproduct
    space.
  • Check the VP emails with the title "VP Approval needed for PO from {ClientCompany}". Click the link in the email.
  • Login to your 
    Frevvoproduct
    space as the ed@<your tenant>.. You will be taken directly to the VP's Task List. Click the Image RemovedPerform icon. The blue perform icon indicates that the task has been assigned to a role. The task will be locked when the first user assigned the VP role clicks the Perform icon.
  • Note the Manager Approval and VP Approval sections display as specified by the Show/Hide rules.
  • Enter a comment for the VP, sign and click Finish. Logout of the
    Frevvoproduct
    space.
  • The sales person and customer receive emails with the signed/approved pdf. Verify that the pdf shows the Client/Sales information, the Client Service Order details, the Signed Agreement,Manager Approval and VP sections.
    Info

    Since we have seen working examples of how the Task Notification emails work, we will bypass them for the Manager and VP steps when testing workflows going forward.

    Example 6 - PO conditional routing

    In 

    Frevvoproduct
    , preconditions are used to add logic to your workflow to skip or perform a step when the condition is true. We will add a precondition on the VP Approval step to route the workflow to the VP only if the Total Amount of the PO is greater than or equal to $10000.00. When the VP approves, the workflow will be completed and the sales person and client receive emails with the signed pdf.

    If the amount of the PO is less than $10,000.00 then the VP step will be skipped and the workflow will end with the Manager Approval step. The sales person and the client will get the email with the signed pdf.

    You can type the JavaScript for the precondition or let

    Frevvoproduct
    create it for you using the Precondition Rule Builder.

    Modify the workflow:

    We will use the Precondition Rule Builder to create the JavaScript for the precondtion. Follow these steps:
  • Login to your
    Frevvoproduct
    tenant as the designer user.
  • Open the Purchase Order project, then edit the Purchase Order Workflow.
  • Click on the Manager Approval step then click on the General Settings section of the Properties panel. Change the text of the Continue button to say Finish or Send to VP. Click Submit.
  • Click on the "VP Approval" step

  • Click on the Precondition Section in the Properties panel.
  • Click on the Slider to set the Precondition Builder On
  • Click on the Edit below the slider. It will open a popup to set the precondition.
  • Select the TotalAmount control from the first dropdown.
  • Select is equal or more than from the operator dropdown.
  • Slide the toggle to the right and enter 10000 into the literal field.
  • Click Accept.
    Image RemovedClick Submit.
  • Click the Image Removedsave/exit icon to save your changes.
  • Logout of the designer.
  •  

    Test Example 6:

    Follow these steps to test Example 6:

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

    • Select the Purchase Order from the Purchase Order 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
      Frevvoproduct
      space.
    • 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 
      Frevvoproduct
      space as the designer@<your tenant>. Select Task List from the Important Items tab.
    • Click the Image RemovedPerform icon. Review the PO then click Send to Manager. Logout of your
      Frevvoproduct
      space.
    • Login to your
      Frevvoproduct
      space as jerry@<your tenant>. Select Task List from the Important Items tab. 
    • Click the Image RemovedPerform icon. Add a comment and sign as the manager. Click Finish or Send to VP. Logout of your

      Frevvoproduct
      space.

    • Login to your
      Frevvoproduct
      space as ed@<your tenant.  Select Task List from the Important Items tab
    • Click the Image RemovedPerform icon. Add a comment and sign as the VP. Click Finish. Logout of your
      Frevvoproduct
      space.
    • 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.

    Example 7 - PO Reject

    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

    Frevvoproduct
     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 one 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 Purchase Order project, then edit the Purchase Order Workflow. You can change the button label on any step where Reject from here is checked.

  • Click the PO step then click on the Rejection section in the left Properties panel.
    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 Submit.
  • Click the Client Approval step. Click on the Rejection section in the left Properties panel.
    1. Check Reject to here and Reject from here.
    2. Change the Reject Button Label to "Send PO back for revision".
    3. Click Submit.
  • Click the Sales Review step then click on the Rejection section in the left Properties panel.
    1. Check Reject from here and Reject to here.
    2. Click Submit.
  • Click the Manager Approval step then click on the Rejection section in the left Properties Panel.
  • 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.
  • Change the Reject Button Label to "Reject PO".
  • Replace the {task.perform.url} template in the Rejection email body to the URL of your 

    Frevvoproduct
    space 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/space/workflowtutorial/tasklist">this link</a></p>
    Info

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

  • Click Submit
  • Click the VP Approval step then click on the  Rejection section in the left Properties Panel.
  • 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.
  • Change the Reject Button Label to "Reject PO".
  • Replace the {task.perform.url} template in the Rejection email body to the URL of your 

    Frevvoproduct
    space 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/space/workflowtutorial/tasklist">this link</a></p>
  • Click Submit.
  • Click the Image Removedsave/exit icon to save your changes to the workflow.
  • Logout of your 
    Frevvoproduct
    tenant.
  • Test Example 7:

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

    • Select the Purchase Order from the Purchase Order 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

      Frevvoproduct
      space.

    • 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

      Frevvoproduct
      space as the sales person (designer user). The Sales Person's (designer user) Task List displays. Click the Image RemovedPerform 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

      Frevvoproduct
      space as the sales person (designer user). Select Task List from the Important Items tab.  Click the Image RemovedPerform icon. Review the PO. Click Send to Manager. Logout.

    • Login to your 

      Frevvoproduct
      space as jerry@<your tenant>. Select Task List from the Important Items tab. Click the Image RemovedPerform 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 

      Frevvoproduct
      space as ed@<your tenant>.  Select Task List from the Important Items tab.  Click the Image RemovedPerform 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 theImage RemovedInbox 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

      Frevvoproduct
      space as jerry@<your tenant>. The Sales Person's (designer user) Task List displays. Click the Image RemovedPerform 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

      Frevvoproduct
      space as ed@<your tenant>. Select Task List from the Important Items tab. Click the Image RemovedPerform icon.

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

    Example 8 - Save/load

    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 

    Frevvoproduct
     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
      Frevvoproduct
      tenant as the designer user.
    2. Edit the Purchase Order project, then edit the Purchase Order Workflow.
    3. Click on the Workflow Designer toolbar to display the Workflow Properties panel. Check the Save/Load property. 
      Image Removed
    4. Click the PO step to display the property panel for this step. Click on General Settings Section. Check the Save/Load property.  
    5. Change the label of the Save button by typing "Save for Later" in the Save Label field. 
    6. Click Submit
    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. Click the Image Removed save/exit icon to save your changes.  
    10. Logout of the workflow designer.
    Test Example 8:
    1. step

      1. Click on the Precondition Tab in the Properties panel.
      2. Make sure the Slider is set to Precondition Builder On (this is the default).
      3. Click on the Edit below the slider. It will open a popup to set the precondition. Click "Add Condition".
      4. Select the TotalAmount control from the first dropdown.
      5. Select is equal or more than from the operator dropdown.
      6. Slide the toggle to the right and enter 10000 into the literal field.
      7. Click OK.
        Image Added

      8. Click Submit.

    2. Click the Image Addedsave/exit icon to save your changes.
    3. Logout of the designer.
     

    Test the Changes

    • Click the link to your space 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
      Frevvoproduct
      space.
    • 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 
      Frevvoproduct
      space as the designer@<your tenant>. Select Task List from the Important Items tab.
    • Click the Image AddedPerform icon. Review the PO then click Send to Manager. Logout of your
      Frevvoproduct
      space.
    • Login to your
      Frevvoproduct
      space as jerry@<your tenant>. Select Task List from the Important Items tab. 
    • Click the Image AddedPerform icon. Add a comment and sign as the manager. Click Finish or Send to VP. Logout of your

      Frevvoproduct
      space.

    • Login to your
      Frevvoproduct
      space as ed@<your tenant.  Select Task List from the Important Items tab
    • Click the Image AddedPerform icon. Add a comment and sign as the VP. Click Finish. Logout of your
      Frevvoproduct
      space.
    • 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.

    8 - PO Reject

    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

    Frevvoproduct
     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 section in the left Properties panel.
      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 Submit.
    2. Click the Client Approval step. Click on the Rejection section in the left Properties panel.
      1. Check Reject to here and Reject from here.
      2. Change the Reject Button Label to "Send PO back for revision".
      3. Click Submit.
    3. Click the Sales Review step then click on the Rejection section in the left Properties panel.
      1. Check Reject from here and Reject to here.
      2. Click Submit.
    4. Click the Manager Approval step then click on the Rejection section in the left Properties Panel.
      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 is set.): Replace the {task.perform.url} template in the Rejection email body to the URL of your 

        Frevvoproduct
        space 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/space/workflowtutorial/tasklist">this link</a></p>


        Info

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


      4. Click Submit
    5. Click the VP Approval step then click on the Rejection section in the left Properties Panel.
      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 is set.): Replace the {task.perform.url} template in the Rejection email body to the URL of your 

        Frevvoproduct
        space 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/space/workflowtutorial/tasklist">this link</a></p>


      4. Click Submit.
    6. Click the Image Addedsave/exit icon to save your changes to the workflow.
    7. Logout of your 
      Frevvoproduct
      tenant.

    Test the Changes

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

    • Select the Purchase Order

    Workflow
    • from the

    Purchase Order
    • 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 Image RemovedSaved Task icon at the top.
    Image Removed 
  • Click the Image RemovedPerform icon. Fill in some more fields. Click Save for Later.
  • You can click the Save button as many times as you want. Clicking the Image Removedview 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).
    Image Removed
  • 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
    Frevvoproduct
    .
  • Example 9 - PO 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.
    We will need to create another user, Sue Blue. A dropdown control with a list of managers will be added to the PO step so Jerry can select the manager he wants to reassign the PO approval to - in this case Sue.

    Create another user:

  • Log on to 

    Frevvoproduct
     as the tenant admin. 

  • Click Manage Users on the Manage tenant page

  • Click the Image Removedadd new user icon which will bring up the Add New User form

  • Enter "sue" as the User Name then enter all the required information.

  • Leave the Reports To and Role fields empty. Click Submit.

  • You should be back on the user list. Logoff.

    Modify the PO step:

  • Login to your
    Frevvoproduct
    tenant as the designer user.
  • Edit the Purchase Order Project, then edit the Purchase Order Workflow.
  • Click the PO step and theImage Removed to edit it.
  • Add a field named "ManagerID" with a label "Manager ID" to the Sales Information Section. Uncheck the Visible property. 

  • 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.
  • 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 

      Frevvoproduct
      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 

  • Click the Properties Style tab and set the control width to half the width of the form.
  • Drop a Message control to the right of the Managers dropdown.
  • 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.
  • 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.

    Click the Image Removed rules icon on the toolbar.

    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. Click the Image Removedto add the rule.
    2. Name it Show/Hide the Manager DD and Reassign Message controls on the Managers Step
    3. Click the Rule Builder button then click Add Condition - this is the Condition wizard
    4. Select current step from the first dropdown.
    5. Select is from the second dropdown
    6. Select Manager Approval from the third dropdown
    7. Click Next then click Add Action - this is the Action wizard where you set up actions that will happen if the condition is true
    8. Set the Managers control to visible
    9. Add another action to set the Reassign Message control to visible
    10. 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
    11. Set the Managers control to hidden
    12. Add another action to set the Reassign Message control to hidden
    13. Click Finish
      Image Removed

    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 theImage Removed 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.
      Image Removed
    8. Click Finish
      Image Removed

    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 Image Removedto 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

    Image Removed

    Click the Image Removed save/exit icon to save the changes to the PO form. 

    Modify the workflow:

    1. Click the Manager Approval step.
      1. Click the Image Removed Edit Step Properties icon. Click on the General Setting tab. Check the Save to User property and verify that the Save/Load property is checked.
      2. Change the User property from {subject.reports.to} to {ManagerID}  - this must now be set to a dynamically populated control in the PO form.
      3. Change the label of the Save button to Save.
    2. Click the Image Removed save/exit icon to save the changes to the workflow.

    Test Example 9:

    1. Test the workflow to the step for Manger Approval
    2. 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.
    3. Click the Save button. The task will be removed from Jerry's Task List.
    4. Login as the other manager (Sue). The PO Manager Approval task is now on her task list.
    5. 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.

    Example 10 - PO 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. 

    We will need to create another user with the role of VP.

    Create another user with the VP role:

  • Log on to 

    Frevvoproduct
     as the tenant admin. 

  • Click Manage Users on the Manage tenant page

  • Click the Image Removedadd new user icon which will bring up the Add New User form

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

  • Leave the Reports To field empty. 

  • Select "VP" from the Role dropdown. Click Submit.

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

    Modify the PO step:

  • Login to your
    Frevvoproduct
    tenant as the designer user.
  • Edit the Purchase Order Project, then edit the Purchase Order Workflow.
  • Click the PO step and the Image Removed to edit it.

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

  • 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.

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

  • Select "Warning" from the Message Type dropdown.

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

    Code Block
    The last VP to comment must sign the approval.
  •  Click the Comments control inside the VP Approval section

    1. Type "Enter both your name and comments" into the Placeholder property
  • Drop a Repeat control inside the VP Approval section immediately above the VP Comments text area.

  • 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
  • Click on the VP Approval section
  • 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.
    • 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

      Frevvoproduct
      space.

    • 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

      Frevvoproduct
      space as the sales person (designer user). The Sales Person's (designer user) Task List displays. Click the Image AddedPerform 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

      Frevvoproduct
      space as the sales person (designer user). Select Task List from the Important Items tab.  Click the Image AddedPerform icon. Review the PO. Click Send to Manager. Logout.

    • Login to your 

      Frevvoproduct
      space as jerry@<your tenant>. Select Task List from the Important Items tab. Click the Image AddedPerform 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 

      Frevvoproduct
      space as ed@<your tenant>.  Select Task List from the Important Items tab.  Click the Image AddedPerform 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 theImage AddedInbox 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

      Frevvoproduct
      space as jerry@<your tenant>. The Sales Person's (designer user) Task List displays. Click the Image AddedPerform 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

      Frevvoproduct
      space as ed@<your tenant>. Select Task List from the Important Items tab. Click the Image AddedPerform icon.

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


    9 - Save/Load

    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 

    Frevvoproduct
     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
      Frevvoproduct
      tenant as the designer user.
    2. Edit the Workflow Tutorial project, then edit the Purchase Order Workflow.
    3. Click on the Workflow Designer toolbar to display the Workflow Properties panel. Check the Save/Load property. 
      Image Added
    4. Click the PO step to display the property panel for this step. Click on General Settings Section. Check the Save/Load property.  
    5. Change the label of the Save button by typing "Save for Later" in the Save Label field. 
      Image Added
    6. Click Submit
    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. Click the Image Added save/exit icon to save your changes.  
    10. Logout of the workflow designer.

    Test the Changes

    • Click the link to your space 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 Image AddedSaved Task icon at the top.
      Image Added 
    • Click the Image AddedPerform icon. Fill in some more fields. Click Save for Later.
    • You can click the Save button as many times as you want. Clicking the Image Addedview 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).
      Image Added
    • 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
      Frevvoproduct
      .

    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
      Frevvoproduct
      tenant as the designer user.
    2. Edit the Workflow Tutorial Project, then edit the Purchase Order Workflow.
    3. Click the PO step and theImage Added to edit it.
    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 

        Frevvoproduct
        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. Click the Image Added rules icon on the toolbar.

      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
        Image Added


    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 theImage Added 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.
        Image Added
      8. Click Finish
        Image Added


    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 Image Addedto 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

      Image Added


    4. Click the Image Modified save/exit icon to save the changes to the PO form.

     

    Modify the workflow:

  • Login to your Live Forms tenant as the designer user.
  • Open the Purchase Order project, then edit the Purchase Order Workflow.

  • Click the Manager Approval step. Click on the Escalations Section in the Properties Panel.
  • 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.

  • 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.
  • 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. 

  • 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. Slide the  "Limit Reminder" to on. Enter "2" in the Every text box. Select "Minutes" from the Time Unit dropdown.

    3. Enter "2" in the Occurrences(s)  text box.
    4. Leave the text of the Reminder message at the default.

  • Click Submit
    1.  

    Modify the

    workflow:

    Workflow

    1. Click the
    VP
    1. Manager Approval step.
       
        1. Click the Image Modified Edit Step Properties icon. Click on the General
      Settings
        1. Setting tab. Check the Save to
      Role property.  Verify
        1. User property and verify that the Save/Load property is checked
      .
    2. Change the label of the Save button to Save.
    3. Click the Image Removed save/exit icon to save the changes to the workflow.  
    4. Logout as the designer.
    5. Test Example 10: 

      1. 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.
      2. You should be logged in as the user, ed for the VP step.
      3. Add a VP Comment. Do not sign it.
      4. 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.
      5. Login as the other VP user (jim) and view Jim's Task List
      6. Perform the task.
      7. Click the Image Removedicon to add another comment and sign the section.
      8. Click Finish.
      9. Logout of your
        Frevvoproduct
        space.
      10. Check the workflow PDF attached to the final email. Verify that the VP Approval section is on a new page in the PDF.

      Example 11 - PO 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 Example 11, we will use the

      Frevvoproduct
      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. 

      In Example 9, manager Jerry manually selected the manager to reassign the task to from a dropdown control in the PO step. In this example, we will configure the Escalation feature so that 

      Frevvoproduct
       automatically assigns the task to the user/role specified after the time period expires.

      We will use the Setup Escalation link on the manager step. Escalations can be set up for any of the steps in our workflow except the step performed by the anonymous user (Client Approval). 

        1. .
        2. Change the User property from {subject.reports.to} to {ManagerID}  - this must now be set to a dynamically populated control in the PO form.
        3. Change the label of the Save button to Save.
        4. Click Submit.
      1. Click the Image Added save/exit icon to save the changes to the workflow.


      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
        Frevvoproduct
        tenant as the designer user.
      2. Edit the Workflow Tutorial Project, then edit the Purchase Order Workflow.
      3. Click the PO step and the Image Added to edit it.

      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. Click the Image Added save/exit icon to save the changes to the PO form.  

      Modify the VP Approval Step

      1. Click the VP Approval step
        1.   Click theImage Added Edit Step Properties icon. Click on the General Settings tab. 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 Image Modified save/exit icon to save the changes to the workflow.  
      3. Logout as the designer.

      ...

      Test

      ...

      the Changes 

      • Test the workflow to the step

      ...

      • for VP Approval

      ...

      Login as Sue. The PO Approval task should now be on Sue's Task List. Note the task was initiated by "System User".

      ...

      Example 12 - Quick Approve/Reject

      Quick Approve provides the ability for a user to see a simple view of a task in order to Approve or Reject it. A comment and/or signature can be added to the task without viewing the entire form. Quick View makes the process of task review/approval/rejection easy especially on mobile devices. When the sales person uses an iPad or Iphone to access their task list, they can perform a quick approval/reject without having to view the PO details by clicking the Image Removed Quick Approval icon.. 

      In this example, we will add Quick Approval to the Sales Review step. We will add a Sales Approval section to the PO, modify the Show/Hide sections rule to make this section visible on the Sales Review, Manager Approval and VP Approval steps then use the Setup Approval/Rejection wizard to configure Quick Approve on the Sales Review step. 

      ...

      • . 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 Image Addedicon to add another comment and sign the section.
      • Click Finish.
      • Logout of your
        Frevvoproduct
        space.
      • 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

      Frevvoproduct
      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 Live Forms tenant as the designer user.
      2. Open the

      ...

      1. Workflow Tutorial project, then edit the Purchase Order Workflow.

      2. Click the

      ...

      1. Uncheck the Visible, Required and Printable properties.
      2. Click the Security tab on the section and set the Signature property to Text/Signature Image.
      3. Check Must sign

      ...

      Modify the workflow:

      ...

      Copy the text below into the Summary:

      Code Block
      {ClientName} from {ClientCompany} has approved the PO for {TotalAmount}!!!

      ...

      1. Manager Approval step. Click on the Escalations Section in the Properties Panel.
      2. 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.

      3. 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.
      4. 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. 

      5. 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.

      6. Click Submit.

      7. Click the Image Modified save/exit icon to save the changes to the workflow.

      8. Logout as the designer.

      ...

      Create the Show/Hide Sales Approval Sections Rule

      ...

      Edit the Purchase Order project, then edit the Purchase Order Workflow.

      ...

      Click the Image Removed rules icon on the toolbar.

      Expand
      titleClick here to see how to build this rule with 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 Image Removedto add the rule.
      2. Name it Show/Hide Sales Approval Step
      3. Click the Rule Builder button then click Add Condition - this is the Condition wizard
      4. Select current step from the first dropdown.
      5. Select is on or after from the second dropdown
      6. Select Sales Review from the third dropdown
      7. Click Next then click Add Action - this is the Action wizard where you set up actions that will happen if the condition is true
      8. Set the Sales Approval section to visible
      9. Add another action to set the Sales Approval section to enabled
      10. Add another action to set the Sales Approval section to required
      11. Add another action to set the Sales Approval section to printable
      12. 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
      13. Set the Sales Approval section to hidden
      14. Add another action to set the Sales Approval section to disabled
      15. Add another action to set the Sales Approval section to optional
      16. Add another action to set the Sales Approval section to not printable
      17. Click Finish

      Image Removed

      ...

      Click the Image Removed save/exit icon to save the changes to the PO form.

      ...

       Test the Changes

      • Test the workflow to the step Manager Approval step.
      • Logon as Jerry to verify the PO task is on his Task List..
      • Wait 2 minutes then check Jerry's email for the first reminder email.
      • Wait another 2 minutes then check Jerry's email for the second reminder email.
      • Check Jerry's email for the Task Deadline notification email after the 5 minutes has passed.  The email should mention that the task has been reassigned to Sue. 
      • Check Jerry's Task List. The PO Approval task should be removed. Logout.
      • Login as Sue. The PO Approval task should now be on Sue's Task List. Note the task was initiated by "System User".

      • Perform the task and complete the workflow.
      • Logout. 
      • Check the PDF in the final email to verify that the approval was signed by the user, sue.

      13 - Quick Approve/Reject

      Quick Approve provides the ability for a user to see a simple view of a task in order to Approve or Reject it. A comment and/or signature can be added to the task without viewing the entire form. Quick View makes the process of task review/approval/rejection easy, especially on mobile devices. When the sales person uses a tablet or smartphone to access their task list, they can perform a quick approval/reject without having to view the PO details by clicking the Image Added Quick Approval icon.. 

      In this example, we will add Quick Approval to the Sales Review step. 

      Modify the Workflow

      1. Click on Sales Review step
        1. Click the Image AddedEdit Step Properties icon then click on the General Settings tab.
        2. Scroll the tabs to the right.
        3. Click on the Quick Approval tab.
        4. In the Quick Approve section, Change the Quick Approval Enabled slider to on.
        5. Copy the text below into the Summary:

          Code Block
          {ClientName} from {ClientCompany} has approved the PO for {TotalAmount}!!!


        6. Select Sales Review from the Approval Controls dropdown.
        7. Click Submit.
      2. Click the Image Added save/exit icon to save the changes to the workflow.

      3. Logout as the designer.   
         

      Test

      Example 12

      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 Image Modified quick view icon. The Quick Approval screen will display.

      Image Removed
      • Image Added 

      • 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.
      Example 13

      14 -

      PageBreak

      Page Break for Mobile

      What do you have to do to run the PO workflow on an iPad a tablet or iPhonesmartphone? Nothing! 

      Frevvoproduct
       automatically breaks up the form into steps and adds Back and Next buttons.
      Frevvoproduct
       uses the device’s features to make the mobile experience easier for the user e.g. specialized keyboards. If you want to specify where the logical breaks are, you , such as specialized keyboards, to create a user-friendly mobile experience. 

      You can use the PageBreak control to break 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 an iPad 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:

      Step

      1. Login to your Live Forms tenant as the designer user.
      2. Open the Purchase Order projectWorkflow Tutorial project, then edit the Purchase Order Workflow.

      3. Click the PO step then click the Edit icon.
      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 toolbar once.
      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 an iPhonea 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

      Example 13:

      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 . 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/Exit icon twice to exit the Step and Workflow Designer.
      Example 14

      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. This feature adds a Finish button Finish feature that allows the user to fast forward through a screenflow. A screenflow . It 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 W-4 allowances and Education information. When completed,  the 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. But by adding Adding Fast Finish allows the new employee can now to click on the Finish button and (as long as 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:Browse one of these URLs:
    6. https://app.frevvo.com - if your
      Frevvoproduct
      tenant is in the frevvo Cloud
    7. http://<server>:<port>/frevvo/web/login - if your
      Frevvoproduct
      tenant is in-house. Replace the <server>:<port> with the information for your in-house server.

      Workflow

      1. Login as the designer.  Open the Purchase Order Completed or Purchase Order projectWorkflow Tutorial project.
      2. Edit the Example 14 - Fast Finish 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 in the workflow designer.

      Test

      Example 14:

      this Feature

      1. Click the  Test icon for Example 14 - Fast Finishthe 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 
        Frevvoproduct
         
        Pixel-perfect PDF generation feature.
      7. While reviewing the pdfPDF, you realize you made a mistake when entering your social security number.  Close the pdfPDF
      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 PDF to verify the updated SSN is now displaying. Close the pdfPDF.
      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
        Frevvoproduct
        .
      Example 15

      Feature - Summary Step

      In this example, we will add a look at the Summary step to 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:  

      Workflow

      1. Login as the designer.  Open the Purchase Order Completed or Purchase Order projectWorkflow Tutorial project.
      2. Edit the Example 15 - Summary workflow. 
      3. Click on the toolbar to display the workflow properties.
      4. Notice the Navigation toolbar is set to Percent. The progress of the workflow displays as a percentage when this option is selectedEmployee OnBoarding Workflow.
      5. Click on the toolbar to display the workflow properties.
      6. Click the Setup Searchable and 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.
      7. 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.
      8. 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.
      9. Click cancel changes icon to exit back to the Form and Workflows Home Page in the workflow designer.  

      Test

      Example 15:

      this Feature

      1. Click the Test icon for the Example 15 - Summary workflow.
        Run the workflow. Notice the percent completed is displayed at the topEmployee 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.
      Example 16

      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. This situation can be prevented  if the designer checks the The Save on Navigate checkbox for the workflow.  This 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

      Frevvoproduct
      returns you to the last step where data was being entered. If you navigate to previous steps, all entered data displays.

      Review the

      workflow:  

      Workflow

      1. Login as the designer.  Open the Purchase Order Completed or Purchase Order Workflow Tutorial project.
      2. Edit the Example 16 - Save on Navigate Employee OnBoarding workflow.
      3. Click on the 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 icon to exit back to the Workflows Home Page in the Workflow Designer.    

      Test

      Example 16:

      this Feature

      1. Click the Test icon for the Example 16 - Save on Navigate workflow.Employee OnBoarding Workflow.
      2. Fill in the Employee Information and Personal Allowances steps in the New Employee On boarding 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 .Login and login as the designer.
      6. Click My Tasks. The unfinished task will be on your Task List.
      7. Click the  Perform icon.
        Frevvoproduct
        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.




      ...