Version 2021

Deploy Multiple MicroStrategy Mobile Projects in iOS

It is possible to deploy multiple mobile applications using the MicroStrategy Mobile project so that each application is treated independently. This is accomplished by specifying a unique bundle identifier for the MicroStrategy Mobile project (for each mobile application) and making changes to the Mobile Configuration URL. To change the name of the mobile application, see Rebranding MicroStrategy Mobile.

Usage of the term "deploying" in this topic relates to compiling the MicroStrategy project during development. See Distributing iPhone or iPad Applications for instructions on making the mobile application available for users.

To deploy multiple mobile applications using the MicroStrategy Mobile project, perform the following steps.

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

  2. Update the Property List file 

  1. Confirm that the application compiles successfully

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

  1. 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. 

  1. Update the Property List file

    1. If it is not already open in the editor, double-click the appropriate property list file (Info_IPhone.plist or Info_IPad.plist for iPhone and iPad respectively) to edit it
    2. The information property Bundle identifier stores the value of the application ID. Update the value of the information property Bundle identifier with the application ID. 
    3. Save your changes.
  1. Build the project to confirm that  it compiles and deploys successfully

    Build and deploy the project as described below: 

    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.

Repeat the above steps for every MicroStrategy Mobile Project you wish to deploy providing a unique name for each project or application.

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.
 

Additional changes for using Mobile Configuration URL

The Mobile Configuration settings in MicroStrategy Web provide the System Administrator the ability to generate a Mobile configuration URL and send it to the MicroStrategy Mobile users. This configuration URL includes information such as authentication credentials, memory limits, and homescreen preferences which can be automatically configured by a mobile user by simply clicking the URL sent by the administrator. In cases where multiple iPhone or iPad applications (created using the MicroStrategy Mobile project) are installed on an iPhone or an iPad, additional steps are required to enable the automatic configuration of every iPhone and iPad application using the configuration URL. This is because a configuration URL for iPhone uses the prefixmstr://(as shown in the example below) which identifies an iPhone application created using MicroStrategy Mobile. The configuration URL for iPad uses the prefixmstripad://(as shown in the example below) which identifies an iPad application created using MicroStrategy Mobile.

Example of a Mobile Configuration URL for an iPhone:

mstr://?url=http%3A%2F%2FmyServer%3A8080%2FMicroStrategy%2Fservlet%2FtaskProc%3FtaskId%3DgetMobileConfiguration%26taskEnv%3Dxml%26taskContentType%3Dxmlanf%26configurationID%3D191bf822-d405-4392-bfe2-809f5526dcecauthMode=1

Example of a Mobile Configuration URL for an iPad:

mstripad://?url=http%3A%2F%2FmyServer%3A8080%2FMicroStrategy%2Fservlet%2FtaskProc%3FtaskId%3DgetMobileConfiguration%26taskEnv%3Dxml%26taskContentType%3Dxmlanf%26configurationID%3D191bf822-d405-4392-bfe2-809f5526dcecauthMode=1

In case of multiple applications (created using the MicroStrategy Mobile project) on an iPhone or an iPad, the configuration URL needs to have information about which specific iPhone or iPad application to configure. This is accomplished by making changes to MicroStrategy Mobile as well as changes to MicroStrategy Web as described below.

Changes to MicroStrategy Mobile

  1. After completing the steps mentioned above, open the MicroStrategy Mobile project in Xcode. 

  2. Double-click the appropriate property list file (Info_IPhone.plist or Info_IPad.plist for iPhone and iPad respectively) to open it for editing

  3. The information property URL Types stores the values for the URL Schemes used by the application. Navigate to URL Types->Item 0->URL Schemes->Item 0

  4. Update the value of the information property Item 0 (under URL Schemes) with a URL Scheme for your application. For example: app1mstr or app1mstripad

  5. Save your changes. 

  6. Build and deploy the project as shown below. 

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

    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.

  7. Repeat the above steps for every MicroStrategy Mobile Project you wish to deploy by providing a unique URL Scheme for each project or iPhone application.

Changes to MicroStrategy Web

iPhone-related change

After the Mobile configuration URL is generated, replace the prefix mstr:// with the URL scheme specified in Changes to MicroStrategy Mobile for every installed iPhone application (created using the MicroStrategy Mobile project) before sending it to the iPhone users. For example, if you have two iPhone applications with URL schemes app1mstr and app2mstr, replace the prefix mstr:// with the two URL schemes as shown in bold code below before sending the hyperlink to the iPhone users.

Mobile Configuration URL that specifies configuration settings for iPhone application with URL scheme app1mstr

app1mstr://?url=http%3A%2F%2FmyServer%3A8080%2FMicroStrategy%2Fservlet%2FtaskProc%3FtaskId%3DgetMobileConfiguration%26taskEnv%3Dxml%26taskContentType%3Dxmlanf%26configurationID%3D191bf822-d405-4392-bfe2-809f5526dcecauthMode=1

Mobile Configuration URL that specifies configuration settings for iPhone application with URL scheme app2mstr

app2mstr://?url=http%3A%2F%2FmyServer%3A8080%2FMicroStrategy%2Fservlet%2FtaskProc%3FtaskId%3DgetMobileConfiguration%26taskEnv%3Dxml%26taskContentType%3Dxmlanf%26configurationID%3D191bf822-d405-4392-bfe2-809f5526dcecauthMode=1

iPad-related change

After the Mobile configuration URL is generated, replace the prefix mstripad:// with the URL scheme specified in Changes to MicroStrategy Mobile for every installed iPad application (created using the MicroStrategy Mobile project) before sending it to the iPad users. For example, if you have two iPad applications with URL schemes app1mstripad and app2mstripad, replace the prefix mstripad:// with the two URL schemes as shown in bold code below before sending the hyperlink to the iPhone users.

Mobile Configuration URL that specifies configuration settings for iPhone application with URL scheme app1mstr

app1mstripad://?url=http%3A%2F%2FmyServer%3A8080%2FMicroStrategy%2Fservlet%2FtaskProc%3FtaskId%3DgetMobileConfiguration%26taskEnv%3Dxml%26taskContentType%3Dxmlanf%26configurationID%3D191bf822-d405-4392-bfe2-809f5526dcecauthMode=1

Mobile Configuration URL that specifies configuration settings for iPhone application with URL scheme app2mstr

app2mstripad://?url=http%3A%2F%2FmyServer%3A8080%2FMicroStrategy%2Fservlet%2FtaskProc%3FtaskId%3DgetMobileConfiguration%26taskEnv%3Dxml%26taskContentType%3Dxmlanf%26configurationID%3D191bf822-d405-4392-bfe2-809f5526dcecauthMode=1