Versions Compared

Key

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

...

...

...

...


Section


Column

The  Task List is an electronic listing of workflow tasks that require a user's attention. It is similar to an email Inbox. Users must log in to to access their task list. Tasks display in a small area on the left side of the screen. Clicking on an icon to perform a task related function will display any associated screens to the right or below the task list depending on it's state. 

Selected tasks will display with a blue background. An icon is provided to manually refresh the list.

Image Modified

Desktop/Tablet View of the Task List  


Column
width240px

On This Page:

 

Table of Contents
maxLevel2


You will notice a different look and feel when the Task List runs on an iPhone.

Image Modified

Task List on the iPhone

Task List

...

  • You clicked the save icon on a form or workflow which had the saved/load feature enabled.
  • workflow was directed to you to perform the next step in the workflow. 
  • A workflow was directed to a role (ex: Manager) to perform the next step in the workflow, and you have that role. See embedding your task list

You will see your tasks when you login. If your user account has the special frevvo.designer role, you must click on the My Tasks tab to view your tasks. Customers using a  space, may have to click on the Important Items tab to access the Task List. The icon expands and contracts the task list . It will show a menu with two selections, My Tasks and Shared Items when it is expanded. A contracted Task list will show the associated screens to the right while an expanded Task List displays the screens below it.

Image Modified

Image Modified

Your tasks will be grouped by workflow. For Example, all expense reports waiting for manager approval will be listed under the Expense Report workflow and vacation requests listed under Leave Approval. You can manually expand or contract the tasks for a specific workflow by clicking anywhere on the workflow title bar.

The  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 timezone.on desktop and mobile devices. Task information, intended to provide additional information about the task for the user who is going to perform it, is configurable by the designer and appears in the bottom left.

Image Modified

My Tasks Menu

...

  • Quick View the task without displaying the entire form. Quick View allows the user who's responsibility it is to review the task (manager, supervisor, reviewer etc.) to add a comment, approve or reject, sign and pass it to the next user in the workflow. Quick View is enabled by the designer. See below for the details.
  • Perform the task. This icon is red when the task is locked by you so that only you can perform it. No other users with your role can perform this task unless you unlock it . The icon is blue when the task is shared between multiple users, for example when the task is assigned to a role i.e. group of users.
  • Abort the task. The abort icon will only display if the user is a workflow administratortenant admin or a designer user. 
  • Modify allows you to send the task back to a prior step, abort, reassign or reset the task. The Modify icon will only display if the user is a workflow administrator, tenant admin or a designer user. 
  • Lock the task so you can perform it later.
  • Unlock the task and return it to the task pool.
  • Audit Trail displays the event history for this specific task. For workflows you will see all the users that have participated in the workflow thus far. For saved forms & workflows you will see each time you clicked save.

...

When a task step is assigned to a role rather than a specific user, that task will simultaneously appear on the task list of all people with that role. The first person that clicks the perform or lock icon will in effect claim that task. At this point all other users with this role can no longer perform this task. They will see the perform icon change as shown below to a indicate that it cannot be clicked. View the audit trail or hover over the icons to display a tool tip with the username of the person who currently has this task locked.

Image Modified

Quick Approval

...

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 View feature for this step in the workflow and assigned the role of manager to it.  When a manager clicks on the Quick view icon, the Manager step displays as shown:.

 
Image Modified

You will see the following on the Quick Approval Screen:

...

A task will also appear in your task list if you clicked the save icon/button on a form/workflow in order to complete it at a later time. When you click the perform icon for a saved task, the form/workflow will load back into your browser with all the form field values as you left them when you last clicked save.

Image Modified

If the task displays the disabled icon, this indicates that the task is currently being performed by another person or that another person has clicked the lock icon to reserve the task. When this is the case, the only person that can complete this task is the person with the lock. View the audit trail or hover over a locked task to see who holds the lock. You can ask that person to unlock the task if you want to perform it. You can also ask your tenant administrator to unlock a task.

Image Modified

If you see the error in the image below when clicking on the Perform this Task icon on the Task list, it is most likely because the visibility of the workflow is set to private instead of public in tenant or public. Notify the form/workflow designer that you are receiving this error.

Image Modified

The Unsaved Changes Warning Message displays if data is changed when performing a task and the changes are not saved i.e. clicking theInbox icon without saving the changes.
Image Modified

