Versions Compared

Key

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

Table of Contents

Task List

The  Task frevvo Task List is an electronic listing of workflow tasks that require a user's attention. It is similar to an email inbox. Tasks appear on the task list for one of three reasons:

...

There are several ways to view your Task List. Users must log in to to frevvo to access their task list.

  1.  appfrevvo app:
    1. Non-designer users will see the task list immediately upon logging in and it serves as their "home page".
    2. Users with the frevvo.Designer role must click on the My Tasks tab to view your tasks.
  2. In a  frevvo Space, users will click on the Important Items tab to access the Task List. 
  3. It is also possible to embed the Task List on your own website

...

  • Toggle the left side navigation bar.

    Expand
    titleClick here to see how the menu toggle works...

    Toggle the User Menu

    The icon expands and contracts the user's navigation menu. When you click it, the left-side menu will appear with the option tabs available based on your  rolefrevvo role. Contracting the menu displays just the Task List and any selected tasks, giving you more screen real estate for you tasks.

    Menu Contracted

    Menu Expanded


  • Refresh the Task List. The expanded/contracted state of the refreshed task list will not change. 

    Note

    The Task List does not automatically refresh. Users who rely on their Task List instead of Task Notification emails should manually refresh the list regularly.


  • Inbox displays a non-expanded task list.  
  • Recent displays all tasks you acted upon in the past 7 days. The task list is color coded. Tasks with a green background have been submitted, while those with an white background are pending/saved. A red background indicates tasks that have been aborted. The image shows one submitted task, two aborted tasks and two pending tasks.
  • Saved displays all tasks currently saved by you.
  • Search for tasks you have performed in the past.
  • Embed your task list in another web page.

...

Each task displays information to help the user identify and prioritize the task.

  • The frevvo user that sent the the task to your Task List displays in the top left.
  • The date/time that the task was navigated to the user's task list is shown on the top right. Task List time is always displayed in the Task List and Audit Trail in the user's browser local time zone.
  • The Task information message provides additional information about the task appears in the bottom left. Task Information messages are configured by the designer for each Workflow Step, and can include run-time data from the workflow.

...

Tip

Quick Approval does not lock the task.

Let's consider a Leave Approval workflow with two activities: the first step is a form which collects the pertinent information about the Leave request - employee name, starting date and duration of leave, etc. This step is filled out by any employee requesting a leave. The second step is a form that has a section named Manager Approval with a text area control for comments. The designer has setup the Quick Approval feature for this step in the workflow and assigned the role of manager to it. When a manager clicks the Quick View icon, the Manager step displays as shown:

 Image Modified

You will see the following on the Quick Approval Screen:

...

View My Task

Users logged into  are frevvo are able to view workflow steps that they performed by clicking the View My Task icon in the Audit Trail. When you are viewing your task, you may notice the read-only view watermark. This is to remind you that you can view the information but can not make changes to it.

...

Here is how you find it:

  1. Login to your tenantfrevvo tenant.
  2. Click on My Tasks (or if you are using a spacefrevvo space, click the Important Items tab, then Task List.)
  3. Click the  Search icon
  4. On the "eave the default selection "Participant."
  5. Type a keyword from the name of the workflow you are looking for, i.e. "time". A list of possible matches appears. Select the correct one. Click Submit.
  6. Search for your task in the returned List.
  7. Click the  Audit icon to display the Audit Trail. This will show you where the workflow is - in this case, it is still sitting at the Manager step waiting to be approved.

  8. Click the  View icon to  display the workflow step. This allows you to see all the information you entered when you filled out the form.
  9. Click the  Audit Trail icon again to return to the Task List.

...

Note

If a task is loaded from the task list but not submitted, the lock will be released when that user's frevvo session expires or the user logs out. You can set the Session Timeout in your in-house installationfrevvo installation. Tenant Admins can manually end sessions using the Manage Sessions page.

...

In many real world workflows such as a loan or job application, the first one or more steps are often performed by people that do not have a user account in the  tenantfrevvo tenant. You can send the workflow back to this person by selecting Assign to: an email address. All signatures in workflow steps along the way will be removed - the user will have to sign again. You cannot reset a task to a Summary Step. 

...

The tenant/workflow admin clicks the  icon. To move this saved form to a different user's task list, enter the user id of the the person you want to assign it to by checking the user choice radio button in the Assign to: control. Type a username in that field and all users beginning with the letter you have entered appear as dropdown choices. Enter the reason for the reassignment in the Reason field and click submit. In the image below the workflow admin, Jerry has reassigned the task to the username jill.

...

Now when Sally next logs into her account frevvo account she'll no longer see this saved form on her task list. When the user jill logs into she frevvo she will see Sally's saved form on her task list and can perform, complete and submit the form.

...

The tenant/workflow admin can also move a saved form or any saved or pending workflow to one or more roles. In the example above imagine that the user jill is also unavailable. The tenant/workflow admin can again search for the loan application form saved by Sally and click modify but this time check the one or more roles radio button then select a role from the Assign to a different role dropdown. Click the plus icon to select multiple roles.
Image RemovedImage Added

The saved form will appear on the task list of all users that have that role(s).

...

  • Searching the workflow to locate the task.
  • Click the Modify this Task icon.
  • Check email address in the Assign To: field
  • Provide the new email address and a reason
  • Click Submit.

Image RemovedImage Added

A "Task Successfully Modified" Message displays.

Image RemovedImage Added

An email is sent to the new email address with a link to the Approval step of the workflow. If the original recipient clicks the link in the email that they received, they will see a message informing them that the submission has already been processed.

...

The Task Search history only displays forms and workflows which have the Show in History property enabled. This property is configured by the form or workflow designer. If you don't see a form appearing in your history, contact your tenant administrator or the workflow designer and ask them to enable this feature.

