Crystal Troubleshooting Guide | Computer Data | Software

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

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

Scroll down to the appropriate PeopleTools entry for the desired environment. 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. PeopleTools delivers Windows Crystal executables such as “PSCRRUN.exe” and “ Set Product Pack to “PeopleSoft Enterprise” and Platform to “Microsoft Windows 32” and click GO. For example. customized or new reports may be implemented within a PeopleSoft environment. For may customize the delivered Crystal reports. “PeopleTools Enterprise – PeopleTools 8. No Crystal Report may be run from the PeopleSoft Application for which the data source is not a Query. which may be viewed from the PeopleSoft Query Manager. This data access method enables PeopleSoft Security to be applied to the reports produced with Crystal/BOE. Each Crystal Report delivered with the PeopleSoft application is associated with a Query. For example. now owned by SAP. The necessary program files are installed during the PeopleTools installation on a Process Scheduler host machine. After successful testing of these reports with the Crystal Designer tool. %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. 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.Executive Overview Crystal Reports/BOE is third party reporting software. Crystal is one of the most highly used reporting tools within the scope of PeopleSoft applications. PeopleSoft uses this software for delivered PeopleSoft applications reports. or may create totally new reports.Chapter 1 . The PeopleTools accesses enable a view of accessible PeopleSoft Queries. Often the Query has the same name as the report format file. the XRFWIN Crystal Report uses the Query “XRFWIN”. according to their requirements. Crystal Reports Related Executable Programs Windows software programs to run Crystal Reports within the PeopleSoft application are delivered with PeopleTools.0 English”.49 Media Pack”. “Crystal Reports 9. On the following page. click the Download link in front of the desired Crystal Reports product. Users design and/or customize reports by means of the Crystal Designer client software tool. .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. Click the Description link.

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

Crystal Designer output may also be exported to a number of different standard formats such as format. 5) Upgrading PeopleTools or Crystal software and using the PeopleSoft Crystal Reports converter program PSCVTRPT. . 1) Confirm that the Crystal software version being used is certified with the respective PeopleTools release. CSV.1 2) Download and install the appropriate release of Crystal Reports based on the certification 3) Perform the Configuration Manager Workstation Install on the desired machine. Testing the newly developed and customized Crystal Reports Running Crystal Reports against a PeopleSoft database. and sending it to “Printer” or “File” output type. View the “Third party” software certification details in Metalink: URL: https://metalink3. HTM. and others.EXE to update the reports for the new NOTE: The primary delivered output format of Crystal Designer is to the proprietary Crystal *. generating an . Then set the correct configurations in these locations for the following parameters: a) Navigate to: Profile > Edit > Default > Process Crystal software is required in order to read RPT files.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. from the following location: URL: http://edelivery.jspx?id=747587. 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. DOC. Configuring Crystal Designer Client Follow these steps to work with Crystal Designer client software over a 2. XLS.exe.or 3-tier connection.RPT output file.

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

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

00. and PT8. i) For a 3-tier connection via the Application Server to the database. 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. 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> .48.46. Click Set. please perform the following navigation: Navigate to Profile > Edit > Default.h) For 3-tier connectivity. PT8.14. machine name and port number. The issue is fixed in PT8. Click the Application Server radio button and add an Application Server Domain name.07.47.

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

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. it may be advisable to specify a different location from the delivered Crystal Reports path. If a path is not specified however. Sending Query output to Crystal Reports rd format is done by clicking the 3 button in the Query Manager.2) Set a path for the Default Crystal Reports field in “Configuration Manager > Crystal/Bus. users should be able to generate query output to Crystal from the PeopleSoft Query client software. . Interlink/Jdeveloper”. to avoid overwriting delivered files. As this field is used by PeopleSoft Query.


Troubleshooting Various issues may occur while running Crystal client software using a 2. confirm the supportability of the machine OS and Crystal software versions. Points to consider before applying any solution steps for Crystal issues are: Checklist 1. 6. Search for any previously reported specific software issues. 5. Check the below points: 1) Confirm the entries for “Crystal /Bus. 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.or 3-tier environment. 4. 6) In scenarios where users are not able to connect to the PeopleSoft database within Crystal Designer. If the issue is happening with specific machines. 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. the issue may lie with the Query Access Security of the underlying Query. 2) Perform the Workstation Installation on the host machine as described above.Crystal in a Client Environment . For details. Crystal on Windows 2000 may get an “IM003” error message while running Crystal reports. refer to Enterprise PeopleTools 8. confirm the connection is being made under the Create New Connection > ODBC (RDO) > PeopleSoft PeopleTools driver. Interlink/Jdeveloper” and “Process Scheduler” tabs in the “Configuration Manager”. If the issue occurs only with specific users. 2. . 3. 4) Confirm whether the issue is occurring with a specific user or all users. For example.Chapter 3 .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.

