Creating a Fish Eye Selector as a selector

If a Fish Eye Selector is created as a selector, the selector can be displayed as a standard selector such as a listbox or button bar in non-Flash modes in MicroStrategy Web. If you want to display the Fish Eye Selector as a widget or a Grid/Graph, or hide it completely, in non-Flash modes, create it as a widget instead. For instructions, see Creating a Fish Eye Selector as a widget. A Fish Eye Selector created as a selector can switch the panels of a panel stack, unlike a Fish Eye Selector created as a widget.

You can create a Fish Eye Selector from scratch or by applying its style to an existing selector. The following procedure creates it from scratch.

To apply the style to an existing selector, set the Flash style property (found in the Property List or the Properties dialog box) to Fish Eye Selector.

A Fish Eye Selector always displays in Flash Mode as a widget.

To create a Fish Eye Selector (using a selector)

1. Open a document in the Document Editor. How?

Create the target

1. Create the Grid/Graph or panel stack to be used as the target, if it is not already in the document. For instructions, see Displaying reports in documents: Grid/Graphs or Adding panel stacks to documents.

Create the selector

If the selector is not switching panels, the selector and target must have an attribute or metric in common. If targets are automatically maintained and you place the selector and the target in the same document section or panel, you will not need to disable automatic target maintenance to select the target. For information on the effects of disabling it, see Disabling automatic target maintenance to allow manual target selection.

2. Click the Selector icon in the toolbar, and then select Fish Eye.

   When you move the cursor to the Layout area, the pointer becomes crosshairs.

3. Click in the desired section of the Layout area. If you click and drag in the section, you can size the selector. The selector is added to the document.

Define the action type

4. Right-click the new selector, and select Properties. The Properties dialog box opens.

   You can also change these properties using the Property List.

5. Click the Selector tab.

6. Select an Action Type from the drop-down menu:

   • Select attribute element: The selector displays a list of the elements from the attribute selected in the Source field, when the document is displayed in MicroStrategy Web.

   • To display attribute elements in the selector, choose Select attribute element. Users will choose from this list of elements to update target panel stacks and Grid/Graphs in the document. Later in this procedure, you specify the attribute whose elements users will choose from.

   • To display metric names in the selector, choose Select Metric. Users will choose from this list to update target Grid/Graphs in the document. Later in this procedure, you specify the target Grid/Graph or panel stack whose metrics users will choose from.

     Metrics in text fields within the target are not listed when the document is displayed. For example, a panel stack is selected as a target and contains a metric in a text field. That metric is not shown as an item in the selector.

   • To display panels in the selector, choose Select Panel. Users will choose from this list to update target panel stacks in the document. Later in this procedure, you specify the panel stack whose panels users will choose from.

     If you define the DHTML Style as Check Boxes, Select Panels is unavailable, since you cannot display multiple panels simultaneously. Select a different DHTML Style to display panels.

     Do not choose Metric condition as the Action Type. Metric condition selectors do not display as Fish Eye Selector.

7. If you chose Select attribute element as the Action Type, select a Source from the drop-down list.

   • The Source drop-down list contains all of the attributes in all of the datasets in the document. The selector displays the attribute elements of the attribute selected as the Source.

Connect the selector to the target

8. If you choose Select panel as the Action Type, from the Panel Stack drop-down list, select the panel stack that the selector will change.

   • The Panel Stack drop-down list contains all of the panel stacks in the document. The selector displays the panels of the panel stack selected in this option.

9. If users will be selecting attribute elements or metrics (in other words, if you set the Action Type above to either Select attribute element or Select metric), you can select one or multiple Grid/Graphs or panel stacks, and any combination of Grid/Graphs and panel stacks. The target Grid/Graph or panel stack displays the attribute elements or metrics that the user chooses from the Fish Eye Selector.

   • If targets are automatically maintained and you added the selector and target to the same document section or panel, the target Grid/Graph or panel stack is automatically added as a target to this selector.

   • If targets are automatically maintained but the selector and target are not in the same document section or panel, you must disable automatic target maintenance before selecting targets, as described below:

     1. Click Manual Targets. A warning message opens, indicating that you will need to manually maintain targets if you disable automatic target maintenance. For the effects of disabling automatic target maintenance, see Disabling automatic target maintenance to allow manual target selection.

     2. Click OK. You are returned to the Properties dialog box. Automatic target maintenance has been disabled for all selectors in the layout.

   • If targets are not automatically maintained, or you disabled automatic maintenance, you must manually specify the target of the selector:

     1. Select the target in the Available targets list, and click > to move it to the Selected targets list.

To set a default selector style for non-Flash modes/views

10. In Flash Mode in MicroStrategy Web, the Fish Eye Selector is displayed as designed above. In non-Flash modes, the Fish Eye Selector is displayed by default as a Listbox style selector. To change the default selector style (for non-Flash Mode display), select a different DHTML style. The DHTML styles are listed below:

    • Drop-down

    • Slider

    • Listbox

    • Radio Buttons

    • Check Boxes

    • Button Bar

    • Link Bar

11. For Slider, Radio Buttons, Check Boxes, and Button Bar selector styles, the Orientation option is available. You can select whether to display the selector horizontally (on a single line from left to right) or vertically (in a single column).

12. The user must select an item in a selector to change the target of the selector. For the List Box selector style, you can allow a user to select an item by hovering the cursor over it, without clicking, if you select the Change selection on mouseover check box. If the user points the cursor away from the selector without clicking an item, the target reverts to its previous state.

    • The mouseover property is applied only in Flash Mode.

    • To allow multiple selections and define the All option for users

13. By default, the user can display all attribute elements or metrics in the target at one time, by selecting the All option. To disable the All option, clear the Show option for all check box.

    The Show option for all check box is not available if either of the following is true:

    The Action Type is set to Select panel.

    The Style is set to Slider and the Allow multiple selections check box is selected.

14. By default, the All option (described in the previous step) is displayed as (All) in the selector. You can rename the All option by typing text into the Alias for All field.

    This option is available only if Show option for All is selected.

15. By default, users can only select one item from the following selector styles: Slider, Listbox, Link Bar, and Button Bar. To allow users to make multiple selections for these selector styles, select the Allow multiple selections check box. This check box is cleared by default. This option is unavailable for other selector styles (except for Check Boxes) because those styles do not support multiple selections.

16. Click OK to return to the document.

Related Topics

• Creating Fish Eye Selectors

• Replacing the selector items of a Fish Eye Selector with images

• Creating a Fish Eye Selector as a widget

• Formatting Fish Eye selectors for Flash Mode