61_mobiOS_admin_en

SAP BusinessObjects Mobile for iOSDocument Version: 6.1 - 2014-10-29Administrator's Guide

Table of Contents1 About this Document. .......................................................... 62 Target Readership. .............................................................73 About the Application and the Supported BI Content Types. .............................84 What's New in 6.1?. ............................................................115 Administering SAP BusinessObjects Mobile for iOS. .................................. 165.1 Solution Overview. ............................................................. 165.1.1 SAP BusinessObjects Mobile Client. ..........................................175.1.2 SAP BusinessObjects Mobile Server. ......................................... 185.1.3 SAP BusinessObjects Business Intelligence (BI) Platform. ..........................185.2 Platform Support for the Application. ................................................195.2.1 Support on iPhones. .....................................................205.3 Language Support in the App. ..................................................... 215.4 Installing the Required Components. ................................................225.4.1 Installing the SAP BusinessObjects Mobile Application For iOS . ......................225.4.2 Installing the SAP BusinessObjects Mobile Server. ............................... 225.4.3 Installing the SAP BusinessObjects BI Platform Server. ............................255.4.4 Installing the Configuration Server. .......................................... 255.5 Creating and Configuring Server Connections (Including BIOD and Sybase Afaria). ............... 255.5.1 Creating, Importing and Sharing Server Connections Using the App on Device. ...........255.5.2 Configuring Connections for Importing to Mobile for iOS. ...........................265.5.3 Using SAP BI URLs For Managing Connections. ..................................275.6 Single Sign On (SSO) Support on the Mobile BI Platform. ..................................315.6.1 Configuring the Mobile Server for SSO Using Trusted Authentication (REMOTE_USER orUSER_PRINCIPAL or X509 Certificate). ..............................................325.6.2 Configuring the Mobile Server for SSO Using CA SiteMinder . ........................355.6.3 Configuring the Mobile Server for SSO Using SAP Logon Tickets. .....................385.7 Connecting to the SAP Mobility Platform (SMP). ........................................415.7.1 Installing the SAP Mobility Platform (SMP). .................................... 425.7.2 Configuring SMP for Use With the Mobile Server. ................................ 425.7.3 Configuring Mobile Server to Connect to the SMP Server. .......................... 485.7.4 Adding IMO- and REST-Based SMP Connections to the Application On Device. ...........495.7.5 Removing an SMP Connection from the App. ...................................505.7.6 Configuring Single Sign-On (SSO) in SMP Environment. ............................515.7.7 Restrictions of the SMP BOE-Legacy Environment. ...............................545.8 Using SAP BI URLs For Managing Connections. .........................................565.8.1 Creating an SAP BI URL To Add a Corporate Connection. ...........................562 © 2014 SAP SE or an SAP affiliate company. All rights reserved.Administrator's GuideTable of Contents

5.8.2 Creating an SAP BI URL To Add an SUP Connection. ..............................575.8.3 Using URLs To Delete Connections. ..........................................585.8.4 Creating a URL to Modify a Connection. .......................................595.8.5 Creating SAP BI URLs to Add Single Sign On Connections. ..........................605.9 Configuring Application's Behavior by Specifying Properties on the Server. .....................625.9.1 Using URLs To Delete Connections. ..........................................635.10 Granting Users the SAP BusinessObjects Mobile Application Rights on the BI Platform . ............645.11 Customizing Application's Interface Features. ..........................................655.11.1 Mobile Server and Property File Locations Matrix. ................................665.11.2 Using the CMC to Define Properties on BI Platform 4.1. ............................ 675.11.3 Configuring the Thumbnail Background Image of BI Documents. .....................685.11.4 Configuring Document-Specific Help. .........................................705.11.5 Configuring the Collaboration Options. ........................................705.11.6 Configuring the Visibility of BI Document Samples. ...............................725.11.7 Configuring QR Code Scanning. .............................................735.11.8 Configuring the Session Timeout Duration of the Application. ........................735.11.9 Configuring the Auto Update option for BI documents. .............................745.11.10 Configuring the Auto Refresh (polling) option for BI documents list. ................... 755.11.11 Configuring the display of nested categories on the Home screen. .................... 775.12 Configuring Categories on the Mobile Server. ..........................................775.13 Generating SAP BI URLs for Opening BI Documents. .....................................815.13.1 Creating SAP BI URLs For Opening Specific BI Documents or Reports. .................825.13.2 Creating SAP BI URLs For Opening The Latest Instance of BI Documents. ...............835.13.3 Creating SAP BI URLs For Opening BI Documents With Prompts. .....................845.13.4 Creating SAP BI URLs for Opening Specific Sections of the BI Documents With Sections...........................................................................855.13.5 Creating SAP BI URLs for Opening the Latest Available Version of a BI document or ItsInstance. ....................................................................865.14 Understanding the Security Implementation in the App. ...................................875.14.1 Features of Application Password. ...........................................875.14.2 Support for Security Deployments On the Web Application Server. ....................885.14.3 User Data Protection and Privacy Parameters. .................................. 915.15 MDM Configuration Support for iOS 7 Devices. .........................................925.16 Working With Notifications. .......................................................946 Creating Personal Views of Web Intelligence Reports. .................................977 Managing the Mobile support for Dashboards. ......................................1027.1 Using the Mobile Compatibility panel. ...............................................1027.2 Supported components in mobile dashboards. ........................................1037.2.1 Using components in mobile dashboards. .....................................1067.3 Unsupported features in mobile dashboards. ......................................... 108Administrator's GuideTable of Contents © 2014 SAP SE or an SAP affiliate company. All rights reserved. 3

7.4 Saving mobile dashboards to BI platform folders. ...................................... 1098 Managing the Mobile support for Information Spaces and Information Views. .............. 1118.1 Valid Data Format for Augmented Views. .............................................1119 Managing the Mobile Support for Analysis Applications. ...............................1139.1 Installation. ..................................................................1139.2 Configuration Tasks for Mobile Usage of Analysis Applications. .............................1139.2.1 Creating a Mobile Category on the BI Platform. ................................. 1149.2.2 Assigning Analysis Applications to the Mobile Category. ...........................1149.2.3 Configuring the BI Platform for Display of Analysis Applications on iPhones. .............1149.3 Creating Analysis Applications for the iPhone. .........................................1159.4 Further information. ........................................................... 11510 Managing the Mobile Support for SAP Lumira Server or SAP Lumira Cloud. ................11610.1 Configuring the Connection to SAP Lumira server or SAP Lumira Cloud. ...................... 11610.2 Further Information. ........................................................... 11611 Troubleshooting Errors. ........................................................11711.1 Troubleshooting the Mobile Server Error Messages. .....................................11711.1.1 An internal server error occurred while processing the client request (MOB00022). ....... 11711.1.2 Connection to the server could not be established; contact your administrator if theproblem persists (MOB06004). ...................................................11811.1.3 Connection to the server could not be established; try again or contact your administrator(MOB06005). ................................................................11811.1.4 The request has timed out; try again or contact your system administrator (MOB06006)...........................................................................11811.1.5 You are not authorized for this request (MOB06008). ............................ 11911.1.6 Your request is invalid; verify the connection details or contact your administrator(MOB06009). ................................................................11911.1.7 Internal server error occurred while processing your request; try again or contact yoursystem administrator (MOB06010). ................................................11911.1.8 Missing prompt value; select at least one value for the prompt (MOB06011). ............12011.1.9 Verify network connectivity (MOB06021). .....................................12011.1.10 Connection to the server could not be established; try again or contact your administrator(MOB06031). ................................................................12011.1.11 Server returned an error while downloading the document (MOB06060). ..............12011.1.12 This action cannot be performed; verify network connectivity (MOB08002). ............ 12111.1.13 An internal server error occurred while processing your request on hierarchical data; thedocument will be closed; contact your administrator for more information (MOB09001). ...........12111.1.14 There was a problem in opening the document; download the document again or contactyour administrator (MOB06061). ..................................................12211.1.15 Maximum character file size limit exceeded. The document is too large to be processed bythe server. Contact your BusinessObjects administrator (WIS 30272) . .......................12211.2 Troubleshooting the Mobile Client Error Messages. .....................................1234 © 2014 SAP SE or an SAP affiliate company. All rights reserved.Administrator's GuideTable of Contents

11.2.1 Email is not configured on this device (MOB07001). ..............................12311.2.2 Internal server error occurred while processing your request; contact your administrator(MOB07002). ................................................................12311.2.3 Server error prevented the document from refreshing; try again (MOB07003). .......... 12311.3 Configuring Trace Logs for Monitoring on the BI Platform. ................................ 124Administrator's GuideTable of Contents © 2014 SAP SE or an SAP affiliate company. All rights reserved. 5

1 About this Document6 © 2014 SAP SE or an SAP affiliate company. All rights reserved.Administrator's GuideAbout this Document

2 Target ReadershipThis guide is designed to help the following types of users:●●IT administrators who:○○○Install and configure the various components of the SAP BusinessObjects Mobile for iOS solutionincluding the application on the user's device (iPhone or iPad), the SAP BusinessObjects Mobile serverand the SAP BI platform server.Configure various application properties and server properties using the property files on the Mobileserver or by using the CMC (Central Management Console) on the BI platform.Troubleshoot errorsBusiness Intelligence administrators who:○○Manage user rights and permissions for accessing documents and performing actions on BI reports.Manage the accessibility and security of BI documents.Administrator's GuideTarget Readership © 2014 SAP SE or an SAP affiliate company. All rights reserved. 7

3 About the Application and the SupportedBI Content TypesThe SAP BusinessObjects Mobile application for iOS provides access to multiple SAP BusinessObjects BusinessIntelligence (BI) content types to users of the iPhone and iPad devices through a single mobile app.The SAP BusinessObjects Business Intelligence (BI) content supported by the app includes Web Intelligence,Crystal Reports, hyperlinks, Dashboards, Analysis applications, Explorer information spaces/exploration views,and BI HANAbased visualizations (based on the SAP Lumira Server and SAP Lumira Cloud).Using the SAP BusinessObjects Mobile application for iOS, users can:1. Create connections to the SAP BusinessObjects BI platform server and access the various BI documents andanalytics content available on the server.2. Search, view, and download documents on their iPhone and iPad devices.3. Access notifications, refresh documents, bookmark documents, filter document data, drill on document data,view document information in sections, and effectively collaborate with other business users for informeddecision-making.SAP BusinessObjects Web IntelligenceFollowing are some of the key features of SAP BusinessObjects Web Intelligence reports:1. Web Intelligence reports offer capabilities such as filtering, drilling down, displaying data in charts, anddisplaying data based on formulas.2. Data of Web Intelligence reports comes from a variety of data sources, including:Universes (which organize data from relational and OLAP databases into objects)Personal data providers (such as CSV files or Microsoft Excel spreadsheets)Bex queries (based on SAP Info Cubes)Web servicesAdvanced analysis workspacesSAP HANASAP Crystal ReportsFollowing are some of the key features of SAP Crystal Reports:1. SAP Crystal Reports can be based on virtually any data source.2. Formulas, cross-tabs, subreports, conditional formatting, geographic maps and graphs in SAP CrystalReports communicate information visually and effectively.8 © 2014 SAP SE or an SAP affiliate company. All rights reserved.Administrator's GuideAbout the Application and the Supported BI Content Types

SAP BusinessObjects Analysis ApplicationsAnalysis applications are Web applications that allow users to analyze data from SAP NetWeaver BusinessWarehouse (BW) and SAP HANA. They are created using the SAP BusinessObjects Design Studio.The design studio uses latest technologies including HTML 5 rendering and the Eclipse plug-in for designers.SAP BusinessObjects DashboardsSAP BusinessObjects Dashboards (created with a Dashboard Builder) are corporate dashboards with analyticsbased on Universe queries. They are rich in look and feel, and provide support for the following features on Mobile:●●●●●Query pane based data connectivityHierarchies in tablesAdd-on componentsMaps, radar charts, bubble charts, waterfall charts, menus (such as Picture Menu, Accordion menu), listbuilderselectors, and checkboxes.The Nova style themeHyperlink ObjectsHyperlink objects can be created in the BI LaunchPad. A hyperlink object has a name and a URL. On tapping ahyperlink document in the app, it opens a Web view within the application to render the URL contents (by default,the hyperlink does not open the browser on device).NoteIf you want the report to open in a Safari (browser) window, append the parameter with thevalue _blank to the URL. If you do not use this parameter, the target report always opens within theapplication container itself.Visualizations (Based on the SAP Lumira Server and SAP Lumira CloudApplication)The SAP Lumira Cloud application allows users to explore datasets and create visualizations that are stored onthe cloud. It also allows you to upload, share, and delete SAP Lumira documents (.svid), SAP Crystal Reportsdocuments, Design Studio files, Microsoft PowerPoint files, Microsoft Excel worksheets, and CSV files. It alsoallows you to share visualizations with other individual users.NoteFiles can only be shared with individuals using the iPad app, not with teams. For more information on the SAPLumira Server, refer to the SAP Lumira Cloud User guide available at http://help.sap.com/boall_enAdministrator's GuideAbout the Application and the Supported BI Content Types © 2014 SAP SE or an SAP affiliate company. All rights reserved. 9

NoteFor more information on the above BI content types, refer to the documentation available on the SAP HelpPortal-> http://help.sap.com/boall_en10 © 2014 SAP SE or an SAP affiliate company. All rights reserved.Administrator's GuideAbout the Application and the Supported BI Content Types

4 What's New in 6.1?User Experience Improvements● The application now aligns with the flat UI design of iOS 7.●There is support for nested categories in the Browse panel of the application. When you tap on a category, thesub-categories that are available within it appear on a new screen within the panel. Tapping on the subcategoryagain opens the lower sub-categories. This is indicated in the below figure:NoteBy default this property is disabled in the application. If you want sub-categories to appear on tapping acategory on device, set the value of the feature.home.category.nested.enabled property to trueusing client settings on the server. For information on how to edit client settings on the server, refer to theConfiguring Application's Behavior by Specifying Properties on the Server chapter in this guide.●If you have opened a chart in zoom mode, you can return to the report by double tapping the chart on device.Enhancements to Home Screen Refresh and Notifications●●The application Home screen is now auto-refreshed every 15 minutes. When an auto-refresh takes place, theBI documents are re-listed on the Home screen such that they are synchronized with the server. (BIdocuments may be added, removed or updated on the server.)When you refresh the Home screen (using the pull-down gesture) or when it is auto-refreshed, the(Notifications) icon appears in the tool-bar if server updates are available for your downloaded BI documents.You can view and fetch document updates using the panel that appears on tapping theicon. The notifications displayed in the panel include:(Notifications)○○Notifications for downloaded documents that are updated on the server.Notifications for downloaded documents that are removed from the server or are no longer assigned tothe Mobile category.Administrator's GuideWhat's New in 6.1? © 2014 SAP SE or an SAP affiliate company. All rights reserved. 11

○Notifications for mobile-enabled documents that are added new on the server, and are thus available onthe Home screen of the application.Note○○You can configure the auto-refresh duration on the server. For this, you need to set a positive value forthe client setting on the server. If you set thisproperty to zero or a negative value, auto-refresh is disabled. For information on how to edit clientsettings on the server, refer to the Configuring Application's Behavior by Specifying Properties on theServer chapter in this guide.The value passed for (auto-refresh duration) isconsidered in minutes and can be in decimals. It is recommended that you do not specify a very smallvalue for this setting as frequent auto-refresh of the Home screen puts load on the server when usertraffic is high.●The application provides you with an Auto Update option that you can enable using the application Settings.With each refresh of the Home screen, if you want the documents with available updates to be redownloadedfrom the server, without explicitly fetching the updates from the Notifications panel, setAuto Update to ON.12 © 2014 SAP SE or an SAP affiliate company. All rights reserved.Administrator's GuideWhat's New in 6.1?

The figure below displays how the "Notifications" panel appears on tappingwhen it is ON:when auto update is OFF andAdministrator's GuideWhat's New in 6.1? © 2014 SAP SE or an SAP affiliate company. All rights reserved. 13

NoteBy default, the auto-update feature is available in the application. If you want to disable it, you can set thevalue of the client setting to 'false'. For information on how to editclient settings on the server, refer to the Configuring Application's Behavior by Specifying Properties on theServer chapter in this guide.●Whenever there are refresh updates available for your downloaded BI documents, the application icon on thedevice screen displays a notification badge as shown in the below image:The number that appears over the badge is a summation of notifications from all server connections that youhave added in the application. For example, if you have added 3 server connections, and there is 1 updateavailable on first server, 1 update available on the second server and 2 updates available on the third server,the Notifications badge displays the sum of all notifications, which is 4.This number changes dynamically and is always in synchronization with theappears in the tool-bar of the application.(Notifications) icon thatNoteFor more information on the behavior of notifications, see the related topic provided at the bottom.Generic Functional Enhancements●●Embedded images are now supported in the header cells of tables. Earlier, they were only supported in cells ofthe table body.You can access downloaded hyperlink content in “Work Offline” mode of the application. However, this mayrequire internet access based on the URL used in hyperlink.NoteThis feature is not available in the app by default. To enable this feature, you need to specify the property“feature.hyperlink.offline.enabled=true” using client settings on the server. For information on how to editclient settings on the server, refer to the Configuring Application's Behavior by Specifying Properties on theServer chapter in this guide.●You can now control the accessibility of Explorer artifacts and Dashboard documents in the application.Earlier, all Dashboard and Explorer artifacts that existed on the server were listed in the application on device,irrespective of whether or not they were assigned to the Mobile category. However, you can now restrictExplorer artifacts and Dashboard documents to appear in the application only if they are assigned to theMobile category on the server. To accomplish this, you need to define the following properties in themobi.properties file on the server:○For Dashboard documents: Set default.listing.xcelsius.category.only=true14 © 2014 SAP SE or an SAP affiliate company. All rights reserved.Administrator's GuideWhat's New in 6.1?

●○ For Explorer artifacts: Set default.listing.explorer.category.only=trueYou can clear HTTP cache in the application by accessing the following setting:Application Settings Additional Settings Clear Data Remove Application Cache DataWeb Intelligence Enhancements●●●●The application supports Report Element Linking (REL) on stacked bar charts and on tables with breaks. Withthe introduction of this feature, REL is now supported on all types of report parts.OpenDocument URL enhancements:○○○OpenDoc URL can be opened within Lumira stories.The sReportPart and mode parameters are supported in the URL.Navigation to a report part within a section is possible using the OpenDocument URL.The application supports input controls defined on variables with a custom list of values (LOV) defined by thereport designer.The application supports colors of hyperlink and report element link that are custom defined by the reportdesigner. For example, the report designer may have defined specific color for a visited and for an unvisitedlink.For more information on the Web Intelligence enhancements, see the Mobile BI Report Designer's Guide availableon http://help.sap.com/bomobileiosRelated InformationWorking With Notifications [page 94]Administrator's GuideWhat's New in 6.1? © 2014 SAP SE or an SAP affiliate company. All rights reserved. 15

5 Administering SAP BusinessObjectsMobile for iOS5.1 Solution OverviewThe SAP BusinessObjects Mobile solution for iOS allows end users to access the SAP BusinessObjects BusinessIntelligence (BI) content through their iPhone and iPad devices. It is suited to running ad-hoc query reporting andanalysis.This solution contains three essential components:●●●SAP BusinessObjects Mobile client (SAP BI app)SAP BusinessObjects Mobile serverSAP BusinessObjects Business Intelligence (BI) platform serverBesides the above mandatory components, you can also have the following optional elements for enhancedsecurity in your landscape:●●A reverse proxy serverA Sybase Unwired Platform server (with a relay server)The overall SAP BusinessObjects Mobile architecture for server versions XI 3.1 and 4.0 is shown in the followingillustration:16 © 2014 SAP SE or an SAP affiliate company. All rights reserved.Administrator's GuideAdministering SAP BusinessObjects Mobile for iOS

For Business Intelligence platform 4.1, the architecture includes the SAP BusinessObjects Explorer server in theBI platform. The architecture is shown in the following illustration:Related InformationSAP BusinessObjects Mobile Client [page 17]SAP BusinessObjects Mobile Server [page 18]SAP BusinessObjects Business Intelligence (BI) Platform [page 18]5.1.1 SAP BusinessObjects Mobile ClientThe SAP BusinessObjects Mobile app for iOS is the client. Using this app, professionals can access BusinessIntelligence content from their iPad and iPhone devices. The application gives its users access to the followingtypes of BI documents:●●●●●SAP BusinessObjects Web IntelligenceSAP BusinessObjects interactive Crystal ReportsSAP BusinessObjects DashboardsSAP BusinessObjects Analysis applicationsSAP BusinessObjects Explorer information spaces/exploration viewsAdministrator's GuideAdministering SAP BusinessObjects Mobile for iOS © 2014 SAP SE or an SAP affiliate company. All rights reserved. 17

●SAP BusinessObjects Lumira server and cloud content (HANA visualizations)The documents are displayed on an iPad or iPhone with user interactivity appropriate to the device.The app offers the following functions: document viewing, refreshing, document sharing, navigation, data drilling,data filtering (using prompts and input controls), report data viewing (in sections), and collaboration options.The SAP BusinessObjects Mobile solution runs on data infrastructures based on Wi-Fi, 3G, and 3G+ networks.5.1.2 SAP BusinessObjects Mobile ServerThe SAP BusinessObjects Mobile server is a Web application that can do the following:●Receive requests sent by the SAP BusinessObjects Mobile client and pass them to the SAP BusinessObjectsBI platform server.NoteThe SAP BusinessObjects Mobile client is the "SAP BI" application installed on a client device such asiPhone, iPad, Android phone/tablet, or Blackberry.●●●●Receive the responses (for example, Web intelligence or CR documents, report data or parameter values)from the SAP BusinessObjects BI platform and send them to the SAP BusinessObjects Mobile client (appinstalled on mobile device).Optimize the responses of the Business Intelligence (BI) platform, thus making it suitable for use with theMobile client.Provide flexibility and customization options for client applications such as the types of BI documents, and thedocument layout to be displayed on the device.Provide additional security options such as restricting users from downloading confidential documents.NoteThe application administrator can configure app security and customization options using the variousproperties files on the server. The required configuration details are provided in this document.5.1.3 SAP BusinessObjects Business Intelligence (BI)PlatformThe SAP BusinessObjects BI platform server gives you access to all data captured from corporate databases anddata warehouses by business intelligence (BI) documents. It handles the whole document life cycle includingcreation, catalog, refresh, content delivery, and report interactivity.The SAP BusinessObjects BI platform server processes requests sent by SAP BusinessObjects Mobile clientthrough the SAP BusinessObjects Mobile server, and sends back responses.18 © 2014 SAP SE or an SAP affiliate company. All rights reserved.Administrator's GuideAdministering SAP BusinessObjects Mobile for iOS

Related InformationInstalling the SAP BusinessObjects BI Platform Server [page 25]5.2 Platform Support for the Application1. Device SupportThe SAP BusinessObjects Mobile application for iOS is supported on the following devices:●●●iPhone 4 and aboveiPad miniiPad 2 and aboveNote1. iPad 1 is deprecated.2. Certain application features are not supported on iPhones. For more information, see the relevant sectionof this chapter: Support on iPhones [page 20]2. Operating System SupportThe application is supported on iOS 6.0 and all higher versions up to iOS 7.1NoteiOS versions older than 6.0 are not supported by the application.3. Web Application Server SupportThe Mobile server and BI platform server can be based on one of the following Web Application servers:●●●Apache TomcatIBM WebsphereSAP NetWeaverAdministrator's GuideAdministering SAP BusinessObjects Mobile for iOS © 2014 SAP SE or an SAP affiliate company. All rights reserved. 19

