Skip Headers
Oracle® Identity Manager Integration Guide for Crystal Reports
Release 9.1.0

Part Number E10373-02
Go to Documentation Home
Home
Go to Book List
Book List
Go to Table of Contents
Contents
Go to Feedback page
Contact Us

  View PDF

Oracle® Identity Manager

Integration Guide for Crystal Reports

Release 9.1.0

E10373-02

June 2008

This document explains how to use Crystal Reports Developer XI and Crystal Reports Server XI to create Crystal Report versions of Oracle Identity Manager reports. This document contains the following sections:

Configuring Crystal Reports Lookups for Oracle Identity Manager Input Parameters

"Lookup" is a term for a drop-down list that displays the available values for any given input parameter. You must configure Crystal Reports lookups for Oracle Identity Manager input parameters before configuring and running reports.

Perform the following steps to configure Crystal Reports lookups for Oracle Identity Manager input parameters by using the Business View Manager:

  1. Start the Business View Manager. From the Microsoft Windows Start menu, select Programs, then select Business Objects, then select Crystal Reports Server, and then select Business View Manager. The Business View Manager is displayed. Log in as the Administrator with Enterprise Authentication.

  2. Click the Tools menu on the Business View Manager and select Import. The Import dialog box is displayed.

  3. Click the Choose XML button next to the XML Filename field on the Import dialog box.

  4. Browse to the location where the LookUps.xml import file is located, select it, and click Open.

    By default, the LookUps.xml import file is in the \installServer\xellerate\db\Oracle\CrystalReports\ directory for Oracle deployments and in the \installServer\xellerate\db\SQLServer\CrystalReports\ directory for Microsoft SQL Server deployments. Click OK on the Import dialog box to import the file.

    Note:

    Microsoft SQL Server is not supported in Oracle Identity Manager release 9.1.0. See "Certified Components" in Oracle Identity Manager Release Notes for information about certified components.
  5. Click the View menu on the Business View Manager and select Repository Explorer. The Repository Explorer window is displayed in the Business View Manager.

  6. Select the List of Values from the Repository Explorer that you want to change the connection for and click Show referenced objects. The Referenced Objects dialog box is displayed.

  7. Expand the List of Values option in the Referenced Objects dialog box so you can see the connection level entry. Note the name of the connection and click Close on the Referenced Objects dialog box.

  8. Double-click the name of the connection entry in the Repository Explorer. The settings for the connection appear in the Business View Manager main window.

  9. Click the View menu on the Business View Manager and select Object Explorer and Property Browser. The Object Explorer window and Property Browser is displayed in the Business View Manager.

  10. Click the Connection field in the Property Browser to set the value for the connection. You can click any of the fields listed in the Property Browser to set their value.

Note:

You can verify the connection to the database by clicking the Test Connectivity icon on the toolbar.

Files Required to Run Each Report

Note:

Microsoft SQL Server is not supported in Oracle Identity Manager release 9.1.0. See "Certified Components" in Oracle Identity Manager Release Notes for information about certified components.

Table 1 lists the required files to run each report for both Oracle and Microsoft SQL Server data sources.

Note:

While the files to run each report for both Oracle and SQL Server data sources have the same file names, the content of the files are different for each data source.

For Oracle data sources, the files listed in Table 1 are located on the Oracle Identity Manager installation CD in the following directories:

For Microsoft SQL Server data sources, the files listed in Table 1 are located on the Oracle Identity Manager installation CD in the following directories:

Each report has an input parameter named Xellerate User Login. For all reports, the default value of the Xellerate User Login parameter is xelsysadm. The Xellerate User Login parameter corresponds to the xellerate user and is based on the report that will run. The report follows the same security model as Oracle Identity Manager taking the xellerate user as the logged in user.

When reports run, the Xellerate User Login parameter is suppressed and users cannot edit the value for this parameter. The administrator or user that publishes the report must set the value for the Xellerate User Login parameter according to the level of security needed.

Note:

The files listed in Table 1 remain on the Oracle Identity Manager installation CD and are not installed on a system when installing Oracle Identity Manager.

Table 1 Files Required to Run Each Report

