28
Designing BI documents for mobile users SAP BusinessObjects Mobile 4.0 Support Package 2 2011-05-06

Xi4 Mobile Bi Rep Design En

Embed Size (px)

Citation preview

Page 1: Xi4 Mobile Bi Rep Design En

Designing BI documents for mobile users■ SAP BusinessObjects Mobile 4.0 Support Package 2

2011-05-06

Page 2: Xi4 Mobile Bi Rep Design En

© 2011 SAP AG. All rights reserved.SAP, R/3, SAP NetWeaver, Duet, PartnerEdge, ByDesign, SAPBusiness ByDesign, and other SAP products and services mentioned herein as well as their respective

Copyright

logos are trademarks or registered trademarks of SAP AG in Germany and other countries. BusinessObjects and the Business Objects logo, BusinessObjects, Crystal Reports, Crystal Decisions, WebIntelligence, Xcelsius, and other Business Objects products and services mentioned herein as wellas their respective logos are trademarks or registered trademarks of Business Objects S.A. in theUnited States and in other countries. Business Objects is an SAP company.All other product andservice names mentioned are the trademarks of their respective companies. Data contained in thisdocument serves informational purposes only. National product specifications may vary.These materialsare subject to change without notice. These materials are provided by SAP AG and its affiliatedcompanies ("SAP Group") for informational purposes only, without representation or warranty of anykind, and SAP Group shall not be liable for errors or omissions with respect to the materials. Theonly warranties for SAP Group products and services are those that are set forth in the expresswarranty statements accompanying such products and services, if any. Nothing herein should beconstrued as constituting an additional warranty.

2011-05-06

Page 3: Xi4 Mobile Bi Rep Design En

Contents

About this guide......................................................................................................................5Chapter 1

Who should read this guide......................................................................................................51.1What this guide contains..........................................................................................................51.2

How documents are displayed on mobile devices..................................................................7Chapter 2

Best practices for mobile document design............................................................................9Chapter 3

Designing Web Intelligence documents for mobile users........................................................113.1Installing Web Intelligence images for mobile reports.............................................................133.1.1Designing Crystal reports for mobile users............................................................................143.2Setting up alerters on documents...........................................................................................153.3

Embedding actions in report cells.........................................................................................17Chapter 4

Quick reference to embedded actions....................................................................................174.1Syntax for actions..................................................................................................................184.2Example: embed an action that launches a phone call to the sales representative named on theselected report cell................................................................................................................20

4.3

Linking documents................................................................................................................23Chapter 5

More Information...................................................................................................................25Appendix A

Index 27

2011-05-063

Page 4: Xi4 Mobile Bi Rep Design En

2011-05-064

Contents

Page 5: Xi4 Mobile Bi Rep Design En

About this guide

1.1 Who should read this guide

This guide is intended for Enterprise report designers who want to provide users of SAP BusinessObjectsMobile with data in a format that is optimized for display and ease-of-use when viewed on a mobiledevice.

1.2 What this guide contains

This guide explains how to design business intelligence documents for optimum display and performancewhen viewed on mobile devices.

2011-05-065

About this guide

Page 6: Xi4 Mobile Bi Rep Design En

2011-05-066

About this guide

Page 7: Xi4 Mobile Bi Rep Design En

How documents are displayed on mobile devices

SAP BusinessObjects Mobile makes viewing and interacting with business intelligence content asintuitive as possible on mobile devices. Documents are natively rendered to take full advantage of themobile device display space and capabilities.

The major presentation differences from the typical desktop user experience are:• The user interface, which is designed to maximize ease-of-use for mobile content navigation.• The ability to set up single-click document access by setting a default document or folder.• The conversion of report tabs within Web Intelligence documents, which appear as a report list on

the device menu.

The constraints inherent in mobile devicesThere are real limits to the size and complexity of reports that you can display on a small mobile devicewhile maintaining any semblance of acceptable usability; due to the small screen size, limited memory,and interaction capabilities of mobile devices. Documents intended for mobile consumption must bedesigned according to best practice design guidelines for mobile devices.