3. BI Platform DependencyTo ensure that you can use the complete application functionality, you require SAP BusinessObjects BI platform4.0 Support Package 8 or 4.1 Support Package 2. However, the application is backward compatible and the legacyfeatures of the application still work on older server versions (including XI 3.1 SPXX, 4.0 SPXX).For information on the application features-versus-server compatibility for new features of the application, referto the relevant section of this chapter. For the detailed compatibility matrix including legacy features of theapplication, refer to the Application Features versus the BI platform Server Compatibility guide at http://help.sap.com/bomobileiosNoteThe application is also supported on the Crystal Report SAP BusinessObjects Edge 4.0 and SAPBusinessObjects Edge 4.1. For information on SAP BusinessObjects Edge, refer to http://help.sap.com/boall_en/4. Data Sources SupportTo create a Web Intelligence document or add new data to a document, use queries to retrieve data from a datasource to the document.Depending on the interface you are using, you can create queries based on:1. Universes, which represent data in relational or OLAP databases as objects.2. Local data sources such as text files or Microsoft Excel files3. SAP Info Cubes in a SAP BW Business Warehouse by using BEx queries.4. Pioneer data sources5. Web servicesAll the above Web Intelligence data sources and HANA are now supported by the application.5.2.1 Support on iPhonesUsers can now install and use the SAP BusinessObjects Mobile application for accessing SAP BI data on iPhonedevices. All application features are supported on the iPhone except for:●●●●●AnnotationSAP JAM and SAP StreamWork collaboration (discussions and activities)"Page layout" model of displaying report parts on the device screenExploration views (created using the SAP BusinessObjects Explorer server)Dashboards20 © 2014 SAP SE or an SAP affiliate company. All rights reserved.Administrator's GuideAdministering SAP BusinessObjects Mobile for iOS

NoteOn the iPhone, each app page (single screen) accommodates one report part. If blank cells are hooked to areport part, they appear along with the report part on the same screen. For information on configuring blankcells in reports, see the Mobile BI Report Designer's Guide.5.3 Language Support in the AppThe SAP BusinessObjects Mobile application for iOS provides support for the following language locales:●●●●●●●●●●Simplified ChineseJapaneseRussianPolishFrenchGermanPortugueseSpanishArabicHebrewNoteDesign Studio content is not supported in the Hebrew language.NoteBoth Product locale and the Viewing locale (as configured on device) are supported in the app.●●You configure the product locale on an iPad by choosing the following option:Settings General International LanguageYou configure the viewing locale on an iPad by choosing the following option:Settings General International Region FormatThe Product locale and the Viewing locale settings that you make on the device take precedence over the settingsyou make for the same parameters in the BI LaunchPad.Administrator's GuideAdministering SAP BusinessObjects Mobile for iOS © 2014 SAP SE or an SAP affiliate company. All rights reserved. 21

5.4 Installing the Required Components5.4.1 Installing the SAP BusinessObjects Mobile ApplicationFor iOSYou install the SAP BusinessObjects Mobile application on your iOS device by downloading the application directlyfrom the iTunes app store to your device.NoteIf you delete the existing app version from your device and install the latest version, you need to add new serverconnections, and all your password information and downloaded documents are lost. However, if you upgradethe application, your data and the server connections remain as they are.5.4.2 Installing the SAP BusinessObjects Mobile ServerPre-requisite:Your Web Application server has the the same version as the SAP BusinessObjects BI platform server.NoteThe SAP BusinessObjects Mobile server can be installed on the same Web application server on which otherSAP BusinessObjects BI platform Web applications are deployed.For BusinessObjects Enterprise XI 3.1, SP xx, and BI platform server versionsup to 4.0, Support Package 4For information on how to deploy the SAP BusinessObjects Mobile server based on the BI platform version, yourWeb application server, and your operating system, refer to the Installation and Deployment Guide:● http://help.sap.com/bomobilexi31 (for XI 3.1)● http://help.sap.com/bomobile40 (for BI 4.0)For BI platform 4.1, BI platform 4.0, Support Package 5 and higherIn version 4.0, Support Package 5 of the SAP BusinessObjects Mobile server and higher, and on BI 4.1, theMobileBIService.war and MOBIServer.war files are auto-deployed. For more information on how to autodeploythe SAP BusinessObjects Mobile server, refer to the Installation and Deployment Guide:22 © 2014 SAP SE or an SAP affiliate company. All rights reserved.Administrator's GuideAdministering SAP BusinessObjects Mobile for iOS

● http://help.sap.com/bomobile41 (for BI 4.1)● http://help.sap.com/bomobile40 (for BI 4.0)NoteIn release 5.1 and higher, the SAP BusinessObjects Mobile application for iOS only allows connections totrusted servers. A trusted server is a server with secure server certificates signed by certificate authorities(CAs) that are trusted by iOS. If the server is not trusted and users try to add a server connection in theapplication, they encounter an error. For more information, refer to the related topic below.Related InformationEnsuring that the Mobile Server is Trusted [page 23]5.4.2.1 Ensuring that the Mobile Server is TrustedIf you are using HTTPS to connect to your SAP BusinessObjects Mobile server, the SAP BI application (for iOS andAndroid) only allows connections to trusted servers. In order for the application to establish successfulconnections to a server, it is essential that one of the following conditions is met:●●Your server is trusted. This means that the server has secure server certificates from a Certificate Authority(CA), and these CAs are trusted by iOS (such as Verisign, Thawte and others listed at http://support.apple.com/kb/ht5012 )The root certificate of your server is installed on the client device (iPhone or iPad) as a profile, which meanswhen the connection to the server is added in the application, the device can verify the server certificate.If one of the above conditions is not met, and you try to add a server connection in the application, you encounteran error like this:Connection to the server could not be established (MOB06031) (HTTP-1202) Details: The certificate for this serveris invalid. You might be connecting to a server that is pretending to be , whichcould put your confidential information at risk.If you are not using a root certificate that is preinstalled on the user's device (such as a self-signed root certificatecreated by your company), you can distribute it in one of the following ways:●●●Using the Mobile Device Management (MDM) toolsSending the root certificate as an email attachmentHosting the root certificate on a server and sharing the linkFor example, to retrieve the root certificate of a trusted server and to share it with other users, follow theprocedure below:1. Open your browser settings and open the certificates (depending on your browser, the Manage Certificates orCertificates option may appear in one of the tabs).2. In the Certificates window, access the Trusted Root Certification Authorities tab as shown in the figure below:Administrator's GuideAdministering SAP BusinessObjects Mobile for iOS © 2014 SAP SE or an SAP affiliate company. All rights reserved. 23

3. Select the trusted root certificate corresponding to your server, and choose Export. The Certificate Exportwizard appears.4. Follow the prompts to export the certificates.The certificate is saved on your machine. Attach the certificate to an e-mail and send it to the required recipients.Alternatively, host the root certificate on a server and send the URL to the users.When users receive the certificate on their iOS device, they can choose the Install option when they tap the file orURL. Once installed, the certificate appears on the device as a profile, and users can check the installation on theiriPhone or iPad: Settings General Profiles .NoteThe SAP BusinessObjects Mobile application temporarily provides you with an option to bypass the verificationof server certificate. However, this option should only be used in exceptional situations. We recommend thatyou install all the root certificates required for your servers on the device. Alternatively, get your currentservers signed by a CA trusted by iOS. For a list of certificate authorities trusted by iOS, refer to http://support.apple.com/kb/ht5012This temporary option will be removed in a future release of the application.To bypass the verification of server certificate and to establish connections to an uncertified server through theapplication, access Application Settings Additional Settings Security Exceptions and add the names or24 © 2014 SAP SE or an SAP affiliate company. All rights reserved.Administrator's GuideAdministering SAP BusinessObjects Mobile for iOS

the IP addresses (of the servers that you want to be ignored for verification) to the IGNORE SERVER TRUSTCERTIFICATE field.5.4.3 Installing the SAP BusinessObjects BI Platform ServerFor more information about installing the SAP BusinessObjects BI platform server, see the Business IntelligencePlatform Administrator Guide on the SAP Help Portal at http://help.sap.com/boall_enNoteThe SAP Business Objects Business Intelligence (BI) platform was previously known as the SAPBusinessObjects Enterprise (BOE).5.4.4 Installing the Configuration ServerTo enable users to import connections from the Mobile server to the client application on their devices, you needto install a configuration server on your network.Ensure that you have the same version of the Web application server and the SAP BusinessObjects BI platformserver. To install a configuration server, perform the following steps:1. Stop your Web application server.2. Copy the MOBIServer.war from the following SAP BusinessObject BI platform location to the\webapps folder on your Web app server:[Installation directory]\BusinessObjects Enterprise 12.0\java\applications3. Start the Web app server again.5.5 Creating and Configuring Server Connections (IncludingBIOD and Sybase Afaria)5.5.1 Creating, Importing and Sharing Server ConnectionsUsing the App on DeviceRefer to the User guide(available on the SAP Help portal at http://help.sap.com/bomobileios) for information onthe following:1. How to configure BI platform server connections, BI On demand connections and SMP connections using theapplication on the device.2. How to import connections from the Configuration server and the Sybase Afaria server to the application.3. How to share configured connections with other users;Administrator's GuideAdministering SAP BusinessObjects Mobile for iOS © 2014 SAP SE or an SAP affiliate company. All rights reserved. 25

5.5.2 Configuring Connections for Importing to Mobile foriOSPre-requisiteYou have the Configuration server/Sybase Afaria server installed on your network.Configuring connections on the Configuration ServerTo allow users to directly import mobile server connections to the iOS application, you need to update thefollowing file on the Configuration server:\MOBIServer\WEB-INF\server.propertiesFirst make a back-up of the server.properties file. Set the following connection properties in the file for everyconnection that you want to make available for importing:●●●●●DisplayName (mandatory)BOBJ_MOBILE_URLBOBJ_MOBILE_CMSBOBJ_MOBILE_AUTH_METHODBOBJ_MOBILE_CONNECTION_TYPE can have one of the following values:●●●●secEnterprise for EnterprisesecLDAP for LDAPsecWinAD for Windows ADsecSAPR/3 for SAP can be set to one of the following values:●●●Set 1 for Enterprise.Set 2 for XXX.Set 3 for YYY.For example, you can add a connection to the properties file as follows:mobi.connections=connection1connection1.DisplayName=SAMPLE Connectionconnection1.BOBJ_MOBILE_URL=http://11.22.33.44:8080connection1.BOBJ_MOBILE_CMS=55.66.77.88connection1.BOBJ_MOBILE_AUTH_METHOD: secEnterpriseconnection1.BOBJ_MOBILE_CONNECTION_TYPE:1NoteSeveral users of the SAP BusinessObjects BI platform might have common user names. Therefore, when youconfigure BOBJ_MOBILE_USER_NAME, create a unique username.26 © 2014 SAP SE or an SAP affiliate company. All rights reserved.Administrator's GuideAdministering SAP BusinessObjects Mobile for iOS

Configuring connections on the Sybase Afaria serverTo enable users to import connections from the Sybase Afaria server, you need to perform the followingconfiguration:1. In Sybase Afaria server, navigate to Policy Edit iOS Enterprise Application Configuration .2. In the view that appears, upload and save the following XML file (in text format):123For each connection, set the connection properties as shown above. The properties for each connection arethe same as in the server.properties file on the Configuration server.Once you save this file on the Afaria server configuration, users can import connections from Sybase Afariausing the Mobile for iOS application.5.5.3 Using SAP BI URLs For Managing Connections5.5.3.1 Creating an SAP BI URL To Add a CorporateConnectionBy creating an SAP BI URL and making it available to users of the SAP BusinessObjects Mobile for iOS application,you enable users to easily add connections from the Mobile client to the SAP BusinessObjects BI platform server.Users access the SAP BI URL on their iOS device (iPhone or iPad) and launch the Connection details screen. Thisscreen is pre-populated with the values for all required input parameters (set by you). The users then save theconnection.This avoids user errors made when a connection is created manually. This can occur when the user enters theinput parameter values on the Connection details screen of the app, for example. Possible errors include an invalid, incorrect , invalid .To create the URL for a Corporate connection, you need to specify values for the required parameters using thefollowing format:Administrator's GuideAdministering SAP BusinessObjects Mobile for iOS © 2014 SAP SE or an SAP affiliate company. All rights reserved. 27

sapbi://addconnection?ConnectionType=BOEConnection&name=ConnectionName&server_url=ServerName/IP:Port&cms=ServerName/IP:Port&authType=AuthenticationType&default=yes/nowhere can have one of the following values:●●●●secEnterprise for EnterprisesecLDAP for LDAPsecWinAD for Windows ADsecSAPR/3 for SAPFor example, assume you are using the following parameters:●●●Connection Name = ManufacturingServer URL = https://yoda.corp.com:8080CMS: Luke77The corresponding URL for the above parameter values would be:sapbi://addconnection?name=Manufacturing&server_url=https://yoda.corp.com:8080&cms=Luke77&authType=secEnterprise&default=noOnce the SAP BI URLis created, you can share it with users by e-mailing it to them.Guidelines for URL ParametersConnection TypeThe connection type for a Corporate connection is a constant value: BOEConnectionConnection NameYou can use alphanumerics, hyphens, underscores, periods, and round brackets; the maximum number ofcharacters allowed is 20.Server URL●●●You can use alphanumerics, hyphens ('-'), underscores ('_'), periods ('.'), 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://: or https://:.If you want to connect to the mobile server with reverse proxy, add the proxy context path after the port in theserver URL. For example, http://:/ or http://:/.5.5.3.2 Creating an SAP BI URL To Add an SUP ConnectionLike Corporate connections, you can create a URL that allows users to create valid connections to the mobileserver by using the Sybase Unwired Platform (SUP). This means, you prevent users from creating connectionsmanually and thereby, from unintentionally creating invalid connections.28 © 2014 SAP SE or an SAP affiliate company. All rights reserved.Administrator's GuideAdministering SAP BusinessObjects Mobile for iOS

An SUP URL should have this format:sapbi://addconnection?ConnectionType=SUPConnection&Application_ID=MobiApp&Sec_Config=MobiSec&server_url=10.53.129.243&SUP _Port=5001&SUP_Farm_ID=0For an explanation of the parameter values in the above URL, refer to the following topic:Adding IMO- and REST-Based SMP Connections to the Application On Device [page 49]Related InformationConnecting to the SAP Mobility Platform (SMP) [page 41]5.5.3.3 Using URLs To Delete ConnectionsPre-requisiteRecipients of the SAP BI URLs (created using the format explained in this topic) have:1. Access to the SAP BusinessObjects BI platform server/ SAP BusinessObjects Mobile server specified in theURL.2. The SAP Mobile for iOS app installed on their iPhone or iPad device.Deleting all connectionsTo delete all active connections including Corporate, BIOD and SUP, use (or provide) the URL:Sapbi://DeleteConnection?ConnectionType=ALLDeleting specific Corporate connectionsTo remove a specific Corporate connection from the application, append the URL with the specific details of theconnection as shown below:sapbi://DeleteConnection?ConnectionType=BOEConnection&name=Tom&server_url=10.53.10.10:8080&cms=10.53.10.10&authType=secEnterprise&default=no&user=UserNameAdministrator's GuideAdministering SAP BusinessObjects Mobile for iOS © 2014 SAP SE or an SAP affiliate company. All rights reserved. 29

Deleting a Sybase connectionTo delete a Sybase connection, use the URL:Sapbi://DeleteConnection?ConnectionType=SUPConnectionDeleting a BIOD connectionTo delete a BIOD connection, use the URL:Sapbi://DeleteConnection?ConnectionType=BIODNoteBefore you delete an SUP connection, ensure that you Deregister from SUP using the Settings screen of theapp. Otherwise, problems may occur when creating connections in future.5.5.3.4 Creating a URL to Modify a ConnectionPre-requisiteRecipients of the SAP BI URLs (created using the format explained in this topic) have:1. Access to the SAP BusinessObjects BI platform server/ SAP BusinessObjects Mobile server specified in theURL.2. The SAP Mobile for iOS app installed on their iPhone or iPad device.Modifying Corporate ConnectionsTo modify an existing Corporate connection, create a URL with the following format:sapbi://ModifyConnection?ConnectionType=BOEConnection&ConnectionName_Prev=Conn1&ConnectionName_New=Conn2&Server_Url_Prev=10.53.10.10:8080&Server_Url_New=10.10.10.10:1010&CMS_Prev=10.53.10.10&CMS_New=10.10.10.10&AuthType_Prev=secEnterprise&AuthType_New=secLDAP&default=yes&UserName_Prev=AdministratorFor every parameter in the URL, you need to include1. _PrevPrevious (current) value of the parameter2. _NewNew value for the parameter30 © 2014 SAP SE or an SAP affiliate company. All rights reserved.Administrator's GuideAdministering SAP BusinessObjects Mobile for iOS

NotePrevious values of connection parameters in the URL help identify the specific Corporate Connection to bemodified on the device.Tapping this URL on the device, overwrites the parameter values of the existing Corporate connection with newvalues and the connection is modified.Modifying SUP ConnectionsTo modify an SUP connection, you need to pass the new parameter values in the SUP connection URL. Here is anexample:sapbi://ModifyConnection?ConnectionType=SUPConnection&Application_ID=MobiApp1&Sec_Config=MobiSec1&server_url=10.10.10.10&SUP_Port=5001&SUP_Farm_ID=0Tapping this URL on the device, overwrites the parameter values of the existing SUP connection with the newvalues passed in the URL and the connection is modified.NoteBecause only one SUP connection can exist for the SAP BI application on the device, the old values of theconnection parameters do not need to be included in the URL. Passing the new values in the URL simplyoverwrites the old values with the new values.To understand how an SUP Connection URL is generated, follow the link below.Related InformationAdding IMO- and REST-Based SMP Connections to the Application On Device [page 49]5.6 Single Sign On (SSO) Support on the Mobile BI PlatformThis topic elaborates the Single Sign On support in the SAP BI application and the Mobile BI landscape.The SAP BusinessObjects BI platform supports the Single Sign On capability with the following authenticationtypes:●●●●SAPLDAPWinADEnterpriseAdministrator's GuideAdministering SAP BusinessObjects Mobile for iOS © 2014 SAP SE or an SAP affiliate company. All rights reserved. 31

The Mobile server and the SAP BI application do not support WinAD with SSO. Other authentication types aresupported in the following ways:1. SAP authentication in SSO is supported through SAP Logon tickets:○○Through custom applications that log on to SAP systems, generate the required SAP logon token, andpass it back to the Mobile BI client (the SAP BI application).Through a FORM-based URL (such as the SAP portal) that authenticates the user, and gives him/her therequired MYSAPSSO2 cookie to proceed.2. LDAP authentication in SSO is supported through CA SiteMinder.3. Enterprise authentication in SSO is supported through trusted authentication (via X509 certificate,REMOTE_USER or USER_PRINCIPAL).The sub-sections of this chapter explain how to configure the Mobile server for SSO with various authenticationtypes.5.6.1 Configuring the Mobile Server for SSO Using TrustedAuthentication (REMOTE_USER or USER_PRINCIPAL or X509Certificate)Deployment Options●●Basic or FORM authentication configured on the Mobile Server (required for REMOTE_USER orUSER_PRINCIPAL).SSL configured with certificate challenge (required for X509 certificate SSO)Pre-requisites1. The SAP BusinessObjects BI platform is configured for trusted authentication.NoteFor information on how to configure the BI platform for trusted authentication, refer to the followingsources:○○For BI platform server version 4.1, Support Package 3 (latest version), see section 9.2 in http://help.sap.com/businessobject/product_guides/sbo41/en/sbo41sp3_bip_admin_en.pdfFor BI platform server version 4.0, Support Package 9 (latest version), see section 8.2 in http://help.sap.com/businessobject/product_guides/boexir4/en/xi4sp9_bip_admin_en.pdf2. The required server certificates are installed on the BI platform key store and Mobile Server key store.NoteFor information on how to install the server certificates, refer to the following sources:○For BI platform server version 4.1, Support Package 3 (latest version), see section 8.13 in http://help.sap.com/businessobject/product_guides/sbo41/en/sbo41sp3_bip_admin_en.pdf32 © 2014 SAP SE or an SAP affiliate company. All rights reserved.Administrator's GuideAdministering SAP BusinessObjects Mobile for iOS

○For BI platform server version 4.0, Support Package 9 (latest version), see section 7.13 in http://help.sap.com/businessobject/product_guides/boexir4/en/xi4sp9_bip_admin_en.pdfConfiguring the Mobile Server (MobileBIService) for Single-Sign-On UsingTrusted AuthenticationYou need to modify the authscheme.properties and sso.properties files on the Mobile server.Note1. By default, these properties files are deployed at the following location on the server machine:\webapps\MobileBIService\WEB-INF\config\defaultNoteThe is the folder on your specific application server, for example C:\ProgramFiles\Apache Software Foundation\Tomcat 6.02. We recommend that you make a backup of these files before modifying them. Alternatively, save the files ina custom folder, and then modify them. For example, \webapps\MobileBIService\WEB-INF\config\customUpdating the authscheme.properties FileOpen the authscheme.properties file and uncomment one of the following lines based on your requirements:# allows you to configure User Principal with Trusted connection to BOE#TRUST_USER_PRINCIPAL=com.businessobjects.mobilebi.server.logon.impl.TrustedAuthUserPrincipal# allows you to configure X509 certificate with Trusted connection to BOE# TRUST_X509=com.businessobjects.mobilebi.server.logon.impl.TrustedAuthX509Updating the sso.properties FileOpen the sso.properties file and define your CMS alias with the properties for your SAP BusinessObjects backend (for SSO through trusted authentication). To do this, uncomment the lines and specify the requiredparameters as described in the following table:File (sso.properties) Parameter Purpose Exampledefault.cms.identifier Specifies the default CMS ID default.cms.identifier =cms1.aliasesSpecifies the IP Address/Qualifiedname/Alias for your CMScms1.aliases = 10.X.X.XAdministrator's GuideAdministering SAP BusinessObjects Mobile for iOS © 2014 SAP SE or an SAP affiliate company. All rights reserved. 33

File (sso.properties) Parameter Purpose ExampleNoteYou can pass the FQN of the SAPBusinessObjects back end server aswell..authentication.scheme.trusted.auth.sharedsecret.trusted.auth.user.retrievalSpecifies the authentication scheme(set to 'TRUST_X509' for trust-basedauthentication mechanisms)Specifies the secret key that isgenerated on the BI platform server fortrusted authentication .Specifies the mechanism of retrievinguser ID:.authentication.scheme=cms1.authentication.scheme=TRUSTcms1.trusted.auth.sharedsecret=cms1.trusted.auth.user.retrieval=REMOTE_USER●●●Set to "REMOTE_USER" forHttpServletRequest.getRemoteUser().Set to "USER_PRINCIPAL" for userprincipal.Set to "X509" when theauthentication scheme isTRUST_X509.product.locale Specifies the default product locale cms1.product.locale=en.preferred.viewing.locale.authentication.typeSpecifies the preferred viewing localeSpecifies the authentication type (suchas 'secLDAP'/'secEnterprise'/'secSAPR3')cms1.preferred.viewing.locale=encms1.authentication.type=secSAPR3Configuring the Client (Configuration Server) for Single-Sign-On Using TrustedAuthenticationUsers can only add Single-Sign-On (SSO) connections in the application by importing connections from theconfiguration server. They cannot manually create connections. To enable users to import SSO connections usingtrusted authentication into the application, you need to create the required connections on the MobileConfiguration server. Connections on the configuration server are created by updating the server.propertiesfile.To create connections on the Configuration server, perform the following steps:1. Access the server.properties file at \webapps\MOBIServer\WEB-INF\config\default34 © 2014 SAP SE or an SAP affiliate company. All rights reserved.Administrator's GuideAdministering SAP BusinessObjects Mobile for iOS

