You are on page 1of 37

PeopleSoft Crystal Reports 8.

5/9/XI Troubleshooting Guide

T I TLE OF P AP E R 7/24/2009

Crystal Troubleshooting Guide

Reference Number: Reporting Tool’s Product(s): PeopleTools Release(s): Revision Number: Contains: √ √ √ √ √ √

PTOOLS001 Crystal Reports 8.5/9.0 Business Objects Enterprise XI 7.x, 8.1x, 8.4x Rev3

Table of Contents

Table of Contents........................................................................................................................................................3 Introduction .................................................................................................................................................................4 Structure of this Troubleshooting guide Related Materials 4 4

Chapter 1 - Executive Overview ................................................................................................................................5 Chapter 2 - Crystal Reports in a Client Environment - Configuration and Use....................................................6 Chapter 3 - Crystal in a Client Environment - Troubleshooting.........................................................................14 Chapter 4 - Crystal in a Web Environment – Configuration and Use ...............................................................19 Chapter 5 - Crystal in a Web Environment - Troubleshooting ...........................................................................21 Chapter 6 - Business Objects Enterprise Java Environment – Configuration and Use ..................................30 Chapter 7 - Business Objects Enterprise Java Environment – Troubleshooting ............................................31 Appendix A - Important Doc IDs..............................................................................................................................33 Appendix B - Important Incidents ...........................................................................................................................34 Appendix C - Validation and Feedback .................................................................................................................35 References.................................................................................................................................................................36

BOE is a javabased report repository and scheduling tool that uses reports designed with Crystal Reports software. This document is not intended to replace other documentation delivered with PeopleTools. To see if the document has been updated since download. PeopleBooks. before using this document. headings. contents. and use with PeopleSoft PeopleTools. and length of this document is likely to vary with each posted version. it is recommended that users have an understanding of basic Windows system administration concepts. RELATED MATERIALS It is assumed that the reader is familiar with PeopleSoft Administration. or any Crystal Reports/ BOE specific documentation. Much of the information contained in this document is based on real-life problems. It is recommended to read the appropriate release of PeopleBooks Crystal Reports for PeopleSoft to ensure a well-rounded understanding of our technology. To take full advantage of the information covered in this document. Troubleshooting tips are given for previously reported Crystal and BOE problems. PeopleTools and the use of PeopleSoft applications. compare the version date to the date posted on the Oracle Portal. BOE is therefore included in the scope of this document. SQL. . Note: Some of the information in this document is previously incorporated into PeopleBooks. STRUCTURE OF THIS TROUBLESHOOTING GUIDE This Guide provides help on different troubleshooting approaches for different Crystal Reports and BOE related issues. This document is updated as needed so that it reflects the most current feedback received from the field. The scope of the document includes Crystal Reports and BOE software installation. workings of the internet. configuration. Therefore.Introduction This practical troubleshooting document is designed for Crystal Reports and Business Objects Enterprise (BOE) users – beginning and advanced – as well as for Oracle Global Customer Support (GCS). the structure. Issues discussed here are ones reported most frequently or are the most troublesome. Hardware and Software Guides. relational database concepts. including Installation Guides and Notes.

customized or new reports may be implemented within a PeopleSoft environment. Each Crystal Report delivered with the PeopleSoft application is associated with a Query. click the Download link in front of the desired Crystal Reports product. No Crystal Report may be run from the PeopleSoft Application for which the data source is not a Query. Scroll down to the appropriate PeopleTools entry for the desired environment. %PS_HOME%\crw\ENG %PS_HOME%\crw\ARA %PS_HOME%\crw\CFR %PS_HOME%\crw\CZE Etc… Crystal Reports Related Queries Access to the PeopleSoft database is via the ODBC(RDO) PeopleSoft PeopleTools driver for from Crystal Reports and via the Integration Gateway and Query Access Services for BOE.exe” under the following folders: %PS_HOME%\bin\client\winx86 %PS_HOME%\setup Crystal Reports Format Files The Crystal Report application report format files are delivered in the following folder: %PS_HOME%\crw Language versions of the same reports are delivered in the sub-directories. PeopleSoft uses this software for delivered PeopleSoft applications reports.exe” and “PSCVTRPT.0 English”.Chapter 1 . Crystal Reports Software Availability The Crystal Reports client software for developing Crystal reports is licensed for use with PeopleTools and is downloadable from: URL: http://edelivery. now owned by Set Product Pack to “PeopleSoft Enterprise” and Platform to “Microsoft Windows 32” and click GO. For example. Click the Description link. The PeopleTools accesses enable a view of accessible PeopleSoft Queries. “Crystal Reports 9.Executive Overview Crystal Reports/BOE is third party reporting software. On the following page. PeopleTools delivers Windows Crystal executables such as “PSCRRUN. “PeopleTools Enterprise – PeopleTools 8. Crystal is one of the most highly used reporting tools within the scope of PeopleSoft applications. This data access method enables PeopleSoft Security to be applied to the reports produced with Crystal/BOE. For example. . Often the Query has the same name as the report format file. There are many delivered individual Crystal reports in the delivered PeopleSoft applications products PeopleSoft application end-users may utilize the delivered Crystal reports as-is. may customize the delivered Crystal Crystal Reports Related Executable Programs Windows software programs to run Crystal Reports within the PeopleSoft application are delivered with PeopleTools. or may create totally new reports.49 Media Pack”. which may be viewed from the PeopleSoft Query Manager. After successful testing of these reports with the Crystal Designer tool. For example. The necessary program files are installed during the PeopleTools installation on a Process Scheduler host machine. Users design and/or customize reports by means of the Crystal Designer client software tool. according to their requirements. the XRFWIN Crystal Report uses the Query “XRFWIN”.