Related Topics• Best practices for mobile document design

2011-05-067

How documents are displayed on mobile devices

Page 8: Xi4 Mobile Bi Rep Design En

2011-05-068

How documents are displayed on mobile devices

Page 9: Xi4 Mobile Bi Rep Design En

Best practices for mobile document design

SAP BusinessObjects Mobile user experience is best when reports are written specifically for easyreading and navigation on a small screen.

Create and use mobile device design templatesUse image backgrounds as the report design template for target mobile devices. Embed an image ofthe target device in the report background as a model of the screen size to help design the report to fitthe device constraints. In the Web Intelligence, for example, you can use the Insert Object feature toplace a *.jpg of your targeted mobile device in the background of a document, giving you an idea howbig the document is in relation to the device. Refer to the Performing interactive analysis using thedesktop interface for SAP BusinessObjects BI guide for details on using this feature.

IT Administrators are advised to install these graphics files on the SAP BusinessObjects BusinessIntelligence platform server at the following location:<BOBJ_INST_DIR>\SAP BusinessObjects Enterprise XI 4.0\images

SAP BusinessObjects provides two backgrounds for this purpose in the SAP BusinessObjects Mobiledownload package. Alternatively, you can create your own backgrounds for specific mobile devices,and save them to the same location.

Design for the device screen sizeSAP BusinessObjects Mobile renders documents using pixel-to-pixel mapping of your report layout.For the best control, authors can design reports to the pixel using the Java interface for SAPBusinessObjects BI.

For optimal display on devices, do not allow graphics and data to exceed 2X the physical screen widthof the target devices.

Use a mobile device simulator to test your documentsUse a mobile device simulator on your desktop to simulate the mobile user experience when you areauthoring business intelligence content designed for mobile users. Install a device simulator on yourworkstation and download SAP BusinessObjects Mobile on the simulator to test each report beingdisplayed inside the simulator. Testing your report ensures that there are no surprises.

Although the report appearance varies between the simulator and the mobile device, you get a goodidea of the size and format of your documents in terms of display and edit controls.

Group mobile documents under mobile categoryIt is recommended that the Enterprise administrator create a category in the BI launch pad called Mobileunder Corporate Categories, and assigns Mobile-related documents to this category. If the reportcreators group all the documents designed specifically for mobile users into the same category, thenmobile users know that they are accessing content designed for mobile consumption through their

2011-05-069

Best practices for mobile document design

Page 10: Xi4 Mobile Bi Rep Design En

mobile device. Hence, when users log into the mobile application using their mobile device, SAPBusinessObjects Mobile presents the "Home" page with the list of mobile documents grouped underMobile category. This enables users to reduce the number of clicks required to access documents eachtime they log on.

If you do not assign mobile documents to a category, SAP BusinessObjects Mobile displays foldersand documents located under Public folders or in the root folder.

In addition, you can search mobile documents by using the Search option. SAP BusinessObjects Mobilesearches the Mobile category and retrieves the list of documents that matches the specified searchstring.

Design small reportsReport data sets can be large and can theoretically saturate available device memory. Large data setson the server can be mitigated by designing smaller report views. In Web Intelligence documents, drillhierarchies in reports allow users to access related data in different report views. Drill hierarchiesalleviate the necessity of scrolling through large reports.

Small reports usually work better in mobile situations, because mobile devices are limited in bandwidthand memory, and large reports are difficult to navigate in a small screen.

Make tables and graphs fit into the smallest device screen sizeWhen you cannot reduce the size of tables and graphs:• Design columns and labels to fit the screen of the target mobile devices.• Do not design reports larger than two screen widths of the device screen.• In reports that exceed a single screen width, make sure that at least two columns (and better three

or four columns) fit entirely in the physical screen width.• Try to adjust the columns sizing so that the grid exactly fits the width of the mobile screen (or such

that at least a fixed number of columns exactly fits the screen width).