Note○○Before modifying the properties file, we recommend that you make a backup of the existing file. Savethe default file in a custom folder (\MobileBIService\WEB-INF\config\custom)and then do your modifications.The is the folder on your specific application server, for example C:\ProgramFiles\Apache Software Foundation\Tomcat 6.0.2. Add (or modify the values of) the following lines in the server.properties file and save the file:SSOTrustedAuthBasicUserPrincipal.DisplayName:SSO_Trusted_Auth_Basic_UserPrincipalSSOTrustedAuthBasicUserPrincipal.BOBJ_MOBILE_URL: http://10.X.X.X:portSSOTrustedAuthBasicUserPrincipal.BOBJ_MOBILE_CMS: 10.X.X.X or FQN of the SAPBusinessObjects BackendSSOTrustedAuthBasicUserPrincipal.BOBJ_MOBILE_SSO_ENABLED:trueSSOTrustedAuthBasicUserPrincipal.BOBJ_MOBILE_SSO_TYPE:TRUSTED_AUTH_BasicNoteThe following parameters are mandatory for specifying the single-sign-on-trusted-authenticationconnection:○○BOBJ_MOBILE_SSO_ENABLED:trueBOBJ_MOBILE_SSO_TYPE:TRUSTED_AUTH_BasicNoteFor a form-based trusted authentication setup, the SSO_TYPE is TRUSTED_AUTH_FORM. Forexample, for an X509 certificate setup, you specify the following configuration:SSOX509Mandatory.BOBJ_MOBILE_SSO_ENABLED:trueSSOX509Optional.BOBJ_MOBILE_SSO_TYPE:X509CertificateSSOX509Optional.BOBJ_MOBILE_CERTIFICATE_REQUIRED_FOR_NETWORK:CertificateOptionalThe parameters SSOTrustedAuthBasicUserPrincipal and SSOX509Mandatory are user-defined andcan have any name.5.6.2 Configuring the Mobile Server for SSO Using CASiteMinderDeployment OptionsThe application supports both Basic and Form based protected URL access, using the SiteMinder Web agent.Administrator's GuideAdministering SAP BusinessObjects Mobile for iOS © 2014 SAP SE or an SAP affiliate company. All rights reserved. 35

Pre-requisites1. You have configured the SAP BusinessObjects BI platform for LDAP authentication (using SiteMinder).NoteFor information on how to configure the BI platform for LDAP authentication, refer to the following sources:○○For BI platform server version 4.1, Support Package 3 (latest version), see section 9.3 in http://help.sap.com/businessobject/product_guides/sbo41/en/sbo41sp3_bip_admin_en.pdfFor BI platform server version 4.0, Support Package 9 (latest version), see section 8.3 in http://help.sap.com/businessobject/product_guides/boexir4/en/xi4sp9_bip_admin_en.pdf2. You have configured the SiteMinder Web agent with the SiteMinder policy server that grants access toapplications requiring URL access.Configuring the Mobile Server (MobileBIService) for Single-Sign-On UsingSiteMinderYou need to modify the authscheme.properties and sso.properties files on the Mobile server.Note1. By default, these properties files are deployed at the following location on the server machine: C:\Program Files\Apache Software Foundation\Tomcat 6.0\webapps\MobileBIService\WEB-INF\config\default2. We recommend that you make a backup of these files before modifying them. Alternatively, you can modifythese files and save them in a custom folder. For example, C:\Program Files\Apache SoftwareFoundation\Tomcat 6.0\webapps\MobileBIService\WEB-INF\config\customUpdating the authscheme.properties FileOpen the authscheme.properties file, and enable the SiteMinder authentication scheme by uncommenting thefollowing line:SiteMinder=com.businessobjects.mobilebi.server.logon.impl.SiteMinderUpdating the sso.properties FileOpen the sso.properties file and define your CMS alias with the properties for your SAP BusinessObjects backend (for SiteMinder SSO). To do this, un-comment the lines and specify the required parameters as described inthe following table:File (sso.properties) Parameter Purpose Exampledefault.cms.identifier Specifies the default CMS ID default.cms.identifier =cms1.aliasesSpecifies the IP Address/Qualifiedname/Alias for your CMScms1.aliases = 10.X.X.X36 © 2014 SAP SE or an SAP affiliate company. All rights reserved.Administrator's GuideAdministering SAP BusinessObjects Mobile for iOS

File (sso.properties) Parameter Purpose ExampleNoteYou can also pass the FQN of theSAP BusinessObjects back endserver..cookie.nameSpecifies the name of cookie if it is notdefault.NoteSiteMinder default cookie isSMSESSIONcms1.cookie.name=SMSESSION.product.locale Specifies the default product locale cms1.product.locale=en.preferred.viewing.locale.authentication.typeSpecifies the preferred viewing localeSpecifies the authentication type (suchas 'secLDAP'/ 'secEnterprise')cms1.preferred.viewing.locale=encms1.authentication.type=secLDAPConfiguring the Client (Configuration Server) for Single-Sign-On UsingSiteMinderUsers can only add Single-Sign-On (SSO) connections in the application by importing connections from theconfiguration server. They cannot manually create connections. To enable users to import SSO connections intothe application, you need to create the required connections on the Mobile Configuration server.To create connections on the Configuration server, perform the following steps:1. Access the server.properties file at \webapps\MOBIServer\WEB-INF\config\defaultNote○○Before modifying the properties file, we recommend that you make a backup of the existing file.Alternatively, modify the default file and save it in the custom folder (\MobileBIService\WEB-INF\config\custom)The is the folder on your specific application server, for example C:\ProgramFiles\Apache Software Foundation\Tomcat 6.02. Add the following lines to the server.properties file and save it:SiteMinder_Basic.DisplayName:SSO_SiteMinder_BasicSiteMinder_Basic.BOBJ_MOBILE_URL:http://10.X.X.X:SiteMinder_Basic.BOBJ_MOBILE_CMS: 10.X.X.X //or FQN of the SAP BusinessObjectsback endSiteMinder_Basic.BOBJ_MOBILE_AUTH_METHOD:secLDAP //(authentication type)SiteMinder_Basic.BOBJ_MOBILE_SSO_ENABLED:trueSiteMinder_Basic.BOBJ_MOBILE_SSO_TYPE:SiteMinder_BASICAdministrator's GuideAdministering SAP BusinessObjects Mobile for iOS © 2014 SAP SE or an SAP affiliate company. All rights reserved. 37

NoteThe following parameters are mandatory for specifying a SiteMinder SSO connection:SiteMinder_Basic.BOBJ_MOBILE_SSO_ENABLED:trueSiteMinder_Basic.BOBJ_MOBILE_SSO_TYPE:SiteMinder_BASICThe parameter name SiteMinder_Basic is user-defined and can have any name.NoteFor a form-based SiteMinder setup, the SSO_TYPE is SiteMinder_FORM..5.6.3 Configuring the Mobile Server for SSO Using SAPLogon TicketsDeployment Options●●You can use a custom application that logs into SAP systems, generates the required SAP logon token, andpasses it back to the Mobile BI client.You can use a form-based URL (such as the SAP portal) that authenticates users, and gives them the requiredMYSAPSSO2 cookie to proceed.Pre-requisites1. The SAP BusinessObjects BI platform is configured for SAP authentication.NoteFor information on how to configure the BI platform for SAP authentication, refer to the following sources:○○For BI platform server version 4.1, Support Package 3 (latest version), see section 9.5 in http://help.sap.com/businessobject/product_guides/sbo41/en/sbo41sp3_bip_admin_en.pdfFor BI platform server version 4.0, Support Package 9 (latest version), see section 8.5 in http://help.sap.com/businessobject/product_guides/boexir4/en/xi4sp9_bip_admin_en.pdf2. SAP systems are configured to generate SAP Logon tickets.3. You must have one of the following:○A custom application deployed on an application server.NoteThe application should be capable of taking the authentication details through URL query parameters,or basic authentication. The application should then be able to connect to SAP systems, log on and38 © 2014 SAP SE or an SAP affiliate company. All rights reserved.Administrator's GuideAdministering SAP BusinessObjects Mobile for iOS

generate the SAP logon ticket, and should be able to pass the MYSAPSSO2 cookie back to the MobileBI client application. This cookie will be used for all future communications with the Mobile Server.○A form-based URL (such as the SAP portal) to log on and generate the required MYSAPSSO2 cookie.NoteThe URL can be a portal URL itself, but we recommend that you use a separate form-based URL forauthentication.Configuring the Mobile Server (MobileBIService) for Single-Sign-On Using SAPLogon TicketsYou need to modify the authscheme.properties and sso.properties files on the Mobile server.Note1. By default, these properties files are deployed at the following location on the server machine: C:\Program Files\Apache Software Foundation\Tomcat 6.0\webapps\MobileBIService\WEB-INF\config\default2. We recommend that you make a backup of these files before modifying them. Alternatively, you can modifythese files and save them in a custom folder. For example, C:\Program Files\Apache SoftwareFoundation\Tomcat 6.0\webapps\MobileBIService\WEB-INF\config\customUpdating the authscheme.properties FileOpen the authscheme.properties file and uncomment the following line:MYSAPSSO2=com.businessobjects.mobilebi.server.logon.impl.MySapSSO2Updating the sso.properties FileOpen the sso.properties file and define your CMS alias with the properties for your SAP BusinessObjects backend (for SSO via SAP Logon tickets). To do this, uncomment the lines and specify the required parameters asdescribed in the following table:File (sso.properties) Parameter Purpose Exampledefault.cms.identifier Specifies the default CMS ID default.cms.identifier =cms1.aliasesSpecifies the IP Address/Qualifiedname/Alias for your CMScms1.aliases = 10.X.X.XNoteYou can also pass the FQN of theSAP BusinessObjects back endserver..cookie.nameSpecifies the name of cookie if it is notdefault.cms1.cookie.name=MYSAPSSO2Administrator's GuideAdministering SAP BusinessObjects Mobile for iOS © 2014 SAP SE or an SAP affiliate company. All rights reserved. 39

File (sso.properties) Parameter Purpose ExampleNoteSAP Logon ticket default cookie isMYSAPSSO2.product.locale Specifies the default product locale cms1.product.locale=en.preferred.viewing.locale.authentication.typeSpecifies the preferred viewing localeSpecifies the authentication type (suchas 'secLDAP'/ 'secEnterprise')cms1.preferred.viewing.locale=encms1.authentication.type=secSAPR3Configuring the Client (Configuration Server) for Single-Sign-On Using SAPLogon TicketsUsers can only add Single-Sign-On (SSO) connections in the application by importing connections from theconfiguration server. They cannot manually create connections. To enable users to import SSO connections intothe application, you need to create the required connections on the Mobile Configuration server. Connections onthe configuration server are created by updating the server.properties file file.To create connections on the Configuration server, perform the following steps:1. Access the server.properties file at \webapps\MOBIServer\WEB-INF\config\defaultNote○○Before modifying the properties file, we recommend that you make a backup of the existing file.Alternatively, modify the default file and save it in the custom folder (\MobileBIService\WEB-INF\config\custom)The is the folder on your specific application server, for example C:\ProgramFiles\Apache Software Foundation\Tomcat 6.02. a. If you are using a custom application in your setup:Add (or modify the values of) the following lines in the server.properties file and save the file:SSOSAPCustomAppQueryString.DisplayName:SSO_SAP_Custom_App_QueryStringSSOSAPCustomAppQueryString.BOBJ_MOBILE_URL: http://10.X.X.X:portSSOSAPCustomAppQueryString.BOBJ_MOBILE_CMS: 10.X.X.X or FQN of the SAPBusinessObjects BackendSSOSAPCustomAppQueryString.BOBJ_MOBILE_SSO_ENABLED:trueSSOSAPCustomAppQueryString.BOBJ_MOBILE_SSO_TYPE:SSO2COOKIE_QueryStringSSOSAPCustomAppQueryString.BOBJ_MOBILE_SSO_QUERY_URL =http://10.X.X.X:port/CustomApp/SSO2Servlet?=val1&=val2SSOSAPCustomAppQueryString.BOBJ_MOBILE_=SSOSAPCustomAppQueryString.BOBJ_MOBILE_=The parameter name SSOSAPCustomAppQueryString is user-defined and can have any name.40 © 2014 SAP SE or an SAP affiliate company. All rights reserved.Administrator's GuideAdministering SAP BusinessObjects Mobile for iOS

NoteIf you specify SSO2COOKIE_QueryString as the value for connection.BOBJ_MOBILE_SSO_TYPE,you require a custom application that is enabled to generate the MYSAPSSO2 cookie on successfulauthentication. Authentication is successful when the user provides parameter values that match whatyou have defined for param1 and param2 in BOBJ_MOBILE_SSO_QUERY_URL.An example of and parameters is User name and Password. When the client(user) provides the User name and Password values that match the values you have specified in yourconfiguration, your custom application should be able to generate the MYSAPSSO2 cookie.b. If you are using a form-based URL in your setup:Add (or modify the values of) the following lines in the server.properties file and save the file:SSOSAPCustomAppForm.DisplayName:SSO_SAP_Custom_App_FormSSOSAPCustomAppForm.BOBJ_MOBILE_URL: http://10.X.X.X:portSSOSAPCustomAppForm.BOBJ_MOBILE_CMS: 10.X.X.X or FQN of the SAPBusinessObjects BackendSSOSAPCustomAppForm.BOBJ_MOBILE_SSO_ENABLED:trueSSOSAPCustomAppForm.BOBJ_MOBILE_SSO_TYPE:SSO_FormSSOSAPCustomAppForm.BOBJ_MOBILE_SSO_Form_URL =http://10.X.X.X:port/CustomApp/index.htmlSSOSAPCustomAppForm.BOBJ_MOBILE_SSO_COOKIE_NAME=MYSAPSSO2SSOSAPCustomAppForm.BOBJ_MOBILE_=SSOSAPCustomAppForm.BOBJ_MOBILE_=The parameter name SSOSAPCustomAppForm is user-defined and can have any name.NoteFor SSO_Form, you require a custom application configured on the SAP J2EE application Server forform-based authentication. The app must be capable of generating the SAP Logon Ticket (similar toSAP portal). The client (mobile application) opens the form in the application and asks users to log on(by passing values for param1 and param2). When the user provides values for these form parameters,your custom application should be able to generate the MYSAPSSO2 cookie on successfulauthentication. Once generated, the MYSAPSSO2 cookie is used for all future communications withthe Mobile Server.5.7 Connecting to the SAP Mobility Platform (SMP)To enable users of the mobile client applications to connect to the SAP BusinessObjects Mobile server using theSAP Mobility Platform (SMP), you need to perform certain configuration steps. These include the following:1. Install SMP on a machine on your network.2. Configure SMP for use with the SAP BusinessObjects Mobile server.3. Configure the SAP BusinessObjects Mobile server to connect to the SMP server.As of the current application release, the SAP BusinessObjects Mobile BI landscape supports two types of SMPconnections:●SMP BOE Legacy (IMO-based traditional connection)The following BI content types are supported for this connection type:Administrator's GuideAdministering SAP BusinessObjects Mobile for iOS © 2014 SAP SE or an SAP affiliate company. All rights reserved. 41

●○○○○Web Intelligence (HTML and as PDFs)Crystal Reports (as PDFs)DashboardsExplorer (information spaces and exploration views)SMP BOE (REST-based new and recommended connection)The following BI content types are supported for this connection type:○○○○○○Web Intelligence (HTML and as PDFs)Crystal Reports (HTML and as PDFs)DashboardsExplorer (information spaces and exploration views)Analysis applications (created using the Design Studio)Hyperlink objectsNote1. You can use REST-based connections (connection type: "SMP BOE Connection") only if your SAP MobilityPlatform (SMP) version is:○○○SUP 2.2, Support Package 4, Patch 10391 or aboveSUP 2.2, Support Package 5, Patch 10397 or aboveSUP 2.3, Support Package 3, Patch 10398 or above2. You can add multiple REST-based SMP connections in the application on an iOS device, but only a singleIMO-based (legacy) SMP connection at a time.3. Do not add a combination of IMO- and REST-based connections in the application, as this may causeissues in rendering HTML content in the application.4. All configuration details in the sub-topics of this chapter likewise apply to both IMO- and REST-based SMPconnections. However, if you want to configure an SMP REST connection, you need to perform severaladditional steps of URL white-listing while configuring SMP for use with the SAP BusinessObjects Mobileserver. These steps are clearly listed in the second sub-chapter (Configuring SMP for use with the SAPBusinessObjects Mobile server).5.7.1 Installing the SAP Mobility Platform (SMP)For detailed information on installing the SAP Mobility Platform, go tohttp://infocenter.sybase.com/help/index.jsp and navigate to SAP Mobility Platform 2.1 ESD #1 InstallationGuide for Runtime 2.15.7.2 Configuring SMP for Use With the Mobile Server●Creating a Security ConfigurationTo connect to a Mobile server, you are required to create a security configuration. To create a securityconfiguration perform the following steps:42 © 2014 SAP SE or an SAP affiliate company. All rights reserved.Administrator's GuideAdministering SAP BusinessObjects Mobile for iOS

1. On the SMP server machine, launch the Mobility Server Cluster Management View.2. In the Mobility Platform Cluster panel that appears on the left, select Security.3. Choose New in the General tab on the right-side panel.The Create Security Configuration window appears.4. Enter a name for the new security configuration (for example ), and choose OK.The new security configuration appears within the Security folder on the left panel.NoteMake a note of the security configuration name. You need this name to configure the SMP connectionon the client application.5. Select the new security configuration in the Mobility Platform Cluster panel.6. Select the Authentication tab on the right panel and choose New.The Add Provider window appears.7. In the Authentication Provider drop-down, select HttpAuthenticationLoginModule.8. In the properties that appear beneath the dropdown, enter a URL in this format:http:///MobileBIService/SUP/VerifyUser/For example: http://10.10.10.10:8080/MobileBIService/SUP/VerifyUser/MobiSec9. Choose OK to close the Add Provider window.The authentication provider you have added appears in the Authentication tab of the new SecurityConfiguration.10. Go to the General tab and choose Validate. This allows you to validate the changes to the securityconfiguration before applying them to the SMP server. Then choose Apply.The security configuration you have added is saved on the Mobility platform server.NoteYou can connect to multiple Mobile servers by creating a security configuration for each one.●Creating an ApplicationAdministrator's GuideAdministering SAP BusinessObjects Mobile for iOS © 2014 SAP SE or an SAP affiliate company. All rights reserved. 43

1. On the SMP server machine, launch the Mobility Server Cluster Management View.2. In the Mobility Platform Cluster panel on the left, select Applications.3. Choose New in the Applications tab on the right-side panel.The Application Creation window appears.●4. In the Application ID field, enter MobiApp.5. In the Display name field, enter a display name.6. Select the security configuration from the drop-down ( configured in step one).7. Choose Finish to complete the procedure.Creating an Application Connection TemplateTo create a connection between your Mobile server and the Application ID (MobiApp), you are required tocreate an application connection template.NoteYou can either create a (new) application connection template or you can edit the existing applicationconnection template that is automatically created when you create the application (in the last procedure).To create an application connection template, perform the following steps:1. In the Mobility Platform Cluster panel on the left, choose Applications.2. Choose Application Connection Template.3. Choose New.The Template pop up appears.44 © 2014 SAP SE or an SAP affiliate company. All rights reserved.Administrator's GuideAdministering SAP BusinessObjects Mobile for iOS

4. In the Template name field, enter the name for the template.5. In the Base template field, choose Default.6. Choose Application Settings, and perform the following substeps:a. In the Application Identifier field, choose MobiApp as the value.b. In the Domain field, choose Default as the value.c. In the Security Configuration field, choose the security configuration you want to connect to.NoteSince you are creating a new application connection template, the Security Configuration shouldbe different from the value (Mobisec) configured while creating the application. If the Applicationidentifier (application ID), the Domain and the Security Configuration values that you enter in thisstep are the same as the ones you specified while creating the application, the system does notallow you to proceed.7. Select Proxy, in the Application Endpoint, enter the URL of the Mobile Server provided by youradministrator. The value should have the format:http:///MobileBIService/MessageHandlerServletFor example, http://10.10.10.10:8080/MobileBIService/MessageHandlerServletAdministrator's GuideAdministering SAP BusinessObjects Mobile for iOS © 2014 SAP SE or an SAP affiliate company. All rights reserved. 45

8. Choose Ok.Whitelisting the Application Endpoint URL (for an SMP BOE Legacyconnection)This section is applicable to you if you are using the SMP server version 2.2.If your SMP server version is 2.2, you need to whitelist the application end point URL.To whitelist a URL, perform the below procedure:1. After creating the application connection template, in the "Mobility Server Cluster Management View", chooseDomains> Default>Connections.2. In the Manage Connections section that appears within the Connections tab on the right of the window,choose New.3. The Add Connection Pool window appears as shown below:46 © 2014 SAP SE or an SAP affiliate company. All rights reserved.Administrator's GuideAdministering SAP BusinessObjects Mobile for iOS

4. Perform the following substeps in the Add Connection Pool window:Enter a name for the Connection pool name.Select "Proxy" for the Connection pool type.Specify the Application Endpoint URL in the Address field. and choose Ok.NoteThe value of Address (Application Endpoint URL) should be of the format http:///MobileBIServiceWhitelisting the Application Endpoint URL for a REST (SMP BOE) connectionThis section is applicable to you if you are using the SMP server version 2.2.If your SMP server version is 2.2, you need to whitelist the application end point URL.To whitelist a URL, perform the below procedure:1. After creating the application connection template, in the "Mobility Server Cluster Management View", chooseDomains> Default>Connections.2. In the Manage Connections section that appears within the Connections tab on the right of the window,choose New.Administrator's GuideAdministering SAP BusinessObjects Mobile for iOS © 2014 SAP SE or an SAP affiliate company. All rights reserved. 47

The Add Connection Pool window appears.3. Perform the following sub-steps in the Add Connection Pool window:Enter a name for the Connection pool name.Select "Proxy" for the Connection pool type.Specify the Application Endpoint URL in the Address field. and choose Ok.NoteThe value of Address (Application Endpoint URL) should be of the format http:///MobileBIService4. In the left panel, select Security in the default domain, and choose Assign.The list of security configurations that are not yet assigned to the default domain appear on the AssignSecurity Configurations screen.5. Select the required security configuration, and choose OK.5.7.3 Configuring Mobile Server to Connect to the SMPServerTo configure the SAP BusinessObjects Mobile server for connecting to the Sybase Mobility Platform, perform thefollowing steps:1. Deploy MobileBIService.war file (version 4.0.3/ 4.0.2.13 or later) on your Web application server.2. Locate the SUP.properties file.NoteThe file location of SUP.properties is the same as for the mobi.properties file. For information on thelocation of mobi.properties file based on your Mobile BI platform server version, see the related topic inthis chapter.3. Insert the following lines in the file:MobiSec.cms=11.22.33.44MobiSec.auth=secEnterpriseNote○○○You will notice that these lines have already been placed as comments in the SUP.properties file.Change the lines from comments to code and update the values of the parameters.Note that MobiSec is the name that you specified for the security configuration setting when you addedit to the SMP server with the Sybase Control Center.Possible values for authentication are: , , , .Also, make sure that the specified IP address of the CMS is correct.4. Save the SUP properties file and restart the Web Application server.5. To verify that the settings on the Mobile server are correct, access this URL in your browser:http:///MobileBIService/SUP/VerifyUser/MobISec48 © 2014 SAP SE or an SAP affiliate company. All rights reserved.Administrator's GuideAdministering SAP BusinessObjects Mobile for iOS

The browser displays an authentication dialog. If you enter a valid user name and password for the CMSspecified in the configuration, you should see an empty page.(MobiSec is the security configuration name in this particular example. Change it to the name you have usedin your settings.)Related InformationMobile Server and Property File Locations Matrix [page 66]5.7.4 Adding IMO- and REST-Based SMP Connections to theApplication On DeviceTo add an IMO-based SMP connection, access the application Settings, tap on Create New Connection and selectSMP BOE Connection (Legacy) as the connection type. .To add a REST-based SMP connection, access the application Settings, tap on Create New Connection and selectSMP BOE Connection as the connection type as .The "Create New Connection" screens for REST- and IMO-based connections that appear after you select theconnection type are shown in the figure below. They have some common and some unique parameters.●●The Security Configuration name is based on the value you have specified when configuring the SMP serverfor Mobile server.See the table below for the server, port and farm ID values that you need to provide to users (depending onwhether you are using a relay server):Administrator's GuideAdministering SAP BusinessObjects Mobile for iOS © 2014 SAP SE or an SAP affiliate company. All rights reserved. 49