and print Crystal Reports via the Process Scheduler . Summary of Crystal Reports Client Software and Connectivity Methods Connectivity Method 2-Tier Crystal Reports Crystal Designer Client (crw32. users may configure.exe) PIA login to PeopleSoft environment then submit to Process Scheduler 3-Tier Web 2-Tier Connect to the database directly using database connectivity software. run.exe) Crystal Designer Client (crw32.Chapter 2 .Configuration and Use Crystal Reports may be run from a variety of software tools using any of the following connectivity methods. Web Login to a web server based PIA session to access the Process Scheduler Using the Crystal Designer client software.exe) PeopleSoft Application Designer (pside. with either a 2.exe) Application Designer (pside.exe) Query (psqed.Crystal Reports in a Client Environment . Reduces the number of individual database connections. May be used for either the Crystal Designer or PeopleSoft Query tools Helpful when no PeopleSoft Application Server is accessible.exe) Query (psqed.or 3-tier connection to the database. 3-Tier Connect to the database using the PeopleSoft application server May be used for either the Crystal Designer or PeopleSoft Query tools Helpful when database connectivity software is not configured on the workstation.

jspx?id=747587.1 2) Download and install the appropriate release of Crystal Reports based on the certification XLS. Then set the correct configurations in these locations for the following parameters: a) Navigate to: Profile > Edit > Default > Process Scheduler.RPT format. CSV. Testing the newly developed and customized Crystal Reports Running Crystal Reports against a PeopleSoft database. and sending it to “Printer” or “File” output type. Crystal Designer output may also be exported to a number of different standard formats such as PDF. Crystal software is required in order to read RPT NOTE: The primary delivered output format of Crystal Designer is to the proprietary Crystal *. View the “Third party” software certification details in Metalink: URL: 3) Perform the Configuration Manager Workstation Install on the desired machine. DOC. from the following location: URL: http://edelivery. and others. Configuring Crystal Designer Client Follow these steps to work with Crystal Designer client software over a 2.EXE to update the reports for the new output file. generating an . HTM.or 3-tier connection.When to Use Crystal Designer Client Software Situations when Crystal Designer client software may be desired or helpful: 1) 2) 3) 4) Developing new Crystal Reports to accompany reports delivered with the PeopleSoft application Customizing the PeopleSoft delivered Crystal Reports to modify or extend their functionality. Follow the details given in PeopleBooks: Crystal Reports for PeopleSoft > Using Crystal Reports 9 Start the PeopleSoft Configuration Manager by clicking the executable PS_HOME\bin\client\winx86\pscfg. . 1) Confirm that the Crystal software version being used is certified with the respective PeopleTools release. 5) Upgrading PeopleTools or Crystal software and using the PeopleSoft Crystal Reports converter program PSCVTRPT.

point to the location of the database connectivity software d) CRWRPTPATH . in this path.b) PS_HOME – point to the local PeopleSoft File Manager c) DBBIN . Do not include a language directory. e) Navigate to Client Setup > ODBC Administrator .point to the top-level directory where the Crystal Report RPT files are found. such as ENG.

and the Database Name as shown in the below example .f) Highlight PeopleSoft PeopleTools > click Configure g) For 2-tier. Database Type. configure the Data Source Name.

14.00. Click the Application Server radio button and add an Application Server Domain name. Return to the Client Setup page and click Apply NOTE: Incident 1325413000 tracks a reported issue preventing the use of 3-tier connectivity for Crystal Reports in certain PeopleTools releases. machine name and port number. from the Crystal Designer client use the following navigation and formatted entries: Create New Connection > ODBC (RDO) > PeopleSoftPeopleTools Server: PeopleSoft PeopleTools UserID: <PeopleSoft User Profile Operid> Password: <PeopleSoft User Profile Password> Database: <machine name>:<port>/<database>/<domain> . i) For a 3-tier connection via the Application Server to the database. Click Set.46.07.48. The issue is fixed in PT8. PT8.h) For 3-tier connectivity. please perform the following navigation: Navigate to Profile > Edit > Default.47. and PT8.

exe in the field “Crystal Exes Path” in Configuration Manager > Crystal/Bus. Interlink/Jdeveloper” on the workstation where the software will be used.EXE .exe is found directly below the installation top directory of the Crystal Reports software on any system.Using PeopleSoft Query to Crystal Client Software For running “Query to Crystal”. 1) Set the correct path for CRW32. Example: C:\Program Files\Crystal Decisions\Crystal Reports 9\CRW32. there are several additional required configurations. Usually CRW32.

If a path is not specified however. it may be advisable to specify a different location from the delivered Crystal Reports path. As this field is used by PeopleSoft Query. to avoid overwriting delivered files.2) Set a path for the Default Crystal Reports field in “Configuration Manager > Crystal/Bus. Interlink/Jdeveloper”. Sending Query output to Crystal Reports rd format is done by clicking the 3 button in the Query Manager. PeopleSoft Query will write the file to the language directory beneath the Crystal Reports CRWRPTPATH Example: C:\TEMP\CRW 3) After adding these configurations and re-executing the Workstation Install. users should be able to generate query output to Crystal from the PeopleSoft Query client software. .


confirm the connection is being made under the Create New Connection > ODBC (RDO) > PeopleSoft PeopleTools driver. 3.Troubleshooting Various issues may occur while running Crystal client software using a 2. 6) In scenarios where users are not able to connect to the PeopleSoft database within Crystal Designer. 4) Confirm whether the issue is occurring with a specific user or all users. 4. . Crystal on Windows 2000 may get an “IM003” error message while running Crystal reports.49 PeopleBook: Crystal Reports for PeopleSoft > Using Crystal Reports 9 > Running Client Setup 3) Confirm whether the issue is occurring with all the host machines or just specific ones. If the issue occurs only with specific users. Search for any previously reported specific software issues.or 3-tier environment. Points to consider before applying any solution steps for Crystal issues are: Checklist 1. Check the below points: 1) Confirm the entries for “Crystal /Bus. If the issue is happening with specific machines. the issue may lie with the Query Access Security of the underlying Query. 5.Chapter 3 . 2) Perform the Workstation Installation on the host machine as described above. confirm the supportability of the machine OS and Crystal software versions. For details. 6. Interlink/Jdeveloper” and “Process Scheduler” tabs in the “Configuration Manager”. For example. Has access been granted to the problem User Profile? 5) Confirm there are not two or more PeopleTools versions or Crystal versions installed on the same host machine. 2. Does the issue occur with ALL reports? Or only SOME reports? Does the issue occur on ALL workstations? Or only SOME workstations? Is the issue intermittent? Has the report operated in the past without this issue? In the same environment? Are the PeopleTools and Crystal releases certified on the problem environment? Does the issue relate to the RPT Converter? When the issue occurs with ALL reports There is a probability that the issue is caused by configurations. refer to Enterprise PeopleTools 8.Crystal in a Client Environment .