Use shortest significant names for headers and names• Use codes instead of names for countries and cities.

• Use the short name for people (made up of their first name initials + their last name) instead of fullnames.

• Use short labels for dates: FY04 instead of Year 2004, Q104 instead of 1st Quarter 2004.

Create short data display formatsDivide numbers by 1,000 or by 1,000,000 and express the numbers in K or in M using Web IntelligenceCustom format to reduce the number of digits displayed (to reduce column width). You can also putk or m in the column title to make columns as small as feasible.

Change universe definitions of dimensions and measures, to enable drills on shortened text labels. Forexample, you can convert the date dimension into two strings: a Text column Year string (four characters)and a Quarter (two character) string. Then you can build an expression for YearAndQuarter made ofthe Quarter string concatenated with the two last characters of Year.

To display charts with short numeric format display:1. Convert the chart to a crosstab.

2011-05-0610

Best practices for mobile document design

Page 11: Xi4 Mobile Bi Rep Design En

2. Shorten the number digits as necessary (for example, divide by 1,000 or by 1,000,000).3. Convert the crosstab back to a chart.

Use Position controls to maximize screen real estatePlace your elements as close as possible to the left corner of the report (for example, Charts, Grids, orTables):• Place first report element, label, or grid (at position (0, 0)) so that no blank appears on the mobile

screen.• Remove the border of the page (Left Margin, Top Margin) = (0 px, 0 px).

Limit font sizes to small-medium-largeUse Fonts 9, 12 and 15: Report display is limited to three available font sizes: Small, Medium, andLarge. Limiting the font sizes ensures greatest compatibility across the variety of device types availablein the marketplace. Font mapping on SAP BusinessObjects Mobile uses the following fonts:• Arial 9 to map Small font of the mobile• Arial 12 to map Medium font of the mobile• Arial 15 to map Large font of the mobileDesign reports with these font sizes to achieve optimal rendering accuracy and consistency betweenthe server and client behavior.

Use small fonts for tables. Do not use bold styles for table content (use bold only for labels).

Design report structure to fit data within available column spaceAll numbers must display completely within available cell space. Strings must appear completely, or atleast the most significant part of each string must be visible.

Use short meaningful names for document and report tabsIn SAP BusinessObjects Mobile, report tabs are converted into a user selection list. Report tabs arealso displayed in the report context labels. Choose report tab names that are short and meaningful tothe end user as they become navigation aids. These name strings can be no longer than 20 characters.

Related Topics• Designing Web Intelligence documents for mobile users• Designing Crystal reports for mobile users

3.1 Designing Web Intelligence documents for mobile users

Use the Java interface for SAP BusinessObjects BIFor maximum formatting accuracy and control, use the Java interface for SAP BusinessObjects BI tocreate and edit Web Intelligence documents for mobile users.

2011-05-0611

Best practices for mobile document design

Page 12: Xi4 Mobile Bi Rep Design En

Include additional icons to flag on-report alertersSAP BusinessObjects Mobile users can subscribe to alerts that send a notification to the mobile devicewhen report values meet the conditions in specific Web Intelligence document alerters.

It is recommended not to place too many conditional alerts on one document (recommendation is 2-3maximum), since device users cannot individually select only one of the available conditional alerts.

The SAP BusinessObjects Mobile download package includes trend and status alerting icons that canbe added to Web Intelligence conditional report alerters for greater visual impact when these reportsare viewed on mobile devices. IT administrators need to install these graphics files on the SAPBusinessObjects Business Intelligence platform server at the following location:<BOBJ_INST_DIR>\SAP BusinessObjects Enterprise XI 4.0\images

To insert one of these icons into a report:• Select the column for the alert and open the Alerters button.• Select or create the alert you want activated on the selected data, then select the appropriate icon