Report Wrapper Stored Procedure (.sql) RPT (.rpt)

User Resource Access

XL_SP_UserResourceAccess_CR

UserResourceAccess

Resource Password Expiration

XL_SP_ResPassExp_CR

ResPassExp

OIM Password Expiration

XL_SP_OIMPassExp_CR

OIMPassExp

Group Membership Profile

XL_SP_GroupMembershipProfile_CR

Note: For Oracle, the wrapper stored procedure is named:

XL_SP_GrpMembershipProfile_CR.

GroupMembershipProfile

Policy List

XL_SP_PolicyList_CR

PolicyList

Policy details

XL_SP_PolicyDetail_CR

PolicyDetail

Entitlement Summary

XL_SP_EntitlementSummary_CR

EntitlementSummary

Attestation request by Process

XL_SP_AttestReqByProc_CR

AttestReqByProc

Attestation Request Details

XL_SP_AttReqDetail_CR

AttReqDetail

Attestation Process List

XL_SP_AttestProcList_CR

AttestProcList

Attestation Request by Reviewer

XL_SP_AttestReqByRev_CR

AttestReqByRev

Resource Access List

XL_SP_ResourceAccessList_CR

ResourceAccessList

User Access History

XL_SP_UserAccessHistory_CR

UserAccessHistory

Resource Access List History

XL_SP_ResAccessLstHistory_CR

Note: For Oracle, the wrapper stored procedure is named XL_SP_ResAccessLstHistory_CR

ResourcAccessListHistory

User Profile History

XL_SP_UserProfileHistory_CR

UserProfileHistory

User Membership History

XL_SP_UserMembershipHistory_CR

UserMembershipHistory

Group Membership History

XL_SP_GroupMembershipHistory_CR

Note: For Oracle, the wrapper stored procedure is named:

XL_SP_GrpMembershipHistory_CR

GroupMembershipHistory

Group Membership

XL_SP_GroupMembership_CR

GroupMembership

Approval Status By Approver

XL_SP_ApprovalStatusByApprover_CR

Note: For Oracle, the wrapper stored procedure is named:

XL_SP_ApprovStatsByApprover_CR

ApprovalStatusByApprover

Organization Structure

XL_SP_OrganizationStructure_CR

OrganizationStructure

Financially Significant Resources

XL_SP_FinanciallySigResources_CR

Note: For Oracle, the wrapper stored procedure is named:

XL_SP_FinanciallySigResourc_CR

FinanciallySigResources

Resource Activity Metrics

XL_SP_ResourceActivity_CR

ResourceActivity

Delegated Administrators By Organization

XL_SP_DelegatedAdministratorsByOrg_CR

Note: For Oracle, the wrapper stored procedure is named:

XL_SP_DelegatedAdminByOrg_CR

DelegatedAdministratorsByOrg

Delegated Administrators and Permissions by Resource

XL_SP_DelegAdminPermsByRes_CR

Note: For Oracle, the RPT is named:

DelegatedAdminPermsByRes.rpt because the filename in the oracle folder is DelegatedAdminPermsByRes.rpt

DelegAdminPermsByRes

Note: For Oracle, the RPT is named DelegatedAdminPermsByRes.

Requests Details by Status

XL_SP_RequestDetailByStatus_CR

RequestsDetailsByStatus

Requests Initiated

XL_SP_RequestsInitiated_CR

RequestsInitiated

Delegated Administrators and Permissions by Organization

XL_SP_DelegAdminPermsByOrg_CR

DelegatedAdminPermsByOrg

Users Created

XL_SP_UsersCreated_CR

UsersCreated

Task Assignment History

XL_SP_TaskAssignmentHistory_CR

TaskAssignmentHistory

Account Activity In Resource

XL_SP_AccountActivityInRes_CR

AccountActivityInRes

Users Deleted

XL_SP_UsersDeleted_CR

UsersDeleted

Delegated Administrators by Resource

XL_SP_DelegatedAdminByRes_CR

DelegatedAdminByRes

Users Unlocked

XL_SP_UsersUnlocked_CR

UsersUnlocked

Users Disabled

XL_SP_UsersDisabled_CR