7) If users are not able to find all the queries available in the database under PeopleSoft PeopleTools. please review: E-CR: All Queries are not available in Database Explorer in Crystal Designer (Doc ID 661444.1) .

When the issue occurs with only certain specific Crystal reports. Refer to: E-CR: How to change the Query a Crystal 9 Report is using? (Doc ID 638844. If the results are correct for the Query.When the issue occurs with only SOME reports These types of issues commonly happen with Application specific Crystal reports such as Crystal Reports checks APY2021.or 3. For troubleshooting these type of issues. confirm these points: 1) Confirm if the same report is running successfully in another environment. associate the query to the Crystal report again with the Database > Verify Database option.tier may be correct.0 there are specific steps to follow to perform “Verify Database”. such as Test or Demo. this indicates that the basic configurations for running Crystal reports in 2. the issue may be caused by the underlying Query associated with that specific Crystal report not fetching the correct data. Whenever the “No Printer” box is checked. that Crystal report is not permitted to be sent to a Printer.1) 4) For printer issues. then copy the problem Crystal report from that working environment to the problem environment and retest. 3) For Crystal Reports 9. Open the report and go to File > Printer Setup. If yes. first confirm the status of the “No Printer” box inside the Report definition within Crystal Designer. . There may have been an RPT file corruption in the problem environment causing the issue. Uncheck the No Printer box. In that case open the associated Query in Query Manager and run the Query Check and compare the results. 2) If the Crystal report is not generating the correct data.

6) Occasionally a User Profile may run one specific Crystal report and data is not refreshed. confirm whether the Query is public and no other Query is a duplicate.5) Sometimes a specific User Profile is not successful running a specific Crystal report. If it is checked. the same data will continually be in the Crystal report output. . In such situations. Older data is in the report output. The specific User Profile must have PeopleSoft Security Query Access to run each specific Query. open the problem Crystal report in Crystal Designer and check if File > Options > Reporting > Save data with report is checked. In such scenarios.

do the following: 1) Create a separate folder such as C:\USER\CRW and copy the specific problem Crystal reports which one wish to convert to that folder.When the issue occurs on specific workstations 1) The issue may be somewhere at the software configuration level. such as CRW\ENG. copy the resulting file back into the original source directory and retest using the process scheduler. 4) For security issues. The machine may have one or more copies of this DLL.EXE 3) If the reports contain any graphic. depending on whether the PS_HOME is also on this same host machine. Select the directory to be converted.DLL. This will avoid any possible loss to original report files as a result of the RPT Converter’s actions and reduce the number of reports converted at one time. search the problem machine for the DLL called PSSECURITY. The RPT Converter may be useful in resolving problems after upgrading PeopleTools as well as Crystal Reports. you may copy the PSSECURITY. or b) b) click on the executable PS_HOME\bin\client\winx86\PSCVTRPT. 5) After the report converter process is completed. and attempt to replicate the issue. Locate another machine with a different operating system such as Windows XP or Windows 2003. Avoid running the RPT Converter on the entire delivered folder. 3) If the issue persists with Windows XP. Select all 3 check boxes.DLL file from the PeopleTools \bin\client\winx86 folder to "C:\Program Files\Crystal Decisions\Crystal Reports 9". ole objects or soft fonts. . 4) The RPT Converter must run on a workstation with only the target PeopleTools and Crystal Reports releases installed. In the tab 'Client Setup' to select 'PeopleTools RPT Converter' and 'Install Workstation' When running Crystal reports against RPT converter. confirm the workstation which is used to run the RPT Converter has those soft fonts and printer drivers supporting those fonts already installed. This program converts Crystal reports from one release to another. When the issue is with the RPT Converter PeopleSoft delivers a report conversion utility known as RPT Converter. No other versions of PeopleTools or Crystal must be installed. Configure the environment for using the RPT Converter by performing these steps: • • Go to: Start/Programs/PeopleTools/Configuration Manager. Always make a copy of any file which is overwritten. install your software. Please confirm the basic Crystal configuration as described above in Chapter 2 2) There are some “IM003” related error messages reported with Windows 2000 machines. 2) To start the RPT Converter a) open the Report Converter executable from the workstation START > PROGRAMS > Crystal Reports program group > RPT Converter.

EXE) on the Process Scheduler host machine.44 onwards. updates to the Windows Registry. The Workstation Installation is described above in Chapter 2.EXE or PSBOERUN. these directories are written from: %PS_HOME%\setup\CrystalBin %PS_HOME%\setup\WINDOWS\SYSTEM These directories written to: C:\Program Files\Common Files\Crystal Decisions\2. The Process Scheduler configuration file (PSPRCS. the Workstation Installation After changes are made to the Configuration Manager > Process Scheduler tab. within a PSJOB. The “PSPRCS. The exact API executed depends on whether Business Objects Enterprise has been implemented in the environment. The User’s LANGUAGE_CODE is then appended to the CRWRPTPATH to determine the sub-directory from where the report is taken.log file written to the %TEMP% directory.CFG” file contains a parameter CRWRPTPATH which points to the top-level directory location where the Crystal Reports RPT files will be found if the PSCRRUN. available for Crystals in web environment: . Different Output types.0\bin C:\WINDOWS\system32 Crystal Reports are often submitted by end users from a run control page.Chapter 4 . it executes a special Crystal Reports API binary (PSCRRUN. When a Crystal report is run by a Process Scheduler. The Workstation Install process creates a log showing each step in the WI process.Crystal in a Web Environment – Configuration and Use Crystal Reports may be submitted to a PeopleSoft Process Scheduler for batch processing from a Web login For running Crystal reports through a Process Scheduler there is no requirement to install Crystal Software on the Process Scheduler machine.EXE is executed. along with different other Process types.CFG) is found at the below location: %PS_HOME%/appserv/prcs/domain name/ Configuration Manager Workstation Installation With PeopleTools 8. Additionally. the necessary Crystal DLLs and ODBC driver files are installed during startup of the Process Scheduler domain. which contains: Errors. the exact source and destination of each file copied. perform the Workstation Installation to incorporate those changes into the Windows Registry and copy necessary files into the correct system locations. This is the psinstal. and shortcuts created During WI process. It may be necessary to do the following in order to incorporate a custom Crystal Report into the application: Add a “Process Definition” for the Custom report : PeopleTools > Process Scheduler > Processes > Add new Value 1) Update existing or create a new run control page using Application Designer 2) Update existing or create a new Component or Menu using Application Designer 3) Update existing or create a new Query 4) Update the Query Access List and/or other PeopleSoft Security Crystal reports can also be run. Users can run Crystals to different output types and output formats.

