/
Workflow Step Types and Design

frevvo Latest - This documentation is for frevvo v10.3. v10.3 is a Cloud Only release. Not for you? Earlier documentation is available too.

Workflow Step Types and Design

This page discusses the various types of workflow steps available in frevvo, as well as when and how to use them.

Step Types

New Form

The Add Step wizard allows you to create a new form directly inside the Workflow Designer. It will come with a My Info section that contains several commonly used controls, and a business rule that auto-fills those controls with the logged-in user's information. 

  1. Select Step Type "New Form".
  2. Provide a Step Name (this will also be the Form Name). If you do not add a name, frevvo will generate a unique and arbitrary name, i.e. Step 29. You can change the name in the Step Properties: Settings tab.
  3. Choose an Assignment Type.

The new step will appear in your workflow, and the Workflow Step Properties wizard will open on the page. To add or edit controls on the form, click the Guided Designer: Forms editing mode at the top of your page.

Approval and Linked Steps

Linked Steps

Many workflows often involve a number of people filling out different sections of a single form. When you're designing this type of workflow, the best practice is to use the Linked Steps feature. This method creates a linked version of a form for another step(s) in your workflow. One great advantage of this method is that if you need to make changes to the form step(s) after you've created your workflow, you only have to edit the "parent" form — the editing changes carry over to linked forms in the workflow. Conversely, if you drag multiple copies of the same form into a workflow to create steps, you'd have to make any changes to each copy of the form in each step.

You can easily show or hide different parts of a form for each step using Business Rules.

Approval Steps

An Approval Step is a type of Linked Step that automatically adds an Approval Section and business rules to show/hide that approval section on the step. In the Workflow Design Wizard, this is your only option for a linked step. You can always remove the section and rules later if you prefer. In an existing workflow, you will have the option to add an Approval Step (with the section and rules) or a Linked Step (simple copy, with no added controls or rules.)

One circumstance in which you might not want to use linked forms is a workflow in which each user is filling out a different form. See Linked Steps vs. Separate Forms below.

Create a Linked/Approval Step
  • Create a new workflow with linked steps in the Workflow Design Wizard by selecting "Approval" for Step Type. This will also add approval sections to your form and rules that show/hide them on the correct steps.
  • On an existing workflow, click the + icon in the workflow diagram to launch the Add Step wizard.

Either option links to the nearest parent form step above.

  1. Select Step Type "Approval" (comes with approval sections and rules) or "Linked" (does not add any controls or rules).
  2. Give the step a name; if you do not provide a name, frevvo will automatically name it <Parent Step Name> Copy.
  3. Select an Assignment Type.

The new step will appear on your workflow diagram and the Step Properties will open on the page. The Step Name and "Linked from: <Parent Step Name>" are listed above the Step Properties wizard.


Linked Steps Workflow Example

Approval workflows lend themselves to a Workflow Design pattern that uses Linked Steps. Any changes made to the parent form propagate to the linked steps. The frevvo Workflow Design Wizard is ideal for creating workflows with linked steps.

 Linked Steps Example: Expense Report

Consider an Expense Report with 3 steps:

  • Step 1 is filled in by an employee
  • Step 2 is approved/rejected by a Manager
  • Step 3 goes to the Finance department for final processing.
  1. Click  Add Content and select Create a New Workflow to launch the Workflow Design Wizard. 
    1. Step 1: Step Name Employee, Step Type New Form, Assignment None
    2. Step 2: Step Name Manager, Step Type Approval, Assignment User (select a user id)
    3. Step 3: Step Name Finance, Step Type Approval, Assignment Role (select Finance role)

      Notice the link icon on the Manager and Finance steps, indicating they are linked/approval steps.



  2. Switch to the Guided Designer: Forms editing mode.  Notice a My Info section and two Approval sections have already been created. Add or Edit Sections for the Expenses, Manager and Finance to reflect your business requirements. Design the sections using any of the Palette Controls. Minimally, you can use a table to collect the Expenses and a Paid on Date and Reference Number field on the Finance step. 

  3. Switch to Guided Designer: Rules editing mode. Notice that the Workflow Design Wizard already created rules to show/hide each approval section appropriately.
  4. Save and Test the workflow.

HTTP

HTTP Wait-Notify is a step, configured with a post url, that can be added to a workflow. The workflow data is posted to this url when the task is executed. A call back url is included in the post. The workflow and task are suspended until the receiver posts back. The timezone must be added programmatically by the service you are using. HTTP steps can be performed by an anonymous user.

To add an HTTP Wait-Notify step, click the + icon in the place you want to add the step. This launches the Add Step wizard.

  1. Select Step Type "HTTP Wait-Notify".
  2. Optionally, add a Step Name. If you do not add a name, frevvo will name the step "HTTP".

The new step will appear in your workflow, and the HTTP Step settings wizard will open on the page.

Consider this scenario. Your company has a purchase process workflow. One of the steps in the workflow requires approval from several other approvers before the workflow can continue to the next step. These approvals should happen in parallel and not one after the other. A web component that would manage those approvals is in place. An HTTP step can be added to the frevvo workflow with a URL to the web component to collect the signatures. The callback URL will be included in that post. The workflow will be suspended until all the signatures are collected. The remote web component will notify the frevvo workflow using the callback URL when the signature task is completed. If the HTTP step in the workflow has doc actions configured, they will be performed and the workflow will proceed to the next step.