NoteA "relay server" is a Web server set up as an intermediary between the client app and the SMP server. Itenables secure load-balanced communication between mobile devices (client applications) and the SAPMobility Platform server.SMP Connection ParameterValue when Relay Server NotusedValue when Relay Server UsedServer Address of SMP server (without port ) Address of relay server (without port)Port 5001 (default) '80' for HTTP and '443' for HTTPSFarm ID 0 Specific to SMP server (non-zerovalue)Note○If the connection between the application and the SMP server/ relay server requires HTTPS:Prefix the server name with "https://" in the Server field. For example, if the SMP server name isrelayserver.acme.org, enter https://relayserver.acme.org in the Server field.Ensure that the SMP server version is 2.1.3 or above.●User Name and Password are the credentials for the CMS configured for the security configuration name inMobile server's SUP.properties file. You need to provide these credentials to the users.NoteYou can configure an SMP connection on your device and share the connection with users (for corporateconnections). When you share a connection, users will receive an email containing the URL of the SMPconnection and they can directly add the connection on their device, without having to configure itmanually.For example, when you share the above connection, the following URL is generated by the app in an emaildraft:sapbi://addconnection?ConnectionType=SMPConnection&Application_ID=MobiApp&Sec_Config=MobiSec&server_url=10.53.129.243&SMP_Port=5001&SMP_Farm_ID=0●●Proxy (for SMP REST connections) is the same as what you specify when white-listing the application endpointURL.Additional Back-End Credentials (for SMP REST connections) are the credentials that you use for logging ontothe BI platform (back end). In case of REST, the credentials that you use to register the application with theSAP Mobility Platform can be different from the credentials that you use to log on to the back end. If both setof credentials are the same, you can keep this property disabled while creating the connection.5.7.5 Removing an SMP Connection from the AppTo remove an existing SMP connection from the app, follow the below procedure:50 © 2014 SAP SE or an SAP affiliate company. All rights reserved.Administrator's GuideAdministering SAP BusinessObjects Mobile for iOS

1. Deregister from SMP and delete the SMP connection using the Settings screen of the app.2. In the SAP Control Center (SCC), verify that the Applications Application Connections tab does notdisplay the user in the list. If the list displays the user, remove it.5.7.6 Configuring Single Sign-On (SSO) in SMP EnvironmentPrerequisitesYou have:1. The SAP BusinessObjects BI platform configured for X509 SSO authentication.2. The SAP Mobility Platform (version 2.2.4 and above) configured for X509 authentication.Configuring the SMP Server for X509 Authentication-Based Single Sign-OnConfigure the SMP server for use with the SAP BusinessObjects Mobile server as described in the related topic ofthis chapter, with only the following difference in step 7 of creating a security configuration:●In the Authentication Provider drop-down, instead of selecting HttpAuthenticationLoginModule, selectCertificateAuthenticationLoginModuleand set the control flag as "Optional". Then add the following properties:Trusted Certificate Store Type=JCEKSTrusted Certificate Store Provider=SunJCETrusted Certificate Store Password=******Validate Certificate Path=”True”Trusted Certificate Store=DREVE:\Sybase\UnwiredPlatform\Servers\UnwiredServer\Repository\SecurityAdministrator's GuideAdministering SAP BusinessObjects Mobile for iOS © 2014 SAP SE or an SAP affiliate company. All rights reserved. 51

Configuring the Mobile Server (MobileBIService) for Single Sign-On UsingX509 AuthenticationYou need to modify the authscheme.properties and sso.properties files on the Mobile server.Note1. By default, these properties files are deployed at the following location on the server machine:\webapps\MobileBIService\WEB-INF\config\defaultNoteThe is the folder on your specific application server, for example C:\ProgramFiles\Apache Software Foundation\Tomcat 6.02. We recommended that you back up these properties files before modifying them. Save the files in a customfolder, and then modify them. For example, \webapps\MobileBIService\WEB-INF\config\customUpdating the authscheme.properties File52 © 2014 SAP SE or an SAP affiliate company. All rights reserved.Administrator's GuideAdministering SAP BusinessObjects Mobile for iOS

Open the authscheme.properties file and un-comment the following line:TRUST_X509=com.businessobjects.mobilebi.server.logon.impl.TrustedAuthX509Updating the sso.properties FileOpen the sso.properties file and define your CMS alias with the properties for your SAP BusinessObjects backend (for SSO via trusted authentication). For this, uncomment the lines and specify the required parameters asdescribed in the following table:File (sso.properties) Parameter Purpose Exampledefault.cms.identifier Specifies the default CMS ID default.cms.identifier =cms1.aliasesSpecifies the IP address/qualifiedname/alias for your CMScms1.aliases = 10.X.X.XNoteYou can pass the FQN of the SAPBusinessObjects back-end server aswell..authentication.scheme Specifies the authentication scheme. .authentication.scheme=cms1.authentication.scheme=TRUST.trusted.auth.sharedsecret.trusted.auth.user.retrievalSpecifies the secret key that isgenerated on the BI platform server fortrusted authentication .Specifies the mechanism of retrievinguser ID.cms1.trusted.auth.sharedsecret=cms1.trusted.auth.user.retrieval=X509.product.locale Specifies the default product locale cms1.product.locale=en.preferred.viewing.locale.authentication.typeSpecifies the preferred viewing localeSpecifies the authentication type (suchas 'secLDAP'/ 'secWinAD'/'secEnterprise'/'secSAPR3')cms1.preferred.viewing.locale=encms1.authentication.type=secEnterpriseConfiguring the Client (Configuration Server) for Single Sign-On Using X509AuthenticationUsers can add single sign-on (SSO) connections in the application only by importing connections from theconfiguration server. (Users cannot manually create them.) So that users can import SSO connections via X509authentication in the application, you need to create the required connections on the mobile Configuration server.Connections on the configuration server are created by updating the server.properties file file.To create connections on the Configuration server, perform the following steps:1. Access the server.properties file available at \webapps\MOBIServer\WEB-INF\config\defaultAdministrator's GuideAdministering SAP BusinessObjects Mobile for iOS © 2014 SAP SE or an SAP affiliate company. All rights reserved. 53

Note○○Before modifying the properties file, it is recommended to take a back up of the existing file. Save thedefault file in a custom folder (\MobileBIService\WEB-INF\config\custom) andthen do your modifications.The is the folder on your specific application server, for example C:\ProgramFiles\Apache Software Foundation\Tomcat 6.02. Add (or modify the values of) the following lines in the server.properties file and save it:SUPSMP_X509.DisplayName:SUP_SSO_REST_X509SUPSMP_X509.BOBJ_MOBILE_CONNECTION_TYPE_STRING=BOESMPSUPSMP_X509.BOBJ_MOBILE_SUP_SERVER = https://10.208.107.23:8002SUPSMP_X509.BOBJ_MOBILE_SUP_PROXY_CONN =X509SUPSMP_X509.BOBJ_MOBILE_SUP_SECURITY_CONFIG_NAME =X509SUPSMP_X509.BOBJ_MOBILE_SSO_ENABLED=trueSUPSMP_X509.BOBJ_MOBILE_SSO_TYPE:X509CertificateSUPSMP_X509.BOBJ_MOBILE_CERTIFICATE_REQUIRED_FOR_NETWORK:CertificateMandatoryNoteThe following parameters are mandatory for specifying a single sign-on X509authentication-basedconnection:○○BOBJ_MOBILE_SSO_ENABLED:trueBOBJ_MOBILE_SSO_TYPE:X509CertificateNoteTo access Design Studio content (Analysis applications) while using the SAP BI application in a REST-basedSMP environment, you need to have one of the following SMP server versions:● SUP 2.2, Support Package 4, Patch 10391● SUP 2.2, Support Package 5, Patch 10397● SUP 2.3, Support Package 3, Patch 10398Related InformationConfiguring SMP for Use With the Mobile Server [page 42]5.7.7 Restrictions of the SMP BOE-Legacy EnvironmentIf you are using an IMO-based (SMP BOE [Legacy]) server connection in your mobile set up, the following BIdocuments based on HTML 5 rendering do not appear in the application:●●Analysis applicationsInteractive Crystal Reports54 © 2014 SAP SE or an SAP affiliate company. All rights reserved.Administrator's GuideAdministering SAP BusinessObjects Mobile for iOS

●Dashboard documents(However, if the Dashboard documents being viewed on mobile are self-contained and do not have databaseconnectivity, they work in the legacy environment without any issues.)Note1. Due to the above restrictions in the legacy SMP environment, we strongly recommend you use RESTbased(SMP BOE) connections in your setup. REST connections also support access to a greater numberof BI content types compared to IMO.2. You can use REST-based connections (connection type: "SMP BOE Connection") only if your SAP MobilityPlatform (SMP) version is :○○○SUP 2.2, Support Package 4, Patch 10391 or aboveSUP 2.2, Support Package 5, Patch 10397 or aboveSUP 2.3, Support Package 3, Patch 10398 or aboveIf you want to continue using the legacy environment, refer to the workarounds to overcome the restriction statedabove.Workaround for viewing all BI documents with the application in a Legacy SMPBOE (IMO) environmentYou can have a direct connection from the SAP BI application to the SAP BusinessObjects Mobile server(MobileBIService). This can be established by opening the Web application server port on the external firewalland allowing direct access from the SAP BI app to the Mobile server, while retaining the SUP connection inparallel.SMP would continue to offer authentication and authorization features, however for data access, the directconnection to the Mobile server would be used by the application.NoteFor Dashboards (with database connectivity) to work in the SUP environment, ensure that the followingconditions are met:●●●The SAP BI app has direct connectivity with the DSWSBOBJ Web services.DSWSBOBJ Web services and the MobileBIService.war are deployed on the same machine (server).The following URLs are whitelisted when configuring SUP in your setup:○○http:///dswsbobje/services/Sessionhttp:///dswsbobje/services/XcelsiusWebServicesFor information on how to white-list URLs, refer to the related topic of this chapter.Administrator's GuideAdministering SAP BusinessObjects Mobile for iOS © 2014 SAP SE or an SAP affiliate company. All rights reserved. 55

Workaround for viewing Crystal Reports documents as PDFs in a Legacy SMPBOE (IMO) environmentConsider the following scenarios:●●You do not want to expose the Mobile server (of any version) in your setup directly to the Internet. SUP is apart of the environment between the client app and the Mobile server.You have upgraded your BI platform/ Mobile server to 4.0, Support Package 5 in the SUP environment, andso you cannot view Crystal Reports documents (the default behavior of Crystal Reports on the SP5 server isinteractive, and interactive Crystal Reports are not rendered with SUP in the current app).In both the above cases you can view the Crystal Reports documents in PDF format (as in prior versions of theapp) in the SUP environment, with the help of the following configuration:1. Access the following file on the Mobile server:[Tomcat_InstallDir]\webapps\MobileBIService\WEB-INF\clientsettings.properties2. Add the following parameter with the value 'true':feature.crystal.showAsPDF=true3. Save the clientsettings.properties file and restart the Web app server.Related InformationConfiguring SMP for Use With the Mobile Server [page 42]5.8 Using SAP BI URLs For Managing Connections5.8.1 Creating an SAP BI URL To Add a CorporateConnectionBy creating an SAP BI URL and making it available to users of the SAP BusinessObjects Mobile for iOS application,you enable users to easily add connections from the Mobile client to the SAP BusinessObjects BI platform server.Users access the SAP BI URL on their iOS device (iPhone or iPad) and launch the Connection details screen. Thisscreen is pre-populated with the values for all required input parameters (set by you). The users then save theconnection.This avoids user errors made when a connection is created manually. This can occur when the user enters theinput parameter values on the Connection details screen of the app, for example. Possible errors include an invalid, incorrect , invalid .To create the URL for a Corporate connection, you need to specify values for the required parameters using thefollowing format:sapbi://addconnection?ConnectionType=BOEConnection&name=ConnectionName&server_url=ServerName/IP:Port&cms=ServerName/IP:Port&authType=AuthenticationType&default=yes/no56 © 2014 SAP SE or an SAP affiliate company. All rights reserved.Administrator's GuideAdministering SAP BusinessObjects Mobile for iOS

where can have one of the following values:●●●●secEnterprise for EnterprisesecLDAP for LDAPsecWinAD for Windows ADsecSAPR/3 for SAPFor example, assume you are using the following parameters:●●●Connection Name = ManufacturingServer URL = https://yoda.corp.com:8080CMS: Luke77The corresponding URL for the above parameter values would be:sapbi://addconnection?name=Manufacturing&server_url=https://yoda.corp.com:8080&cms=Luke77&authType=secEnterprise&default=noOnce the SAP BI URLis created, you can share it with users by e-mailing it to them.Guidelines for URL ParametersConnection TypeThe connection type for a Corporate connection is a constant value: BOEConnectionConnection NameYou can use alphanumerics, hyphens, underscores, periods, and round brackets; the maximum number ofcharacters allowed is 20.Server URL●●●You can use alphanumerics, hyphens ('-'), underscores ('_'), periods ('.'), 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://: or https://:.If you want to connect to the mobile server with reverse proxy, add the proxy context path after the port in theserver URL. For example, http://:/ or http://:/.5.8.2 Creating an SAP BI URL To Add an SUP ConnectionLike Corporate connections, you can create a URL that allows users to create valid connections to the mobileserver by using the Sybase Unwired Platform (SUP). This means, you prevent users from creating connectionsmanually and thereby, from unintentionally creating invalid connections.An SUP URL should have this format:Administrator's GuideAdministering SAP BusinessObjects Mobile for iOS © 2014 SAP SE or an SAP affiliate company. All rights reserved. 57

sapbi://addconnection?ConnectionType=SUPConnection&Application_ID=MobiApp&Sec_Config=MobiSec&server_url=10.53.129.243&SUP _Port=5001&SUP_Farm_ID=0For an explanation of the parameter values in the above URL, refer to the following topic:Adding IMO- and REST-Based SMP Connections to the Application On Device [page 49]Related InformationConnecting to the SAP Mobility Platform (SMP) [page 41]5.8.3 Using URLs To Delete ConnectionsPre-requisiteRecipients of the SAP BI URLs (created using the format explained in this topic) have:1. Access to the SAP BusinessObjects BI platform server/ SAP BusinessObjects Mobile server specified in theURL.2. The SAP Mobile for iOS app installed on their iPhone or iPad device.Deleting all connectionsTo delete all active connections including Corporate, BIOD and SUP, use (or provide) the URL:Sapbi://DeleteConnection?ConnectionType=ALLDeleting specific Corporate connectionsTo remove a specific Corporate connection from the application, append the URL with the specific details of theconnection as shown below:sapbi://DeleteConnection?ConnectionType=BOEConnection&name=Tom&server_url=10.53.10.10:8080&cms=10.53.10.10&authType=secEnterprise&default=no&user=UserNameDeleting a Sybase connectionTo delete a Sybase connection, use the URL:58 © 2014 SAP SE or an SAP affiliate company. All rights reserved.Administrator's GuideAdministering SAP BusinessObjects Mobile for iOS

Sapbi://DeleteConnection?ConnectionType=SUPConnectionDeleting a BIOD connectionTo delete a BIOD connection, use the URL:Sapbi://DeleteConnection?ConnectionType=BIODNoteBefore you delete an SUP connection, ensure that you Deregister from SUP using the Settings screen of theapp. Otherwise, problems may occur when creating connections in future.5.8.4 Creating a URL to Modify a ConnectionPre-requisiteRecipients of the SAP BI URLs (created using the format explained in this topic) have:1. Access to the SAP BusinessObjects BI platform server/ SAP BusinessObjects Mobile server specified in theURL.2. The SAP Mobile for iOS app installed on their iPhone or iPad device.Modifying Corporate ConnectionsTo modify an existing Corporate connection, create a URL with the following format:sapbi://ModifyConnection?ConnectionType=BOEConnection&ConnectionName_Prev=Conn1&ConnectionName_New=Conn2&Server_Url_Prev=10.53.10.10:8080&Server_Url_New=10.10.10.10:1010&CMS_Prev=10.53.10.10&CMS_New=10.10.10.10&AuthType_Prev=secEnterprise&AuthType_New=secLDAP&default=yes&UserName_Prev=AdministratorFor every parameter in the URL, you need to include1. _PrevPrevious (current) value of the parameter2. _NewNew value for the parameterNotePrevious values of connection parameters in the URL help identify the specific Corporate Connection to bemodified on the device.Administrator's GuideAdministering SAP BusinessObjects Mobile for iOS © 2014 SAP SE or an SAP affiliate company. All rights reserved. 59

Tapping this URL on the device, overwrites the parameter values of the existing Corporate connection with newvalues and the connection is modified.Modifying SUP ConnectionsTo modify an SUP connection, you need to pass the new parameter values in the SUP connection URL. Here is anexample:sapbi://ModifyConnection?ConnectionType=SUPConnection&Application_ID=MobiApp1&Sec_Config=MobiSec1&server_url=10.10.10.10&SUP_Port=5001&SUP_Farm_ID=0Tapping this URL on the device, overwrites the parameter values of the existing SUP connection with the newvalues passed in the URL and the connection is modified.NoteBecause only one SUP connection can exist for the SAP BI application on the device, the old values of theconnection parameters do not need to be included in the URL. Passing the new values in the URL simplyoverwrites the old values with the new values.To understand how an SUP Connection URL is generated, follow the link below.Related InformationAdding IMO- and REST-Based SMP Connections to the Application On Device [page 49]5.8.5 Creating SAP BI URLs to Add Single Sign OnConnectionsThis chapter explains the syntax for creating SAP BI URLs using which mobile users can directly add Single SignOn (SSO) connections in the SAP BI application on their devices.SSOConnectionTypeX509 SSOMandatoryX509 SSOOptionalSAP BI URL Syntax (With example values)sapbi://addconnection/?cms=10.X.X.X&isSSO=YES&server_url=https://ServerUrl:port&isCertificateRequired=CertificateMandatory&connection_name=sso_X509Certificate_Mandatory&SSOType=X509Certificate&authType=secEnterprise&ConnectionType=BOEConnectionsapbi://addconnection/?cms=10.X.X.X&isSSO=YES&server_url=https://ServerUrl:port&isCertificateRequired=CertificateOptional&connection_name=60 © 2014 SAP SE or an SAP affiliate company. All rights reserved.Administrator's GuideAdministering SAP BusinessObjects Mobile for iOS

SSOConnectionTypeSAP BI URL Syntax (With example values)sso_X509Certificate_Optional&SSOType=X509Certificate&authType=secEnterprise&ConnectionType=BOEConnectionSSO2CookieSITE MINDERSSO BasicAuthSUP SSO IMOSSO2CookieSUP SSORESTSSO2CookieSUP SSO X509RESTTRUSTEDAUTH BasicUSER_PRINCIPALTRUSTEDAUTH BasicREMOTE_USERSSO SAPCustom AppFORMSSO SAPCustom QueryStringsapbi://addconnection/?cms=10.X.X.X&isSSO=YES&server_url=ServerUrl:Port&connection_name=SSO2Cookie&SSOType=SSO2Cookie&authType=secEnterprise&ConnectionType=BOEConnectionsapbi://addconnection/?cms=10.X.X.X&isSSO=YES&server_url=ServerUrl:port&connection_name=sso_Siteminder_Basic_Auth&SSOType=SITEMINDER_BASIC&authType=secLDAP&ConnectionType=BOEConnectionsapbi://addconnection/?ConnectionType=BOESUPConnection&SUP_Farm_ID=0&Sec_Config=SecurityConfigName&server_url=SUPServer_Url&isSSO=YES&connection_name=SUP_SSO_IMO_SSO2Cookie&SSOType=SSO2COOKIE&Application_ID=MobiApp&SUP_Port=5001sapbi://addconnection/?ConnectionType=BOESMPConnection&isSSO=YES&server_url=SUP_Server_URL&connection_name=SUP_SSO_REST_SSO2Cookie&proxyConnection=MobiApp&SSOType=SSO2COOKIE&Application_ID=MobiApp&Sec_Config=SecurityConfigNamesapbi://addconnection/?ConnectionType=BOESMPConnection&isSSO=YES&server_url=Mutual_SSL_SUPServer_Url&connection_name=SUP_SSO_REST_X509&proxyConnection=X509&SSOType=X509Certificate&Application_ID=MobiApp&Sec_Config=SecurityConfigNamesapbi://addconnection/?cms=10.X.X.X&isSSO=YES&server_url=Server_url&connection_name=SSO_Trusted_Auth_Basic_UserPrincipal&SSOType=TRUSTED_AUTH_Basic&authType=secEnterprise&ConnectionType=BOEConnectionsapbi://addconnection/?cms=10.X.X.X&isSSO=YES&server_url=Server_Url&connection_name=SSO_Trusted_Auth_Form_RemoteUser&SSOType=TRUSTED_AUTH_FORM&authType=secEnterprise&ConnectionType=BOEConnectionsapbi://addconnection/?cms=10.X.X.X&ssoCookieName=MYSAPSSO2&isSSO=YES&server_url=Server_url:Port&connection_name=SSO_SAP_Custom_App_Form&SSOType=SSO_Form&authType=secEnterprise&ConnectionType=BOEConnectionsapbi://addconnection/?cms=10.X.X.X&isSSO=YES&server_url=Server_Url:port&sso2CookieQueryURL=QueryUrl:port/AuthService/SSO2Servlet?j_username=EnterUserName&j_password=EnterPassword&connection_name=SSO_SAP_Custom_App_QueryString&SSOType=SSO2COOKIE_QueryString&authType=secEnterprise&ConnectionType=BOEConnectionAdministrator's GuideAdministering SAP BusinessObjects Mobile for iOS © 2014 SAP SE or an SAP affiliate company. All rights reserved. 61

Related InformationSingle Sign On (SSO) Support on the Mobile BI Platform [page 31]This topic elaborates the Single Sign On support in the SAP BI application and the Mobile BI landscape.5.9 Configuring Application's Behavior by SpecifyingProperties on the ServerPre-requisites1. You have the SAP BusinessObjects Mobile server and the SAP BusinessObjects BI platform server in yournetwork.2. You have the SAP BusinessObjects Mobile (SAP BI) application for iOS installed on your iPhone/ iPad device.You can configure some chief behavioral aspects of the application by configuring the client settings on the SAPBusinessObjects Mobile server.You configure client settings using the clientsettings.properties file on the Mobileserver.Note●●The location of clientsettings.properties file on the SAP BusinessObjects Mobile server is based onthe server version you are using. To find the file-path for your specific server version, refer to the relatedtopic of this chapter.If you are using the BI platform 4.1 and higher versions, you can also use the Central ManagementConsole (CMC) interface for configuring client settings. For information on how to configure client settingsusing the CMC, see the related topic of this chapter.Following is a typical default configuration of the clientsettings.properties file:savePassword=falseofflineStorage=falseofflineStorage.ttl=365offlineStorage.appPwd=trueNoteIf you are using BI platform 4.1 or BI 4.1 SP1, the negative mobile application rights that are granted via theCMC take precedence over the above client settings (properties). For example, if the right To save documentsto the local store of a device is not granted to the user in the CMC, users cannot download BI documents totheir device even if the offlineStorage property is set to true in the client settings.Also note that if the right to save documents is granted in the CMC, but offlineStorage=false in clientsettings, users cannot download BI documents to the mobile device. Only when the right is granted andofflineStorage=true that users can download/save BI documents to the device. For information on how togrant the application rights using the CMC, refer to the related topic of this chapter.62 © 2014 SAP SE or an SAP affiliate company. All rights reserved.Administrator's GuideAdministering SAP BusinessObjects Mobile for iOS