1) .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.

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

6) Occasionally a User Profile may run one specific Crystal report and data is not refreshed. . the same data will continually be in the Crystal report output. The specific User Profile must have PeopleSoft Security Query Access to run each specific Query. In such situations. Older data is in the report output. If it is checked. In such scenarios. 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. open the problem Crystal report in Crystal Designer and check if File > Options > Reporting > Save data with report is checked.

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

CFG) is found at the below location: %PS_HOME%/appserv/prcs/domain name/ Configuration Manager Workstation Installation With PeopleTools 8. 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.EXE or PSBOERUN. within a PSJOB. perform the Workstation Installation to incorporate those changes into the Windows Registry and copy necessary files into the correct system locations. 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 necessary Crystal DLLs and ODBC driver files are installed during startup of the Process Scheduler domain. Users can run Crystals to different output types and output formats.EXE) on the Process Scheduler host machine.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.0\bin C:\WINDOWS\system32 Crystal Reports are often submitted by end users from a run control page. which contains: Errors. the Workstation Installation After changes are made to the Configuration Manager > Process Scheduler tab. The “PSPRCS.EXE is executed. Additionally.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. it executes a special Crystal Reports API binary (PSCRRUN. The User’s LANGUAGE_CODE is then appended to the CRWRPTPATH to determine the sub-directory from where the report is taken. This is the psinstal.44 onwards. The Process Scheduler configuration file (PSPRCS. the exact source and destination of each file copied. available for Crystals in web environment: . along with different other Process types.log file written to the %TEMP% directory.Chapter 4 . Different Output types. When a Crystal report is run by a Process Scheduler. and shortcuts created During WI process. updates to the Windows Registry. The Workstation Installation is described above in Chapter 2. The exact API executed depends on whether Business Objects Enterprise has been implemented in the environment. The Workstation Install process creates a log showing each step in the WI process.

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

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.PDF. 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. PeopleSoft Security. 3) Sometimes the issue happens on passing prompts in the command line which is generated for the Process Scheduler. this indicates that basic setup for running Crystal reports from the Process are likely configured correctly. the issue could be at the Query level. determine the root cause.Troubleshooting When troubleshooting Crystal Reports run by the Process Scheduler in a Web environment.Crystal in a Web Environment . Confirm that the prompts are in the correct order in the Process Definition for this Crystal report. correct the Query and then re-associate the modified Query to the Crystal report with the steps suggested in: (Doc ID 638844. printer. Confirm that the prompts are created in the PeopleSoft Query and not in the Crystal report. Review the below points: 1) Attempt to run the same Crystal report from the Crystal Designer client. This is a PeopleSoft requirement. For a sample Crystal Report using 3 prompts the Parameter line would appear something like: -ORIENTL :RUN_CNTL_AP. the Query. consider these questions to clarify the issue. 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. 2) If not successful. The issue may be within the Crystal report definition.OPRID :RUN_CNTL_AP. or other report-specific area. . . 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 specific format.RUN_CNTL_ID :RUN_CNTL_AP.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. email etc. but not ALL. Please try to run the underlying Query from ReportingTools > Query Manager.) or specific output formats (like . If the Query is not successful. When issues are happening with only ONE Crystal Report If the issues are happening with one or more specific Crystal reports.Chapter 5 .XLS. .1) “E-CR: How to change the Query a Crystal 9 Report is using?” Now retest.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.

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

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

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

PRCSINSTANCE FROM PSPRCSRQST A WHERE NOT EXISTS (SELECT 'X' FROM PSPRCSQUE B WHERE B.PRCSINSTANCE = A. examine the following: 1) Intermittent issues happen due to corruption of Process Scheduler cache or a block of resources.PRCSINSTANCE FROM PSPRCSQUE A WHERE NOT EXISTS (SELECT 'X' FROM PSPRCSRQST B WHERE B. 3) If the issue happens only when multiple Crystal reports are running simultaneously. 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. There may be some queued processes in the PSPRCSRQST record and the PSPRCSQUE record from an old system. Delete any such processes from the PSPRCSRQST and PSPRCSQUE records. Max API Aware =5 COBOL=3 Crystal=3 SQR=3 increase the Max .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. Then delete cache files and restart the Scheduler. such as the XRFWIN report. 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.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. 2) When Crystal reports start remaining in Queued status or remain in the Processing status.PRCSINSTANCE = A. there may be a outof-sync condition or blocked status with the Process Scheduler tables. yet intermittently reports go to error. Retest. Firstly.PRCSINSTANCE) / SELECT A.

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

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