please refer to PeopleBooks: Home > PeopleBooks > Enterprise PeopleTools 8.49 PeopleBook: Crystal Reports for PeopleSoft > Crystal Reports for PeopleSoft Enterprise Preface . available for Crystals in web environment: For more detail regarding Crystal.Different Output formats.

If the Query is not successful. or other report-specific area. It is also critical that the prompts created in the Process Scheduler command line are listed in the exact order as listed in the Query Prompts and in the SQL of the Query. consider these questions to clarify the issue. in the same environment? 6) Are users able to run other Process Types like nVision or SQR successfully or is the issue specific to Crystal reports only? 7) Are users able to run Crystals in other environments (like DEMO or TEST)? 8) What is the Crystal version and exact PeopleTools release? 9) Confirm there are not two or more different PeopleTools releases or Crystal versions running on the problem Process Scheduler host machine. When issues are happening with only ONE Crystal Report If the issues are happening with one or more specific Crystal reports.HTM etc) 3) Is this issue intermittent in nature? 4) Is this issue happening with some specific group of users or with all the users? 5) Has the user ever successfully run the problem Crystal reports without this issue in the past.START_DT The prompts must be in the correct order expected by the Query Refer to PeopleBook Crystal Reports for additional information regarding dynamically selecting prompt values at runtime. For a sample Crystal Report using 3 prompts the Parameter line would appear something like: -ORIENTL :RUN_CNTL_AP.) or specific output formats (like .XLS. . Confirm that the prompts are created in the PeopleSoft Query and not in the Crystal report. printer. email etc. . Please try to run the underlying Query from ReportingTools > Query Manager. this indicates that basic setup for running Crystal reports from the Process are likely configured correctly. Review the below points: 1) Attempt to run the same Crystal report from the Crystal Designer client. correct the Query and then re-associate the modified Query to the Crystal report with the steps suggested in: (Doc ID 638844.1) “E-CR: How to change the Query a Crystal 9 Report is using?” Now retest.OPRID :RUN_CNTL_AP. the Query. the issue could be at the Query level.Chapter 5 . and finally resolve the problem: Checklist: 1) Is this issue happening with all Crystal reports or with only some/one specific Crystal reports? 2) Is this issue happening when Crystal reports are run to specific output type (like web. Confirm that the prompts are in the correct order in the Process Definition for this Crystal report. This is a PeopleSoft requirement. the specific format. PeopleSoft Security. 3) Sometimes the issue happens on passing prompts in the command line which is generated for the Process Scheduler.PDF. 2) If not successful. but not ALL.Crystal in a Web Environment .RUN_CNTL_ID :RUN_CNTL_AP.Troubleshooting When troubleshooting Crystal Reports run by the Process Scheduler in a Web environment. The order of the prompt values are defined in the Crystal report Process Definition PeopleTools > Process Scheduler > Processes > Override Options > Parameter List > Append > Parameters. . The issue may be within the Crystal report definition. determine the root cause.

the main report may pass in a summary value that can be used in calculations by the subreport. it's called an Explicit Link. Select the Change Subreport Links menu option. Save the report and try rerunning it. the parameter may need to be changed. open the report. See also Crystal Reports documentation. Shutdown the process scheduler and remove the existing cache directories. Select Change Subreport Links to display the Subreport Links dialog window. Review the information below: ---------Crystal reports containing a subreport with prompts when running on the Web Linking a Subreport to the Main Report When a subreport is inserted. This is called an Implicit Link. highlight the subreport field and right click on it. Click the drop down arrow and change the Subreport Parameter Field to Use value from the default value of "?Pm-xxxx" to "?xxxx" (where xxxx is the field name). 6) If the issue persists. please reboot the Process Scheduler so that these changes will take effect. or the main report may pass in the title of the subreport. In Crystal Designer. Trace settings for Crystal . 4. Restart the process scheduler and submit the same Crystal report with a new Run Control ID. By default it will be written to C:\Temp.========================================================================= Trace=NO TraceFile=%TEMP%\CRYSTAL. When a field in the main report is linked to a parameter field in the subreport. A small scroll bar will display. Right-click on the subreport on the Crystal Reports . Select the OK button to save the change. Click OK. it may be caused by conflicting data in either the cache or the run control record which can lead to errors. ---------5) If the issue started happening suddenly.4) Determine if there are subreports attached to the problem Crystal report. Click the Subreport parameter field to select from a dropdown list.========================================================================= . For instance. Crystal Reports on-line Help explains Implicit and Explicit links between subreports and main reports.CFG file. 5. 3. To change the subreport link: 1. . turn on the Crystal trace in the PSPRCS.CFG file. Crystal automatically creates a parameter field to link the subreport to the main report. It looks like this.CFG file. then resubmit the problem Crystal report. A trace file will be created for that Crystal report in the specified directory which may be helpful in troubleshooting. The "Select data in subreport based on field" checkbox and drop down will become disabled. 2. [Crystal] . Depending on the needs of the subreport. Scroll to select the parameter field from the subreport.Report Template page. Turn on the Crystal Trace by setting parameters under the Crystal section of the PSPRCS.TRC Set the Trace=Yes and specify a location for the trace file to be written. After making changes in PSPRCS. restart the process scheduler.