for each condition of the alerter by selecting the Format button in the "Alerter Editor".• In the Background section, select the Image from URL radio button and enter the following:

boimg://<image file name and extension>.

For example: boimg://icon_TrendRedDown.gif

Note:The boimg:// prefix directs the Web Intelligence component to the images folder.

Integrate a background skin that portrays the screen size of the mobile deviceSAP BusinessObjects provides two backgrounds for this purpose in the SAP BusinessObjects Mobiledownload package, but you can create your own backgrounds for specific mobile devices, if required.IT administrators need to install these graphics files on the SAP BusinessObjects Business Intelligenceplatform server at the following location:<BOBJ_INST_DIR>\SAP BusinessObjects Enterprise XI 4.0\images

To set the background image for a Web Intelligence document creators, go to the Background Imageitem in the Properties tab of Java interface foe SAP BusinessObjects BI and then select the Imagefrom URL radio button and enter the following: boimg://<image file name and extension>.

For example: boimg://skin_nokia.gif

Note:The boimg:// prefix directs the Web Intelligence component to the images folder.

Refer to the Web Intelligence component of SAP BusinessObjects BI documentation for more informationon creating Web Intelligence reports.

Related Topics• Designing Crystal reports for mobile users

2011-05-0612

Best practices for mobile document design

Page 13: Xi4 Mobile Bi Rep Design En

3.1.1 Installing Web Intelligence images for mobile reports

The SAP BusinessObjects Mobile server component includes image files designed to be used whenauthoring Web Intelligence documents targeted at mobile devices. The images include:• skins -- that provide a model of the screen size of some mobile devices, so you can design Web

Intelligence reports to fit specific device constraints• icons -- to be used in cells that contain on-report alerters, so that alerters are easier to view via

mobile devices

The file names are:

DescriptionFilename

BlackBerry device skinskin_Blackberry.gif

Nokia device skinskin_Nokia.gif

Fail alerts iconicon_SymbolFail.gif

Pass alerts iconicon_SymbolPass.gif:

Warning alerts iconicon_SymbolWarning.gif

Trend up (green) alerts iconicon_TrendGreenUp.gif

Trend down (red) alerts iconicon_TrendRedDown.gif

Trend down (yellow) alerts iconicon_TrendYellowDown.gif

Trend flat (yellow) alerts iconicon_TrendYellowFlat.gif

Trend up (yellow) alerts iconicon_TrendYellowUp.gif

Note:The image files are automatically installed at the following path, so that they are easily accessible fromwithin the Web Intelligence component: <BOBJ_INST_DIR>\SAP BusinessObjects EnterpriseXI 4.0\images. If SAP BusinessObjects Mobile is installed on a dedicated server, as SAPBusinessObjects recommends, administrators need to copy these image files from the Mobile server

2011-05-0613

Best practices for mobile document design

Page 14: Xi4 Mobile Bi Rep Design En

and paste them onto the SAP BusinessObjects Business Intelligence platform server at:<BOBJ_INST_DIR>\SAP BusinessObjects Enterprise XI 4.0\images

3.2 Designing Crystal reports for mobile users

When designing Crystal reports for mobile users, verify that only the following elements are includedinto the reports:• Charts• Simple sections and details

Note:SAP BusinessObjects Mobile 4.0 supports viewing Crystal reports created by SAP Crystal Reports andSAP Crystal Reports for Enterprise.

Font displayFont types, sizes, and formats can display differently on different types of mobile devices. It isrecommended that you test your reports on the popular devices used by your mobile users before youmake the reports available to users.

Table typesSAP BusinessObjects Mobile does not support crosstabs, used to analyze OLAP data, in Crystal reports.

Drilling capabilityDrilling into data in Crystal reports is not supported on SAP BusinessObjects Mobile.

PromptsSAP BusinessObjects Mobile only supports static prompts in Crystal Reports.

Linking documents and drill capabilityLinks to external documents and drill capability are not supported in Crystal reports when viewed byusers via a mobile device.

