Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Migrated to Confluence 5.3
Section
Column

The version 5.1 Task List has a different look and feel than previous releases. 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.  See images below.

Selected tasks will display with a blue background. Updates to the task list occur automatically every five minutes and a new icon is provided to manually refresh the list.

The improved task list in version 5.1 allows quick and easy approval/rejection/update of a task for the workflow manager. For example, it is very common for workflows to consist of an initial form followed by many approvals. In previous versions, the approver had to perform the task, load the entire form, view the request, check an Approve box, enter a comment, sign a section then send the task to the next step in the flow. The Quick View feature makes it very easy to approve something without viewing the entire form.

The Task List theme overrides all forms/flows themes. If none is specified, it defaults to Nouveau.

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

Desktop/Tablet View of the Task List  

Column
width240px

On This Page:

 

Table of Contents
maxLevel1

...

Quick View will display the appropriate Approval Control section of the form to the right/below the task list. An Approval Control is any section in the form that contains a text area control directly inside of it. It can be named anything. The section cannot have any other control in it and it can be anywhere in the form with one exception - nesting an approval control inside a repeat or a signed section is not allowed. Regular text digital signatures for the approval section are supported. Let's consider a Leave Approval workflow with two activities: the first activity is a form which collects the pertinent information about the Leave request - employee name, starting date and duration of leave, etc. This step can be filled out by any employee requesting a leave. The second step in the flow 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 flow and assigned the role of manager to it.  When a manager clicks on the Quick view icon, the approval control in the form will display as shown in the image below. 

You will see the following on the Quick View Screen:

  • A summary text area that can be used to give a description of the task at the top. This is configurable by the designer and can be templatized via the "control" dropdown. See Setup Quick View for the details.
  • A text area in which the person who is viewing the task can enter a comment. Entering a comment on the Quick View screen is the same as typing the comment directly into the form.
  • Approve button. Clicking this displays the message "Task successfully approved" and moves the workflow along to the next step. The task will disappear from your task list.
  • Reject button. Clicking this rejects the task and sends it back to the immediate previous step. The message "Task successfully rejected" will display.
  • Details button. Clicking this will display the form as usual. This action is identical to clicking on the perform this task icon. Clicking on the Details button will lock the task.

...

  •  - The task can be continued (displayed for saved & pending events, and pending flows)
  •  - This task was modified and reset to this step
  •  - This task was finished
  •  - The task is paused (displayed for saved forms/flows)
  •  - The task is aborted
  •  - The task has been reassigned to another user or role by an administrator.

Here is the event history for a workflow that was initiated by an anonymous user ("By: "). Next the task was performed by the user m1. Next user s1 modified the task and reset it back to a step previously performed by user m1. This workflow now resides on the task list of user m1.

...

The image below shows the Task List of Manager Jill Burns after Manager Jerry Mouse has claimed the Leave Approval submitted by employee Tom Cat. Note that the error message shows the user who has locked the task, in this case, Jerry. You can also hover over these icons to display a tool tip with the username of the person who currently has this task locked. If a task is currently locked, the last entry in the audit trail will show who locked it and when.

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. 

Section
Column
width30%

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

Column
width30%

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/Flows.

Column
width30%

The icon will display if the task was locked:


 

Modify A Task

A workflow can be sent back to a person who performed one of the prior step by clicking the  icon. The reset action can be done by any user that has the task pending on their list.

...

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  tenant. You currently cannot send the workflow back to this person. The task can only be sent back to a person with a user account in the  tenant.

By Admin

The tenant admin user has special modify permissions. In addition to reset to stepYou cannot reset a task to an activity with a precondition. All signatures in activities along the way will be removed -  the user will have to sign again. You cannot reset a task to a Summary activity.

By Admin

The tenant admin user has special modify permissions. In addition to reset to step, the tenant admin can:

  • Abort a pending task
  • Reassign a pending task to a different user
  • Reassign a pending task to a different role

...

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 form/workflow designer and ask them to enable this feature.

Image RemovedImage Added

You can narrow your search to specific forms or flows and also to a specific date range when you performed that task, submission status and only tasks that ended with errors.

Workflows only appear in your search results if you performed one or more steps in the flow. 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 flow step is assigned, but this step is performed by another user with that role, then this task will not appear in your search list.

Search History - By Admin

When you click the Submit button, the Search Results will display. You may notice the Image AddedRefresh icon is no longer visible. This is as designed. There is no Refresh capability available for Search results.When you click the Cancel button, you will see the message "Your search was cancelled" and the Task List is accessible.

Search History - By 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.

...

Here is how the 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.

For this version, embedding the task list successfully into an HTML page requires setting its width. See URL Parameters for more details.