UsersDisabled

Password Reset Success Failure

XL_SP_PassResetSuccessFail_CR

PassResetSuccessFail

Rogue Accounts by Resource

XL_SP_RogueAccountsByResource_CR

RogueAccountsByResource

Fine Grained Entitlement Exceptions by Resource

XL_SP_FineGrainEntExcpByRes_CR

FineGrainEntExcpByRes


Configuring Reports for Crystal Reports Developer and Crystal Reports Server

This section explains how to configure Crystal Report versions of Oracle Identity Manager reports for both Crystal Reports Developer and Crystal Reports Server. This section contains the following topics:

Note:

The information in Configuring the Database for Crystal Report Versions of Oracle Identity Manager Reports is common to both Crystal Reports Developer and Crystal Reports Server.

Configuring the Database for Crystal Report Versions of Oracle Identity Manager Reports

Perform the steps in one of the following sections appropriate for your type of database to compile the wrapper stored procedure, which is the data source for the report.

Note:

Each wrapper procedure calls the parent procedure. The sixth parameter in this call, named intpagesize_in in the parent procedure, indicates the number of records for the report to retrieve. By default, the value of intpagesize_in is set to 5000 in each wrapper procedure.

If needed, change the value of intpagesize_in and save the file before compiling the wrapper stored procedure.

Configuring Oracle Databases for Crystal Report Versions of Oracle Identity Manager Reports

To configure Oracle databases for Crystal Report versions of Oracle Identity Manager reports, execute the \Oracle\Wrappers\XL_SP_Report Name_CR.sql script on the database server by using the database login for Oracle Identity Manager.

Configuring Microsoft SQL Server Databases for Crystal Report Versions of Oracle Identity Manager Reports

Note:

Microsoft SQL Server is not supported in Oracle Identity Manager release 9.1.0. See "Certified Components" in Oracle Identity Manager Release Notes for information about certified components.

Perform the following steps to configure Microsoft SQL Server databases for Crystal Report versions of Oracle Identity Manager reports:

  1. Edit the \SQLServer\XL_SP_Report Name_CR.sql script and replace every occurrence of the @sysuser string with the name of the SQL Server login for Oracle Identity Manager.

  2. Execute the updated \SQLServer\XL_SP_Report Name_CR.sql script on the database server by using the database login for Oracle Identity Manager.

Configuring Reports to Run Against Crystal Reports Developer

This section explains how to configure reports to run against Crystal Reports Developer by using both Oracle and Microsoft SQL Server data sources. By default, reports attempt to connect to the data source that was configured when the report was initially designed.

Note:

Microsoft SQL Server is not supported in Oracle Identity Manager release 9.1.0. See "Certified Components" in Oracle Identity Manager Release Notes for information about certified components.

To change the location of the data source that the report connects to, perform the steps in the following sections specific to either Oracle or Microsoft SQL Server data sources. This section contains the following topics:

Configuring Reports to Run Against Crystal Reports Developer By Using Oracle Data Sources

Perform the following steps to configure reports to run against Crystal Reports Developer by using Oracle data sources:

  1. Open Crystal Reports Developer and log in as the Administrator with Enterprise Authentication.

  2. Open the \Oracle\RPT\Report Name.rpt file for the report you want to run.

  3. Click the Database menu and select Set Datasource Location. The Set Datasource Location dialog box is displayed.

  4. Expand the Create New Connection option in the Replace With field of the Set Datasource Location dialog box.

  5. Select Oracle Server. The Oracle Server Connection dialog box is displayed.

  6. Enter the name of the connection string defined in the TNSNAMES.ora configuration file in the Service field.

  7. Enter the database User ID in the User ID field.

  8. Enter the password in the Password field and click the Finish button.

  9. Expand the entry for the user name/schema that compiled the wrapper stored procedure from the list of options for the Oracle Server entry in the Replace With field.

  10. Select the wrapper stored procedure for the report.

  11. Select the original datasource in the Current Data Source field of the Set Datasource Location dialog box and click the Update button. The Enter Values dialog box is displayed.

  12. Enter the appropriate values for each parameter in the Enter Values dialog box and run the report.

    Note:

    Click the refresh button to run the report with new parameter values.

