Linking to documents and reports from an iPhone or iPad document

You can use links in a document displayed on the iPhone or iPad to run a report or document. For example, if a user is viewing a document containing regional sales, he can select a particular region to execute another document that displays sales for the stores in that region. This is a form of drilling, where the user has drilled from region to store. The source document could also link to the underlying dataset report, to display profit and cost values as well. Links can also allow iPhone and iPad users to change the grouping of displayed data and the layout that they are currently viewing, and access items in the Reports screen.

To create links to a report or document that is viewed on an iPhone or iPad, you must create the URL for each link manually, using the correct link syntax, as described in the steps below. Links created in the Link Editor are not supported in MicroStrategy Mobile for iPhone, except for links created in:

A report displayed on an iPhone
A report displayed as an Interactive Grid widget on the iPhone
An Interactive Grid widget on the iPhone

Once you have created a link to execute a report or document, you can add parameters to the URL to perform additional tasks, such as providing answers for prompts in the linked document, or specifying which layout to display. For a list of tasks you can perform, see Using links to answer prompts, display document layouts, and group data in a report or document. Steps are below to create a link to run a report or document.

Note: If you add a link to a text field, the user will only be able to open the link by selecting the link text on the iPhone or iPad. To create a link with a larger area that is easier to select, you can define a link that includes both the text and the area around it, or create an image button that users can select. To do this, you can:

Create an image to use as the button and add a link to it.
Insert a transparent image into the document, then enlarge and/or position it to cover the desired link area. Add a link to the transparent image. The user can then select any area covered by the image to open the link. A sample transparent image is located by default in Program Files\MicroStrategy\Intelligence Server\images\1ptrans.gif.
To ensure that the area of the link is large enough to recognize a user selecting it, make sure it has a height and width of at least 40 pixels.

Prerequisite

Before creating a link, you must first create the report or document you want to link to, and find its ID. For steps to find the ID of a report or document, see To obtain the ID of a report or document.

To create a link to run a report or document

Open the document in Design or Editable Mode.
To use a text field for the hyperlink, complete the following steps:

From the Insert menu, select Text.
Click in the section of the document where you want to place the text field. If you click and drag in the section, you can size the text field.
Type the text to be displayed to users into the text field. You can add static text, dynamic text (in the form of data fields and auto text codes), or a combination to the text field:

To add static text, type the static text into the text field.

To add a data field, drag and drop a dataset object from the Dataset Objects panel into the text field.

To add an auto text code, from the Insert menu, select Auto-text, then select the code to insert.

To use an image for the hyperlink, complete the following steps:

From the Insert menu, select Image.
Click in the section of the document where you want to place the image. If you click and drag in the section, you can size the image. The Properties and Formatting dialog box opens.
Type the address of the image file to insert in the Source field.
Click OK. The image appears in the document.

Right-click the image or text field and select Properties and Formatting. The Properties and Formatting dialog box opens.
From the left, select General.
Select the Is Hyperlink check box.
Type the URL of the link in the Hyperlink field, as follows:

To create a link to run a document, use the syntax:

http://MSTRMobileURL?src=source&evt=2048001&currentViewMedia=2&documentID=objectID

To create a link to run a report, use the syntax:

http://MSTRMobileURL?src=source&evt=4001&reportViewMode=view&reportID=objectID

To have the link display a folder, show a screen such as the Home screen or Reports screen, or display a selection screen to change the group-by in a document, use the URL for the task you want to perform, listed in the table below.

Replace the italicized variables in the link with the appropriate values. The table below lists each variable, and the text to replace it with.
Click OK to save changes.

Replace the italicized variables in the URL, as summarized below:

Variable

Replace With

MSTRMobileURL

You must provide the path to your Mobile Server in the link. You can provide the full address of the Mobile Server (absolute path), or a shortened address (relative path).

If you provide an absolute path, you can specify a Mobile Server to use other than your main Mobile Server. However, if you change the name or setup options of the Mobile Server in the link, all your links will have to be updated.

Using a relative path allows you to easily duplicate a project or use a different Mobile Server, but you cannot specify a particular Mobile Server to use.

To use an absolute path to your Mobile Server, use one of the following:

For .NET: Mobileserver/MicroStrategy/asp/Main.aspx
For JSP: Mobileserver/MicroStrategy/servlet/mstrWeb

Replace Mobileserver with the name of your MicroStrategy Mobile Server.

To use a relative path to your web server, use one of the following:

For .NET: Main.aspx
For JSP: mstrWeb

source

The source parameter is the page component that should handle the action and the event.

Replace source with the following:

For a document using JSP format, mstrWeb.2048001
For a document using .NET format, Main.aspx.2048001
For a report using JSP format, mstrWeb.4001
For a report using .NET format, Main.aspx.4001

view

When you execute a report, you can specify whether to display the report in grid or graph view.

Replace view with one of the following:

To display the report as a grid: 1
To display the report as a graph: 2

objectID

You must provide the ID of the target report or document.

Replace objectID with the ID of the target report or document.

For steps to obtain the ID of a report or document, see the steps below.

Prerequisite

This procedure assumes you have already created the report or document for which you want to obtain the ID.

To obtain the ID of a report or document

Navigate to the folder location of the report or document.
Right-click the report or document, then select Properties. The Properties dialog box is displayed, with the object's ID displayed in the ID field. You can highlight and copy this ID to use in a link URL.