Use the worklist

You can open the form associated with a Worklist task for viewing, editing, or completing an action.

1. From the Worklist, open the action menu next to a worklist task.
   
2. From the action item menu, click the Open Form icon.
   
3. View or edit the form as required. (The form shown below uses the Workflow panel to complete the workflow task. Your form may look different, depending on how the form was designed by the application creator).
   
4. Click Save to save any changes made to the form.
5. In the workflow panel on the form, select an action from the Select Action drop-down menu and click Submit, otherwise click Cancel or close the form without completing the task.

A blue circular icon shows that a task item's status is Available. When in Available state, a work item can be opened and processed by all users who have that item in their worklists. Hover your mouse over the blue icon to display the status.

1. In Worklist, open the action menu next to a task.
   
2. Click an appropriate action to complete the task. In the example below, the available completion action for this task is Approved. (The actions shown will depend on the workflow design and whether the actions were configured to be available without having to open the associated task form for the task).
   

You can complete multiple tasks at the same time using the batch action feature.

1. On the top right-hand side of the Worklist, click the multi-select icon to display selection boxes next to each work item in your Worklist.
2. Use the check boxes to select the work items that you want to select, or check the very top box to automatically select all tasks in your Worklist.
   
3. Open the action menu for a selected Item and select the common action you wish to perform on all the checked items.

You can share a task from your worklist with other users. For example, if Department A has a backlog of work to process and Department B is assisting to reduce the backlog; then Department A shares their worklist items with members of Department B. The original user continues to own the shared item and can still complete the task.

1. In Worklist, open the action menu next to a task.
   
2. On the action item menu, click the Share icon.
   
3. Click the Add link to add one or more users to share the task with (after you add a user, you can remove that user using the Remove link).
   
4. Enter the name of the person that you want to share your task with in the Search box and click the magnifying glass icon.
   

To refine your search, click the down arrow next to Search and select to limit your search by match option or security label. When searching for a user with a security label other than Azure Active Directory (AAD), all the Match filters are available for use. If the security label is AAD, only the Begins With filter is available.


Microsoft Azure Active Directory is now Microsoft Entra ID



5. Click to select one or more users that will share your task, making sure that the selected names are highlighted.
   
6. Click OK. The task is shared with the person or persons that you selected.

You can redirect a task to another person, which removes the task from your worklist. For example, if you are responsible for Department A tasks and accidentally receive a task for Department B; you can redirect that task to the correct person in Department B.

1. In Worklist, open the action menu next to a worklist task.
   
2. On the action item menu, click the Redirect icon.
   
3. Type the full or partial name of the person that you want to redirect your task to in the Search box and click the magnifying glass icon.
   

To refine your search, click the down arrow next to Search and select to limit your search by match option or security label. When searching for a user with a security label other than Azure Active Directory (AAD), all the Match filters are available for use. If the security label is AAD, only the Begins With filter is available.


Microsoft Azure Active Directory is now Microsoft Entra ID



4. Click to select the person that will receive your task.
   
5. Click OK. The task is removed from your worklist and redirected to the person that you selected.
   

If you opened a task but did not complete it, you can release the task to make it available to other task recipients again. Releasing a task returns the task to available status.

1. In Worklist, open the action menu next to a worklist task.
   
2. On the action menu, click the Release icon. (The Release icon is only available if the task is assigned to multiple recipients or was shared with another person.)
   
3. The task is released and is available for other recipients to open.

You can delay acting on a task in your worklist until a later date. Choose to delay acting on a task until a preselected time (Basic) or a date that you specify (Date) occurs. For example, if your schedule prevents you from completing tasks until the next day, you can choose to delay your action until the following morning or afternoon.

1. In Worklist, open the action menu next to a worklist task.
   
2. On the action menu, click the Sleep icon.
   
3. To set up a Basic sleep option, click the Basic radio button followed by the radio button for your selected basic option.
   

Where:

• Breakfast tomorrow – The item is paused until 8 AM the following day.
• Lunch tomorrow – The item is paused until 1 PM the following day.
• In a week from now – The item is paused until 8 AM the following week.
4. To set up a custom Date sleep option, click the Date radio button and type a date in the Start Date box or click the calendar icon to select a date.
   
5. Click OK. The task is removed from your worklist and delayed until the selected sleep interval has passed.
   