Configuring Reports to Run Against Crystal Reports Developer By Using Microsoft SQL Server Data Sources

Perform the following steps to configure reports to run against Crystal Reports Developer by using Microsoft SQL Server data sources:

  1. Open Crystal Reports Developer and open the \SQLServer\RPT\Report Name.rpt file for the report you want to run.

  2. Click the Database menu and select Set Datasource Location. The Set Datasource Location dialog box is displayed.

  3. Expand the Create New Connection option in the Replace With field of the Set Datasource Location dialog box.

  4. Select OLE DB (ADO). The OLE DB (ADO) Provider dialog box is displayed.

  5. Scroll through the list in the Provider box and select Microsoft OLE DB Provider for SQL Server. Click the Next button. The OLE DB (ADO) Connection Information dialog box is displayed.

  6. Enter the SQL Server host name in the Server field.

  7. Enter the database user ID in the User ID field.

  8. Enter the password in the Password field.

  9. Enter the name of the database in the Database field and click the Next button. The OLE DB (ADO) Advanced Information dialog box is displayed.

  10. Click the Finish button on the OLE DB (ADO) Connection Information dialog box.

  11. Expand the entry for the database name in the list of entries for OLE DB (ADO) in the Replace With field and select the user name that holds the wrapper stored procedure for the report.

  12. Expand the Stored Procedures entry for the user name that holds the wrapper stored procedure for the report.

  13. Select the wrapper stored procedure for the report.

  14. Select the original datasource in the Current Data Source field of the Set Datasource Location dialog box and click the Update button. The Enter Values dialog box is displayed.

  15. Enter the appropriate values for each parameter in the Enter Values dialog box and run the report.

    Note:

    Click the refresh button to run the report with new parameter values.

Configuring Reports to Run Against Crystal Reports Server

This section explains how to configure reports to run against Crystal Reports Server. The process for configuring reports to run against Crystal Reports Server includes the following steps documented in this section:

  1. Publishing Reports By Using the Publishing Wizard

  2. Configuring Published Reports

Publishing Reports By Using the Publishing Wizard

The first step in configuring reports to run against Crystal Reports Server is to publish the reports to the Crystal Reports Server. Perform the following steps by using the Publishing Wizard to publish reports to the Crystal Reports Server:

  1. Start the Publishing Wizard. From the Microsoft Windows Start menu, select Programs, then select Business Objects, then select Crystal Reports Server, and then select Publishing Wizard. The Welcome to the Publishing Wizard dialog box is displayed.

  2. Click Next on the Welcome to the Publishing Wizard dialog box. The Please Log On dialog box is displayed.

  3. Enter the following information in the fields on the Please Log On dialog box:

    • Enter the host name of the system where Crystal Reports Server is running in the System field.

    • Enter your Crystal Reports Server user name in the User Name field.

    • Enter your password in the Password field.

    • Ensure the Authentication field is set to Enterprise and click Next.

      The Select Files dialog box is displayed.

  4. Click Add Files on the Select Files dialog box. Browse to the location of the RPT file you want to publish, select the file, and click Open.

  5. Click Next on the Select Files dialog box after the RPT file you selected is displayed in the list of files to be published. The Specify Location dialog box is displayed.

  6. Browse to the location where you want the report to appear and click the Next button until the Change Default Values dialog box is displayed.

  7. Select the Publish without modifying properties option on the Change Default Values dialog box and click Next. A Publishing Wizard dialog box is displayed and lists the objects/reports you selected to publish.

  8. Click Next to publish the report. After publishing the report, click Finish.

Configuring Published Reports

After publishing reports to the Crystal Reports Server, you must configure the published reports so that can users to access them.

Note:

- Be aware that you cannot configure and publish a report designed for Oracle against a Microsoft SQL Server data source, and you cannot configure and publish a report designed for SQL Server against an Oracle data source.

- Microsoft SQL Server is not supported in Oracle Identity Manager release 9.1.0. See "Certified Components" in Oracle Identity Manager Release Notes for information about certified components.