Parameters and filtersSAP BusinessObjects Mobile supports only simple parameters and static filters Crystal reports. Dynamicand cascading parameters and the ability to modify filters are not supported.

ActiveX contentSAP BusinessObjects Mobile does not support ActiveX content in Crystal reports.

Database LogonsSAP BusinessObjects Mobile does not support prompting for database logons in Crystal reports. If aCrystal report includes a database logon, the logon fails and the report cannot be opened.

2011-05-0614

Best practices for mobile document design

Page 15: Xi4 Mobile Bi Rep Design En

Suppression at view timeSAP BusinessObjects Mobile does not support suppression at view time in Crystal reports. The mobileuser cannot suppress sections while viewing a Crystal report.

Refer to the Crystal Reports documentation for more information on creating Crystal Reports.

Related Topics• Designing Web Intelligence documents for mobile users

3.3 Setting up alerters on documents

Mobile device members can subscribe to alerts on specific server documents provided those documentscontain alerters. The following types of alerters are prerequisites for subscribing to alerts on the device:

Required pre-configuration of server documentAlert type supported ondevices

The document is modified on the server.Document Alert

Configure the document with at least one schedule (recurrence) so thatthe user receives an alert when the schedule is executed.

Scheduled Alert

Configure the document with a conditional alerter in SAP Crystal Reportsor the Web Intelligence component. The mobile user receives alerts forall the conditions defined in the report (the user cannot choose to activatea specific condition).

Conditional Data Alert

Configure the document with at least one condition on at least one of thescheduled recurrences so that the mobile user can subscribe to receivean alert each time the selected data fulfills at least one condition in theserver document.

Scheduled ConditionalData Alert

Documents resulting from alerts and schedules can be saved locally to the device. The device userselects this option in the "Alert Properties" screen.

For information on how to schedule documents, refer to the BI Launch Pad User Guide.

Note:For information on how to include conditional alerters on the Web Intelligence and SAP Crystal reports,refer to the Web Intelligence or SAP Crystal Reports documentation.

2011-05-0615

Best practices for mobile document design

Page 16: Xi4 Mobile Bi Rep Design En

2011-05-0616

Best practices for mobile document design

Page 17: Xi4 Mobile Bi Rep Design En

Embedding actions in report cells

SAP BusinessObjects Mobile supports user actions embedded in reports. Embedded actions definedby the document creator enable end users to initiate a communication of a predefined type with anotherapplication by clicking the embedded action hyperlink on the report.

For example, a typical business intelligence action requested by mobile users is the ability to leveragepredefined 'phoneto' or 'smsto' commands to contact a business collaborator who has a relationshipwith the data content of the open reports.

Note:You can embed local actions only on Web Intelligence documents.

Related Topics• Example: embed an action that launches a phone call to the sales representative named on theselected report cell• Quick reference to embedded actions

4.1 Quick reference to embedded actions

The following actions are supported for SAP BusinessObjects Mobile:

2011-05-0617

Embedding actions in report cells

Page 18: Xi4 Mobile Bi Rep Design En

Performs this action...This command...

automatically dials a predefined phone number.phoneto

enables you to send a text message to a predefined recipient.smsto

enables you to retrieve a phone number from the device address book, then eithercall or send a text message to that contact.

Note:plookup local action must be embedded within either the phototo or smsto localaction.

plookup

enables you to retrieve an e-mail address from the address book and then sendan e-mail to that contact.

Note:elookup local action must be embedded within the mailto local action.

elookup

enables you to send an e-mail message to a predefined recipient.mailto

Note:The lookup action is deprecated in SAP BusinessObjects Mobile 4.0 , and is substituted with elookupand plookup local actions. However, documents designed in earlier releases using lookup action stillworks in SAP BusinessObjects Mobile 4.0.

Related Topics• Syntax for actions• Example: embed an action that launches a phone call to the sales representative named on theselected report cell

