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

This page describes major changes to the SuperSTAR suite from version 9.0 onwards. This is intended to assist customers who are upgrading to the latest version of the SuperSTAR suite.

Version 9.0

ProductAreaDescriptionMore Information
AllUnicodeSuperSTAR now features full Unicode support. In some cases you may need to update existing SXV4s, TXDs and macros to ensure they work with version 9.0 and above, although in the vast majority of cases this change will be completely transparent and no action will be required.
Data ControlRecord Count and PerturbationA new Record Count data control module has been added. In addition, the perturbation module now has the ability to perturb other results.
Data Control APIFunctionsA new function (PreJob) has been added to the Data Control API to allow for processing that needs to run before the cross tabulation.
Java Java 7 or later is now required. Java is included with the SuperSTAR installation.
SuperADMIN / SuperWEB2Configuration Server

This release introduces the configuration server. This is a JSON configuration system that stores a number of internal settings. Most of these settings are used by SuperWEB2, and were previously configured in XML and .properties files within SuperWEB2 itself. These settings can now be set and checked using the cfg command in the SuperADMIN console.

If you are upgrading from an earlier release you will need to check the list of settings that have moved to the configuration server and manually reapply any that are required for your deployment.

The configuration server communicates on port 9000, so you will need to ensure your network firewalls are properly configured to allow this communication: this port must be accessible by SuperWEB2 and any machines running the SuperADMIN console.

We recommend you do not make port 9000 publicly accessible, even if your SuperWEB2 server is publicly accessible.

SuperCHANNELBatch ModeSuperCHANNEL batch mode now supports the skip and stop cleansing rules, as well as null columns.
SuperCROSSColourMatrixThe ColourVIEW feature has been replaced with ColourMatrix.
SuperSERVERUpdate DatasetSuperSERVER now supports live updates of compatible SXV4s. As long as there have been no changes to the SXV4 schema, you can live swap to a new SXV4 with no downtime.
SuperWEB2Bulk SelectionA new feature has been added for cases where a field has a large number of valueset items. SuperWEB2 now displays a bulk selection option allowing users to search for and select the items they want.
SuperWEB2CatalogueIt is now possible to choose the sort order for the dataset catalogue.

A new SuperWEB2 configuration file,, has been added, and many settings have moved to this file. When upgrading from an earlier release you will need to manually reapply any required settings by editing the new file.

SuperWEB2Default TableIt is now possible to configure a default table for each of your datasets.
SuperWEB2Drag and DropUsers can now build tables quickly by dragging and dropping fields.
SuperWEB2Graph ViewGraph view has been completely updated with new look interactive graphs.

It is now possible to navigate up and down the levels of a hierarchical field from with the table.

In addition, the default settings have been changed so that it is now possible to mix items from different levels of a hierarchy within a table (for example adding both Victoria and Melbourne from an Area hierarchy to the table at the same time). In previous releases, this behaviour was disabled by default. You can revert to the previous behaviour by editing the rules in the RulesEngine.xml configuration file.

SuperWEB2Mandatory FieldsMandatory fields are now defined on a per-dataset basis only. Previously it was possible to define global mandatory fields.
SuperWEB2MappingSuperWEB2 mapping configuration has been moved from an XML file to the configuration server.
SuperWEB2Multilingual SupportSuperWEB2 now supports multilingual datasets. In addition, users can select their preferred user interface language from the SuperWEB2 menu. Prior to this release, SuperWEB2 automatically set the user interface language based on the user's browser settings.
SuperWEB2Ranges and QuantilesThe range and quantile options now support translations based on the current dataset language.
SuperWEB2Zero SuppressionSuperWEB2 now supports zero suppression.

Version 9.1

ProductAreaDescriptionMore Information
SuperCHANNELTotalsThe Totals Appropriate setting has been added to SuperCHANNEL. This allows you to disallow totals for specific classification tables. It currently applies to SuperWEB2 only.
SuperWEB2User Defined FieldsThis release adds the ability to import user defined fields from SuperCROSS into SuperWEB2.

