Downloading and Setting Up the Mobile App

Learn how to get and set up the SAP Analytics Cloud mobile app.

Device Requirements

  iOS Android
Mobile operating systems Requires iOS/iPadOS 15.0 or later. Requires Android 9.0 or later.
Devices

Compatible with iPhone and iPad only.

Requires an iOS mobile device with 2 GB of RAM or more (iPhone 6s or later, iPad Air 2 or later, iPad Pro). For the best experience, use an iPad Pro or a mobile device with a fast processor and a good data or WIFI connection.
Requires an Android mobile device with at least 4 GB of RAM. Supported devices include Samsung Galaxy S9/S9 plus S10/S10plus, S4 Tab, S5 Tab, Google Pixel, Google Pixel 3 XL ). For the best experience, use a Samsung S10 plus or a mobile device with a fast processor and a good data or WIFI connection.
Note
The SAP Analytics Cloud iOS mobile app will cache your data (all sources) for 7 days. This cache is encrypted on the device. The cached data is only accessible via the app. You can always clear the story related cached data using theClear Storage (Clear Cache on the Android app) setting. To access the setting go to Start of the navigation pathProfile Next navigation step SettingsEnd of the navigation path.

Download and Install the iOS App

  1. Download and install the mobile app from the App store hereInformation published on non-SAP site.

  2. Tap Analytics to launch the app.

    Note

    To view and consent to our Chinese Cyber Security Law privacy statement, your device needs to be on Chinese Standard Time, and the device language must be set to Chinese.

  3. The first time you sign in, set an application password in the Set App Password screen to protect your data.

    To reset a forgotten application password, on the welcome screen tap Forgot Password. To change your application password, go to Start of the navigation pathProfile Next navigation step SettingsEnd of the navigation path and tap Change Application Password.

    Note
    As an administrator, you can disable the application password prompt for all users. From the () Main Menu, select Start of the navigation path System Next navigation step  AdministrationEnd of the navigation path and select the System Configuration tab. Toggle Disable mobile app password to ON. Once a user sets up the mobile app on their device (application password required for first-time setup), they will no longer be prompted to re-enter their application password each time the app is changed to the foreground and made active.
  4. Enter the server URL on the Enter Server URL screen and tap Connect.

    Use the base URL from the browser of your SAP Analytics Cloud web application:

    Note
    Make a note of your tenant ID.
  5. On the Authorize Client screen, tap Authorize to enable access to your SAP Analytics Cloud data.

    https://<customerdomain>.<region>.sapanalytics.cloud
    Note

    If you receive the error: Logon failed: Cannot connect to SAP Analytics Cloud. Error code: 500, check with your administrator to see if your user account is associated with more than one tenant. If so, specify the tenant name in the server URL with /tenants/<tenantname>/ as follows:

    https://<customerdomain>.<region>.sapanalytics.cloud/tenants/<tenantname>/

    To find your tenant name, log on to SAP Analytics Cloud from a web browser note the name as shown below:

Tip

You can use Touch ID or Face ID on your iOS device to log on to the SAP Analytics Cloud app. Let's enable Touch ID as an example.

Once you have set up Touch ID for your device, here's how to enable it with the SAP Analytics Cloud app:
  1. Go to your user Profile and tap the Enable Touch ID slider. Tap OK to accept.

  2. Relaunch the app and enter your application password one more time.
  3. When prompted if you would like to use Touch ID to unlock, tap YES.
  4. The next time you need to unlock the app, use Touch ID by touching your iOS device's Home button.

Download and Install the Android App

  1. Download and install the mobile app from the Google Play store.

  2. Tap Analytics to launch the app.
  3. Accept the displayed EULA.
    Note

    To view and consent to our Chinese Cyber Security Law privacy statement, your device needs to be on Chinese Standard Time, and the device language must be set to Chinese.

  4. Enter the server URL in the Enter Server URL screen and tap on the device keyboard.

    Use the base URL from the browser of your SAP Analytics Cloud web application:

    https://<customerdomain>.<region>.sapanalytics.cloud

    Note
    Chrome is the default supported browser for authentication. Use the displayed Chrome browser for the following authentication step. For authentication to work, OAuth needs to be configured on the server running the SAP Analytics Cloud web application.
  5. Enter your username and password and tap Log On. Use the same authentication credentials you use to log in to the SAP Analytics Cloud web application.
  6. On the Authorize Client screen, tap Authorize to enable access to your SAP Analytics Cloud data.

Managing the Application Password

When you first log in, you can use the Set App Password to set a password for the app and therefore protect your data. Once an application password is set, you will be prompted to enter the application password each time the app is changed to foreground and made active. As an Administrator you can disable the application password prompt for all users in the SAP Analytics Cloud web application. From the () Main Menu, select Start of the navigation path System Next navigation step  AdministrationEnd of the navigation path and select the System Configuration tab. Toggle Disable mobile app password to ON. This will enable the Skip option in the Set App Password screen, thereby giving the user a choice of setting or not setting the application password. If a user opts to Skip in the Set App Password screen, they can later set the password by going to Start of the navigation pathUser Profile Next navigation step Settings Next navigation step Enable Application PasswordEnd of the navigation path.

  • If you have forgotten the application password, on the welcome screen tap Forgot Password. This option resets the application.
  • The application will reset after you provide an incorrect password in ten attempts to launch the app.
  • To change your application password, tap Start of the navigation pathUser Profile Next navigation step Settings Next navigation step App PasswordEnd of the navigation path and tap Change Application Password.

Secure Connection Requirements

The mobile app can only connect to URLs that are trusted connections. This includes both intermediary URLs used to log on to the SAP Analytics Cloud system, or live data source connections consumed by stories viewed in the app. For example, if you are using a reverse proxy server to relay requests from the mobile app to SAP Analytics Cloud, and the connection does not satisfy certain requirements, errors may be displayed to the user. Use the information below to secure your connections for your particular app:

iOS

To test your secure connection, you may want to use a public SSL testing service, for example: https://www.ssllabs.com/ssltest/. Check the handshake simulation results for Apple ATS. More troubleshooting tips are available at: Troubleshooting Connection Issues.
Note
For the latest the ATS compliance requirements refer to communication from your ATS certificate provider.

Android

A trusted SSL certificate must be installed on the server (such as the reverse proxy server). This means that the server has secure server certificates from a Certificate Authority (CA), and the CA is trusted by Android ( the trusted root certificates are installed on the device under Settings > Biometrics and Security > Other Security Settings > View security certificates). Possible error message:

An SSL Error has occurred. This may be due to the detection of a self-signed certificate on the server. Please only use certificates generated by a CA.Self-signed or untrusted SSL certificates are not supported.

Note
More information on Android secure connection issues is available at:https://developer.android.com/training/articles/security-config#TrustingDebugCaInformation published on non-SAP site