If Crystal reports are erroring out on a consistent basis. If that box is checked. Please review: E-CR: How to change the Query a Crystal 9 Report is using? (Doc ID 638844. This may leads to many issues when multiple releases of PeopleTools are installed on the same host machine.0\bin and C:\WINDOWS\system32) Since the Workstation Install is performed with each Process Scheduler startup. After making the changes. Start the BEA Tuxedo Service with the same EXACT Windows Login ID/Password that is starting the host machine and logging on to the Network Domain Upon startup of the host machine from a stopped state.DLL The Workstation Install copies DLLs from the PeopleTools File Manager Setup directories. For Crystal 9. confirm the below 1) Perform a manual Workstation Installation on the Process Scheduler box. it may mean the issue is at the Process scheduler setup level. In that case. If yes. 9) Sometimes an issue happens when a specific Crystal report errors out when sending to a printer. the name of the Query must be unique. If there is any difference. when running through the Process Scheduler. 10) Confirm that the Query associated with a problem Crystal report is Public. delete the Process Scheduler cache and then reboot the scheduler domain. . 3) If an error is received while sending Crystal report output to a Printer or sending output to a network drive. If the issue is happening with ALL Crystal reports If the issue is happening with all the Crystal reports. If the results are correct for the Query. associate the query to the Crystal report again inside the Crystal Designer using the Database > Set Data Source Location option. 4) Confirm there are not two or more different PeopleTools versions installed on the Process Scheduler host machine. 8) If the Crystal report is not generating the correct data. try deleting the Process Scheduler cache and then rebooting the Scheduler domain. there is only one file location for the designated PSQODB32. the crystal report may not be sent to a Printer. such as TEST or DEMO. this must be the same Windows LoginID/Password which is starting the BEA Tuxedo Service under "This Account" . into the system directories (C:\Program Files\Common Files\Crystal Decisions\2. when the Network Domain login screen appears after doing the Control + Alt + Delete.0 there are specific steps to follow to perform the Set Datasource Location. as described above. Compare the results of the query. the issue may be with the Query associated with that specific Crystal report. In those scenarios open the report in Crystal Designer and go to File > Printer Setup and “uncheck” the “No Printer” box. change accordingly. as discussed earlier. 2) If the issue started happening suddenly and the crystal reports were running fine. compare the Process Definition of the same Crystal report in both the environments. confirm the BEA ProcMGR Tuxedo Service is started using "This Account" as opposed to LocalSystem.7) Determine if the same report is running successfully in another environment.1). Multiple releases on the same host machine can be problematic for the following reasons: Due to the Windows Registry design of the ODBC key under HKEY_LOCAL_MACHINE and HKEY_CURRENT_USER. open the associated query in the Query Client or from the Web ReportingTools > Query Manager and run it. the files are overwritten with the PeopleTools release last started. Also.

DLL and ExportModeller. Run control data is also present in PS_PRCSRUNCNTL table. Example SQL to execute: select OPRID. RUN_CNTL_ID. if the Crystal reports are running successfully when running to output format as WEB but failing when sending Crystal report to EMAIL or PRINTER. The Process Scheduler logs are available in this location %PS_HOME% \appserv\prcs\<Process Scheduler domain name>\LOGS 2) The process Message Log accessible from the Process Monitor > Details page may contain important information. 5) Determine whether the issue is happening with Crystal reports to some specific output formats such as: PDF. PeopleTools does not prevent an incorrect language code from being submitted. update the run control record language code to ENG. For example the CRXF_PDF. To resolve the issue. Report run control tables may have names like PS_RUN_<report name> OR PS_RUN_CNTL_<report name>. EMAIL or PRINTER. RUN_CNTL_ID. LANGUAGE_CD Check the same run control tables in ALL other environments. The Error message may help further troubleshoot the issue. After fixing the Language Codes in the run control tables or all environments. etc. LANGUAGE_CD from PS_PRCSRUNCNTL where LANGUAGE_CD <> 'ENG' order by OPRID.. 7) The issue may be caused by damaged DLLs which are responsible for exporting Crystal output to the specific format.5) Anti-Virus software has been associated with damaging of Crystal Reports DLL running in memory or residing on disk on a Process Scheduler box. DEMO. Steps to troubleshoot 1) Check Process Scheduler logs for any error messages. If that runs to success then the issue is likely specific to the certain Crystal reports only. Investigate printer setup on the process scheduler host machine and SMTP services on the same machine. Test run the XRFWIN Crystal report in the Web environment from this navigation: PeopleTools > Process Scheduler > System Process Requests 4) Select XRFWIN Crystal report to output type WEB and output format as PDF and run. 9) If the error “wrong language selected” occurs when running Crystal reports. Additionally. then the issue may be with underlying EMAIL or PRINTER configurations. it is likely caused by a run control record having been mistakenly created using a Language Code other than ENG. TEST. such as DEV. 8) Determine whether the issue is happening with Crystal reports to a specific output type such as: web. examine the run control tables for a non-supported language. If the issue is only with using the PDF format then copy the DLLs from a working environment to the problem environment and retest. 3) Try to determine whether the issue is happening with all the Crystal reports or some specific Crystal reports. stop and restart the PSNT Process Schedulers and test running the Crystals again . For example. or HTM 6) Test running XRFWIN Crystal report to different output types and output formats in combination. DOC. to assure the issue is stopped.DLL are responsible for writing output to PDF.

PRCSINSTANCE FROM PSPRCSRQST A WHERE NOT EXISTS (SELECT 'X' FROM PSPRCSQUE B WHERE B.If the issue is happening intermittently with ALL Crystal reports If the basic delivered functionality of Crystal Reports through the Process Scheduler is working for delivered sample reports.PRCSINSTANCE) / SELECT A. Firstly.PRCSINSTANCE = A. Delete any such processes from the PSPRCSRQST and PSPRCSQUE records. 2) When Crystal reports start remaining in Queued status or remain in the Processing status.PRCSINSTANCE FROM PSPRCSQUE A WHERE NOT EXISTS (SELECT 'X' FROM PSPRCSRQST B WHERE B. examine the following: 1) Intermittent issues happen due to corruption of Process Scheduler cache or a block of resources. such as the XRFWIN report. Max API Aware =5 COBOL=3 Crystal=3 SQR=3 increase the Max . Retest. there may be a outof-sync condition or blocked status with the Process Scheduler tables.PRCSINSTANCE = A. Concurrent setting for Crystal in the Server definition page: Example: Max API Aware: 7 Crystal Max Concurrent: 3 Each Scheduler server has a Max API Aware number for Concurrent tasks and each Process Type has a Max Concurrent for that process type. delete the Process Scheduler cache and then restart the Scheduler domain. Then delete cache files and restart the Scheduler. yet intermittently reports go to error. There may be some queued processes in the PSPRCSRQST record and the PSPRCSQUE record from an old system. a) Confirm the PSPRCSRQST and PSPRCSQUE records have the same number of rows SELECT COUNT (*) FROM PSPRCSRQST SELECT COUNT (*) FROM PSPRCSQUE SELECT COUNT * FROM PS_MESSAGE_LOG b) Execute the following SQL to determine the rows that are out of sync (Oracle) and Delete any rows returned by these queries: SELECT A.PRCSINSTANCE) / c) Check the PSPRCSRQST record for old Crystals stuck in “Queued” status d) Check the PSPRCSRQST and PSPRCSQUE records for previous requests in Error or Blocked status. 3) If the issue happens only when multiple Crystal reports are running simultaneously.

