Version 2020

Preconfigure Library Mobile for Android

In a typical MicroStrategy Library Mobile deployment, a System Administrator e-mails a mobile configuration URL to users. For MicroStrategy Library Mobile for Android, this configuration URL includes information such as server information and authentication credentials. When users click the configuration URL, the MicroStrategy Library Mobile app on their Android device is configured with the appropriate connection settings for their MicroStrategy environment.

To preconfigure MicroStrategy Library Mobile for Android, perform the following steps.

  1. Set up the environment to use the MicroStrategy Library Mobile sample Android project

    Set up the environment so that you can use the MicroStrategy Library Mobile sample Android project as the base for your customizations.  

  2. Update the configuration files for the project

    Follow these steps to update the project configuration files for the MicroStrategy Library Mobile sample Android project, which are each called default_config.json. You can pre-configure more than one server.  

    1. Open the MicroStrategy Library Mobile sample Android project in Android Studio.  

    2. Navigate to the app -> src > main -> res folder. The res folder has two subfolders. The raw folder contains the project configuration file for smartphones, and the raw-large folder contains the project configuration file for tablets. Both configuration files are called default_config.json.   

    3. Make the following changes in both default_config.json files, using the appropriate values for your environment.  

      Parameter Description Example value
      nm Your dossier server name myLibraryServer.cloud.microstrategy.com
      pt Your dossier server path "MicroStrategyLibrary"
      po Your dossier server port 443
      am

      Default authentication mode. Possible values include:

      1: Standard

      8: Anonymous

      16: LDAP

      64: Trusted

      256: SAML

      1
      lo Username (can be empty) ""
      ps Password (can be empty) ""

      The code in your default_config.json files should now look like this sample:

      ...
      {
        "po": 443,
        "pt": "MicroStrategyLibrary",
        "ty": 0,
        "rt": 1,
        "udc": true,
        "nm": "myLibraryServer.cloud.cloud.microstrategy.com",
        "dmo":false,
        "wsc": {
          "am": 1,
          "lo": "",
          "ps": "",
          "ow": false
        },
        "pdc": {
          "am": 1,
          "lo": "",
          "ps": "",
          "ow": false
        },
        "pl": [
        ]
      }
      ...
      
    4. Save your changes.

  3. Build the project to confirm that the application compiles successfully  

    1. In Android Studio, build the sample project.  

    2. Run the compiled MicroStrategy Library Mobile application on a device or simulator to confirm that the APK you built can run successfully.