Documente Academic
Documente Profesional
Documente Cultură
This software and related documentation are provided under a license agreement containing restrictions
on use and disclosure and are protected by intellectual property laws. Except as expressly permitted in
your license agreement or allowed by law, you may not use, copy, reproduce, translate, broadcast,
modify, license, transmit, distribute, exhibit, perform, publish, or display any part, in any form, or by any
means. Reverse engineering, disassembly, or decompilation of this software, unless required by law for
interoperability, is prohibited.
The information contained herein is subject to change without notice and is not warranted to be error-
free. If you find any errors, please report them to us in writing.
If this is software or related documentation that is delivered to the U.S. Government or anyone licensing
it on behalf of the U.S. Government, the following notice is applicable:
This software or hardware is developed for general use in a variety of information management
applications. It is not developed or intended for use in any inherently dangerous applications, including
applications that may create a risk of personal injury. If you use this software or hardware in dangerous
applications, then you shall be responsible to take all appropriate fail-safe, backup, redundancy, and
other measures to ensure its safe use. Oracle Corporation and its affiliates disclaim any liability for any
damages caused by use of this software or hardware in dangerous applications.
Oracle and Java are registered trademarks of Oracle and/or its affiliates. Other names may be
trademarks of their respective owners.
Intel and Intel Xeon are trademarks or registered trademarks of Intel Corporation. All SPARC trademarks
are used under license and are trademarks or registered trademarks of SPARC International, Inc. AMD,
Opteron, the AMD logo, and the AMD Opteron logo are trademarks or registered trademarks of Advanced
Micro Devices. UNIX is a registered trademark of The Open Group.
This software or hardware and documentation may provide access to or information on content,
products, and services from third parties. Oracle Corporation and its affiliates are not responsible for and
expressly disclaim all warranties of any kind with respect to third-party content, products, and services.
Oracle Corporation and its affiliates will not be responsible for any loss, costs, or damages incurred due
to your access to or use of third-party content, products, or services.
Contents
Index
Topic Description
“About Associating Siebel Reports Views with New topic. It provides a recommended association of
Siebel Responsibilities” on page 48 Siebel Reports views with Siebel Reports
responsibilities.
“About Oracle Business Intelligence Modified topic. It describes how Oracle Business
Enterprise Edition Coexistence with Siebel Intelligence Enterprise Edition (OBIEE) coexists with
Reports” on page 49 Siebel Business Applications for use with Siebel
Reports.
“Configuring Security and Authentication for New topic. It describes how to configure security and
Siebel Reports Using Oracle BI Publisher authentication for Siebel Reports using Oracle BI
Security” on page 56 Publisher.
“Configuring the Reports Icon” on page 69 New topic. It describes how to enable and disable
Siebel Reports in Siebel Business Applications and
how to customize the Reports menu.
“About Working with Multilingual Reports” on Modified topics. For Siebel Reports, locale is the
page 76 language and locale combination based on the locale
configuration. In prior releases, language and locale
“Designing Multilingual Reports” on page 77
were two separate entities.
“Adding and Deleting Locales from Report
Templates” on page 80
“About Report Translation” on page 81 Modified topic. Added information about what occurs
when multilingual reports are generated for a specific
report locale.
“Setting the Report Execution Waiting Period Modified topic. It is recommended that you limit the
for Reports” on page 82 wait time for report execution so that report
generation runs in the background.
“Increasing EAI HTTP Transport Sleep Time Modified topic. You can increase the default sleep
for Siebel Reports” on page 88 time for the EAI HTTP Transport business service to
optimize generation of complex reports.
Topic Description
“About Increasing the Java Heap Size on New topic. It describes how to increase the JVM
Oracle BI Publisher Server” on page 89 allocation for the OC4J process for running large
reports.
“About Reducing the Size of an Integration New topic. For performance purposes, it is
Object” on page 89 recommended that you limit the fields in integration
objects to only those absolutely necessary for report
generation.
“About Generating Reports for Selected New topic. It describes how report generation is
Records” on page 93 executed when you select a specific record or
multiple records.
“Viewing Details for Generated Reports” on Modified topic. It describes the new report parameter
page 99 settings and their values.
“Registering Report Layout Templates” on Modified topic. It describes how you can override
page 120 queries in the user interface by specifying a search
specification on the primary integration object.
“About Parameterized Reports” on page 153 Modified topic. If a report template accepts run-time
parameters, a Parameters option appears in the
Schedule a Report dialog box when scheduling a
report.
“Adding Scrollbars to the Parameters Dialog New topic. It describes how to use threshold to make
Box” on page 160 scrollbars appear in the Parameters dialog box.
“Enabling Debugging on Oracle BI Publisher New topic. It describes how to configure Oracle BI
Server for Siebel Reports” on page 167 Publisher Server to capture detailed information
about errors that occur while working with Siebel
Reports in the Siebel Web Client.
Additional Changes
This book contains the following general changes:
■ Much of the content in this guide was rewritten to reflect the updated user interface.
Table 2. New Product Features in Siebel Reports Guide, Version 8.1, Rev. E
Topic Description
“Configuring an Outbound Web Service Modified topic. Added steps for defining a WSDL for the
for the Siebel Application” on page 45 outbound Web service.
Table 3. New Product Features in Siebel Reports Guide, Version 8.1, Rev. D
Topic Description
Chapter 4, “Integrating Oracle BI New chapter. It provides updated content and reorganized
Publisher with Siebel Business topics to reflect the latest integration and configuration
Applications” tasks.
Chapter 8, “Scheduling Reports” Modified chapters. They reflect the latest report features
and topics have been reorganized accordingly.
Chapter 11, “Parameterized Reports”
“About Controlling Access to New topic. Reports access is based on standard Siebel
Reports” on page 23 responsibility-based visibility as well as access granted by
others.
“About Oracle BI Publisher” on New topic. It describes the Oracle BI Publisher, OC4J (Oracle
page 20 Application Server Containers for Java Platform, Enterprise
Edition), and Oracle BI Publisher Add-in for Microsoft Word
(also known as Oracle BI Publisher Desktop).
“Siebel Reports Directory Structure” Modified topic. The naming convention for XLIFF files
on page 27 requires that all languages have the same file name as the
report layout template, only the extension differs.
“About Upgrading Siebel Reports” on New topic. Provides an overview of Siebel Reports upgrades.
page 34
“Roadmap for Integrating Oracle BI New topic. It provides a high-level roadmap for integrating
Publisher with Siebel Business Oracle BI Publisher with Siebel Business Applications.
Applications” on page 35
“Setting Up and Enabling the Siebel Modified topic. You replace the existing address of the
Security Model for Siebel Reports” on Service Ports subview with the URL used to access the EAI
page 51 Object Manager.
Table 3. New Product Features in Siebel Reports Guide, Version 8.1, Rev. D
Topic Description
“About Security and Authentication New topic. Describes the various security models available
for Siebel Reports” on page 48 for Siebel Reports.
“Roadmap for Upgrading Siebel New topic. It provides instructions for upgrading to the
Reports” on page 64 latest Siebel Reports features.
“Roadmap for Uploading Multilingual New topic. It describes how to upload multilingual reports to
Reports to the Siebel Application” on a Siebel application.
page 79
“About Report Translation” on Modified topic. Added a caution that each translated report
page 81 must have a unique name, otherwise errors can occur.
“Setting Locale User Preferences for New topic. It describes how to set the default report
Reports” on page 101 language and locale by setting user preferences.
“About Multiorganizational Report New topic. It describes the logic for how an organization-
Templates” on page 109 specific report template appears in the Reports menu.
“Scenario for Report Template New topic. It provides an example of how you might use
Visibility Across Organizations” on report template visibility across organizations.
page 110
“Suspending and Resuming New topic. It describes how to suspend and resume
Scheduled Reports” on page 134 scheduled reports.
“Example of Comparing the Service New topic. It provides an example of using a master-detail
Request Activity (All) Report with its report.
Corresponding Layout Template” on
page 138
“Syntax and Description of the Fields New topic. It provides additional information for the
for an Example Template” on example of using a master-detail report.
page 140
“About Parameterized Reports” on Modified topic. It describes how parameterized reports are
page 153 generated.
“About Report Parameter Types and New topic. It provides a description of the report parameter
Attributes” on page 154 types and attributes.
“About Defining Report Parameters in New topic. It provides information about parameter
the Siebel Application” on page 157 definitions and how to use them.
“About Report Parameter Validation” New topic. It provides an overview for checking for report
on page 158 parameter inconsistencies between the report layout
template and definitions for the template in the Siebel
application.
Table 3. New Product Features in Siebel Reports Guide, Version 8.1, Rev. D
Topic Description
“Process of Creating Parameterized New topic. It provides instructions for defining report
Reports” on page 159 parameters.
“Defining Report Parameters in the New topic. It describes how to define report parameters in
Siebel Application” on page 160 the Siebel application. The parameters govern how the
reports appear so that users have options when generating
reports.
Additional Changes
This version of Siebel Reports Guide includes:
■ The following screen names and other user interface (UI) elements have changed:
■ The Administration - BIP Reports screen is now the Administration - BI Publisher Reports
screen.
■ The Report Template Registration view is replaced with two new template views:
■ The Generate Sample Data File button in the Integration Objects list of the template views
is now Generate Sample XML.
■ Start Date and End Date replace Active Start Date and End Date, respectively.
■ Several topics in Chapter 4, “Integrating Oracle BI Publisher with Siebel Business Applications” were
relocated to either other chapters or 880452.1 (Article ID), Siebel Maintenance Release Guide
on My Oracle Support.
■ The procedures in Chapter 4, “Integrating Oracle BI Publisher with Siebel Business Applications”
now indicate which steps are applicable to a first-time installation or upgrades (or both).
■ “Uploading New or Modified Report Layout Templates for Multiple Siebel Server Environments”
on page 69
■ “Changing the Location of the Oracle BI Publisher Repository for Siebel Reports” on page 73
■ You can generate reports in MHTML (MIME HTML) format in connected mode only.
■ Mentions of upgrading to Siebel CRM version 8.1.1.1 from Siebel CRM version 8.1.1 were
removed because they are no longer applicable.
■ The following screen names and other user interface (UI) elements have changed:
■ The Administration - BIP Reports screen is now the Administration - BI Publisher Reports
screen.
■ The Report Template Registration view is replaced with two new template views:
■ The Generate Sample Data File button in the Integration Objects list of the template views
is now Generate Sample XML.
■ Retitled Chapter 4, “Integrating Oracle BI Publisher with Siebel Business Applications” to clarify
that tasks are integration tasks rather than installation and configuration tasks. Also made
structural changes to the content, including:
■ Revisions to procedures
■ New and revised index entries
■ Modified steps in roadmap for integrating Oracle BI Publisher with Siebel Business Applications.
■ Provided a better example for the “Configuring the Outbound Web Service for the Oracle BI
Publisher Server” topic.
■ Several new preconfigured reports are available in this release. For a comprehensive list of the
preconfigured reports that ship with Siebel Business Applications, see 876284.1 (Article ID) on
My Oracle Support.
■ Changes made throughout the guide to reflect the new features and functionality for the current
release of Siebel Reports.
■ Structural changes to the content, such as topic organization and heading arrangement,
revisions to procedures, and an expanded index.
For information about integrating Siebel reports with Actuate, see Siebel Reports Administration
Guide version 8.0 on the Siebel Bookshelf.
■ Reports and the Reports menu are no longer available in Siebel Tools. Siebel Reports are now
accessed using the application views in the Siebel clients.
■ Several reports are no longer available. Of particular note, the following reports are no longer
available:
■ Application Upgrade Object List. Provided object differences between repository versions.
NOTE: The data provided in these reports is still accessible using the Screens menu. For more
information about using the Screens menu, see Using Siebel Tools.
■ The following reports have been relocated to the application administration views in the Siebel
clients instead of Siebel Tools:
■ Tables. Provides selected properties and lists the columns for each table.
For more information about the Tables report, see Siebel Data Model Reference.
■ EIM Interface Tables. Provides various properties for each EIM interface table.
For more information about the EIM Interface Tables report, see Siebel Enterprise Integration
Manager Administration Guide.
■ Other Siebel CRM documentation (Release Notes, Maintenance Release Guides, Alerts,
Technical Notes, Troubleshooting Steps, FAQs, Error Messages) is located on My Oracle
Support.
The reporting module for Siebel Business Applications is Oracle® Business Intelligence Publisher
(Oracle BI Publisher). This chapter provides a brief introduction to Siebel Reports and the reporting
tools used to create reports. It includes the following topics:
■ About Using Oracle Business Intelligence Publisher Add-in for Microsoft Word with Siebel Reports on
page 20
■ In the Siebel application to generate, schedule, and view reports. The views are also used for
Siebel application administrative tasks.
For more information about generating reports, see Chapter 6, “Generating Reports.” For
information about scheduling reports, see Chapter 8, “Scheduling Reports.”
■ In Microsoft Word by using Oracle Business Intelligence Publisher Add-in for Microsoft Word to
create and customize layout templates.
For more information about using Oracle Business Intelligence Publisher Add-in for Microsoft
Word, see “About Using Oracle Business Intelligence Publisher Add-in for Microsoft Word with Siebel
Reports” on page 20.
■ In Oracle BI Publisher to manage report scheduling, report users, and other Oracle BI Publisher
administration tasks.
NOTE: The reports that are available to you while in a Siebel view are based on either a view-report
relationship for standard templates, or position-based and multiorganizational visibility for custom
templates. Others can also grant you access to their reports.
For more information about using Siebel reports from a user perspective, see Chapter 6, “Generating
Reports.” For more information scheduling reports from a user perspective, see Chapter 8,
“Scheduling Reports.” For information about positions and visibility, see Siebel Security Guide.
Related Topic
“Who Can Use Siebel Reports?” on page 18
■ Report user. Users can generate, view, monitor, and schedule reports that they are granted
access to in a Siebel application. Users can also delete reports that they have personally
generated. Additionally, users who have Microsoft Word and Oracle Business Intelligence
Publisher Add-in for Microsoft Word installed on their computers can also modify existing
templates or create custom layout templates. For more information about Oracle Business
Intelligence Publisher Add-in for Microsoft Word, see “About Using Oracle Business Intelligence
Publisher Add-in for Microsoft Word with Siebel Reports” on page 20. In a sales organization, typical
report users might be sales representatives, sales managers, and sales executives.
NOTE: Report scheduling is available only in connected mode. For more information about the
connection modes in relation to Siebel Reports, see “About the Siebel Reports Architecture” on
page 23.
■ Report developer (or business user). Developers are responsible for determining how best
to extract data from various sources and are granted permission to perform administrative tasks.
These administrative tasks include generating translatable XLIFF (XML Localization Interchange
File Format) files, uploading and registering templates in the Siebel clients, associating reports
with Siebel application views, and so on. In a sales organization, report developers might be
sales managers, business analysts, and so on.
NOTE: A sales manager might be a report user or a report developer depending on the
responsibility assigned. Your business requirements determine which views are made available
to certain users for reports development and administration. Restrictions are implemented using
the standard Siebel access controls. For more information about access control in general, see
Siebel Security Guide.
■ Report administrator. The report administrator might perform tasks typically performed by
report developers, but the administrator is also responsible for installation and configuration
tasks, purging reports, and managing the translation of reports from one language to another.
Related Topic
“About Using Siebel Reports” on page 18
NOTE: The PPT and MHTML report output file types are available only in connected mode. For more
information about the connection modes in relation to Siebel Reports, see “About the Siebel Reports
Architecture” on page 23.
The report output file types that are available to you for a specific report are determined by the
report developer when registering a report in the Siebel application. For more information about
registering reports, see “Registering Report Layout Templates” on page 120.
NOTE: Siebel Reports allows you to use a subset of the functionality and features the Oracle BI
Publisher Desktop provides. Only the features documented in this guide are supported.
Oracle Business Intelligence Publisher Add-in for Microsoft Word provides separate layout, query, and
language capability in one interface. Because data logic is separate from the layout, and the layout
is not dependent on the needs of a particular language, this feature allows for flexibility in
deployment and reduced maintenance costs.
When you open Microsoft Word after installing Oracle Business Intelligence Publisher Add-in for
Microsoft Word, the Oracle BI Publisher toolbar appears, as shown in Figure 1.
Oracle BI Oracle BI
Publisher Toolbar Publisher Menu
■ Data
■ Insert
■ Preview
■ Tools
■ Help
For information about installing Oracle Business Intelligence Publisher Add-in for Microsoft Word, see
“Installing Oracle Business Intelligence Publisher Enterprise for Integration with Siebel Business
Applications” on page 39.
NOTE: It is recommended that you use the same versions of Oracle BI Publisher Server and Oracle
BI Publisher Desktop in your deployment.
■ Users can build the layout and rules for reports themselves or reuse their existing company
documents. Even if your users do not have the skills to create their own layout templates, they
can begin creating the template in Microsoft Word. Then the report developer can use that same
document to finalize the template and report.
■ Deployment is more efficient, because users can build the report that they want without having
to depend on an engineer to interpret their requirements.
■ Testing cycles are reduced because users can implement changes to the report rather than tying
up valuable development resources.
■ Both report developers and report administrators can build and maintain reports.
■ Template Builder. Facilitates the development of RTF (Rich Text Format) layout templates for
reports.
Using Template Builder, users create how they want their report to look, and then a report
developer can use this same document to determine how to extract data from the database in
the most efficient manner. Because both report users and report developers use the same report
authoring tool, there is much less chance for misinterpretation of the requirements.
■ Template Viewer. Allows you to preview report layouts with sample data in multiple output
formats at any stage of development. Template Viewer is a feature of Template Builder.
■ Excel Analyzer. Oracle BI Publisher Analyzer for Excel facilitates the development of Excel
templates that export data to an Excel spreadsheet. It allows you to:
■ Log in to Oracle Business Intelligence Publisher Add-in for Microsoft Word from Excel to
refresh your data, apply new parameters, and apply a template to the report data
■ Create templates in Excel, upload them to the Oracle BI Publisher repository, and then access
and generate reports from an Excel session
NOTE: The Analyzer for Excel feature is available only in connected mode. For more information
about the connection modes in relation to Siebel Reports, see “About the Siebel Reports
Architecture” on page 23.
For more information about using Oracle Business Intelligence Publisher Add-in for Microsoft Word,
see Oracle Business Intelligence Publisher Report Designer's Guide available on Oracle Technology
Network (http://www.oracle.com/technetwork/indexes/documentation/index.html).
NOTE: Not all features mentioned in the Oracle Business Intelligence Publisher documentation are
currently integrated in the Siebel Reports solution; only the features documented in this guide.
This chapter describes the Siebel Reports development environment and how Siebel Reports
interacts with Oracle Business Intelligence Publisher (Oracle BI Publisher) to generate reports in
Siebel Business Applications. It includes the following topics:
■ Connected mode. Requesting reports in connected mode to a server or through the Siebel Web
Client integrates directly with the Siebel XMLP Report Server component and the Oracle BI
Publisher Server. For more information about the architecture for connected mode, the XMLP
Report Server component, and the Oracle BI Publisher Server, see “Workflow for Generating
Reports in Connected Mode” on page 24.
TIP: For some Siebel Business Applications, the Siebel Web Client is not required. It is possible
to generate Oracle BI Publisher reports with the embedded Oracle BI Publisher libraries, such as
is the case with Siebel Loyalty. Another instance of when a Siebel Web Client is not required is
when report generation is requested using a workflow by way of the business services in the
XMLP Report Server Component. These two instances, however, are not documented in this
guide. The instances are mentioned so that you know there are other reporting capabilities
available for Siebel Reports.
Figure 2 illustrates both the architecture and workflow for generating reports in connected mode.
NOTE: Oracle BI Publisher was recently renamed; previously Oracle BI Publisher was called XML
Publisher or XMLP. For this reason, some software elements retain the XMLP naming convention.
Figure 2. Siebel Reports Architecture and Workflow for Generating Reports in Connected Mode
2 The Siebel Application Object Manager (AOM) routes the event to the Siebel Database.
3 The Server Request Broker (SRBroker) and the Server Request Processor (SRProc) monitor the
request and pass it to the XMLP Report Server component through the XMLP Driver Service.
4 The XMLP Driver Service makes a call to the XMLP Data Service.
5 The XMLP Data Service fetches data from the Siebel Database through the EAI Siebel Adapter,
and then returns the control back to the XMLP Data Service.
6 The XMLP Data Service passes control back to the XMLP Driver Service.
7 The XMLP Driver Service makes a call to the XMLP Adapter Service.
8 The XMLP Adapter Service makes a call to the proxy PublicReportServiceService business service.
9 The proxy PublicReportService business service makes a Web service call to the Oracle BI
Publisher Server.
10 The Oracle BI Publisher Server executes report generation and returns the generated report
binary data by way of a Web service call back to the proxy PublicReportServiceService business
service.
11 The proxy PublicReportServiceService business service returns control to the XMLP Adapter
Service.
12 The XMLP Adapter Service then downloads the report, and creates the file in the Siebel File
System, which is displayed in the Siebel application.
In disconnected mode, the Oracle BI Publisher Server is a logical component that uses the Oracle BI
Publisher XDO Engine to manage generating reports. The XMLP Report Business Service is the
interface to this logical component that instantiates the EAI Java Business Service to load the JAR
files to the JVM (Java Virtual Machine). The Oracle BI Publisher XDO Engine then processes the XML
data, XSL template, and XLIFF files to generate the report. For more information about the EAI Java
Business Service and JVM, see Transports and Interfaces: Siebel Enterprise Application Integration.
The XMLP Report Business Service and the Oracle BI Publisher core libraries (XDO JAR files) are
available as part of a Siebel mobile client installation. These core libraries are located in the
SIEBEL_CLIENT_ROOT\CLASSES directory. For information about client installation, see Siebel
Installation Guide for the operating system you are using.
Figure 3 illustrates both the architecture and workflow for generating reports in disconnected mode.
NOTE: Oracle BI Publisher was previously known as XML Publisher or XMLP. For this reason, some
software elements retain the XMLP naming convention.
Figure 3. Siebel Reports Architecture and Workflow for Generating Reports in Disconnected Mode
2 Data is retrieved from the Siebel Database using the EAI Siebel Adapter and stored as XML in
the XMLP\DATA folder in the Siebel client installation (SIEBEL_CLIENT_ROOT\CLASSES) directory.
4 The XMLP Report Business Service instantiates the EAI Java Business Service, and loads the JAR
files to the JVM (Java Virtual Machine).
5 The Oracle BI Publisher XDO Engine loads the XDO classes from the JAR files, and then the XML,
XLIFF, and XSL template are given as input to the XDO classes for generating the report. The
report is temporarily stored in XMLP\REPORTS, and then sent to the Siebel File System.
6 The control then goes back to the Siebel user interface where the generated report appears.
\DATA Contains the generated XML files from the integration object definition.
NOTE: The administrator must copy the font files from the C:\WINDOWS\Fonts
directory to the $JRE_HOME\fonts directory to make sure that reports are
displayed and print properly. For more information about copying font files, see
“Copying Fonts for Report Generation” on page 75.
\TEMPLATES Contains the RTF (Rich Text Format) layout templates. Users can download these
report files to a local drive.
This directory also contains the XSL files necessary for disconnected mode. For
information about how these files are used for generating reports, see “How
Siebel Business Applications and Oracle BI Publisher Interact” on page 29.
\xliff\lang Contains the XLIFF files for localization. XLIFF is the XML format for exchanging
localization data. If multiple languages are supported, a separate xliff
subdirectory is provided for each language and is identified by its language code.
For example, XLIFF files for German reside in xliff\deu and XLIFF files for
French reside in xliff\fra.
NOTE: After a report template is registered, the XLIFF file (or files) is stored in
the relevant xliff\lang directory (or directories) on the Siebel Server. When you
upload the report template, all the XLIFF files from each language folder and the
RTF file are placed on the Oracle BI Publisher Server in their appropriate
locations. For more information, see “About the Oracle BI Publisher Server in Siebel
Business Applications” on page 28.
TIP: Siebel Language Packs are installed as part of the Siebel installation
process. For more information about installing languages, see Siebel Installation
Guide for the operating system you are using.
■ XSL (Extensible Stylesheet Language). A language for expressing style sheets. An XSL style
sheet is a file that describes how to display an XML document of a given type. Used in
disconnected mode only. For more information about the connection modes for Siebel Reports,
see “About the Siebel Reports Architecture” on page 23.
■ XLIFF (XML Localization Interchange File Format). A format to store extracted text and
carry the data from one step to another in the localization process.
■ XPath (XML Path Language). An expression language used by XSLT to access or refer to parts
of an XML document.
Siebel Reports also supports various report output file types. For more information about these
report output types, see “Who Can Use Siebel Reports?” on page 18.
The Oracle BI Publisher Server uses a push-pull mechanism to transfer XML data between the Siebel
application and the Oracle BI Publisher Server. During report generation, which is triggered from the
Siebel application, data is pushed from the Siebel Database to the Oracle BI Publisher Server to
generate reports. When handling a report request, the Oracle BI Publisher Server merges the data
with the report layout template from the Oracle BI Publisher repository, and then sends the report
to the Siebel application.
The following subtopics describe the Oracle BI Publisher Server functionality in relation to Siebel
Reports in greater detail.
■ Validates privileges
■ Generates reports
In the SharedFolder directory in the Oracle BI Publisher repository, the SIEBELCRMREPORTS directory
stores all reports. Each report stored in the SIEBELCRMREPORTS directory has its own folder. The
layout template (RTF) and XLIFF files necessary for generating that report are in that folder.
You upload the layout template files (RTF and XLIFF) to the Oracle BI Publisher Server by registering
the template in the Siebel application. The Oracle BI Publisher Server then requests report
generation using a Web service to generate the report. For more information about uploading layout
templates to the Oracle BI Publisher repository and registering layout templates, see “Workflow for
Uploading Report Layout Templates to a Siebel Application” on page 107.
1 A report generation request is initiated from a Siebel application view, and then routed to one of
the following to generate the report:
2 The RTF Processor converts the RTF layout templates to XSL for input to the BI Publisher-FO
Processor.
3 The BI Publisher-FO Processor merges the XSL and the XML data files to produce the following
output formats:
■ XML, XSL-FO, are XLIFF formats are converted to: PDF, HTML, RTF, EXCEL, PPT, and MHTML.
NOTE: The PPT and MHTML output file types are available only in connected mode.
Template Builder, a feature of Oracle Business Intelligence Publisher Add-in for Microsoft Word, is
used to modify and customize layout templates. Template Builder uses form fields to encapsulate
XSL instructions for parsing XML data. Form fields are a feature of Microsoft Word and are the
building blocks for layout templates in Oracle Business Intelligence Publisher Add-in for Microsoft
Word. You use form fields in template design wherever data is required. Template Builder generates
these form fields using the Siebel application and the information specified in the layout template.
Oracle BI Publisher provides the XML file to the engine using the EAI Java Business Service. The XML
contains the data that populates the resulting document. The data comes from the results of the
internal queries run against various data sources.
Oracle BI Publisher uses XSLT and XPath to extract data from the XML data and incorporates that
data into an RTF-formatted layout template during run time. XSL comprises three standards (XSLT,
XPath, and XSL- FO) for manipulating XML data. The XMLP Report Server component uses the XDO
Engine to convert the RTF templates into XSL format, and then using the BI Publisher-FO Processor,
converts the files to the published report formats.
This chapter provides instructions for administrators on how to integrate Oracle Business Intelligence
Publisher (Oracle BI Publisher) with Siebel Business Applications for report generation. It includes
the following topics:
■ Roadmap for Integrating Oracle BI Publisher with Siebel Business Applications on page 35
■ Preparing for Integration of Oracle BI Publisher with Siebel Business Applications on page 38
■ Process of Installing Oracle BI Publisher for Integration with Siebel Business Applications on page 39
■ About Oracle Business Intelligence Enterprise Edition Coexistence with Siebel Reports on page 49
■ Adding an Explicit Reference to JAR Files for the Oracle BI Publisher Server on page 57
■ Uploading Preconfigured Report Layout Templates to the Oracle BI Publisher Server on page 59
■ The latest Siebel CRM version. If not, follow the guidelines provided in “About Integrating Oracle
BI Publisher with Siebel Business Applications” on page 34.
For information about supported Siebel CRM versions, see Siebel System Requirements and
Supported Platforms on Oracle Technology Network.
■ Siebel Tools
■ (Optional) ADM
You might want to use ADM to migrate reports from one Siebel environment to another (for
example, migrating reports from the development to the production environment). For more
information about ADM, see Siebel Application Deployment Manager Guide.
■ Java Development Kit (JDK) version 1.6 or later and JAVA_HOME system environment variable
points to JDK
■ Siebel Application Object Manager (AOM), for example, SCCObjMgr_enu for Siebel Call
Center
■ (Optional) Workflow
NOTE: Enable this component if you plan to use workflow, the Reports Business Service, or
the XMLP Purge Records workflow.
■ Oracle BI Publisher Add-In for Microsoft Word (also known as Oracle BI Publisher Desktop)
For information about which version to use, see Siebel System Requirements and Supported
Platforms on Oracle Technology Network. For information about Oracle BI Publisher, see “About
Oracle BI Publisher” on page 20. For information about installing Oracle BI Publisher as a first-
time installation, see “Process of Installing Oracle BI Publisher for Integration with Siebel Business
Applications” on page 39. If you are upgrading Oracle BI Publisher, see “Roadmap for Upgrading
Siebel Reports” on page 64.
Explanation of Callouts
In Figure 5, the following conventions are used:
■ A box with a broken line indicates the task or subtask is only required for first-time installations
Figure 5. Roadmap for Integrating Oracle BI Publisher with Siebel Business Applications
Figure 5 illustrates the high-level tasks you perform to integrate Oracle BI Publisher with Siebel
Business Applications.
1 “Preparing for Integration of Oracle BI Publisher with Siebel Business Applications” on page 38
2 (First-time installation only) “Process of Installing Oracle BI Publisher for Integration with Siebel
Business Applications” on page 39
For instructions, see Instructions for ACR 719B in 880452.1 (Article ID), Siebel Maintenance
Release Guide on My Oracle Support.
5 (First-time installation only) “Configuring an Outbound Web Service for the Siebel Application” on
page 45
■ “Setting Up and Enabling the Siebel Security Model for Siebel Reports” on page 51
■ “Configuring Security and Authentication for Siebel Reports Using LDAP” on page 55
8 “Adding an Explicit Reference to JAR Files for the Oracle BI Publisher Server” on page 57
9 “Uploading Preconfigured Report Layout Templates to the Oracle BI Publisher Server” on page 59
c “Verifying Symbolic URL Arguments That Embed the Oracle BI Publisher Scheduling Views in the
Siebel Application” on page 62
11 “Testing Your Siebel Reports Integration Configurations” on page 63
Click the links to navigate to detailed instructions for that topic. Tasks are applicable to both Siebel
Reports first-time installations and upgrades unless otherwise indicated.
NOTE: If you are upgrading from previous versions of Siebel Reports, see the instructions in
“Roadmap for Upgrading Siebel Reports” on page 64.
NOTE: If you are upgrading from a previous Siebel Reports deployment, do not perform the steps
described in this topic. Instead, see “Roadmap for Upgrading Siebel Reports” on page 64.
This task is a step in “Roadmap for Integrating Oracle BI Publisher with Siebel Business Applications”
on page 35.
For the requirements, see “Requirements for Using Siebel Reports” on page 34.
2 Review Siebel System Requirements and Supported Platforms on Oracle Technology Network
(http://www.oracle.com/technetwork/indexes/documentation/index.html). Also check for
applicable alerts, bulletins, or other documents on My Oracle Support.
3 Install the appropriate Java Development Kit (JDK) version and point the JAVA_HOME system
environment variable to the JDK, if you have not already done so.
To find the JDK version applicable to your deployment, see Siebel System Requirements and
Supported Platforms on Oracle Technology Network.
For installation instructions, see “Installing Oracle Business Intelligence Publisher Enterprise for
Integration with Siebel Business Applications” on page 39.
■ Oracle BI Publisher Add-In for Microsoft Word (also known as Oracle BI Publisher Desktop)
For installation instructions, see “Installing Oracle Business Intelligence Publisher Add-in for
Microsoft Word” on page 41.
For the applicable version for your deployment, see Siebel System Requirements and Supported
Platforms on Oracle Technology Network. For more information about Oracle BI Publisher, see
“About Oracle BI Publisher” on page 20 and “About Using Oracle Business Intelligence Publisher Add-
in for Microsoft Word with Siebel Reports” on page 20.
5 Before using Siebel Reports, make sure that the Siebel Server is running and the Siebel clients
and Siebel Tools can connect to the server data source.
NOTE: Do not use this process if you are upgrading from a previous deployment of Siebel Reports.
Instead, follow the instructions provided in “Roadmap for Upgrading Siebel Reports” on page 64.
This process is a step in “Roadmap for Integrating Oracle BI Publisher with Siebel Business Applications”
on page 35.
To install Oracle BI Publisher for integration with Siebel Business Applications, perform the following
tasks:
1 “Installing Oracle Business Intelligence Publisher Enterprise for Integration with Siebel Business
Applications” on page 39
For information about which versions of this software to use for your specific deployment, see
Siebel System Requirements and Supported Platforms on Oracle Technology Network.
2 “Installing Oracle Business Intelligence Publisher Add-in for Microsoft Word” on page 41
For information about which versions of this software to use for your specific deployment, see
Siebel System Requirements and Supported Platforms on Oracle Technology Network.
5 (Optional) “Changing the Location of the Oracle BI Publisher Repository for Siebel Reports” on
page 73
NOTE: This task is applicable to both first-time Siebel Reports deployments as well as upgrades.
This task is a step in “Process of Installing Oracle BI Publisher for Integration with Siebel Business
Applications” on page 39.
NOTE: Perform the following procedure only if this is a first-time Siebel Reports deployment. This
task is not applicable if you are upgrading.
http://edelivery.oracle.com
2 Enter the export validation information, accept the license terms and export restrictions, and
then click Continue.
3 Select Oracle Business Intelligence as the product pack, and an operating system (for example,
Microsoft Windows [32-bit]). Then click Go.
NOTE: You must select an operating system compatible with the computer on which the Oracle
BI Publisher Server is installed. For information about which platforms are supported for Siebel
Reports, see Siebel System Requirements and Supported Platforms on Oracle Technology
Network.
4 Select the Oracle Business Intelligence 10.1.3 Media Pack, and then click Continue.
For example, you might select Oracle Business Intelligence (10.1.3) Media Pack for Microsoft
Windows (32-bit).
5 Download the appropriate Oracle BI Publisher 10.1.3.4.x installer for your deployment.
For information about which versions of this software to use for your specific deployment, see
Siebel System Requirements and Supported Platforms on Oracle Technology Network.
NOTE: Typically administrators download and install Oracle Business Intelligence Publisher
Desktop (also known as Oracle Business Intelligence Publisher Add-in for Microsoft Word) during
the Oracle BI Publisher Enterprise installation, however, you can install it any time. For
information on installing this desktop software, see “Installing Oracle Business Intelligence
Publisher Add-in for Microsoft Word” on page 41.
CAUTION: You must extract the .zip file to a directory whose name does not contain spaces.
If the directory name contains spaces, the installation fails.
b Follow the instructions about installing Oracle BI Publisher on Oracle Application Server for OC4J
10.1.3.1 in Oracle Business Intelligence Publisher Installation Guide, Release 10.1.3.x available
on Oracle Technology Network (http://www.oracle.com/technetwork/indexes/documentation/
index.html).
NOTE: OC4J is installed and the Oracle BI Publisher Server starts automatically as part of
this installation.
c Verify the installation by making sure you have an Oracle - BIPHomeX entry in the Start
Programs menu, where X is an incremental number depending on the number of Oracle
installations you have.
7 Create a local Superuser for the Oracle BI Publisher Server by doing the following:
NOTE: The URL for launching Oracle BI Publisher resides in the BI_Publisher_readme.txt file
located in the Oracle BI Publisher installation folder. Administrator credentials are case
sensitive.
b Click the Admin tab, and then select Security Configuration (in the Security Center section).
c Check the Enable Local Superuser checkbox, enter a Superuser name and password of your
choice, and then click Apply.
After creating a local superuser, administrators can log in directly to the Oracle BI Publisher
Server when the Siebel Server is not running.
This task is a step in “Process of Installing Oracle BI Publisher for Integration with Siebel Business
Applications” on page 39.
NOTE: Perform the following procedure only if this is a first-time Siebel Reports deployment. It is
not applicable if you are upgrading.
http://edelivery.oracle.com
NOTE: This software is listed on Oracle Software Delivery Cloud as Oracle Business Intelligence
Publisher Desktop.
2 Enter the export validation information, accept the license terms and export restrictions, and
then click Continue.
3 Select Oracle Business Intelligence as the product pack, and an operating system (for example,
Microsoft Windows [32-bit]). Then click Go.
NOTE: You must select an operating system compatible with the computer on which the Oracle
BI Publisher Server is installed. For information about which platforms are supported for Siebel
Reports, see Siebel System Requirements and Supported Platforms on Oracle Technology
Network.
4 Select the Oracle Business Intelligence 10.1.3 Media Pack for your operating system, and then
click Continue.
For example, you might select Oracle Business Intelligence (10.1.3) Media Pack for Microsoft
Windows (32-bit).
5 Download the appropriate Oracle BI Publisher 10.1.3.4.x installer for your deployment.
NOTE: Typically administrators download and install Oracle Business Intelligence Desktop (also
known as Oracle Business Intelligence Publisher Add-in for Microsoft Word) during the Oracle BI
Publisher Enterprise installation, however, you can install it any time.
6 Install Oracle Business Intelligence Publisher Add-in for Microsoft Word by doing the following:
a Decompress the appropriate .zip file according to the Media Pack you chose in Step 3.
CAUTION: You must extract the .zip file to a directory whose name does not contain spaces.
If the directory name contains spaces, the installation fails.
c Verify the installation by making sure you have an Oracle BI Publisher Desktop application in the
Start Programs menu.
For more information about installing this software, see the post-installation topics in Oracle BI
Publisher on Oracle Application Server for OC4J 10.1.3.1 in Oracle Business Intelligence Publisher
Installation Guide, Release 10.1.3.x available on Oracle Technology Network (http://
www.oracle.com/technetwork/indexes/documentation/index.html).
7 Make sure that applicable users install Oracle BI Publisher Desktop on a computer where
Microsoft Word for Windows is installed.
This task is a step in “Process of Installing Oracle BI Publisher for Integration with Siebel Business
Applications” on page 39.
NOTE: Perform the following procedure only if this is a first-time Siebel Reports deployment.
■ XSLFunctions.JAR
■ SiebelCustomXMLP.JAR
■ SiebelCustomXMLP_SIA.JAR
■ Siebel.JAR
■ SiebelXMLP.JAR
■ (Optional) InkToolsLib.jar
■ (Optional) iSignBmp.jar
2 If there are additional custom Java extensions, then you must copy those JAR files as well.
This task is a step in “Process of Installing Oracle BI Publisher for Integration with Siebel Business
Applications” on page 39.
NOTE: Perform the following procedure only if this is a first-time Siebel Reports deployment. It is
not applicable if you are upgrading.
For instructions, see “Starting and Stopping OC4J and Oracle BI Publisher” on page 44.
2 Log in to the Oracle BI Publisher Server with administrator privileges by doing the following:
b Enter your administrator credentials (such as Administrator for the login and Administrator for
the password).
NOTE: Administrator credentials for the Oracle BI Publisher Server are established during
installation and are case sensitive.
3 Click the Admin tab, and then select Properties under Runtime Configuration.
4 Change the default value for the Disable External Reference attribute to FALSE, and then click
Apply.
For instructions, see “Starting and Stopping OC4J and Oracle BI Publisher” on page 44.
NOTE: You must leave this command window open while the Oracle BI Publisher Server is
running.
When the server is started, a statement appears in the command window indicating the Oracle
Containers are initialized.
This task is a step in “Roadmap for Integrating Oracle BI Publisher with Siebel Business Applications”
on page 35.
NOTE: Perform the following procedure only if this is a first-time Siebel Reports deployment. It is
not applicable if you are upgrading.
http://host:port/xmlpserver/services/PublicReportService_v11?wsdl
2 Using Siebel Tools, remove the existing outbound Web service and related integration objects by
doing the following:
c In the Business Services list, query for PublicReportService, and then delete it.
e In the Integration Objects list, query for XMLP Integration project, and then select and delete all
the objects.
3 Import the WSDL you saved in Step 1 (to replace the one you just removed) by doing the
following:
a From the Tools menu, choose File, New Object, EAI, and then the Web Service icon, and click OK.
c Check the Deploy Integration Object(s) and Proxy Business Service(s) option, and then click
Finish.
❏ Name is PublicReportService
❏ siebel_port_name is PublicReportService_v11
❏ siebel_web_service_name is PublicReportServiceService
❏ siebel_web_service_namespace is http://xmlns.oracle.com/oxp/service/v11/
PublicReportService
d In the Object Explorer, select Integration Object, and query for the XMLP Integration project.
5 In the Siebel application, remove the old version of the PublicReportService outbound Web
service by doing the following:
a Navigate to the Administration - Web Service screen, then the Outbound Web Service view.
b In the name field, query for PublicReportServiceService, and then delete the service that does
not show PublicReportService_v11 as the server port name.
NOTE: Two Web services appear; make sure you delete the correct one.
6 Make sure the service port address corresponds to the Oracle BI Publisher Server by doing the
following:
a Navigate to the Administration - Web Services screen, then the Outbound Web Service view.
c Make sure that the service port address corresponds to the Oracle BI Publisher Server.
http://host.domain:port/xmlpserver/services/PublicReportServiceService
where:
http://BIPServerHostName:9704/xmlpserver/services/PublicReportServiceService
TIP: Other than in this specific procedure, there is typically no need to change this address
because it is automatically populated when you configure the business service and the Web
service in Siebel Tools using the Web service wizard.
7 Click Clear Cache to make sure that the changes are propagated to run-time memory.
This task is a step in “Roadmap for Integrating Oracle BI Publisher with Siebel Business Applications”
on page 35.
NOTE: If you are upgrading, you only need confirm these components are active. Additionally,
the XMLP Report Server component might already be enabled depending on how you configured
your original Siebel Server installation.
NOTE: Enable this component if you plan to use workflow, the Reports Business Service, or the
XMLP Purge Records workflow.
For information about enabling Siebel Server components, see Siebel System Administration Guide.
Responsibility
Related Topics
“Setting Up and Enabling the Siebel Security Model for Siebel Reports” on page 51
There are several options to choose from for configuring security and authentication for Siebel
Reports. This topic provides a high-level description of each option and provides links to the
instructions for implementing each option.
The reporting responsibilities in the Siebel application correspond to roles and permissions on the
Oracle BI Publisher Server. The names of these responsibilities must exactly match the corresponding
set of roles on the Oracle BI Publisher Server.
NOTE: It is recommended that you use this model because it was designed specifically for use with
Siebel Reports.
LDAP
In an implementation using LDAP authentication, an LDAP security adapter provided with Siebel
Business Applications authenticates users against an LDAP-compliant directory. The directory stores
information that is required to allow users to connect to the database and the Oracle BI Publisher
Server and this information is retrieved by the security adapter when users try to run a report. When
users log into a Siebel application that uses LDAP authentication, they are already authenticated for
the current session.
For LDAP security information relating to Siebel Reports, see “Configuring Security and
Authentication for Siebel Reports Using LDAP” on page 55.
For the Oracle BI Server Security model, you must define all users and those users must belong
to designated groups in OBIEE. For more information, see “Configuring Security and
Authentication for Siebel Reports Using Oracle BI Publisher Security” on page 56.
■ For Siebel Security, checks by way of the endpoint that a user exists in the Siebel application.
2 Checks that a user has certain roles depending on what action they are taking:
■ For LDAP, groups are created which relate to the Oracle BI Publisher roles. Users in the LDAP
directory have these certain groups assigned to them. Oracle BI Publisher authentication to
LDAP directory checks for a user if they have a certain group.
■ For Siebel Security, each user has certain XMLP responsibilities. Oracle BI Publisher
authentication to the Siebel application, by way of an endpoint inbound Web service call,
checks that a user has the correct responsibilities that relate to the Oracle BI Publisher roles.
3 Checks Siebel XMLP responsibilities that control the Siebel user interface for Reports menu
restrictions (for example, XMLP_SCHEDULER responsibility for the scheduling option).
NOTE: Perform the following procedure only if this is a first-time Siebel Reports deployment. It is
not applicable if you are upgrading.
■ “Setting Up and Enabling the Siebel Security Model for Siebel Reports” on page 51
■ “Configuring Security and Authentication for Siebel Reports Using LDAP” on page 55
■ “Configuring Security and Authentication for Siebel Reports Using Oracle BI Publisher Security”
on page 56
NOTE: It is recommended that you use this security model. It is designed specifically for use with
Siebel Reports.
This task is a step in “Configuring Security and Authentication for Siebel Reports” on page 50.
To set up and enable the Siebel Security Model for Siebel Reports
1 (First-time install only) Create the inbound Web service for the Siebel application by doing the
following:
a Navigate to the Administration - Web Services screen, then the Inbound Web Services view.
d Change the host and port number of the server port’s address to that of the Siebel Server.
http:/computer.domain.com/eai_enu/
start.swe?SWEExtSource=WebService&SWEExtCmd=Execute
2 (Upgrade only) Change view names in the Siebel application to reflect repository changes: For
v81F, Rupa confirmed step is necessary.
b In the View Name field, query for the following views and rename them:
c Clear the cache, log out of the Siebel application, and then log back in.
3 (First-time installation only) Create four new responsibilities and add appropriate users to each by
doing the following:
a Navigate to the Administration - Application screen, then the Responsibilities view to create the
responsibilities described in the following table.
Responsibility Description
XMLP_DEVELOPER Assign this responsibility to allow for uploading reports from the
Siebel application to the Oracle BI Publisher Server.
NOTE: The reporting responsibilities in the Siebel application correspond to roles and
permissions on the Oracle BI Publisher Server. The names of these responsibilities must
exactly match the corresponding set of roles on the Oracle BI Publisher Server.
4 (Upgrade only) Verify the following responsibilities exist and confirm each are assigned the
appropriate users:
■ XMLP_ADMIN
■ XMLP_DEVELOPER
■ XMLP_SCHEDULER
■ XMLP_SIEBEL_GUEST
6 Make sure the scheduling views are associated with the appropriate responsibilities and users by
doing the following:
a Associate the XMLP_ADMIN responsibility to all views, then assign that responsibility to just
administrators.
b Associate the XMLP_SCHEDULER responsibility to the Report Job List View, and then assign that
responsibility only to those users who run scheduled reports.
c Do not associate any views to the following responsibilities:
❏ XMLP_DEVELOPER
❏ SIEBEL_GUEST
For more information about Siebel Reports views and responsibilities, see “Configuring Security
and Authentication for Siebel Reports” on page 50.
7 If changes are necessary, clear the cache, log out of the Siebel application, and then log back in.
b Confirm a new Scheduled Reports link was added to the My BI Publisher Reports screen.
The Scheduled Reports link in the Siebel application is an embedded user interface to the
Oracle BI Publisher Server that allows users to view their scheduled reports. Before you can
use this link, you must perform further configuration to embed the Scheduled Reports view
in the Siebel application.
c Confirm the views were added to the appropriate screens as shown in the following table.
View Screen
9 (First-time installation only) Enable the Siebel Security Model by doing the following:
b Click the Admin tab, and then select Security Configuration (under Security Center).
c In the Security Model section, perform the following, and then click Apply:
NOTE: The address of the Web Service Endpoint parameter in the Oracle BI Publisher Server
is the same address as the inbound Web service used by the Siebel Server.
The following table provides sample parameter values for a Siebel Security model
configuration.
Parameter Value
Administrator password
Password
NOTE: Password is the Siebel administrator password. The
password for an account cannot be the same as the user name for
that account.
NOTE: Siebel administrator credentials are necessary for the Oracle BI Publisher application
to log into the Siebel EAI object manager. These credentials are case sensitive and must
match the Siebel database specifications.
11 (First-time installation only) Verify that the Siebel Security Model has been implemented by doing
the following:
a Start the Oracle BI Publisher Enterprise application (from the Start Menu, choose Start BI
Publisher).
b Log in to the Oracle BI Publisher Enterprise application using the Siebel administrator
credentials.
The Siebel Security Model was successfully implemented if you are able to login using the Siebel
credentials.
12 Add an explicit classpath and add a new wlfullclient.jar file to the XMLPJvmSubsys profile for the
Oracle BI Publisher Server.
For instructions, see “Adding an Explicit Reference to JAR Files for the Oracle BI Publisher Server”
on page 57.
Related Topics
“Configuring Security and Authentication for Siebel Reports” on page 50
When implementing LDAP authentication for Siebel user access to the Oracle BI Publisher Server, you
implement LDAP authentication for your Siebel application, and you must use the same LDAP
directory for the Oracle BI Publisher Server.
This task is a step in “Configuring Security and Authentication for Siebel Reports” on page 50.
For more information on implementing LDAP for Oracle BI Publisher, refer to the Oracle BI Publisher
documentation. For more information on setting up an LDAP directory, see the topic on setting up
the LDAP or ADS Directory in Siebel Security Guide.
NOTE: Make sure you have configured both the Siebel application and Oracle BI Publisher so that
both are pointing to the appropriate LDAP directory.
■ XMLP_ADMIN
■ XMLP_DEVELOPER
■ SIEBEL_DEV
■ SIEBEL_ADMIN
■ SIEBEL_SCHEDULER
■ XMLP_SCHEDULER
These tasks ensure that when Oracle BI Publisher Server authenticates with the LDAP directory, the
correct roles are used for each user and limits the reporting actions that a user can perform.
For more information, see the topic about Web single sign-on authentication in Siebel Security Guide.
This task is a step in “Configuring Security and Authentication for Siebel Reports” on page 50.
When implementing Oracle BI Publisher Security authentication for Siebel user access to Oracle BI
Publisher Server, all connections between the Siebel application and Oracle BI Publisher Server are
made using the same generic user account. This generic user account is useful for certain security
topologies where multiple applications and authentication directories are used with a single shared
Oracle BI Publisher Server instance.
NOTE: This security model does not support private scheduled reports. All scheduled reports are
public.
3 Click Admin tab, and then select Security Configuration under Security Center.
7 Enter the BI Publisher user name and password by doing the following:
a Navigate to the Administration - Server Configuration screen, Enterprises, and then the
Component Definitions view.
b In the Component field, query for XMLP*.
c Scroll down to the Component parameters subview, and then enter the appropriate values for:
The task is a step in “Roadmap for Integrating Oracle BI Publisher with Siebel Business Applications” on
page 35.
NOTE: If you are upgrading, you only need add the new wlfullclient.jar file to the explicit classpath
(see Step 3 on page 58), and then restart the Siebel Services.
To add an explicit reference to JAR files for the Oracle BI Publisher Server
1 Navigate to the Administration - Server Configuration screen, Enterprises, and then the Profile
Configuration view.
3 In the Profile Parameters subview, provide a reference to each of the JAR files in the CLASSES
directory in the Siebel application root directory and set the JVM DLL Name. Some of the values
are provided in the following table. Make sure that the paths correctly locate the required files.
Parameter Value
JVM <SIEBSRVR_ROOT>/classes/Siebel.jar;<SIEBSRVR_ROOT>/classes/
Classpath SiebelXMLP.jar;<SIEBSRVR_ROOT>/classes/wlfullclient.jar
where:
Alternatively, you can set the CLASSPATH using the Siebel Server Manager
(srvrmgr program). For information about using the srvrmgr program to set the
CLASSPATH, see “Troubleshooting the CLASSPATH Settings Using Siebel Server
Manager” on page 178.
CAUTION: An error might occur if the value of the CLASSPATH parameter is too
long (must be less than 1024 characters). To avoid this, copy the CLASSPATH
folder to the root directory, and then point CLASSPATH to this path.
For HP-UX:
<path to libjvm.sl_file>
For Windows:
<path to jvm.dll >
NOTE: For Windows, the path to the JVM DLL file is automatically read from
the Windows registry setting of the JRE installed on the Siebel Server.
For more information on setting the values of the JVM DLL Name and JVM
Options parameters, see Transports and Interfaces: Siebel Enterprise
Application Integration.
/usr/jdk1.6.0_xx/jre/bin/j9vm/libjvm.so
For example:
/usr/java
For example:
/usr/jdk1.6.0_xx/jre/bin:/usr/jdk1.6.0_xx/jre/bin/j9vm
NOTE: The instructions in this topic are not applicable for new reports you create or modify while in
disconnected mode. Such reports require deployment to the Siebel Web Client. For instructions, see
“Deploying Report Layout Templates to the Siebel Web Client from a Disconnected Client” on page 68.
Additionally, if you have a multiple Siebel Server environment, see “Uploading New or Modified Report
Layout Templates for Multiple Siebel Server Environments” on page 69.
CAUTION: If the report layout templates are not uploaded to the Oracle BI Publisher Server, when
a user attempts to run a report, an error occurs and the report fails. For more information about this
failure, see Error Message SBL-OMS-00203 in “Troubleshooting Error Messages for Siebel Reports” on
page 171.
The task is a step in “Roadmap for Integrating Oracle BI Publisher with Siebel Business Applications” on
page 35.
2 From the application-level menu, select Edit, and then Select All.
4 Set the proper access permissions to the SiebelCRMReports folder by performing the following:
b Open a new browser window and navigate to the Oracle BI Publisher Server at
http://BIPServerHostName:port/xmlpserver
c Click the Admin tab, select Roles and Permissions, and then locate the XMLP roles (XMLP_*).
TIP: These roles begin with XMLP and are listed in alphabetical order.
d For each report responsibility, click Add Folders to grant permission to the shared
SiebelCRMReports folder.
This task is a step in “Roadmap for Integrating Oracle BI Publisher with Siebel Business Applications”
on page 35.
1 (First-time installation only) “Setting Up the Database Schema for the Oracle BI Publisher Server”
on page 60
2 “Configuring the Data Service WSDL for the Oracle BI Publisher Server” on page 61
3 “Verifying Symbolic URL Arguments That Embed the Oracle BI Publisher Scheduling Views in the
Siebel Application” on page 62
c Select the database type applicable to your deployment and provide information as shown in the
following table.
Database Enter
username:username
password:password
jdbc:hyperion:db2://
BIPServerHostName:port;DatabaseName=<DATABASENAME>
username:username
password:password
2 Restart both the Oracle BI Publisher Server and the Siebel Server (or servers).
The task is a step in “Process of Enabling and Configuring Report Scheduling” on page 60.
To configure the data service WSDL for the Oracle BI Publisher Server
1 Log in to the Siebel application as a Siebel administrator.
2 Navigate to the Administration - Web Services screen, then the Inbound Web Services view.
3 Configure the address for the BIPDataService Web service with the host name and port number
of the Siebel Server and modify the credentials to correspond to the username, login, and
password used for logging in to the Siebel EAI object manager.
5 Save the WSDL as a new data service file named dataservice.wsdl in a directory in the Oracle BI
Publisher home directory (by default, this is the \OraHome_X\oc4j_bi\bin directory).
D:\OraHome_1\oc4j_bi\bin\dataservice.wsdl
The task is a step in “Process of Enabling and Configuring Report Scheduling” on page 60.
To verify symbolic URL arguments that embed the Oracle BI Publisher Scheduling
Views in the Siebel application
1 Navigate to the Administration - Integration screen, then the Host Administration view.
■ Name is host:port
where host:port is the Oracle BI Publisher host address you choose from a picklist.
3 Navigate to the Administration - Integration screen, then the Symbolic URL Administration view.
■ Name is BIPReportJobListPage
■ URL is http://biphost/xmlpserver/servlet/myhistory
Required Argument
Argument Name Argument Type Argument Value
7 (Upgrade only) Confirm the new monthly scheduling List of Value (LOV) is available by doing the
following:
c In the List of Values view, make sure there is Monthly value for the XMLP_RPT_SCHEDULE_MODE
type.
The task is a step in “Roadmap for Integrating Oracle BI Publisher with Siebel Business Applications” on
page 35.
a Navigate to the Administration - BI Publisher Reports screen, then the relevant template view
(Reports - Custom Templates or Reports - Standard Templates).
b Select the Account List report layout template, and then click Upload Files.
c Navigate to the View Association view to associate the Account List report to the Account List
view.
The Account List report layout template is now available to the Siebel application for use in
generating reports.
b Perform a query that returns approximately 30 records, and then click Reports.
e Generate the report in a different format or click Close to close the output type dialog box.
NOTE: When you create your own custom reports, you must upload the report template and
associate it with a view before you can use that report.
For more information about generating reports, see Chapter 6, “Generating Reports.”
a Make sure you have a Siebel CRM version 8.1.1 or later environment and have applied the latest
Siebel CRM Fix Pack 8.1.1.x.
b Upgrade to the appropriate Java Development Kit (JDK) version and make sure the JAVA_HOME
system environment variable points to the JDK.
For the applicable versions for your deployment, see version 8.1.1.x Siebel System Requirements
and Supported Platforms on Oracle Technology Network.
2 Make sure you have the appropriate Oracle Business Intelligence Publisher software installed:
■ Oracle Business Intelligence Publisher Add-in for Microsoft Word (also known as Oracle BI
Publisher Desktop)
For the applicable version for your deployment, see Siebel System Requirements and Supported
Platforms on Oracle Technology Network. For more information, see “Upgrading to the Latest
Oracle BI Publisher Patch” on page 45.
4 Apply the latest repository, schema, and seed data changes for ACR 719b.
For instructions, see 880452.1 (Article ID), Siebel Maintenance Release Guide on My Oracle
Support.
For instructions, see “Enabling Siebel Server Components for Siebel Reports” on page 47.
For instructions, see “Setting Up and Enabling the Siebel Security Model for Siebel Reports” on
page 51.
NOTE: Many of the steps in this task are applicable only to first-time installations. Make sure to
perform only steps indicated for upgrades.
7 Add a new wlfullclient.jar file to the XMLPJvmSubsys classpath for the Oracle BI Publisher Server.
For instructions, see “Adding an Explicit Reference to JAR Files for the Oracle BI Publisher Server”
on page 57.
8 “Uploading Preconfigured Report Layout Templates to the Oracle BI Publisher Server” on page 59
a “Configuring the Data Service WSDL for the Oracle BI Publisher Server” on page 61
b Change the id symbolic URL argument name to uid and create a new pgheader argument.
For instructions, see “Verifying Symbolic URL Arguments That Embed the Oracle BI Publisher
Scheduling Views in the Siebel Application” on page 62.
This chapter describes some of the administrative tasks for Siebel Reports. The tasks in this chapter
are for administrators only and are applicable to both connected and disconnected modes unless
otherwise indicated. This chapter includes the following topics:
■ Deploying Report Layout Templates to the Siebel Web Client from a Disconnected Client on page 68
■ Uploading New or Modified Report Layout Templates for Multiple Siebel Server Environments
■ Changing the Location of the Oracle BI Publisher Repository for Siebel Reports on page 73
■ Setting the Server Request Processor Database Polling Interval for Siebel Reports on page 83
■ Process of Optimizing the Generation Performance of Siebel Reports for Large Data Volumes on
page 85
■ About Increasing the Java Heap Size on Oracle BI Publisher Server on page 89
Report templates and associated XLIFF translation files are stored in the Siebel File System and are
synchronized to the Siebel Server when a Mobile Client performs a synchronization. After you click
Upload in the user interface, the report is then available for generation in connected mode with the
Oracle Business Intelligence Publisher (Oracle BI Publisher) Server. This topic describes how to
deploy reports to the Siebel Web Client from a disconnected client.
NOTE: It is recommended that you locate your report layout template files in the
SIEBSRVR_ROOT\XMLP\Templates directory and the XLIFF files in the
SIEBSRVR_ROOT\XMLP\xliff\language directory.
2 Register the report by doing the following:
a Navigate to the Administration - BI Publisher Reports screen, then one of the following template
views:
b Create a new record and assign the template and integration object to the record.
c In the XLIFF field, assign the associated .xlf file to the report.
NOTE: The Generate XLIFF button is disabled in the Siebel Web Client and that is why you must
explicitly select the .xlf file.
For information about assigning reports to Siebel views, see “Associating Registered Reports with
Siebel Application Views” on page 127.
4 Upload the report to the Oracle BI Publisher Server by doing the following:
b Click the Reports tab, expand Shared Folders, and then click SiebelCRMReports.
c Verify that the new report layout template and associated files were uploaded.
To upload new or modified report layout templates for a multiple Siebel Server
environment
1 For each of the Siebel Servers, copy the new or modified RTF file to the following directory:
SIEBSRVR_ROOT\TEMP\XMLP
2 For each of the Siebel Servers, copy the .XLF (XLIFF) file to the appropriate language folder in
the following directory:
SIEBSRVR_ROOT\XMLP\XLIFF
SIEBSRVR_ROOT\XMLP\XLIFF\ENU
3 Log in to the Oracle BI Publisher Server as administrator and manually delete the report layout
template from the SiebelCRMReports folder.
4 Log in to the Siebel Web Client and upload the new or modified report layout template by doing
the following:
a Navigate to the Administration - BI Publisher Reports screen, then the relevant template view
(Reports - Custom Templates or Reports - Standard Templates).
b Click Upload Files.
NOTE: If the Reports icon is disabled, then you can still execute reports using Siebel workflows or
Siebel business services. For more information, see “Report Business Service” on page 181.
2 Navigate to the Administration - Application screen, then the System Preferences view.
3 Query for ReportEngineType and then set the System Preferences value to NONE.
4 Restart the Siebel Server to verify the Reports icon does not appear.
2 Navigate to the Administration - Application screen, then the System Preferences view.
3 Query for ReportEngineType and then set the System Preferences value to BIP.
■ My BI Publisher Reports
■ Schedule Report
NOTE: By default, the scheduling option appears on the Reports menu only if a user has been
assigned the XMLP_SCHEDULER responsibility. For more information about reports
responsibilities, see “Setting Up and Enabling the Siebel Security Model for Siebel Reports” on
page 51.
For example, you might want to change the My BI Publisher Reports in the Reports menu to
Generated Reports or something similar.
Using Siebel Tools, you rename Siebel Reports menu items by configuring symbolic strings to change
the text string.
b To change the Schedule Report menu item, query for SBL_SCHEDULE_REPORTS, and then edit
the Current String Value.
4 Compile the Symbolic String project, distribute the updated SRF, and then restart the Siebel Server.
5 Verify your changes by doing the following:
NOTE: Administrators are also responsible for purging reports from the Oracle BI Publisher Server.
For information about this purging, see “Purging Scheduled Reports from the Oracle BI Publisher
Server” on page 72.
You can set up Siebel Reports to automatically purge reports from the Siebel Database after a
specified time interval. The BIP Delete After Days system preference allows you to specify a nonzero
positive value that executes the Auto Purge workflow to purge the reports. The reports are purged
from the database and the Siebel File System after the number of days specified. For example, if you
want to keep reports for the last seven days, but remove all reports after this time frame, then you
set the value to 7.
CAUTION: It is recommended that only administrators perform this task, because you run the risk
of inadvertently depleting or contaminating the report repository. Report developers and other users
can delete reports, but they must not purge reports. For information about deleting reports, see
“Deleting Reports” on page 101.
2 Navigate to the Administration - Application screen, then the System Preferences view.
3 In the System Preferences list, select BIP Delete After Days, and change the value to a positive,
nonzero value.
NOTE: It is recommended that you set this value in relation to your daily report volumes,
especially for large-scale implementations where many reports are generated. Setting this
parameter to a low value prevents the Siebel File System from increasing to an unmanageable
size.
4 Navigate to the Administration - Server Management screen, then the Jobs view.
7 Click Submit.
You can also schedule this job to generate periodically using a workflow. For more information about
scheduling workflows, see Siebel Business Process Framework: Workflow Guide.
TIP: You cannot purge scheduled reports from the Siebel application or by using the Oracle BI
Publisher administration application.
This topic describes how to purge reports using either the Job Manager Instances List or the Job
Manager Purge Instances Window.
CAUTION: It is recommended that only administrators purge scheduled reports, because you run
the risk of inadvertently depleting or contaminating the report repository. Report developers and
other users can delete reports, but they cannot purge reports. For information about deleting
reports, see “Deleting Scheduled Reports” on page 135.
NOTE: Administrators are also responsible for purging reports from the Siebel File System. For
information about this purging, see “Automatically Purging Reports from the Siebel File System” on
page 71.
By default, the location of the Oracle BI Publisher repository is stored in the Oracle home JVM
property with a value of ${oracle.home}/xdo/repository. The Siebel application uses this JVM
property to access the Oracle BI Publisher repository. If Oracle BI Publisher is running on an Oracle
Application server or an Oracle Application Server Containers for Java Platform, Enterprise Edition
(OC4J) standalone, then this oracle.home property value is automatically set by the OC4J container.
For more information about OC4J, see Oracle Business Intelligence Publisher Installation Guide,
Release 10.1.3 available on Oracle Technology Network (http://www.oracle.com/technetwork/
indexes/documentation/index.html).
For instructions, see “Changing the Location of the Oracle BI Publisher Repository by Creating a
Custom XML File” on page 74.
For instructions, see “Changing the Location of the Oracle BI Publisher Repository by Replacing a
JVM Property Name” on page 74
For instructions, see “Changing the Location of the Oracle BI Publisher Repository by Changing the
Absolute Path to the Repository” on page 75.
This task is a step in “Changing the Location of the Oracle BI Publisher Repository for Siebel Reports”
on page 73.
To create a custom XML file to change the location of the Oracle BI Publisher
repository
1 Copy the xmlp-server-config.xml file and paste it to a folder where Oracle BI Publisher can read
it.
For example, in an Oracle AS/OC4J 10.1.3 deployment, you copy the configuration file from:
OC4J_HOME/j2ee/home/applications/xmlpserver/xmlpserver/WEB-INF/xmlp-server-
config.xml
2 Edit the newly created .xml file to reflect the new path.
<xmlpConfig xmlns="http://xmlns.oracle.com/oxp/xmlp">
<resource>
<file path="${oracle.home}/xdo/repository"/>
</resource>
</xmlpConfig>
-Dxdo.server.config.dir=/home/BIP
This task is a step in “Changing the Location of the Oracle BI Publisher Repository for Siebel Reports”
on page 73.
NOTE: You must set the value of the new JVM property to the correct repository path.
Use the following procedure to change the location of the Oracle BI Publisher Repository by changing
the absolute path to the repository.
NOTE: It is the responsibility of the report designer to make sure that fonts are selected that match
the data that is likely to be included in a report. For more information about fonts in Siebel Business
Applications, see Siebel Global Deployment Guide.
To copy fonts
■ On the Siebel Server where the XMLP Report Server component is enabled, do one of the
following:
■ For Windows, copy the fonts in C:\WINDOWS\Fonts directory to the fonts directory in the Java
installation directory for your deployment (typically this is JAVA_HOME\lib\fonts).
■ For UNIX, copy the fonts in the /Fonts directory to the fonts directory in the Java installation
directory for your deployment.
NOTE: This task is typically performed as part of the Siebel application installation. However,
administrators can perform this task at any time.
■ Make sure that a report is generated against a particular Siebel record with a preference for a
specific document locale for that record. For example, you might have a preference for a
document language for a specific Quote report.
■ Let users set a default locale preference for their own report generation.
■ Let users override the default locale values when generating reports.
■ Execute report generation using the default locale settings of the user’s session object manager.
Table 6 provides details of how this logic is implemented in Siebel Reports. The order defines the logic
applied at run time to determine which default language preferences to use.
Table 6. How Siebel Reports Determines the Report Language at Run Time
Default
Preference Order Description
Template specific 1 If a default locale is specified in the report layout template, then
these values appear as the default selection for the report output.
However, users can override these settings at run time for an
individual report (see Run-time Selection in this table).
Entity related 2 The Report Business Service is configurable for locale as an optional
(business service) inputs. If the locale is specified at the template level, then the
template parameters are used rather than those specified for the
input. If no parameters are passed to the Report Business Service,
then the default application object manager values are used.
NOTE: Only use locale values as business service inputs when these
values are not set at the template level.
Table 6. How Siebel Reports Determines the Report Language at Run Time
Default
Preference Order Description
User preferences 3 If the report layout template does not have a default locale, and the
user has set a locale property in their user preferences, then the user
preference values are used. Otherwise, the values in the report
layout template prevail. For information about setting user
preferences for report generation, see “Setting Locale User
Preferences for Reports” on page 101.
Run-time selection 4 Users can override the default locale values when generating a
report.
Related Topics
“Designing Multilingual Reports” on page 77
“Roadmap for Uploading Multilingual Reports to the Siebel Application” on page 79
“Adding and Deleting Locales from Report Templates” on page 80
“About Report Translation” on page 81
For more information about externalizing the user interface elements, see “About Report Translation”
on page 81. For more information about designing reports, see Chapter 7, “Creating Reports.”
2 Using Oracle Business Intelligence Publisher Add-in for Microsoft Word, redesign the layout
template for the new language.
For information about registering reports, see “Registering Report Layout Templates” on page 120.
NOTE: How translation files are uploaded from Oracle Business Intelligence Publisher Add-in for
Microsoft Word to generate reports differs depending on the connection mode; that is, whether
it uses connected or disconnected mode. For more information about uploading files, see
“Workflow for Uploading Report Layout Templates to a Siebel Application” on page 107.
Related Topics
“About Working with Multilingual Reports” on page 76
“Roadmap for Uploading Multilingual Reports to the Siebel Application” on page 79
“Adding and Deleting Locales from Report Templates” on page 80
“About Report Translation” on page 81
To upload a multilingual report to the Siebel application, perform the following tasks and processes:
1 Associate the RTF layout template file with the report using the appropriate report template
registration view (Reports - Standard Templates or Reports - Custom Templates). For
information, see “Registering Report Layout Templates” on page 120.
2 Associate an XLIFF or ZIP file with the report record using the following guidelines:
■ To upload a single or multiple XLIFF files, use the following naming convention:
where:
3 Click Upload.
■ RTF file. The file is stored the SIEBEL_ROOT\XMLP\TEMPLATES directory. The RTF file and
associated XLIFF files are uploaded to Oracle BI Publisher Server in the appropriate folders.
■ ZIP file. The file is stored in the SIEBEL_ROOT\XMLP\xliff directory. The ZIP file is
automatically decompressed to the SIEBEL_ROOT\XMLP\xliff\locale_code folder.
NOTE: Validation occurs during the upload, and if any issues arise, an error message appears
and the uploaded files are deleted. For information about this validation, see “Registering Report
Layout Templates” on page 120.
4 Register the report, add the languages to the Translations list in the appropriate report
registration view (Reports - Standard Templates or Reports - Custom Templates). For
instructions, see “Registering Report Layout Templates” on page 120.
The report layout template and the associated XLIFF translation files are now registered.
Related Topics
“About Working with Multilingual Reports” on page 76
“Designing Multilingual Reports” on page 77
“Adding and Deleting Locales from Report Templates” on page 80
“About Report Translation” on page 81
2 Navigate to the Administration - BI Publisher Reports screen, then to one of the following
template views:
3 In the appropriate Template list, select the report to which you want to add a locale.
5 In the Language field, add a new language, and then click OK.
6 (Optional) If you want a different name for the translated report to appear in the Reports menu,
enter a Report Name.
2 Navigate to the Administration - BI Publisher Reports screen, then to one of the following
template views:
3 In the Report Template Registration list, select the report from which you want to delete a
language.
NOTE: This step removes only the language from the report; it does not remove the report.
Related Topics
“About Working with Multilingual Reports” on page 76
“Designing Multilingual Reports” on page 77
“Roadmap for Uploading Multilingual Reports to the Siebel Application” on page 79
“About Report Translation” on page 81
Typically, an administrator manages report translations; a third party usually performs the actual
translation.
NOTE: For a list of the languages that Siebel Reports supports, see Siebel System Requirements and
Supported Platforms on Oracle Technology Network.
When multilingual reports are generated for a specific report locale, the following occurs for each
component of the report translation:
■ Template text elements. Translation is determined by way of the translations in the relevant
XLIFF file.
■ MLOVs. Translation is determined based on the selected report locale and LOV data extracted
by way of EAI in the relevant language.
■ Dates and currency formatting. The format of date, time, and currency fields is based on the
template functions: format-date() and format-currency(). Both of these Oracle BI Publisher
functions use the locale code specified for the report generation to determine the correct format
to display based on the Oracle BI Publisher locale format definitions.
CAUTION: Each translated report must have a unique translated display name. If there are duplicate
names for translated reports, then when those names pass from the browser to the Siebel Server,
the server cannot differentiate which report to generate.
Related Topics
“About Working with Multilingual Reports” on page 76
■ “Setting the Server Request Processor Database Polling Interval for Siebel Reports” on page 83
■ “Process of Optimizing the Generation Performance of Siebel Reports for Large Data Volumes” on
page 85
NOTE: Most of these tasks are applicable only when the client is in connected mode unless noted
otherwise.
After the threshold is reached, and if a report is still generating, a message appears stating that the
report is running in the background and to retrieve the report from the BI Publisher Reports view.
For information about this view, see “Generating Reports” on page 95.
This task is a step in “Roadmap for Optimizing the Performance of Siebel Reports” on page 82.
2 In the System Preferences list, select BIP Report Wait Time, and then change the System
Preference Value to a number greater than 0.
Related Topics
Setting the Server Request Processor Database Polling Interval for Siebel Reports
Setting Concurrency Parameters for Siebel Reports
Process of Optimizing the Generation Performance of Siebel Reports for Large Data Volumes
NOTE: This parameter is hidden by default and does not appear in either the Siebel Server Manager
GUI or the Siebel Server Manager command-line interface program.
This task is a step in “Roadmap for Optimizing the Performance of Siebel Reports” on page 82.
Use the following procedure to set the Database Polling Interval server component parameter.
To set the Server Request Processor database polling interval for Siebel Reports
1 Navigate to the Administration - Server Configuration screen, Servers, and then the Components
view.
3 Scroll down, click the Parameters subview, and then click Hidden.
4 In the Parameter list, select Database Polling Interval, and change the value from 10 to 1.
Alternatively, you can use the srvrmgr command-line interface to restart the SRProc component
For more information about setting the server component parameters and restarting the Siebel
Server and server components, see Siebel System Administration Guide.
Related Topics
Setting the Report Execution Waiting Period for Reports
Setting Concurrency Parameters for Siebel Reports
Process of Optimizing the Generation Performance of Siebel Reports for Large Data Volumes
NOTE: A single Oracle BI Publisher instance running on OC4J platform can handle approximately
1500 concurrent users.
This task is a step in “Roadmap for Optimizing the Performance of Siebel Reports” on page 82.
2 Navigate to the Administration - Server Configuration screen, Servers, and then the Components
view.
a For the Maximum Tasks parameter, change the Value on Restart to 100.
where:
Related Topics
Setting the Report Execution Waiting Period for Reports
Setting the Server Request Processor Database Polling Interval for Siebel Reports
Process of Optimizing the Generation Performance of Siebel Reports for Large Data Volumes
This task is a step in “Roadmap for Optimizing the Performance of Siebel Reports” on page 82 and is
applicable to connected mode.
CAUTION: It is recommended that you perform the following procedure on a separate named
subsystem (for example, reportsdatascr) that is used only by the XMLP Report Server component.
Otherwise, the Application Object Manager (AOM) on the client computer might fail when retrieving
large amounts of data.
To optimize the generation performance of Siebel Reports for large data volumes, perform the
following tasks:
For instructions for setting this parameter, see 1064043.1 (Article ID) on My Oracle Support.
3 “Configuring a Temporary Directory on the Oracle BI Publisher Server for Siebel Reports” on page 87.
4 “Increasing EAI HTTP Transport Sleep Time for Siebel Reports” on page 88.
For more information about setting server profile parameters, see Siebel System Administration
Guide.
NOTE: It is recommended that you not execute reports with large data volumes as an immediate
report request. Instead, schedule these reports on the Oracle BI Publisher Server.
Related Topics
Setting the Report Execution Waiting Period for Reports
Setting the Server Request Processor Database Polling Interval for Siebel Reports
Setting Concurrency Parameters for Siebel Reports
This task is a step in “Process of Optimizing the Generation Performance of Siebel Reports for Large
Data Volumes” on page 85 and is applicable to connected mode.
NOTE: It is recommended that you only enable scalable mode when viewing large reports online with
a high concurrent report usage because this mode consumes more resources and might affect overall
performance. If large reports are more common than not in your deployment, then set the scalable
mode for all reports. Setting the scalable option prepares the FO processor to handle large data,
longer processing times, time-outs, and so on. Although scalable mode is a relatively slower process,
this mode makes sure there is no data loss even if the report is complex.
2 Open the xdo.cfg file, and in the <Properties></Properties> tag, use the following syntax to set
the Scalable Mode parameter to true (if it is not already set):
<property name="xslt-scalable">true</property>
<properties>
<!-- PLEASE uncomment this property and set it to a valid temp directory
path. -->
<property name="system-temp-dir">D:\Temp</property>
<property name="xslt-scalable">true</property>
</properties>
<fonts>
</font>
</font>
<font-substitute name="MSGothic">
</font-substitute>
</fonts>
<currency-formats>
</currency-formats>
</config>
Related Topics
Configuring a Temporary Directory on the Oracle BI Publisher Server for Siebel Reports
Increasing EAI HTTP Transport Sleep Time for Siebel Reports
This task is a step in “Process of Optimizing the Generation Performance of Siebel Reports for Large
Data Volumes” on page 85 and is applicable to connected mode.
NOTE: The path for the Java installation folder varies depending on where you installed JRE.
2 Open the xdo.cfg file, and in the <Properties></Properties> tag, use the following syntax to set
the temporary directory:
<property name="system-temp-dir">d:\tmp</property>
NOTE: Make sure the location of the temporary directory has adequate space for the temporary
files.
Related Topics
Enabling Scalable Mode for Siebel Reports
Increasing EAI HTTP Transport Sleep Time for Siebel Reports
This step is a task in “Roadmap for Optimizing the Performance of Siebel Reports” on page 82.
You can optimize report generation for complex reports by increasing the default sleep time for the
EAI HTTP Transport business service. This is especially helpful when generating complex reports or
against large data sets, that might take longer than a couple of minutes to generate.
This task is a step in “Process of Optimizing the Generation Performance of Siebel Reports for Large
Data Volumes” on page 85 and is applicable to connected mode.
4 In the Object Explorer, select Business Service Method, select the GenerateBIPReport method,
and then the HTTPSleepTime Business Service Method Arg.
Related Topics
“Enabling Scalable Mode for Siebel Reports” on page 85
“Configuring a Temporary Directory on the Oracle BI Publisher Server for Siebel Reports” on page 87
-Xms512m -Xmx512m
NOTE: Different operating systems can have different JVM memory limits.
For more information about increasing the Java heap size, see the topic on setting the JVM heap size
for OC4J processes in Oracle® Application Server Performance Guide in the Oracle Business
Intelligence Publisher Documentation Library 10.1.x available on Oracle Technology Network (http:/
/www.oracle.com/technetwork/indexes/documentation/index.html).
■ Avoid creating a large integration objects that might be shared by many different reports, if the
integration object contains many fields. Create individual integration objects for each report to
improve performance.
■ Deactivate any fields that are not required. When using the EAI Siebel Wizard to create an
integration object, be aware that the wizard adds all fields from the business component.
This chapter describes how to generate, view, monitor, and delete reports in Siebel Business
Applications from a user perspective. It includes the following topics:
Figure 6 shows a sample Reports menu drop-down list, which displays the names of the reports
available for the current view—such as Opportunity List and Pipeline Report By Rep—as well as a link
to a user’s own previously generated reports (My BI Publisher Reports) and a link for scheduling
reports (Schedule Report).
NOTE: The Reports menu and some menu items are configurable. For more information about
configuring the Reports menu, see “Configuring the Reports Icon” on page 69.
Related Topics
“Scenario for Generating Reports” on page 92
“About Generating Reports for Selected Records” on page 93
“Generating Reports” on page 95
“Example of Generating an Opportunity Report” on page 97
“Monitoring the Status of Currently Generating Reports” on page 97
“Viewing Details for Generated Reports” on page 99
“Deleting Reports” on page 101
“Setting Locale User Preferences for Reports” on page 101
“Configuring the Reports Icon” on page 69
This scenario describes one example of a sales representative generating reports. In this example,
the representative chooses a report and the report output type, then the report generates and
appears in the chosen format. While generating, the representative can monitor or view the status
of the report and after successful completion, she can access the report immediately or a later time.
NOTE: The process for scheduling reports is similar, however, you choose Schedule Report from the
Reports menu instead of selecting a report from the drop-down list. For information about scheduling
reports, see Chapter 8, “Scheduling Reports.”
Related Topics
“About Generating Reports” on page 91
“About Generating Reports for Selected Records” on page 93
“Generating Reports” on page 95
“Example of Generating an Opportunity Report” on page 97
“Monitoring the Status of Currently Generating Reports” on page 97
“Viewing Details for Generated Reports” on page 99
“Deleting Reports” on page 101
“Setting Locale User Preferences for Reports” on page 101
For nonselected records reports, any query or predefined query you perform from a list view in Siebel
Business Applications is the criterion used for report generation. When you drill down on a record
from a list view into a detail view, the query context is preserved. Therefore, the query record set
for the report generation reflects the record set in the detail view.
With a selected records report, if you select individual records from a parent list applet or form applet
or child records on a list applet in a detail view, then these record selections override any user
interface or pre-defined query. The selected records become the query record set for the report
generation.
NOTE: The report developer must have specified that a particular report can be generated using the
selected records functionality. For information, see “About Defining Report Layout Templates for
Selected Records” on page 111 and “Defining Report Layout Templates for Selected Records” on
page 126.
CAUTION: It is recommended that you select no more than 50 records at a time because doing so
might cause report generation to fail. If you need to specify a large data set for a report, then execute
a query and run a nonselected records report.
Related Topics
“About Generating Reports” on page 91
“Generating Reports” on page 95
“Example of Generating an Opportunity Report” on page 97
“Monitoring the Status of Currently Generating Reports” on page 97
“Viewing Details for Generated Reports” on page 99
“Deleting Reports” on page 101
“Setting Locale User Preferences for Reports” on page 101
Generating Reports
You generate reports using the Siebel application views and the Reports menu. Figure 7 shows the
tasks for generating Siebel Reports.
1 (Optional) Override the default report language and local by setting user preferences.
For information about overriding user preferences for report generation, see “Setting Locale User
Preferences for Reports” on page 101. For information about how languages and locale settings
are implemented in Siebel Reports, see “About Working with Multilingual Reports” on page 76.
2 Navigate to the Siebel application view from which you want to generate a report, run a query
to limit the number of returned records, and then click Reports.
TIP: It is strongly recommended that you perform a query before generating a report.
Performing a query will limit the number of returned records for the report.
3 From the Reports menu, you choose to either generate a report or schedule a report.
■ Generate a report from the BI Publisher listing, you designate a report output file type, and
then click Submit. Additionally, if this is a parameterized report, you have the option to select
more criteria before selecting the report output file type.
NOTE: Optionally, you can choose a different locale rather than accept the defaults.
■ Select My BI Publisher Reports, you can choose a report that you previously generated by
drilling down on it from the My Reports view.
■ Schedule a report, you choose the report name, the output type, and other scheduling
criteria from the Schedule a Report dialog box.
5 If you chose a report from the BI Publisher section or drilled down on a report from the My
Reports view, from the File Download dialog box, you can choose to:
■ Open the report. The report downloads and appears in a browser window in the format you
chose in Step 4.
The report output file types are: PDF, HTML, RTF, EXCEL, PPT, and MHTML. The PPT and
MHTML output file types are available only in connected mode. For more information about
the report output file types, see “Who Can Use Siebel Reports?” on page 18.
■ Save the report. You can save the report to a destination of your choosing, and then Open it
for viewing immediately or at a later time.
If you chose to schedule a report, you can view or monitor the report job in the Scheduled
Reports view.
6 You can continue to generate or schedule reports in other formats or click Close to end.
NOTE: If a report encounters errors while generating, a log file is created that the report developers
or administrators can use to troubleshoot the problem. For more information about troubleshooting
reports, see Chapter 12, “Troubleshooting Siebel Reports.”
Related Topics
“About Generating Reports” on page 91
“Scenario for Generating Reports” on page 92
“About Generating Reports for Selected Records” on page 93
“Generating Reports” on page 95
“Example of Generating an Opportunity Report” on page 97
“Monitoring the Status of Currently Generating Reports” on page 97
“Viewing Details for Generated Reports” on page 99
“Deleting Reports” on page 101
“Setting Locale User Preferences for Reports” on page 101
“Scheduling Reports” on page 129
In this example, assume you want to generate the By Sales Rep opportunity report in PDF format.
TIP: The predefined query for this view shows only your current opportunities. If you want to
see all of your opportunities, click Query, and then click Go.
2 Run a query to limit the number of records returned, and then click Reports.
3 From the BI Publisher section of the Reports menu, select the By Sales Rep report.
4 In the Select the Report Output Type dialog box, choose PDF, and then click Submit.
The By Sales Rep report Opportunity appears in a browser window, prompting you to open, save,
or cancel the request.
5 Click Open.
The By Sales Rep Opportunity report appears in PDF format in a new browser window, from which
you can choose to print, save, or cancel the report.
Related Topics
“About Generating Reports” on page 91
“Scenario for Generating Reports” on page 92
“About Generating Reports for Selected Records” on page 93
“Generating Reports” on page 95
“Monitoring the Status of Currently Generating Reports” on page 97
“Viewing Details for Generated Reports” on page 99
“Deleting Reports” on page 101
“Setting Locale User Preferences for Reports” on page 101
NOTE: This topic is not applicable to scheduled reports. For information about monitoring scheduled
reports, see “Monitoring and Viewing Scheduled Reports” on page 134.
2 Navigate to the BI Publisher Reports screen, then one of the following Reports views:
■ My Reports
■ My Team’s Reports
■ All Reports
3 In the appropriate reports list, look for the report that you want to monitor, and then review the
Status field for that report.
The status indicators are: In Progress, Success, and Error as described in the following table.
Field Description
Status Indicates:
TIP: The timestamp for a report is the submit time on the Siebel Server. If a user submits a
report when the XMLP Report Server component is not enabled, the report appears with a blank
status in the My Reports view. Then, when the XLMP Report Server component is enabled, the
report immediately shows a status of In Progress. However, the status might not appear long
enough for you to view it. This behavior is because typically the In Progress status disappears
after only a few seconds and is replaced with a status of Success. The My Reports view allows
you to monitor the progress of a currently generating report.
4 If the report shows a status of Success, you can drill down on the report to view it or save it.
Related Topics
“About Generating Reports” on page 91
“Scenario for Generating Reports” on page 92
“About Generating Reports for Selected Records” on page 93
“Generating Reports” on page 95
“Example of Generating an Opportunity Report” on page 97
“Viewing Details for Generated Reports” on page 99
Position-based visibility applies to generated reports, that is, a user’s position specifies which reports
that user has access to.
For more information about positions and visibility in Siebel Business Applications, see Siebel
Security Guide.
NOTE: This topic is not applicable to scheduled reports. For information about viewing scheduled
reports, see “Monitoring and Viewing Scheduled Reports” on page 134.
■ My Reports
■ My Team’s Reports
■ All Reports
2 In the appropriate reports list, select or query for the report that you want to view.
Parameter Description
Task Id The unique task ID for the report generation server request. The task ID
is useful when searching log fields to find a specific segment related to a
report request.
Start Time The start and end times of the report generation.
End Time
Query String Shows the query entered when the report was generated.
Bookmark The complete view context including any query and applet and business
component search expressions and sort specifications that were active
when the report was generated.
View Mode The visibility view mode that was used when the report was generated.
Error Message If there is a problem with report generation, an error message appears in
this field.
Description Editable field you can use to add more descriptive information or
categorization.
Tags Editable field you can use to add more descriptive information or
categorization.
NOTE: Administrators can also view a report entitled Report Usage Statistics that provides
detailed statistical information about report generation, users who run the reports, failures, long-
running reports, and so on. This report is available as part of the preconfigured reports that ship
with Siebel Business Applications. For information about downloading these reports, see
876284.1 (Article ID) on My Oracle Support.
Related Topics
“About Generating Reports” on page 91
“Scenario for Generating Reports” on page 92
“About Generating Reports for Selected Records” on page 93
“Generating Reports” on page 95
“Example of Generating an Opportunity Report” on page 97
“Monitoring the Status of Currently Generating Reports” on page 97
Deleting Reports
This topic describes how to delete unwanted reports. You can delete reports that you have personally
generated or have been granted access to. After a report is deleted, it is no longer available in the
Siebel File System.
NOTE: This topic is not applicable to scheduled reports. For information about deleting scheduled
reports, see “Deleting Scheduled Reports” on page 135.
To delete a report
1 Navigate to the BI Publisher Reports screen, then to one of the following views:
■ My Reports
■ My Team’s Reports
■ All Reports
2 In the appropriate reports list, select a report, and then click Delete.
Related Topics
“About Generating Reports” on page 91
“Scenario for Generating Reports” on page 92
“About Generating Reports for Selected Records” on page 93
“Generating Reports” on page 95
NOTE: If a default report locale is not specified in the report template, and a user has set the locale
properties in their user preferences, the user preferences settings are used when the report is
generated. For detailed information about how Siebel Reports determines the report language at run
time, see “About Working with Multilingual Reports” on page 76.
2 Change the Locale and Language properties to the language of your choice.
NOTE: Setting user preferences allows you to generate reports in the locale you specified as long as
there is no default language or locale set in the report layout template.
Related Topics
“About Generating Reports” on page 91
“Scenario for Generating Reports” on page 92
“About Generating Reports for Selected Records” on page 93
“Generating Reports” on page 95
This chapter describes how to create reports. It is intended only for those who have report developer
or administrator privileges.
NOTE: Most users do not typically have access to the administration views in the Siebel application,
and as such, are not able to perform the tasks in this chapter. For information about reporting from
the user perspective, see Chapter 6, “Generating Reports” and Chapter 8, “Scheduling Reports.”
■ Workflow for Uploading Report Layout Templates to a Siebel Application on page 107
■ Should You Clone an Existing Report or Create Custom Reports? on page 110
■ About Defining Report Layout Templates for Selected Records on page 111
This scenario describes how a sales manager works with a report developer to create a custom
opportunity report.
Sales Manager Modifies an Existing Sales Report to Hand Off to the Report Developer
These reports give the sales manager a good understanding of the opportunities in the pipeline for
each sales representative on his team, and allows him to monitor how they are progressing through
the sales cycle. Towards the end of the quarter, he wants to know how much potential revenue his
team might be able to close for the quarter. To learn that information, he wants to see a revenue
breakdown for the team’s opportunities by probability and sales stage. He knows, however, that no
such report is currently available, but realizes that the reports developer can create such a report
for him. Because the sales manager wants the report to have a certain look, he starts creating a
preliminary opportunity report himself using Oracle Business Intelligence Publisher Add-in for
Microsoft Word. When he is satisfied with the report layout template design, he hands off the
template to the report developer.
Siebel integration objects are used to define which Siebel data is integrated. A typical business object
contains several business components and fields. In most integrations, only a subset of this data is
necessary for generating reports. Siebel integration object definitions specify the components and
which fields to integrate, and facilitate the integration by exchanging integration data as XML files.
For more information about:
■ Adding custom fields to existing integration objects for Siebel reports, see “Extending Integration
Objects to Add New Fields for Siebel Reports” on page 115.
■ Creating new integration objects for Siebel reports, see “Creating New Integration Objects for
Siebel Reports” on page 116.
NOTE: It is recommended that you request the assistance of a Siebel Tools developer to create
new integration objects for Siebel Reports.
Table 7 shows the integration object search specification run-time behavior for Siebel Reports. Keep
this behavior in mind when specifying your search specifications.
Table 7. Integration Object Search Specification Run-Time Behavior for Siebel Reports
Search Specification
UI Predefined Business
Query Query Applet Comp IO Expected Result
■ Position- and organizational-based visibility and view mode are automatically preserved.
■ The selected records functionality has no affect on query behavior. The context of the selected
records becomes the user interface or predefined query.
NOTE: Siebel Business Applications ship with standard integration objects for creating reports.
However, if there is no appropriate integration object available, you can either extend an existing
integration object or create new integration objects. For information about extending integration
objects, see “Extending Integration Objects to Add New Fields for Siebel Reports” on page 115. For
information about creating new integration objects, see “Creating New Integration Objects for Siebel
Reports” on page 116.
The following conditions and restrictions apply to reporting on multiple integration objects:
■ When specifying the integration objects in the report template in the Integration Objects list,
nonprimary integration objects must have a valid search specification value. For more
information about the report template in the Integration Objects list, see “Registering Report
Layout Templates” on page 120. For more information about nonprimary integration objects, see
“Adding Multiple Integration Objects to a Report” on page 124.
■ At run time, the query from the current view in the Siebel application is captured and passed to
the primary integration object. However, for integration objects other than the primary
(sometimes referred to as secondary integration objects) that are associated with a report,
queries are not passed from the user interface. The secondary integration objects are passed
according to the expression provided in the object’s search specification. For this reason, a valid
search specification value is required to filter the data for nonprimary integration objects.
■ If no search specification value is entered for nonprimary integration objects, or the expression
is incorrect, the integration object returns all data from the relevant business components. This
omission returns potentially unwanted data, and also has a negative impact on performance.
NOTE: It is recommended that you test search specifications for multiple integration objects in a
relevant application view to make sure the search specification is valid before applying the
specification to a report in the applicable report template view. For information about adding multiple
integration objects to reports, see “Adding Multiple Integration Objects to a Report” on page 124.
Figure 8. How the Layout Template and Translation Files Are Uploaded from Oracle Business
Intelligence Publisher Add-in for Microsoft Word to Generate Reports
1 From the report template views (My Templates and All Templates Across Organizations), the RTF
report layout template and translation (XLIFF) files are uploaded using an upload business
service to the Oracle BI Publisher repository as follows:
a In connected mode, the upload service occurs by way of the PublicReportServiceService Web
service. For more information about connected mode, see “Siebel Reports Architecture and
Workflow for Generating Reports in Connected Mode” on page 24.
To upload the report to the Oracle BI Publisher repository, the following must occur:
❏ The report layout template must have been saved in RTF format using Oracle Business
Intelligence Publisher Add-in for Microsoft Word.
❏ You must click Upload Files in the report template views in the Siebel application. The
RTF and XLIFF files are uploaded and an XDO report definition file is created when the
reports are generating.
❏ The report layout template (RTF) and language (XLIFF) files are attached to the report
during the registration of the report layout template.
NOTE: The Generate XLIFF button is disabled (grayed out) in connected mode.
❏ Before moving to the Oracle BI Publisher repository, the layout template (RTF) and XLIFF
files are attached to the report during the registration of the layout template.
b In disconnected mode, the upload service is not applicable. All files (RTF, XLIFF, and XSL) are
local to the Oracle BI Publisher XDO Engine when generating reports after. For more information
about generating reports in disconnected mode, see “Siebel Reports Architecture and Workflow
for Generating Reports in Disconnected Mode” on page 26.
For disconnected mode, you must click Generate XLIFF to create XSL. (Whereas in connected
mode, XSL is generated at run time by the Oracle BI Publisher Server.)
NOTE: The Upload Files button is disabled (grayed out) in disconnected mode.
2 For connected mode, the RTF and XLIFF files are stored in the Oracle BI Publisher repository by
way of the PublicReportServiceService Web service.
3 In disconnected mode, the report templates and XLIFF files are stored in the Siebel client
installation folder (that is, SIEBEL_ROOT_CLIENT\xmlp\templates and
SIEBEL_ROOT_CLIENT\xmlp\XLIFF, respectively).
For more information about uploading from Oracle Business Intelligence Publisher Add-in for
Microsoft Word, see “Registering Report Layout Templates” on page 120.
NOTE: Standard Siebel responsibilities control which reports views users can access. If you want to
prevent users from creating their own report templates and executing them from the Siebel
application, then do not grant access to the relevant template views. For example, you might want
to limit access to the Reports - Standard Templates view only to administrators.
The two views you use for report template registration are:
■ Reports - Standard Templates. This view contains the standard (preconfigured) report
templates provided with the Siebel application and any custom templates that you want to be
accessible enterprise-wide (that is, not based on position-based visibility). These templates are
visible within the Siebel application. The templates are based on the standard association of
Siebel views; that is, users can execute reports if they have access to the relevant views.
CAUTION: It is strongly recommended that you limit access to standard templates only to
administrators. Otherwise, you run the risk of users inadvertently modifying the standard report
templates (or other templates that are visible to all users in the enterprise).
■ Reports - Custom Templates. This view contains report templates that are filtered by
positions. Users with visibility to the My Templates view can create their own custom report
templates. Only these users can see or execute the custom report templates in the Siebel
application. However, they can share templates if other users have visibility to the relevant
application views. The All Templates Across Organizations view allows managers and
administrators to see the report templates of their subordinates. For more information about
shared report layout templates, see “Sharing Report Layout Templates” on page 125.
■ When a user logs into the Siebel application, that user sees organization-specific reports where
the Active Position Organization equals the organization or organizations defined for a custom
template.
■ Users with more than one organization can change their Primary Active Position Organization
during a single session. After making this change, the reports that user can view is different from
the original access.
A sales representative and his manager have visibility to the same Siebel view. However, the reports
they can see differ depending on their organization settings. Let us consider that the user is the
Holland organization, and his manager is in the Benelux organization. Benelux is the parent
organization of both the Holland and Belgium organizations.
■ Both the sales representative and his manager can see any report that is defined in the Standard
Templates view and that is associated to the view.
■ Custom templates he has created in the My Templates View. These templates have only a
default organization.
■ Custom templates that are explicitly associated to the Holland organization, given his current
active position organization is Holland.
■ Custom templates he has created in the My Template View or templates his subordinates
have created that appear in the My Teams view. These templates have only a default
organization.
■ Custom templates that are explicitly associated to the Benelux organization, given his
current active position organization is Benelux.
■ Custom templates created by both Holland and Belgium organizations because the manager
can see report templates created by his subordinates regardless of whether the subordinate
is in a different organization.
■ When differences between your new report and an existing report are minor
■ When you want multiple versions of the same report showing slightly different data to different
categories of users
When your requirements are not satisfied by an existing report and there are significant differences
between the report that you want and an existing report, create a custom report. The following are
some situations in which you must create a custom report:
■ When the report requires a new integration component for an existing integration object. For
example, you create a new report for a view that belongs to the same business object.
How Reports are Generated at Run Time When Not Using Selected
Records
If a report is not indicated in the report template registration views as supporting selected records,
then the report executes using the user interface query defined in the list or detail view in the Siebel
application based on the current view context. Drilldown context is also preserved so that when a
user drills down on a record from a list view into a detail view, the query context is preserved. The
query record set for the report generation reflects the record set in the detail view.
If you perform a query in the parent form applet on a detail view, then query replaces the record set
with a new query. If you perform a query on the child applet in a detail view, then the child applet
query is appended to the current query, and the record set in the view is reflected in the report
output.
How Reports are Generated at Run Time When Using Selected Records
If a report is indicated in the report template registration views as supporting selected records, then
the report executes only those records the user selects in the list or detail applet in the Siebel
application.
When you run a report that supports the selected records functionality from a list view, the parent
records selections are based on those records highlighted in the list applet. When you drill down, the
context is preserved, and by default, the parent applet will become the active applet. Therefore, only
the parent record and related child records will be the query used for the report generation.
If you select child records in the child list applet on a detail view, then these child records also
become selected records, and along with the associated parent record, make up the query used for
report generation.
CAUTION: It is recommended that you select no more than 50 records at a time because doing so
might cause report generation to fail. If you need to specify a large data set for a report, then run a
non-selected records report and execute a query prior to running the report.
NOTE: For suggestions as to when to modify versus create a report layout template, see “Should You
Clone an Existing Report or Create Custom Reports?” on page 110.
■ In Oracle Business Intelligence Publisher Add-in for Microsoft Word (also known as Oracle BI
Publisher Desktop) by modifying the existing or creating new report layout templates.
■ In the Siebel clients by using the Siebel Reports administration views to upload and register
report layout templates, associate reports with Siebel application views, and other administrative
tasks.
■ (Optional) In Siebel Tools by either extending an existing integration object or creating new
integration object definitions that execute at run time.
NOTE: Siebel Business Applications ship with standard integration objects. You create new
integration objects only when existing integration objects do not suffice.
Figure 9 shows the process of creating custom reports. The roadmap is applicable to both connected
and disconnected modes. For more information about the connection modes in relation to Siebel
Reports, see Chapter 3, “Siebel Reports Development Environment.”
Figure 9 illustrates the high-level tasks you perform when creating custom reports:
1 (Optional) “Extending Integration Objects to Add New Fields for Siebel Reports” on page 115
2 (Optional) “Creating New Integration Objects for Siebel Reports” on page 116
NOTE: Create new integration objects only when no appropriate integration object exists.
3 “Generating Sample XML Data Files for Siebel Reports” on page 118
Using the Sample Data File Generation view in the Siebel client, in this step the following tasks
are performed:
b Generate the sample XML data file, and then save it.
NOTE: The XML data file is typically saved to the XMLP\DATA directory in the Siebel File System.
You can however, save the XML to another location. For more information about the Siebel
Reports directory structure, see “About the Siebel Reports Architecture” on page 23.
4 “Creating Report Layout Templates Using Oracle Business Intelligence Publisher Add-in for Microsoft
Word” on page 119
In this step, you either modify an existing report layout template or create a new one, and then
do the following:
Using the template views (Reports - Custom Templates or Reports - Standard Templates), in this
step do the following:
In this step, you add new integration objects to a report, and the generate sample XML.
8 (Optional) “Defining Report Layout Templates for Selected Records” on page 126
In this step, you click the Selected Records field to configure a report template to display only
the currently selected records in a Siebel application view when a report is generated.
10 (Optional) “Changing the Report Sequence Order in the Reports Menu” on page 127
Using the Association View, in this step you can define the way reports are ordered or prevent
them from appearing in the Reports menu.
NOTE: It is recommended that you seek the assistance of a Siebel Tools configurator for integration
object modification. It is also recommended that you consider this option before creating new
integration objects for your reports. For information about creating new integration objects for Siebel
reports, see “Creating New Integration Objects for Siebel Reports” on page 116.
This task is an optional step in “Process of Creating Custom Reports” on page 112.
a Navigate to the Administration - BI Publisher Reports screen, then the relevant report template
view (either the Reports - Custom Templates view or Reports - Standard Templates view).
b Select the report for which you want to add a new field.
c In the Primary Integration Object Name column, identify and make note of the integration object
for this report.
TIP: Integration objects do not appear in the Object Explorer by default. Click the View
menu, Options, and then the Object Explorer tab to add the integration objects to the Object
Explorer view.
d Expand the Integration Component and Integration Component Field object types to view the
existing fields associated with this integration component.
e Create a new integration component field record and copy the Name, Data Type, and Length
properties from the underlying business component field whose data you want to display in the
report.
f Set the XML-related properties to construct the XML file when data is extracted.
NOTE: You must follow the convention for naming XML tags, that is, remove all spaces and
special characters. However, it is not a requirement that you use the ss_ prefix convention.
b Right-click the integration object you want to deploy, and then select Deploy to Runtime
Database.
NOTE: This action overrides the object definition in the SRF file.
c In the Siebel client, Navigate to the Administration - Web Services screen, then the Deployed
Integration Objects view.
e Navigate to the Administration - Web Services screen, Inbound Web Services view.
The extended integration object is now available for generating a new sample data file.
NOTE: You must migrate a modified SRF between environments for any changes you make to
integration objects.
For information about generating sample data files, see “Generating Sample XML Data Files for Siebel
Reports” on page 118. For more information about working with and deploying integration objects,
see Integration Platform Technologies: Siebel Enterprise Application Integration.
NOTE: It is strongly recommended you seek the assistance of a Siebel Tools developer for
integration object creation. It is also recommended that you consider extending an existing
integration object to add new fields before creating new integration objects for your reports. For
information about extending existing integration objects, see “Extending Integration Objects to Add
New Fields for Siebel Reports” on page 115.
This task is an optional step in “Process of Creating Custom Reports” on page 112.
After new integration objects are created and deployed, you can use the integration objects to
register a report layout template. For more information about registering a report layout template,
see “Registering Report Layout Templates” on page 120.
NOTE: When creating custom integration objects for Siebel Reports, make sure that the fields used
for dynamic queries in the applet of the master business component are also contained in the
integration component. Dynamic queries are specific, customized queries that you create.
By default, a QueryString field is automatically populated in the sample XML and parsed as a field
value in the integration object during report execution. This field contains the user-defined query
that was entered when the report was executed. You can display this field value on the report
template. For example, the format of the field might be [Account Status] = “Active”].
2 Use the Integration Object Builder wizard to create the new integration object, making sure to
name the new object definition with the prefix, BIP.
By default, you must add the BIP prefix so that integration objects appear in the Sample Data
File Generation view.
NOTE: It is recommended that if you use this wizard for creating integration objects, that you
deactivate only the required business component fields for the report. By default, the wizard
automatically adds all business component fields in the integration component. A large amount
of fields in an integration component might affect performance.
Typically, you add to an integration component only the fields that are required in the report. You
must also add to the integration component fields in the user interface that are required for
querying and filtering the data before executing the report.
3 Deploy the integration object to the run-time database by doing the following:
b In the Integration Object list, right-click the integration object you want to deploy, and then
select Deploy to Runtime Database.
c In the Siebel client, navigate to the Administration - Web Services screen, then the Inbound Web
Services view.
d Click Clear Cache to invalidate the integration object and Web services definitions in the run-time
database.
4 (Optional) Generate a new sample data file for the integration object for use when designing your
report templates.
This newly created integration object is now available in the Sample Data File Generation view for
creating custom reports. For information about generating sample data files, see “Generating Sample
XML Data Files for Siebel Reports” on page 118. For more information about integration objects and
deploying an integration object without compiling an SRF, see Integration Platform Technologies:
Siebel Enterprise Application Integration.
NOTE: It is recommended that you consider extending an existing integration object to add new
fields before creating new integration objects for your reports. If, however, there is no existing
integration object that fits your requirements, you can create new integration objects using Siebel
Tools. For information about extending existing integration objects, see “Extending Integration
Objects to Add New Fields for Siebel Reports” on page 115. For information about creating new
integration objects for reports, see “Creating New Integration Objects for Siebel Reports” on page 116.
2 In the Sample Data File Generation list, select the integration object for which you want to
generate a data file, click Generate Sample XML, and then save the file to the
SIEBSRVR_ROOT\XMLP\DATA directory.
An XML file is generated with the name of the integration object followed by .xml. For example,
if the integration object name is BIPLiteratureFulfillment, the file name for the XML file is
BIPLiteratureFulfillment.xml.
NOTE: When you generate sample XML data, only a subset of the I/O data is exported into the
XML file. If some fields (such as multivalue fields) are not populated, these fields do not appear
when loaded into Microsoft Word using Oracle BI Publisher Add-In for Microsoft Word (also known
as Oracle BI Publisher Desktop). If this occurs, export the schema using Siebel Tools (from the
Tools menu, select Integration Object, and then Generate Schema). Rename the file with an .xsd
extension, and then load this schema into Microsoft Word using the Oracle BI Publisher menu.
All fields are now available for use in the template. For more information about XML schema
generation, see Transports and Interfaces: Siebel Enterprise Application Integration.
You can now create report layout templates based on this XML data. For information about creating
report layout templates, see “Creating Report Layout Templates Using Oracle Business Intelligence
Publisher Add-in for Microsoft Word” on page 119.
NOTE: It is recommended that you use Oracle Business Intelligence Publisher Add-in for Microsoft
Word to create your custom RTF-formatted report layout templates. If you use other RTF-formatted
templates for creating your reports, you must manually code the XSL statements and references to
the data fields. Coding XSL is out of scope for this documentation.
CAUTION: Oracle BI Publisher does not support report names containing special characters.
The following are some situations in which you must create a new report layout template:
■ When a layout template requires that you add new fields or design a different layout
■ When a layout template requires association with a different integration component for the
specified integration object
■ When a layout template requires association with a different or multiple integration objects
The following procedure assumes you have installed Oracle Business Intelligence Publisher Add-in
for Microsoft Word (also known as Oracle BI Publisher Desktop). This procedure provides only quick
reference information for creating report layout templates. For detailed information, see Oracle
Business Intelligence Publisher User’s Guide, which is available from the Oracle BI Publisher Desktop
program menu (click Start, Programs, Oracle BI Publisher Desktop, and then BI Publisher Users
Guide).
To create a report layout template using Oracle Business Intelligence Publisher Add-
in for Microsoft Word
1 Start Microsoft Word.
2 From the application-level menu in Microsoft Word, select Oracle BI Publisher, Data, and then
Load Sample XML Data.
3 In the Select XML Data window, select the XML data file.
NOTE: Typically, the XML data files reside in the XMLP\DATA directory on which the Siebel Server
is running.
4 Define the format of the report and the Siebel fields that you want to appear in the report, using the
Template Wizard as follows:
a From the Microsoft Word toolbar, choose Insert, Table/Form, and then Wizard.
b In the Template Wizard, choose the report format, and then click Next.
You can choose one of the following: Table, Form, or Free Form.
c (Optional) Change the XML data grouping, and then click Next.
d Select the Siebel fields that you want to appear in your report, and then click Next.
e If the data is to appear in Table format, decide the grouping and sorting, and then click Next.
f Label the Siebel fields as you want them to appear in the new report, and then click Finish.
The following files are created and stored in the Siebel File System for retrieval by the Siebel
application as follows:
❏ The report layout template (RTF) and XLIFF files in connected mode
a In Microsoft Word, open the RTF template file (if not already open).
b From the application-level menu, select Oracle BI Publisher, Preview Template, and then choose
the output file format.
The report appears in the chosen format with the data substituted.
If you are currently creating a report for which you want to use this report layout template, you must
register the report layout template in the Siebel application, see “Registering Report Layout
Templates” on page 120.
NOTE: Additional report template creation information is provided in Oracle Business Intelligence
Publisher Report Designer's Guide in the Oracle Business Intelligence Publisher Documentation
Library 10.1.3.4 available on Oracle Technology Network (http://www.oracle.com/technetwork/
indexes/documentation/index.html). Not all features mentioned in the Oracle Business Intelligence
Publisher documentation are currently supported in Siebel Reports; only the features documented in
this guide.
NOTE: Each report can have only one report layout template, but you can register the same report
layout template for many reports.
In connected mode, the Oracle BI Publisher Server requires the RTF and XLIFF files in its folder
structure. If the files are not available, the report is not generated. When the upload is successful,
a new folder structure is created in the Oracle BI Publisher repository. This folder has the same name
as the report selected and contains the report layout template (RTF), XLIFF, and .xdo files. The Oracle
BI Publisher Server creates the XSL file during run time.
In disconnected mode, the RTF, XLIFF, and XSL files must be made available (by uploading the files
to the Oracle BI Publisher XDO Engine) before the reports are generated. For more information about
uploading report layout templates to the Siebel application, see “Workflow for Uploading Report Layout
Templates to a Siebel Application” on page 107.
NOTE: If you are uploading new or modified report layout templates in a multiple Siebel Server
environment, see also “Uploading New or Modified Report Layout Templates for Multiple Siebel Server
Environments” on page 69. If you are uploading multilingual reports, see also “Roadmap for Uploading
Multilingual Reports to the Siebel Application” on page 79.
When associating an RTF or ZIP file with a report, the following validation checks occur to make sure
that:
■ The XLIFF file name contains the same template name as the physical template file name
NOTE: You must leave this command window open while the Oracle BI Publisher Server is
running.
2 In the Siebel application, navigate to the Administration - BI Publisher Reports screen, then one
of the following template views:
4 Register the report layout template for the report by doing the following:
NOTE: An error message appears if a report already exists in the Siebel application with the
same Report Name value, including other user’s reports or standard preconfigured reports
that ship with Siebel Business Applications.
NOTE: The Report Access field is available only in the Reports - Custom Templates view to
allow for sharing of generated reports.
TIP: The start and end dates determine the period that a report is available for use. If you
choose a start date, you must also choose an end date. Conversely, if you choose an end
date, you must also choose a start date.
Field Description
End Date An end date for the report. After the end date passes, the report no
longer appears in the Reports menu. By default, this field is NULL.
Primary The primary integration object for the report. This field is read-only
Integration Object and is automatically populated when you select an integration object
Name in the report template Integration Objects subview.
Template The RTF report layout template that is used to generate the report.
Templates are stored in the following folder:
SIEBSRVR_ROOT\XMLP\TEMPLATES
Output Type The format of the generated report, which can be one of the following:
PDF, HTML, RTF, XLS, PPT, MHTML, or All.
NOTE: If a report is saved with only one report output type, the
Report Output Type dialog box does not appear when the user selects
that report in the Reports menu. Instead, the report begins generating
in the assigned format. Typically, the output type is set to All. PPT is
applicable only in connected mode.
Default Locale The default locale for the template. Locale is the language and locale
combination based on the locale configuration in the Siebel
application. For more information, see Siebel Global Deployment
Guide.
Field Description
XLIFF XLIFF files contain the strings of the report column, field labels, and
captions that are used for translation purposes.
Selected Records Indicates that only the currently selected records in a Siebel
application view are included in the report at run time. For more
information about how to use the selected records feature, see
“Defining Report Layout Templates for Selected Records” on page 126.
Parameters Indicates that the report is a parameterized report that accepts run-
time parameters. You define the parameters associated with the report
in the Parameters list. For information about defining parameters for
a report, see “Defining Report Parameters in the Siebel Application” on
page 160.
5 Associate a primary integration object with the report by doing the following:
Field Description
Integration The integration object that you want to associate with the report layout
Object Name template.
Field Description
Search A query data filter. When you create a nonprimary integration object
Specification for a report, you must enter a search specification value. For example,
the value of the search specification might be the following expression:
'IntegrationComponentName'.Search = "[FiledName] =
""ValueToBeTested"""
For example:
Primary Indicates that this integration object is the primary integration object. The
Primary Integration Object Name field in the template views are
automatically populated when you select a primary integration object.
NOTE: The first integration object that you associate with a report is
automatically indicated as the primary integration object.
c (Optional) Click Generate Sample XML for use when designing reports.
6 (Optional) If you want to generate reports for multiple business objects, perform the tasks as
described in “Adding Multiple Integration Objects to a Report” on page 124.
For information about assigning languages to report layout templates, see “Adding and Deleting
Locales from Report Templates” on page 80.
You must now associate the registered report with the views in which you want the report to be
available. For more information on associating reports, see “Associating Registered Reports with Siebel
Application Views” on page 127.
This task is an optional step in “Process of Creating Custom Reports” on page 112.
The following procedure assumes that you have registered or are in the process of registering a
report layout template, as described in “Registering Report Layout Templates” on page 120.
2 In the relevant report template view, select a report (if not already selected).
NOTE: Custom integration objects previously created appear as well as the preconfigured
integration objects that ship with the Siebel application. One of the integration objects is
indicated as primary. This Primary field is automatically indicated when associating an integration
object with a report for the first time.
The fields are described in Step 5 in “Registering Report Layout Templates” on page 120.
5 Repeat Step 3 and Step 4 of this procedure for each additional integration object that you want
to add.
One XML data file is generated for the multiple integration objects.
NOTE: This step is similar to what occurs in “Generating Sample XML Data Files for Siebel Reports”
on page 118, but in the Sample Data File Generation view, you can generate XML for only one
integration object.
If you are currently creating a report, you must now associate the registered report with a Siebel
application view. See “Associating Registered Reports with Siebel Application Views” on page 127.
This task is an optional step in “Process of Creating Custom Reports” on page 112.
The Report Access field on the report record controls access to the report templates that are
executable. After a user is granted access to the report template, the template appears in the
Reports menu when a user navigates to the relevant view.
NOTE: The Report Access field is available only in the Reports - Custom Templates view to allow
for sharing of generated reports based on position.
For information about registering a new report, see “Registering Report Layout Templates” on
page 120.
a Click the Report Access field to display the Position dialog box.
b In the Position dialog box, select the positions that you want to grant access to the report, and
then click Add.
NOTE: You can select multiple positions by using the CTRL key.
b Select the organizations that you want to grant access to the report, and then click Add.
NOTE: If you encounter problems using this feature, you might need to perform additional Siebel
Tools configuration. For instructions, see 1180903.1 (Article ID) on My Oracle Support.
This task is an optional step in “Process of Creating Custom Reports” on page 112.
2 In the appropriate templates list, select the report for which you want to enable the single or
multiselect feature, and then click the Selected Records field.
2 In the Views list, select a view with which you want to associate a report.
c Click OK.
The report is now available in the Reports menu when a user is in a view with which the report
is associated and the user has visibility to that view.
NOTE: If a report encounters errors while generating, a log file is created that report developers
and administrators can use to troubleshoot the problem. For more information about
troubleshooting reports, see Chapter 12, “Troubleshooting Siebel Reports.”
You can define the way reports are ordered or even hide a report from appearing in the Reports menu
by setting the Sequence field on the report record. You can define this field when creating a report
(or change the sequence later) to a numeric value that determines the sort order of the reports. The
sort order is calculated with the lowest value appearing higher in the list of reports. The Siebel
application calculates the order. The calculation is based on the following logic:
■ The sequence value can be any positive integer including 0 (zero) or NULL.
■ When the sequence value is set to 0 (zero), the report does not appear in the Reports menu.
■ If the field value is blank or NULL, the report is generated using the standard sort order (that is,
according to the report name). This setting is the default.
■ Reports with a positive integer sequence value are sorted by the sequence value and ordered
before any report with a NULL sequence value.
■ If two or more records have the same sequence value, the records are sorted by name.
TIP: Because the Sequence field is a standard, numeric-business component field, you can add your
own business logic for how reports appear in the application. For more information about configuring
business components, see Configuring Siebel Business Applications.
2 Select the view for which you want to define the report order.
3 In the Report List, use the sequence field to assign a sequence to some or all of the reports.
This chapter describes how to schedule reports in Siebel Business Applications from a user
perspective. It includes the following topics:
The Scheduled Reports view is an Oracle BI Publisher Web page that is embedded in the Siebel
application user interface. The Siebel application and Oracle BI Publisher exchange data by way of a
Web service to produce the report. For more information about using the Schedule Reports view, see
“Monitoring and Viewing Scheduled Reports” on page 134.
NOTE: Report scheduling requires the Siebel Web Client in connected mode. For more information
about report scheduling in connected mode, see “Workflow for Generating Reports in Connected Mode”
on page 24.
Related Topics
“Scheduling Reports” on page 130
“Example of Scheduling an Opportunity Report” on page 133
“Monitoring and Viewing Scheduled Reports” on page 134
“Suspending and Resuming Scheduled Reports” on page 134
“Deleting Scheduled Reports” on page 135
Scheduling Reports
You schedule reports by selecting the Schedule Report menu item from the Reports menu while in a
Siebel application view. If you have been granted scheduling privileges, you can schedule reports
using various criteria. Report scheduling is available only in connected mode. For more information
about the connection modes in relation to Siebel Reports, see “About the Siebel Reports Architecture”
on page 23.
CAUTION: If you are unable to schedule reports, you might not have the appropriate access controls
assigned. Ask your administrator to grant you the XMLP_SCHEDULER responsibility.
NOTE: You cannot schedule parameterized reports. For information about parameterized reports,
see Chapter 11, “Parameterized Reports.”
To schedule a report
1 Navigate to the Siebel application view from which you want to schedule a report, and click
Reports.
3 Enter the schedule criteria for the report, and then click Schedule.
Field Description
Job Name Enter a name for the job you are scheduling.
NOTE: Any descriptive text for the job name is acceptable, the job name
does not have to be unique. However, for search purposes, you might
want to adopt a naming convention.
Output Type The output file format for the report. For information about the available
output file types, see “Who Can Use Siebel Reports?” on page 18.
Frequency The recurrence of the report. Choices are: Run Immediately, Run Once,
Run Daily/Weekly, or Run Monthly.
■ Only one time, you must enter the exact date and time to run the
report.
■ Daily or weekly, you must enter the day (or days) of the week, specify
the run time for the selected day (or days), and a start and end date.
■ Monthly, you must enter the month (or months), the day (or range of
days) to run, and a start and end date.
Public If checked, the output of the job is viewable by all users. By default, this
field is not checked.
Save Data If checked, the XML data of the job is saved and is viewable in the Scheduled
Reports view. By default, this field is checked.
Save Output If checked, the output of the job is saved and is viewable in the Scheduled
Reports view. By default, this field is checked.
Run Date The date and time the report generates when you choose the run once
frequency.
Run Time The time the report generates when you choose a daily/weekly or
monthly frequency.
Field Description
Start Date and If a date is set in either of these fields, then it restricts the dates for which
End Date scheduling is active. By default, the start date is the date you schedule
the report and the end date is NULL. A start and end date are required
for the daily/weekly and monthly frequencies. The default Start Date
format is based on the date format of the current user preferences.
Day(s) The day (or days) of the week or date range you want the report to
generate when you choose a daily/weekly frequency.
Month(s) The month (or months) you want the report to generate when you choose
a monthly frequency.
Date(s) The day (or days) of the week or date range you want the report to
generate when you choose a monthly frequency.
A message appears indicating the report (with Job ID) has been scheduled.
4 (Optional) If scheduling a parameterized report, enter the run-time parameters by doing the
following:
a Click Parameter.
NOTE: For this option to appear, the report developer must have indicated the report as a
parameterized report in the applicable report template registration view.
NOTE: The scheduling dialog box remains open until you close it.
a Navigate to the BI Publisher Reports screen, then the Scheduled Reports view.
NOTE: The Scheduled Reports view is an embedded Web page from the Oracle BI Publisher
Enterprise application.
b Drill down on the Job Name for more information, and then click Back if you want to view
additional scheduled reports.
Related Topics
“About Scheduled Reports” on page 129
“Example of Scheduling an Opportunity Report” on page 133
“Monitoring and Viewing Scheduled Reports” on page 134
“Suspending and Resuming Scheduled Reports” on page 134
“Deleting Scheduled Reports” on page 135
In this example, assume you want the By Sales Rep opportunity report to generate in HTML format
each Tuesday and Thursday at 10:15 a.m. for a two week period from August 2-15, 2009.
2 Run a query to limit the number of records returned, and then click Reports.
4 In the Schedule a Report dialog box, enter the following schedule criteria for the report, and then
click Schedule:
For descriptions of these and other fields in this dialog box, see “Scheduling Reports” on page 130.
5 (Optional) Navigate to the BI Publisher Reports screen, then the Scheduled Reports view to
monitor the scheduled report.
For information about monitoring and viewing your scheduled reports, see “Monitoring and
Viewing Scheduled Reports” on page 134.
Related Topics
“About Scheduled Reports” on page 129
“Scheduling Reports” on page 130
“Monitoring and Viewing Scheduled Reports” on page 134
“Suspending and Resuming Scheduled Reports” on page 134
“Deleting Scheduled Reports” on page 135
NOTE: The Scheduled Reports view is an embedded Web page from the Oracle BI Publisher
Enterprise application.
■ Click the Schedules tab to view the report jobs you have scheduled and their status. Drill
down on a report to view detailed information about the report job.
Related Topics
“About Scheduled Reports” on page 129
“Scheduling Reports” on page 130
“Example of Scheduling an Opportunity Report” on page 133
“Suspending and Resuming Scheduled Reports” on page 134
“Deleting Scheduled Reports” on page 135
NOTE: The Scheduled Reports view is an embedded Web page from the Oracle BI Publisher
Enterprise application.
3 Click the checkbox next to the applicable report, and then click Suspend or Resume.
Related Topics
“About Scheduled Reports” on page 129
“Scheduling Reports” on page 130
“Example of Scheduling an Opportunity Report” on page 133
“Monitoring and Viewing Scheduled Reports” on page 134
“Deleting Scheduled Reports” on page 135
2 Click the checkbox next to the report you want to delete, and then click Delete.
NOTE: This step removes the report from the report list; it does not remove the report from the
Oracle BI Publisher repository. Only administrators can purge Siebel reports from the Oracle BI
Publisher repository. For more information about purging scheduled reports, see “Purging
Scheduled Reports from the Oracle BI Publisher Server” on page 72.
Related Topics
“About Scheduled Reports” on page 129
“Scheduling Reports” on page 130
“Example of Scheduling an Opportunity Report” on page 133
“Monitoring and Viewing Scheduled Reports” on page 134
“Suspending and Resuming Scheduled Reports” on page 134
This chapter describes master-detail reports as well as how to create a master-detail layout
template. It includes the following topics:
■ Example of Comparing the Service Request Activity (All) Report with its Corresponding Layout
Template
Figure 10 shows an example of a Service Request Activity - All report in Siebel Service, which is a
master-detail report.
In this example, the master-detail reports provide master information for each service request,
followed by a list of activities for that service request. Each service request begins on its own page.
For further analysis of the Service Request Activity - All master-detail report, see “Example of
Comparing the Service Request Activity (All) Report with its Corresponding Layout Template” on
page 138.
A master-detail report can also have multiple detail elements. In this case, a list of detail records
appears for several business components for each master record. For example, the Account Service
Profile report provides three lists for each account master record: customer survey responses,
opportunities, and service requests. A report with two detail elements is described in “Creating a
Master-Detail Layout Template in Microsoft Word” on page 142. Many of the preconfigured reports that
ship with Siebel Business Applications are master-detail reports.
A master detail report incorporates a parent business component and related child and grandchild
business components as defined in the business object definition that the integration object is based
on. When executing a report, the UI context is captured and passed to the primary integration
component of the integration object. If a multivalue field (MVF) is included in a report, only the first
record is displayed. To display all the records from an MVF in the report, an integration object must
have been created in Siebel Tools under the associated integration object based on the business
component that contains the MVF to be displayed.
This information is also valid for indirect MVFs. For example, consider the case where the business
address (an MVF) of an account associated with an opportunity appears in the report. The business
addresses in the MVF are not directly related to the opportunity, but they are related to the account
that it is associated with it. To display all the records in the business address MVF as a detail section,
first create a link between the Business Address business component and the Opportunity business
component using Account Id as the source field. Include the Business Address business component
under the Opportunity business object, and then create an integration object with the Business
Address business component under the integration object, and include the necessary MVF. For more
information about master-detail reports, see “Example of Comparing the Service Request Activity (All)
Report with its Corresponding Layout Template” on page 138 and “Creating a Master-Detail Layout
Template in Microsoft Word” on page 142.
To compare the Service Request Activity (All) report in Siebel Service with its
corresponding layout template
1 Generate the Service Request Activity (All) report in Siebel Service by performing the tasks:
b Navigate to the Service screen, then All Service Requests across Organizations view.
c In the All Service Requests across Organizations list, select an account, click Reports, and then
from the Reports menu, select Service Request Activity (All).
The Service Request Activity (All) report appears in the browser window. To view this report,
see Figure 10 on page 137.
2 Open the layout template for the Service Request Activity (All) report using Microsoft Word:
a Navigate to the \XMLP\TEMPLATES folder (or the equivalent on your computer), and then open
srvreqaa.rtf.
Notice the following features of this template as shown in the following figure:
❏ There is a for-each loop (over all master records) that includes the parent form and all
the child lists.
NOTE: To identify the layout template associated with a report, use the appropriate
Template view (either Reports - Custom Templates or Reports - Standard Templates in the
Administration - BI Publisher Reports screen).
b From the Oracle BI Publisher menu, select Tools, Field Browser, and then Show All.
The Field Browser dialog box appears, which allows you to view and modify the template
logic.
For more information, see “Syntax and Description of the Fields for an Example Template” on page 140.
Table 8. Oracle BI Publisher Syntax and Field Definitions for the Service Request Activity (All)
Report Template
Table 8. Oracle BI Publisher Syntax and Field Definitions for the Service Request Activity (All)
Report Template
You can view additional information about the integration object definition (and related integration
components) in Siebel Tools. For information about viewing integration object definitions in Siebel
Tools, see Using Siebel Tools.
For more information about Oracle BI Publisher syntax, see Oracle Business Intelligence Publisher
Report Designer's Guide, Release 10.1.3.4 available on Oracle Technology Network (http://
www.oracle.com/technetwork/indexes/documentation/index.html). For more information about
creating master-detail templates, see “Example of Comparing the Service Request Activity (All) Report
with its Corresponding Layout Template” on page 138 and “Creating a Master-Detail Layout Template in
Microsoft Word” on page 142.
■ Make sure that all child integration components in the integration object have the appropriate
value in the Parent Integration Component property.
■ In the RTF template, make sure that the correct for-each-group and for-each:current-group
elements are placed in the template, see “Example of Comparing the Service Request Activity (All)
Report with its Corresponding Layout Template” on page 138.
■ When creating custom integration objects for Siebel Reports, make sure that the fields used for
dynamic queries in the applet of the master component are also contained in the integration
component. Dynamic queries are specific, customized queries that you create.
2 Using the Oracle BI Publisher Desktop menu, select Data, and then Load XML Data.
3 Select the XML file containing the sample data, and then save the template in RTF format.
4 Add the relevant titles, formatting, page header and footer, and so on to the document.
5 Add the Master data section by doing the following:
a Insert a master data section manually, or by using the Insert menu option from the Oracle BI
Publisher Desktop menu.
NOTE: This process embeds the for loop within the table and does not replicate the location
of the controls in the preconfigured examples.
<?for-each-group:ssServiceRequest;position()?>
c (Optional) If you want to view descriptive text for the inserted sections, click Tools, Options,
Build, and then Descriptive.
b From the Oracle BI Publisher menu, click Insert, and then Repeating Group.
7 Insert a page break after the final detail section by doing the following:
For more information on adding features, see “Example of Comparing the Service Request Activity
(All) Report with its Corresponding Layout Template” on page 138.
9 After testing the report, register the report layout template in the usual manner.
For information about registering report layout templates, see “Registering Report Layout
Templates” on page 120.
2 From the Oracle BI Publisher application-level menu, click Options, Build, and then in the For-
each form field box, select Descriptive.
For more information about master-detail reports, see “About Master-Detail Reports” on page 137 and
“Example of Comparing the Service Request Activity (All) Report with its Corresponding Layout
Template” on page 138.
■ Process of Migrating New Reports after Creating New Integration Objects on page 151
Before migrating reports from one environment to another, perform the following tasks:
1 In the source environment, make sure the reports are finalized and ready to migrate.
For more information about installing Siebel Servers, see Siebel Installation Guide for the
operating system you are using.
c Set up ADM for your particular deployment needs. In particular, you must have a Siebel
Management Server and Siebel Management Agents installed.
For more information on setting up ADM, see Siebel Installation Guide for the operating
system you are using.
To migrate XML files along with their associated SIF objects, you must specify the repository SIF
object and the XML file for packaging. After the migration of the integration objects is called, the SIF
objects and the XML files are migrated together.
1 Make sure you have met the necessary requirements for migrating reports.
For information about these requirements, see “Requirements for Migrating Reports” on page 145.
This task is a step in “Process of Packaging and Migrating Reports” on page 146.
The following procedure assumes that your reports are finalized and available in the source
environment.
SharedFolder\PackageName\file\siebsrvr\XMLP\<subdirectory_name>
where:
PackageName is the name of the ADM package folder that contains the report files to be
migrated.
SharedFolder\PackageName\file\AppServer\XMLP\DATA
SharedFolder\PackageName\file\AppServer\XMLP\TEMPLATES
SharedFolder\PackageName\file\AppServer\XMLP\enu\xliff
2 Run the following command to generate a descriptor file for the package:
where:
SharedFolder\PackageName is the shared folder and package name in which the packages to be
migrated reside.
This task is a step in “Process of Packaging and Migrating Reports” on page 146.
where:
TIP: If an error occurs, you might have an invalid path to the JAR files. To resolve this error,
make sure the CLASSPATH variable points to the exact location of the JAR files in the
admpkgr.bat file in the Management Server installation folder.
3 Run the following command to call the deploy.bat file to load the package to the server database:
where:
■ username and password are the username and password account of the Siebel user who is
deploying the package.
■ PackageName is the name of the package for which the descriptor was created in Step 2 on
page 147.
5 Run the following copy command to complete the deployment of the sample package:
6 In the destination Siebel Server folder ( siebsrvr\XMLP), verify that the files you placed in the
deployment package (as described in Step 1 on page 146) are available in the appropriate
folders.
This task is a step in “Process of Packaging and Migrating Reports” on page 146.
3 Fill in the project fields as necessary, making sure to check the Export to File field to create the
export file.
For descriptions of the projects fields, see Siebel Application Deployment Manager Guide.
NOTE: It is recommended that you name your report projects with a BIP prefix. This prefix
allows you to search for your report projects.
4 In the Deployment Filter field in the Deployment Project data type list, create search expressions
for the data types to filter only those items of a data type that match the condition for migration.
Save each filter.
For example, if you create a report in the source environment and that report is:
You enter the following filter information to migrate the data types to the target environment:
NOTE: If the data type of interest is not available, it might be set as Inactive. Make sure the
Active field for the data type is checked in the Data Type Details view.
This step allows you to query the reports being migrated to the target environment.
The Status field of the draft deployment project record appears as Draft.
ADM populates the Status field with Enabled and the Publication Date/Time field with the date
and time of the report project activation.
a Navigate to the Application Deployment Manager screen, then the Deployment Sessions view.
b Select the newly enabled report project, and make sure the Export to File and the Deployment
Lock fields are checked.
c Enter a shared location to store the XML files that contain the database records.
d Click Deploy.
The database record XML files are exported to the shared location.
2 Click the Deployment Sessions Menu button, and select Deploy from File.
3 In the Deploy from File dialog box, enter the file paths from which to migrate the database
records by doing the following:
a Enter the file path for the XML file that contains the Sample Data Generation file, and then click
Import.
b Enter the file path for the XML file that contains the Report Template Registration file, and then
click Import.
c Enter the file path for the XML file that contains the View Association file, and then click Import.
NOTE: Make sure to specify the shared location where the database records are stored.
■ \\sharedlocation\88-25ZC7_BIP_Sample_Data_Generation.xml
■ \\sharedlocation\88-25ZC7_BIP_Report_Template_Registration.xml
■ \\sharedlocation\88-25ZC7_BIP_View_Association.xml
4 In the target environment, make sure the data was migrated correctly by verifying that the
report appears in the Reports menu.
For example, in Step 4 on page 148 in the “Packaging Report Database Records in the Source
Environment” you created a report named Test Account List. To verify that report migrated
correctly, navigate to the Accounts screen, and then the Account List view. Click Reports to verify
the Test Account List report appears in the Reports menu.
NOTE: The following process assumes you have created a new integration object that has yet to be
migrated.
1 Create and export a SIF file for the integration object by doing the following:
c In the Integration Object list, right-click the integration object for which you want to create the
SIF file, and then click Add to Hot Fix.
d In the Generate Hot-Fix dialog box, enter a label, and then click Export.
2 Copy the SIF and descriptor files in the repository folder of the ADM package that was created
when you ran the admpkgr init command.
For more information about generating the command, see “Packaging the Report Files in the
Source Environment” on page 146.
3 Perform the steps as described in “Packaging the Report Files in the Source Environment” on
page 146.
NOTE: If there is no report for this integration object and there are no plans to move a report
for this integration object, you can skip Step 1 on page 146.
4 Verify that the integration object was moved to the target environment, perform the following:
b Navigate to the Administration - BI Publisher Reports screen, then the Sample Data File
Generation view.
c Make sure the integration object appears in the Sample Data File Generation list.
To migrate a new report after creating a new integration object, perform the following:
1 Perform the procedure in “Process of Migrating an Integration Object for a Report” on page 150.
2 Generate the XML data file for the report as described in “Generating Sample XML Data Files for
Siebel Reports” on page 118.
3 Copy the database record files in the related package folder along with the SIF file, and then
migrate them.
■ Narrow the query, sort specification, or grouping by a field for report execution
When scheduling a parameterized report, if a report template accepts run-time parameters, then a
Parameters option appears in the Schedule a Report dialog box. You click Parameters to enter the
parameter values from the Parameters dialog box. When you click Submit, the parameter values
entered are held in memory. You can amend the parameter values by clicking Parameters again, upon
which the parameter values you previously entered appear. To finalize the schedule report request,
click Submit again. A message appears showing that the report is scheduled, and the parameter
values entered are passed with the report request.
CAUTION: To use the Parameters option with scheduled reports, you must have installed the
appropriate Oracle BI Publisher patch level. For information about which patch to use, see 880452.1
(Article ID), Siebel Maintenance Release Guide on My Oracle Support.
Related Topics
“About Report Parameter Types and Attributes” on page 154
“About Referencing Parameters in the Report Layout Template” on page 156
“About Defining Report Parameters in the Siebel Application” on page 157
“About Report Parameter Validation” on page 158
“Process of Creating Parameterized Reports” on page 159
“Adding Scrollbars to the Parameters Dialog Box” on page 160
“Defining Report Parameters in the Siebel Application” on page 160
“Example of Generating a Parameterized Report” on page 162
Parameter
Type Behavior
Date Displays a text box where the user can enter a date value and an associated calendar
control which can be invoked using an icon. The date format is based on the user
preferences.
Parameter
Type Behavior
LOV Displays a picklist where the user selects a value from a list. You can define any
application list of values (based on Picklist Generic BC). Dynamic list of values are
not possible. An LOV must exist in the list of application list of values. The LOV
parameter type supports MLOV translation. The list of values available are those
defined in the application list of values. Hierarchical LOVs are not possible.
NOTE: The picklist name chosen from the UI determines whether it is bounded or
not. If the selected picklist is bounded, then the LOV parameter is bounded, but if
the selected picklist is not bounded, then the LOV parameter is not bounded.
Text Displays a text box where the user can enter a string value.
Number Displays a text box where the user can enter a numeric value. The number control
invokes the standard calculator widget.
DateTime Displays a text box where the user can enter a date and time value and an associated
calendar control which can be invoked using an icon. The calendar control includes
time and time zone options. The date format is based on the user preferences.
Label This parameter type is simple text that you can use as descriptive text for a section
separator. There is no control type related to this parameter.
The only applicable property for this parameter type is Display Value and the Order
attribute. All parameters of type Label align from the left when rendered in the user
interface. The longest Label property of a Label type parameter is used for the
alignment starting position. All other parameter types are then aligned relative to
the starting position.
NOTE: It is not possible to define font face, size, color, style, or alignment or wrap
the Display Value with HTML formatting codes in order to determine the run-time
appearance of labels.
TextArea Displays a text area (with small scrollbar) where the user can enter a large string
value.
Related Topics
“About Parameterized Reports” on page 153
“About Referencing Parameters in the Report Layout Template” on page 156
“About Defining Report Parameters in the Siebel Application” on page 157
“About Report Parameter Validation” on page 158
“Process of Creating Parameterized Reports” on page 159
“Adding Scrollbars to the Parameters Dialog Box” on page 160
“Defining Report Parameters in the Siebel Application” on page 160
“Example of Generating a Parameterized Report” on page 162
You use template parameters within a report layout template to dynamically change the layout of the
report using conditions based on the parameter value. Some examples are:
■ Control the sorting pattern in a table. You can select a column name for sorting.
■ Control the grouping pattern in a table. You can select a column name for the group.
■ Render data rows in different colors by defining a user-specified field (such as ACTIVE_STATUS).
TIP: To test that the parameters are passed through correctly, you can display user input directly
on the report. In this manner, you can verify Oracle BI Publisher received the correct user input, but
there is no impact on the report layout controls.
NOTE: You can also use parameters to filter data in a template, but this action is not recommended
for performance reasons. It is more efficient to filter records in the user interface using a query than
in the report layout template.
You must define template parameter definitions at the beginning of an RTF report layout template
using the following syntax:
<?param@begin: Param1>
NOTE: Default values are now defined in the user interface (in previous releases, default values were
defined in the report layout template). For more information about defining default values, see
“Defining Report Parameters in the Siebel Application” on page 160.
Related Topics
“About Parameterized Reports” on page 153
“About Report Parameter Types and Attributes” on page 154
“About Defining Report Parameters in the Siebel Application” on page 157
“About Report Parameter Validation” on page 158
“Process of Creating Parameterized Reports” on page 159
“Adding Scrollbars to the Parameters Dialog Box” on page 160
“Defining Report Parameters in the Siebel Application” on page 160
“Example of Generating a Parameterized Report” on page 162
Use the following sample syntax in the RTF report layout template to display run-time parameter
values on the report output:
Param1 = <?$Param1?>
Param2 = <?$Param2?>
Param3 = <?$Param3?>
The following bullet points provide information about parameter definitions and how to use them:
NOTE: It is recommended that you do not copy parameters using the Copy Record
functionality.
■ Make a parameter required by setting the Required field to Y. A red asterisk appears next to
the parameter at run time.
■ Define the order in which parameters appear at run time by setting values in the Order field.
Parameters must have a unique Order value. If the order values are left blank, then the
parameters appear in the user interface after any other values.
■ The parameter choices a user can select at run time is displayed as a single list. If a large number
of parameters is specified, then the list becomes too large and impedes the ability to select
values correctly, especially with smaller screen resolutions. It is possible to configure a scrollbar
to appear on the parameter applet (helpful for usability) when there are a large number of
parameters you want to display. By default, the threshold at which the scrollbar automatically
displays in the Parameters dialog box is 25 parameters. Using Siebel Tools, you can reconfigure
that value. For information about configuring the threshold, see “Adding Scrollbars to the
Parameters Dialog Box” on page 160.
■ For each data type, the appropriate validation occurs at run time to check that a user has entered
a correct value.
■ Each parameter value a user enters at run time is passed to the Oracle BI Publisher Server as
string values when the report is generated. Therefore, certain data types, such as Date, must
address the appropriate functions for the value to be recognized as an official date value. For
example, you can use the canonical date functions to convert a string value into a date value.
■ The minimum and maximum validation (date values entered within a set range) and validation
or defaults using date functions, such as Today()-7 and conditional value logic (a display of one
parameter that depends on another value) are not currently possible.
■ In the Parameter Translations list in the Templates views, you can associate a language
translation by setting a display value.
■ By default, there are a set number of parameter definition fields available in the Report
Parameters virtual business component. If you want to add more parameters of a certain data
type than already exist, then you can create more fields in the virtual business component. By
default, the number of parameter definition fields by data type that are provided are described
in the following table.
Number of Parameter
Data Type Definition Fields
LOV 10
Text 5
Text Area 5
Number 10
Date 5
Date/Time 5
Check box 10
CAUTION: Although possible, it is recommended that you do not use parameters to filter data in a
report layout template. Doing so can negatively affect performance.
Related Topics
“About Parameterized Reports” on page 153
“About Report Parameter Types and Attributes” on page 154
“About Referencing Parameters in the Report Layout Template” on page 156
“About Report Parameter Validation” on page 158
“Process of Creating Parameterized Reports” on page 159
“Adding Scrollbars to the Parameters Dialog Box” on page 160
“Defining Report Parameters in the Siebel Application” on page 160
“Example of Generating a Parameterized Report” on page 162
■ Number of parameters defined in the Siebel application equals the number of parameters defined
in the report layout template.
NOTE: Most parameter types are dynamically mapped to the Report Parameter Form Applet
business component field, however, Label parameter types are not. Additionally, Label parameter
types are ignored during validation against the report layout template.
■ Name attribute for each parameter in the Siebel application has an equivalent placeholder in the
report layout template.
For information about when to perform parameter validation, see “Defining Report Parameters in the
Siebel Application” on page 160.
Related Topics
“About Parameterized Reports” on page 153
“About Report Parameter Types and Attributes” on page 154
“About Referencing Parameters in the Report Layout Template” on page 156
“About Defining Report Parameters in the Siebel Application” on page 157
“Process of Creating Parameterized Reports” on page 159
“Adding Scrollbars to the Parameters Dialog Box” on page 160
“Defining Report Parameters in the Siebel Application” on page 160
“Example of Generating a Parameterized Report” on page 162
1 Create parameter definitions (or make sure the definitions exist) in the report layout template.
<?param@begin: Param1?>
NOTE: For this example, a parameter must also exist as a parameter definition in the Siebel
application with the Name property set to Param1 for the value of the output above to populate.
For information about parameter definitions in report layout templates, see “About Referencing
Parameters in the Report Layout Template” on page 156.
Related Topics
“About Parameterized Reports” on page 153
“About Report Parameter Types and Attributes” on page 154
“About Referencing Parameters in the Report Layout Template” on page 156
“About Defining Report Parameters in the Siebel Application” on page 157
“About Report Parameter Validation” on page 158
“Adding Scrollbars to the Parameters Dialog Box” on page 160
“Defining Report Parameters in the Siebel Application” on page 160
2 In the Object Explorer, select Applet, and then in the Object List Editor query for Report
Parameters Applet.
3 In the Object Explorer, select Applet User Prop, and then set the Display Scrollbar user property
to the threshold value that you want.
NOTE: The scrollbar appears when the number of parameters that appear in the UI is greater
than or equal to the threshold value.
The threshold is used for all parameterized reports and for all users in the application.
Related Topics
“About Parameterized Reports” on page 153
“About Report Parameter Types and Attributes” on page 154
“About Referencing Parameters in the Report Layout Template” on page 156
“About Defining Report Parameters in the Siebel Application” on page 157
“About Report Parameter Validation” on page 158
“Defining Report Parameters in the Siebel Application” on page 160
“Example of Generating a Parameterized Report” on page 162
2 From the applicable Template view, select a template, and then check the Parameters field to set
it to True.
NOTE: This flag ensures the parameter applet appears at run time. The template views you have
access to depend on the user’s responsibilities.
3 Scroll down to the Parameters list, click New, and then fill in the applicable fields.
Field Description
Label Descriptive text for the parameter. You can use this field for translations.
Name The name of the parameter. This field references the placeholder
parameter name in the report layout template.
Type The type of parameter. Choices are: Checkbox, Date, LOV, Text, Number,
DateTime, Label, and TextArea. For a description of each parameter, see
“About Report Parameter Types and Attributes” on page 154.
Default Use this field to provide the default value for the parameter. This default
value appears in the Report Parameter dialog box and is passed to the
Oracle BI Publisher Server for report generation.
Picklist Name The name of the picklist from which users choose values in the parameter
dialog box. Use this field for LOV parameter types.
NOTE: Each parameter name value you define must have a correlating parameter definition in
the report layout template. For example, if you define a parameter with the Name property as
Param1, then the definition of Param1 must appear in the report layout template.
4 If there are translations, add the following information for each language:
■ Default Value
■ Display Name
5 Click Validate to check for inconsistencies between the template definitions you defined above
and the report layout template. For more information about this feature, see “About Report
Parameter Validation” on page 158.
Related Topics
“About Parameterized Reports” on page 153
In this example, assume you have created a parameterized report and want to generate that report
in a specific format.
2 Run a query to limit the number of records returned, and then click Submit.
NOTE: If this report has parameters defined, the Siebel application retrieves the parameters
from the parameter definitions for the report template defined in the Siebel application.
4 From the parameter pop-up applet, select the parameter values for the report, and then click
Submit.
NOTE: If the report does not have a default output type defined, you must select the output file
type, and then click Submit again.
The report is generated by the Oracle BI Publisher Server, and then transferred to the Siebel
application screen. For more information about generating reports, see “Generating Reports” on
page 91.
Related Topics
“About Parameterized Reports” on page 153
“About Report Parameter Types and Attributes” on page 154
“About Referencing Parameters in the Report Layout Template” on page 156
“About Defining Report Parameters in the Siebel Application” on page 157
“About Report Parameter Validation” on page 158
“Process of Creating Parameterized Reports” on page 159
“Adding Scrollbars to the Parameters Dialog Box” on page 160
■ Enabling Logging for Siebel Reports in the Siebel Application on page 165
■ About Enabling Logging for the Oracle BI Publisher Server on page 167
■ Enabling Debugging on Oracle BI Publisher Server for Siebel Reports on page 167
■ Enabling and Disabling Debugging for Siebel Reports in Disconnected Mode on page 168
■ Guidelines for Resolving Class Not Found Errors When Previewing Reports in Microsoft Word on
page 169
■ Resolving Class Not Found Errors When Previewing Reports in Microsoft Word on page 170
NOTE: Oracle Business Intelligence Publisher (Oracle BI Publisher) for Siebel Business Applications
logs all exceptions and debug level information.
You set the log level for the XMLP Report Server component by using the Server Manager UI or the
Server Manager command-line interface program (srvrmgr program).
Setting the Log Level for the XMLP Report Server Component Using
the Server Manager UI
Use the following procedure to set the log level for the XMLP Report Server component using the
Server Manager UI.
To set the log level for the XMLP Report Server component using the Server Manager
UI
1 Navigate to the Administration-Server Configuration screen, Servers, and then the Components
view.
2 In the Component field, query for XMLP Report Server, and then click the Events view tab.
3 In Events list, query for XMLP Report Log, and then set the log level value to 5.
5 In the Component field, query for your AOM (Application Object Manager), for example, Call
Center Object Manager (ENU), and then click the Events tab.
6 In the Events list, query for XMLP Report Log, and then set the log level value to 5.
7 Stop and restart the XMLP Report Server and AOM server components.
For more information about restarting the Siebel Server, see Siebel System Administration Guide.
Setting the Log Level for the XMLP Report Server Component Using
Server Manager
Use the following procedure to set the log level for the XMLP Report Server component using Server
Manager (srvrmgr).
To set the log level for the XMLP Report Server component using Server Manager
1 Run the following command to connect to the Siebel Server Manager:
where:
gateway machine name:port number is the name of the physical computer on which the Siebel
Gateway Name Server is running and the port number on which the Gateway Name Server is
listening.
NOTE: The colon and port number are optional if using an optional default port.
xmlp siebel server name is the name of the server on which the XMLP Report Server component
is enabled.
For example, to get details for a call to a business service, run the following command:
3 Shut down the XMLP Report Server component and then restart this component to make sure
logging changes take effect.
NOTE: This debugging is in addition to the usual debugging capabilities available in Siebel Business
Applications.
2 Click the Admin tab, and then Server Configuration under System Maintenance.
3 Change the Debug Level value from Exception to Debug, and then click Apply.
4 In a text editor, such as Notepad, create a new file entitled xdodebug.cfg, and then type in the
following for use as a sample file:
LogLevel=log_level
LogDir=logging_directory_path
ORACLE_HOME\oc4j_b\jdk\jre\lib directory
where:
LogLevel=STATEMENT
2 Place the file in the jre\lib directory used by the Siebel client (for example, C:\Program
Files\Java\jre1.6.0_07\lib) and make sure that the directory specified by the LogDir
parameter exists. The resulting log files from the report generation will be created at this
location.
If an error occurs while generating reports in disconnected mode, an xdo.log file is created and saved
to the path specified in the .cfg file. Use this log file for troubleshooting.
2 Remove or rename the xdo.cfg in the jre\lib directory used by the Siebel client.
■ Make sure there are no spaces or new line character after the -Xbootclasspath/a: string. For
example, this string might appear as follows:
set_JAVA_OPTIONS=-Xbootclasspath/a:C:\81DQSSIA\client\classes…
■ To check the syntax, turn off word wrapping in the editor you are using so that
set_JAVA_OPTIONS is a single line. You must have three distinct lines in your batch file if word
wrapping is turned off.
■ Check the path to Microsoft Word that the batch file references.
■ The %1 in the batch file is an argument to represent a document that is typically opened in
Microsoft Word (RTF files).
■ Do not use set _JAVA_OPTIONS as a system environment variable because this prevents you from
previewing reports in the Siebel client.
For instructions for resolving, see Resolving Class Not Found Errors When Previewing Reports in
Microsoft Word on page 170.
NOTE: In your batch file, replace the explicit drive and folder locations with those on your own
computer based on where you installed the Siebel Web Client. It is not necessary to associate .doc
extensions with this batch file.
To resolve class not found errors when previewing reports in Microsoft Word
1 Navigate to C:\Program Files.
2 Create a MSWordForBIPub.bat file containing the following code to set the _JAVA_OPTIONS
environment variable before launching Microsoft Word.
echo %1
set _JAVA_OPTIONS=-Xbootclasspath/a:
C:\81DQSSIA\client\classes\SiebelXMLP.jar;C:\81DQSSIA\client\
classes\siebel.jar;C:\81DQSSIA\client\classes\XSLFunctions.jar;C:\81DQSSIA\
client\classes\SiebelCustomXMLP.jar;C:\81DQSSIA\client\classes\SiebelCustomXMLP
_SIA.jar
TIP: Create a shortcut to the MSWordForBIPub.bat batch file and move it to your desktop.
3 If you want to make sure this batch file is always executed when opening a preconfigured report
layout template, you associate the RTF files with the .bat file by doing the following:
a Navigate to the template files in your Siebel client environment. (For example,
C:\Siebel\client\XMLP\TEMPLATES)
c Right-click on a RTF file (or select all) and Select Open With to choose an text editor.
d Click Browse to find the .bat file, and then open it.
e Check the Always use the selected program to open this kind of file checkbox, and then click OK.
This associates the selected RTF file or files with the batch file created in Step 2 on page 170.
The batch file sets an environment variable needed for publishing Oracle BI Publisher reports
from within Microsoft Word.
NOTE: This workaround automatically associates the RTF file with the batch file. Now, when you
double-click a RTF file, you see a command prompt window (running the batch file) automatically
run at the same time. Alternatively, you can go to the desktop shortcut icon and run the shortcut
to the .bat file to test the report preview.
Connection
Error Message or Symptom Description and Solution Mode
SBL-OMS-00203: Error <?> invoking This error occurs when you fail to upload the Connected
method "<?>" for Business Service template to the Oracle BI Publisher Server. and
"<?>" disconnected
To resolve, see “Troubleshooting Errors While
Running Siebel Reports (SBL-OMS-00203)”
on page 176.
"Unable to find definition for This error occurs after clicking Submit to Connected
component XMLPReportServer(SBL- generate a report. and
SRQ-00103)" error when I clicked on disconnected
To resolve, see “Troubleshooting Error After
the Submit button to generate the
Clicking Submit to Generate a Report (SBL-
report."
SRQ-00103)” on page 176.
The specialized method 'GetFileToDir' This error occurs when the path settings in Connected
is not supported on Business the configuration files are incorrect. and
Component 'Report Template BC' disconnected
To resolve, see “Troubleshooting Errors That
used by Business Object 'Report
Occur Due to Incorrect Configuration File
Administration'.
Settings (SBL-DAT-00322)” on page 176.
(SBL-DAT-00322)
Connection
Error Message or Symptom Description and Solution Mode
SBL-RPT-50504: Error occurred while This error occurs when users forget to Disconnected
saving the record. No data file provide a sample XML data file for only
provided for XLIFF generation. generating an XLIFF file.
"Class name incorrect" error when This error occurs when Oracle BI Publisher Disconnected
generating BI Publisher reports or the JAR files are not loaded. only
$OC4J_PATH\j2ee\home\applications\
xmlpserver\xmlpserver\WEB-INF\lib
■ SiebelCustomXMLP_SIA.jar
■ SiebelXMLP.jar
SBL-EAI-04116 BIP: Server This error might occur if the report Connected
connection is lost generation has extended the HTTP Sleep only
Time, typically only for very large or
complex reports.
Connection
Error Message or Symptom Description and Solution Mode
Verify the BIP Server Userid and This error message appears in the XMLP log Connected
Password. (SBL-RPT-50529) or file, because the user has not provided the only
correct User ID and password for the Oracle
Failed to log into BI Publisher: invalid
BI Publisher Server in the XMLP Report
username or password.
Server component parameters.
PublicReportService::executeCreate Make sure that the report name does not Connected
Report Failure: due to Report Name contain the following special characters: only
contains special characters for report
■ Forward slash (/)
■ Backslash (\)
■ Tilde (~)
■ Ampersand (&)
■ Asterisk (*)
Connection
Error Message or Symptom Description and Solution Mode
SBL-EAI-04308: Operation This error occurs when you execute a report Connected
'runReport' of Web Service 'http:// that has missing bits on the Oracle BI only
xmlns.oracle.com/oxp/service/ Publisher Server (such as the .xdo file).
PublicReportService.PublicReportSer
To resolve, upload the layout template from
viceService' at port
Oracle BI Publisher using the Report
'PublicReportService' failed with the
Template Registration view. For more
following explanation:
information about uploading layout
"oracle.apps.xdo.webservice.
templates, see “Registering Report Layout
exception.OperationFailedException:
Templates” on page 120.
PublicReportService::
generateReport failed: due to
oracle.apps.xdo.servlet.
CreateException: Report definition
not found:/SiebelCRMReports/
<Report Name>/<Report
Name>.xdo".
Alignment issues with columns with The problem occurs when the table header Connected
HTML file output type row and the data row are composed of two and
different tables with no space between disconnected
them. HTML, and sometimes EXCEL, might
generate output with alignment issues.
Alignment issue with JPN/PSJ The PPT output type for Japanese (JPN) is Connected
environment in the reports. distorted in generated reports. Create the only
font mappings for the Oracle BI Publisher
Server to make sure that the HTML output
appears correctly.
Connection
Error Message or Symptom Description and Solution Mode
SBL-EAI-05010: Class name This error occurs while uploading files to Not
incorrect or does not extend Oracle BI Publisher. applicable
SiebelBusinessService : com/siebel/
To resolve, verify the following:
data/SiebelPropertySet -- JVM
Exception:java.lang.NoClassDefFoun ■ JAVA_HOME variable is set correctly.
dError: com/siebel/data/
SiebelPropertySetObjMgrBusService ■ The following JAR files (Siebel.JAR,
Log SiebelXMLP.JAR, XSLFunctions.JAR,
SiebelCustomXMLP.JAR, and
Object manager error: ([0] Class SiebelCustomXMLP_SIA.JAR) are copied
name incorrect or does not extend from the following directory:
SiebelBusinessService : <?>
siebelroot\classes\original
Then make sure they are copied to the
following directory:
ORACLE_HOME\j2ee\home\
applications\xmlpserver\xmlpserve\
WEB-INF\lib
ORACLE_HOME\xmlp\XMLP\Reports\
SiebelCRMReports
2 Increase the XMLP Report Server component log level to 5 to create a more detailed log file.
For information about performing these tasks, see “Enabling Logging for Siebel Reports in the
Siebel Application” on page 165 and “Enabling and Disabling Debugging for Siebel Reports in
Disconnected Mode” on page 168.
Additionally, you might encounter an instance where a layout template was registered with one
database, but you generated it with a different database, and the generation fails. If this error
happens, you must complete the following task.
For information about enabling this component, see Siebel System Administration Guide.
For information about restarting the Siebel Server, see Siebel System Administration Guide.
a Navigate to the Administration - Server Configuration screen, Servers, and then the Components
view.
b Query for the Callcenter Object Manager (or other application specific Object Manager, like Siebel
Sales or Siebel Service).
c Click the Parameters view tab, and then query for FileSystemManager, and then click Advanced.
e Make sure that the fs directory exists in the D: drive and also that it is shared.
2 Restart the Siebel Server.
5 Verify that all the required JAR files are included and available in the CLASSPATH.
6 Verify that the CLASSPATH separator is in the correct format for Windows or UNIX.
In UNIX, the CLASSPATH separator is a colon (:). In Windows, the CLASSPATH separator is a
semicolon (;).
2 In the [XMLPReports] section of the .cfg file, make sure this section is defined as follows:
[XMLPReports]
XdoDir = /xmlp/templates/
ReportOutputDir = /xmlp/reports/
ReportDataDir = /xmlp/data/
3 To check whether the file system path is set properly, try to register the template.
If registering the template is successful, you can drill down on the generated XLIFF file. If either
browsing the template fails or the drilldown fails, this means that the file system path is not set
appropriately.
2 Select the integration object associated with the report, and then click Generate Sample XML.
For information on how to start and use the srvrmgr program, see Siebel System Administration
Guide.
2 Click the Component view tab, and query for XMLP Report Server.
3 Click the Parameters view tab, query for BIP Server Login, and then enter (or verify) the correct
login information for the Oracle BI Publisher Server.
4 While still in the Parameters view tab, query for the BIP Server Password, and then enter (or
verify) the correct password for the Oracle BI Publisher Server.
2 Copy the Form fields from the data row in the added row.
The single table now contains both header and data row.
\Java\jdk\jre\lib\fonts
2 Restart OC4J (Oracle Application Server Containers for Java Platform, Enterprise Edition).
This appendix is intended for Siebel configurators. It consists of the following topics:
Using the Report Business Service business service methods, administrators can generate, share,
and print reports automatically without user interaction. Because reports are automatically
generated when certain business rules are satisfied, there is no way for the user to pass a query.
Therefore, the view mode applied on the report executable is used for obtaining data.
Siebel Business Process Designer, an interactive software tool, lets you automate how your
organization handles workflow processes. For more information about Siebel Business Process
Designer and workflow processes, see Siebel Business Process Framework: Workflow Guide.
NOTE: Currently, the Report Business Service business service methods are supported only on run-
time events. Therefore, a user must be logged on to trigger an event that will invoke these methods.
Knowledge of Siebel Tools, scripting, Siebel Business Process Designer, and the Oracle BI Publisher
Server is necessary to use the Report Business Service report business service methods. Having an
understanding of running the business services is also necessary. Administrators can create as many
workflow processes as needed to satisfy their business requirements and include the necessary
report business service methods as steps (recall that workflow processes can include one or more
business services as steps). The report designers can test these workflow processes in the Business
Process simulator. For more information about workflow processes and the Business Process
simulator, see Siebel Business Process Framework: Workflow Guide.
NOTE: The Reports Business Service report business service methods are executed only in the Siebel
Web Client.
For detailed information about using the Report Business Service and its methods, see 823360.1
(Article ID) on My Oracle Support.
A Transformation
administering reports 67 See XSLT
Extensible Stylesheet Language-Formatting
Objects
C See XSL-FO
copying JAR files to the Oracle BI Publisher
Server 42
custom reports G
creating new integration objects for 116 generating reports 95
creating, process of 112 about 91
extending integration objects for Siebel diagram of 95
Reports 115 example of 97
process of creating, diagram of 113 for selected records, about 93
monitoring the status of 97
scenario for 92
D workflow for connected mode 24
debugging workflow for generating in disconnected
disabling for Siebel Reports in disconnected mode 25
mode 169
enabling for Siebel Reports in disconnected
mode 168 I
enabling on Oracle BI Publisher for Siebel integrating Oracle BI Publisher with Siebel
Reports 167 Business Applications
deleting scheduled reports 135 guidelines for 34
deploying reports to the Siebel Web Client preparation tasks for 38
from a disconnected client 68 process of installing and configuring Oracle BI
description of 109 Publisher 39
directory structure for Siebel Reports roadmap for 35
DATA directory, described 27 roadmap for, diagram of 36
FONTS directory, described 27 integration objects for Siebel Reports
REPORTS, directory described 27 creating new 116
TEMPLATES directory, described 27 extending to add new fields to a report 115
xliff directory, described 27 reducting the size of, about 89
disabling external file references for the
Oracle BI Publisher Server 43 J
documentation, where to find previous JAR files for the Oracle BI Publisher Server,
versions of Siebel Reports 34 adding an explicit reference to 57
E L
enabling and configuring report scheduling, locales
process of 60 adding to report layout templates 80
error messages, troubleshooting for deleting from report layout templates 80
reports 171 logging for Siebel Reports
Extensible Markup Language enabling logging for in the Siebel
See XML application 165
Extensible Stylesheet Language setting log levels for using the GUI 165
See XSL setting log levels for using the Server Manager
Extensible Stylesheet Language (srvrmgr) 166