Skip to main content
Skip table of contents

Configure Field Drop-down Labels

When you are selecting fields to add to a table, if you click the arrow to the right of a field, SuperWEB2 displays a drop-down box that allows you to quickly select all values from that field. If the field is a hierarchy, this option allows you to select all items at a particular level in the hierarchy.

For example, if you click the arrow alongside the Area field in the Retail Banking dataset, the drop-down box allows you to select all the values at the State, State Sub-Division, State Suburbs, or Postal Codes levels:

Selecting the State option from the Area Select All at Level dropdown box

By default, SuperWEB2 displays the value set labels that were defined in SuperCHANNEL when the SXV4 dataset was created , but you can configure what appears in this drop-down:

  • You can change the value set labels to use alternative text strings specified in the SuperWEB2 configuration. This can be a useful option if you did not set the classification table labels when the SXV4 was created, as it allows you to replace the default labels without having to re-channel the SXV4.
  • Alternatively, you can choose to display the label of the first item in each valueset instead of the valueset label. For example:

    Selecting the State option by clicking New South Wales in the Area Select All at Level dropdown box

  • You can also change the "Select all at level" text that appears in the first line.

If you override the value set labels in the SuperWEB2 configuration, then your new value set label text will be used in the table title and axis headings, whenever you add that field to a table (and the value set labels will also appear in Graph View and Map View). If you do not override the value set labels in the SuperWEB2 configuration, then the field names will be used in table titles, axis headings, Graph View, and Map View.

Configure Value Set Labels to use Alternative Text Strings

The following steps only apply to hierarchical fields. Non-hierarchical fields use the field name in the Select all at level drop-down instead. 

To change the value set labels, you first need to find the value set IDs. You can do this in SuperADMIN, as follows:

  1. Use the command cat <dataset_id> fields to get a list of fields in the dataset. For example:

    CODE
    > cat bank fields
    [ Summation Field : 'Customers' ]
    [ Summation Field : 'Customer Profit' ]
    [ Summation Field : 'Accounts' ]
    [ Summation Field : 'Account Profit' ]
    [ Summation Field : 'Average Account Balance' ]
    [ Field Group: 'Customers' ]
        [ XTAB Field : 'Age' ]
        [ XTAB Field : 'Age Groups' ]
        [ XTAB Field : 'Gender' ]
        [ XTAB Field : 'Marital Status' ]
        [ XTAB Field : 'Occupation' ]
        [ XTAB Field : 'Area' ]
        [ XTAB Field : 'Customer Mail Indicator' ]
        [ XTAB Field : 'Individual \ Company' ]
        [ XTAB Field : 'Customer Open Calendar Date' ]
        [ XTAB Field : 'Customer Open Financial Date' ]
    ...
  2. Then, for each field you want to set labels for, use the command cat <dataset_id> <field>. SuperADMIN will display details of the field's value sets. For example:

    CODE
    > cat bank Area
    [ XTAB Field : 'Area' ]
        [ ID : 'SXV4__Retail_Banking__F_Customer__Area_FLD' ]
        [ Value Set : 'SXV4__Retail_Banking__C_State' ]
            [ Value Set : 'SXV4__Retail_Banking__C_Geography_2' ]
                [ Value Set : 'SXV4__Retail_Banking__C_Geography_1' ]
                    [ Value Set : 'SXV4__Retail_Banking__C_Geography_0' ]

    In this example, the Area field has value sets at the four levels of the hierarchy.

    The format of the value set name returned in SuperADMIN is:

    CODE
    <dataset_type>__<dataset_name>__<valueset_id>

    In the example above, the value set IDs are therefore C_State, C_Geography_2, C_Geography_1, and C_Geography_0.

Once you have all the value set IDs, you can configure your preferred text strings. The process varies depending on whether your deployment has been configured to support multiple dataset languages. Follow the appropriate steps below.

Single Dataset Language Deployments

If you are using a single language deployment, then you need to use the SuperADMIN cfg command to change the labels. For each value set ID, you need to use a command similar to the following:

CODE
cfg global superweb2.valueSetLabels.<valueset_id> set <label_text>

For example:

CODE
cfg global superweb2.valueSetLabels.C_State set "State"
cfg global superweb2.valueSetLabels.C_Geography_2 set "State Sub-Division"
cfg global superweb2.valueSetLabels.C_Geography_1 set "State Suburbs"
cfg global superweb2.valueSetLabels.C_Geography_0 set "Postal Codes"