If you accidentally sleep a task or need to access a sleeping task before the sleep interval has passed, you can use the Filter icon to edit the default filter to show sleeping tasks, as shown below. Once you have completed the task, remember to revert the filter back to the previous value so that the worklist will not show sleeping tasks.

You can refine a Worklist to only display the workflow items that you need to see by using the search and filter functions. For example you may only want to see all the expense claims needing approval at the end of a month. By selecting the search icon, you can display only the workflow items that match your search request.

For example, the following figure shows a quick search for visible fields that contain the word "West." Clicking the arrow next to "Search" enables or disables a "Match" search refinement option to further limit your results. For example, selecting "Begins With" instead of "Contains" limits the results to only workflow items that begin with "West".

By selecting the filter icon, you can modify the default filter and sorting parameters for your worklist.

Selecting the Filters tab allows you to customize the information that shows in your worklist .You can configure multiple filters by using the Add button. When changing the filter, the filter is only valid for the duration of your current browser session. For example, if you open another browser session you must configure the filter again.

Selecting the Sorting tab allows you to customize the order that items show in your worklist. You can configure multiple sorting options by using the Add button.

Although the default filter and sorting options work well for most applications, you have the ability to customize those options to best fit your specific business application.

When applying a filter to the Worklist at runtime, the filter overrides the one created in design time and persists per user.

Sort items according to status by clicking on the arrow. Available items display with a blue icon and open items have no icon.

Use the View Flow page to view where your task is in the workflow and the various routes it can go before the workflow completes.

1. In Worklist, open the action menu next to a worklist task.
   
2. Click View Flow from the action menu.
   
3. To interpret a View Flow diagram, remember:
   • Line Rules that evaluated true and were successful are colored green
   • Line Rules that evaluated false and were not successful are colored red
   • Skipped lines or not yet evaluated lines are gray
   • Green workflow steps indicate that the step was successful
   • Blue workflow steps indicate that the activity has started, and is in an Active or Running state
   • White workflow steps indicate that the step has not yet been executed
   • Blue events with red exclamation marks indicate that the event is currently in an error state
   
4. Click the workflow Start step to view the Process Instance Detail report for the entire workflow. See the Process Instance Detail section for more information.
   .
5. Click a workflow step to view the Activity Instance Detail report for that step. See the Activity Instance Detail section for more information.
   

Out of Office settings can be configured using the Out of Office icon in Worklist.

For more information of configuring Out of Office using Worklist see Out of Office.

Out of Office Notifications

The Out of Office (OOF) Notification allows all forwarded users to receive an e-mail notification regarding delegated tasks when a specific user is out of office. Take note of the following considerations:

1. The notification sent to the forwarded (delegated) users is not customizable.
2. The notification is only sent to forwarded users if the task is sent while the original user's out of office setting is turned on.

Disabling the Out of Office Notifications

Disabling this notification requires a change to the K2HostServer.exe.config file.

1. Open the K2HostServer.exe.config file from the following location: "%ProgramFiles%\ K2\ Host Server\ Bin\"
2. Locate the following line in the K2HostServer.exe.config file:
   <outOfOffice notificationsEnabled="True" />
3. Change the value from true to false as shown below:
   
   

   The value is set to true by default.

4. Save and Close the K2HostServer.exe.config file.
5. Restart the K2 Service.

Example

The following example illustrates the Out of Office functionality using a multiple approval step workflow for a Customer Onboarding process. A user’s tasks are delegated to multiple users when they are out of office.

1. When a new customer is created via a form, the workflow starts and the task is sent to the appropriate users in the first approval step. For this example the task is sent to Ashley.
   
2. Ashley receives an email notification that she has a new task. Since Ashley is currently out of the office, her tasks are forwarded to two other users, Barry and Codi. The figures below show all three email notifications sent by the server.

   Ashley's

   

   Barry's

   

   Codi's

   
3. The task is approved by Codi and she receives an approval email.
4. The workflow moves to the second approval step containing an out of office exception rule that forwards the tasks to three other users. For the purpose of this example, the notifications are sent to Dennis, Eric and Holly via the exception rule. Any of the three forwarded users can action the task by responding to the notification or opening the task from their Worklist.

   Dennis's

   

   Eric's

   

   Holly's