Selecting and configuring the action for a column

On the Edit column dialog, the Column actions section is used to indicate whether users can click the column value.

From the Column Selection tab, to display the Edit column dialog, click the edit icon for the column.

When the dialog is first displayed, the section is collapsed. To expand or collapse the section, click the section heading.

From the Column action drop-down list, select the action to perform when the user clicks the value, then configure the details.

The available actions are:
Action Name Description
No Action Indicates that the value is not hyperlinked.

For columns that contain an attribute that does not support refinement, this is the default option.

Show Details When users click the value, the Record Details component is populated with the details for that row.
Refinement When users click the value, the data is refined to only include records with that value.

If the column contains an attribute that supports refinement, then this action is selected by default.

Hyperlink When users click the value, they navigate to the specified URL.

The hyperlink can include attribute values.

To configure a selected action:

  1. If you select the Show Details or Refinement action, then in the Target page field, specify the name of the page that is affected by the action.

    If you leave the field empty, then the current page is used.

    For information on how to specify a different page in the application to be affected by the action, see Displaying component refinements or record details on a different page,

  2. If you select the Hyperlink action, then to display the URL in a new browser window, check the Open link in a new window checkbox. The box is checked by default.

    Initial view of the configuration options for the Hyperlink column action

    In the URL field, type the URL. Make sure the URL is correctly formed, and that you have properly encoded special characters.

    The URL can include attribute values. The values could be query parameters: http://www.acme.com/index.htm?p1="Red"&p2="1995"

    Or could be part of the URL path: http://www.acme.com/wines/1995/

    To add attribute values to the URL:

    1. Click Add URL Parameters.
    2. On the add parameters dialog, in the attribute list, click the add icon next to each attribute to add.

      For each attribute you select, the add icon changes to a delete icon. To not include a selected attribute in the URL parameters to add, click the delete icon.


      Dialog with URL parameters selected for a Results Table hyperlink
    3. When you are finished selecting attributes, click Apply.

      The selected attributes are displayed in a table, with each attribute assigned an ID to use when inserting the attribute into the URL.

      The attributes are also inserted as query parameters, where the parameter name is the attribute key, and the parameter value is {IDNumber}, where IDNumber is the ID for that attribute.

      For example: http://www.acme.com/index.htm?Region={0}&WineType={1}


      Hyperlink column action with parameters selected

      By default, the value is encoded. To not encode the value, change the format to {{IDNumber}}.

      For example: {{0}}

      You can also use the ID numbers to insert the attribute values manually.

      For details on component hyperlinks and encoding inserted attribute values, see Configuring hyperlinks from Studio components.

    4. To remove a URL parameter from the table, click its delete icon.

      If you did not edit the inserted query parameter, then Studio also removes it from the URL.

      If you did edit the inserted query parameter, then you must remove the parameter from the URL manually.

      If you inserted the attribute value manually, then you also must remove it manually.