Image RemovedImage Added

You can only search for tasks of one form or workflow. You can search for tasks by:

...

If all the Submission Status boxes are unchecked and the Submit button is clicked, the following warning displays:
Image RemovedImage Added
This message will clear if you click the Reset button.

...

Expand
titleClick here for information about setting up search criteria using fields from your form/workflow.


Excerpt

The Filter Form/Workflow by data section of the Search screen allows you to optionally setup additional search criteria using the Searchable Fields configured for the form/workflow. The Condition column provides the available conditions based on the type of field, and the Value column allows you to enter matching values. The filter logic can be edited using AND and OR, etc.

Condition Column

The Condition column choices depend on the data type of the selected field. The data types and their corresponding options are shown in the table.

Data Type(s)Conditions Available in the Dropdown List
Date, Time, Date/Timeis equal to

is not equal to

is after

is before

is on or before

is on or after

is within last

contains a value

does not contain a value
Number, Money, Quantityis equal to

is not equal to

is greater than

is less than

is greater than or equal to

is less than or equal to

contains a value

does not contain a value
Text, TextArea, Email, DropDown, Radio, Checkboxcontains

does not contain

begins with

ends with

is equal to

is not equal to

contains a value

does not contain a value
Boolean Checkboxis equal to
Value Column

The values entered into the Value Column depend on the field type and also sometimes upon the condition chosen. The allowed values for Field Type(s) and conditions are listed in the table.

Field TypeConditionValue Entry Field TypeNotes
DateAny except 'is within last'Date Picker
TimeAny except 'is within last'Time Entry
DateTimeAny except 'is within last'Date and Time Picker
Date, Time, DateTime'is within last'Special time duration entry field.Enter a duration in Years:Months:Days:Hours:Minutes. Any field to the left may be omitted. For example, 2 days and 4 hours may be expressed as 0:0:2:4:0 or as 2:4:0.
Number, Money, Quantity
number field
Text, TextArea, Email, DropDown, Radio, Checkbox
Text field
Boolean Checkbox
drop down containing true and false options

For Example, if you select a Date field, the Date Picker is provided to help enter the value. If you select a Text field from your form/workflow, you will be prompted to "Enter text".

Info

A Date, Time or Date/Time field with the "is within last" condition selected, requires a special time duration entry. The duration must be entered in this format: Years:Months:Days:Hours:Minutes. Fields to the left may be omitted. For example, if you were searching for tasks performed in the last 2 hours you can enter 02:00 or as 2:0. To search for tasks within the last 2 months and 12 days, enter 02:12:00:00.

If you enter an invalid value, an error will display with instructions:

Editing the Logical Expression

If you want to modify the logical expression, click the Edit button. The logic expression becomes editable.

The Logic Expression allows you to customize and combine the filter conditions using ANDs and ORs as well as parenthesis () to group terms of the expression.

  • Each filter item (expression) is represented by a letter (A for the Date range or B for the State or a number that corresponds to the row of the sub-expression in the Other Filter Items grid).
  • Combine the letters and numbers using parenthesis to group items as needed.
  • Build the logic of the overall predicate expression using AND and OR as appropriate.
  • Click save when done to save the expression. Please correct any indicated parse errors in order to save.

Searches are initialized with the data entered as part of the previous search performed in the current web session. The one exception to that is the Filter Form/Workflow by data table which will always start out empty.

The Reset button clears all filter fields with the exception of Submission Status which is reset to all checkboxes checked.

Task List Search Example

The image shows an example of a Task search screen and the results displayed. Manager Jerry is searching for:

  • Tasks in all submission states for Simple PO Workflows for companies named Alpha or Bravo.
  • There is a field in the Simple PO Workflow named ClientName that has been set up as a Searchable field.
  • The Purchase Order Workflow is selected from the Form/Workflow search box (type in a keyword, then select from matching options).
  • The field named ClientName is selected from the Field dropdown.
  • The condition for the ClientName field is contains.
  • A value of Alpha is entered in the Value column on the first line.
  • Jerry clicks the  icon and adds another line where the value of the ClientName field is Bravo.
  • Jerry clicks the Edit button and changes the logical expression from 1 AND 2 to 1 OR 2 and clicks Save.
  • He can also select the Start and End Dates and verifies that all the submission status checkboxes are checked
  • He clicks Submit.


The results show a Simple PO Workflow for each company currently in a pending state. Checking the Audit Trail reveals that the task is on his Task List and is locked by him.



Image RemovedImage Added
Workflows only appear in your search results if you performed one or more steps in the workflow. Workflows will NOT appear in your search results just because it was at one point in time on your task list but was performed by a user other than you. For example if a workflow is on your task list because you have the role (ex: Managers) to which a particular workflow step is assigned, but this step is performed by another user with that role, then this task will not appear in your search list.

...

Select a Form/Workflow from the search box (type a keyword and select from matching options) and the Filter Form/Workflow by data table becomes visible and enabled. The Filter Form/Workflow by data topic explains how to set up filters using form/workflow fields.

Image RemovedImage Added

The tenant admin search screen includes an additional For Admin User Only section. This section gives the tenant admin the ability to search tasks by user name, tasks by a particular user in a locked state and all locked tasks

...

Here is how an embedded tasks list looks. Even when embedded, the task list is always protected by a login dialog. So if you have not already authenticated to  you frevvo you will be prompted to enter your  username frevvo username and password. The login then automatically redirects each person to their own personal task list.

...

Tomcat 8.5 doesn't allow curly braces in URLs since they are not valid URL chars and deemed a security vulnerability. currently frevvo currently support parenthesis as well as curly braces. However, if you are embedding forms, workflows or the Task List in your website, change the markup to use parenthesis (). Support for curly braces {} will be dropped in a future release.

...