Contents

List of Figures

List of Tables

Title and Copyright Information

Preface

• Audience
• Documentation Accessibility
• Related Documents
• Conventions

What's New in the Oracle Identity Manager Connector for Flat File?

• Software Updates
  • Software Updates in Release 11.1.1.6.0
    • Support for Disconnected Resources
    • Support for Generating Artifacts for All Attributes in the Trusted Source Configuration Mode
    • Automated Tagging of Entitlements
    • Support for Displaying Date Values as Date Picker
    • Resource-Specific Generation of Scheduled Jobs
    • Support for Lookup Fields
    • Generation of Application Instance
    • Support for Prepopulating All Process Form Fields
  • Software Updates in Release 11.1.1.5.0
• Documentation-Specific Updates
  • Documentation-Specific Updates in Release 11.1.1.6.0
  • Documentation-Specific Updates in Release 11.1.1.5.0

1 About the Flat File Connector

• 1.1 Introduction to the Connector
• 1.2 Certified Components
• 1.3 Certified Languages
• 1.4 Connector Architecture
• 1.5 Use Cases Supported by the Connector
  • 1.5.1 Reconciliation of Records
  • 1.5.2 Disconnected Resource
  • 1.5.3 Connected Resource
• 1.6 Features of the Connector
  • 1.6.1 Support for Both Target Resource and Trusted Source Reconciliation
  • 1.6.2 Full and Incremental Reconciliation
  • 1.6.3 Limited Reconciliation
  • 1.6.4 Support for Disconnected Resources
  • 1.6.5 Resource-Specific Generation of Scheduled Jobs
  • 1.6.6 Support for Archival
  • 1.6.7 Support for Custom Parsers
  • 1.6.8 Support for Reconciling Complex Multivalued Data
  • 1.6.9 Support for Delimiters
  • 1.6.10 Support for Comment Characters
  • 1.6.11 Support for Fault Handling
  • 1.6.12 Support for Preprocess and Postprocess Handlers
  • 1.6.13 Support for Reconciliation of Deleted Records
  • 1.6.14 Support for Transformation and Validation of Account Data
  • 1.6.15 Support for Connector Server
• 1.7 Lookup Definitions Used During Connector Operations
  • 1.7.1 Lookup.FlatFile.Configuration
  • 1.7.2 Lookup.FlatFile.Configuration.Trusted
  • 1.7.3 Lookup.FlatFile.EntFieldMap
  • 1.7.4 Lookup.FlatFile.UM.Configuration
  • 1.7.5 Lookup.FlatFile.UM.Configuration.Trusted

2 Deploying the Flat File Connector

• 2.1 Preinstallation
  • 2.1.1 Exporting Flat Files
  • 2.1.2 Understanding and Creating the Schema File
    • 2.1.2.1 Understanding the Schema File Format
      • 2.1.2.1.1 Understanding Account Qualifiers
      • 2.1.2.1.2 Understanding Field Qualifiers
    • 2.1.2.2 Configuring the Connector for Status Reconciliation
    • 2.1.2.3 Configuring the Connector for Date Type
    • 2.1.2.4 Creating a Schema File
  • 2.1.3 Installing the Connector for a Connected Resource
  • 2.1.4 Installing the Connector for a Disconnected resource
    • 2.1.4.1 Summary of steps to Generate the Connector Components
    • 2.1.4.2 Preparing the Schema File
    • 2.1.4.3 Understanding Entries in the FlatFileConfiguration.groovy File
    • 2.1.4.4 Configuring the FlatFileConfiguration.groovy File
    • 2.1.4.5 Running the Flat File Generator
    • 2.1.4.6 Understanding the Generated Connector Package
    • 2.1.4.7 Installing the Connector Package
  • 2.1.5 Prerequisites for the Target Resource
    • 2.1.5.1 Understanding Mapping in the Recon Attribute Map Lookup Definition
    • 2.1.5.2 Modifying the Reconciliation Field Name and Updating the Reconciliation Field Mapping
  • 2.1.6 Configuring the Connector for Incremental Reconciliation
  • 2.1.7 Copying Custom Parser Libraries and Preprocess and Postprocess Handlers
• 2.2 Installation
  • 2.2.1 Installing the Connector on Oracle Identity Manager
    • 2.2.1.1 Running the Connector Installer
    • 2.2.1.2 Configuring the IT Resource
  • 2.2.2 Deploying the Connector in a Connector Server
    • 2.2.2.1 Installing and Configuring the Connector Server
    • 2.2.2.2 Running the Connector Server
    • 2.2.2.3 Installing the Connector on the Connector Server