Now let’s take a look at a simple workflow that will accomplish the scenario described above. This workflow contains the Purchase Request form submitted by the company purchasing manager as the first step. The second step is an HTTP step that provides the URL to the web component that handles collecting the signatures from all the required approvers. The third step is a Summary step. Remember the workflow will be suspended until all the approval signatures have been collected by the web component. The web program will then use the callback url to proceed to the Summary step of the workflow.


  • Click on the HTTP step and open the Settings tab. Enter the URL for your post. In the image below, we are entering the URL to a remote test server running a service that can be used to test this feature: 

    http://<server>:<port>/services/test
  • Configure Email or a post to a web application if required. These actions will be performed when the HTTP step is completed. 

When the first step in the workflow is submitted, an outbound message similar to the one shown below is captured in the frevvo.log:

Notice the latter portion of the entry contains the callback URL:

This URL is generated by the frevvo server and will point to whatever host/port the frevvo server is accessed on. If the frevvo.forms.server.external.url property is set in the frevvo-config.properties, it will always use the value of that property.

This URL is used by the remote service to “wake” up the frevvo workflow. Any document actions configured will be performed and the frevvo workflow will resume. Workflow visibility can be set to any of the choices. 

You cannot reset a workflow to an HTTP step. Look for the status of WAITING in the Audit Trail to find HTTP steps in a workflow that are in a suspended state. 

If navigation is used to go to the previous step, the HTTP step will be skipped. In this case, if a user who has navigated back, makes some changes in a form and proceeds forward through the workflow, the backend system will not have updated data. If you use the HTTP step, it is important to realize that it will not get called again if the user navigates around. The designer may not want to have the navigation bar visible or prior steps' data should be read-only. The HTTP step will get recalled if you reset to a prior step and the workflow continues through its normal steps. 

Configure a History Message on the step before the HTTP step if you want to see relevant information in the audit trail.  

Summary

The Summary step type will simply display a summary view of the data that has been entered into the various steps of the workflow prior to the Summary step at runtime. Clicking on the Details button navigates to the selected step for viewing/editing. The designer selects the fields to display in the Settings mode Summary Fields tab. Usually, you will choose a sample of the fields that provide a summary of the information entered.

To add a Summary step, click the + icon in the place you want to add the step. This launches the Add Step wizard.

  1. Select Step Type "Summary"
  2. Optionally, add a Step Name. If you do not add a name, frevvo will name the step "Summary".

The new step will appear in your workflow, and the Summary Step settings wizard will open on the page.

Previously completed steps in a workflow can be viewed by all users but editing data is only allowed for the user that initiated the workflow. For example, if the Summary step is part of a screenflow performed by the same user, editing is allowed when this user clicks on the Details button. Once the workflow navigates to a different user, previous steps are rendered read-only and cannot be edited. Refer to Navigating Between Steps for more information.

The Print button is available on Summary steps by default. Refer to Printing Workflows for the details. The designer can specify a CSS class, a Button label and a Decorator for the Summary step on the Settings property tab.

Existing Forms 

You can also add a form you have already created and which is listed in your current project's forms home page. Adding an existing form to the workflow creates a copy of that form. If you later edit the standalone form, those changes will not affect the step in the workflow. It remains as it was at the time you copied it into the workflow. If you want to update the workflow to have a new copy of the form, delete the step from the workflow and re-add the updated form.

Alternatively, you can edit the form directly in the workflow. Similarly, these changes to the form inside the workflow do not affect the original form in the form home page.

To add an existing form, click the + icon in the place you want to add the step. This launches the Add Step wizard.

  1. Select Step Type "Use Exisiting Form: <Your Form Name>"
  2. Optionally, add a Step Name. If you add a name, this will also become the form name in the workflow. If you do not add a name, the existing form name will become the step name. You can change the name anytime in the Step Properties: Settings tab.
  3. Add an Assignment type.

The new step will appear in your workflow, and the Workflow Step Properties wizard will open on the page. To add or edit controls on the form, click the Guided Designer: Forms editing mode at the top of your page. When you add an existing form as a step in your workflow:

If the following properties are selected in your form, they will be unchanged when you drag and drop this form into a workflow as one of the steps:

Settings:

  • Save/Load
  • Task Info
  • Allow Sign Pad
  • Printable

Style:

  • Orientation

Workflow Step Design

Linked Steps vs. Separate Forms

There are two design patterns to be considered when designing your workflow. Choosing one design pattern over the other really depends on the purpose of your workflow. The choices are:

  • Use individual forms as your steps
  • Use Linked or Approval steps

For example, if you were creating a workflow from a fifty-tab Excel spreadsheet, you can create forms for each tab and then drag the individual forms into your workflow for your steps.

Workflows where one form gets routed to a lot of people and they all have to work on it collaboratively, typically use the Linked steps approach.

There are several design paradigms for workflows that you may want to consider depending on your workflow requirements. You can find examples of each type