Audit Trail

...

Here is the event history for a form that was saved twice and not yet submitted.

Image Modified

Each events contain the following information:

...

Here is the event history for a form that was saved thrice and then submitted.

Image Modified

The icons displayed at the left of each event indicate:

  • - The task can be continued (displayed for pending events, and pending workflows)
  •  - Displayed for saved forms
  • - This task was modified and reset to this step
  • - This task was finished
  •   - The task is locked by a user
  • - The task is aborted
  • - The task has been reassigned to another user or role by an administrator
  • Image Removed Image Added - User can view every completed task in a workflow that the user performed. The legacy anonymous task is also supported. Refer to View My Task for the details

Here is the event history for a Mortgage Application workflow that was initiated by an anonymous user ("By:Anonymous "). Next the task was performed by the manager Jack Smith. Next supervisor Sam Spade rejected the task back to the step previously performed by the manager. This workflow now resides on the manager's Task List.

...

Here is the event history of a 2nd Mortgage Application workflow. The workflow was initiated by an anonymous user (John Johnston) and then approved by manager Jack Smith. The tenant admin, Carrie Castle, then aborted the task. Abort removes the task from everyone's task list. This task can still be found by any user that performed one or more steps or by the tenant admin via Search History.

Use the history message property to add custom messages to the audit trail for the steps of a workflow.

...

Workflows that assign the step to an Email Address show the step performed by the customer (anonymous user) in a Pending state and displays the Email address it was sent to.

Image Modified

View My Task

...

  1. Login to your tenant
  2. Click on My Tasks or Task List under Important Items if you are using a space
  3. Click the Search icon
  4. Select the workflow from the dropdown and set any other search criteria. Click Submit. 
  5. Search for your task in the returned List.
  6. Click the  Audit icon to display the Audit Trail
  7. Click the View icon to  display the workflow step.
  8. Click the Audit icon again to return to the Task List.

...

The Audit Trail will show the View icon on the step pending for HR. The  employee clicks the View icon and the workflow opens on the Employee Information step. The employee clicks the Next button to navigate through all four screenflow steps.
Image Modified

To return to the beginning of the screenflow from any of the viewed steps, click the Audit Trail icon then the  View icon.

Sue, an employee in the HR department, completes her workflow step. Sue searches and finds her completed task, clicks the Audit Trail then clicks on the  View icon. Note, Sue only sees the View Icon on the the HR review step that she performed.
Image Modified

Info
  • If a screenflow is configured with the Navigation toolbar or the workflow contains a Summary step, the user can navigate backwards when viewing. Otherwise, they can only move forward to view the steps.
  • Screenflows using Save on Navigate, will show an audit record for each screenflow step. The View icon will be on the last step only but when clicked it will open the screenflow on the first task step. This is as designed.
  • If your workflow was created in a version of Live Forms previous to v8.0, then the steps  performed by anonymous users show the task in a WAITING state. In version 8.0, these steps display with a Pending state and show the Email address it was sent to.

...

The View My Task feature eliminates the need to design workflows that send an Email with a PDF attachment after each step is executed to provide users with a way to keep track of submitted data. You can simply use the Task Search to find your workflow and then use the Audit trail to view the information you submitted.

...

Some task do not display lock/unlock icons. A workflow step assigned specifically to you, rather than a role, must be performed by only you. In this sense such a workflow is currently locked for only you to perform.

Image Modified

The same is true for saved forms. Saved forms must be performed, completed and submitted by the person that started them. They cannot be unlocked back to a pool of users to complete. 

Once a task is locked, all other users with this role can no longer perform this task. They will see the perform icon for this task on their task list change as shown below to a indicate that they cannot be clicked:

Image Modified

The image below shows the Task List of Manager Jack Smith after Manager Jerry Mouse has claimed the Expense Report submitted by employee Giorgio Armani. Clicking on the perform icon will not display the task. If you hover over these icons to a tool tip with the username of the person who currently has this task locked displays. If a task is currently locked, the last entry in the audit trail will show who locked it and when.

Image Modified

You can ask that person or your tenant administrator to unlock the task if you want to perform it. 

Section


Column
width30%

Image Modified

To lock/unlock a task on the iPhone, touch the Edit button on the Task List.  


