MicroStrategy ONE

Shortcuts

A shortcut is a hyperlink defined in the Page Configuration file. A group of shortcuts is called a shortcut list. A shortcut list can be defined in a page or inherited from the default page. Any number of shortcut lists can be used on a page. Shortcuts are defined as part of one or more shortcut lists, which are often presented as navigation bars.

The top shortcuts bar in MicroStrategy Web lists several shortcuts which are hyperlinks to different pages within MicroStrategy Web.

The toolbar is the most commonly used shortcut list. It is rendered with MicroStrategy custom tags.

  • The <web:shortcutOptions> tag presents each shortcut in a shortcut list.  

  • The <web:shortcutProperty> tag allows you to specify properties about how each shortcut is displayed.  

  • The <web:shortcutElement> tag lists the shortcut.  

  • The <web:shortcutSeparator> tag lets you provide rules for what appears between each shortcut link.

Another interesting example of shortcut use in MicroStrategy Web products is the Page Configuration file's <menus> tag. Learn more about this in Menu Configuration File XML Structure.

Refer to the MicroStrategy Custom Tags Reference for information on how to use these tags.

Syntax

Every shortcut has a number of properties indicated by <shortcut> node attributes, as shown in the following example:

J2EE environment:

<shortcut desc="Shared Reports" desc-id="mstrWeb.2" feature-id="public-reports" href="mstrWeb?evt=2001&src=mstrWeb.shared.2001" iframe="false" name="public"/>

.NET environment:

<shortcut desc="Shared Reports" desc-id="mstrWeb.2" feature-id="public-reports" href="Main.aspx?evt=2001&src=Main.aspx.shared.2001" iframe="false" name="public"/>

The main shortcut properties are listed below:

Property Description

desc-id

Refers to a key in a localized descriptor file, defined in the Messages Bundle.

desc

Used verbatim in desc-id’s absence.

feature-id

Indicates a feature or MicroStrategy privilege that a user must have to access the page’s content. If the feature is not available to the user, the page is not displayed and the user is redirected to the Access Denied page.

href

Provides the URL for the hyperlink. This may be to another MicroStrategy Web page or to any non-MicroStrategy Web page. This is effective only if a <shortcut> does not have a child <event> node. If you examine the out-of-the-box Page Configuration file, shortcuts are defined based on events. You can define event-driven shortcuts in this way as well.

name

Name with which this shortcut is known to the rest of the application.

See also: