Usage and example

The radio button web extension requires you to specify these parameters:

  • Item keys: A reference to a range of cells that contain the unique names of items and actions for further processing.
  • Item data: A reference to a range of cells that contain data for list items, or a cell that contains XML with the same data. The first column of the data range is reserved for the keys of items. In XML, keys are represented by rows. Valid properties are: Caption (string), Visible (boolean), and Enabled (boolean).
  • Orientation: A value (horizontal or vertical) that specifies the orientation of the radio buttons. The default is vertical.
  • Selected item: A reference to a cell that contains the unique name of the item to be selected when the report loads.
  1. Create an Application Studio report.
  2. Insert this sample data into the specified cell ranges:
    B7:B11 C7:C11 D7:D11 E7:E11
    Key Caption Visible Enabled
    Option_1 Option 1 TRUE TRUE
    Option_2 Option 2 TRUE TRUE
    Option_3 Option 3 TRUE TRUE
    Option_4 Option 4 TRUE TRUE
  3. Create a report variable named rv_SelectedItem. Specify the unique name of the item to be preselected. For example, specify Option_1. In the properties of the variable, specify Option_1 as the default value and select False as the value of Is Persistent option.
  4. On each of the key cells ( B8, B9, B10, and B11), create an action with these characteristics:
    Actions: Type
    Select Set Parameters as the action type.
    Actions: Condition
    Select =TRUE.
    Actions: Mode
    Select Web Extension as the mode.
    Parameters: Name
    Click Add parameter and select the rv_SelectedItem variable.
    Parameters: Property
    Select Value(.Text).
    Parameters: Value
    Specify =Actions.Input.Text.
  5. Click Web Extension on the Objects toolbar and double-click the Radio Button web extension.
  6. Drag the cursor to insert, size, and position the web extension in the report.
    The Format Web Extension dialog is displayed.
  7. Specify these parameters:
    Item Keys
    Specify =B8:B11.
    This refers to the range of cells that contain the unique names of the items.
    Item Data
    Specify =B7:E11.
    Refers to the range of cells that contain the data for the items' keys.
    Orientation
    Specify =""
    This specifies that the default, vertical alignment, is applied.
    Selected Item
    Specify rv_SelectedItem.
    This refers to the unique name of the currently selected item.
  8. Click OK and view the report in a web browser.