You can add the following features to the file, if you need to customize some of these based on your requirements:●●●●●●●●●●●●●●●●●●feature.email.enabledfeature.collaboration.enabledfeature.annotation.enabledfeature.streamwork.enabledfeature.jam.enabledfeature.jam.urlfeature.jam.consumer.keyfeature.jam.consumer.secretfeature.jam.callback.urlverbfeature.help.enabledfeature.help.urlfeature.help.video.enabledfeature.help.video.playlistfeedfeature.webi.refresh.enabledfeature.webi.reportTitle.enabledfeature.rel.legacy.modefeature.webi.default.palette.enabledfeature.dashboard.sup.enabledThe above listed features are also configurable using the application SDK. For information on the significance andimpact of above features on the application, see the Developer's Guide available at http://help.sap.com/bomobileios .Related InformationUsing the CMC to Define Properties on BI Platform 4.1 [page 67]Mobile Server and Property File Locations Matrix [page 66]Granting Users the SAP BusinessObjects Mobile Application Rights on the BI Platform [page 64]5.9.1 Using URLs To Delete ConnectionsPre-requisiteRecipients of the SAP BI URLs (created using the format explained in this topic) have:1. Access to the SAP BusinessObjects BI platform server/ SAP BusinessObjects Mobile server specified in theURL.2. The SAP Mobile for iOS app installed on their iPhone or iPad device.Administrator's GuideAdministering SAP BusinessObjects Mobile for iOS © 2014 SAP SE or an SAP affiliate company. All rights reserved. 63

Deleting all connectionsTo delete all active connections including Corporate, BIOD and SUP, use (or provide) the URL:Sapbi://DeleteConnection?ConnectionType=ALLDeleting specific Corporate connectionsTo remove a specific Corporate connection from the application, append the URL with the specific details of theconnection as shown below:sapbi://DeleteConnection?ConnectionType=BOEConnection&name=Tom&server_url=10.53.10.10:8080&cms=10.53.10.10&authType=secEnterprise&default=no&user=UserNameDeleting a Sybase connectionTo delete a Sybase connection, use the URL:Sapbi://DeleteConnection?ConnectionType=SUPConnectionDeleting a BIOD connectionTo delete a BIOD connection, use the URL:Sapbi://DeleteConnection?ConnectionType=BIODNoteBefore you delete an SUP connection, ensure that you Deregister from SUP using the Settings screen of theapp. Otherwise, problems may occur when creating connections in future.5.10 Granting Users the SAP BusinessObjects MobileApplication Rights on the BI PlatformOnce installed and configured, the users of an SAP BusinessObjects Mobile application can perform variousactions in the app on device, including:●●Logging on to the application.Downloading BI documents.64 © 2014 SAP SE or an SAP affiliate company. All rights reserved.Administrator's GuideAdministering SAP BusinessObjects Mobile for iOS

●●Sharing BI documents with other business users.Subscribing to document alerts.NoteAlerts are notifications that appear in the application when Web Intelligence documents with conditionalformatting are refreshed or updated on the server. Alerts appear only if the document is subscribed foralerts in the SAP BusinessObjects Mobile application.However, to use the above features and interact with the application, users need to have the necessary rights onthe BI platform.As an administrator, you can grant these application rights to users through the Central Management Console(CMC) by following the procedure below:1. Access the CMC on the BI platform 4.0For example: http://10.10.111.111:8080/BOE/CMC/2. Choose Applications in the drop-down that appears on the CMC page.3. Right click SAP BusinessObjects Mobile and choose User Security.The User Security window appears.4. In the table, select the particular user or user-group to which you want to grant SAP BusinessObjects Mobilerights. Choose Assign Security.5. In the Assign Security window, choose the Advanced tab and choose Add/Remove Rights.The Add/ Remove Rights window appears displaying the specific rights for SAP BusinessObjects Mobile :6. Based on your security requirements, ensure that you have enabled the rights for various actions (such assubscribing to document alerts) by selecting the radio button in the first (tickmark) column.7. Choose Apply, close the User Security: SAP BusinessObjects Mobile window and logout from the CMC.NoteThe rights for SAP BusinessObjects Mobile do not appear in the CMC on any release of the BusinessObjectsEnterprise XI 3.1This feature is supported only on BI platform 4.0 and higher; BI platform 4.1 and higher release versions.5.11 Customizing Application's Interface FeaturesYou can customize the appearance and certain behavioural aspects of the application by performing the requiredconfigurations on the Mobile server. These include application's Home screen and tool-bar appearance, and alsothe time duration after which the application times out.Administrator's GuideAdministering SAP BusinessObjects Mobile for iOS © 2014 SAP SE or an SAP affiliate company. All rights reserved. 65

To quite an extent, the appearance of the Home screen on device is based on the organization of your documentsand the specification of document properties defined in the BI LaunchPad (or your report designing client tool) onthe BI platform. Other UI features are based on a metadata driven approach in which you update variables andtheir values in the .properties files on the Web application server, and restart the server for changes to takeeffect in the application on device.The sub-sections of this chapter explain the configurations required to customize the application.Note1. The server location of the .properties files depend on the Mobile BI platform server version you areusing. See the related topic of this chapter for more information.2. If you have deployed SAP BusinessObjects mobile server 4.1 or 4.1 SP1 in your set-up, you can use theCentral Management Console (CMC) to configure client settings and mobile properties. See the relatedtopic of this chapter for more information.Related InformationMobile Server and Property File Locations Matrix [page 66]Using the CMC to Define Properties on BI Platform 4.1 [page 67]5.11.1 Mobile Server and Property File Locations MatrixSAP BusinessObjects Mobile server versionXI 3.1 SP3, SP4, SP5, SP6BI 4.0, SP5 and lower versionsBI 4.0, SP6BI 4.1File location of clientsettings.properties andmobi.properties\webapps\MobileBIService\WEB-INF\\webapps\MobileBIService\WEB-INF\\webapps\MobileBIService\WEB-INF\config\default\webapps\MobileBIService\WEB-INF\config\defaultNoteThe is the root folder location specific to your deployed application server, for example: C:\Program Files (x86)\SAP BusinessObjects\Tomcat666 © 2014 SAP SE or an SAP affiliate company. All rights reserved.Administrator's GuideAdministering SAP BusinessObjects Mobile for iOS

5.11.2 Using the CMC to Define Properties on BI Platform 4.1If you have deployed SAP BusinessObjects mobile server 4.1 or 4.1 SP1 during your setup, you can use the CentralManagement Console (CMC) to configure client settings and mobile properties. These parameters are otherwiseconfigured through the clientsettings.properties and mobi.properties files on the Mobile server,respectively.You need to explicitly define the following parameter in the MobileBIService\WebContent\WEB-INF\web.xml file, so that the application can identify whether the Mobile configuration is defined on the CMC (BIplatform) or in the properties files on the Mobile server:local-if configuration on server, boe-if configuration in CMCmobile.server.configuration.locationboeIf you specify the context-param value as boe in the file above, your mobile server configuration on the CMC isconsidered.To access mobile properties on the CMC, perform the following steps:1. Open the Central Management Console on the BI platform server and access Applications.You'll find the SAP BusinessObjects Mobile application listed on the page.2. Right-click SAP BusinessObjects Mobile and choose Properties.You'll see the following window:3. Edit the category values in Properties as required.Administrator's GuideAdministering SAP BusinessObjects Mobile for iOS © 2014 SAP SE or an SAP affiliate company. All rights reserved. 67

Note○○For information on the various categories, see the topic Configuring Categories on the Mobile Server ofthe Administrator and Report Designer's guide available at http://help.sap.com/bomobileios.To understand the overall mobile properties and their impact on the application in general, refer to theMobile server Installation and Blackberry Configuration guide available at http://help.sap.com/bomobile404. To edit client settings, choose Client Settings:5. Save your property settings and exit from the CMC.NoteThe negative mobile application rights that are granted via the CMC take precedence over the values specifiedfor client settings via the CMC. For example, if the right To save documents to the local store of a device is notgranted to the user in the CMC, users cannot download BI documents to their device, even if theofflineStorage property is set to true in the client settings.Also note that if the right to save documents is granted in the CMC, but offlineStorage=false in clientsettings, users cannot download BI documents to the mobile device. Downloading/saving BI documents tothe device is possible only if the right is granted and offlineStorage=true.5.11.3 Configuring the Thumbnail Background Image of BIDocumentsBased on your requirements, you can customize the thumbnail image for BI documents that appear as tiles on theHome screen of the application.If you do not configure a thumbnail image for BI documents on the server, the documents display a default image(based on document type) on the Home screen. Once you open the document and return to the Home screen, the68 © 2014 SAP SE or an SAP affiliate company. All rights reserved.Administrator's GuideAdministering SAP BusinessObjects Mobile for iOS

default background image of the thumbnail is replaced by a snapshot of the first report of the document. Thefigure below illustrates this behavior for a Web Intelligence document:However, once configured on the server (BI LaunchPad), the thumbnail background image remains constant onthe Home screen. It does not change even after you open the BI document and return to the Home screen:To configure the thumbnail background image for a BI document, perform the following steps:1. Access the Properties of the document on the BI platform (BI LaunchPad/Web Intelligence Rich client).2. Enter the URL of your image in the Keywords field and choose Save.Note1. The recommended thumbnail image size for best results on the device screen is 208 pixels * 208 pixels.2. The background image size should not be greater than one hundred Kilobyte (100 KB).3. Valid image formats include .jpeg, .jpg and .png.4. If multiple image URLs are specified in the BI document's Keywords field on the BI platform, the applicationconsiders only the last valid image URL for the thumbnail background image.Administrator's GuideAdministering SAP BusinessObjects Mobile for iOS © 2014 SAP SE or an SAP affiliate company. All rights reserved. 69

