Click Save. Click Add Rule on the Rule Elements tab. Select the rule element or rule to be deleted on the Rule Elements tab. Click Delete.

5-12 Oracle Fusion Middleware Developers Guide for Oracle Identity Manager 6 Developing Scheduled Tasks 6-1 6 Developing Scheduled Tasks Oracle Identity Manager contains a set of predefined tasks that can be scheduled as job runs. An example is a password warning task that sends email to users for password expiration. Oracle Identity Manager also provides the capability of creating your own scheduled tasks. You can create scheduled tasks according to your requirements if none of the predefined scheduled tasks fit your needs. For example, you can configure a reconciliation run using a scheduled task that checks for new information on target systems periodically and replicates the data in Oracle Identity Manager. This chapter explains how to create and implement your custom scheduled tasks. It contains these topics: ■ Overview of Task Creation ■ Define the Metadata for the Scheduled Task ■ Configure the Scheduled Task XML File ■ Develop the Scheduled Task Class ■ Configure the Plug-in XML File ■ Create the Directory Structure for the Scheduled Task

6.1 Overview of Task Creation

This section outlines the essential steps in creating scheduled tasks, and presents an example to illustrate the process. Subsequent sections provide details on each step. ■ Steps in Task Creation ■ Example of Scheduled Task

6.1.1 Steps in Task Creation

The basic steps for configuring new scheduled tasks are as follows: 1. Review Oracle Identity Managers predefined scheduled tasks to determine whether a custom task is necessary. For details about the predefined tasks, see Managing Scheduled Tasks in the Oracle Fusion Middleware System Administrators Guide for Oracle Identity Manager. 2. Determine key features of the scheduled task, such as the task name and the parameters that control the actions performed by the task. 6-2 Oracle Fusion Middleware Developers Guide for Oracle Identity Manager For details, see Section 6.2, Define the Metadata for the Scheduled Task . 3. Add the task metadata to the scheduled task XML file. For details, see Section 6.3, Configure the Scheduled Task XML File . 4. Develop the scheduled task Java class. For details, see Section 6.4, Develop the Scheduled Task Class . 5. Declare the new scheduled task as a plug-in. For details, see Section 6.5, Configure the Plug-in XML File . 6. Package the task files so that Oracle Identity Manager can locate the files and make the task available for jobs. For details, see Section 6.6, Create the Directory Structure for the Scheduled Task .

6.1.2 Example of Scheduled Task

To illustrate the steps in developing a scheduled task, we use an example scheduled task that retrieves employee records belonging to the given department from a given IT resource. In addition, our scheduled task should allow the user to specify the number of records to be retrieved and whether to include disabled records in the retrieval.

6.2 Define the Metadata for the Scheduled Task

Each scheduled task contains the following metadata information: ■ Name of the scheduled task ■ Name of the Java class that implements the scheduled task ■ Description ■ Retry Interval ■ Optional Parameters that the scheduled task accepts. Each parameter contains the following additional information: – Parameter Name – Parameter Data Type – Required Optional Parameter – Help Text

6.3 Configure the Scheduled Task XML File

Configuring the scheduled task XML file involves updating the XML file that contains the definitions of custom scheduled tasks. This section describes how to update the task XML file with the details of the new custom scheduled task. You can modify the task.xml file located in the db namespace of Oracle Identity Manager MDS schema, or you can create a custom scheduled task file. If you create a custom file, then the file name must be the same as the scheduled task name, with the .xml extension. You must import the custom scheduled task file to the db namespace of Oracle Identity Manager MDS schema. See Also: Chapter 7, Developing Plug-ins for examples of plug-ins.