If you already have Table View open, then any changes you make to the drop-down labels will not be applied until you reselect the dataset from the Datasets page.

Non-Alphanumeric Characters in Value Set IDs

Due to a known issue, the SuperADMIN cfg command only allows alphanumeric characters and underscores in key names, and does not provide a means to escape special characters. Therefore, if your value set IDs contain other characters, such as ( or ), you will not be able to set the labels for those value sets by typing the command in the SuperADMIN console.

For example:

CODE
> cfg global superweb2.valueSetLabels.C_Geography(State) set "State"
Config command syntax incorrect: line 1, column 48:
[, ., whitespaces or EOF expected, ( encountered.

The workaround for this issue is to export the valueSetLabels key to a text file, edit the settings there, and then reimport:

  1. Use a command similar to the following to export the valueSetLabels configuration to a text file (replace the filepath and filename with the location of your choice):

    CODE
    cfg global superweb2.valueSetLabels save E:\Config\ValueSet.json
  2. Make the changes in a text editor. For example:

    CODE
    {
        "C_Age": "Age",
        ...
        "C_Geography(State)": "State",
        "C_Geography_2": "State Sub-Division",
        "C_Geography_1": "State Suburbs",
        "C_Geography_0": "Postal Codes",
        ...
    }    
  3. Import the updated configuration, using a command similar to the following (replace the filepath and filename with the appropriate value):

    CODE
    cfg global superweb2.valueSetLabels load E:\Config\ValueSet.json

Multilingual Dataset Deployments

The ss_code column in this table contains the value set IDs. To edit the value set labels that are displayed in SuperWEB2, locate the relevant value set IDs, and add the names to the <id>_name columns (where <id> is the language ID).

For example:

 

Display the Label of the First Item Instead


By default, SuperWEB2 displays value set labels in the Select all at level drop-down. If you wish, you can configure SuperWEB2 to display the label of the first item in each value set instead.

For example:

Valueset Labels (Default):First Item Label:

Selecting the State option from the Area Select All at Level dropdown box

Selecting the State option by clicking New South Wales in the Area Select All at Level dropdown box

If you are using Field Level Security, SuperWEB2 will display the first item that the logged in user has permission to see.

Please note that even if this setting is activated, any value set label overrides in the SuperWEB2 configuration will still appear in table titles, so you may still wish to use the steps above to check and set the value set labels.


To change this setting, you need to edit <tomcat_home>\webapps\webapi\WEB-INF\classes\configuration.properties.

  1. Open the properties file in a text editor.
  2. Locate the following line:

    CODE
    schemaTree.selectAtLevelShowsValuesetName=
  3. Set the value to false:

    CODE
    schemaTree.selectAtLevelShowsValuesetName=false
  4. Save your changes.
  5. Restart Tomcat (or the SuperWEB2 Service).


Changing this property to false means that SuperWEB2 more closely matches the behaviour of SuperCROSS (when selecting all the Subitems from a level of the hierarchy in the Define Recode window).

Change the "Select all at level" Text

If you want to change the "Select all at level" text, you do this by editing the file <tomcat_home>\webapps\webapi\WEB-INF\classes\common_labels.properties

There may be multiple copies of this file for different languages and locales, with names like common_labels_en.properties, and common_labels_en_AU.properties. Each one contains the text used for different languages. Depending on which languages are in use on your deployment, you may need to make these changes in multiple versions of the file. The properties file that is used will depend on the language settings in the end user's web browser, the set of supported locales defined in the faces-config.xml configuration file, and the language selected by the user from the drop-down list . See Multilingual and Localisation Support for more information about localisation and how SuperWEB2 uses the properties files.

Make a backup copy of this file before making any changes.

  1. Open the properties file in a text editor.
  2. Locate the following line:

    NONE
    tableView.schema.selectAllAtLevel=Select all at level
  3. Change the text to your preferred wording. For example:

    NONE
    tableView.schema.selectAllAtLevel=Choose a level to select all
  4. Save your changes.

  5. Restart Tomcat (or the SuperWEB2 Service).
  6. Review your changes:
    The Select All at Level dropdown box with heading text changed to Choose a level to select all
JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.