How to Create a New Task

Use the New Task page to create a task based on the task types provided. Tasks can be as general or specific as required.

See Task Types for the complete list of tasks types available in IdentityIQ.

  1. Click or mouse over the Setup tab and select Tasks to open the Tasks page.

  2. Select a task type from the New Task dropdown list to open the New Task page.

  3. Enter a Name and brief Description for the new task. This information is displayed on the Tasks table when the new task is saved.

  4. Select a Previous Result Action from the dropdown list. Delete is selected by default. Previous result actions determine how subsequent runs of this tasks react to existing task results.

    1. Delete – overwrite the previous task results with the new information.

    2. Rename Old – append a numeral to the name of the old task result and preserve both.

    3. Rename New – append a numeral to the name of the new task result and preserve both.

    4. Cancel – cancel the new run of the task.

    5. Optional: Allow concurrency. Select Allow Concurrency to enable two identical tasks to run at the same time. If enabled, allow concurrency appends a numeric value to the name of the task that started second. If disabled, the second task is canceled and an exception sent to the requestor.

  1. Optional: Require sign off.

    1. Select Required sign off to expand the Signoff Properties section.

    2. Select an email notification template from the Initial Notification Email dropdown list. For example, the Task Result Signoff template.
      Templates are created and defined when the application is configured.

    3. Specify the escalation criteria for the sign off request. Use the options displayed to set your escalation parameters.
      None – no reminder emails are sent and no escalation is performed for this work item.
      Send Reminders – email reminders are sent at the configured interval.
      Reminders then Escalation – the configured number of reminders are sent and then the work item is escalated to the signers manager.
      Escalation only – this work item is escalated after the configured interval with no reminders being sent.

    4. Specify the required signers.
      Enter the first letter, or letters, of an identity or workgroup to display a selection list of valid identities or workgroups containing that letter string or click the arrow to the right of the field to display all identities and workgroups and select a signer.
      You can add as many signers as required.

  2. Optional: Host. If you want to choose a specific host or set of hosts to run the task on, add a comma separated list of host names. If multiple hosts are specified, the task manager selects the first active host If there are no active hosts, or if an incorrect host name is given, the task terminates, and an error message is left in the result.

  3. Email Task Alerts. Choose an Email Notification type, if you want to send email notifications upon task completion, to the recipients whose email is being registered to receive the task status. These settings overwrite the email notification configured at the IdentityIQ Configuration level setting. Use these options to set your notification:

    Caution: If your installation has enabled the task reanimator service on the host where this task is run, be aware that when a task hangs and is restarted by the reanimator service, email task alert notifications may not be sent. For more information on the task reanimator service, see Hosts.

    • Disabled – no email notification will be sent.

    • Warning – email notification will be sent in case of any warning after completion of task.

    • Failure – email notification will be sent in case of task Failure.

    • Always – email notification will be sent at completion of task irrespective of the task status.

    • Email Notification Template – (Applicable only if Disabled is not selected) Select Task Status template to send emails on task completion. Templates are customizable.

    • Email Recipients – (Applicable only if Disabled is not selected) Select the identity to register them to receive task status notification on emails associated with it.

  4. Specify the task options required for the task you are creating. Each task type displays unique task options. See the Tasks Page for details on each type.

  5. Click Save to save the new task to the Tasks table, or Click Save and Executeto save the task to the Tasks table and run it immediately. The Tasks Results page displays when the task completes.

See Task Results Page.