This document provides the steps required to integrate Visual Crossing mapping technology into your MicroStrategy Mobile deployment.
- Configure a working Visual Crossing environment in MicroStrategy Web
- Add the Visual Crossing mobile plugin to MicroStrategy Mobile
- Restart web servers
- Enable Custom Mobile Visualizations in MicroStrategy Web for a report or dashboard with an existing Visual Crossing Map.
- Download and install the Visual Crossing Mobile App
- Run a report that has a Visual Crossing Mobile map visualization
Follow the steps outlined in the 'Getting started with Visual Crossing 4.1 and MicroStrategy Web' document to configure a working Visual Crossing Web deployment.
If your mobile server is a separate machine from your web server, make special note of the 'Useful tip' in the 'Unpack skeleton Visual Crossing metadata' section of that document.
If your mobile deployment will not be sharing a Visual Crossing metadata with your web deployment, but will instead have its own copy, be sure you have adequate hard drive space for it. The size requirements for this depends on the data being used but it typically ranges from 100Mb - 1 GB.
Add the Visual Crossing mobile plugin to MicroStrategy Mobile
Download the Visual Crossing mobile plugin from http://www.visualcrossing.com/installations/VisualCrossing4_MicroStrategyMobilePlugin.zip.
Extract this zip file to the your MicroStrategy mobile 'plugins' directory. This should create a folder named 'VisualCrossingMobile' in that location. Once extracted, your 'plugins' folder should resemble the following diagram.
Don’t leave backups or copies of files inside the MicroStrategy Mobile plugins directory– these can confuse MicroStrategy Mobile! Copy those backups to a separate location outside of your MicroStrategy Mobile deployment.
If you are using the JSP version of MicroStrategy Mobile in a servlet container such as Tomcat, JBoss or WebLogic, you may need to repackage the war and redeploy the MicroStrategy Web application. Please consult the MicroStrategy documentation for these steps.
Restart web servers
Again, if using the servlet container, it will be necessary to stop and restart the MicroStrategy Mobile application for the new plugin to be registered with MicroStrategy Mobile.
If you are using the ASP version of MicroStrategy Web that runs inside Microsoft’s IIS, it is necessary to restart web server. The most reliable way to do this is issue an iisreset command from the Windows Command shell:
Enable Custom Mobile Visualizations in MicroStrategy Web
To enable the mobile visualization for a report in MicroStrategy Web that already contains a Visual Crossing map, navigate to the Custom Visualization menu in Tools menu->Custom Visualizations.
Set the Visual Crossing widget for your required mobile platforms. Please note that Visual Crossing mobile is not yet available for Android tablets, but will be soon.
To configure a dashboard map for use in mobile, edit the dashboard, right click on the grid to be rendered as a map, and select 'Properties and Formatting...' menu option. In the resulting dialog, select the 'Widget' tab from the menu on the left, and select the Visual Crossing widget for your required mobile platforms as shown below.
Be sure to save the report/dashboard after making these selections.
Download and install the Visual Crossing Mobile App
The Visual Crossing Mobile App is required to view Visual Crossing Maps. This app is simply the native MicroStrategy Mobile app with the Visual Crossing Mapping technology included. It retains all of the functionality of the native app. While the MicroStrategy app and the Visual Crossing app can run side-by-side on the same device, we recommend that your remove the MicroStrategy app from your device to eliminate any confusion.
The Visual Crossing App is available in both the App Store for iOS devices and in Google Play for Android devices. Simply search for 'Visual Crossing' in either of these marketplaces and install the 'VC Biz Maps' App from the search results.
After the App is installed, you must configure it to point to your MicroStrategy mobile server just as you would do with the native MicroStrategy app. You can manually configure the server connection via the app's 'Mobile Server' section in the 'Settings' dialog, or you can configure it via the 'mstr:' prefixed URL generated by the MicroStrategy Mobile Configuration web application.
The MicroStrategy native app and the Visual Crossing app share the same 'mstr' prefix. Therefore, if both apps are installed on your mobile device, it is indeterminate which app will open when you execute the configuration URL. Therefore, Visual Crossing recommends removing the native MicroStrategy app prior to running the URL.
Run a report that has a Visual Crossing Mobile map Visualization
Open the Visual Crossing Mobile app and navigate to a report or a dashboard that contains the a Visual Crossing Mobile map Visualization. If everything is configured correctly, you should see the map appear just as you would in MicroStrategy Web.