4) There are reported issues with Crystals remaining in the Queued status. must be started as “This Account” instead of “Local System Account”. when a Master Scheduler service is running. confirm that the SMTP server is configured correctly in the PSPRCS. confirm that the problem users have access to run the Queries behind those Crystal reports. Refer to: E-CR: CR9 Error 'memory full' during export and 'Not enough memory for operation' (Doc ID 658499.CFG file. Refer to E-CR: Command line length being truncated (Doc ID 612557. specify the same UserID/Password in the Services page > Log On As field. 3) Confirm that Printer Drivers are installed properly on the Process Scheduler machine If the printer driver is properly installed and the BeaProcMgr service is logged in as “This Account”. Depending on the total number of processes submitted. Crystal Issues with “Email” output type 1) For sending Crystal reports to Email output type. This may be confirmed by running the underlying Query from the ReportingTools > Query Manager . Crystal reports should go to a printer successfully.If 3 processes of each process type are submitted. the "Network" option should be chosen and not the "Local" option. then there are 9 processes running. Test sending the XRFWIN Crystal report to the printer. 2) The “BeaProcMgr” Tuxedo service.CFG and PSAPPSRV. When configuring the printer. there may be insufficient slots for the Crystal Reports to be initiated in the timeframe desired. Crystal issue is with some specific Users 1) If only some users are not able to run Crystal reports.1) for more details Crystal reports printer issues: 1) For Crystal reports or nVision reports to print successfully to network printers specified by the UNC pathname. the network printer must be configured on the process scheduler as a "Network" printer. In the absence of the SP7 patch. The maximum number of API-aware processes will never exceed the MAX API configuration. When starting the process scheduler as a Windows Service.1) 5) Crystal Reports 9.0 SP7 patch is required. 2) The User’s email ID is a functioning address defined at the User Profile level and is authorized to view the reports. having a Standard TCP/IP port. one may receive the 'memory full' error during export and 'Not enough memory for operation' when running via Process Scheduler. Start the BEA Tuxedo Service with the same Windows Login User ID/Password that is physically booting up the PSNT Server machine and logging on to the Network Domain When starting the process scheduler manually login to the machine with the same UserID/Password as was used to connect to the network.

What else is running on the same host? 6) Check server definition (PeopleTools >Process Scheduler > Servers) Perhaps 6 concurrent Crystal Reports is too much with the other reports that may be running on the host. then correct the Query performance first. relocate it to another host. Group Footer. determine if subreports are included in that report. 5) Open the Process Scheduler logs and determine what ran and how long it ran. If the SQL runs slower with the index that without it. Click OK When a subreport is called as On-Demand. run the Query behind this Crystal report to determine if the performance degradation is with the Query. In these scenarios. If yes. To make a subreport On-Demand. this is a known issue with Crystal Software itself. Reducing the number of concurrent processes will also have an impact at the database level. reboot the scheduler domain and clear the cache before restarting. Confirm there is memory available and users are not running more processes simultaneously than the resources available. The DBA typically looks at this. Reduce the Crystal Reports Max Concurrent to 3 or even fewer. check if subreports are defined in the “detail” section of the main report. 8) If development work is being performed on the same machine as the production scheduler. Confirm that database statistics are recent and are FULL SCAN rather than sample. 9) Create another scheduler on a different host to attempt isolation of the machine as a possible cause. 4) Check that indexes are not corrupted (incorrect) and are being used by the query. the problem may be caused at the Process Scheduler level. Right click the subreport and click on Format Subreport. Was the problem caused by over-use of the available resources on the host server? Open the Windows Task Manager and monitor the resource usage at the time users are running these reports. drop and recreate them. If the indexes are corrupt. then consider dropping the index (this sometimes happens). delete the Process Scheduler cache and then restart the Scheduler domain. define the subreport in the Crystal report’s “header” as opposed to the “detail” section. (The DBA should have tools to help with this task. from the scheduler logs. go to the Design view of the Report. If it is at the Query level also. it creates a hyperlink of the subreport. Report Header. . determine what else was running at that same time. --------3) If the Crystal takes a long time. After making any changes. Below are the inputs of Business Objects/SAP ------The best way of using Subreports is to put them in the Group Header.cfg scheduler configuration file. In this case. 7) Confirm there is adequate system global area and temporary database space for sorting. Check the number of subdirectories and files in the directory specified as Log/Output Directory in the psprcs. 2) If the performance issue is with only one Crystal report. Report Footer sections but avoid using it in the Details section. Every time the report is run.). In case one does not want to move the subreport from the “Details section” then try to make the subreport 'On Demand'. In case one does not need the subreport to be evaluated.Crystal Performance: 1) If the issue started happening suddenly. simply do no click on the link and hence the data retrieval time is saved. If yes. When the processes ran long. there is an option of clicking on the hyperlink to show the data of the subreport. Now go to the Subreport tab and check the On-demand subreport check box.