• 2.3 Postinstallation
  • 2.3.1 Configuring Oracle Identity Manager
    • 2.3.1.1 Creating and Activating a Sandbox
    • 2.3.1.2 Creating a New UI Form
    • 2.3.1.3 Creating an Application Instance
    • 2.3.1.4 Publishing a Sandbox
  • 2.3.2 Changing to the Required Input Locale
  • 2.3.3 Clearing Content Related to Connector Resource Bundles from the Server Cache
  • 2.3.4 Setting up the Configuration Lookup Definition
  • 2.3.5 Managing Logging
    • 2.3.5.1 Understanding Log Levels
    • 2.3.5.2 Enabling Logging
  • 2.3.6 Localizing Field Labels in UI Forms
  • 2.3.7 Configuring the Connector to Ignore Comment Characters
  • 2.3.8 Creating the IT Resource for the Connector Server
• 2.4 Configuring the Connector with the Target Resource
• 2.5 Upgrading the Connector

3 Using the Connector

• 3.1 Performing First-Time Reconciliation
• 3.2 Scheduled Jobs for Lookup Field and Entitlement Synchronization
• 3.3 Configuring Reconciliation
  • 3.3.1 Reconciliation Scheduled Jobs
  • 3.3.2 Attributes of the Scheduled Jobs
    • 3.3.2.1 Scheduled Jobs for Reconciliation of User Records
      • 3.3.2.1.1 Flat File Users Loader and IT_RES_NAME Flat File Users Loader
      • 3.3.2.1.2 Flat File Users Diff Sync Reconciliation and IT_RES_NAME Flat File Users Delete Diff Reconciliation
      • 3.3.2.1.3 Flat File Users Delete Reconciliation and IT_RES_NAME Flat File Users Delete Reconciliation
      • 3.3.2.1.4 Flat File Users Delete Sync Reconciliation and IT_RES_NAME Flat File Users Delete Sync Reconciliation
    • 3.3.2.2 Scheduled Jobs for Reconciliation of Accounts
      • 3.3.2.2.1 Flat File Accounts Loader and IT_RES_NAME Flat File Accounts Loader
      • 3.3.2.2.2 Flat File Accounts Diff Sync Reconciliation and IT_RES_NAME Flat File Accounts Delete Diff Reconciliation
      • 3.3.2.2.3 Flat File Accounts Delete Reconciliation and IT_RES_NAME Flat File Accounts Delete Reconciliation
      • 3.3.2.2.4 Flat File Accounts Delete Sync Reconciliation and IT_RES_NAME Flat File Accounts Delete Sync Reconciliation
  • 3.3.3 Performing Full and Incremental Reconciliation
  • 3.3.4 Limited Reconciliation
• 3.4 Configuring Scheduled Jobs
• 3.5 Reconciling Complex Multivalued Data
• 3.6 Configuring Fault Handling
• 3.7 Configuring Archival
• 3.8 Understanding and Configuring Delimiters
  • 3.8.1 About Delimiters Supported By the Connector
  • 3.8.2 Configuring Delimiters
• 3.9 Uninstalling the Connector

4 Extending the Functionality of the Connector

• 4.1 Configuring Custom Parsers
  • 4.1.1 Creating the Custom Parser
    • 4.1.1.1 About Creating the Custom Parser
    • 4.1.1.2 About Mandatory Attributes Validation
    • 4.1.1.3 About Filters
    • 4.1.1.4 About Handling Multivalued Attributes
  • 4.1.2 Integrating the Custom Parser with the Flat File Connector
• 4.2 Configuring Preprocess and Postprocess Tasks
  • 4.2.1 Understanding the Preprocess and Postprocess Tasks
    • 4.2.1.1 About the Preprocess task
    • 4.2.1.2 About the Postprocess Task
  • 4.2.2 Integrating the Preprocess and Postprocess Tasks with the Flat File Connector
• 4.3 Adding New Attributes for Target Resource Reconciliation
• 4.4 Adding New Multivalued Attributes for Target Resource Reconciliation
• 4.5 Configuring Validation of Data During Reconciliation
• 4.6 Configuring Transformation of Data During Reconciliation
• 4.7 Configuring the Connector for Multiple Installations of the Target System

5 Troubleshooting the Connector

6 Frequently Asked Questions

7 Known Issues and Workarounds

• 7.1 Multicharacter Delimiters Are Not Supported
• 7.2 Ignore Event API is Not Called
• 7.3 StartDate and EndDate Values Not Populated in Child Form
• 7.4 Error Encountered When Process Recon Event Batch Size is Set to a Smaller Value

A Sample Entries for Users, Currency, Groups, and Roles in a CSV File

• A.1 Sample Entries for Users
  • A.1.1 Sample Entries for Users
  • A.1.2 Sample Entries for Accounts with Child Form Data
• A.2 Sample Entries for Currency
• A.3 Sample Entries for Groups
• A.4 Sample Entries for Roles

B Sample Schema Files

• B.1 Sample Schema File for Users
• B.2 Sample Schema File for Currency
• B.3 Sample Schema File for Groups
• B.4 Sample Schema File for Roles

C Sample Groovy File

D Files and Directories in the Flat File Installation Media

E Scheduled Jobs for Lookup Fields and Entitlement Synchronization, and Reconciliation

Index