Version 9.2

ProductAreaDescriptionMore Information
SuperCROSSFact Table RelationshipsIt is now possible to see a visualisation of the relationship between fact tables in the SXV4. This is particularly useful if you have a complex dataset that has lots of interconnected fact tables.

The following setting has been added to the file:

  • graphView.maxCells
SuperWEB2Graph ViewThe cell limit for accessing graph view can now be modified. Previously, this limit was fixed at 1,000 visible table cells.
SuperWEB2MetadataSuperWEB2 now uses the metadata server when connecting to a metadata database. Prior to this release, SuperWEB2 connected to the external database directly.

Version 9.2.1

ProductAreaDescriptionMore Information

The following settings have been added to the file:

  • catalogue.databaseFolderExpansionDepth
  • table.totalsInitialState

Version 9.2.2

ProductAreaDescriptionMore Information

The following setting has been added to the file:

  • table.enableDrillUpAndDrillDown

Version 9.2.6

ProductAreaDescriptionMore Information

The following settings have been added to the file:

  • download.formatNumbers
  • login.requireTerms
  • map.mapCacheLocation
SuperWEB2MappingIt is now possible to change the directory that is used to store mapping cache files.
SuperWEB2PrecisionIt is now possible to disable number formatting in downloads, which can improve the performance when downloading large tables.
SuperWEB2Table DownloadsSuperWEB2 can now be configured to add a warning/disclaimer when tables are printed.
SuperWEB2Terms and ConditionsSuperWEB2 can now display a terms and conditions screen during log in.

Version 9.2.7

ProductAreaDescriptionMore Information

A new property has been added to the mapping configuration: localFeatureUrlHostName.

This property sets the host name of the Tomcat instance that mapping will use when it needs to make a request to another of the REST endpoints.

Version 9.3.0

ProductAreaDescriptionMore Information
SuperADMIN SuperADMIN now runs an embedded H2 server, listening on port 9092 but only on localhost. In a standard configuration, only the SuperADMIN server itself needs to access this port. This database is now used to store the data for the configuration server. In a new installation it will also be used to hold Field Level Security settings. 
SuperADMINField Level SecurityIt is now much easier to allow or deny access to all values in a value set. Previously, each value had to be configured individually.
SuperADMIN / SuperWEB2Saved Tables

This release adds the ability to load TXDs into the User Data Repository through SuperADMIN. This means you can save a TXD from SuperCROSS and then load it into the SuperADMIN catalogue so that SuperWEB2 users can access that table (in previous releases this required you to save the TXD file to a location within SuperWEB2 itself).

Once you have loaded a TXD into the catalogue, you can use the cat command in SuperADMIN to manage that table (for example you can move it to a folder, rename it, or delete it).

SuperADMINServer CommandThe server command now lists SuperWEB2 instances that are registered with SuperADMIN. SuperWEB2 will automatically register itself when it starts up. The list of registered SuperWEB2 instances are used to determine which User Data Repository to apply table commands to.
SuperCHANNELPerturbationFrom 9.3 onwards, SuperCHANNEL can automatically generate R Keys for perturbation.
SuperCHANNELTDD Driver Encoding

A new option has been added to the config.txt configuration file allowing you to set the encoding to use when channelling with the TDD driver.

You may need to change this setting if you are channelling data that contains characters that are not supported by the current system codepage.

SuperCROSSSave Table FormatsA new configuration option has been added to SuperModule.ini for configuring the order that the different download formats appear when saving tables.
SuperSERVERDefault SettingsSome default settings have been changed for performance reasons: the default number of threads per cross tabulation is now 4 and the default number of processors is now 2.

