Beruflich Dokumente
Kultur Dokumente
Overview
In Version 7.1, an IBM Report Integration is available to the SAP Business Objects XI Product
Suite (BO) . The integration enables users to see and execute BO reports within the V7.1 instance.
This document will detail the various components of the V7.1 BO Integration including
1. Overview of Business Objects XI Product Suite
2. Licensing
3. Accessing Reports
4. Integrating V7.1 to work with Business Objects
5. Adding Reports to Central Management Console
6. Registering Reports to V7.1 Report Administration Application
7. Report Parameters
8. Developing V7.1 Reports
9. Enabling Sub Reports for V7.1 Integration
10. Upgrading from Previous Versions
11. Integration Properties
Notes:
A. Crystal Reports XI is also required for report design.
B. An application server separate from the V7.1 application server is required. The integration
component runs as a web application on this server, as do several Business Objects applications. The
BO Enterprise Server includes an optional install of Tomcat. It is recommended that Tomcat be used
for the integration.
C. For best performance, IBM recommends that your configuration contains the following dedicated
servers:
D. When you integrate V7.1 to run with BO, you are responsible for using products that BO and V7.1
support. The specific product platforms that BO runs on can vary from those of Version 7.1.
1. Licensing
IBM does not provide you with any Business Objects or Crystal licenses and does not support any
specific Business Objects or Crystal issues. You must purchase and maintain your Crystal license
separately with Business Objects.
IBM developed this V7.1 integration using a Processor based license. Therefore, all BO reports that
you run through this integration execute against a single, name user account. Optional Crystal
Licenses are available, including Named User Licenses. If you encounter any integration licensing
conflicts, you must resolve the issue separately with Business Objects.
2. A listing of available BO Reports will then be visible in the On Demand Reports subtab of the
Reporting Window.
3. Once the user submits his report request, the BO Report will be displayed in a separate BO
browser session.
4. The integration enables BO Reports that use either the Current/Selected Record Set or
Bound Parameters.
5. For the V7.1 Release, three Out of the Box reports will be delivered. These are
a. Job Plan List Report, jobplan.rpt
b. PO List Report, po.rpt and
c. PO Details report, poprint.rpt
These reports are located in <V7.1>\applications\bocrystal\reports
V7.1 BO Job Plan List report displayed in BO Browser
Contents
JSP files including error.jsp, interactiveViewer.jsp,
runBOCrystalReport.jsp, and utilities.jsp
Folder you use to copy files from your Business Objects Enterprise
Application
Information about Manifest and Apache Software Versions
V7.1 Error messages you may see when using Crystal
Sample Job Plan List Report
web.xml and class files
NOTE: To enable the integration, you must edit the properties in the System Properties application
to successfully complete this integration. Information on these property files are contained at the
end of this document.
To integrate V7.1 to work with BO, complete the following sections in order.
A. Copy BusinessObjects Enterprise server files to the V7.1 Application Server
B. Build bocrystal.war
C. Deploy bocrystal.war
A. Copy Business Objects Enterprise Server files to the V7.1 Application Server
1.
B. Build bocrystal.war
1. On the V7.1 Application server, open a command prompt.
2. Change the directory to the following location
<V7.1>\maximo\deployment
3. Type buildbocrystalwar.cmd and press Enter. After V7.1 successfully completes the command,
close the command prompt window.
C. Deploy bocrystal.war
The bocrystal.war file needs to be deployed on the Business Objects Enterprise Application
server. To deploy the file, consult the application server documentation. The bocrystal.war file
resides in the following location:
<V7.1>\maximo\deployment\default
Note: If you update your BusinessObjects Enterprise server, you must repeat the steps
described in this chapter so that the server and the bocrystal.war file remain at the same
revision level.
10
2. On the CMC home page, click Folders to open your report folder structure.
Example
rpt
JOBPLAN
Reports
Job Plan Crystal Report 1.rpt
Job Plan Crystal Report 2.rpt
LABOR
Reports
SECURGROUP
Reports
11
<V7.1>\Applications\bocrystal\reports
Click Update to save your updated report title to the Central Management Console.
12
By setting the Edit Objects option to explicitly granted, you are providing the minimum level
of rights required for the V7.1 Integration with BO. You should determine if any additional
rights need to be granted to your users.
The following instructions explain how to set security privileges in the CMC for user MXES.
1. Log on to the CMC as the Administrator. The CMC Home Page appears. To open the Top Level
Folders dialog box, click Folders.
13
3. Click the Rights subtab. For existing user MXES, go to the Access Level dialog box and select View
on Demand. To add rights for a new user, create that user and return to this subtab.
6. Change the Edit Objects option from Not Specified to Explicitly Granted. To accept this change
and refresh the page, click Apply.
7. To return to the Rights sub tab, click OK.
14
15
To set report security at the report level, access the report in Report Admin. Click on the Security
Tab, and add the Security Group(s) who can run that specific report. Only those Security Groups who
have Run Report Security Group Access to the Application will be available for selection.
16
To set report security at the application level (meaning the group can see ALL reports registered to
that specific application), access Report Admin. From the Action Menu, click Set Application
Security. Select the Application, and then choose the Security Group(s) who should have access.
Additionally, you can grant report app security to all Report Types, or to specific report types like
Crystal or Custom.
NOTE: Setting Report Security for All Reports is enabled via similar functionality.
17
7. Report Parameters
BO Reports in the V7.1 Integration can use two types of parameters. The first is the
Current/Selected Record Set and the second is Bound Parameters.
Unbound parameters those that do not have relationships with the V7.1 database are not supported
for the BO Integration. More information on these types of parameters is detailed below.
Description
Unique Characteristics
Current/Selected
Record Set
Bound User
Inputted Parameter
18
More details on Bound versus Unbound parameters are contained in the chart below.
Bound
Unbound
Parameter Name
Can be - but does not have to be - defined in Must be defined in report's design
report's design file
file
Attribute Name
ALWAYS Populated
NEVER Populated
Lookup Name
Optional
NEVER Populated
Multi-Lookup
Enabled?
Yes or No
Yes or No
Display Sequence
Numeric Value
Numeric Value
Override Label
Any Text
Any Text
Default Value
Required?
Yes or No
Yes or No
19
20
2. Click Blank Report to open your database in the Database Expert dialog box.
Note: Oracle reports use an Oracle connection, while DB2 and SQL Server reports use an
ODBC connection.
21
22
3. Double-click Add Command (below the server name) to open the Add Command to Report dialog
box.
Note: As noted earlier in this section, you must use the Command Table editor for this integration.
You cannot create reports by selecting individual tables to include in your BO report.
23
4. A blank dialog will display in the Add Command to Report Dialog. For this example, type the
following SQL query in the Enter SQL query in the box below field.
select po.ponum,po.description,po.vendor,
companies. name,
po.requireddate, po.vendeliverydate,
po.purchaseagent,
po.status,po.mnetsent
from po, companies,
where po.orgid = companies.orgid
and po.vendor = companies.company
24
5. In the next steps, you will define a parameter required for this integration. To do this, open the
Command Parameter dialog box, and click Create
6. In the Parameter Name field, type where as shown below.
7. Click OK to return to the Add Command to Report dialog box.
25
8. Place your cursor at the end of the SQL query. Type and (as shown), then double click where in
the Parameter List dialog box to place the parameter at the end of the SQL query.
After completing this step, your SQL query statement should look like
statement in the following figure.
Note: If your original SQL statement does not include a where clause, you must insert the
where parameter at the end of the statement as shown in the example below.
select po.ponum, po.description, po.vendor, po.requireddate,
po.vendeliverydate, po.purhcaseagent, po.status, po.mnetsent from po
where (?where)
26
Note: If you use an Oracle database, as in this example, you must also add a schema parameter
before each table name. To do this, follow steps A thru H below.
A. Click Create, to open the Command Parameter dialog box. click Create.
B. In the Parameter Name field, type SCHEMA.
C. To return to the Add Command to Report dialog box, click OK.
D. Place your cursor before each table name (po and companies) on the From line and double-click the
schema parameter in the Parameter List to add it to the SQL query.
E. Add a period (.) between the schema parameter and each table name
After completing this step, your SQL query statement should look like the SQL query statement
below.
F. Click OK to open the Enter Values dialog box. Enter values for each of the parameters in the
Parameter list.
1 In the Schema field, enter the owner of the database schema
2 In the Where field, type 1=1.
G. To accept these values, click OK. BO reopens the Database Expert dialog box.
H. To return to the report, click OK
27
28
9. To open a list of database fields selected for your report (as determined by your SQL statement),
select View> Field Explorer.
10.
Drag database fields from Field Explorer to the Details section of your report. As you do so,
each field appears in the Page Header section.
29
12. Edit the report as needed. To save your report, select File> Save.
30
31
3 Open the Subreport Links dialog box in the Purchase Order Details Report to connect the
new subschema parameter to the schema in the main report.
Note In the Subreport parameter field to use drop-down list, you must select the
subSchema parameter.
32
2.
You do not need to upgrade the BusinessObjects application server. However, you must
configure the application server to use Java 1.5. If you are using Tomcat, there are instructions on
how to do this in the BusinessObjects Enterprise XI Release 2 Installation Guide, in Appendix B,
"Deploying on Tomcat with the JDK 1.5".
3.
Copy the new BusinessObjects files to your application server as described in Section 4 of
this document, and rebuild bocrystal.war.
33
mxe.report.bo.db.databaseName
(SQL Server and DB2 only)
mxe.report.bo.serverURL
mxe.report.bo.rootFolder
mxe.report.bo.rptServerLogonName
mxe.report.bo.rptServerLogonPass
mxe.report.bo.cmsName
Description
The V7.1 database connection string (Oracle) or ODBC DSN
(SQL Server and DB2) defined on the BusinessObjects
Enterprise server.
The database name for the V7.1 database.
The URL of the BusinessObjects Enterprise server, including
port number and folder. V7.1 uses this URL to access the
bocrystal.war Web application.
Example: http://BOSERVER:8080/bocrystal
The BusinessObjects Enterprise root folder name. This should
be rpt unless you used another value in step 3 under Adding
Reports to Central Management Console above.
The BusinessObjects Enterprise logon name. This user must
have specific rights to any report you will access from Maximo.
See Setting Security Privileges in this document.
The BusinessObjects Enterprise password.
Unless you changed the name of the Central Management
Server (CMS) when you installed BusinessObjects Enterprise,
this property is the name of the server where you installed
BusinessObjects Enterprise and the server port number,
separated by a colon. To verify the correct values, open the
CMC Logon page and check the System field.
Example: BOSERVER:6400.
34
35
Additional References
The following lists additional references available at the time this guide was prepared. To locate
these documents, perform a search on IBMs Support Site on the report title highlighted below, or on
its support reference number directly next to the title.
IBMs support site can be found at this url:
http://www-947.ibm.com/support/entry/portal/Overview/Software/Tivoli/Maximo_Asset_Management
Additionally, the url's below are available with the additional information including blogs,
forums and a wiki site
https://www.ibm.com/developerworks/servicemanagement/am/index.html
https://www.ibm.com/developerworks/wikis/display/maximo/Home
36
Title
V7 Report Feature Guide
Reference Number
1305020
V7 Report Booklet
1305005
141.417 (7.1.1.6+)
136800 (Pre 7.1.1.6)
Designing V7 Reports
1305009
1421371
V7 Report Performance
1305031
1304936
1390372 (7.1.1.5+)
1315837 (Pre 7.1.1.5)
1447958
1438532
Description
Details how the embedded report engine is utilized, including
a review of the file structure, installation and database
structure. Includes information on Security, Scheduling,
Administration, Queuing, and Property Files.
Contains listings, file names, descriptions, details on
parameters, formatting (grouping, sorting) and a pdf copy of
each of the OOB (Out of the Box) Delivered Reports.
Details how users can Create and Execute Ad Hoc Reports,
and the Administrative setup work involved in enabling Ad
Hoc Reports, including security features and creating Report
Object Structures.
Clients often require custom reports to communicate their
individual business needs. This reviews the data analysis
options available, including KPIs, Application List Downloads,
QBR and Reports. Details report templates available,
parameter options and a variety of items to consider when
designing reports
Reviews each of the data analysis options available in V7,
including a detailed review of each report option.
Details various administration and configuration
recommendations to optimize report performance. This
includes BIRT Report Only Server (BROS) Configurations,
along with Clustering.
Describes additional ways of configuring your database for
reporting, including enabling (1) All reports to execute
against a reporting database or (2) A portion of the reports
to execute against the reporting database.
37
Report Logging
1423974
1433106
1370440
1304925
1317577
Misc Guides
Upgrading to BIRT 232 in V7
1390274
1304923
1403958
Business Objects/Crystal
Report Integration Guide
1421365
1421312
1303812
38
1304916
39
2. Input the reference number or the document title from the charts below
3. This leads to the page below. Find the specific guide from the list and click on it.
*Note: Many of the report documents have a key in front of them. This indicates that you must
first sign in to IBM support before downloading.
40
4. After clicking on the name, it brings you to the IBM support log in page. Sign in with your
username and password. If you do not have an IBM support username and password, click on the
register now link highlighted by the top arrow.
5. After you have signed in, you will be brought to the page where the document can be downloaded.
41
Revision History
Revision 2 Updated Reference Documents, Updated References to 7.1x
Revision 1 February 2011 - Updates include (1) Addition of Overview Section (2) Reordering of
sections
42
Notices
This information was developed for products and services offered in the U.S.A.
IBM may not offer the products, services, or features discussed in this document in other countries. Consult your local
IBM representative for information on the products and services currently available in your area. Any reference to an
IBM product, program, or service is not intended to state or imply that only that IBM product, program, or service may
be used. Any functionally equivalent product, program, or service that does not infringe any IBM intellectual property
right may be used instead. However, it is the user's responsibility to evaluate and verify the operation of any non-IBM
product, program, or service.
IBM may have patents or pending patent applications covering subject matter described in this document. The
furnishing of this document does not grant you any license to these patents. You can send license inquiries, in writing,
to:
IBM Director of Licensing
IBM Corporation
North Castle Drive
Armonk, NY 10504-1785
U.S.A.
The following paragraph does not apply to the United Kingdom or any other country where such provisions are
inconsistent with local law: INTERNATIONAL BUSINESS MACHINES CORPORATION PROVIDES THIS
PUBLICATION "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED,
INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF NON-INFRINGEMENT,
MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. Some states do not allow disclaimer of
express or implied warranties in certain transactions, therefore, this statement may not apply to you.
This information could include technical inaccuracies or typographical errors. Changes are periodically made to the
information herein; these changes will be incorporated in new editions of the publication. IBM may make
improvements and/or changes in the product(s) and/or the program(s) described in this publication at any time without
notice.
Any references in this information to non-IBM Web sites are provided for convenience only and do not in any manner
serve as an endorsement of those Web sites. The materials at those Web sites are not part of the materials for this IBM
product and use of those Web sites is at your own risk.
IBM may use or distribute any of the information you supply in any way it believes appropriate without incurring any
obligation to you.
Information concerning non-IBM products was obtained from the suppliers of those products, their published
announcements or other publicly available sources. IBM has not tested those products and cannot confirm the accuracy
of performance, compatibility or any other claims related to non-IBM products. Questions on the capabilities of nonIBM products should be addressed to the suppliers of those products.
This information contains examples of data and reports used in daily business operations. To illustrate them as
completely as possible, the examples include the names of individuals, companies, brands, and products. All of these
names are fictitious and any similarity to the names and addresses used by an actual business enterprise is entirely
coincidental.
Trademarks
IBM, the IBM logo, and ibm.com are trademarks or registered trademarks of International Business Machines Corp.,
registered in many jurisdictions worldwide. Other product and service names might be trademarks of IBM or other
43
companies. A current list of IBM trademarks is available on the Web at Copyright and trademark information at
www.ibm.com/legal/copytrade.shtml.
Microsoft, Windows, Windows NT, and the Windows logo are trademarks of Microsoft Corporation in the United
States, other countries, or both
44