See attached files. please rename the same DLL in the problem environment. Determine if the same report is showing the same behavior in DEMO or other environments also..5 PDF output does not handle Long-Char Fields correctly (Doc ID 648781.Graph not exported in PDF and HTML format (Doc ID 615356. and copy the same DLL from the working environment to the problem environment. In these scenarios.1) E-CR: Crystal 8.1) E-CR: Crystal to PDF and Font is bad when viewing PDF document (Doc ID 622504.Crystal Formatting Issues: Some formatting issues have been reported for Crystal Reports.1) . If the issue persists.1) E-CR: Cannot display Chinese characters in PDF format (Doc ID 624236. 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. If not. these formatting issues happen when running Crystals to any specific formats. generates lo (Doc ID 624700.” 1) Check if the formatting issue is happening only when crystals are running to any specific formats or with all the formats.White Paper (Doc ID 616257. Restart the Scheduler and re-test..1) E-CR: Crystal Reports 8 Exporting options/limitations . such as: XLS or CSV or PDF etc. In most cases. 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.1) E-CR: Crystal . In these situations.1) E-CR: HTM format Crystal Report fonts gets large and not aligned after 30 pages (Doc ID 653361. check if the same report is showing the formatting issue when running to other output formats. 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. please check ICE for previously reported issues.

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

also known as Crystal Enterprise.Chapter 6 . converts the Crystal Report definition files from the Crystal Reports 9 (CR9) format to the Crystal Reports XI format. and the delivered Crystal Report definition files are in the Crystal Report 9 format. you must use either the Crystal Reports 9 or the Business Objects Enterprise XI runtime environment. as the java-based version of Crystal Reports. If you are using PeopleSoft PeopleTools 8.Business Objects Enterprise Java Environment – Configuration and Use Business Objects Enterprise (Crystal Enterprise) Business Objects Enterprise XI (BOE XI). PeopleTools T 8.48 and above. pscrconv.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.exe. Installing and Configuring Software for Crystal Reports.46 and PeopleTools 8. For PeopleSoft applications. PeopleBooks for Crystal Reports describes how this product works. PeopleSoft Process Scheduler report definitions are configured to use the Crystal Reports 9 print engine. rather than the DLL based as with CR9. Starting in PeopleTools 8. is supported by PeopleTools starting in PeopleTools 8. is the ability to run Crystal Reports on UNIX process schedulers. The executable used to run this report is javabased. The BOE XI reports are stored in a database.47 support “Crystal Enterprise 10”. With Business Objects Enterprise XI. you can optionally use the Business Objects Enterprise XI runtime environment to run and view your reports. Administering and Using Business Objects Enterprise XI. When to Use BOE(CE) The most important benefit of using BOE XI instead of CR9. you use the Crystal Reports XI product to create and edit report definitions. You cannot run a mixed environment in which some reports run using Crystal Report 9 and some reports run using Business Objects Enterprise XI. rather than as flat Crystal Reports Environments for PeopleSoft Enterprise PeopleSoft applications are delivered to work with the Crystal Reports 9 runtime environment. You use the Crystal Reports 9 product to create and edit report definitions. . 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. A PeopleSoft-supplied conversion program.48 “BOER XI” is supported.

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

Problems and Solutions: 1. 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. 2. .“Error: Failed to open the Report File” Solution: a) Deinstall all prior releases of Crystal Reports.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.“Error: Create top level folder failed” during conversion Solution: Login to BOE XI and add BOE_ADMIN to Administrators Group.

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

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

Customer Validation PeopleSoft is interested in obtaining feedback regarding this document.Validation and Feedback This section documents customer response to this Troubleshooting Guide. . replicated and posted here.Appendix C . Additional content will be verified.

com • • • 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 > PeopleTools Release > Crystal Reports for PeopleSoft 2) Oracle MetaLink 3) PeopleTools Installation Guides and Notes https://metalink3.epx .oracle.References 1) PeopleBooks

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

Sign up to vote on this title
UsefulNot useful