Installation, Configuration and Deployment Guide

Installation, Configuration and Deployment Guide
■ SAP BusinessObjects Mobile for iPad 4.0.3
2011-12-21
Copyright
© 2011 SAP AG. All rights reserved.SAP, R/3, SAP NetWeaver, Duet, PartnerEdge, ByDesign, SAP
BusinessObjects Explorer, StreamWork, and other SAP products and services mentioned herein as
well as their respective logos are trademarks or registered trademarks of SAP AG in Germany and
other countries.Business Objects and the Business Objects logo, BusinessObjects, Crystal Reports,
Crystal Decisions, Web Intelligence, Xcelsius, and other Business Objects products and services
mentioned herein as well as their respective logos are trademarks or registered trademarks of Business
Objects Software Ltd. Business Objects is an SAP company.Sybase and Adaptive Server, iAnywhere,
Sybase 365, SQL Anywhere, and other Sybase products and services mentioned herein as well as
their respective logos are trademarks or registered trademarks of Sybase, Inc. Sybase is an SAP
company. All other product and service names mentioned are the trademarks of their respective
companies. Data contained in this document serves informational purposes only. National product
specifications may vary.These materials are subject to change without notice. These materials are
provided by SAP AG and its affiliated companies ("SAP Group") for informational purposes only,
without representation or warranty of any kind, and SAP Group shall not be liable for errors or
omissions with respect to the materials. The only warranties for SAP Group products and services
are those that are set forth in the express warranty statements accompanying such products and
services, if any. Nothing herein should be construed as constituting an additional warranty.
2011-12-21
Contents
3
Chapter 1
About this Guide.....................................................................................................................5
1.1
1.2
Overview..................................................................................................................................5
Chapter 2
What's New?...........................................................................................................................7
Chapter 3
Solution Overview...................................................................................................................9
3.1
3.2
3.3
3.3.1
SAP BusinessObjects Mobile Client........................................................................................9
Chapter 4
Installing the Required Components.....................................................................................13
4.1
4.2
4.2.1
4.3
Installing SAP BusinessObjects Mobile on iPad.....................................................................13
Chapter 5
Creating an SAP BI URL.......................................................................................................15
Chapter 6
Defining the Log Level..........................................................................................................17
Chapter 7
Embedded Images in Reports...............................................................................................19
Chapter 8
Layout Predictability of Report Parts on an iPad .................................................................21
Chapter 9
Configuring the Blank Cells of a Report for Viewing on an iPad..........................................25
9.1
9.2
9.3
Configuring Blank Cells in XI 3.1 Web Intelligence Reports....................................................25
Target Audience.......................................................................................................................5
SAP BusinessObjects Mobile Server.......................................................................................9
SAP BusinessObjects Business Intelligence(BI) Platform Server...........................................10
Supported Versions of Business Intelligence Platform and the Mobile Server........................10
Installing the SAP BusinessObjects Mobile Server.................................................................13
Configuring Categories for iPad.............................................................................................14
Installing the SAP BusinessObjects BI Platform Server..........................................................14
Configuring Blank Cells in 4.0 Interactive Analysis Reports....................................................26
Example of Blank Cell Configuration.......................................................................................27
2011-12-21
Contents
Chapter 10
Creating Scorecards for Report Tables on an iPad...............................................................31
10.1
Examples of Scorecards.........................................................................................................34
Chapter 11
Linking a Document to Other Web Intelligence Documents on the BI Platform..................37
Chapter 12
Constraints on Report Parts on the iPad...............................................................................39
Appendix A
More Information...................................................................................................................43
Index
4
45
2011-12-21
About this Guide
About this Guide
1.1 Overview
This guide provides information about SAP BusinessObjects Mobile features and technology. It includes
information about:
• Solution overview and the various components
• How to install the required components
• Security aspects that you should know
• Defining the log level
• Overview of the layout prediction model for report parts that is provided by the Mobile for iPad
software
• Required configuration settings for viewing blank cells of a Web Intelligence report on an iPad
• Creating Scorecards of reports and related examples
• Constraints of report tables on an iPad
• How to create an SAP BI custom URL (for allowing a user to establish direct connection between
the client application and mobile server)
Related Topics
• Solution Overview
• Defining the Log Level
• Configuring the Blank Cells of a Report for Viewing on an iPad
• Creating Scorecards for Report Tables on an iPad
• Constraints on Report Parts on the iPad
• Creating an SAP BI URL
1.2 Target Audience
This guide is designed to help the following types of users:
•
•
5
IT administrators who install and configure the Mobile server.
Business Intelligence administrators who:
2011-12-21
About this Guide
•
•
•
•
6
Plan how business intelligence (BI) data and applications are deployed and managed enterprise
wide.
Manage BI Web Intelligence documents.
Design Web Intelligence documents for viewing on the iPad.
IT security managers who:
• Guarantee that business intelligence data communicated through the Internet and wireless
networks remains secure.
• Manage Mobile client access and the security policy of the Mobile server.
2011-12-21
What's New?
What's New?
1. SAP BusinessObjects Mobile for iPad 4.0.3 application is supported on an increased number of the
BI platform server release-versions. For information on this, refer to Supported Versions of Business
Intelligence Platform and the Mobile Server
2. The OpenDocument URL now supports the sDocName parameter. The document name can have
trailing spaces. For more information on the supported parameters of OpenDoc URL, refer to Linking
a Document to Other Web Intelligence Documents on the BI Platform
3. The report parts such as tables, charts and graphs have a different set of boundary conditions and
constraints in the application. For information on this, refer to Constraints on Report Parts on the
iPad
Note:
This topic lists only those new features of the app, that are relevant for your role as an administrator.
For a complete list of the app's new features, refer to the Using SAP BusinessObjects Mobile for iPad
guide available at http://help.sap.com/businessobject/product_guides/boexir4/en/403_mobiPad_us
er_en.pdf
7
2011-12-21
What's New?
8
2011-12-21
Solution Overview
Solution Overview
The SAP BusinessObjects Mobile solution on iPad allows end users to access SAP BusinessObjects
Web intelligence documents. This solution contains three components:
• SAP BusinessObjects Mobile client
• SAP BusinessObjects Mobile server
• SAP BusinessObjects Enterprise server
Related Topics
• SAP BusinessObjects Mobile Client
• SAP BusinessObjects Mobile Server
• SAP BusinessObjects Business Intelligence(BI) Platform Server
3.1 SAP BusinessObjects Mobile Client
Using SAP BusinessObjects Mobile, professionals can access SAP BusinessObjects Web intelligence
information from iPad. The application is designed specifically to meet the screen size and interactivity
features of iPad. Business intelligence documents and reports are displayed on iPad with native
rendering, single-click access, and user interactivity appropriate to the device.
The client application enables access to Web intelligence and provides users with document rendering,
refresh, snapshot sharing, and navigation options.
SAP BusinessObjects Mobile can work on data infrastructures like Wi-Fi, 3G, and 3G+ networks.
3.2 SAP BusinessObjects Mobile Server
The SAP BusinessObjects Mobile server is a Web application. It performs the following:
•
•
9
Receives requests sent by the SAP BusinessObjects Mobile client and passes them to the SAP
BusinessObjects Enterprise (BI platform) server.
Receives the response (for example, Web intelligence documents) from the SAP BusinessObjects
Enterprise (BI platform) server and sends it to the SAP BusinessObjects Mobile client.
2011-12-21
Solution Overview
Related Topics
• Installing the SAP BusinessObjects Mobile Server
3.3 SAP BusinessObjects Business Intelligence(BI) Platform Server
The SAP BusinessObjects BI platform server renders corporate data captured from corporate databases
and data warehouses through business intelligence documents. It handles the whole document lifecycle
including creation, catalog, refresh, content delivery, and report interactivity.
The SAP BusinessObjects BI platform server processes requests sent by SAP BusinessObjects Mobile
client through the SAP BusinessObjects Mobile server, and sends back responses (for example, Web
intelligence document).
Related Topics
• Installing the SAP BusinessObjects BI Platform Server
3.3.1 Supported Versions of Business Intelligence Platform and the Mobile Server
SAP BusinessObjects Mobile for iPad application is supported on the various versions of the Business
Intelligence (BI) platform and the BI Mobile server. The following table displays the supported releases
of the platform server and the app features or fixes that become available on deploying the respective
server release.
Note:
The SAP BusinessObjects Mobile server should be of the same release version as that of the BI platform
server.
10
2011-12-21
Solution Overview
BI platform/Mobile server release
New supported features or fixes
SAP BusinessObjects Enterprise Server Supports access to the latest instance of a scheduled docXI 3.1, Fix Pack 3.6
ument.
SAP BusinessObjects Enterprise Server •
XI 3.1, Fix Pack 3.7
•
•
•
SAP BusinessObjects Enterprise Server •
XI 3.1, Service Pack 4.1
•
•
•
SAP BusinessObjects Enterprise Server •
XI 3.1, Service Pack 5
•
•
•
Supports access to the latest instance of a scheduled
document
Supports trailing spaces in the target document name
(for openDocument functionality)
Supports the enhancements to prompts
Fixed XML encoding issues
Supports access to the latest instance of a scheduled
document
Supports trailing spaces in the target document name
(for openDocument functionality)
Supports the enhancements to prompts
Fixed XML encoding issues
Supports access to the latest instance of a scheduled
document
Supports trailing spaces in the target document name
(for openDocument functionality)
Supports the enhancements to prompts
Fixed XML encoding issues
SAP BusinessObjects BI platform Server No new features. All features supported by the server are
4.0, Service Pack 2
the same as that available in 4.0.1 release of the Mobile
for iPad application.
SAP BusinessObjects BI platform Server •
4.0, Service Pack 2, Patch 9
•
•
•
11
Supports access to the latest instance of a scheduled
document
Supports trailing spaces in the target document name
(for openDocument functionality)
Supports the enhancements to prompts
Fixed XML encoding issues
2011-12-21
Solution Overview
12
2011-12-21
Installing the Required Components
Installing the Required Components
4.1 Installing SAP BusinessObjects Mobile on iPad
The SAP BusinessObjects Mobile client is supported on iPad 1 and iPad 2. You can install SAP
BusinessObjects Mobile client application on your iPad device in two ways. These are described below:
• You can download the SAP BusinessObjects Mobile client application from the App Store using the
iTunes software. Then synchronize the downloaded application with your iPad device.
• You can download the SAP BusinessObjects Mobile client application directly from the App store
to your device.
4.2 Installing the SAP BusinessObjects Mobile Server
You have Tomcat with the same version as that of the SAP BusinessObjects BI platform server version.
The SAP BusinessObjects Mobile server is supported on Tomcat Web application server. To install
Mobile server on Tomcat Web application server, perform the following:
1. Stop Tomcat Web application server.
2. Copy the file MobileBIService.war from one of the following SAP BusinessObject BI platform locations,
as appropriate, to [Tomcat home directory]\webapps.
• For SAP BusinessObjects Business Intelligence platform 4.0 SPXX: [Install directory]\Mobile
14\Client
• For SAP BusinessObjects Business Intelligence platform 3.1 SPXX: [Install
directory]\BusinessObjects Enterprise 12.0\java\applications
Note:
MobileBIService.war is supported only on Tomcat.
3. Start Tomcat.
Note:
The SAP BusinessObjects Mobile server can be installed on the same Tomcat Web application server
on which other SAP BusinessObjects BI platform Web applications are deployed. It can also be installed
on a separate Tomcat Web application server.
13
2011-12-21
Installing the Required Components
4.2.1 Configuring Categories for iPad
The SAP BusinessObjects Mobile application displays the available documents from the configured
categories on the My Reports screen of the iPad device.
To configure the categories, perform the following steps:
1. Locate and edit the file: [Tomcat_Home]\webapps\MobileBIService\WEB-INF\mobi.properties.
2. Add the required categories to the request sources (default or iPad) as shown below.
default
default.corporateCategory=Mobile, Category 1, Category 2...
default.personalCategory=Mobile, Category 1, Category 2...
ipad
ipad.corporateCategory=Mobile, Category 1, Category 2...
ipad.personalCategory=Mobile, Category 1, Category 2...
Note:
•
•
If you do not specify any entries for iPad request sources, the values specified for the default request
source are used.
If you specify values for iPad request sources, the values specified for the default request source
are ignored.
4.3 Installing the SAP BusinessObjects BI Platform Server
For information about installing the SAP BusinessObjects BI platform server, see SAP BusinessObjects
Enterprise Administrator Guide (3.1 or 4.0 release) on SAP Help Portal at http://help.sap.com.
Note:
The SAP Business Objects Business Intelligence(BI) platform was earlier known as the SAP
BusinessObjects Enterprise (BOE).
14
2011-12-21
Creating an SAP BI URL
Creating an SAP BI URL
By creating an SAP BI URL and providing it to users of the SAP BusinessObjects Mobile for iPad
application, you help them add connections from the Mobile client to the SAP BusinessObjects BI
platform server easily and successfully.
Users can click the SAP BI URL to launch the "Add connection" screen that is pre-populated with the
values for all required input parameters(set by you). Then they can save the connection.
This has the advantage of avoiding the errors that users might commit if they create a connection by
themselves and enter the input parameter values on the "Add connection" screen. Example of such
errors are an invalid Connection name, incorrect Server URL or an invalid Server name.
To create the URL you need to specify values for the required parameters using the following format:
sapbi://addconnection?name=ConnectionName&server_url=ServerName/IP:Port&cms=
ServerName/IP:Port&authType=AuthenticationType&default=yes/no&user=User
Name&password=UserPassword&save_password=yes/no
where AuthenticationType can have one of the following values as appropriate:
•
•
•
•
secEnterprise for Enterprise
secLDAP for LDAP
secWinAD for Windows AD
secSAPR/3 for SAP
For example, assume the following parameters:
• Connection Name = Manufacturing
• Server URL = https://yoda.corp.com/8080
• CMS: Luke77
The corresponding URL with the above parameter values would be:
sapbi://addconnection?name=Manufacturing&server_url=https://yo
da.corp.com/8080&cms=Luke77&authType=secEnterprise&default=no&save_pass
word=yes
Once the SAP BI URLis created, you can share it with the users by e-mailing it to them.
Guidelines for URL Parameters
Connection Name
You can use alphanumerics, hyphens, underscores, dots, and round brackets; the maximum number
of characters allowed is 20.
15
2011-12-21
Creating an SAP BI URL
Server URL
•
•
•
You can use alphanumerics, hyphens('-'), underscores('_'), dots('.'), colons(':'), and forward slashes('/');
the maximum number of characters allowed is 281.
If you want to connect to the mobile server in HTTPS mode, use HTTPS in the server URL. For
example, https://<hostname>:<port> or https://<IP>:<port>.
If you want to connect to the mobile server with reverse proxy, add the proxy context path after the
port in the server URL. For example, http://<hostname>:<port>/<context path> or
http://<IP>:<port>/<context path>.
CMS Server
•
•
•
16
For the CMS name, you can use alphanumerics, hyphens, underscores, dots, and colons; the
maximum number of characters allowed is 261.
The maximum number of characters allowed for the user name is 100.
For the username and password, signs such as ampersand ('&'), question mark ('?'), and equals
('=') are not supported; providing a password is optional.
2011-12-21
Defining the Log Level
Defining the Log Level
You use this procedure to enable the Mobile application to record information about the execution
details of Mobile client on the iPad device. This log information helps you identify issues if the application
fails or encounters a problem.
To set the log level, perform the following steps:
1. Log on to the mobile application on iPad.
2. From Settings, choose Logs.
3. You see the following settings for the logs:
• Enable Logs: If you want to view logs for your activities, toggle the button state to ON.
• Clear Logs: Tap this option if you want to clear the logs.
• Select a minimum log level: Select the required log level based on which the system must enter
details in the log file:
Error: Logs error and fatal errors
Warnings: Logs warning messages in addition to normal and fatal error messages.
Debug: Logs the trace information in addition to medium and low log level details.
Note:
You can view the log file by performing the following steps:
1. Acess the iPad device from iTunes.
2. From the File Sharing section in the Apps pane, select the device.
3. Save the mobi.log file to your computer.
4. Open and view the log details from the file.
17
2011-12-21
Defining the Log Level
18
2011-12-21
Embedded Images in Reports
Embedded Images in Reports
The mobile for iPad software supports the images embedded in report parts of a Web Intelligence
report. Embedded images are the images that are embedded or inserted within a report part.
The following are certain features of embedded images on the iPad device:
• Embedded images are supported only in the following report parts in Web Intelligence reports:
• Blank cells
• Table cells
•
When designing a Web Intelligence report, the embedded image for a blank cell or table cell can
only be browsed and uploaded from a file location. Images from a source URL are not supported
by the mobile for iPad application.
Note:
All image file formats supported by a Web Intelligence (Interactive analysis) document are supported
on the iPad. No constraints apply here.
•
19
The maximum height of a table row on an iPad can be 28 pixels. Hence, when designing a Web
Intelligence report, if the specified height of the image embedded in a table cell is more than 28 px.,
the image is truncated when the report is viewed on the iPad.
2011-12-21
Embedded Images in Reports
20
2011-12-21
Layout Predictability of Report Parts on an iPad
Layout Predictability of Report Parts on an iPad
When the report parts of a Web Intelligence Report can not be accomodated completely on a single
screen of an iPad device (size 1024 px. * 768 px.), they are rendered in successive screens on the
device, such that you can access them by sliding your finger on the screen.
The software makes sure that report parts are not lost or rendered in a haphazard manner by providing
you with a layout prediction model. This section gives an overview of this model. As a report-designer,
you can consider the information provided in this topic while designing a Web Intelligence document
for viewing on an iPad.
Following are some of the aspects that define the layout prediction on an iPad:
1. On a single screen of an iPad, a maximum of four report parts are accomodated. If the report parts
in the report exceed this number, they are moved to the next or successive screen.
2. When the Web Intelligence report has more than two report parts placed adjacent to each other
along a single line, then on an iPad, after two report parts, the subsequent report parts are moved
to the next line on the screen. The layout of the initial two report parts is respected on the iPad
screen.
3. When the Web Intelligence report has more than two report parts placed one below another along
a single(vertical) line, then on an iPad, after two report parts, the subsequent report parts are moved
to the next screen of the iPad. The layout of the initial two report parts is respected on the iPad
screen.
Note:
When the Web Intelligence report has exactly two report parts placed adjacently or one below another,
then their layout is not respected on an iPad screen. The rendition on an iPad is such that the best
possible fit is achieved on the device screen. This is an exceptional case.
The above mentioned aspects of layout prediction can be observed in the few examples illustrated in
the following table. This table displays the layouts which can be predicted in the portrait and landscape
views of an iPad when the number of report parts in a Web Intelligence report range from one to four.
The “Infoview” column displays the layout of Web Intelligence report parts as seen in a client side BI
platform tool like the Web Intelligence rich client(XI 3.1) or Interactive Analysis Desktop (4.0 onwards)
or the SAP BusinessObjects InfoView (BI Launchpad).
21
2011-12-21
Layout Predictability of Report Parts on an iPad
22
2011-12-21
Layout Predictability of Report Parts on an iPad
23
2011-12-21
Layout Predictability of Report Parts on an iPad
DISCLAIMER: This topic in the document just gives an overview of the layout prediction model provided
by the software.
The number of possible layouts on an iPad increase in number as the number of report parts in the
Web Intelligence report increase. Practically, it is not possible to make accurate predictions for all
possible layouts in cases when the number of report parts is huge.
24
2011-12-21
Configuring the Blank Cells of a Report for Viewing on an iPad
Configuring the Blank Cells of a Report for Viewing on
an iPad
The blank cells of a Web Intelligence (or Interactive Analysis) report can be viewed on the iPad only if
their format is configured in a specific way. This section explains the configuration with an example.
It is recommended that you go through the configuration steps as well as the example to completely
understand the concept.
Note:
The steps for configuration mentioned in this section for the Web Intelligence Rich Client(for XI 3.1)
and Interactive Analysis Desktop (for 4.0) can be applied to any client application such as Infoview.
The work-flow and interface may differ between each client tool, but the steps and fields for configuration
remain the same.
9.1 Configuring Blank Cells in XI 3.1 Web Intelligence Reports
To configure blank cells in an XI 3.1, Web Intelligence report, perform the following steps:
1. Open the report in Edit mode in the Web Intelligence rich client.
2. For the blank cell in the report, select the Properties tab in the left panel.
3. In the Text field which appears in the General section of the properties, enter the following tag and
parameters for the blank cell: <a href="laction://cell?attachedto='[blocknum]'&valign='[align
var]'&halign='[alignvar1]'"><text></a> ; where
a. attachedto: In this parameter, specify the name of report part to which you want to hook the
blank cell. Note that ampersand (&) and single quote (') characters are not supported in the value
for this parameter.
b. valign: Specify the vertical alignment of the blank cell. It has two valid values: "Top", "Bottom".
Based on this, the blank cell appears at the top or bottom of the report part.
c. halign: Specify the horizontal alignment of the blank cell. It has three valid values: "Left",
"Center", "Right". This needs to be specified if more than one blank cell is hooked to a report
part. If a single blank cell is hooked to a report part, it spans across the width of the report part
by default.
d. Specify thetext which you want to display in the blank cell, in the body of the tag. The software
does not support URLs for this parameter at this point in time. The text specified for this parameter
is treated only as plain text and is not hyperlinked to external URLs.
If you want, you can set a background image for the blank cell by uploading it in the “Background
image” field of Appearance section of the "Properties" panel.
25
2011-12-21
Configuring the Blank Cells of a Report for Viewing on an iPad
4. In the Display section, for the field Read cell content as, select the Hyperlink option from the
drop-down menu. This makes sure that the value specified in the Text field of blank cell is interpreted
as a hyperlink.
5. Based on your requirements, you can also set values of the following parameters in the "Properties"
panel of the blank cell. However, these are not mandatory:
• "Text Format" section: Text color, Vertical text alignment, Horizontal text
alignment, Background image, Borders.
Note:
•
•
Optional parameters other than those listed above are not supported for the blank cell on the iPad.
Only full borders for blank cells are supported on the iPad. Border colors are not respected.
9.2 Configuring Blank Cells in 4.0 Interactive Analysis Reports
To configure blank cells in a 4.0 Interactive Analysis report, perform the following steps:
1. Logon to the “Interactive Analysis Desktop” client side tool of the BI platform (Enterprise) suite.
2. Open the report and go to the Design mode.
The report opens in design mode.
3. In the formula bar of the document, enter the hyperlink URL for the blank cell as described for the
XI 3.1 Web Intelligence report in the previous section: <a href="laction://cell?attachedto='[block
num]'&valign='[alignvar]'&halign='[alignvar1]'"><text></a>. Then press Enter.
4. Right click the blank cell and select the Format Cell option.
The "Format Cell" window opens.
5. In the "Format Cell" window, go to the Display Section within the General(default) tab. For Read
contents as field, select Hyperlink from the drop-down menu.
6. Based on your requirements, you can also set the values for the following parameters for the blank
cell in the "Format Cell" window. However, these are optional:
• Alignment
•
•
•
•
•
Font tab: You can set only the Font Color .
Border tab: Select the symbol for full borders. Border colors and partial borders are not supported
on the iPad.
Appearance tab:
•
•
•
26
You can set the text alignments within the blank cell using the dropdown fields: Horizontal,
Vertical.
You can select or unselect the "Display" > Wrap text option.
In the "Image" section, you can Browse and upload a background image for the blank cell.
The "Display" property should be selected as Normal from the drop-down menu. Other menu
options are not valid.
In the "Position" field, you can make a selection for position of the image from the drop-down.
(Left/Center/Right ; Top/Center/Bottom)
2011-12-21
Configuring the Blank Cells of a Report for Viewing on an iPad
7. Save the report.
9.3 Example of Blank Cell Configuration
Suppose your Web Intelligence/Interactive Analysis report has four report parts: a bar chart, a line
graph, a table and a blank cell.
Based on your requirements, suppose you make the following configuration settings for the blank cell:
• In the formula bar, the hyperlink is set as <a
href="laction://cell?attachedto='block1'&valign='top'&halign='left'">Data Source GeoHive</a>
(Assume that "block1" is Name of the table in the report. )
•
Read cell content as field within the Format / Properties of blank cell is selected appropriately as
Hyperlink.
In the client view, all the report parts are independent as shown below :
27
2011-12-21
Configuring the Blank Cells of a Report for Viewing on an iPad
Note:
The text in the blank cell is treated as a hyperlink in the client tool, hence it appears as blue in the view.
The actual text color(as configured) shows up in the iPad view of the report.
After saving the properties of all the report parts including the blank cell, it is displayed as shown below
when you view the report on the iPad:
28
2011-12-21
Configuring the Blank Cells of a Report for Viewing on an iPad
Note:
•
To achieve the above view of the report on the iPad device, you could also have set the
alignment(halign) of the blank cell(in the hyperlink URL) as "center" or "right". All the values(
"left","center", "right") would work for the cell in this case, because only one blank cell is being hooked
to the table report part. In such a case, irrespective of the specified alignment, the cell spans across
the width of the report part to which it is hooked(at its top or bottom based on the value of valign).
If there were two or three blank cells, the alignment of each would have been picked based on the
value of halign specified in the text URL.
29
2011-12-21
Configuring the Blank Cells of a Report for Viewing on an iPad
30
2011-12-21
Creating Scorecards for Report Tables on an iPad
Creating Scorecards for Report Tables on an iPad
As a Web intelligence report designer, you can enable the application to display the documents as
scorecards on iPad devices. To create scorecards, enter your input in the report Block Name field
using the syntax described in the table below.
Note:
Based on the client tool that you are using for designing the reports (such as Web Intelligence rich client
in XI 3.1, Interactive Analysis Desktop in 4.0 or InfoView), the interface will differ. However, the concept
and the syntax detailed in this section apply to all.
The features below are supported in vertical tables and cross tables. You can also define a combination
of these features in a vertical table or a cross table.
31
2011-12-21
Creating Scorecards for Report Tables on an iPad
Feature
Sub
Feature
Syntax
Description
Example
Micro Line
Chart
;SL_L_[column name for
Specify the columns to be
Micro Chart]_C_[starting
converted as Line Micro
number of column]_[Ending Chart.
number of column]
;SL_L_Revenues_C_5_16
Micro Area
Chart
;SL_GF_[column name for Specify the columns to be
Micro Chart]_C_[starting
converted as Area Micro
number of column]_[Ending Chart.
number of column]
;SL_GF_QSales_C_7_10
Trend Circu- ;SC_TT_ C_[Column numIcon lar
ber from left]_[Position of
glossy the arrow to be displayed]
icon
Use a circular icon to depict
the trend of a scorecard parameter. To define the icon
position (with respect to values in the column), specify
'R' for right and 'L' for left.
When the report is viewed
on iPad, the table displays a
column titled “Revenues”
that displays a sparkline of
the data values contained in
columns 5 to 16 of the table.
The sparkline will appear as
a linear curve because 'L' is
used in the formula.
On iPad, the report table
displays a column titled
“QSales” that has a sparkline
of the data values contained
in columns 7 to 10 of the table. The area of the microchart enclosed within the
sparkline and the axis will be
filled or shaded because
gradient fill ('GF') is applied.
;SC_TT_C_4_R
On iPad, the fourth column
of the table(scorecard) displays a trend icon to the right
of data values in the column.
Note:
The icon takes the same
color (mostly green, red,
yellow etc.) as that of data in
the table. The color of the
data in table cells depends
on the alerts applied to the
data based on their values
and different criteria.
Status
Icon
32
Button
;SC_GF_C_[Column number from left]
2011-12-21
Creating Scorecards for Report Tables on an iPad
Feature
Sub
Feature
Syntax
Description
Example
Define the value to be dis- ;SC_GF_C_6
played on the button based
On an iPad, the sixth column
on WebI alerts color.
of the scorecard displays the
Note:
values of column data (formatted as a percentage) by
You must ensure that the
cells of columns you want to a button that is fractionally
enable as buttons have per- filled to indicate the percentcentage values. If you speci- age.
fy any numeric values, the
button appears as complete- The color of the gradient fill
ly filled with the data values in the button is based on the
alerter applied to the column
displayed on the button.
data values in the table. If no
alerter is applied to the data
column, then the gradient fill
will have a default color.
Trend Arrow ;SC_TA_C_[Column num- Use an arrow to depict the
Icon
ber from left]_[Position of trend of a table parameter.
the arrow to be displayed] To define arrow position
(with respect to values in the
column) , specify 'R' for right
and 'L' for left.
;SC_TA_C_5_L
On an iPad, the fifth column
of the scorecard displays a
trend arrow to the left of the
parameter(column) values.
Note:
The icon takes the same
color (mostly green, red,
yellow etc.) as that of the
data in the table. The color
of the data in column cells
depends on the alerts applied to the data based on
their values and different criteria.
Acronyms used in the syntax are:
• SL: Sparkline
• L: Line Chart
• C: Column
• GF: Gradient Fill
• SC: Scorecard
• TT: Trend Traffic
• TA: Trend Arrow
33
2011-12-21
Creating Scorecards for Report Tables on an iPad
Note:
•
•
•
•
Each scorecard feature in the name of a report block (table) should begin with a semi-colon.
Multiple features of scorecards can be used on a single table by specifying them in a sequence in
the report “block name” such that each feature is separated by a semi-colon.
To understand vertical, horizontal and cross tables in a Web Intelligence report, refer to the "Table
Types in Interactive Analysis" section of Interactive Analysis 1.0 Building Reports with Interactive
Analysis guide that is available on http://help.sap.com/businessobject/prod
uct_guides/IA10SP1/en/ia_user_guide_en.pdf
To understand the alerters' criteria applied to table columns, refer to the "Using Alerters to Highlight
Results" section of the Interactive Analysis 1.0 Building Reports with Interactive Analysis guide
available on http://help.sap.com/businessobject/product_guides/IA10SP1/en/ia_user_guide_en.pdf
10.1 Examples of Scorecards
Example: 1. Microcharts in a cross table
Suppose you are designing a report titled "Performance dashboard change for landscape". The report
has a cross table with sales overview data. (The structure of this cross table is depicted in the figure
below.)
You want to display the cross table as a scorecard on the iPad. For this, you set the“block name” of
the cross table in your Web intelligence report as;SC_GF_C_4;SL_GF_Sales_C_5_16
After saving the report, it appears as the scorecard below, when you view it on the iPad:
34
2011-12-21
Creating Scorecards for Report Tables on an iPad
Based on the name given to the cross table in the report, you can see that:
• On the iPad, the cross table displays data from the fourth column as a button icon that is gradient
filled to indicate percentage values. The color of the gradient is based on the applied alerter.
• On the iPad, the data from columns five to sixteen of the table is projected as microcharts within
a single column titled as “Sales”. The microchart in each row of the table consists of a sparkline
that is gradient filled and depicts the revenue trend across twelve months of the year.
Example: 2. Trend traffic icon in a vertical table
You are designing a Web Intelligence report named "Yearly Business Performance" that has a vertical
table containing zonal business performance data (Structure of table is depicted in below figure).
You want to project this vertical table as a scorecard in which a traffic icon indicates the trend of sales
revenue. For this, you set the “block name” of vertical table in the report as;SC_TT_C_3_R
35
2011-12-21
Creating Scorecards for Report Tables on an iPad
After saving the report with the above block name for the table, it is displayed as follows when you
view the report on iPad:
36
2011-12-21
Linking a Document to Other Web Intelligence Documents on the BI Platform
Linking a Document to Other Web Intelligence Documents
on the BI Platform
As a Web Intelligence report-designer for SAP BusinessObjects Mobile for iPad, you can hyper-link
report parts of a document to other documents in the CMS (BI platform server).
Hyperlinking a report part or cell to another Web Intelligence document involves configuring an OpenDoc
URL with certain parameter values. The basic OpenDoc URL syntax is:
http://<servername>:<port>/BOE/OpenDocument/opendoc/openDocument.jsp?<param
eter1>&<parameter2>&...&<parameterN>
Note:
•
•
For a complete understanding of the syntax and various parameters of an OpenDoc URL, refer to
the "Parameter reference" (chapter 4) in Viewing Documents Using OpenDocument guide available
at: http://help.sap.com/businessobject/product_guides/boexir4/en/xi4_opendocument_en.pdf. This
document also provides introductory information about the OpenDocument application deployed on
the SAP BusinessObjects Enterprise (BI platform).
To understand how to hyperlink cells in report parts of a Web Intelligence document to other Web
Intelligence documents in the CMS, refer to chapter 28 of the SAP BusinessObjects Web Intelligence
User's Guide available at: http://help.sap.com/businessobject/product_guides/boexir4/en/xi4_ia_en.pdf
The SAP BusinessObjects Mobile for iPad supports the following query string parameters as part of
the OpenDoc URL syntax:
37
Parameter Type
Parameter
Description
Document Identifier
Parameter
iDocID
This is the unique identifier of the viewable Web Intelligence
document in the CMS. It is used in conjunction with sIDType.
Document Identifier
Parameter
sIDType
Specifies the type of object identifier used to specify the viewable document.
Document Identifier
Parameter
sDocName
Specifies the name of the viewable Web Intelligence document
in the CMS.
Input Parameter
sReportName Specifies the report to open if the target document contains
multiple reports.
2011-12-21
Linking a Document to Other Web Intelligence Documents on the BI Platform
Parameter Type
Parameter
Description
Input Parameter
sRefresh
This is a flag parameter having two valid values {'Y', 'N}. The
value of this flag determines whether a database refresh should
be forced when the target document is opened.
Input Parameter
lsM[NAME]
Specifies multiple values for a prompt. [NAME] is the text of the
prompt.
Note:
Prompt appears on the iPad if the target Web Intelligence document is prompt enabled. Based on the prompt values entered
by the user on the iPad, the target Web Intelligence document
will display the filtered data.
Input Parameter
lsS[NAME]
Specifies a value for a single prompt. [NAME] is the text of the
prompt.
An example of the OpenDoc URL configured for a report cell of Web Intelligence document on the iPad
is:
http://10.208.110.53:8080/BOE/OpenDocument/opendoc/openDocument.jsp?iDocID=AW
imiw9StnhGm993evk.Amc&sIDType=CUID&sReportName=Report2&sRefresh=Y&lsMProduct
Name=Cycle;Car
Note:
•
•
•
38
An OpenDoc URL should have a minimum of iDocID or sDocName parameter with valid values.
Spaces are allowed in the name of target document (sDocName).
If the OpenDoc URL configured for a Web Intelligence report cell contains parameters other than
those mentioned in the above table, the app ignores them.
2011-12-21
Constraints on Report Parts on the iPad
Constraints on Report Parts on the iPad
When accessed on an iPad device, there are certain limitations on size and other aspects of report
parts of a Web Intelligence report. You can consider the information given in this topic while designing
the Web Intelligence reports for iPad.
The below tables display the screen display limitations for tables and charts:
Tables
Table Type
Maximum size supported on an iPad
Vertical table
Ten thousand rows and twenty columns (10,000*20)
Horizontal table
Twenty rows and five hundred columns (20*500)
Cross table
Three hundred rows and twenty columns (300*20)
Note:
Tables having rows and columns more than the above mentioned values are supported on the iPad
device. However, users may encounter issues with the speed of interaction and response-time of the
app. Hence, the best practice is to observe the above boundary values while designing the report.
39
2011-12-21
Constraints on Report Parts on the iPad
Line Charts
Display Parameter
Boundary Value
Number of viewable x-axis values points
300
Number of viewable x-axis values points with chart slider
54
Number of viewable series
10
Number of legends displayed in Report-part-mode
Portrait: 8; Landscape: 10
Number of bars tappable for viewing values
300
Pie Charts
Display Parameter
Boundary Value
Number of viewable x-axis values points More than 1600
(sectors)
Note:
When the number of sectors is more than eleven, all sectors
beyond the eleventh sector get grouped into a single sector
named "Other". The sectors in pie-chart are displayed in
descending order of the measure value.
Number of viewable x-axis values points 11
(sectors) with chart slider
Number of legends displayed in Report- 12
part-mode
Vertical Bar (Column) Charts
Display Parameter
Boundary Value
Number of viewable x-axis values points
300
Number of viewable x-axis values points with chart slider
54
Number of viewable series
5
Number of legends displayed in Report-part-mode
Portrait: 5; Landscape: 5
Number of tappable data-points for viewing values
Portrait: 22; Landscape: 30
Stacked Bar Charts
(A variant of Column charts)
40
2011-12-21
Constraints on Report Parts on the iPad
Display Parameter
Boundary Value
Number of viewable x-axis values points
54
Number of viewable x-axis values points with chart slider
300
Number of viewable series
5
Number of legends displayed in Report-part-mode
Portrait: 5; Landscape: 5
Number of tappable data-points for viewing values
Portrait: 22; Landscape: 30
Grouped Bar Charts
(A variant of Column Charts)
41
Display Parameter
Boundary Value
Number of viewable x-axis values points
54
Number of viewable x-axis values points with chart slider
300
Number of viewable series
5
Number of legends displayed in Report-part-mode
Portrait: 5; Landscape: 5
Number of tappable data-points for viewing values
Portrait: 30; Landscape: 40
2011-12-21
Constraints on Report Parts on the iPad
42
2011-12-21
More Information
More Information
Information Resource
Location
SAP BusinessObjects product information
http://www.sap.com
Navigate to http://help.sap.com/businessobjects and on the "SAP BusinessObjects Overview" side panel click All Products.
SAP Help Portal
You can access the most up-to-date documentation covering all SAP
BusinessObjects products and their deployment at the SAP Help Portal.
You can download PDF versions or installable HTML libraries.
Certain guides are stored on the SAP Service Marketplace and are not
available from the SAP Help Portal. These guides are listed on the Help
Portal accompanied by a link to the SAP Service Marketplace. Customers
with a maintenance agreement have an authorized user ID to access
this site. To obtain an ID, contact your customer support representative.
http://service.sap.com/bosap-support > Documentation
•
•
SAP Service Marketplace
Installation guides: https://service.sap.com/bosap-instguides
Release notes: http://service.sap.com/releasenotes
The SAP Service Marketplace stores certain installation guides, upgrade
and migration guides, deployment guides, release notes and Supported
Platforms documents. Customers with a maintenance agreement have
an authorized user ID to access this site. Contact your customer support
representative to obtain an ID. If you are redirected to the SAP Service
Marketplace from the SAP Help Portal, use the menu in the navigation
pane on the left to locate the category containing the documentation you
want to access.
https://cw.sdn.sap.com/cw/community/docupedia
Docupedia
Docupedia provides additional documentation resources, a collaborative
authoring environment, and an interactive feedback channel.
https://boc.sdn.sap.com/
Developer resources
https://www.sdn.sap.com/irj/sdn/businessobjects-sdklibrary
43
2011-12-21
More Information
Information Resource
Location
SAP BusinessObjects articles on
the SAP Community Network
https://www.sdn.sap.com/irj/boc/businessobjects-articles
These articles were formerly known as technical papers.
https://service.sap.com/notes
Notes
These notes were formerly known as Knowledge Base articles.
Forums on the SAP Community
Network
https://www.sdn.sap.com/irj/scn/forums
http://www.sap.com/services/education
Training
From traditional classroom learning to targeted e-learning seminars, we
can offer a training package to suit your learning needs and preferred
learning style.
http://service.sap.com/bosap-support
Online customer support
The SAP Support Portal contains information about Customer Support
programs and services. It also has links to a wide range of technical information and downloads. Customers with a maintenance agreement
have an authorized user ID to access this site. To obtain an ID, contact
your customer support representative.
http://www.sap.com/services/bysubject/businessobjectsconsulting
Consulting
44
Consultants can accompany you from the initial analysis stage to the
delivery of your deployment project. Expertise is available in topics such
as relational and multidimensional databases, connectivity, database
design tools, and customized embedding technology.
2011-12-21
Index
C
Charts 39
Configuring blank cells 25
Cross tables 31
Cross Tables 39
G
Gradient 31
H
Horizontal Tables 39
I
Interactive Analysis 31
Interactive Analysis Desktop 26
L
S
Layout prediction 21
Log level 17
SAP BI URL 15
Scorecard 31
Sparkline 31
M
Microchart 31
T
Trend 31
O
OpenDocument 37
P
V
Vertical tables 31
Vertical Tables 39
Predict layout 21
W
R
Web Intelligence Rich client 25
Report Parts 21
45
2011-12-21
Index
46
2011-12-21
Download PDF
Similar pages