Some changes have been made to audit logging:

  • SuperSERVER now logs additional events: tabulation.requesttabulation,started and tabulation.retrieved.
  • All SuperSERVER audit events now log duration in milliseconds (this includes tabulation.complete, which previously logged duration in seconds.
  • SuperSERVER audit logging is now enabled by default.

Some changes have been made to SuperSERVER and Metadata Server logging:

  • The logs are now configured to roll to a new file every day, by default.
  • The log settings are now configured in an XML file, rather than a .properties file.

The following settings have been added to the file:

  • catalogue.infoPanel.displayDatabaseMetadataDescription
  • schemaTree.selectAtLevelShowsValuesetName
  • table.useSavedTableLanguage
  • table.displayMetadataAsAnnotations
  • metadata.scanForDescriptions
  • udr.maxQueryParams
SuperWEB2Default TableThis release adds the ability to configure any table in the user data repository to be a default table. Previously, default tables could only be saved system tables (TXDs created in SuperCROSS and saved in the txd directory within SuperWEB2).
SuperWEB2Information Pages

The information pages that are displayed on the dataset catalogue screen in SuperWEB2 now support more options:

  • It is now possible to create static HTML pages for different languages, by including the language code in the filename of the HTML page.
  • It is now possible to configure SuperWEB2 to retrieve the information page from the metadata server, rather than using static HTML pages.
  • It is now possible to display metadata links (retrieved from the metadata database) on the dataset information pages.

Some settings in the file have changed. This file that is used to configure the base map images (the map imagery itself, such as the street map images or the satellite view).

  • The urllist property is now two related properties: url and subdomains
  • An additional option, BLANK, is now available for the type property.
  • The order of the map types has changed, so that satellite imagery is now the default type of map (previously the street map was the default).
  • The default base map image for street maps now uses imagery from ArcGIS online (previously the default street map imagery was provided by Map Data Services).
SuperWEB2MappingThe plugin used to display Map View in SuperWEB2 has changed to ESRI leaflet. As a result of this change, the buttons that allow you to edit the table from within Map View have changed: the Freehand button is now Polygon, and works in a slightly different way.

A number of new features have been added to metadata:

  • There is now a configuration setting that instructs SuperWEB2 to automatically scan for metadata descriptions in the metadata database, and display metadata links in the field list against fields that have descriptions in the metadata database.
  • There is now an option to automatically retrieve descriptions from the metadata database for any fields in the current table, and display them as annotations below the table.
  • A new REST endpoint has been introduced to enable administrator users to flush SuperWEB2's local metadata cache.

In some cases, precision settings in TXDs now override the SuperWEB2 precision settings.

In previous releases, the summation options precision setting (defined using the displayoptions command in SuperADMIN), and SuperWEB2's global dataprecision setting took precedence. Now, custom decimal place settings in TXDs saved from SuperCROSS that are loaded into SuperWEB2 will take precedence.

SuperWEB2Select All At Level Drop-DownIt is now possible to display the label of the first item in a valueset in the Select all at level drop-down. This new setting makes SuperWEB2 more closely match the behaviour of SuperCROSS, which displays the first item in a valueset when displaying hierarchies in the Define Recode window.

A new configuration option has been added that allows you to prevent users from sorting a field alphabetically in SuperWEB2.

By default, when a field has been added to the table rows, SuperWEB2 allows users to sort it into ascending and descending alphabetical order. In some cases, this will not make sense (for example, a date field where it does not make sense to sort the months alphabetically).

Version 9.3.2

ProductAreaDescriptionMore Information
SuperSERVERPerturbationNew functionality has been added for propagating zero across fact tables when using perturbation.

Version 9.5

ProductAreaDescriptionMore Information
Open Data APINew ProductThe Open Data API is now available. This is an additional component that provides programmatic access to SuperSTAR data using a JSON REST API.

The following settings have been added to the file:

  • externalLink.helpCatalogueURL
  • externalLink.helpGraphViewURL
  • externalLink.helpMyTablesURL
  • map.mapArcGISEndpointPattern
  • openDataApi.schema.pageSize
  • openDataApi.schema.numberOfRateLimitPerPeriod
  • openDataApi.table.maximumResponseCellLimit
  • openDataApi.table.maximumRequestItemLimit
SuperWEB2MetadataA new file, metadataRedirect.html, is now supplied with SuperWEB2 to make it easier to configure static metadata. This file contains the code for redirecting to a static HTML page based on the dataset or field that the clicked metadata link relates to.
SuperWEB2User Interface

A number of usability changes have been made to the SuperWEB2 user interface. Some on screen elements have moved or been renamed (for example, the Catalogue option on the SuperWEB2 menu bar has moved from the top-right of the screen to the top left, and has been renamed to Datasets).

If you have added your own UI languages, then some translation changes may be required.

Version 9.6

ProductAreaDescriptionMore Information
Data ControlConfidentiality Rule

Additional configuration options have been added to the confidentiality rule data control module:

  • You can now configure the confidentiality rule so that it only applies when specific fields are in the table.
  • You can now set different thresholds and frequency rules for totals and non totals.

Version 9.7

ProductAreaDescriptionMore Information
SuperCROSSGrand Total

Grand totals are now calculated using recode totals by default. This means that they now correctly handle non additive tables without double counting.

Grand totals can also now be added to tables that have multiple summation options and return correct results for the total Relative Standard Error (RSE) as well as the RSE of percentages based on the grand total.

If you wish to keep the behaviour from previous releases, set UseRecodeTotalsForGrandTotal to 0 in the super.ini configuration file.

If you load a saved table, it will use the behaviour it was created with, until the grand total is switched off.

As a result of this change, when using the new functionality if you select any of the total options from the Calculations menu your table results will be reset and you will need to run the cross tabulation again.

If you have weighted databases and you are using the SuperSERVER weighting option, then you must use the new grand total behaviour.

SuperCROSSQuantilesFor weighted databases, it is now possible to display the Relative Standard Error of the range in the labels of quantile user defined fields. You can also choose to show the minimum and maximum RSE values in each label.
SuperCROSSQuantiles (Precision)

It is now possible to configure the precision used when displaying quantile range boundaries and RSE values in the labels of quantile user defined fields.

The precision of these values is controlled by two new settings that you can add to the [Preferences] section of the cross.ini configuration file: Quantile Label Value Precision and Quantile Label Rse Precision.

SuperCROSSRelative Standard Error

When using weighted databases:

  • Relative Standard Error for user defined fields is now calculated correctly and added to tables in the same way as standard measures.
  • Relative Standard Error values are now recalculated correctly if perturbation is turned off in SuperCROSS.
SuperCROSSSummation Options

The statistics.xml file defines the statistical formulas used by SuperCROSS for its summation options.

  • Prior to version 9.7 the formulas in statistics.xml applied to unweighted summations only.
  • From 9.7 onwards, if you are using SuperSERVER weightings then statistics.xml is now used for both weighted and unweighted functions.
  • From 9.7 onwards, if you are using SuperCROSS client weightings then the unweighted functions will be loaded from statistics.xml and the weighted functions will be loaded from the formulas.xml file (this is consistent with the behaviour in previous releases).

As a result of changes to the statistics.xml file that is provided with SuperCROSS, the default set of functions available for some summation options has changed.

In previous releases, the Define Recode window displayed a number of functions for counts, such as Mean and Standard Deviation, even though these are not meaningful calculations for a record count (for example, the mean of a record count will always be 1). Sum is now the only function available by default for counts. If you wish to revert to the previous behaviour, you can modify the statistics.xml file.


It is now possible to display both weighted and unweighted values in the same table when using SuperSERVER weightings in SuperCROSS.

In previous versions, changing between a weighted and unweighted option in the Weight By drop-down list in the Define Recode window would change all of the functions in the Recode Values list to be either weighted or unweighted. Now, you can add a combination of weighted and unweighted functions to the Recode Values list.

SuperSERVERPerturbation (Quantiles)

Quantile perturbation requires three configuration files. In previous releases these had to be located in the same directory as the SXV4 file.

New properties have been added to the data control modules so that it is now possible to configure the location of these files.

SuperSERVERRelative Standard Error

Prior to version 9.7, it was necessary to configure a data control plugin to calculate RSE values. From 9.7 onwards this now runs automatically for all SuperSERVER weighted databases, and will use the jackknife formula for calculating the RSE. You can still configure the plugin if you wish to change some of its other settings, such as the formula, thresholds and unreliable table message, although if you just want to change the formula used then you can do this by editing a setting in the weightings file (if both are configured then the plugin settings take precedence).

As a result of this change, RSE values are now available for SuperSERVER weighted databases in SuperCROSS when confidentiality has been turned off using the padlock button.


New configuration options have been added to enable consistent weighting configuration across SuperCROSS and SuperWEB2.

Version 9.8

ProductAreaDescriptionMore Information
SuperCROSSExcel Downloads

Since version 9.0 SuperCROSS has been using a particular formatting function from a third-party library when generating Excel files. This function adjusts the row height in the downloaded Excel file to fit the text in the row. This function has been found to cause performance issues when downloading very large tables.

SuperCROSS now runs the function only once per row when downloading very large tables, so in some cases it may be necessary to manually adjust the row height in the downloaded Excel file in order to see the full heading text.

A new setting has been added to the super.ini configuration file: AutoFitCellLimit=90

This setting controls the threshold for the new behaviour. Its value is the table cell count in millions.

For example, when this is set to 90:

  • Any table under 90 million cells will use the auto formatting option on every header cell.
  • Any table above this size will not have any custom row heights applied. You may need to manually adjust the row heights in the downloaded Excel file.
SuperWEB2DerivationsSuperWEB2 now allows users to create derivations within tables.
SuperWEB2Excel Downloads

It is now possible to control the formatting of annotations in Excel downloads. This is particularly useful if you have long annotations as you can now control how the text wraps beneath the table.

In addition, the default Excel download templates have been updated to match the current default SuperWEB2 branding.


A new setting (schemaTree.schemaFolderExpansionDepth) has been added that allows you to choose how many levels of folders to expand in the list of fields when opening a dataset.

In previous releases, the list of fields was always fully collapsed when opening the dataset (so only the names of the top level folders would be visible initially). Now you can choose how many levels to expand.

By default, all folders will now be expanded when you open a dataset.

SuperWEB2Graph View

The configuration setting for specifying the PDF template for downloads from Graph View has changed. Previously this used a single setting (externalLink.pdfTemplateURL) that specified the full path to the template PDF file.

This setting has been replaced by two individual settings in the filegraph.graphPdfTemplateLocation and graph.graphPdfTemplateName.

SuperWEB2Graph ViewIt is now possible to configure the abbreviations used to shorten large numbers in the axes in Graph View.
SuperWEB2Info Pages

The location of the HTML info pages (which are displayed on the right of the database catalogue screen) has changed.

Previously these pages were located in <tomcat_home>\webapps\webapi\WEB-INF\resources\info\

Now, they are located in <tomcat_home>\webapps\webapi\info\

SuperWEB2MetadataThe files supplied for configuring metadata have been renamed from not-configured.jsp and sa-metadata.jsp to not-configured.xhtml and sa-metadata.xhtml. In addition, the default path to these files has changed from /webapi/help/ to /webapi/jsf/help/. You will need to update the settings in your file to match the new location.
SuperWEB2TourA new interactive tour has been added to guide new users through the basic operations of SuperWEB2. 
SuperWEB2User Interface

A number of usability changes have been made to the SuperWEB2 user interface:

  • Some on screen elements have moved or been renamed.
  • New icons have been added to help users distinguish between datasets, tables, folders and fields.
  • By default, the logo in the top-left of SuperWEB2 is now displayed within the navigation bar, rather than above it. This change is fully backwards compatible, so you can choose to continue to display the logo above the navigation bar if you prefer. Your existing branding customisations can continue to be used with this version of SuperWEB2.
  • No labels