Column
width30%

Image Modified

Check the checkbox that appears to the left of the task. Touch Lock to lock the task or Unlock to unlock the task. This checkbox is not available for Saved Forms/Workflows.


Column
width30%

Image Modified

The green dot displays when the task is locked.


...

Designer users and workflow administrators will see the  Modify this Task icon when the task appears on their task list. The tenant/workflow admin/designer user performs a search to locate the task then click the  Modify this Task icon. Clicking the Modify this Task icon on a Saved task presents this screen without the Reset to Step section.

...

  1. Click on theModify this Task icon.

  2. Select the step in the workflow that you want to send the task back to from the Reset to Step dropdown. To send the workflow back to the Loan Application step performed by the user (Sheila Wallace), jerry selects this choice from the dropdown. The sections of the screen for aborting and reassignment collapse.
  3. Fill in the Reason for the modification. Click submit. The task disappears from Jerry's task list and appears on Michelle's task list.



The  message message will display.

User Michelle receives an email informing that she has a new task for the Loan Application workflow. The email contains a link to her task list. She will have to log in to access it.

...

The tenant admin must perform a search to locate the task then click the  abort this task icon. 

In all three cases, clicking the icon displays the following message to confirm the abort: 

Image Modified 

A task can also be aborted by checking the Abort this task checkbox after clicking the modify this task icon for that task. Checking "Yes" for the Abort this task question collapses the Reset to Step section. A required reason for aborting the task must be entered before clicking Submit. The reason will be visible in the audit trail.

Reassigning a Task

Reassigning a workflow task to another user/role can be done automatically via workflow escalation or performed manually by administrators. Tenant/workflow admin users can modify both workflows and saved forms. This gives the admin the ability to move a saved form or a pending workflow step from one user's task list to another.

...

Imagine that Sally in the mortgage processing department was working on a mortgage application and had saved the loan form. Sally then left for a week vacation. The tenant admin can login and search for all forms saved by Sally. Workflow administrators can search for all saved forms associated with the mortgage application workflow. Here we see the loan application task she was working on.

Image Modified

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.

Image Modified

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

...

A "Task Successfully Modified" Message displays.

Image Modified

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 Audit Trail shows the original and reassigned email addresses.

Image Modified

Warning
  • The ability to reassign a workflow step to another email address is not available for workflows created in earlier releases that contain an EMail/Anonymous Task step.
  • The PENDING status shows as WAITING in the Audit Trail for workflows designed with an EMail/Anonymous Task step.

...

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 ANDs and ORs, 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.
Image Modified

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

Image Modified

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 Simple PO Workflow is selected from the Form/Workflow dropdown.
  • 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 Image Modified 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.
    Image Modified

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.




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.

...

If no matching tasks are found as a result of your search, you will see this message:

Image Modified

By Tenant Admin Admin

The tenant admin user is able to search for tasks that were performed by other users. The search history form for the tenant admin has several additional search criteria fields.

Select a Form/Workflow from the dropdown 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.

...

The task list can be made conveniently available in your own web site. By embedding the task list you can access your tasks without having to login to the frevvo web UI directly. This gives the feel that the task list is part of your company portal. To do this click on the Embed icon and copy the task list embed script into your web page.

Image Modified

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 will be prompted to enter your  username and password. The login then automatically redirects each person to their own personal task list.

Image Modified

Info

LDAP SSO customers must make one change to the script to successfully embed the Task List in your website. Replace the {tn.id}  in the script with your tenant id. The example shows a modified script for a tenant named ldap:

Original script:

  <script src="https://app.frevvo.com:443/frevvo/web/embed?resize=true&container=true&border=false&url=https://app.frevvo.com:443/frevvo/web/tn/{tn.id}/subject/{subject.id}/tasks%3fembed=true%26container=true%26resize=true"
                    type="text/javascript"></script>

Script modified with tenant name:

<script src="https://app.frevvo.com:443/frevvo/web/embed?resize=true&container=true&border=false&url=https://app.frevvo.com:443/frevvo/web/tn/ldap/subject/{subject.id}/tasks%3fembed=true%26container=true%26resize=true"
                    type="text/javascript"></script>        

...

Tomcat 8.5 doesn't allow curly braces in URLs since they are not valid URL chars and deemed a security vulnerability. 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.