- Step 10 in the following procedure will differ for Oracle and SQL Server data sources. Perform only the steps that are appropriate for your data source.

Perform the following steps to configure the reports you published by using the Publishing Wizard:

  1. Start the Java Administration Launchpad. From the Microsoft Windows Start menu, select Programs, then select Business Objects, then select Crystal Reports Server, and then select Java Administration Launchpad. A browser opens and the Welcome to the Administration Launchpad page is displayed.

  2. Click Launch the Central Management Console. The Central Management Console Log On page is displayed.

  3. Enter the following in the fields on the Central Management Console Log On page:

    • Enter the host name of the system where Crystal Reports Server is running in the System field.

    • Enter your user name in the User Name field. The user name must be the Administrator or a user with Administrator privileges.

    • Enter your password in the Password field.

    • Ensure the Authentication Type field is set to Enterprise and click Log On.

      The Central Management Console page is displayed.

  4. Click Folders. The Top Level Folders page is displayed.

  5. Select the folder where the report was published. The contents of the folder is displayed.

  6. Click the report. The report details appear.

  7. Enter the following information in the fields for the report details:

    • Enter a title for the report in the Report Title field.

    • Enter a description for the report in the Report Description field.

  8. Click the Process tab. Click Database. The configured database information is displayed.

  9. Select the Use custom database logon information specified here option.

  10. This step depends on whether you are using an Oracle or SQL Server data source. Perform the steps appropriate to your data source as follows:

    Oracle

    1. Select the Select a database driver option and select Oracle from the list.

    2. Enter the name of the connection string defined in the TNSNAMES.ora configuration file in the Server field.

    3. Enter your user name in the User Name field. The user name must be the Administrator or a user with Administrator privileges.

    4. Enter your password in the Password field.

    5. Select the Specify a custom table prefix option.

      Enter user_name. in the Specify a custom table prefix field, where user_name represents the database user. For example:

      oracledb1user.

      Note:

      Ensure to include a period following the user name.

    Microsoft SQL Server

    1. Select the Specify a custom driver option and enter crdb_ado in the field.

    2. Enter the host name of the SQL Server in the Server field.

    3. Enter the name of the database in the Database field.

    4. Enter your user name in the User Name field. The user name must be the Administrator or a user with Administrator privileges.

    5. Enter your password in the Password field.

    6. Select the Specify a custom table prefix option.

      Enter database_name.user_name. in the Specify a custom table prefix field, where database_name represents the name of the database and user_name represents the database user. For example:

      sqldb1.sqldb1user.

      Note:

      Ensure to include a period following the user name.
  11. Select the Use same database logon as when report is run option and click Update.

  12. Click Parameters. The screen to set the default parameters for the report is displayed.

  13. Click any parameter to set a default value and to configure whether users should be prompted for new values for the parameter when viewing.

    Note:

    The Administrator should set the value for the Xellerate User Login parameter by entering a valid Oracle Identity Manager user ID. The Xellerate User Login parameter should not be set as a prompted parameter. If an incorrect user ID is entered, then the user gets an error message such as Error in database connector.

    After setting the default values for any parameter, click Update.

  14. Verify the appropriate servers are running by using the Central Configuration Manager before running the report. From the Microsoft Windows Start menu, select Programs, then select Business Objects, then select Crystal Reports Server, and then select Central Configuration Manager. The Central Configuration Manager is displayed.

  15. Verify the appropriate servers are running by checking the Status column for each server.

  16. Click the Properties tab on the Central Management Console.

  17. Click the Preview button to run the report and enter the appropriate information when prompted. The report results appear in a Crystal Reports Viewer browser window.

Creating Users, Configuring Access, and Distributing Reports

After configuring the published reports, you must create the users that will access the reports and you must create the appropriate level of access permissions before distributing the reports.

Perform the following steps:

  1. Create users and the appropriate access permissions. See Crystal Reports documentation for more information.

  2. Distribute the Central Management Console's URL for the InfoView Web site to the users.

    The URL takes users to the login page where they can log in with the user ID and password provided to them by the administrator. The users can then navigate to the folder containing the report, select the appropriate input parameters for the report by using the lookup lists, and run the report.

General Limitations