check if the same report is showing the formatting issue when running to other output formats. Determine if the same report is showing the same behavior in DEMO or other environments also. please rename the same DLL in the problem environment. The issues deal with: • • • • • Extra pages in the report output Extra columns Fonts too big or too small Extra lines in the report output Column widths of variable size Examples: “The reports are running fine on our system but the only issue is that they are not running correctly to populate the cells of Excel spreadsheet or CSV format as it would show in a PDF format.1) E-CR: Crystal Reports 8 Exporting options/limitations . If the issue persists.1) E-CR: HTM format Crystal Report fonts gets large and not aligned after 30 pages (Doc ID 653361..Graph not exported in PDF and HTML format (Doc ID 615356.1) .” 1) Check if the formatting issue is happening only when crystals are running to any specific formats or with all the formats. In these scenarios.1) E-CR: Crystal 8. Below are important Oracle Knowledge Documents dealing with format-related issues of using Crystal reports in a PeopleSoft environment: • • • • • • • E-CR: Crystal 9 Outputting report to PDF format and then printing.1) E-CR: Cannot display Chinese characters in PDF format (Doc ID 624236.. there is very much probability that the specific DLL (responsible to export the crystal output to that specific format) has been corrupted in memory or on disk. such as: XLS or CSV or PDF etc.5 PDF output does not handle Long-Char Fields correctly (Doc ID 648781. generates lo (Doc ID 624700. Restart the Scheduler and re-test. and copy the same DLL from the working environment to the problem environment. these formatting issues happen when running Crystals to any specific formats. If not.1) E-CR: Crystal to PDF and Font is bad when viewing PDF document (Doc ID 622504. please check ICE for previously reported issues. See attached files. In most cases.White Paper (Doc ID 616257.Crystal Formatting Issues: Some formatting issues have been reported for Crystal Reports.1) E-CR: Crystal . In these situations.

If the issue is happening only while running a specific Application Crystal report. In this scenario. In this situation. often the issue is due to a damaged specific RPT file. If not.RPT file from the working environment to the non-working environment.1) . this is a strong indication that basic Crystal functionality is working as designed. confirm that users are able to print Crystal reports such as the delivered XRFWIN successfully. For troubleshooting this issue. 2) There are issues reported with printing MICR Fonts on Crystal Checks or simply with printing Crystal checks (for example: APY2021). it indicates that the issue is Application specific. If the same report may be opened in another environment.Unable to print MICR font on new printer Troy 2420 (Doc ID 657793. If that report goes to Run Status = Success. Please refer to the below Doc IDs before opening a new SR • • • • EAP . open the same file in any other environment. then examine the following: 1) Some reports are not able to opened using the Crystal Designer client using a 2-tier connection and are receiving “data out of memory” related error messages. If XRFWIN Crystal is printing successfully.Application specific Crystal Issues To determine whether the issue is PeopleTools specific or Application specific.15) (Doc ID 612452.1) AP: Paycycle error Selected Process Scheduler not currently running (7250.RPT report layout from the Demo environment. run the basic “Cross reference” Crystal reports XRFWIN. It may be helpful to use the crystal .RPT in the problem environment. resolve the basic printer functionality by following the above points under “Crystal Printing Issues”.1) EAP: Not able to print MICR fonts for APY2021 Crystal Checks (Doc ID 636857. replace that .1) E-CR: Troubleshooting AP Checks Printer Errors (Doc ID 651735.

rather than as flat files. converts the Crystal Report definition files from the Crystal Reports 9 (CR9) format to the Crystal Reports XI format. When to Use BOE(CE) The most important benefit of using BOE XI instead of also known as Crystal Enterprise.exe.htm Search for "Using Crystal Reports XI" and "Understanding Crystal Reports XI Compatibility Issues" Begin any installation of BOE XI(CE) with a thorough reading of the appropriate PeopleSoft Enterprise PeopleTools Installation guide for your database platform. PeopleSoft Process Scheduler report definitions are configured to use the Crystal Reports 9 print engine. you must use either the Crystal Reports 9 or the Business Objects Enterprise XI runtime environment. you can optionally use the Business Objects Enterprise XI runtime environment to run and view your reports. is the ability to run Crystal Reports on UNIX process schedulers. and the delivered Crystal Report definition files are in the Crystal Report 9 format. Crystal Reports Environments for PeopleSoft Enterprise PeopleSoft applications are delivered to work with the Crystal Reports 9 runtime environment. BOE Installation and Configuration Documentation for installation and configuration of BOE XI (CE) is available at the hosted PeopleBooks site: Crystal Reports for PeopleSoft Enterprise which describes how this product works. . PeopleTools T 8. Installing and Configuring Software for Crystal Reports. Starting in PeopleTools 8. rather than the DLL based as with CR9. http://download. you use the Crystal Reports XI product to create and edit report definitions.48 and above. Administering and Using Business Objects Enterprise Objects Enterprise Java Environment – Configuration and Use Business Objects Enterprise (Crystal Enterprise) Business Objects Enterprise XI (BOE XI). You cannot run a mixed environment in which some reports run using Crystal Report 9 and some reports run using Business Objects Enterprise XI. The executable used to run this report is javabased. For PeopleSoft applications. The BOE XI reports are stored in a database.48 “BOER XI” is supported. You use the Crystal Reports 9 product to create and edit report definitions.Chapter 6 . is supported by PeopleTools starting in PeopleTools 8. If you are using PeopleSoft PeopleTools 8.46 as the java-based version of Crystal Reports. pscrconv. With Business Objects Enterprise XI.46 and PeopleTools 8. A PeopleSoft-supplied conversion program.47 support “Crystal Enterprise 10”. PeopleBooks for Crystal Reports describes how this product works.

Using the Process Instance ID.available on DISK1. ensure the process runs to completion in process monitor.RPT link to view the report in the Business Objects Enterprise XI report viewer. Search for the report using the process instance id generated from step 2. Task 11-3-12: Configuring the PeopleSoft Application for Business Objects Enterprise XI Integration After running the indicated DMS script and project. b. The documentation indicates the viewer will be the BOE Info Viewer. Report Manager. you may have to copy nd rd st the 2 and 3 CDs to the common directory on the 1 CD. it may be necessary st to copy the ~\win32\* files from those 2 CDs to the 1 CD ~\win32 directory.EXE Task 11-3-14: Verifying the PeopleSoft to Business Objects Enterprise XI Integration When testing a report and viewing the output from the Process Monitor or the Report downloadable from View Report output in InfoViewer a.48 PeopleTools Installation Guide Referenced Issues: Task 11-3-3: Installing Business Objects Enterprise XI on Windows If the installation program gives an error when trying to access the files on the 2 and 3 CD.Business Objects Enterprise Java Environment – Troubleshooting References: 1) BOE XI Platforms.peoplesoft. and select the Administration Tab. which does not appear to be the case. Here is the doc… 2. .Chapter 7 . DOCS\en folder. the report is being pulled up directly from the PSREPORTS report repository using the PIA web server. d. .txt for Windows . DOCS\en folder. nd rd Task 11-8-2: Converting Reports from Crystal Reports 9 Format to Crystal Reports XI Format It is necessary to have both Crystal Reports 9 and Crystal Reports XI installed on the workstation simultaneously for this step to complete.http://www.available on DISK1. then the . check the process type definition in your environment. In other words. downloadable from http://edelivery. %%TOOLBINSRV%%\ 3) PeopleTools 8. You may still need to manually update the Process Type definition for Crystal for the specific database to reflect the new command line executable. Select Reporting 2) BOE XI Install. c.PDF for Windows .com>Site Index>Installation Guides and Notes>PT8.48 Installation Guide. Click the Details link next to the report.

