Castaneda n Ppt

download Castaneda n Ppt

of 70

Transcript of Castaneda n Ppt

  • 8/9/2019 Castaneda n Ppt

    1/70

    Transform your Standard ReportsTransform your Standard Reports

    GO the XML Way!GO the XML Way!PresentersPresenters

    Neida E. Castaneda & Josephine L. AbelNeida E. Castaneda & Josephine L. Abel

    City of West Palm BeachCity of West Palm Beach

  • 8/9/2019 Castaneda n Ppt

    2/70

    City of West Palm BeachCity of West Palm Beach-- ProfileProfile Established in 1894, we are a local government operating under a Strong

    Mayor System

    1,700 employees serve approximately 82,000 residents along the Atlantic

    Intracoastal Waterway

    Ranks #4 by Milken Index which measures cities with thriving economy

    2005 Digital Cities Survey Winner

    The City successfully implemented/upgraded Oracle Financials/HR/Payroll

    - August 1999, 10.7 first time implementation

    - August 2002, 11.5.5 upgrade

    - October 2004, 11.5.9 upgrade

    Visit us @ www.wpb.org

  • 8/9/2019 Castaneda n Ppt

    3/70

    PresentersPresenters Neida E. Castaneda - Senior Systems Analyst, OCP

    - 8 years of Oracle experience- Lead HR/Payroll Technical and End user support

    - Oracle Apps implementation team member (10.7, 11.5.5 and 11.5.9)

    Josephine L. Abel - Database Administrator, OCP

    - 12 years of Oracle experience, 5 in Development, 7 in e-Business Suite

    - Oracle Apps implementation team member (10.7, 11.5.5 and 11.5.9)

    - Technical support for e-Business suite

  • 8/9/2019 Castaneda n Ppt

    4/70

    AgendaAgenda What is XML Publisher?

    XML Publisher Benefits

    Report Transformation - Process Overview

    XML Publisher Template Builder

    Going the XML Way!

    Tips and Tricks

    Technical Requirements & Challenges

    XML Publisher Latest Releases Resources

    Q&A

  • 8/9/2019 Castaneda n Ppt

    5/70

    What is XML Publisher?What is XML Publisher?

    It is a template-based publishing solution bundled with e-Business suite

    XML is the acronym for eXtensible Markup Language

    Designed to structure, store and send information

    The collection of data continues to be handled by e-Business Suite, but usersdesign and control report outputs using template files

  • 8/9/2019 Castaneda n Ppt

    6/70

    XML PublisherXML Publisher-- BenefitsBenefits

    Eliminate 3rd party software

    Reduce support cost

    Maximize technical resources

    Generate jazzy and feature rich reports

    Use graphs, charts, fonts, and colors

    Allow different report layouts using same data source

    Publish reports for online viewing

  • 8/9/2019 Castaneda n Ppt

    7/70

    HR & PayrollHR & Payroll

  • 8/9/2019 Castaneda n Ppt

    8/70

    Invoices & Dunning LettersInvoices & Dunning Letters

  • 8/9/2019 Castaneda n Ppt

    9/70

    Financial ReportsFinancial Reports

  • 8/9/2019 Castaneda n Ppt

    10/70

    Report TransformationReport TransformationProcess Overview

    Design

    Create layout form and markup elements

    IntegrateSetup Data Definition and Template Definition

    Runtime

    Submit report and XML Publisher concurrent request

  • 8/9/2019 Castaneda n Ppt

    11/70

    DesignDesign -- LayoutLayout Determine the report or form layout such as fonts, colors, graphs and charts

    Create layouts using Acrobat Writer for PDF templates or MS Word forRTF templates

    Graphics

    Fonts

    Form Letter

    Table

    Colors

  • 8/9/2019 Castaneda n Ppt

    12/70

    DesignDesign -- MarkupMarkupSet the concurrent program to generate XML output

    Run report

    Change output format to XML

  • 8/9/2019 Castaneda n Ppt

    13/70

    DesignDesign -- MarkupMarkupXML datasource

    Repeating Group

    Fields

  • 8/9/2019 Castaneda n Ppt

    14/70

    DesignDesign -- MarkupMarkup Define markup elements to map XML datasource to the layout

    Markup elements can be defined using Basic RTF or Form Field Method

    Group

    Placeholders

    Page Break

    End of Group

  • 8/9/2019 Castaneda n Ppt

    15/70

    IntegrateIntegrate Data DefinitionData DefinitionRegister report as a Data Definition

    Use XML Publisher Administrator responsibility

    Navigation Path: Home Data Definitions

  • 8/9/2019 Castaneda n Ppt

    16/70

    IntegrateIntegrate Data DefinitionData DefinitionData Definition Code MUST MATCH the concurrent program Short Name

    Data Definition Code = Short Name

  • 8/9/2019 Castaneda n Ppt

    17/70

    IntegrateIntegrate Template DefinitionTemplate DefinitionRegister and upload template file

    Use XML Publisher Administrator responsibility

    Navigation Path: Home Templates

  • 8/9/2019 Castaneda n Ppt

    18/70

    IntegrateIntegrate Template DefinitionTemplate DefinitionAssociate template to Data Definition

    The first template uploaded is the default template A single report can be associated to multiple templates

    Data Definition

    Upload Template File

  • 8/9/2019 Castaneda n Ppt

    19/70

    RuntimeRuntime Run the concurrent program

    Run the XML Publisher Concurrent Request

    Not required if patch 3435480 is applied

  • 8/9/2019 Castaneda n Ppt

    20/70

    Report TransformationReport Transformation -- Process OverviewProcess Overview

    Process OverviewProcess Overview

    DesignDesign

    IntegrateIntegrate

    RuntimeRuntime

    LayoutLayout

    MarkupMarkup

    Data DefinitionData Definition

    Template DefinitionTemplate Definition

    Run ReportRun Report

    Run XML PublisherRun XML Publisher

  • 8/9/2019 Castaneda n Ppt

    21/70

    XML Publisher Template BuilderXML Publisher Template BuilderWhat is Template Builder? An add-on to MS Word Simplify RTF templates development

    To install Template Builder for MS Word apply45618354561835 Oracle XML Publisher Desktop Patch 5.5.0 client patch

  • 8/9/2019 Castaneda n Ppt

    22/70

    Data Menu Load XML Data

    Allows users to select a sample XML file containing fields that can be inserted

    into the template as a data source. The data source defines the XML formatthat will be merged with the RTF template

    Insert Menu Field

    Allows users to select fields from the data source and insert them into the

    templateInsert Menu Table/Form

    Allows users to insert tables or forms into the template

    Preview Menu

    Allows users to preview the RTF template with sample XML data. The availableoutput formats are PDF, HTML, RTF and EXCEL

    Tools Menu Field Browser

    Allows multiple fields to be changed/updated efficiently

    XML Publisher Template BuilderXML Publisher Template Builder

  • 8/9/2019 Castaneda n Ppt

    23/70

    Going the XML Way!Going the XML Way!

  • 8/9/2019 Castaneda n Ppt

    24/70

    How ToHow To -- DesignDesignAbout the report

    HR Employee Details report (hreebarg.rdf) is a custom standard report, used

    by HR to generate service awards, eligibility lists and letters

    Run HR Employee Details Report

    Pre-

    XML

  • 8/9/2019 Castaneda n Ppt

    25/70

    How ToHow To -- DesignDesignLayout

    Use MS Word to design the layoutPlace logo, headers/footers, title, static text, etc

    Logo

    Header

  • 8/9/2019 Castaneda n Ppt

    26/70

    How ToHow To -- DesignDesignMarkup

    Set output format = XML

    Use System Administrator responsibilityNavigation Path: Concurrent Program Define

    Set output format to XML

  • 8/9/2019 Castaneda n Ppt

    27/70

    How ToHow To -- DesignDesignRun HR Employee Details Report to generate XML output

    Navigation Path: View Output Tools Copy File

  • 8/9/2019 Castaneda n Ppt

    28/70

    How ToHow To -- DesignDesignOutput displays in a browser

    Save XML output file as hr_emp_detail.xml

  • 8/9/2019 Castaneda n Ppt

    29/70

    How ToHow To -- DesignDesignLoad the XML output (hr_emp_detail.xml)

    Data Load XML Data

  • 8/9/2019 Castaneda n Ppt

    30/70

    How ToHow To -- DesignDesignAfter data is loaded successfully

    Use Insert Table/Form to add table and fields

  • 8/9/2019 Castaneda n Ppt

    31/70

    How ToHow To -- DesignDesignTo Preview template

    Use Preview PDF

  • 8/9/2019 Castaneda n Ppt

    32/70

    How ToHow To -- DesignDesignUse Insert Field to add more fields

  • 8/9/2019 Castaneda n Ppt

    33/70

    How ToHow To -- DesignDesignTo Preview template

    Use Preview PDF

  • 8/9/2019 Castaneda n Ppt

    34/70

    How ToHow To -- DesignDesignUse Tools Field Browser

    View/Modify XML commands in the form fields

  • 8/9/2019 Castaneda n Ppt

    35/70

    How ToHow To -- DesignDesignPre and Post XML Output

    Pre-XML

    Post-XM

    L

  • 8/9/2019 Castaneda n Ppt

    36/70

    How ToHow To -- DesignDesignAdditional Template Features

    IF-THEN-ELSE

    Display a message depending on a field value

    Conditional formatting of fields

    CHOOSE Display a graphic depending on a field value

    Group Count

    Count total number of employees

    Graphs

  • 8/9/2019 Castaneda n Ppt

    37/70

    How ToHow To -- DesignDesignDisplay a message depending on years of service

    Use IFIF--THENTHEN--ELSEELSE

  • 8/9/2019 Castaneda n Ppt

    38/70

    How ToHow To -- DesignDesign

    Yrs of Service

    Conditional Message

  • 8/9/2019 Castaneda n Ppt

    39/70

    How ToHow To -- DesignDesignChange color attribute for years of service

  • 8/9/2019 Castaneda n Ppt

    40/70

    How ToHow To -- DesignDesignDisplay when employee has 15+ years of service

    Use CHOOSECHOOSE

  • 8/9/2019 Castaneda n Ppt

    41/70

    How ToHow To -- DesignDesignDisplay the total count of employees

    Use COUNTCOUNT

  • 8/9/2019 Castaneda n Ppt

    42/70

    How ToHow To -- DesignDesignRepresent Number of Employees vs. Years of Service graphically

    Chart Type

    Group by Years of Service

    Count Number of Employees

    Use InsertInsert ChartChart

  • 8/9/2019 Castaneda n Ppt

    43/70

    How ToHow To -- DesignDesignSample Template

  • 8/9/2019 Castaneda n Ppt

    44/70

    How ToHow To -- DesignDesignThe possibilities are endless

  • 8/9/2019 Castaneda n Ppt

    45/70

    How ToHow To -- IntegrateIntegrateNavigation Path: XML Publisher Administrator responsibility

    Home Data Definition

    NOTE:

    Data Definition Code MUST MATCHthe concurrent program Short Name

  • 8/9/2019 Castaneda n Ppt

    46/70

    HowHow ToTo -- IntegrateIntegrateNavigation Path: XML Publisher Administrator responsibility

    Home Templates

    Data Definition

    Upload RTF template

    Specify Language

    Template type = RTF

  • 8/9/2019 Castaneda n Ppt

    47/70

    How ToHow To -- IntegrateIntegrateTemplate Duplicate Functionality

    Enter Code & Name for newtemplate definition

    Query template definition

    Click on Duplicate button

  • 8/9/2019 Castaneda n Ppt

    48/70

    How ToHow To -- IntegrateIntegrateUpload the new template file

    Click on Update button

    Change template file

    Upload hr_emp_detail_graph.rtf

  • 8/9/2019 Castaneda n Ppt

    49/70

    How ToHow To -- RuntimeRuntimeRun HR Employee Details Report

  • 8/9/2019 Castaneda n Ppt

    50/70

    How ToHow To -- RuntimeRuntimeDefault template can be changed using Concurrent Program definition page

    Navigation Path: System Administration responsibility

    Concurrent Programs

  • 8/9/2019 Castaneda n Ppt

    51/70

    Transformation StepsTransformation Steps -- SummarySummary

  • 8/9/2019 Castaneda n Ppt

    52/70

    Tips & TricksTips & Tricks

  • 8/9/2019 Castaneda n Ppt

    53/70

    Tips and TricksTips and TricksThe Form Field Help Text is limited to 138 characters. To overcome limitation, use

    the Help Key tab or add more form fields to the template.

  • 8/9/2019 Castaneda n Ppt

    54/70

    Handling NULLs - Suppress or not to Suppress?

    Suppress Nulls

    No additional coding required

    E.g. Letters and Labels

    Do Not Suppress Nulls

    Insert blank space

    E.g. Preprinted forms

    Tips and TricksTips and Tricks

  • 8/9/2019 Castaneda n Ppt

    55/70

    XML output does not extract parameter names and their values.

    As a workaround, create formula columns to return parameter values.

    Formula Column (Report Builder)

    Tips and TricksTips and Tricks

  • 8/9/2019 Castaneda n Ppt

    56/70

    Tips and TricksTips and TricksHeaders and footers do not allow placeholders.

    Use BASIC RTF method to insert fields in the headers and footers

  • 8/9/2019 Castaneda n Ppt

    57/70

    Tips and TricksTips and TricksUse MS Word Table Property to repeat heading across pages

    Missing header on Page 2

  • 8/9/2019 Castaneda n Ppt

    58/70

    Tips and TricksTips and TricksUse MS Word Table Property to prevent rows from breaking across pages

    Row breaking across pages

  • 8/9/2019 Castaneda n Ppt

    59/70

    Tips and TricksTips and TricksTo utilize date format functionality, the date from the XML data source must be in

    canonical format:YYYY-MM-DDThh:mm:ss+HH:MMOptional

    dddd, MMMM dd, yyyy

  • 8/9/2019 Castaneda n Ppt

    60/70

    Tips and TricksTips and TricksUse Diagnostic button to view XML output

    Navigation Path:

    Standard Request Submission

    Diagnostics Button

    View XML

  • 8/9/2019 Castaneda n Ppt

    61/70

    Technical RequirementsTechnical Requirements

    &&ChallengesChallenges

  • 8/9/2019 Castaneda n Ppt

    62/70

    PatchesPatchesClient side patch (Platform = Microsoft Windows(32-bit) Client)

    4561835 Oracle XML Publisher Desktop Patch 5.5.0

    Server side patches (Sun SPARC 32-bit)

    3412795 XML Publisher: Patch ADSPLICE patch for XDO

    3263588 Patch 11i.XDO.H

    3822219 XDO/Oracle XML Publisher OA ROLLUP patch 5.0.0

    3435480 Publishing Concurrent Requests with XML

    3854951 FSG XML Publisher Functionality for R11i

    4073717 FND images pre-req for OA Framework 4206181 XDO/Oracle XML Publisher OA ROLLUP patch 5.5.0

    4515143 XML Publisher Users Guide Online Help Release 5.5

  • 8/9/2019 Castaneda n Ppt

    63/70

    SetupsSetups Set properties in the xdo.cfg under $JRE_TOP/lib

    The configuration file is primarily used for setting:

    Temporary directory (Highly recommended for processing large files)

    General and security properties for PDF files generated by XML Publisher

    Font locations and substitutions

    Copy the font filesFrom $FND_TOP/resource to the /lib/fonts directory (under OA_JRE_TOP &JRE_TOP)on all Web and concurrent nodes.When using MICR font, remember to copy fonts on server

    Assign the XML Publisher Administrator responsibility to users

  • 8/9/2019 Castaneda n Ppt

    64/70

    Challenges & SolutionsChallenges & Solutions JAVA lang out of memory errors

    To improve performance add the following lines to the xdo.cfg on your concurrentmanager node:

    /tmp

    true

    The directory pointed to by system-temp-dir should be large enough to hold your largest

    output files.

    Timeout Warnings

    The concurrent manager has timed out waiting for the Output Post-processor to finish thisrequest set profile Concurrent:OPP Response Timeout to allow more time to processlarge reports

    Unable to find the published output for this request

    Output Post Processor (OPP) patch has not been applied, or report is non-SRS requestrun the XML Publisher request to generate the output

  • 8/9/2019 Castaneda n Ppt

    65/70

    XML PublisherXML Publisher

    Latest ReleasesLatest Releases

  • 8/9/2019 Castaneda n Ppt

    66/70

    XML Publisher 5.6XML Publisher 5.6 Server side patches

    4561451 XDO/ORACLE XML PUBLISHER OA ROLLUP PATCH 5.6.04743521 XDO 5.6.0 ADMIN PAGE UPDATE

    4734820 ONLINE HELP PATCH FOR XML PUBLISHER RELEASE 5.6

    New Features

    Administration User Interface

    Configuration properties can be set via the Administration interface,

    previously done in the xdo.cfg file. Behavior of XML Publisher can beconfigured at the site, data definition, and template level.

  • 8/9/2019 Castaneda n Ppt

    67/70

    XML Publisher 5.6XML Publisher 5.6 Upload Font Files and Create Font Mappings

    Upload fonts through the Administration interface to make them available atruntime

    RTF Template Enhancements

    Graphics Support

    Drawing/Shape support

    Background and Watermark support

    Conditional Formatting

    Fixed-row enumeration

    Specify a fixed number of rows for a table regardless of the amount of

    data coming into the template at runtime Currency formatting

    Numeric values can now be formatted according to their associatedcurrency code

  • 8/9/2019 Castaneda n Ppt

    68/70

    XML Publisher 5.6.1XML Publisher 5.6.1Server side patches

    4905678 XDO/ORACLE XML PUBLISHER OA ROLLUP PATCH 5.6.1

    RTF Template Enhancements

    Hyperlink support for shapesUsers can click the image in the document and link to an internal or externaldestination

    Bookmark SupportGenerate the bookmark links that display in the PDF navigation pane

    Truncate Table DataAbility to truncate data in a table cell that is too big for the cell

    Odd and even header and footer supportDefine different headers and footers for odd and even pages in report output

  • 8/9/2019 Castaneda n Ppt

    69/70

    ResourcesResourcesTopic Doc#

    About Oracle XML Publisher Release 5.5 316447.1

    Using the Output Post Processor (OPP) in Oracle ApplicationsConcurrent Processing

    291792.1

    Publishing Concurrent Requests with XML Publisher 295409.1

    XML Publisher and Concurrent Manager Integration 276691.1

    Check Printing Using XML Publisher 312353.1

    Concurrent Request Fails due to Timeout of the Post ProcessingAction

    352518.1

    Unable to view output in a single request run (CONC-PP FAILED NOOPP error)

    308203.1

    Presentations, Technical Information and Demos on XML Publisherhttp://www.oracle.com/technology/products/applications/publishing/index.html

    http://www.oracle.com/technology/products/applications/publishing/index.htmlhttp://www.oracle.com/technology/products/applications/publishing/index.htmlhttp://www.oracle.com/technology/products/applications/publishing/index.html
  • 8/9/2019 Castaneda n Ppt

    70/70

    Q&AQ&A

    E-mail Addresses: [email protected]

    [email protected]