From the left navigation bar in PeopleSoft Applications, select XML Publisher> Setup > Design Helper to download

the Template Builder

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

After the download is complete, install XML Publisher Desktop. Open File Explorer and navigate to the download directory (for example, c:\temp). The following example shows the expanded files under c:\temp\xmlp_desktop. Double-click setup.exe to start the installation process. A set of installation wizard pages guide you through the installation process.

Select English, and then click Next.

Ensure that no previous version of XML Publisher Desktop is installed. Click Next.

The XML Publisher Desktop requires the installation of Java Runtime Environment (JRE) version 1.4 (or later versions). Enter the location for Java Runtime Environment and click Next.

Deselect Open the Word Template Builder Tutorial file and click Next. Enter the name of the folder where you will install XML Publisher Desktop and click Next

Click Install for the installation to start.

When the installation is complete, click Finish

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

Modify an Existing Query

Initially you modify an existing query, PERSONAL_DATA_PAY, and apply criteria on department id to reduce the volume of data. To modify the query, perform the following steps: Log in to your PeopleSoft Application. Then, from the left menu, select Reporting Tools > Query > Query Manager. EnterPERSONAL_DATA_PAY in the begins with field. The query PERSONAL_DATA_PAY will return.

To modify the query, click the Edit link under the Edit column. All the fields in the query are displayed.

Because the filter will be on DeptID, click the filter icon on DeptID

On the Edit Criteria Properties page, select in list from the Condition Type drop-down list.

Click the search icon for List Members in the Edit List box.

Enter ADMIN and click Add Value.

Similarly, add the departments ADMISSION and ALL DEPTS. When all the departments are entered for the criteria, click OK.

On the Edit Criteria Properties page, click OK.

Click the Run tab and run the report. Make sure only three departments (ADMIN, ADMISSION, and ALL DEPTS) are returned. The query should return only 30 rows.

Create and Register a Data Source

Before you create any report, you must create and register a data source. User queries are data sources that the application uses to retrieve data for an XML Publisher report. XML Publisher supports PS Query, rowsets, XML files, and various other types of data sources. In this tutorial, the query you just modified will be your data source. Log in to your PeopleSoft Application. Then, in the left navigation bar, expand Reporting Tools > XML Publisher > Data Source.

Because you will use a PS query, click Add a New Value. Select PS Query as the Data Source type and click the Look Up Query search icon for Data Source ID.

Enter P in the begins with field and click the Lookup button.

Scroll down and click PERSONAL_DATA_PAY.

Click the Add button on the Data Source page.

On the Data Source page, in the Data Source Properties section, enter the Description as Departmental Annual Salary. Click Generate under the Generate File column for Sample Data File.

After the data source is generated, an XML file for PERSONAL_DATA_PAY is created. Click the Save button.

Click the PERSONAL_DATA_PAY.XML file. The browser appears and displays the XML data in the file. Save the XML file in the C:\temp folder.

Create an RTF Template

You use a Microsoft Word plug-in to build an RTF template. You use a preexisting RTF template file named Personal_Data_Pay.rtf.

Load XML Data in a Word Template Create a Pie Chart and a Bar Chart Create a Table

Load XML Data in a Word Template

You open a base template and load the XML data. To load the XML data, perform the following steps: Open the file named Personal_Data_Pay.rtf in Microsoft Word

Click Data and select Load XML Data.

In the Please select XML data dialog box, select the PERSONAL_DATA_PAY.xml file and click Open.

When the "Data loaded successfully" message appears, click OK.

Create a Pie Chart and a Bar Chart

If you do not want to create a pie chart or a bar chart, skip this section. To create a pie chart and a bar chart, perform the following steps: From the first cell in the table, delete the text <insert a pie chart here>. From the menu, select Insert > Chart.

In the Chart window, select Row and enter the details as shown below.

Click OK. Resize the pie chart to fit within the width of the cell.

Similarly insert a bar chart. Delete the text <insert a vertical bar chart here>. Select Insert>Chart from the menu. In the Chart window, select Row and enter the details as shown.

Click OK. Resize the bar chart.

Save the template and preview in PDF format. Click Preview and select PDF from the drop-down list.

Create a Table
You create a tabular report for which you have already loaded the data. To create a table, perform the following steps: Move the cursor below the table for the charts, add some blank lines, and insert a new table. Click Insert and select Table/Form.. from the drop-down list. The Insert Table/Form window appears. Select Row from the Data Source list on the left.

The Insert Table/Form window appears. Select Row from the Data Source list on the left.

Drag Row from the left to the Template column and select Drop all Nodes.

Delete the following fields by selecting the field and clicking the delete button:

@rownumber Position Nbr Acct Cd Monthly Rt Hourly Rt

As a result, you should have four fields.

Provide grouping details. Select Row in the template column and, from the properties window, select DEPTID from the drop-down list for theGrouping property.

Click OK. You are returned to Word. Resize the table to match the image below by dragging the sizing handles for the columns.

Use Word features and select the G DEPTID field and cut and paste above the table.

Select the inner table and the control character E (as shown).

Cut and paste the selected area a few lines below the outer table.

Delete the outer table. Select the outer table and, from the menu, select Table > Delete > Table.

Enter a new row at the end of the table to display the department average annual rate. Place the cursor inside the row of the table and, from the menu, select Table > Insert > Rows Below. Enter Average Rate for the first column in the new row.

Change the column headings as shown

Add a department average rate field to the last row in the Annual Salary Rate column. Click anywhere in the empty Annual Salary Rate column of the Total row to position your cursor. Select Insert > Field.

In the Field window, select Annual Rt and average for Calculation. Select the On Grouping check box. Click Insert and then click Close.

Your table should look like the image below:

Change the format of the column data for Annual Salary Rate. Double click ANNUAL_RT. The Text Form Field Options window appears. ChangeType to Number. Select the Number format $#,##0.00 and edit it as shown. Enter $999 in the Default number field. Click OK.

Similarly change the format for average ANNUAL_RT.

Save the template and preview in PDF format. Select Preview > PDF. The preview report displays dummy data.

You can add other Word features to the template.

Define a Report
You now define a report with the RTF template that you created. To define the report, perform the following steps: Select XML Publisher > Report Definition.

On the Report Definition page, click Add a New Value. Enter the report name PERSONAL_PAY.

For Data Source ID, click the Look up Datasource icon.

Enter P in the begins with field and click the Lookup button.

From the list, select PERSONAL_DATA_PAY as the data source. Click the Add button.

On the Definition tab, enter a description for the report. Select Active as the Report Status.

Click the lookup icon for Report Category ID.

Select the ALLUSER category.

On the Template tab, upload the RTF template. Set the template Status to Active.

Click the Upload button. Browse for the Personal_Data_Pay.rtf template and click Upload.

On the Output tab, select PDF as the default output. Click Save. You can now view the report in the Report Viewer.

Run and View the XML Publisher Report

From the left navigation bar in PeopleSoft Applications, select Reporting Tools > XML Publisher > Query Report Viewer.

On the Query Report Viewer page, click the Search button.

From the list of reports, select PERSONAL_PAY and then click View Report.

While the report is being processed, the word Processing appears at the top. After processing is complete, a threepage PDF report is displayed with charts and a table.