This is the documentation for SuperSTAR 9.8

SuperSTAR 9.9 is now available.
View this page in the SuperSTAR 9.9 documentation or visit the SuperSTAR 9.9 documentation home.

Skip to end of metadata
Go to start of metadata

SuperWEB2 can be configured to display 'footnote' text at the bottom of each table. For example:

The footnote is intended to provide information about the source of the data in the table, and can be set to show a different string for each dataset.

To define the text string, you need to edit the file database_labels.properties, which is located in <tomcat_home>\webapps\webapi\WEB-INF\classes\

There may be multiple copies of this file for different languages and locales, with names like database_labels_en.properties, and database_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 - SuperWEB2 for more information about localisation and how SuperWEB2 uses the properties files.

The data source text is defined in this file using two lines: one line defines the text string itself, and the other assigns that text string to a particular dataset.

For example:

bank.datasource=datasource.synthetic
people.datasource=datasource.synthetic
census.datasource=datasource.2001

datasource.synthetic=Space-Time Research synthetic data
datasource.2001=2001 National Census

In this example:

  • For tables created using the datasets with the IDs bank and people, SuperWEB2 will display the text "Dataset: Space-Time Research synthetic data".
  • For tables created using the dataset with the ID census, SuperWEB2 will display the text "Dataset: 2001 National Census".

If the text you want to show for your dataset is not already listed in this file:

  1. Add the datasource text as follows (replace <datasource_id> with an ID of your choosing to identify this text, and replace <text> with the text string itself):

    datasource.<datasource_id>=<text>
  2. Then map your dataset to this text by adding a line similar to the following (replace <dataset_id> with the ID of the dataset, and <datasource_id> with the ID of the data source text string you want to use):

    <dataset_id>.datasource=datasource.<datasource_id>
  3. Restart Tomcat (or the SuperWEB2 Service if you use SuperSTAR Suite).

If you do not want to display a data source for a given dataset, simply remove the mapping for that dataset from this file.

The data source footnote will also be displayed by default when downloading graphs to PNG or PDF. You can control the text that appears in these files by editing the settings in the sw2-chart-export-options.js configuration file.