10.2 Managing Your Tasks

The My Tasks action lets you check your workflow queue for tasks that have been assigned to you. When a task is in your queue, you need to perform one of the following actions:

NOTE:You must have the appropriate authority to reassign tasks. To reassign a task, you must be a Provisioning Application Administrator or a Team Manager who has been given this permission in the team rights definition.

When you’ve claimed a task to work on, you have the ability to take an action that forwards the workitem to the next activity within the workflow. The actions you can perform on a claimed task are described below:

Table 10-1 Forward Actions

Forward Action

Description

Approve

Allows you to give your approval to the task. When you approve the task, the workitem is forwarded to the next activity in the workflow.

Deny

Allows you to explicitly deny your approval to the task. When you deny the task, the workitem is forwarded to the next activity in the workflow and the request is denied. Typically, the workflow process terminates when a request is denied.

Refuse

Allows you to explicitly refuse the task. When you refuse the task, the workitem is forwarded to the next activity for the refused action in the workflow.

10.2.1 Viewing Your Tasks

To see the tasks that have been assigned to you:

  1. Click My Tasks in the My Work group of actions.

    The list of tasks in your queue is displayed.

    The Type column in the task list includes an icon that indicates whether the task is currently assigned to a user, group, delegate, or to multiple approvers. The type Assigned to Multiple Approvers applies in the following situations:

    • The task has been assigned to a group of addressees, but only one addressee can claim and approve the task. After this approval is given, task execution is considered complete.

    • The task has been assigned to multiple addressees, and all of them must claim and approve the task before the activity can be considered complete.

    • The task has been assigned to multiple addressees, and a quorum of users must claim and approve the task before the activity can be considered complete. The definition of a quorum is configured by the administrator. To define the quorum, the administrator specifies an approval condition that specifies the precise number of approvals or the percentage of approvals needed.

    The workflow system performs short circuit evaluation to optimize quorums. Whenever a quorum approval condition reaches the point where a quorum is not possible, the activity is denied and the task is removed from the queues of all addressees.

    The Priority column shows a flag for the high priority tasks. You can sort the list of tasks by priority by clicking the Priority column.

10.2.2 Selecting a Task

To select a task in the queue list:

  1. Click the name of the task in the queue.

    The Task Detail form is displayed.

    When a task is assigned to multiple approvers, the Task Detail form displays the Multiple Approvers icon next to the Assigned To field, and displays text below the icon to indicate that multiple approvals are necessary.

    Task Detail form
  2. To display more information about a task assigned to multiple approvers, click the text under the Multiple Approvers icon:

    Task Detail form continued

    A pop-up window displays to indicate how many approvals are required, who the current addressees are, and what the approval status currently is.

    Multiple Approvers screen

    The requirements for the task depend on how the task was configured by your administrator:

    • If the approval type is group, the task has been assigned to several users within a group, but only one is expected to claim and approve the task.

    • If the approval type is multiple approvers, the task has been assigned to several addressees, and all of the addressees must claim and approve the task.

    • If the approval type is quorum, the task has been assigned to several addressees, and a quorum of addressees is sufficient to approve the task. The definition of a quorum is configured by the administrator. To define the quorum, the administrator specifies an approval condition that specifies the precise number of approvals or the percentage of approvals needed.

    The workflow system performs short circuit evaluation to optimize quorums. Whenever a quorum approval condition reaches the point where a quorum is not possible, the activity is denied and the task is removed from the queues of all addressees.

  3. To claim a task, follow the instructions under Section 10.2.3, Claiming a Task.

  4. To view the comment history for the task, click View Comment History.

    A pop-up window lets you see user and system comments. The order in which comments appear is determined by the time stamp associated with each comment. Comments entered first are displayed first. For parallel approval flows, the order of activities being processed concurrently can be unpredictable.

    1. To display user comments, click Show User Comments.

      User comments include the following kinds of information:

      • The date and time when each comment was added.

      • The name of the activity to which each comment applies. The list of activities displayed includes user and provisioning activities that have been processed or are currently being processed.

      • The name of the user who made the comment. If the comment is generated by the workflow system, the name of the application (for example, IDMProv) is the user name. Comments generated by the workflow system are localized automatically.

      • The comment text, which includes the name of the user who is the current assignee for each activity.

      The workflow designer can disable the generation of user comments for a workflow. For more information, see the Identity Manager User Application: Design Guide.

    2. To display system comments, click Show System Comments.

      System comments include the following kinds of information:

      • The date and time when each comment was added.

      • The name of the activity to which each comment applies. When you display system comments, all activities in the workflow are listed. The list of activities includes those that have been processed or are currently being processed.

      • The name of the user who made the comment. If the comment is generated by the workflow system, the name of the application (for example, IDMProv) is the user name. Comments generated by the workflow system are localized automatically.

      • The comment text, which indicates what action was taken for the activity.

      System comments are intended primarily for debugging purposes. Most business users do not need to look at the system comments for a workflow.

    3. To scroll through a long list of comments, click the arrows at the bottom of the screen. For example, to scroll to the next page, click the Next arrow.

      Next arrow
    4. Click Close to close the window.

  5. To return to the task list, click Back.

10.2.3 Claiming a Task

To claim a task to work on:

  1. Click Claim.

    Claim button

    The Form Detail section of the page is updated to include the Deny and Approve buttons, as well as any other action buttons included by the flow definition, and the appropriate fields become editable.

    If the resource you’ve requested requires a digital signature, the Digital Signature Required icon appears in the upper right corner of the page.

    Digital Signature Required icon

    In addition, on Internet Explorer, a message appears indicating that you need to press the Spacebar or the Enter key to activate the digital signature applet.

    Internet Explorer message
  2. If you’re working on a task that requires a digital signature, perform these steps:

    1. If you’re using a smart card, insert the smart card into the smart card reader.

    2. On Internet Explorer, press the Spacebar or the Enter key to activate the applet.

      At this point, your browser might display a security warning message.

      Security warning
    3. Click Run to proceed.

    4. Fill in the fields in the approval form. The fields on the form vary depending on which resource you requested.

    5. Click the check box next to the digital signature confirmation message to indicate that you are ready to sign.

      The digital signature confirmation message varies depending on how the provisioning resource was configured by the administrator.

      The applet then displays a pop-up window that allows you to select a certificate. The pop-up window lists certificates imported to the browser as well as certificates imported to the smart card (if one is currently connected).

      Select Certificate window
    6. Select the certificate you want to use and click Select.

      Select Certificate window
    7. If you select a certificate that has been imported into your browser, type the password for the certificate in the Password field on the request form.

    8. If you select a certificate that has been imported to your smart card, type the PIN for your smart card and click OK.

      You do not need to type the password for the certificate if you’re using a smart card, because the certificate password has already been transmitted to the card.

      PIN screen

      If your administrator has enabled the ability to preview the user agreement, the Preview button is enabled.

    9. Click Preview to see the user agreement.

      If the digital signature type is set to Form, a PDF document is displayed.

      If the digital signature type is set to data, an XML document is displayed.

  3. To deny the request, click Deny.

    Form Detail page
  4. To approve the request, click Approve.

    Form Detail page

    The user application displays a message indicating whether the action was successful.