4.2 Syntax for actions

Understanding the syntaxThe syntax for local actions is:laction://action_name?param1=value1+param2=value2$

For example:

2011-05-0618

Embedding actions in report cells

Page 19: Xi4 Mobile Bi Rep Design En

Supported parame-tersExampleLocal action

num, desclaction://phoneto?num='0123456789'$

phoneto

num, desclaction://smsto?num='0123456789'$

smsto

name, desclaction://phoneto?num=laction://plookup?name='jane doe'$$

plookup

name, desclaction://mailto?to=laction://elookup?name='jane doe'&subject='Meeting'&body='What time is our meeting?'$$

elookup

to, subject, body, desclaction://mailto?to='john'&subject='Meeting'&body='What time isour meeting?'$

mailto

Including promptsYou can include prompts (or parameters) into local actions. The syntax for prompts is:@paramName='Label|type|defaultValue'$

where:• @paramName= indicates a prompt.• label is the string that displays on the menu of the mobile device, before the field into which the

user will input data.• type (optional) is the data type that the user is allowed to enter (the supported types are numeric,

decimal, password, string, url).• defaultValue (optional) is the value that is entered in the field by default.

Note:If you entered a default value, indicate the data type that the device can expect to receive as input.

• $ is a marker that signifies the end of an embedded action.

The lookup action can also take the @num parameter. For example:<a href="laction://phoneto?@num='Enter number|numeric'$">Call</a>

The @ argument indicates to the device that the user can enter the phone number manually. When theuser accesses the report containing this action, the device displays the message "Enter number" andexpects the user to enter a numeric value, that is, a phone number.

Nesting multiple actions in a single commandYou can nest actions to combine more than one action in a single command. For example, to create alink that would look up "Edith Jansen" in the device phone book and then place a call to the numberthat was found, you would use the following URL:laction://phoneto?num=laction://plookup?name=Edith%20Jansen$$

2011-05-0619

Embedding actions in report cells

Page 20: Xi4 Mobile Bi Rep Design En

Note:

1. To include a space, it is necessary to enter %20.2. When nesting multiple actions in single command, each laction must end with $.

Embedding multiple local actions in a particular cell in the reportYou can embed multiple local actions in a particular cell in the report, thereby enabling users to performseveral actions on the cell content. You can simultaneously embed "phoneto", "smsto", and "mailto"local actions on the cell content, and the mobile client displays a contextual menu with call, sms, ande-mail local actions. However, you can perform only one action at a time.

The syntax for embedding multiple local actions is:"mobile://menu?item1=laction1$^item2=laction2$^item3=laction3$" desc=\"item1 description^item2 description^item3 description \"

where:• mobile://menu?

indicates the menu with which you can perform multiple actions on the cell.• item1=laction1^item2=laction2^item3=laction3

indicates menu items with corresponding local actions.• ^ (caret) is a marker that separates menu items.

For example,<a href=\"mobile://menu?action1=laction://phoneto?num=laction://plookup?name= 'John'$$^action2=laction://mailto?to='[email protected]'&body=Test Body&subject=Test Subject$^action3=laction://smsto?num=1234567$\" desc=\"CallJohn^Send Mail to John^Sms John\">MultipleActions</a>

Note:

Each menu item must have a corresponding description, which is the text that appears in the devicemenu. If the number of menu items is not equal to the number of 'desc' provided, then the menu itemsin the contextual menu are displayed as Open link[0], Open link[1] , Open link[2], and so on.

Related Topics• Example: embed an action that launches a phone call to the sales representative named on theselected report cell• Quick reference to embedded actions

4.3 Example: embed an action that launches a phone call to the sales representativenamed on the selected report cell

2011-05-0620

Embedding actions in report cells

Page 21: Xi4 Mobile Bi Rep Design En

As an example of how a local action works, here is a URL from a Web Intelligence report, which usesthe report variable '[SalesREPName] ' to invoke the local device Personal Information Manager application(PIM) for making a phone call:

