4.1 Implementing the SAP HR Driver with the SAP Business Logic Driver

Complete the following tasks, in the order listed, to implement the SAP HR driver with the SAP Business Logic driver.

4.1.1 Prerequisites

4.1.2 Linking the Drivers Together

The SAP HR and the SAP Business Logic drivers contain GCV parameters that link the two drivers together.

To set the GCV parameters on the SAP Business Logic driver:

  1. Access the properties of the SAP Business Logic driver in either Designer or iManager.

  2. Click the GCVs tab.

  3. Use the following information to link the SAP Business Logic driver with your SAP HR driver:

    Show SAP HR business logic settings: Select show to display the GCVs that link the drivers together. By default this is set to hide.

    Enable SAP HR business logic: Select Yes to enable the SAP HR driver with the SAP Business Logic driver.

    SAP HR Driver: Browse to and select the SAP HR driver to link to this SAP Business Logic driver.

    Determine Hire Date from HR Action: Select true for the SAP Business Logic driver to determine the SAP Hire Date from an SAP Action.

    Hire Action Identifier: (Conditional) This option is only available if the Determine Hire Date from HR Action GCV is set to true. Specify the SAP identifier for the Hire Action. By default this is 01.

    Hire Action Reason: (Conditional) This option is only available if the Determine Hire Date from HR Action GCV is set to true. Specify the SAP reason that should be considered for the hire date. Leave this field empty only if the hire action identifier is used for the hire date.

    Determine Termination Date from HR Action: Select true for the SAP Business Logic driver to determine the SAP Termination Date for an SAP Action.

    Termination Action Identifier: (Conditional) This option is only available if the Determine Termination Date from HR Action is set to true. Specify the SAP identifier for the Termination Action. By default, this is 10.

    Termination Action Reason: (Conditional) This option is only available if the Determine Termination Date from HR Action is set to true. Specify the SAP reason that should be considered for the termination date. Leave this field empty only if the termination action identifier is used for the termination date.

  4. Click OK to save the changes.

  5. Restart the SAP Business Logic driver to have these changes take effect.

To set the GCV parameters on the SAP HR driver:

  1. Access the properties of the SAP HR driver in Designer or iManager, then click the GCV tab.

  2. Use the following information to link the SAP HR driver with the SAP Business Logic driver.

    Show Future Event Options: Select show to display the configuration parameters.

    Record Future Events: Select Yes to record future events.

    SAP Business Logic Driver: Browse to and select the SAP Business Logic driver.

    Filter: Add the attributes you want to be notified when changes happen in the future. The attribute names must be in the Identity Vault name space.

  3. Click OK to save the changes.

  4. Restart the SAP HR driver to have these changes take effect.

4.1.3 Populating the Identity Vault with Organizational Data

In order to populate the Identity Vault with the organizational data, the existing data must be exported from SAP. To export your organization's hierarchical data, perform the following steps before starting the driver:

  1. From the SAP client, enter the transaction code PFAL.

  2. Insert the Object Type O for Organization objects.

  3. Enter the organizations you want to export to the Identity Vault. You can choose to export one organization, a range of organizations, or all organizations.

    If you are exporting a range of objects, access the Parallel Processing tab on the HR: ALE Distribution of HR Master Data page, then select a value of 100 or less at the Number of Object per Process prompt. This ensures that driver processing does not consume too much Java heap space.

  4. Click Execute, then ensure that the status is set to Passed to Port Okay.

  5. Repeat Step 2 through Step 4 for the Object Type C for Job objects.

  6. Repeat Step 2 through Step 4 for the Object Type S for Position objects.

  7. Repeat Step 2 through Step 4 for the Object Type P for Person objects.

4.1.4 Running the Job

The SAP Business Logic driver contains a job that must run to populate the Identity Vault correctly. You must schedule this job to run on a regular basis to make sure the data is current.

  1. In iManager, click Summary page to display the Identity Manager Administration page.

  2. Open the Overview page for the SAP Business Logic driver:

    1. In the Administration list, click Identity Manager Overview to display the Identity Manager Overview page.

    2. In the Search in field, specify the fully distinguished name of the container where you want to start searching for driver sets, then click Summary page, or leave [root] in the field and click Summary page to search from the root of the tree.

      You can also click Summary page to browse for and select the container in the tree structure, or click Summary page to select the container from a list of previously select objects.

    3. After the available driver sets are displayed on the Driver Sets page, click the desired driver set to display the SAP Business Logic driver.

    4. Click the driver to display the Driver Overview page.

  3. Click the Jobs tab.

  4. Select the dm-maintenance job, then click Run Now to manually run the job.

  5. After the job runs, click the dm-maintenance job to schedule the job to run.

  6. Click the Schedule tab.

  7. Select Run on a schedule.

  8. Specify a time to run the job, then select Daily.

    The job must run daily to update the Identity Vault with the information from SAP. The job must run after SAP distributes data. For example, if SAP distributes data at 6:00 p.m., schedule the job to run at 10:00 p.m. For more information about scheduling jobs, see Configuring a Predefined Job’s Properties in the Identity Manager 3.6 Jobs Guide.

  9. Click OK to save the changes.