The following is a list of general limitations of using Crystal Reports Developer and Crystal Reports Server to create Crystal Report versions of Oracle Identity Manager reports:

Note:

If you are using Oracle as the data source, the SQL*Plus client must be installed on the system where Crystal Reports Developer is running. Crystal Reports uses the TNS connection to connect to the Oracle database.

Documentation Accessibility

Our goal is to make Oracle products, services, and supporting documentation accessible, with good usability, to the disabled community. To that end, our documentation includes features that make information available to users of assistive technology. This documentation is available in HTML format, and contains markup to facilitate access by the disabled community. Accessibility standards will continue to evolve over time, and Oracle is actively engaged with other market-leading technology vendors to address technical obstacles so that our documentation can be accessible to all of our customers. For more information, visit the Oracle Accessibility Program Web site at

http://www.oracle.com/accessibility/

Accessibility of Code Examples in Documentation

Screen readers may not always correctly read the code examples in this document. The conventions for writing code require that closing braces should appear on an otherwise empty line; however, some screen readers may not always read a line of text that consists solely of a bracket or brace.

Accessibility of Links to External Web Sites in Documentation

This documentation may contain links to Web sites of other companies or organizations that Oracle does not own or control. Oracle neither evaluates nor makes any representations regarding the accessibility of these Web sites.

TTY Access to Oracle Support Services

Oracle provides dedicated Text Telephone (TTY) access to Oracle Support Services within the United States of America 24 hours a day, 7 days a week. For TTY support, call 800.446.2398. Outside the United States, call +1.407.458.2479.


Oracle Identity Manager Integration Guide for Crystal Reports, Release 9.1.0

E10373-02

Copyright © 2007, 2008, Oracle. All rights reserved.

The Programs (which include both the software and documentation) contain proprietary information; they are provided under a license agreement containing restrictions on use and disclosure and are also protected by copyright, patent, and other intellectual and industrial property laws. Reverse engineering, disassembly, or decompilation of the Programs, except to the extent required to obtain interoperability with other independently created software or as specified by law, is prohibited.

The information contained in this document is subject to change without notice. If you find any problems in the documentation, please report them to us in writing. This document is not warranted to be error-free. Except as may be expressly permitted in your license agreement for these Programs, no part of these Programs may be reproduced or transmitted in any form or by any means, electronic or mechanical, for any purpose.

If the Programs are delivered to the United States Government or anyone licensing or using the Programs on behalf of the United States Government, the following notice is applicable:

U.S. GOVERNMENT RIGHTS Programs, software, databases, and related documentation and technical data delivered to U.S. Government customers are "commercial computer software" or "commercial technical data" pursuant to the applicable Federal Acquisition Regulation and agency-specific supplemental regulations. As such, use, duplication, disclosure, modification, and adaptation of the Programs, including documentation and technical data, shall be subject to the licensing restrictions set forth in the applicable Oracle license agreement, and, to the extent applicable, the additional rights set forth in FAR 52.227-19, Commercial Computer Software--Restricted Rights (June 1987). Oracle USA, Inc., 500 Oracle Parkway, Redwood City, CA 94065.

The Programs are not intended for use in any nuclear, aviation, mass transit, medical, or other inherently dangerous applications. It shall be the licensee's responsibility to take all appropriate fail-safe, backup, redundancy and other measures to ensure the safe use of such applications if the Programs are used for such purposes, and we disclaim liability for any damages caused by such use of the Programs.

Oracle, JD Edwards, PeopleSoft, and Siebel are registered trademarks of Oracle Corporation and/or its affiliates. Other names may be trademarks of their respective owners.

The Programs may provide links to Web sites and access to content, products, and services from third parties. Oracle is not responsible for the availability of, or any content provided on, third-party Web sites. You bear all risks associated with the use of such content. If you choose to purchase any products or services from a third party, the relationship is directly between you and the third party. Oracle is not responsible for: (a) the quality of third-party products or services; or (b) fulfilling any of the terms of the agreement with the third party, including delivery of products or services and warranty obligations related to purchased products or services. Oracle is not responsible for any loss or damage of any sort that you may incur from dealing with any third party.