PeopleSoft XML Publisher

Feb 2, 2009 By Mritunjay & Gajalakshmi

1
PS Technical Training

Agenda

Definition Installation and Settings Report Creation Steps PS Query Based Report Rowset Based Report Migrating between Instances Trouble Shooting Samples
2
PS Technical Training

Definition
XML Publisher /Oracle Business Intelligence Publisher / BI Publisher / XMLP It is a template-based reporting tool that leverages standard technologies for data extraction and display It segregates the Data Logic from the Presentation Layout during development of the reports and combines them at run time End users with minimal training are able to design templates and reports based on generally designed data sources, thus greatly reducing the cost of ownership.

3
PS Technical Training

Prerequisites
1. PeopleTools 2. Java Runtime Environment (JRE) 1.4. and Microsof .Net 2.0 3. Microsoft Word 2000 (or later versions)

4
PS Technical Training

Installation
1. From the left navigation bar in PeopleSoft Applications, select XML Publisher> Setup > Design Helper to download the Template Builder.

2. Download the Template Builder by clicking the Plug-in link. You can save the download anywhere (for example, in c:\temp).

5
PS Technical Training

Installation cntd.,
3. Double-click setup.exe to start the installation process. A set of installation wizard pages guide you through the installation process.

4. After XML Publisher Desktop is installed, open Microsoft Word. Notice a menu item named Template Builder in the menu bar and a new toolbar.

6
PS Technical Training

Settings
XML Publisher Global Engine Settings 1.Define XML Publisher settings. The xdo.cfg file is primarily used for: Setting a temporary directory. Setting properties for PDF, RTF, and HTML output files. Setting PDF security properties. Setting font locations and substitutions. Setting translation properties. The default xdo.cfg file is located in the $PSHOME/appserver directory, which is shared by all application server and process scheduler domains by default.

7
PS Technical Training

Setting contd.,
2.Set up XML Publisher permissions. PTPT2600 - XMLP Report Developer - Report developers PTPT2500 - XMLP Power User - Power users Now the user can have access to all components to the XML Publisher menu. 3.Set Up Report Manager: Activating Domain: PeopleTools-> Integration Tools-> Configuration-> Quick Configuration Service Operations PeopleTools->Integration Tools-> Integration Setup-> Service Operations PSRF_FOLDER_CREATE PSRF_REPORT_CREATE PSRF_REPORT_DATE_CHANGE PSRF_REPORT_DELETE The Default Service Operation Version must be ACTIVE.

8
PS Technical Training

Report Data Sources

Source Types: PeopleSoft Query  Rowset object  XMLDoc object  XML files. For improved performance, Rowset and XMLDoc data sources should only be used for small low volume reports Moderate to large reports should use XML files as their data sources. XML data can be generated using PS/Query, SQR, Application Engine, PeopleCode, FileLayout etc., and use XML File as a data source for all other means of data generation. Internally all data source types will be converted to xml files before passing them to the core formatting engine
9
PS Technical Training

Report Generation
Steps to be Followed: Create Data Source  Create xml and xsd files  Crete template file For RTF File Open Word Document Go to Add Ins Tab Load XML Using Insert Tab, Create Table Save as .rtf file.  Create Report Definition  Run the report definition

10
PS Technical Training

Flow Diagram

11
PS Technical Training

PS Query Report
Steps for Query report Generation: Create PS Query Create a Data Source which is of type PS Query Generate the xml and schema file in Data source definition page. Create template (.rtf file) Create Report definition Run the report using Query Report Scheduler View results using Query Report Viewer
12
PS Technical Training

Data Source Creation

13
PS Technical Training

DS Contd.,

14
PS Technical Training

Report Definition

15
PS Technical Training

Report Definition contd.,

16
PS Technical Training

Report Definition

17
PS Technical Training

Report Definition

18
PS Technical Training

Creation of .rtf file

Refer the below attached for creating .rtf file

Microsoft Office Word Document

19
PS Technical Training

View Report (PS Query)

20
PS Technical Training

Rowset Based Report

Generate XML and XSD Files Create Data Source as type Rowset Create Template Create Report Definition Create Application Engine Program Create Process Definition Run the Report View Report in Report Manager

21
PS Technical Training

Rowset Rpt Data Source

22
PS Technical Training

Report Defn

23
PS Technical Training

Application Engine Program

For Creating XML and XSD Files:
import PSXP_XMLGEN:*; Local Rowset &rs; Component string &mySchema, &myXMLFile; Local File &f1, &f2; /*Create Rowset*/ &rs = CreateRowset(Record.DEPT_TBL); /*Fill Rowset*/ &rs.Fill("WHERE FILL.SETID = 'AUS01'"); /*Create Schema*/ &rds = create PSXP_XMLGEN:RowSetDS(); /*package method*/ &mySchema = &rds.getXSDSchema(&rs); &f1 = GetFile("c:\temp\DEPT_XSD.xsd", "W", %FilePath_Absolute); &f1.WriteLine(&mySchema); &f1.Close(); /*Create Sample XML File*/ &myXMLFile = &rds.getXMLData(&rs, "C:\temp\DEPT_XSD.xsd"); &f2 = GetFile("c:\temp\DEPT_XML.xml", "W", %FilePath_Absolute); &f2.WriteLine(&myXMLFile); &f2.Close();

24
PS Technical Training

Application Engine Program

