MicroStrategy ONE

Formatting a Toggle control

The Toggle style displays as a button in Web or on a mobile device. Users can click (in Web) or tap (on a mobile device) the button to change its display. For example, in a mobile document designed to allow supervisors to accept or reject time-off requests, you can choose to display a toggle button next to each request. Each toggle button can be displayed as one of three different images:

  • An empty circle for requests that have not yet been reviewed

  • A check mark for requests that have been approved

• An X mark for requests that have been rejected

Users can then tap the toggle button next to each request until the toggle button is displayed as the image that indicates the correct status of the request.

Continuing with the example above, the toggle button next to a request is first displayed as an empty circle on the mobile device. Tapping the button changes the display of the button to a check mark. Tapping the button again displays the button as an X mark. Tapping the button a third time displays the button as an empty circle, and so on.

When displayed in a transaction table on an iOS device, the Toggle style displays as a list.

Steps to format a Toggle control are below. For steps to navigate to where you can select the following options, see Creating a transaction-enabled document.

To format a Toggle control

  1. You can require that users click or tap the input object control before submitting their changes. Do one of the following:

    • To require users to click or tap the control before submitting their changes, select the Input is required check box.

    • To allow users to submit their changes without clicking or tapping the control, clear the Input is required check box.

  2. You must define each image that can be used to display the toggle button by specifying the address of the image and the value to assign to each image. This value will be used to represent the image when the user submits their changes. Perform the following steps:

    1. In the Value field, type the value to use when the image is selected.

    2. Type the location of the image to display in the Image Source field. You can specify the location as:

      • An HTTP reference to a central web server machine, such as http://microstrategy/Test/myimage.jpg. Intelligence Server and MicroStrategy Developer must both be able to access the machine.

      • A full path to the image on a shared network drive, such as \\my_computer\shared\myimage.jpg. All users, Intelligence Server, MicroStrategy Developer, and the web server must be able to access the drive.

      • A partial path, such as Images\myimage.jpg. The image must be copied in all of the following folders: Developer\Images, Intelligence Server\Images, and Web\Images.

    3. To add another value to the toggle button, hover the cursor over a value and click the Add icon. A new value is added below the selected value.

    4. To delete a value from the toggle button, hover the cursor over the value and click the Delete icon.

    5. Repeat the appropriate steps above for each value that you want to add to the toggle button.

  3. By default, when the text field or grid cell on which the toggle button is defined is set to a value for which no image is specified in the Control Properties, the toggle button is displayed as a blank space and no value is selected. You can specify an image to display for the toggle button instead. To do so, type the location of the image (as described above) in the first field in the Image Source column, next to the word Unset.