clean the Windows Registry and remove all installation directories b) Install Crystal Reports 9 c) Install Crystal Reports XI d) Add the location of Crystal Reports 9 CRW32.“Error: Failed to retrieve the 0-th formula field of the report” Solution: Grant QUERY_TREE_PT to PeopleSoft BOE_ADMIN a) Login to PeopleSoft. .exe to the Configuration Manager Workstation install. navigate to PeopleTools > Security> User Profile > open BOE_ADMIN and determine the Primary Permission List b) Navigate to Security> Permission Lists > open the Primary Permission List c) Navigate to PeopleTools Tab > click Query Access d) Navigate to Query Tab > Access Group Permissions > Add QUERY_TREE_PT e) SAVE 3. 2.“Error: Failed to open the Report File” Solution: a) Deinstall all prior releases of Crystal Reports.“Error: Create top level folder failed” during conversion Solution: Login to BOE XI and add BOE_ADMIN to Administrators Group.Problems and Solutions: 1.

output to specific printer trays .1) E-WF/PRCS: How to configure SMTP PeopleTools 8. "Error Starting PeopleTools" (Doc ID 618497.1) E-CR: Crystal Report printing is generating "PSPAL::Abort" error (Doc ID 654202.1) E-CR: How to change the Query a Crystal 9 Report is using? (Doc ID 638844.1) E-CR: Crystal-language issues and Printer issues via the Web/PIA (Doc ID 641292.1) E-CR: Crystal PDF output goes to Portrait instead of Landscape (Doc ID 616198. dealing with various types of Crystal issues • • • • • • • E-CR: Cannot display Chinese characters in PDF format (Doc ID 624236. MICR and Printer issues (Doc ID 636478.5 produce error of. a sample of Doc Ids. then subsequent Crystal reports all error (Doc ID 619991.1) E-CR/NV: If one Crystal report hangs.1) E-CR: Crystal AP Checks .18 (Doc ID 643185.Important Doc IDs Below is.1) Crystal/Printer issues: • • • • • • • • • • • E-CR: Crystal report on the Web with output directly to printer and getting err (Doc ID 611395. CHECK1.APY2021.1) E-CR/NV: Crystal's and nVision's error to "Email/PDF" after Tools Patch 8.1) E-CR: Troubleshooting AP Checks Printer Errors (Doc ID 651735.1x. 8.1) Crystal/Email issues: • • • E-AS: How to interpret SMTP tracing (Doc ID 611273.Appendix A .1) E-CR: Crystal Trace error.4x (Doc ID 610132.1) .1) E-CR: Crystal Printing issues/errors via the Web (PIA) (Doc ID 654039.1) E-CR: Crystal reports through the Process Scheduler will not print to Legal siz (Doc ID 618585. EAP: Troubleshooting Crystal Check Signature.1).1) CR: Master Resolution for Crystal Reports Print Engine error text: Error in Fil (Doc ID 614753.45. 2 (Doc ID 640344.1) E-CR: Troubleshooting AP Checks Printer Errors (Doc ID 651735.1) E-CR: Crystal Date Format Issue (Doc ID 619839. "No Default Printer" (Doc ID 617896.1) E-CR: How to correctly specify the Printer and Orientation in Crystal? (Doc ID 621234.1) E-CR: Crystal Reports 8.

Crystal 9 is getting an error if left idle for 20 minutes Error may be: Incident # 1655734000 -. Incident # 1325413000 -.Language code for Crystal Report getting overwritten with lang code of another report run at exactly the same time by another user.pstowordsloc function is not producing correct results for ITALIAN language Incident # 150577000 -.Add ability to export to XML output format.Crystal report: custom date/time format has no impact of the output layout Incident # 1343207000 -.Crystal 9 .46 Tools for BAM Connectivity (Business Analysis Modeller) Incident # 1376228000 -.18 Incident # 110799000 -.Unable to perform Queries using PSODBC in 8.Appendix B . not the report requester's locale .Crystal's don't email to Distribution for "Email/PDF" after Tools Patch 8. Incident # 122146000 -.Crystal formats all dates and times based on the server's locale.Important Incidents Below are some important issues with Crystal Reports previously reported to Development. Incident # 1728266000 -.Crystal checks & file copy sent to printer will only print from the default tray Incident # 142287000 -.45.

Customer Validation PeopleSoft is interested in obtaining feedback regarding this document. . replicated and posted here. Additional content will be verified.Appendix C .Validation and Feedback This section documents customer response to this Troubleshooting Guide. 1) PeopleBooks 3) PeopleTools Installation Guides and Notes • • • Knowledge > Tools and Technology > ReportingTools Product Certifications > PeopleSoft Enterprise Certifications Patches and Downloads > • Knowledge > Browse Home > Tools and Technology > Documentation > Installation Guides and Notes 4) Crystal Reports and Business Objects Enterprise references http://www12.epx .com/pls/psft/homepage > PeopleTools Release > Crystal Reports for PeopleSoft 2) Oracle MetaLink

and Siebel are registered trademarks of Oracle Corporation and/or its affiliates.A. PeopleSoft. All rights reserved.PeopleSoft Crystal Reports 8.7200 oracle.7000 Fax: +1. This document is provided for information purposes only and the contents hereof are subject to change without notice.650. for any purpose. .506. Other names may be trademarks of their respective owners. without our prior written permission. Oracle. electronic or mechanical. This document may not be reproduced or transmitted in any form or by any Copyright © 2009.506.650. One specifically disclaim any liability with respect to this document and no contractual obligations are formed either directly or indirectly by this document.5/9/XI Troubleshooting Guide By Sandeep Verma and Kirsten Zurbrugg [March] 2009 Oracle Corporation World Headquarters 500 Oracle Parkway Redwood Shores.S. nor subject to any other warranties or conditions. including implied warranties and conditions of merchantability or fitness for a particular purpose. CA 94065 U. whether expressed orally or implied in law. Worldwide Inquiries: Phone: +1. JD Edwards. This document is not warranted to be error-free. Oracle.