For Generating Report Output
import PSXP_RPTDEFNMANAGER:*; import PSXP_XMLGEN:*; Local Rowset &rs; Local string &rptDefnId = "CT_XMLROW"; Local string &LanguageCode = "ENG"; Local string &outputfmt = "HTM"; Local string &sTemplateId = "CT_XMLROW_1"; Local string &folderName = "General"; Local PSXP_RPTDEFNMANAGER:ReportDefn &rptDefn;

&rptDefn = create PSXP_RPTDEFNMANAGER:ReportDefn(&rptDefnId); &rptDefn.Get(); /*Create Rowset*/ &rs = CreateRowset(Record.DEPT_TBL); /*Fill Rowset*/ &rs.Fill("WHERE FILL.SETID = 'AUS01'"); &rptDefn.SetRuntimeDataRowset(&rs); &rptDefn.ProcessReport(&sTemplateId, &LanguageCode, %Date, &outputfmt); &rptDefn.Publish("", "", "XMLP", CT_XMLROW_AET.PROCESS_INSTANCE); PS Technical Training

25

View Report

26
PS Technical Training

Sample - Report Output

Click Here to view the output

HTML Document

27
PS Technical Training

XMLP File Defn objects

Steps to migrate XMLP File Defn objects from one environment to another: How to export a Project to a file? 1. Open Application Designer on the first environment (ex. PS1). 2. Create a new project 3. Insert XML Report Definition wanted. 4.Select both Related Definitions (XMLP File Defn, XMLP Templates Defn) 5. Select Report Defn Id and press Insert button. When migrating an XMLP report, please include the following into your project: a. Data Source b. PeopleSoft Objects used for data collection ( Query, File Layout, Records used in Rowset, etc) c. Report Definition with ALL RELATED OBJECTS being highlighted in Object selection dialog
28
PS Technical Training

XMLP File Defn objects

6.Go to the Upgrade tab and see all the definitions inserted. 7. Go to the Tools menu > Copy Project option > To File option 8. Press Copy button How to import a Project from a file? 1. Open Application Designer on the second environment (ex. PS2). 2. Go to the Tools menu > Copy Project option > From File option 3. Select the new project created above. 4. Press Select button after the selection of the project. 5. Press the Copy button 6. Open the imported project and verify all the definitions imported.

29
PS Technical Training

Trouble Shooting
Case 1: The system cannot find the path specified

Check the process scheduler is using PSAESRV Application Engine servers and see what is configured for the JavaVM Options parameter. When PSAE is used, rather than the PSAESRV, two configuration changes are required: 1) psprcs.cfg parameter JavaVM Options = Dxdo.ConfigFile=%PS_HOME%/appserv/xdo.cfg 2) Application Engine Process Type definition CWD field value must be Null When PSAESRV is used, configurations required: 1) psprcs.cfg parameter JavaVM Options = -Dxdo.ConfigFile=../../xdo.cfg 2) Application Engine Process Type definition CWD field value may be Null or %%DBBIN%%

30
PS Technical Training

Trouble Shooting
Case 2: Field is Required: PSXPRPTFMT_VW - PT_TEMPLATE_TYPE (124,64) Re-run the original DMS statements in pt<ver>tls.dms (example pt848tls.dms) to put the data in their target environments. -- populate initial list of allowed template file formats SET LOG PT<ver>TLS_PSXPTMPLTYPE.log; set input PSXPTMPLTYPE.dat; delete from PSXPTMPLTYPE; import *; -- populate initial list of supported output types SET LOG PT<ver>TLS_PSXPTMPLOUTFMT.log; set input PSXPTMPLOUTFMT.dat; delete from PSXPTMPLOUTFMT; import *;

31
PS Technical Training

Trouble Shooting
Case 3: Error generating report output In this case there could be two reasons why the relative "CACHE" directory does not work. 1) It doesn't exist under the PS_SERVDIR directory. 2) It does exist under the PS_SERVDIR directory, due to not using PSAESRV service under the appserver domain. If psaesrv service is not started, then: 1. The relative path specified will work if the Current Working Directory specified is blank into the Process Type definition for App Engine . or 1. In the xdo.cfg file,under %PSHOME%\appserv, there is a setting called system-temp-dir (<property name="system-temp-dir">CACHE</property>). The system-temp-dir property is used only for PDF,RTF and not for HTM and XLS. For example: property name="system-temp-dir">c:\temp</property>. 2. Restart both application server and process scheduler.
32
PS Technical Training

Trouble Shooting
Case 4: Java VM library jvm not found. (2,717) You should check both psappsrv.cfg and psprcs.cfg entries JavaVM Options=-Dxdo.ConfigFile=../../xdo.cfg. (You can also use absolute path %PS_HOME%/APPSERV/xdo.cfg. Using absolute pathes is more reliable option.) A reconfigure of the appserver and process scheduler domains using psadmin is required for changes to take effect. Please check if 'Add to CLASSPATH' key is populated in AppServer and/or PRCS configuration files. You can add xdo56.jar and axdoparser.jar to the beginning of this string value and bounce your domains. Please also try to stop both application server and process scheduler, clear CACHE and start both of them.

33
PS Technical Training

Trouble Shooting
Case 5: Error : Field Does Not Exist Solutions: Check AET State Record is attached with AE Check the Table is built Check the particular field exists in the record Check for Naming mistakes

34
PS Technical Training

Samples ?

35
PS Technical Training

Q&A

36
PS Technical Training

Thank You !

37
PS Technical Training