This action might not be possible to undo. Are you sure you want to continue?
PeopleTools Release 8.48
November 16, 2007
What is XML Publisher?
Starting in release 8.48, Oracle XML Publisher (XMLP) was incorporated into PeopleTools to enhance the reporting capability of PeopleSoft Applications. XML Publisher is synonymous with BI Publisher (Business Intelligence). The two terms are interchangeable.
What is XML Publisher?
XML Publisher is a Java-based reporting tool that makes report generation more efficient by separating the data extraction logic from the report layout.
Data Extraction XML Publisher Report Layout Report Output
What is XML Publisher?
Report templates can be created using common software such as Microsoft Word, Excel, Adobe Acrobat, etc., while data sources can come from PeopleSoft Queries, rowsets, XML document objects, or XML files. The separation of data sources and report templates allow end users to modify the report layout, using familiar desktop applications, without the assistance of technical developers once the data source of the report is created.
Running a Query-Based XMLP Report
Main Menu > Reporting Tools > XML Publisher > Query Report Viewer
XMLP Report Output Types There are four XMLP report output types: HTM PDF RTF XLS Page 6 .
Data Source Let’s examine the data source for the delivered report that we just ran: Main Menu > Reporting Tools > XML Publisher > Data Source Page 7 .
Types of Data Source There are four types of XMLP report data sources: PS Query Rowset XML File XMLDoc Page 8 .
Navigate to the Report Definition component. Page 9 . Open up the report definition named JPM_CATI_RPT (“Content Items Report”).Report Definition It is in the Report Definition that a Data Source is associated with one or more layout template files.
Report Definition Main Menu > Reporting Tools > XML Publisher > Report Definition Page 10 .
Template Page 11 .Report Definition .
In order to be available at runtime. Notice that each template can have one or more template files associated with it. Page 12 . When the report is run. a template file must be “Active”. But only one template can be the default template.Report Definition . Each report can have multiple templates. Each template file assigned to a template must have a unique effective date.Template Notice the Level 1 and Level 2 scroll areas on the Template page. any of the templates can be specified.
and previewed. Therefore. you must design the layout of your report (the template) before you can create the report definition.Report Definition . template files can be uploaded. On the Template page.Template You will not be able to save a report definition unless it has been associated with at least one active template file. Page 13 . generic data is used to provide an example of the layout of the report. downloaded. When you preview a template.
” which is a required attribute for all report definitions and sub-templates. It is a good idea to install the Template Builder plug-in for Microsoft Word. There must be at least one “Report Category.Setting Up XML Publisher Setting up your PeopleSoft system to use XML Publisher requires just a few steps. Page 14 . This will make it easier to design RTF templates for your reports. The XDO configuration file identifies the location of the cache directory for your application server domain.
if your application server domain is called CSDMO90.” The value for this property must point to the CACHE directory for your application server domain.Setting Up the XDO Configuration File In the “appserv” directory. Page 15 . For example.cfg”. under “PSHOME” you will find a file called “xdo. the system-tempdir setting in the xdo. One of the “property” tags in this file identifies the “system-temp-dir.cfg file would be: [PS_HOME]/appserv/CSDMO90/CACHE.
<property name="pdf-permissions-password">owner</property> --> </properties> </config> Page 16 .com/oxp/config/"> <properties> <!-.cfg file is modified): <config version="1.PDF Security --> <!-.PDF compression --> <property name="pdf-compression">true</property> <!-.oracle.Setting Up the XDO Configuration File This example is from a Windows server environment.0.<property name="pdf-security">true</property> --> <!-. where the name of the application server domain is HRDMO90 (The Application Server does not need to be restarted after the xdo.<property name="pdf-open-password">user</property> --> <!-.0" xmlns="http://xmlns.System level properties --> <property name="xslt-xdoparser">true</property> <property name="xslt-scalable">true</property> <property name="system-temp-dir">T:\PT848\appserv\HRDMO90\CACHE</property> <property name="system-cachepage-size">50</property> <!-.
Page 17 .Setting Up Report Categories Report Category is a required field for all report definitions and subtemplates. There is one delivered report category: ALLUSER. Report categories define groups that enable control over who can access and edit report definitions and subtemplates.
Setting Up Report Categories Main Menu > Reporting Tools > XML Publisher > Setup > Report Categories Page 18 .
and easily map the tags in the XML file to fields that appear in the report. You must have Microsoft word installed prior to installing the plug-in. Much of the basic syntax that is necessary will be imbedded in the form fields in the Word document. Page 19 .The Template Builder for Microsoft Word This plug-in for Microsoft Word helps facilitate the development of RTF template documents in Microsoft Word. It allows you to associate an XML file with a report template.
The Template Builder for Microsoft Word The following navigation will allow you to download the Template Builder for Microsoft Word: Main Menu > Reporting Tools > XML Publisher > Setup > Design Helper Page 20 .
The Template Builder for Microsoft Word You can also find the Design Helper in the <PSHOME> directory: <PSHOME>\webserv\<webservername>\ applications\peoplesoft\PORTAL\ps\xmlp\ xmlp_desktop.zip Page 21 .
Create a Query. Page 22 . 3. Create the Report Definition. Create the Template. Run and test the XMLP Report. 5.Steps to Create Your Own XMLP Report You can create your own XMLP report using the following steps: 1. Create the Data Source. 4. 2.
XMLP Report Developer (Creating XMLP definitions). Page 23 . the users need these roles: XMLP Power User (Running XMLP reports).XMLP Roles In order to run or develop XMLP reports.
Step 1: Creating a Query Main Menu > Reporting Tools > Query > Query Manager Page 24 .
select Add a New Value: Main Menu > Reporting Tools > XML Publisher > Data Source Page 25 .Step 2: Creating the Data Source On the “Data Source” search page.
Step 2: Creating the Data Source When the Data Source page displays. Page 26 . Save the Data Source definition. click on each of the Generate hyperlinks near the bottom of the page.
Page 27 .Step 2: Creating the Data Source Click on the hyperlink for the Sample Data File.
You will need to retrieve it in the next step. Page 28 .Step 2: Creating the Data Source Save that XML file to an appropriate directory. when you import it into your report template.
Step 3: Creating the Template Open up Microsoft Word. provides a new pull-down menu and a tool bar menu. that was installed earlier. Page 29 . The Template Builder.
5”. select “Page Setup…”. Under the “File” menu. Set the left and right margins to 0. Page 30 .Step 3: Creating the Template Start a new document in Word.
and select “Load XML Data…”: Page 31 . click on the Data menu.Step 3: Creating the Template On the Template Builder menu.
Step 3: Creating the Template Select the XML file that was created when you saved the sample data file while defining the data source. Page 32 . A message will appear indicating that the data was successfully loaded.
Step 3: Creating the Template Save the Word document as an RTF file. Page 33 .
One line below. type “Number of Rows:” Page 34 . type the following text: “Query Name:”. on the left side.Step 3: Creating the Template Put a title at the top of the document and center the text: Below the title.
Find the @queryname field in the list. select “Insert.Step 3: Creating the Template Place your cursor in your document to the right of the text “Query Name. Field…”. Apply the same technique with the @numrows field. Page 35 . Double-click on it so it appears to the right of the corresponding label you have created in your report. The Field Creator dialog will appear.” From the Template Builder menu.
Step 3: Creating the Template Page 36 .
Click on the Insert menu and select “Table/Form…”: Table Structure Window Page 37 . A table is a convenient way of displaying the results of our query because there are multiple rows of data.Step 3: Creating the Template Create a blank line or two in your document. under the fields you just added.
When the pop-up prompts you to choose from three menu items. Page 38 . select “Drop All Nodes”.Step 3: Creating the Template In the Data Source window on the left. click on the word “Row” (which appears bold) and drag it into Table Structure window in the middle.
Page 39 .Step 3: Creating the Template You have defined the structure of the row for the table.
Page 40 . Save the document again.Step 3: Creating the Template Click the “OK” button to insert the table into your document.
Step 3: Creating the Template Click Preview on the Template Builder menu and select PDF. and RTF. Excel. The preview does not use real data. Page 41 . HTML. Notice that four different types of output are available for preview: PDF.
Step 3: Creating the Template Page 42 .
Step 4: Creating the Report Definition Main Menu > Reporting Tools > XML Publisher > Report Definition Page 43 .
Step 4: Creating the Report Definition Page 44 .
Click the Upload button.Step 4: Creating the Report Definition Note: You will not be able to save a report definition unless it has at least one active template file assigned to it. Page 45 . Select the RTF template file that you have previously defined.
Step 5: Running and Testing the XMLP Report Main Menu > Reporting Tools > XML Publisher > Query Report Viewer Page 46 .
Modifying the Template After you test a report. you may decide to make changes to it to improve the layout. Each template must have at least one active template file associated with it. Each report definition can have multiple templates defined. each template file must have a unique Effective Date. Within each template. Your modified template will not be applied to the report until you re-associate it with the report definition. Page 47 . Only one template can be the default template for a report definition.
Page 48 . this will not be reflected in the report until you regenerate the sample data and schema files associated with the Data Source definition.Modifying the Query Definition Any changes you make to the criteria in the query that affects the number of rows returned will be reflected the next time the XMLP report is run. Also. you need to modify the report template to show the new field(s) and associate the new template with the report definition. There is no need to change or update any setting in the data source definition or report definition. If you add more fields to an existing query (modifying the SELECT clause).
When you are defining a table. Page 49 .Sorting Data You have the option of defining the sorting rules in the query definition. But you can also specify sorting preferences in the template of the report. you have the option of sorting the rows by any column in that row. You can dictate the sorting rules while defining a table or you can do it in a more manual way by inserting the code into the template directly.
Sorting Data When you click on the word “Row” in the middle of the Insert Table/Form dialog box. Page 50 . the “Sort by” field appears along with several other options on the right.
place your cursor in that position.Adding Images to Your Reports You can insert a . not the “Insert” menu item in the Template Builder menu. Page 51 .jpg.gif. click Insert > Picture > From File… Use the “Insert” menu that is part of the regular Word menu. or . After you decide where you would like an image to appear in your report. . In MS Word.png file into a template.
XML Publisher supports the use of “if” statements. The following syntax is placed at the beginning of the conditional area: <?if:condition?>.Conditional Formatting You can choose to change the formatting of your report output based on whether or not a certain condition is met. The following syntax is placed at the end of the conditional area: <?end if?>. Page 52 .
” If you choose to hide the syntax in a form field. you can insert the appropriate syntax directly into the template or place the syntax in a “Text Form Field.Conditional Formatting To insert an “if” statement in your MS Word template.” Make sure the “Forms” toolbar is visible in Word. you have to define a “Text Form Field. Page 53 .
USM Regional Conference Wrap Up and Additional Questions Page 54 .
This action might not be possible to undo. Are you sure you want to continue?
We've moved you to where you read on your other device.
Get the full title to continue listening from where you left off, or restart the preview.