Oracle Adaptive Access Manager

11-4 Oracle Fusion Middleware Administrators Guide for Oracle Identity Manager – sessionID: A unique string identifying the particular session. This string must be the same in repeated invocations of APIs that form the part of a single data collection session. – entities: A Map that contains all the entities and the since dates for which data collection is to be performed. There are two static entities, user and entitlement. The rest can be resource object names in Oracle Identity Manager. If the entity or resource object name cannot be found, it is ignored and no data collection is performed for the same. The values in the Map are java.util.Date objects that represent a timestamp. If this value is NULL, then complete data for that entity is populated. If the data is non-NULL, then data is populated in the staging tables for entities modified after that date. ■ String checkStatusString sessionID: This API checks for the status of the specified data collection session. The API returns the following statuses: – INITIATED – IN PROGRESS – COMPLETED – FAILED – FINALIZED ■ void finalizeSessionString sessionID: This API finalizes the data collection session by truncating the staging tables and other cleanup activities.

11.3.2.2 Staging Tables

Oracle Identity Manager makes user, account, and entitlement data through certain tables to OIA. These are called staging tables, which can be populated on demand by using the APIs in the DataCollectionOperationsIntf interface. The following staging tables can be populated: ■ staging_users_table: Staging table for user profile attributes ■ staging_user_extended_props: Staging table for custom user defined fields ■ staging_entitlements: Staging table for entitlement information ■ staging_accounts: Staging table for account information ■ staging_account_attributes: Staging table for account attributes including parent and child form data

11.3.2.3 Data Collection Process

The following is the sequence of steps for the data collection: 1. Invoke startDataCollection API with the appropriate session ID and entities with since dates. If the since date is NULL, then indicates to Oracle Identity Manager that full data must be populated in the staging tables. 2. Poll Oracle Identity Manager by running the getDataCollectionStatus API with the same session ID. 3. After the getDataCollectionStatus API returns COMPLETED status, OIA processes can directly read the data from the staging tables. 4. After data synchronization is complete, run the finalizeDataCollectionSession API with the same session ID to finalize the data collection session.