="<a href=\'laction://phoneto?num=laction://plookup?name='"+[SalesREPName]+"'$$\'desc=\'Call'+[SalesREPName]+'\'>[SalesREPName]</a>"

In this case "Jane Doe" is the current report value of [SalesREPName]. When the mobile user selectsthe hyperlink on the report cell, the option "Call Jane Doe" displays on the device menu. When the userselects "Call Jane Doe" this launches a lookup in the device address book for "Jane Doe" and thenactivates a phone call to the corresponding phone number.

In this example, the formula terms have the following meanings:

DefinitionTerms

The phone call action that is invoked using the resulting phonenumber that the PIM look up delivers from the local directory of thephone.

Note:This feature can only be used if the device has a PIM package thatsupports it. The phone directory must have this name in it to invokethe call successfully.

phoneto?

The plookup action passes a value (phone number) to one of theother two options. This feature can only be used if the device has aPIM package that supports it.

plookup?

The name to submit to the device PIM (Personal Information Managerapplication) for lookup ('Jane Doe' which is the current report valueof [SalesREPName]).

The function uses the first and last name as separate search param-eters, so in the example above the function would search for 'jane'and 'doe' in the directory.

name=

The text that appears on the device menu when the hyperlink in thereport cell containing the action is selected. (For example, 'Call JaneDoe').

desc=

Related Topics• Quick reference to embedded actions• Syntax for actions

2011-05-0621

Embedding actions in report cells

Page 22: Xi4 Mobile Bi Rep Design En

2011-05-0622

Embedding actions in report cells

Page 23: Xi4 Mobile Bi Rep Design En

Linking documents

Note:SAP BusinessObjects Mobile supports document links in Web Intelligence reports, but not in Crystalreports.

Document links are specific actions that enable navigation from one document to another. In the WebIntelligence component, OpenDocument links are created through URL syntax in a cell that looks likethis:

=<a href=\"action_url\" desc=\"action_description\">"+[Cellvalue]+"</a>"

Specifically, the SAP BusinessObjects OpenDocument syntax is as follows:

action_url=\' http://<server>:<port>/BOE/OpenDocument/opendoc/openDocument.jsp?sDocName=<docname>\'

When a link is placed inside a Web Intelligence document, the field containing the OpenDocument linkappears as a hyperlink. Mobile users can move from the source document to the target document bybrowsing to the cell that contains the hyperlink, and then pressingOK or selectingOpen from the menu.

Supported parameters for document linkingSAP BusinessObjects Mobile supports a subset of the Web Intelligence OpenDocument syntax.Specifically, SAP BusinessObjects Mobile supports the following parameters:• sPath

sPath indicates the relative paths to the folder containing the current document, using the followingsyntax:[My+folder],[My+subfolder],

If this parameter is omitted, the function calls the document using the iDocId.

• sDocName

The sDocName parameter can be used without the iDocId when the document name is unique inthe CMS. If two documents in the CMS have the same name, you must use this parameter inconjunction with sPath and/or iDocID. If a unique identifier is not specified and two documentsexist in the CMS under the same name, SAP BusinessObjects Mobile displays the first documentit retrieves when it searches the CMS.

• iDocID

iDocID represents the unique document CUID in the CMS.

• sReportName

sReportName indicates which report to open when the target document contains multiple reports.

• sRefresh

2011-05-0623

Linking documents

Page 24: Xi4 Mobile Bi Rep Design En

sRefresh determines that a refresh is forced when the target document or report is opened.

• lsS[NAME]

lsS[NAME] specifies a value for a single prompt. [NAME] represents the text of the prompt.

• lsM[NAME]

lsM[NAME] specifies multiple values for a prompt. [NAME] represents the text of the prompt.

Note:SAP BusinessObjects Mobile is case sensitive, so you need to use the exact syntax specified above.