5. If there are multiple strings specified in the Keywords field, and if the image URL is not the last keywordstring, a space is required between the URL and the comma (for example: keyword1, http://www.xyz.com/myImage.png , keyword2, keyword3).5.11.4 Configuring Document-Specific HelpFor an open BI document on the device, when you tap Help in the secondary report toolbar, the Mobile knowledgecenter (http://help.sap.com/bomobileios) opens by default.If you want to replace this Help URL with some other URL based on your specific requirements for the BIdocument, you can do so by performing the procedure below:1. Access the Properties of the document on the Mobile BI platform (BI LaunchPad/ Web Intelligence Richclient).2. Enter the URL of your custom Help in the Keywords field with the syntax below:docHelpURL=new_URL is your custom URL, for example, http://www.myHelpURL.com3. Choose Save.NoteIn the current release of the application, you can use a BI document's Keywords field to customize either thedocument Help or the thumbnail image. However, you cannot implement both of these functionalities at thesame time.Related InformationConfiguring the Thumbnail Background Image of BI Documents [page 68]5.11.5 Configuring the Collaboration OptionsIn an open BI document on device, users choose Collaborate in the secondary report toolbar to share or discussthe report with business colleagues using SAP JAM. Based on requirements, you can do either of the following:●●Disable collaboration on the server, so that it does not appear as an option in the secondary report toolbar ondevice.Specify SAP JAM or SAP StreamWork as a collaboration options in the server configuration.Note○○By default the application supports SAP JAM as the Web based collaboration tool if no configuration isperformed on the server.Both collaboration tools cannot be simultaneously specified for use by the application. Only one can beused at a time.70 © 2014 SAP SE or an SAP affiliate company. All rights reserved.Administrator's GuideAdministering SAP BusinessObjects Mobile for iOS

To configure collaboration settings based on your specific requirements, perform the following procedure:1. Access the clientsettings.properties file available at the following location on the Mobile server:\webapps\MobileBIService\WEB-INF\config\defaultNote○○The is the root folder location specific to your deployed application server, forexample: C:\Program Files (x86)\SAP BusinessObjects\Tomcat6The location of clientsettings.properties varies based on the Mobile server version you areusing. See the related topic for more information.2. ○ If you want to enable SAP Streamwork as the collaboration tool in the application, follow the belowsubsteps and proceed with step 3.○1. Set the value of following property in the file as 'true'feature.streamwork.enabled=true2. Ensure that the following property is disabled (set to 'false'):feature.jam.enabled=falseIf you want to configure SAP JAM as the collaboration tool (default enabled) based on your specificrequirements, follow the below substeps below:1. Ensure that the following property is disabled (set to 'false')feature.streamwork.enabled=false2. Specify values for the following properties based on their description:PropertyDescriptionfeature.jam.enabled ○ If you set this property to"false", SAP JAM is disabledfor collaboration in theapplication.○If the value is "true" (default),SAP JAM appears as thecollaboration web site whenusers choose Collaborate inthe secondary report toolbar inthe application on device.feature.jam.urlfeature.jam.consumer.keyfeature.jam.consumer.secretfeature.jam.callback.urlverbThe JAM URL to which theapplication should redirect whenusers choose Collaborate insecondary toolbar of BI reports ondevice.The consumer key that is issuedwhen you register the applicationon JAMThe secret key that is issued whenyou register the application onJAM.The link that you specify as theredirection address whileregistering the application. ForAdministrator's GuideAdministering SAP BusinessObjects Mobile for iOS © 2014 SAP SE or an SAP affiliate company. All rights reserved. 71

PropertyDescriptionexample, sapbi://token. Thisensures that the application islaunched when the user clicks thislink (with the URI scheme definedby you).NoteFor SAP JAM to be enabled, it is mandatory that you specify a value for all the above listedparameters.3. Save and close the clientsettings.properties file.4. Restart the Web application server.5. Launch the application on device, connect to the server, open the BI document and validate the result of yourconfiguration by checking the Collaborate option in the secondary report toolbar.Related InformationMobile Server and Property File Locations Matrix [page 66]5.11.6 Configuring the Visibility of BI Document SamplesThis topic explains how you can enable or disable the offline BI document samples that appear in the application(until you add a server connection).1. Access client settings using the clientsettings.properties file on the Mobile server, or the Central ManagementConsole (CMC) interface (if you are using the BI platform 4.1).2. To disable the BI document samples in the application, set the value of the following property to false:feature.show.samples.enabledNote●●See the related topics in this chapter for information on how to access client settings based on the serverversion that you are using.You can also generate custom BI report samples based on your specific requirements, and use them inthe application. For more information, refer to the Developer's Guide published on http://help.sap.com/bomobileiosRelated InformationUsing the CMC to Define Properties on BI Platform 4.1 [page 67]72 © 2014 SAP SE or an SAP affiliate company. All rights reserved.Administrator's GuideAdministering SAP BusinessObjects Mobile for iOS

Mobile Server and Property File Locations Matrix [page 66]5.11.7 Configuring QR Code ScanningIf you do not want users to usel the Scan QR Code option in the application, you can disable it using the clientsettings on the Mobile server. This topic explains how to disable QR code scanning in the application (by default itis enabled in the application).1. Access client settings using the clientsettings.properties file on the Mobile server, or the Central ManagementConsole (CMC) interface (if you are using the BI platform 4.1).2. To disable the QR code scanning in the application, set the value of the following property to false:feature.qrcode.enabledNoteSee the related topics in this chapter for information on how to access client settings based on the serverversion that you are using.Related InformationUsing the CMC to Define Properties on BI Platform 4.1 [page 67]Mobile Server and Property File Locations Matrix [page 66]5.11.8 Configuring the Session Timeout Duration of theApplicationThe number of concurrent sessions running on the SAP BusinessObjects Mobile server can impact itsperformance.If you want a session of an SAP BI mobile application to be terminated after a defined period of inactivity, performthe following configuration on the Mobile server:1. Open the web.xml file found at the following location:\webapps\MobileBIService\WEB-INFNoteThe is the root folder location specific to your deployed application server, forexample: C:\Program Files (x86)\SAP BusinessObjects\Tomcat62. Set the value of the session-timeout parameter found within the tags shown below:60Administrator's GuideAdministering SAP BusinessObjects Mobile for iOS © 2014 SAP SE or an SAP affiliate company. All rights reserved. 73

Note○○○○The session-timeout element defines the default session timeout interval for all sessions created inMobileBIService (Mobile server).The timeout duration begins when the device is locked or the application is sent to the background(user switches to other applications on the device).When a session times out, the user is logged off from the BI platform.The specified timeout must be expressed as a whole number of minutes. In the example above, thetimeout is 60 minutes.If the timeout is zero ('0') or less, sessions never time out.5.11.9 Configuring the Auto Update option for BI documentsYou can configure the Auto Update option for BI documents in CMC. When you enable the Auto update option, ifthere are any updates to the downloaded BI documents on the server, the application automatically downloadsthe updated documents onto your device. In addition, if there are any BI documents available in BI Inbox, they getdownloaded as well.To configure the Auto Update option for BI documents in CMC, perform the following steps:1. Log on to CMC and under the Manage section, choose Applications.2. Double-click SAP BusinessObjects Mobile.3. Choose Client Settings.4. Choose +Add More....5. Add the following keys and the corresponding values.Key Possible Values Descriptionfeature.autoupdate.enabled true, false Set to true to enable the auto updateoption for BI documents.feature.autoupdate.bi.inbox.enabledtrue, falseSet to true to enable the auto updateoption for BI documents locatedin BI Inbox.74 © 2014 SAP SE or an SAP affiliate company. All rights reserved.Administrator's GuideAdministering SAP BusinessObjects Mobile for iOS

6. Choose Save & Close.Once you configure the Auto Update option in CMC, the user needs to enable this feature on the device toautomatically download the updated documents from BI platform server onto the device.5.11.10 Configuring the Auto Refresh (polling) option for BIdocuments listYou can configure the Auto Refresh option also known as polling for BI documents list in CMC. As anadministrator, you can either enable or disable this option by setting the auto-refresh duration on the server.To configure the Auto Refresh option for BI documents list, perform the following steps:1. Log on to CMC and under the Manage section, choose Applications.2. Double-click SAP BusinessObjects Mobile.3. Choose Client Settings.4. Choose +Add More....5. Add the following key and the corresponding value.Key Possible values Descriptionfeature.notification.polling.interval Any positive integer value. By default, auto-refresh happensin every 15 mins interval. You canchange this interval by setting anypositive integer value for the pollinginterval. To disable the auto-refreshoption, set the value to 0.Administrator's GuideAdministering SAP BusinessObjects Mobile for iOS © 2014 SAP SE or an SAP affiliate company. All rights reserved. 75

6. Choose Save & Close.The application Home screen is now auto-refreshed at the specified time interval. When an auto-refresh takesplace, the BI documents are refreshed on the Home screen such that they are synchronized with the server.5.11.10.1 Configuring auto refresh for application running inbackgroundThe auto-refresh duration setting is applicable only when you are running the mobile application in foreground.Once you run the application in background, the iOS takes the control of the polling interval. However, theadministrator can manage background polling in CMC.To manage background polling in CMC, perform the following steps:1. Log on to CMC and under Manage, choose Applications.2. Double-click SAP BusinessObjects Mobile.3. Choose User Security.4. Choose the required user to whom you want to grant or deny rights.5. Choose Assign Security.6. Choose Advanced.7. Choose Add/Remove Rights.76 © 2014 SAP SE or an SAP affiliate company. All rights reserved.Administrator's GuideAdministering SAP BusinessObjects Mobile for iOS

The Subscribe to document alerts right controls background polling. By default, this right is granted to the user. Ifrequired, you can choose to deny this right for the user.5.11.11 Configuring the display of nested categories on theHome screenYou can configure the display of nested categories on the Home screen in CMC.1. Log on to CMC and under the Manage section, choose Applications.2. Double-click SAP BusinessObjects Mobile.3. Choose Client Settings.4. Choose +Add More...5. Add the following key and the corresponding value.Key Possible values Descriptionfeature.home.category.nested.enabledtrue, falseSet to true to enable the display ofnested/sub categories on theHome screen.6. Choose Save & Close.After enabling the feature.home.category.nested.enabled key, when you tap on a category and if it has subcategoriesavailable within it, they appear on a new screen within the panel. Tapping on the sub-category againopens the lower sub-categories (if available).5.12 Configuring Categories on the Mobile ServerA category is a logical classification of BI documents (objects). BI documents are assigned to categories on the BIplatform. In the context of Mobile BI, categories help control various aspects of the BI documents accessedthrough the SAP BI applications on mobile devices.These aspects include:1. Controlling the user accessibility of BI documents:Defining the specific devices on which a BI document can be accessed.Preventing confidential documents from being saved in the device memory.2. Customizing the display layout of BI documents on the mobile device screen. (Display layout of BI documentson device screen can be based on the Card Layout or Page Layout model).3. Organizing BI content based on your custom requirements.Category names are configured in the mobi.properties file on the Mobile server at the following location:[_Home]\webapps\MobileBIService\WEB-INF\mobi.propertiesThere are three types of technical categories to which you can assign a BI document in the document designingtool on the BI platform:Administrator's GuideAdministering SAP BusinessObjects Mobile for iOS © 2014 SAP SE or an SAP affiliate company. All rights reserved. 77

1. Category to allow the BI document to be displayed and accessed on the mobile device.(By default, this category is named "Mobile").2. Category to ensure that the report layout on the device screen is the same as the "page layout" defined on theBI platform.(By default, this category is named "MobileDesigned").3. Category to secure the document. Documents assigned to this category cannot be downloaded and saved inthe device memory. They can only be accessed by users who are connected to the server.(By default, this category is named "Confidential").The extract below displays the default configuration of mobi.properties file on the mobile server:#default........default.corporateCategory=Mobiledefault.personalCategory=Mobiledefault.category.mobileDesigned=MobileDesigneddefault.category.secure=Confidentialdefault.docTypes=Webi,CrystalReport..........#ipad......ipad.corporateCategory=Mobile.....#iphone......iphone.corporateCategory=Mobile...#blackberry mobile...#android tabletandroidtablet.corporateCategory=Mobile...#android phoneandroidphone.corporateCategory=Mobile....The mobi.properties file contains various sections based on request sources such as , , , and .78 © 2014 SAP SE or an SAP affiliate company. All rights reserved.Administrator's GuideAdministering SAP BusinessObjects Mobile for iOS

All the properties in the default request source govern various aspects of SAP BI applications on all mobiledevices. If different parameter values are entered in a request source, that it the default request source isoveridden.You do not need to tweak the default settings in the properties file. However, if you have custom requirementsfor a specific device or platform, you can enter specific category names in the corresponding request source andthe values will override the ones in the request source.In the mobi.properties file:1. The lines:.corporateCategory=Mobile.personalCategory=Mobileindicate that BI documents assigned to the {Mobile} category can be accessed using the SAP BI (SAPBusinessObjects Mobile) application on a mobile device.2. The line:.category.mobileDesigned=MobileDesignedindicates that BI documents assigned to the MobileDesigned category (on the BI platform) would appear onthe mobile device screen according to the reports' page layout defined on the BI platform.3. The line:.category.secure=Confidentialindicates that BI documents assigned to the Confidential category on the BI platform are secured. Documentsassigned to this category cannot be saved in the device memory, and therefore, they cannot be accessed indisconnected (offline) mode.Note○○○On the BI platform, you can change (customize) the category names that you see on the right side ofthe assignment operator (such as "Mobile", "MobileDesigned" and "Confidential") in themobi.properties file . However, if you are changing a category name on the BI platform, you shouldupdate the corresponding line in the mobi.properties file.Categories of type:mobileDesigned and secure cannot be personal categories. They have the Corporatetype.To make SAP BusinessObjects Dashboards accessible on mobile, they need not be assigned to aMobile category . This is an exceptional BI document type for which mobile access is enabled by theDashboard model designer using the SAP BusinessObjects Dashboards. See the related topic for moreinformation.Example 1: Controlling visibility of BI documentsSuppose that you have 5 BI documents designed for the Mobile for iOS application, and you want 2 to appear onboth (iPhone and iPad) devices; 2 documents to appear only on an iPad and 1 document to appear only on aniPhone.You need to perform the following configuration:1. In your report designing tool, assign the 2 documents you want to appear on both devices, to a categorynamed Mobile. This is because the "Mobile" category name is present in the request source ofmobi.properties and is not specific to any device.Administrator's GuideAdministering SAP BusinessObjects Mobile for iOS © 2014 SAP SE or an SAP affiliate company. All rights reserved. 79

2. In your report designing tool, assign the 2 documents you only want to appear on iPad to a custom corporatecategory name (such as iPad_specific). Then, edit the following line in mobi.properties (replace oldcategory name with the new name):ipad.corporateCategory=iPad_specificSince the corporate category name in the ipad request source is different from the name in the defaultrequest source (Mobile), the iPad request source overrides the default request source. This ensures that themobile server recognizes these BI documents for the iPad request source and they only appear in the SAP BIapp installed on an iPad.3. In your report designing tool, assign the document you want only to appear on iPhone, to a custom Corporatecategory name (such as iPhone_specific). Then, edit the following line in mobi.properties (replace oldcategory name with the new name):iphone.corporateCategory=iPhone_specificNow the iPhone request source overrides the default request source. This ensures that the mobile serverrecognizes these documents for the iphone request source and they only appear on the SAP BI app installedon an iPhone.Example 2: Controlling display layout of BI documents on the mobile devicescreenYou have 4 Web Intelligence documents. 2 are designed for Android phones and 2 are designed for an iPadscreen. To ensure that documents are displayed in the respective devices in the correct layout, perform thefollowing steps:1. Web Intelligence documents meant for iPad devices, perform the following steps:In your report designing tool, assign the documents to a custom category name such as "iPad_designed".Then, make this update in the mobi.properties file: ipad.corporateCategory=iPad_designed.This ensures that the documents only appear on iPads and not on other devices.Assign the documents to the "MobileDesigned" category on BI platform.This ensures that reports aredisplayed on the iPad screen according to their page layout defined on the BI platform.2. Web Intelligence documents for the Android phone:In your report designing tool, assign the documents to a custom category name such as"Android_designed". Then, make this update in mobi.properties file:androidphone.corporateCategory=Android_designed. The Android phone request sourceoverrides the default request source. This means that the documents only appear on Android phones andnot on other devices.Assign the documents to the "MobileDesigned" category on BI platform.This ensures that the reports aredisplayed on the android device screen according to their "page layout" defined on the BI platform. If yougive a custom name to this category on the BI platform (such as "Mydesign"), you should updatemobi.properties file: androidphone.category.mobileDesigned=Mydesign accordingly.NoteIf you do not assign your BI documents to a mobileDesigned category on the BI platform, they appear onthe mobile device screen according to the Card Layout model. For information on the two layout models(Card layout and Page layout), see the Mobile BI Report Designer's Guide.80 © 2014 SAP SE or an SAP affiliate company. All rights reserved.Administrator's GuideAdministering SAP BusinessObjects Mobile for iOS

Example 3: Securing BI documents with confidential dataYou have certain BI documents that contain sensitive business information. You do not want users to save thesedocuments on their device or to have offline access. The device the user is using to access the document isirrelevant. You just need to assign the confidential BI documents to the "Confidential" category on the BI platform(via the BI LaunchPad or otherwise).This is because by default, the "Confidential" category is defined as a secured category in the mobi.propertiesfile. If you choose a different name for this category on the BI platform (such as "Restricted"), update theproperties file for the following line: default.category.secure=Restricted.NoteCategory names should not have a comma (',').Related InformationSaving mobile dashboards to BI platform folders [page 109]5.13 Generating SAP BI URLs for Opening BI DocumentsAn SAP BI document viewed in the application can have either of the following views on device:●●●Default view (first report, first page)A report (page) view within the documentA report part (zoomed) viewAs an administrator, you can share a BI document (so that it opens in a particular view on the recipient's device)by generating and sending an SAP BI URL.You can generate an SAP BI URL for a document in either of the following waysa. Using the Email option in the report on appWhen you choose Email in the secondary report tool-bar of an open report view on the device, the applicationgenerates an SAP BI URL with various parameters based on the view/ type of report.b. Manually creating an SAP BI URLYou can create SAP BI URLs to allow users to directly open a BI document on their devices. The sub-sections ofthis topic explain how to create SAP BI URLs for various scenarios.NoteUse SAP BI URLs to launch the SAP BI application from outside the app, that is from a third party iOSapplication. Once you are inside the application and you have to navigate between documents, useOpenDocument instead of creating SAP BI URLs.Administrator's GuideAdministering SAP BusinessObjects Mobile for iOS © 2014 SAP SE or an SAP affiliate company. All rights reserved. 81

See the Mobile BI Report Designer's Guide for information on OpenDocument URLs.5.13.1 Creating SAP BI URLs For Opening Specific BIDocuments or ReportsPre-requisiteRecipients of the SAP BI URLs should have:1. Access to the SAP BusinessObjects BI platform server/ SAP BusinessObjects Mobile server specified in theURL.2. The SAP BusinessObjects Mobile application for iOS installed on their iPhone or iPad device.1. Creating an SAP BI URL for opening a simple BI document (default view: firstreport, first page) in the appTo enable users to directly open a BI document with the tap of a URL on their iPad or iPhone devices, create anSAP BI URL with the following format:sapbi://OpenDoc/?ConnectionType=&connection_name=&server_url=&cms=&Type=&iDocID=&reportPartKey=&reportPageNumber=0&reportIndex=&isInstance=N&prompt=●●●ConnectionType, connection_name, server_url and cms are the regular SAP BI URL parameters thathelp the app (on user's device) identify the particular BI platform server with the relevant BI document.Type is the BI document type that has 2 valid values: 'webi', ''iDocID is the CUID of the document. Retrieve the CUID by accessing document Properties on the BI platform(report designing client tool).● For other parameters (reportPartKey, reportPageNumber, reportIndex, isInstance and prompt ),you do not need to assign any specific values. However, they should be retained in the URL syntax will nullvalues assigned to them as shown in the above URL format.2. Creating an SAP BI URL for opening a specific report within a BI document inthe appTo enable users to directly open a specific report within a BI document with the tap of a URL on their iPad oriPhone devices, create an SAP BI URL with the following format:sapbi://OpenDoc/?ConnectionType=&connection_name=&server_url=

t>&cms=&Type=&iDocID=&reportPartKey=&reportPageNumber=&reportIndex=5&isInstance=N&prompt=●●●●●ConnectionType, connection_name, server_url and cms are the regular SAP BI URL parameters thathelp the app (on user's device) identify the particular BI platform server with the relevant BI document.Type is the BI document type that has 2 valid values: 'webi', ''iDocID is the CUID of the document. Retrieve the CUID by accessing document Properties on the BI platform(report designing client tool).reportIndex is the index number of the report. The number count starts from zero. To give access to nthreport in the document, assign (n-1) as the value for this parameter.For example, if you want users to get direct access to third report of the BI document, assign the value (3-1)=2 to the reportIndex in the URL.For other parameters (reportPartKey, reportPageNumber, isInstance and prompt ), you don't need toassign any specific values. However, they should be retained in the URL syntax will null values assigned tothem as shown in the above URL format.NoteThe SAP BI URL that the application generates dynamically (on sharing a report) may have values for allparameters including the reportPageNumber and reportPartKey.When creating the SAP BI URL manually,we do not recommend that you pass values for these parameters, as they are not guaranteed to work in theapplication.5.13.2 Creating SAP BI URLs For Opening The Latest Instanceof BI DocumentsPre-requisiteRecipients of the SAP BI URLs should have:1. Access to the SAP BusinessObjects BI platform server/ SAP BusinessObjects Mobile server specified in theURL.2. The SAP BusinessObjects Mobile app for iOS installed on an iPad or iPhone device.To enable users to directly open the latest instance of a BI document (that is scheduled on the BI platform) withthe tap of a URL on their devices, create an SAP BI URL with the following format:sapbi://OpenDoc/?ConnectionType=&connection_name=&server_url=&cms=&Type=&iDocID=&reportPartKey=&reportPageNumber=0&reportIndex=&isInstance=Y&prompt=●●●ConnectionType, connection_name, server_url and cms are the regular SAP BI URL parameters thathelp the app (on user's device) identify the particular BI platform server with the relevant BI document.Type is the BI document type that has 2 valid values: 'webi', ''iDocID is the CUID of the document. Retrieve the CUID by accessing document Properties on the BI platform(report designing client tool).Administrator's GuideAdministering SAP BusinessObjects Mobile for iOS © 2014 SAP SE or an SAP affiliate company. All rights reserved. 83

●For other parameters (reportPartKey, reportPageNumber, reportIndex and prompt ), you do not needto assign any specific values. However, they should be retained in the URL syntax will null values assigned tothem as shown in the above URL format.5.13.3 Creating SAP BI URLs For Opening BI Documents WithPromptsPre-requisiteRecipients of the SAP BI URLs have:1. Access to the SAP BusinessObjects BI platform server/ SAP BusinessObjects Mobile server specified in theURL.2. The SAP BusinessObjects Mobile application for iOS installed on their iPhone or iPad device.1. Creating an SAP BI URL for opening documents with prompts withoutrefreshTo enable users to directly open a BI document with prompts using the SAP BI URL on their devices, create a URLwith the following format:sapbi://OpenDoc/?ConnectionType=&connection_name=&server_url=&cms=&Type=&iDocID=&reportPartKey=&reportPageNumber=0&reportIndex=&isInstance=N&prompt=●●●●ConnectionType, connection_name, server_url and cms are the regular SAP BI URL parameters thathelp the app (on user's device) identify the particular BI platform server with the relevant BI document.Type is the BI document type that has 2 valid values: 'webi', ''iDocID is the CUID of the document. Retrieve the CUID by accessing document Properties on the BI platform(report designing client tool).prompt defines the type of prompt (single or multiple).2. Creating an SAP BI URL for opening documents with prompts (on refresh)with list of values (LOV)To enable users to directly open a BI document with prompt (on refresh) with LOVs, take the following steps:1. Create an SAP BI URL with prompt names and corresponding LOVs in the following format: sapbi://OpenDoc/?ConnectionType=BOEConnection&connection_name=243&server_url=10.10.10.243:8080&cms=10.10.10.243&Type=webi&iDocID=AemcMBDKWG1Bl0nBT0PDPTQ&reportPartKey=&reportPageNumbe84 © 2014 SAP SE or an SAP affiliate company. All rights reserved.Administrator's GuideAdministering SAP BusinessObjects Mobile for iOS

=0&reportIndex=&isInstance=Y&prompt=lsM[Enter value(s) for Year:]=[2005],[2006],[2004],[2002]_lsM[Enter value(s) for City:]=[Los Angeles],[Washington],[SanFrancisco],[New York],[Miami]NoteObserve that multiple prompts (lsM) are separated by an underscore ('_').2. Encode the parameter section (prompt names and LOVs) of the URL.For example, after encoding the prompt section of the above URL, it looks like:lsM%5BEnter%20value(s)%20for%20Year%3A%5D%3D%5B2005%5D%2C%5B2006%5D%2C%5B2004%5D%2C%5B2002%5D_lsM%5BEnter%20value(s)%20for%20City%3A%5D%3D%5BLos%20Angeles%5D%2C%5BWashington%5D%2C%5BSan%20Francisco%5D%2C%5BNew%20York%5D%2C%5BMiami%5D%0A%0A3. Again encode the prompt section and join it with the remaining URLAfter performing this step, the URL for the above example looks like this:sapbi://OpenDoc/?ConnectionType=&connection_name=&server_url=&cms=&Type=&iDocID=&reportPartKey=&reportPageNumber=0&reportIndex=&isInstance=N&prompt=lsM%5BEnter%2520value(s)%2520for%2520Year:%5D=%5B2005%5D,%5B2006%5D,%5B2004%5D,%5B2002%5D_lsM%5BEnter%2520value(s)%2520for%2520City:%5D=%5BLos%2520Angeles%5D,%5BWashington%5D,%5BSan%2520Francisco%5D,%5BNew%2520York%5D,%5BMiami%5DNoteFor the parameters: reportPartKey, reportPageNumber, reportIndex and isInstance, you don't needto assign any specific values in the URL. However, they should be retained in the URL syntax will null valuesassigned to them as shown in the above URL format.5.13.4 Creating SAP BI URLs for Opening Specific Sections ofthe BI Documents With SectionsPre-requisiteRecipients of the SAP BI URLs (created using the format explained in this topic) have:1. Access to the SAP BusinessObjects BI platform server/ SAP BusinessObjects Mobile server specified in theURL.2. The SAP BusinessObjects Mobile application for iOS installed on their iPhone or iPad device.To enable users to directly open a specific section of a BI document in the SAP BI app on their device, create anSAP BI URL with the following format:sapbi://OpenDoc/?ConnectionType=&connection_name=&server_url=&cms=&Type=&iDocID=&reportPartKey=&reportPageNumber=0&reportIndex=&isInstance=N&prompt=&sectionPathByName=Administrator's GuideAdministering SAP BusinessObjects Mobile for iOS © 2014 SAP SE or an SAP affiliate company. All rights reserved. 85

●●●●●ConnectionType, connection_name, server_url and cms are the regular SAP BI URL parameters thathelp the app (on user's device) identify the particular BI platform server with the relevant BI document.Type is the BI document type that has 2 valid values: 'webi', ''iDocID is the CUID of the document. Retrieve the CUID by accessing document Properties on the BI platform(report designing client tool).reportIndex is the unique ID of the report, and enables the application to identify your specific report.The parameter enables the application to retrieve the specific report section youwant to open on the user's device. For this, pass the name of the section as specified on the server whilecreating the report-section.Note1. The parameters (reportPartKey, reportPageNumber, isInstance and prompt ) are optional.However, if even you do not assign values to these parameters, you can retain them in the URL syntax willnull values assigned to them as shown in the above URL format.2. The parameter sectionPathByName cannot be used for specifying multiple sections in a report. At a time,you can open only a single report section using this parameter.3. The parameter sectionPathByName cannot be used for multiple levels of section hierarchy if the reportsectionsare nested. Only a single level of hierarchy in report sections can be opened using this parameter.5.13.5 Creating SAP BI URLs for Opening the Latest AvailableVersion of a BI document or Its InstancePre-requisiteRecipients of the SAP BI URLs have:1. Access to the SAP BusinessObjects BI platform server/ SAP BusinessObjects Mobile server specified in theURL.2. The SAP BusinessObjects Mobile application for iOS installed on their iPhone or iPad device.To enable users to open the latest available version of the BI document or its instance on their device, create anSAP BI URL with the following format:sapbi://OpenDoc/?ConnectionType=&connection_name=&server_url=&cms=&Type=&iDocID=&reportPartKey=&reportPageNumber=0&reportIndex=&isInstance=N&prompt=&sectionPathByName=&useInstance=●●●ConnectionType, connection_name, server_url and cms are the regular SAP BI URL parameters thathelp the app (on user's device) identify the particular BI platform server with the relevant BI document.Type is the BI document type that has 2 valid values: 'webi', ''iDocID is the CUID of the document. Retrieve the CUID by accessing document Properties on the BILaunchPad.86 © 2014 SAP SE or an SAP affiliate company. All rights reserved.Administrator's GuideAdministering SAP BusinessObjects Mobile for iOS

NoteThe parameters (reportPartKey, reportPageNumber, reportIndex, isInstance, prompt andsectionPathByName are optional. However, you can retain them in the URL syntax will null valuesassigned to them as shown in the above URL format.●The useInstance parameter can have the value 'last' or null. Below is how this parameter works:- If this parameter is assigned the value 'last', the BI document or its latest instance whichever is latest outof the two is opened from the server on the device.- If this parameter is assigned the value 'last', and the user has already downloaded the BI document or itslatest instance to the device, the document or the instance, whichever is latest out of the two is openedfrom the device memory. Note that if there is an update available on the server that the user has notretrieved for the downloaded document, the URL does not consider that update while opening thedocument.- If no value is assigned to this parameter, always only the BI document is opened from the server. If theuser has downloaded the BI document already to the Home screen (before tapping the SAP BI URL), the BIdocument is opened from the device memory. (Latest instance of the document even if available on theserver or device memory is not opened when no value is assigned to this parameter.)5.14 Understanding the Security Implementation in the App5.14.1 Features of Application PasswordThe application password acts as a source of input for encryption of user data, where other users cannot decryptthe data without this input.Here are some features of the SAP BusinessObjects Mobile application password:●By default, the application password is not enabled in the application, until users add a connection to the BIplatform server. When users add a BI platform server connection, the application forces them to create anapplication password (this is because user specific or personal information comes on the device only after aconnection is created).However, if users have not created a single connection, yet, they wish to enable the application password,they can do so using the Settings screen of the application. (Settings screen appears on tapping the[Settings] icon which is next to the current connection name in the left hand navigation panel.)NoteThe above behavior applies if the user has performed a fresh installation of the application. If a user hasupgraded the existing installation with a newer version of the application from the iTunes store, serverconnections would already exist in the application, and so the password would remain enabled.●Password prerequisites:Password length must be minimum eight characters.For entering the password, the application allows a maximum of twenty attempts. If the attempts exceedthis number, the application forces the user to reset the application.Administrator's GuideAdministering SAP BusinessObjects Mobile for iOS © 2014 SAP SE or an SAP affiliate company. All rights reserved. 87

NoteResetting the application erases the application password and all the SAP BI content downloaded on thedevice.● By choosing the Clear Data Remove Application Data option in the of the Settings screen, all BI data ofthe application is deleted from the local memory. However, this does not delete the application password.●Users can change the password and set the "Application password timeout" parameter using the Settingsscreen.NoteThe Application password timeout parameter defines the duration of inactivity. Once this is exceeded, theapplication forces the user to enter the password to resume the application activity. This applies to thescenario when the user has switched over to other applications, and returns to the SAP BusinessObjectsMobile application after some time.The default value of this parameter is 5 minutes.●The following lines of code in the clientsettings.properties file on the Mobile server, help youcustomize the password settings in the application:savePassword=trueofflineStorage=trueofflineStorage.ttl=365offlineStorage.appPwd=trueIf you set savePassword=true, the Save Password option appears in the Connection settings screen of theapplication. Otherwise, it does not appear for the user.If for a server, the administrator has set the value of offlinestorage.appPwd parameter to true, userscannot disable the application password (for the particular server connection) while using the application. Ifthis parameter has the false (default) value, users can disable the application password using the(Settings) screen of the application.Other parameters associated with offline storage (such as "time to live") apply to the password as well.NoteFor information on the workflow of a particular action (such as disabling application password), use theembedded Help provided in the application.5.14.2 Support for Security Deployments On the WebApplication ServerEnsure that you have implemented either of the following scenarios on your Web application server (on which youhave installed the SAP BusinessObjects Mobile server):●●●Basic authentication (for example Siteminder)Form based authentication (for example Siteminder, Webseal)X509 certificate (two way client certificate)88 © 2014 SAP SE or an SAP affiliate company. All rights reserved.Administrator's GuideAdministering SAP BusinessObjects Mobile for iOS

When users add connections to the SAP Mobile server (with either of the above security deployments) using theSAP BusinessObjects Mobile application on their devices, they see a security interface which asks forauthentication. The following sections explain the three scenarios listed above.a. Basic Authentication1. Using the Settings screen of the application, users add a connection to the CMS with basic authenticationdeployed on it. (As an administrator, you provide the specific server details to the application users.)2. On choosing the new connection in the Settings screen, the application displays the basic Authenticationdialog box, asking the user to enter his/her credentials.3. User is logged in to the connection, and can browse the BI documents available on the server.b. Form Based Authentication1. Using the Settings screen of the application, users add a connection to the CMS with form basedauthentication deployed on it. (As an administrator, you provide the specific server details to the applicationusers.)2. On choosing the new connection in the Settings screen, the application displays a form, asking the user toprovide additional information.NoteThe form fields can be customized on the Web application server and UI features such as company logocan be included in the form. The form configured on the Web application server is displayed in the sameway as in the application in a container on device.3. User is logged in to the connection, and can browse the BI documents available on the server.c. Certificate Based Authentication1. Users first install the X509 certificate on the device. Information on how to install the certificate is provided inthe sub-topic of this chapter.2. Using the Settings screen of the application, users add a connection to the CMS with certificate basedauthentication deployed on it. (As an administrator, you provide the specific server details to the applicationusers.)3. When you choose the new connection in the Settings screen, the application displays a dialog box stating thatthe connection requires a certificate.User chooses Yes to display the certificate.4. Application displays the available certificates and asks for the right certificate.5. User selects the certificate (installed in step 1) from the list.6. User is logged in to the connection, and can browse the BI documents available on the server.Administrator's GuideAdministering SAP BusinessObjects Mobile for iOS © 2014 SAP SE or an SAP affiliate company. All rights reserved. 89

Note1. Installed certificates can be removed from the application by choosing the Clear Data RemoveCertificates option in the Settings screen.2. The application supports basic authentication and certificate based authentication for hyperlinkobjects as well.5.14.2.1 Installing the x509 Certificate on DeviceFor adding or accessing a certificate based connection in the application, users need to first install the certificateon their device. SAP BusinessObjects Mobile applications support the set ups that are deployed based on the x509 certificate.x 509 certificate is usually of the format ".p12" or ".cert"The procedures below are for users who install the certificate (received via email or accessed from a Webapplication server) on their device:Installing the certificate received as an email attachment1. On your desktop, download the certificate (*.p12) file.2. Change the certificate file extension from ".p12" to ".mcert" and send it to the email account configured onyour device.This ensures that the certificate file is in a recognizable format for the application.3. On your device, double-click the certificate that you emailed to your account.The application is launched.●●If the certificate is not password protected, a message appears on the screen saying that the certificate isinstalled successfully.If the certificate is password protected, a dialogue box appears on the screen asking you to enter thepassword. For the installation to complete successfully, enter the password and choose OK.The message for successful certificate installation appears.NoteIf the certificate you are installing already exists on your device, on performing step 3 in the above task, adialogue box appears saying: "This certificate already exists". If you want to delete the existing certificatefrom the app, choose Delete in the dialogue box. Else, choose Cancel.Installing the certificate hosted on a Web Application Server1. On your device, access either of the following links emailed to you by the administrator:SAPBI://action=downloadcert&certurl=90 © 2014 SAP SE or an SAP affiliate company. All rights reserved.Administrator's GuideAdministering SAP BusinessObjects Mobile for iOS

SAPBI://action=downloadcert&certurl=&Password=abc1232. If you access the first link above:The application is launched and the certificate file is downloaded from the URL location (certurl).A dialogue box appears asking you to enter the password. Enter the password and choose OK.The certificate is installed successfully on the device.NoteIf the certificate is not password protected, the application is installed directly on accessing the link.3. If you access the second link above:The application is launched and the certificate file is downloaded from the URL location (certurl).The certificate is directly installed on the device.NoteSince the password is already included in the URL, the application does not ask the user for the password.In this case, if the certificate is not password protected, the parameter for password is ignored by theapplication.An example of the parameter "Download URL" is http://10.208.107.248:8080/Resource/I087312.p12 ;where 10.208.107.248:8080 is the IP address and port of the Web application server machine andI087312.p12 is the certificate file.NoteIf the certificate you are installing already exists on your device, on accessing any of the two links, a dialoguebox appears saying: "This certificate already exists". If you want to delete the existing certificate from theapplication, choose Delete in the dialogue box. Else, choose Cancel.5.14.3 User Data Protection and Privacy ParametersUser data is the data or information which is personal to an individual user. This includes the downloaded reportsand application logon credentials of the user. To ensure the security of user data, the application implementscertain security measures.Some of these measures are as follows:●●●Users have the option of saving their password for a connection in the application. However, in the defaultmobile server configuration, this option is disabled by default (savePassword=false). If a user enables theSave Password option while configuring the connection on his or her device, the password is encrypted filesusing the FIPS compliant AES algorithm. On iPad/iPhone devices, files are stored with the iOS keychain.If users do not choose the option to save their password, they are prompted for the password whenever theyaccess the application, whether they are in the online or offline mode of the device.In the default configuration of the application, the option to download and view documents locally on thedevice is disabled. (offlineStorage=false). Users can only access the documents available on the serverin online mode.Administrator's GuideAdministering SAP BusinessObjects Mobile for iOS © 2014 SAP SE or an SAP affiliate company. All rights reserved. 91

●●Based on requirements, administrator can enable this option in the server configuration file.If offline storage of documents is enabled, there is a "Time to Live" parameter in the server configuration file,with a default value of 365 days (offlineStorage.ttl=365). This means that the downloaded documentsexpire after 365 days and are automatically removed from the local memory of device.For Web Intelligence or Crystal Reports documents with private or confidential data, you can secure thedocuments by assigning them to a "Confidential" category in document designing tool. A secure documentcan only be accessed by users while they are connected to the Mobile server. Once users log off from theserver, the secure document is deleted from the device memory.The parameters (savePassword, offlineStorage and offlineStorage.ttl) explained above can be foundin the following file on the Mobile server:[_Home]\webapps\MobileBIService\WEB-INF\ClientSettings.propertiesBased on your specific security requirements, you can change the values of the above parameters in theClientSettings.properties file.Note1. The location of clientsettings.properties file on the SAP BusinessObjects Mobile server is based onthe server version you are using. To find the file-path for your specific server version, refer to the relatedtopic of this chapter.2. If you are using the BI platform 4.1 and higher versions, you can also use the Central ManagementConsole (CMC) interface for configuring client settings. For information on how to configure client settingsusing the CMC, see the related topic of this chapter.3. For your configuration changes to take effect in the app, ensure that you restart the Web application serverafter making updates to the ClientSettings.properties file.4. For more information on the security measures implemented in the application and in the mobile systemlandscape, refer to the Security Guide available at http://help.sap.com/bomobileiosRelated InformationConfiguring Categories on the Mobile Server [page 77]Features of Application Password [page 87]Configuring Application's Behavior by Specifying Properties on the Server [page 62]Using the CMC to Define Properties on BI Platform 4.1 [page 67]Mobile Server and Property File Locations Matrix [page 66]5.15 MDM Configuration Support for iOS 7 DevicesFor devices with iOS 7 or higher, Apple provides the "Managed App Configuration" functionality. This functionalityallows a Mobile Device Management (MDM) server to push down a configuration dictionary into the managedapp's NSUserDefaults for the purpose of remotely configuring settings.92 © 2014 SAP SE or an SAP affiliate company. All rights reserved.Administrator's GuideAdministering SAP BusinessObjects Mobile for iOS

For further information on MDM configuration support, see https://developer.apple.com/library/ios/samplecode/sc2279/Introduction/Intro.htmlSAP BusinessObjects Mobile (SAP BI) Application Configuration Propertiesthat can be Managed by the MDM ServerPredefined Connections ListYou can configure a single predefined connection or multiple predefined connections in the application byspecifying values for the conn.list.(n) property on the MDM server, where 'n' is the array index starting with avalue of 1. Each array item is of the type "String", and the value of each item corresponds to a connection URL.For example, you can specify a predefined connection URL for a BOE server connection with the syntax shownbelow:conn.list.1=sapbi:// addconnection? ConnectionType=BOEConnection&con nection_name=SAP%20Analytics %20Gallery&server_url=&cms=NoteFor more information on specifying valid URL values for a predefined connections list, refer to chapter 5.1Customizing the Onboarding Features of the Developer's Guide posted on http://help.sap.com/bomobileios.Default Application Behavior Properties (Other than the predefinedconnections list)All the key properties defined in the defaultsettings.plist file of the application SDK that are described in thechapter 5 of the Developer's Guide ("Customizing the Default Behavior of the Application"), can be managed bythe MDM using the corresponding key-value pairs.For example, you want the MDM to remotely manage the email feature of the application functionality. Thefeature.email.enabled.default property in defaultsettings.plist has a default value of 'true'. Tomanage this feature remotely, you can define the corresponding key as email.enabled in the configurationdictionary of the MDM server and specify its value as 'true'/'false', based on your requirements. Similarly, you canmanage other application features such as annotation, collaboration, Help, and default Home view.For each property (formatted as feature..default) in defaultsettings.plist of the app, you can define thecorresponding property on the MDM server in the format .For a description of all such properties that define the default behavior of the application, refer to the subchaptersof chapter 5 in the Developer's Guide posted on http://help.sap.com/bomobileios.Administrator's GuideAdministering SAP BusinessObjects Mobile for iOS © 2014 SAP SE or an SAP affiliate company. All rights reserved. 93

NoteThe only property in defaultSettings.plist that does not follow the above rule is the predefinedconnections list (feature.predefinedconnections.list.default) that defines an array of predefinedconnection URLs.5.16 Working With NotificationsNotifications appear in the application in the following scenarios:1. When a downloaded BI document has an update available on the server.2. When a downloaded BI document is either removed from the server or is no longer assigned to the ‘Mobile’category on the BI platform.3. When a data refresh is performed on downloaded BI documents on the server in line with the alerter' criteria(leading to a change in the formatting of its tables). This applies only to Web Intelligence documents that:○○Have conditional formatting (alerter) defined for them in Web Intelligence, andAre subscribed for alerts (using the Subscribe option in the Information [ i ] screen of the document.)NoteFor more information on conditional formatting or "alerter" in Web Intelligence reports, see the Mobile BIReport Designer's Guide.4. When a BI document is added to the 'Mobile' category on the server.Scenario 1: Notifications when documents are updated on the serverTo understand this scenario, perform the following steps:1. Download a BI document from the Home screen of the application to your device.The downloaded document appears with a tick-mark badge on the screen.2. Log on to BI Launch Pad and do either of the following:Access the BI document and choose Schedule from the context menu. On the Scheduling page, set anyvalues for the scheduling options; preferably run an instance by choosing the value asNow; orOpen the BI document, choose the Modify menu option, edit and save document.3. Refresh the application's Home screen. Tap (Notifications) on the Home screen toolbar.The application opens the Notifications panel, and you find the BI document displayed within the UpdatesAvailable tab on the Notifications panel.4. Tap the document to retrieve the update and to view the updated document or tap the (Update) icon,which is located beside the document title, to update the document.94 © 2014 SAP SE or an SAP affiliate company. All rights reserved.Administrator's GuideAdministering SAP BusinessObjects Mobile for iOS

Scenario 2: Notifications when BI documents are removed from the serverTo understand this scenario, perform the following steps:1. Download a BI document from the Home screen of the application to your device.The downloaded document appears with a tick-mark badge on the screen.2. Log on to BI Launch Pad and do either of the following:Search and navigate to the BI document, choose Categories and deselect the Mobile category assigned tothe document; orIf you have the rights, delete the BI document from the server.3. Refresh the application's Home screen. Tap (Notifications) on the Home screen toolbar.The application takes you to the Notifications panel, and you find the BI document displayed within theDeleted Documents tab on the Notification panel.Scenario 3: Notifications when Web Intelligence documents with conditionalformatting are refreshed on the serverTo understand this scenario, perform the following steps:1. Identify a document with conditional formatting.Users can identify conditional formatting by observing the formatting of table cells in the reports of thedocument. They may have a different colored text and background-image or hyperlinks.2. Download a BI document from the Home screen of the application to your device.The downloaded document appears with a tick-mark badge on the screen.3. Open the document, and tap (Settings) in the tool-bar to open the secondary report tool-bar, and choose'i' (Info) to go to the Information screen of the document in the app, and ensure that it is subscribed for alerts.4. Log on to the BI platform server (BI Launch Pad), search and open the Web Intelligence document, andchoose (Refresh).(This refreshes the data-providers of the document.)5. Refresh the application's Home screen. Tap (Notifications) on the Home screen toolbar.The application takes you to the Notifications panel, and you find the BI document displayed within the Alertstab on the page.NoteIn the above scenario, an alert only appears in the app if you are refreshing the document on the serverafter a time-interval of four hours or more. If the last time you refreshed the document in Web Intelligencewas less than four hours ago, no notification appears within the Alerts tab. Instead, only an alert appearswithin the Updates tab on the Alerts page because the document has been refreshed on the server.This is because the alerter criteria (conditional formatting) of the document are checked on the serverevery four hours.6. Tap the document to retrieve the update and to view the updated document or tap the (Update) icon,which is located beside the document title, to update the document.Administrator's GuideAdministering SAP BusinessObjects Mobile for iOS © 2014 SAP SE or an SAP affiliate company. All rights reserved. 95

Scenario 4: Notifications when BI documents are added to the Mobile categoryon the serverTo understand this scenario, perform the following steps:1. Log on to BI launch pad and add a BI document to the Mobile category.2. Refresh the application's Home screen. Tap (Notifications) on the Home screen toolbar.The application takes you to the Notifications panel, and you find the BI document displayed within the AddedDocuments tab on the Notifications panel.3. Tap the document to view the newly added document.Related InformationWhat's New in 6.1? [page 11]96 © 2014 SAP SE or an SAP affiliate company. All rights reserved.Administrator's GuideAdministering SAP BusinessObjects Mobile for iOS

6 Creating Personal Views of WebIntelligence ReportsPersonal Views is a capability to save personalized views of a Web Intelligence report.Understanding the Significance of Personal ViewsFor some business requirements, you may want a particular view of a Web Intelligence report to be opened everyday and refreshed. For example, consider the following use case:For customer A, a sales representative filters data with certain input control values and drills down two levels inthe report tables. The representative then saves a personal view of the report and names it Daily Sales - CustomerA. Now the representative can open this personal view every day and quickly refresh (or update) the report withlatest data from the server, without performing the same actions for customer A again. This way, havingperformed different server actions (for different customers), the representative can save multiple personal viewsof the same report (but with different results) for offline or personalized viewing (such as Daily Sales - Customer A,Daily Sales - Customer B and Daily Sales - Customer C).Creating and Accessing Personal Views in the ApplicationTo create a personal view of a Web Intelligence report, perform the following steps:1. Open the report, and perform the required server actions so that the report arrives at your desired view. (Youractions may include drilling, filtering using input controls, displaying information in sections, and other actionsbased on server interaction.)2. Tap (Report Settings) to open the secondary toolbar, then tap Save View.The "Save View" dialog opens.3. Specify a Personal View Name and optionally a description of the view. Then tap Done.The personal view is created and you can access it using the Personal Views tab in the Browse panel. You canalso refresh the data in your personal view anytime by tapping the[Refresh] option in the view toolbar.Characteristics of Personal Views1. You can create multiple personal views of the same base (source) document, and each view is independent ofeach other.2. If you want a saved personal view to display the latest information from the server (in online mode), you needto explicitly Refresh the personal view after opening it. You can update the personal view with the latest datafrom the server in two ways:○○By tapping the Refresh icon in the toolbar of the opened personal view.By tapping the Update option that appears in the Information (>) screen of the personal view tile.Administrator's GuideCreating Personal Views of Web Intelligence Reports © 2014 SAP SE or an SAP affiliate company. All rights reserved. 97

NoteIf you want to disable the refresh or update of personal views in the application, you can set the value of thefollowing client setting to 'false'feature.webi.personal.view.update.enabledTo access client settings based on the server version that you are using, see the related topics of thischapter.3. When you refresh a personal view, the application refreshes the source BI report (from which you created theview) and applies all the history actions on the report to bring it to the view state.4. You can save personal views of Web Intelligence documents only. Other BI document types do not supportthis feature.5. Personal views are supported on both Web Intelligence documents and their instances.NoteIf the Web Intelligence document is scheduled on the BI platform server, and there is an instance of thesame available on the server, when users tap Update or Refresh, the server returns either the refresheddocument or its latest instance, depending what is more recent.6. When you save a personal view, the application does the following:○○Saves the state of a Web Intelligence report. (In whatever state you left the report before saving the view,the same state is maintained when you access the personal view.)Saves the history of server actions that you performed on the report before saving the personal view.On a personal view, you can perform all server actions that you performed before saving the view. Forexample, if you drilled down in the report's charts or tables and applied filters, you can perform the sameactions after opening the personal view (even in offline mode).NoteIf the report has REL (report element linking), the application also records the sequence in which youfiltered data in the linked report parts. You can only use REL in the same sequence of linking.7. Irrespective of whether you are in offline or online working mode, you can perform only those actions on asaved personal view that you performed before saving it.For example, if you drilled down in report parts, but did not drill up, you cannot drill up in the personal view.If the report has hierarchical tables, but you did not perform an expand or collapse action on the nodes,you cannot expand or collapse nodes in the personal view.NoteFor a personal view, the application does not record the actions that are independent of server interaction(such as sort, re-order, or freeze in tables). Users can perform these actions in personal views anytime andin any order.8. Apart from Refresh and Update, no other action (request) on a personal view goes to the mobile BI server.(Before saving the view, when you perform server actions such as drill and filter, the application fetches therequired data and stores it in local memory of the device. When you perform the same actions on the savedpersonal view, the required data is fetched from device memory, and there is no server interaction.)98 © 2014 SAP SE or an SAP affiliate company. All rights reserved.Administrator's GuideCreating Personal Views of Web Intelligence Reports

9. If the personal view has an OpenDocument URL that targets a BI document that is not Web Intelligence, thetarget document does not open when you tap the URL in the personal view (even if you tapped the URL beforesaving the view of report).10. If the BI report has drill-enabled tables, the personal view displays the drill pop-up options on only those cellson which you have drilled information before saving the view. Other cells do not display the drill pop-up.11. Using input controls, if you have filtered data in the BI report before saving the personal view, when you openthe personal view and tap (Filter), the pop-up displays only the combination of values that you chose whilefiltering data. The following figure displays the view that appears:Administrator's GuideCreating Personal Views of Web Intelligence Reports © 2014 SAP SE or an SAP affiliate company. All rights reserved. 99

When you tap on any value combination, the pop-up displays all the individual values the same way as theyappeared in the original BI report, as shown below:You can select any value and tap Apply to apply value selections.12. You cannot create a personal view from an existing personal view.13. The maximum number of personal views that you can save on-device depends on the value of the PersonalView Storage setting that you specify in Application Settings-> Additional Settings.NoteIf you specify 'None' as the personal view storage limit, you can save an unlimited number of personal viewson your device.14. You can delete personal views from the device in one of the following ways:○By tapping the Delete Personal View option that appears on the Information(>) pop-up of the personalview tile.○ By erasing application data using (Settings)Application SettingsAdditional SettingsClear DataRemove Application Data○ By removing the server connection that has the BI report from which the personal views are created.100 © 2014 SAP SE or an SAP affiliate company. All rights reserved.Administrator's GuideCreating Personal Views of Web Intelligence Reports

15. In the following scenarios, you cannot save personal views for a Web Intelligence report:○○○○The parent document is configured to "Refresh on Open".The parent document is set to Confidential on the server.The parent document is a "View as PDF".The property on the Mobile server is set to 'False'.16. In the following scenarios, saved personal views are automatically removed from the device memory:○○○○The parent (source) document of the personal view has expired (based on the TTL server parameter).The administrator has either removed the parent document from the server or unassigned it from theMobile category.The administrator set the parent document to Confidential on the server.The property on the Mobile server is set to 'False'.17. The secondary toolbar of a personal view does not have the Collaborate option, as personal views are notdesigned for discussing.Few Limitations of Personal Views1. If you use hierarchical input controls or hierarchical sections in a Web Intelligence report, the application doesnot permit you to save a personal view of the report.2. When you email a personal view, the email body contains the view snapshot only. It does not contain any SAPBI URL for OpenDocument.3. You cannot save a personal view of the Web Intelligence report that is invoked by a source report using theOpenDocument function. The application prompts you to return to the source document for saving a personalview.4. Personal views are supported only on the following BI Platform server versions:○○SAP BusinessObjects BI platform 4.0, Support Package 8 and aboveSAP BusinessObjects BI platform 4.1, Support Package 2 and above5. If your personal view has an OpenDocument URL that targets the same BI document as the source (parentdocument from which you created the view), the URL does not work as expected in the personal view.Administrator's GuideCreating Personal Views of Web Intelligence Reports © 2014 SAP SE or an SAP affiliate company. All rights reserved. 101

7 Managing the Mobile support forDashboardsSAP BusinessObjects Dashboards allows dashboard consumers to view models on mobile devices such as theiPad. Certain components and dashboard features are unavailable or behave differently on mobile devices. Youcan use the Mobile Compatibility panel to ensure that your model will run correctly on mobile devices.Add-on components created using the Dashboards Component SDK can be made mobile-compatible. For moreinformation, refer to the Dashboards Component SDK documentation, available on the SAP Help Portal (http://help.sap.com/bodash41).NoteMobile support requires SAP BusinessObject Business Intelligence platform 4.0 Support Package 5 or later.7.1 Using the Mobile Compatibility panelThe Mobile Compatibility panel helps ensure that your model will run correctly on mobile devices. The paneldisplays a warning icon for each component or feature in your model that is unsupported on mobile devices.Selecting a component in the Mobile Compatibility panel selects it on the canvas and opens its property sheet.To view all incompatible components or features in the model, in the Mobile Compatibility panel, click Refresh( ). Incompatible items are categorized as follows:●●General - Miscellaneous warnings and suggestions, such as an oversized canvas or an unsupported theme.Component - Unsupported components. Component warnings are split into the following subcategories:○○○Unsupported components. These components are not displayed in the model when the model is viewedon mobile. Components in this category are denoted by a red warning icon.Supported components with unsupported properties. These components are displayed when the modelis viewed on mobile but may behave differently or have certain properties disabled. Components in thiscategory are denoted by a yellow warning icon.Visual variant components. These components are replaced by their fallback component when the modelis viewed on mobile with all settings preserved. For example, Gauge2 or Gauge3 would be replaced byGauge on mobile. Components in this category are denoted by a yellow warning icon.NoteBackground2, Background4, and Background5 are supported.●Connectivity - Unsupported external connections. This includes all connections added through the DataManager.102 © 2014 SAP SE or an SAP affiliate company. All rights reserved.Administrator's GuideManaging the Mobile support for Dashboards

7.2 Supported components in mobile dashboardsThe following is a summary of all components supported on mobile devices, along with any of their unsupportedproperties or features.NoteAll components have Entry Effect and Insert On: Mouse Over disabled on mobile.Chart componentsComponentUnsupported propertiesBar ChartColumn Chart●●●●●All Enable Run-Time Tools, Plot Area, Title Area, andRange Label options.Allow Zoom Out Only, Logarithmic, and Fixed Label Sizescale options.Show Fill, Show Border, Border Thickness, and CheckBox legend options.All underline font styles.Alerts.Bubble Plot ● All Enable Run-Time Tools options.●●●●Allow Zoom Out Only, Logarithmic, and Fixed Label Sizescale options.Show Fill, Show Border, Border Thickness, and CheckBox legend options.All underline font styles.Alerts.Combination ChartLine Chart●●●●●All Enable Run-Time Tools, Plot Area, Title Area, LegendArea, and Range Label options.Allow Zoom Out Only, Logarithmic, and Fixed Label Sizescale options.Show Fill, Show Border, Border Thickness, and CheckBox legend options.All underline font styles.Alerts.Pie Chart ● All Plot Area, Title Area, and Legend Area options.●All underline font styles.Stacked Bar ChartStacked Column Chart●●●All Enable Run-Time Tools, Plot Area, Title Area, LegendArea, and Range Label options.Allow Zoom Out Only, Logarithmic, and Fixed Label Sizescale options.Show Fill, Show Border, Border Thickness, and CheckBox legend options.Administrator's GuideManaging the Mobile support for Dashboards © 2014 SAP SE or an SAP affiliate company. All rights reserved. 103

ComponentUnsupported properties●●●The Marker Overlap appearance option.All underline font styles.Alerts.Waterfall Chart ● All Enable Run-Time Tools options.●●●Allow Zoom Out Only, Logarithmic, Fixed Label Size, andMinor Divisions scale options.Show Fill, Show Border, Border Thickness, and CheckBox legend options.All underline font styles.Container componentsComponentCanvas ContainerUnsupported propertiesAll Scroll Bar color options.Tab SetSelector componentsComponentCheck BoxUnsupported propertiesAll properties are supported.IconPush ButtonRadio ButtonToggle ButtonCombo Box ● All Scroll Bar color options.●●Drop-Down Animation.Alerts.Label Based Menu ● All Interaction options except Always Expanded andExpand On Mouse Click.●●All Title options.Alerts.List Box ● All Scroll Bar color options.●Alerts.List View ● All Scroll Bar color options.104 © 2014 SAP SE or an SAP affiliate company. All rights reserved.Administrator's GuideManaging the Mobile support for Dashboards

ComponentUnsupported propertiesScorecard ● Change Column Width at runtime and Column Width bypercentage.Single Value componentsComponentUnsupported propertiesGaugeGauge7Gauge8Horizontal Progress BarVertical Progress BarHorizontal SliderVertical Slider●●●●Object Elasticity, Adjustable and Open Limits, MouseSensitivity, and Vertical Mouse Tracking behavioroptions.Play Button and Limit Background Color appearanceoptions.Adjustable and Open Limits behavior options.Play Button and Limit Background Color appearanceoptions.Text componentsComponentInput TextInput Text AreaUnsupported propertiesAll properties are supported.Enable HTML Formatting.Label ● All Scroll Bar color options.●Enable HTML Formatting.Art and background componentsComponentBackgroundUnsupported propertiesAll properties are supported.Background2Background4Background5EllipseAdministrator's GuideManaging the Mobile support for Dashboards © 2014 SAP SE or an SAP affiliate company. All rights reserved. 105

ComponentUnsupported propertiesHorizontal LineRectangleVertical LineImage ● Import SWF files.● Hide SWF Background Color.Web ConnectivityComponentURL ButtonUnsupported propertiesAll properties are supported.NoteLinking a URL button to unsupported data sources will notwork. For example, an OpenDocument URL will not passFlashVars to the model since FlashVars are not supported.For more information about unsupported data sources,see Unsupported features in mobile dashboards [page108].NoteOn an iPad, external URLs (such as http://help.sap.com)are opened in Safari.Universe ConnectivityComponentQuery Refresh ButtonUnsupported propertiesAll properties are supported.7.2.1 Using components in mobile dashboardsMobile dashboard users interact with components using the device's touch screen. The user can interact withcomponents and items by tapping, touching, or dragging them. The user can also pinch to zoom chart componentscales or models with a canvas size larger than the mobile device's resolution.Component interaction that involves clicking or dragging is unchanged on mobile. Component interaction thatinvolves mousing over is unsupported, with the following exceptions:106 © 2014 SAP SE or an SAP affiliate company. All rights reserved.Administrator's GuideManaging the Mobile support for Dashboards

Pie ChartWhen viewing a model on a computer, the user can mouse over a slice of a Pie Chart to show detailed values. Onmobile devices, the user must tap the slice. The values are displayed in the center of the chart, as shown below:Column Chart and Line ChartWhen viewing a model on a computer, the user can mouse over a column on a Column Chart or a point on a LineChart to show detailed values. On mobile devices, the user must briefly touch the column or point. The values aredisplayed on the column or point, as shown below:Administrator's GuideManaging the Mobile support for Dashboards © 2014 SAP SE or an SAP affiliate company. All rights reserved. 107

Pinch to zoomThe user must pinch to zoom chart component scales. Pinching to zoom a chart's scale is shown below:7.3 Unsupported features in mobile dashboardsThe following is a summary of unsupported or partially supported features when viewing a model on mobiledevices.FontsFor a list of fonts supported on mobile, see http://iosfonts.com/ . All listed fonts that are installed on your localmachine will be added to Dashboards' font list with (iOS 5+) appended.NoteIf a font is not supported, it defaults to Verdana.ThemesOnly the Nova theme is supported.NoteIf another theme is used, it defaults to Nova. The color scheme remains the same.108 © 2014 SAP SE or an SAP affiliate company. All rights reserved.Administrator's GuideManaging the Mobile support for Dashboards

Canvas sizeIf the canvas is larger than the mobile device's native resolution, scroll bars will be used if the dashboard is viewedin Original Size Mode. The native resolution of the iPad is 1024x768, so it is recommended you set the canvas tothis size when designing your model.Model connectivityIf the model is running in offline mode, or if the mobile device has no network connection, all connections in themodel will be disabled and will use cached data.NoteOnly connections added from the Query Browser are supported. Connections added through the Data Managerare supported if denoted by an asterisk.7.4 Saving mobile dashboards to BI platform foldersWhen you create a new model and save it to the platform, it is saved as a Dashboards object that includes both thedesign file (XLF) and the runtime file (SWF).NoteFor general information about creating, modifying, and saving models, see the Dashboards and PresentationDesign User Guide, available on the SAP Help Portal (http://help.sap.com) under Analytics All Products .1. After creating or modifying a model, click File and select one of the following options:OptionDescriptionSave to PlatformMobile OnlyUse this option if you have created a new model, or have opened and modified an existingDashboards model. Features unsupported on mobile devices are omitted.NoteFor more information about unsupported features, see Using the Mobile Compatibilitypanel [page 102].Save to PlatformDesktop and MobileUse this option if you have created a new model, or have opened and modified an existingDashboards model. In the mobile file, features unsupported on mobile devices are omitted.NoteFor more information about unsupported features, see Using the Mobile Compatibilitypanel [page 102].Administrator's GuideManaging the Mobile support for Dashboards © 2014 SAP SE or an SAP affiliate company. All rights reserved. 109

OptionSave to Platform AsDashboards Object forMobile OnlyDescriptionUse this option if you have opened and modified an existing Dashboards model, or haveopened an Xcelsius object and want to save it as a new Dashboards object, but do not wantto overwrite the existing object. Features unsupported on mobile devices are omitted.NoteFor more information about unsupported features, see Using the Mobile Compatibilitypanel [page 102].Save to Platform AsDashboards Object forDesktop and MobileUse this option if you have opened and modified an existing Dashboards model, or haveopened an Xcelsius object and want to save it as a new Dashboards object, but do not wantto overwrite the existing object. In the mobile file, features unsupported on mobile devicesare omitted.NoteFor more information about unsupported features, see Using the Mobile Compatibilitypanel [page 102].2. In the Log On to SAP BusinessObjects Business Intelligence platform dialog box, enter the followinginformation:OptionDescriptionSystemType the name of the Central Management console (CMC) where you want to save the file.The CMC stores information about the objects saved to the BI platform system. For more informationabout the CMC, refer to the BI platform documentation available on the SAP Help Portal (http://help.sap.com).User namePasswordAuthenticationType your logon name.Type you password.Click the appropriate authentication type.3. Click OK.4. If you are not replacing an existing file, select the folder where you want to save the Dashboards object, entera file name, and click Save.110 © 2014 SAP SE or an SAP affiliate company. All rights reserved.Administrator's GuideManaging the Mobile support for Dashboards

8 Managing the Mobile support forInformation Spaces and Information ViewsSAP BusinessObjects Explorer is a data discovery application that allows you navigate through datasets known asInformation Spaces and Exploration Views. These datasets are created in the web version of SAP BusinessObjectsExplorer as part SAP BusinessObjects Business Platform.When you open an Information Space on an iPhone or iPad, you can explore your corporate data, search, applyfilters and dimensions and retrieve answers to your business questions.In order to access your corporate data on your iPhone or iPad, you need to ensure that your data administratormakes the appropriate connections available to your user profile.For information on how to create information spaces using the SAP BusinessObjects Explorer and other relatedinformation, refer to the SAP BusinessObjects Explorer for iPhone/iPad User Guide available at http://help.sap.com/businessobject/product_guides/boexpl41/en/41_expl_user_en.pdf8.1 Valid Data Format for Augmented ViewsWhen the data is correctly formatted, Information Spaces and Exploration Views show the informationaugmented, so that you can view the information in terms of your points of interest (POIs).For the augmented view of a document to load, it is essential that one of the columns of the data set uploaded tothe Explorer server is formatted as a point of interest (POI).A POI is a structure containing the following information:●●●●POI name (mandatory)POI location (mandatory)POI imagePOI associated linkThe POI column in the data set should be formatted as follows:NAME|| LATITUDE;LONGITUDE|| IMAGE_URL|| LINK_URLExample: myStore||45.5;-1.2||http://mydomain/myimage||http://mydomainThis order and format is mandatory. POI information must be separated by the string “||”.The following is an example of a data set which is valid for getting an augmented view:Store Year Quarter RevenueStore 1||46.43431150;1.16331900||http://sapweb20.com/blog/augreality/icon21.png2010 Q1 7703Administrator's GuideManaging the Mobile support for Information Spaces and Information Views © 2014 SAP SE or an SAP affiliate company. All rights reserved. 111

Store Year Quarter RevenueStore 1||46.43431150;1.16331900||http://sapweb20.com/blog/augreality/icon21.pngStore 1||46.43431150;1.16331900||http://sapweb20.com/blog/augreality/icon21.pngStore 1||46.43431150;1.16331900||http://sapweb20.com/blog/augreality/icon21.pngStore 2||50.47431150;2.55331900||http://sapweb20.com/blog/augreality/icon13.png||http://sapweb20.com/blog/augreality/icon13.pngStore 2||50.47431150;2.55331900||http://sapweb20.com/blog/augreality/icon13.png||http://sapweb20.com/blog/augreality/icon13.pngStore 2||50.47431150;2.55331900||http://sapweb20.com/blog/augreality/icon13.png||http://sapweb20.com/blog/augreality/icon13.pngStore 2||50.47431150;2.55331900||http://sapweb20.com/blog/augreality/icon13.png||http://sapweb20.com/blog/augreality/icon13.png2010 Q2 39182010 Q3 56022010 Q4 31002010 Q1 10252010 Q2 6802010 Q3 11002010 Q4 6709The data set can have any number of dimensions, but one of the columns should be formatted as POI. If thiscondition is fulfilled, then when tapping the document, the augmented view will load and the augmented viewsicon will be available. Otherwise, the normal exploration view opens up.112 © 2014 SAP SE or an SAP affiliate company. All rights reserved.Administrator's GuideManaging the Mobile support for Information Spaces and Information Views

9 Managing the Mobile Support for AnalysisApplicationsAnalysis applications are Web applications that allow users to analyze data from SAP NetWeaver BW and SAPHANA. Integration with SAP BusinessObjects Mobile means that users can access analysis applications on mobiledevices, such as the iPad or the iPhone.Application designers create analysis applications with SAP BusinessObjects Design Studio. For using analysisapplications on mobile devices and integrating them with SAP BusinessObjects Mobile they need to create theanalysis applications in the SAP BusinessObjects BI Platform mode of Design Studio.This section provides administrators with an overview of the tasks required to integrate analysis applications withSAP BusinessObjects Mobile.9.1 InstallationMake sure that you have installed the full installation of the Analysis Application Service for SAP BusinessObjectsDesign Studio on the BI platform, including: Analysis Application Web Components, Analysis Application Serviceand Analysis Application support for Mobile Devices.The installation feature Analysis Application support for Mobile Devices adds mobile support to analysisapplications, thereby integrating analysis applications with SAP BusinessObjects Mobile. It allows applicationusers to access analysis applications on mobile devices, such as the iPad or the iPhone.NoteThe setup feature Analysis Application support for Mobile Services requires Mobile Services to be installed.For more information, see the Administrator Guide: SAP BusinessObjects Design Studio based on SAPBusinessObjects BI Platform on the SAP Help Portal at http://help.sap.com/boad.9.2 Configuration Tasks for Mobile Usage of AnalysisApplicationsBefore users can access analysis applications on the mobile app of the SAP BusinessObjects Mobile solution, youneed to check whether a mobile category exists on the BI platform. If no mobile category exists, you need tocreate one. Then you need to assign the analysis applications to this category.NoteThe default name of the mobile category is Mobile. Administrators can change the category name in themobi.properties file on the Mobile server under[_Home]\webapps\MobileBIService\WEB-INF\mobi.properties. For more information, see “Configuring Categories on the Mobile Server” inAdministrator's GuideManaging the Mobile Support for Analysis Applications © 2014 SAP SE or an SAP affiliate company. All rights reserved. 113

the Administrator and Report Designer's Guide: SAP BusinessObjects Mobile for iOS at http://help.sap.com/bomobileios.If your application users want to access analysis applications on their iPhones, you need to change a property inthe zen.properties file on the BI platform server.9.2.1 Creating a Mobile Category on the BI PlatformCheck whether a mobile category exists on the BI platform. If this category does not exist, you need to create one.1. In the Central Management Console under Categories, choose Manage New Category .2. When prompted, type Mobile as the name for the new category.3. Click OK.For more information on configuring categories, see “Configuring Categories on the Mobile Server” in theAdministrator and Report Designer's Guide: SAP BusinessObjects Mobile for iOS at http://help.sap.com/bomobileios.9.2.2 Assigning Analysis Applications to the Mobile CategoryBefore users can access analysis applications on a mobile device using the SAP BusinessObjects Mobile solution,you need to assign the analysis applications to the mobile category on the BI platform.1. In the BI launch pad, go to the folder that contains the analysis application that you want to assign to themobile category.2. Select the analysis application and click More Actions Categories .The Categories dialog box appears.3. Choose the mobile category.4. Click OK.9.2.3 Configuring the BI Platform for Display of AnalysisApplications on iPhonesBefore application users can see analysis applications on their iPhones (using the mobile app of the SAPBusinessObjects Mobile solution), you need to change a property in the zen.properties file on the BI platformserver.1. On the BI platform server, navigate to the \Tomcat\webapps\MobileBIService\WEB-INF\classes\internal\zen.properties file.2. Change the document.supported.devices property as follows:○document.supported.devices = ipad, iphone114 © 2014 SAP SE or an SAP affiliate company. All rights reserved.Administrator's GuideManaging the Mobile Support for Analysis Applications

3. Stop the Tomcat server.4. Clear the cache of the Tomcat server.5. Restart the Tomcat server.After updating the SAP BusinessObjects Design Studio BI platform add-on, you need to execute the stepsdescribed above again.9.3 Creating Analysis Applications for the iPhoneWhen creating mobile analysis applications for an iPhone, note the following SAP recommendations:●●●●Keep the applications simple and do not use too many components.Only create applications based on the predefined templates for iPhones (do not use the blank template foriPhones).In the New Application dialog box, select iPhone as the target device. In the next step, select a predefinediPhone template (for example, iPhone Template 1).Do not use crosstab components for iPhone applications as this is not supported by SAP.Only design iPhone applications in portrait format. Landscape orientation is not supported when running theapplication in the SAP BusinessObjects Mobile solution.9.4 Further informationFor more information about creating analysis applications with SAP BusinessObjects Design Studio, see theApplication Designer Guide: Designing Analysis Applications on the SAP Help Portal at http://help.sap.com/boad.For more information about installing, configuring and managing SAP BusinessObjects Design Studio, see theAdministrator Guide: SAP BusinessObjects Design Studio based on SAP BusinessObjects BI Platform on the SAPHelp Portal at http://help.sap.com/boad.Administrator's GuideManaging the Mobile Support for Analysis Applications © 2014 SAP SE or an SAP affiliate company. All rights reserved. 115

10 Managing the Mobile Support for SAPLumira Server or SAP Lumira CloudSAP Lumira server and SAP Lumira cloud are visual data analysis tools. Integration with SAP BusinessObjectsMobile means that users can access datasets and visualizations on the iPad. Users can also create visualizationson the iPad and save them to the SAP Lumira server or the SAP Lumira Cloud. This section providesadministrators with an overview of the tasks required to connect SAP Lumira server or SAP Lumira Cloud withSAP BusinessObjects Mobile.10.1 Configuring the Connection to SAP Lumira server or SAPLumira Cloud1. In the SAP BusinessObjects Mobile application, open the Application Settings.2. Tap Create new connection, and then tap Connection type.3. Choose SAP Lumira Cloud or SAP Lumira server.4. Enter a Connection Name.5. Enter the Server URL.6. Enter a User Name.7. Optional: Enter a Password then toggle Save Password to ON. If you do not enter a password, you will beprompted to enter a password when you attempt to connect to the SAP Lumira Server or SAP Lumira Cloud.8. Tap Done.The connection you created will appear in the connections list in the Application Settings. Tap the connectionname to connect to SAP Lumira Server or SAP Lumira Cloud.10.2 Further InformationFor more information about creating visualizations with SAP Lumira Server, see the SAP Lumira Server UserGuide on the SAP Help Portal at http://help.sap.com/lumiraFor more information about creating visualizations with SAP Lumira Cloud, see the SAP Lumira Cloud User Guideon the SAP Help Portal at http://help.sap.com/lumira.116 © 2014 SAP SE or an SAP affiliate company. All rights reserved.Administrator's GuideManaging the Mobile Support for SAP Lumira Server or SAP Lumira Cloud

11 Troubleshooting Errors11.1 Troubleshooting the Mobile Server Error MessagesIn this section, you find a description of the error messages that are generated on server side of the SAPBusinessObjects Mobile on iOS application. This information may help you in troubleshooting these errors whenthe app users face them.●NoteErrors explained in this section are generated on the server side of the Mobile solution, yet they areencountered while working with the app.● Most errors occuring on the server are caused by HTTP errors such as HTTP 503, HTTP 400, HTTP 404,HTTP 500 and others.With effect from the 4.0.3 release of the application, whenever the application (client) receives an HTTP errorcode from the server, the code is included in the error message displayed by the app. This helps theadministrator identify the server error and take the required action to fix it.For example, consider the following error:"Connection to the server could not be established; try again or contact your administrator (MOB06005)"If during the occurence of this error, the application recieves HTTP 503 error from the server, the errormessage is displayed as:"Connection to the server could not be established; try again or contact your administrator (MOB06005)(HTTP 503)"Sometimes, instead of the HTTP code, the server may return a zero error code ('0'). In this case, theapplication does not append anything to the error message.11.1.1 An internal server error occurred while processing theclient request (MOB00022)CauseThis error occurs when the user is connected to 4.0 Fix Pack 2.13 release of the BI platform server and doescontent Search on server using the SAP BI application on iPad. It is a limitation of server configuration.ActionTo resolve this issue, take the following steps:1. Stop the Web application server on which the MobileBIService.war is installed.2. Locate MobiService.jar file in the following directory:\MobileBIService\WEB-INF\lib3. Open MobiService.jar as a zip file (using Winrar or Winzip).Administrator's GuideTroubleshooting Errors © 2014 SAP SE or an SAP affiliate company. All rights reserved. 117

4. Extract command_factories.properties file from the MobiService.jar5. Open command_factories.properties using a text editor and add the following lines at the end of file:com.businessobjects.mobilebi.server.messages.AdvancedSearchRequest=com.businessobjects.mobilebi.server.commands.impl.AdvancedSearchFactorycom.businessobjects.mobilebi.server.messages.AdvancedSearchDataRequest=com.businessobjects.mobilebi.server.commands.impl.AdvancedSearchDataFactorySave the file.6. Update MobiService.jar with the updated command_factories.properties file.7. Restart the Web application server.11.1.2 Connection to the server could not be established;contact your administrator if the problem persists(MOB06004)CauseThe proxy information configured on the device might be incorrect or the application server might be down.Action1. Verify that the proxy server settings are configured correctly on your device.2. Verify the connectivity to the application servers on which the Mobile WebApp and the BusinessObjectsEnterprise (BI platform) is deployed. You should also make sure that these servers are up and running.11.1.3 Connection to the server could not be established; tryagain or contact your administrator (MOB06005)CauseThis error occurs when there is a problem in redirecting the request to the Web proxy server. The server is unableto handle the request temporarily, due to an overload of the request. This error arises due to HTTP 503 responsefrom the server.ActionTrying again after sometime resolves the issue.11.1.4 The request has timed out; try again or contact yoursystem administrator (MOB06006)CauseThis error occurs when user's HTTP request to the server has timed out. This can be due to slow speed of thenetwork or because of connectivity problems between the client and server.118 © 2014 SAP SE or an SAP affiliate company. All rights reserved.Administrator's GuideTroubleshooting Errors

ActionVerify the connectivity of user's mobile device to the mobile server.11.1.5 You are not authorized for this request (MOB06008)CauseThe file for which the user has requested the server requires access rights and permissions.ActionCheck if the user is authorized to view or access the requested document on the BI platform.11.1.6 Your request is invalid; verify the connection details orcontact your administrator (MOB06009)CauseThe request which the user has made to the server is incorrect. This message may also be displayed due to anHTTP 404 error.ActionAsk the user to try again after some time. If user's request invokes a document from the server, verify if therequested document is accessible on the BI platform server.11.1.7 Internal server error occurred while processing yourrequest; try again or contact your system administrator(MOB06010)CauseThis error indicates that the Web application server has encountered some unexpected condition. This can alsoarise due to improperly configured proxy servers.ActionVerify that the proxy server settings are configured correctly on user's device.If this does not resolve the problem, try restarting the Web application server.Administrator's GuideTroubleshooting Errors © 2014 SAP SE or an SAP affiliate company. All rights reserved. 119

11.1.8 Missing prompt value; select at least one value for theprompt (MOB06011)CauseThis error appears when the user has not entered any values in the prompt which appears while refreshing a WebIntelligence document using the app.ActionAsk the user to ensure that he/she has selected at least one value for each prompt that appears on refreshing adocument.11.1.9 Verify network connectivity (MOB06021)CauseThis error is encountered when the openDocument link of a webintelligence document is not able to fetch orretrieve the target document.ActionVerify that the network connectivity is fine. You can do so by trying to access the internet from the browser onuser's device.11.1.10 Connection to the server could not be established; tryagain or contact your administrator (MOB06031)CauseThis error occurs when the network within which users are working does not have connectivity with the SAPBusinessObjects Mobile server.ActionVerify the server connection details in the app on user's device, such as the IP address or syntax of the connectionURL.11.1.11 Server returned an error while downloading thedocument (MOB06060)CauseThis error may appear when the user is trying to download a document. It occurs due to following reasons:120 © 2014 SAP SE or an SAP affiliate company. All rights reserved.Administrator's GuideTroubleshooting Errors

●●There are connectivity issues between the Mobile server and the CMS (BI platform server).The document which the user is trying to download is corrupt.ActionAsk the user to try downloading the document again. If the problem persists, check if the document is openingand behaving as expected on the BI platform.11.1.12 This action cannot be performed; verify networkconnectivity (MOB08002)CauseThis error occurs due to one of the following reasons:●●Connection to the BI platform server is lost.The device has lost its connectivity to the Wifi network.ActionVerify the following:1. Application's connectivity to the BI platform.2. Device connectivity to the Wifi network.11.1.13 An internal server error occurred while processing yourrequest on hierarchical data; the document will be closed;contact your administrator for more information (MOB09001)CauseThis error is encountered when users are working with reports based on hierarchical report parts or hierarchicalprompts. It occurs because the Web Intelligence server is unable to fetch data from a hierarchical data source(such as OLAP and BW).Administrator's GuideTroubleshooting Errors © 2014 SAP SE or an SAP affiliate company. All rights reserved. 121

ActionNone. This is a known limitation of the app.11.1.14 There was a problem in opening the document;download the document again or contact your administrator(MOB06061)CauseThis error appears when users are trying to open a document that is either corrupt or is not downloadedcompletely.ActionAsk the user to download the document again and to download it completely. Also, check if the document isopening and behaving as expected on the BI platform.11.1.15 Maximum character file size limit exceeded. Thedocument is too large to be processed by the server. Contactyour BusinessObjects administrator (WIS 30272)CauseWhen users view a Web Intelligence document in HTML format, the Web Intelligence server generates characterbased output, which is then interpreted by the Web browser. This errors occurs, if the size of the character outputis greater than the maximum size specified by you on the Web Intelligence server.ActionAs the app administrator, you can change the value for Maximum Character Stream Size (MB) in the WebIntelligence Processing server properties via the CMC (Central Management Console). However, increasing themaximum binary output (Binary Stream Maximum Size (MB)) can affect the performance.122 © 2014 SAP SE or an SAP affiliate company. All rights reserved.Administrator's GuideTroubleshooting Errors

11.2 Troubleshooting the Mobile Client Error MessagesIn this section, you find a description of the error messages which are generated on client side of the SAPBusinessObjects Mobile on iOS application. These error messages may be encountered while working with theapp as well.11.2.1 Email is not configured on this device (MOB07001)CauseThis error occurs when the user does not have email configured on your device.ActionConfigure a valid email account on user's device.11.2.2 Internal server error occurred while processing yourrequest; contact your administrator (MOB07002)CauseThis error arises due to partially downloaded documents. When the document is not downloaded completely, it'sXML is not well-formed and so the client side software is unable to parse it.ActionDelete the document from user's device memory (downloaded list of BI documents) and download it again.11.2.3 Server error prevented the document from refreshing;try again (MOB07003)CauseThe document does not refresh due to a server error. The Universe may not have been found at the back-end.ActionCheck if the Web Intelligence server is running fine.Administrator's GuideTroubleshooting Errors © 2014 SAP SE or an SAP affiliate company. All rights reserved. 123

11.3 Configuring Trace Logs for Monitoring on the BI PlatformTracing allows you (system administrator) and support personnel to report on the performance of BI platformcomponents (servers and Web applications) and the activities that occur within the monitored components.System-level messages generated by BI platform servers are traced and written to log files. You can use these logfiles to monitor performance or for debugging purposes.Traces are recordings of events that occur during the operation of a monitored component. The traced eventsrange from severe exception errors on one end to simple status messages at another.For complete information on managing, configuring and using logs, refer to the Business Intelligence PlatformAdministrator Guide available at http://help.sap.com/businessobject/product_guides/boexir4/en/xi4_bip_admin_en.pdf124 © 2014 SAP SE or an SAP affiliate company. All rights reserved.Administrator's GuideTroubleshooting Errors

Important Disclaimers and Legal InformationCoding SamplesAny software coding and/or code lines / strings ("Code") included in this documentation are only examples and are not intended to be used in a productive systemenvironment. The Code is only intended to better explain and visualize the syntax and phrasing rules of certain coding. SAP does not warrant the correctness andcompleteness of the Code given herein, and SAP shall not be liable for errors or damages caused by the usage of the Code, unless damages were caused by SAPintentionally or by SAP's gross negligence.AccessibilityThe information contained in the SAP documentation represents SAP's current view of accessibility criteria as of the date of publication; it is in no way intended to be abinding guideline on how to ensure accessibility of software products. SAP in particular disclaims any liability in relation to this document. This disclaimer, however, doesnot apply in cases of wilful misconduct or gross negligence of SAP. Furthermore, this document does not result in any direct or indirect contractual obligations of SAP.Gender-Neutral LanguageAs far as possible, SAP documentation is gender neutral. Depending on the context, the reader is addressed directly with "you", or a gender-neutral noun (such as "salesperson" or "working days") is used. If when referring to members of both sexes, however, the third-person singular cannot be avoided or a gender-neutral noun does notexist, SAP reserves the right to use the masculine form of the noun and pronoun. This is to ensure that the documentation remains comprehensible.Internet HyperlinksThe SAP documentation may contain hyperlinks to the Internet. These hyperlinks are intended to serve as a hint about where to find related information. SAP does notwarrant the availability and correctness of this related information or the ability of this information to serve a particular purpose. SAP shall not be liable for any damagescaused by the use of related information unless damages have been caused by SAP's gross negligence or willful misconduct. All links are categorized for transparency(see: http://help.sap.com/disclaimer).Administrator's GuideImportant Disclaimers and Legal Information © 2014 SAP SE or an SAP affiliate company. All rights reserved. 125

www.sap.com/contactsap© 2014 SAP SE or an SAP affiliate company. All rights reserved.No part of this publication may be reproduced or transmitted in anyform or for any purpose without the express permission of SAP SEor an SAP affiliate company. The information contained herein maybe changed without prior notice.Some software products marketed by SAP SE and its distributorscontain proprietary software components of other softwarevendors. National product specifications may vary.These materials are provided by SAP SE or an SAP affiliate companyfor informational purposes only, without representation or warrantyof any kind, and SAP or its affiliated companies shall not be liable forerrors or omissions with respect to the materials. The onlywarranties for SAP or SAP affiliate company products and servicesare those that are set forth in the express warranty statementsaccompanying such products and services, if any. Nothing hereinshould be construed as constituting an additional warranty.SAP and other SAP products and services mentioned herein as wellas their respective logos are trademarks or registered trademarksof SAP SE (or an SAP affiliate company) in Germany and othercountries. All other product and service names mentioned are thetrademarks of their respective companies.Please see http://www.sap.com/corporate-en/legal/copyright/index.epx for additional trademark information and notices.