MicroStrategy ONE

Preconfigure MicroStrategy Mobile for iOS

In a typical MicroStrategy Mobile deployment, a System Administrator e-mails a Mobile Configuration URL to users. This configuration URL includes information such as authentication credentials, memory limits, and homescreen preferences. The users click the configuration URL and the MicroStrategy Mobile application on their device gets configured with the appropriate connection settings for the MicroStrategy environment.

In this customization, you preconfigure MicroStrategy Mobile with the connection settings such that the users can start using MicroStrategy Mobile immediately after installing it on their devices. All the connection settings are preconfigured by the System Administrator prior to making MicroStrategy Mobile available to the users. This is accomplished by performing the steps below.

To preconfigure MicroStrategy Mobile in Xcode perform the following steps.

  1. Define a new configuration for MicroStrategy Mobile

  2. Set up the environment to use the MicroStrategy Mobile project

  3. Use the new configuration file

  4. Confirm that the application compiles successfully

A detailed explanation of each of these steps is provided below.

  1. Define a new configuration for MicroStrategy Mobile

    Define a new configuration for MicroStrategy Mobile from the Mobile Configuration settings in MicroStrategy Mobile Server. This generates an XML mobile configuration file in the MicroStrategy/Mobile Server/WEB-INF/xml/mobile folder of your application server for MicroStrategy Mobile.

    • If you have application-level DPC (Device Passcode) setting enabled and want to use Touch ID, you need to modify the mobile configuration file as described below:

      1. Look under ../WEB-INF/xml/mobile and find the mobile configuration file you need to modify. Files typically have names in the format, mobileConfig-<ConfigurationID. For example, mobileConfig-ff212bbb-9c9b-4279-83cb-30a5d6010bfb.

        To identify the mobile configuration file to edit, you can use the time stamp that indicates when the file was last modified, or you can open the file and check the configuration name that is displayed on the first line, as shown in bold italics below.

        <cnf n="iPad - Touch ID" cid="ff212bbb-9c9b-4279-83cb-30a5d6010bfb" v="1" bld="9.5.4004.0189J" dt="2" cntr="2">:

      2. Make a copy of the mobile configuration file to use as a backup if needed.

      3. Open the mobile configuration file and locate the <daip> element. Change the value from false to true, as shown below:

        <daip v="true"/>

      4. Save the mobile configuration file. When you recompile the application, this new configuration will be baked into the application.

    • If you intend to publish your rebranded application in the App Store, you need to change the URL scheme as described in Deploying Multiple MicroStrategy Mobile Projects. If you fail to do this, your custom app will conflict with the out-of-the-box MicroStrategy app for users who have downloaded both apps. 

    Do not enter user credentials while defining a new configuration. Users will be prompted for their credentials the first time they access the application, and their credentials will be saved for subsequent login.

  2. Set up the environment to use the MicroStrategy Mobile project

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

  3. Use the new configuration file

    Follow these steps to use the XML configuration file from step 1.

    1. Navigate to the iPhone or iPad group—iPhone if you are customizing the application for iPhone or iPad if you are customizing the application for iPad—and delete Preferences.xml.

    2. Right-click the iPhone or iPad group—iPhone if you are customizing the application for iPhone or iPad if you are customizing the application for iPad—and select Add Files to "MicroStrategyMobile". This displays a dialog for setting properties.

    3. Navigate to the XML configuration file from step 1, and select the file.

    4. Check the box for Copy items into destination group's folder (if needed) in the dialog. Leave all other selections as default.

    5. Select the appropriate target (MicroStrategyMobileIPhone and/or MicroStrategyMobileIPad for iPhone and iPad respectively) in the Add To Targets panel, and click Add. The dialog closes.

    6. Navigate to the group, iPhone (if customizing the application for iPhone) or iPad (if customizing the application for iPad), and rename the copied XML configuration file as Preferences.xml.

  4. Build the project to confirm that it compiles and deploys successfully

    1. Make sure that the appropriate scheme (MicroStrategyMobileIPhone or MicroStrategyMobileIPad for iPhone and iPad respectively) is correctly selected.

    2. Click the Run button to compile and deploy the application to a simulator. Confirm that it compiles and deploys successfully.

    To upload the application to a device, set the destination in the scheme to the mobile device and then build and run. For other requirements on deploying to a device, refer to documentation from Apple. You can access useful links to the Apple documentation from the Distributing iPhone or iPad Applications topic.