For more information about viewing reports and document using URLs, refer the following guides:• Viewing Documents Using OpenDocument• Viewing Crystal Reports Using URL Reporting

2011-05-0624

Linking documents

Page 25: Xi4 Mobile Bi Rep Design En

More Information

LocationInformation Resource

http://www.sap.comSAP BusinessObjects product infor-mation

Navigate to http://help.sap.com/businessobjects and on the "SAP Busi-nessObjects Overview" side panel click All Products.

You can access the most up-to-date documentation covering all SAPBusinessObjects 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 notavailable from the SAP Help Portal. These guides are listed on the HelpPortal accompanied by a link to the SAP Service Marketplace. Customerswith a maintenance agreement have an authorized user ID to accessthis site. To obtain an ID, contact your customer support representative.

SAP Help Portal

http://service.sap.com/bosap-support > Documentation• Installation guides: https://service.sap.com/bosap-instguides• Release notes: http://service.sap.com/releasenotes

The SAP Service Marketplace stores certain installation guides, upgradeand migration guides, deployment guides, release notes and SupportedPlatforms documents. Customers with a maintenance agreement havean authorized user ID to access this site. Contact your customer supportrepresentative to obtain an ID. If you are redirected to the SAP ServiceMarketplace from the SAP Help Portal, use the menu in the navigationpane on the left to locate the category containing the documentation youwant to access.

SAP Service Marketplace

https://cw.sdn.sap.com/cw/community/docupedia

Docupedia provides additional documentation resources, a collaborativeauthoring environment, and an interactive feedback channel.

Docupedia

https://boc.sdn.sap.com/

https://www.sdn.sap.com/irj/sdn/businessobjects-sdklibraryDeveloper resources

2011-05-0625

More Information

Page 26: Xi4 Mobile Bi Rep Design En

LocationInformation Resource

https://www.sdn.sap.com/irj/boc/businessobjects-articles

These articles were formerly known as technical papers.SAP BusinessObjects articles onthe SAP Community Network

https://service.sap.com/notes

These notes were formerly known as Knowledge Base articles.Notes

https://www.sdn.sap.com/irj/scn/forumsForums on the SAP CommunityNetwork

http://www.sap.com/services/education

From traditional classroom learning to targeted e-learning seminars, wecan offer a training package to suit your learning needs and preferredlearning style.

Training

http://service.sap.com/bosap-support

The SAP Support Portal contains information about Customer Supportprograms and services. It also has links to a wide range of technical in-formation and downloads. Customers with a maintenance agreementhave an authorized user ID to access this site. To obtain an ID, contactyour customer support representative.

Online customer support

http://www.sap.com/services/bysubject/businessobjectsconsulting

Consultants can accompany you from the initial analysis stage to thedelivery of your deployment project. Expertise is available in topics suchas relational and multidimensional databases, connectivity, databasedesign tools, and customized embedding technology.

Consulting

2011-05-0626

More Information

Page 27: Xi4 Mobile Bi Rep Design En

IndexA

actionsembedding 17example 20local 17, 18remote 17, 18syntax for 17, 18

Active-XCrystal reports 14

alertercreating 15

alertsicons for Web Intelligence 13

C

crosstabsCrystal reports 14

Crystal reportsdesigning 14mobile limitations 14parameters 14

F

foldersdefault folder 9

fontsCrystal reports 14

I

iconsfor report design 11for reports 13icons

for report alerters 11installation

graphics files 13

L

linksdocuments 23

O

OpenDoc 23

P

parametersCrystal reports 14

phonetoembedded action 17, 20

promptsin local actions 18

R

report design templates 9, 11reports

displaying 7

S

skins 9, 11SMS

embedded action 17syntax

for actions 17, 18

T

templatesfor mobile reports 9, 11

W

Web Intelligencealert icons 13designing documents 11device specific skins 13icons 11linking documents 23

2011-05-0627

Page 28: Xi4 Mobile Bi Rep Design En

2011-05-0628

Index