Skip to main content
Skip table of contents

web.xml

Location<tomcat_home>\webapps\webapi\WEB-INF\web.xml

The following are some of the parameters in this configuration file that you can change:

ParameterExampleDescriptionMore Information
  • SessionUserAgentFilter
  • SessionIPFilter
XML
<filter-mapping>
  <filter-name>SessionUserAgentFilter</filter-name>
  <url-pattern>*</url-pattern>
</filter-mapping> 
XML
<filter-mapping>
  <filter-name>SessionIPFilter</filter-name>
  <url-pattern>*</url-pattern>
</filter-mapping>

These settings are commented out by default.

You can enable these settings to activate some protection against session hijacking in SuperWEB2.

Enable Protection Against Session Hijaking - SuperWEB2
recordview
XML
<param-name>recordview</param-name>
<param-value>false</param-value>
Enables or disables the Record View feature.Enable or Disable Record View - SuperWEB2
  • AGENCY_ID
  • AGENCY_NAME
  • USER_GENERATED_STRUCTURE_AGENCY_ID
  • RSE_CONCEPT_ID
  • RSE_CONCEPT_NAME
  • RSE_CONCEPT_DESCRIPTION
XML
<param-name>AGENCY_ID</param-name>
<param-value>AGENCY_ID</param-value>
...
These settings configure various parameters that will be used when exporting table data to SDMX format.Branding SDMX Downloads - SuperWEB2
facelets.DEVELOPMENT
XML
<param-name>facelets.DEVELOPMENT</param-name>
<param-value>true</param-value>

This parameter is used during development to produce log and code checks.

You must set this to false before going into production.

 
logoutRedirectionURL
XML
<param-name>logoutRedirectionURL</param-name>
<param-value>login.xhtml</param-value>
Configures the URL that users are redirected to on logout or when their login times out. This can be used in conjunction with the SuperWEB2 direct URLs to create a custom external login form.Use Direct URLs to Open a Specific Dataset or Table - SuperWEB2
  • GuestUsername
  • GuestPassword
XML
<param-name>GuestUsername</param-name>
<param-value>guest</param-value>
...
These settings define the username and password used for guest user access to SuperWEB2.Configure Guest Access - SuperWEB2
administratorGroup
XML
<param-name>administratorGroup</param-name>
<param-value>administrators</param-value> 
Denotes which SuperADMIN group contains administrator users. 
TXDEncodingType
XML
<param-name>TXDEncodingType</param-name>
<param-value>windows-1252</param-value> 

The codepage to use when loading saved system tables (TXD files that have been saved to <tomcat_home>\webapps\webapi\WEB-INF\resources\txd).

This setting only applies when loading TXDs that were created with versions of SuperCROSS prior to 9.0:

  • Any TXDs created with SuperCROSS 9.0 will be Unicode and therefore work correctly regardless of what codepage setting you configure here.
  • For TXDs created with earlier releases, these will only work if they either contain only English/ASCII characters, or they only contain characters supported by the codepage configured here.
Add Datasets and Tables - SuperWEB2
suppressSum
XML
<param-name>suppressSum</param-name>
<param-value>false</param-value>
Can be used to prevent users adding the Sum measure to a table.Suppress Ability to Add Sum to a Table - SuperWEB2
BulkSelectionThreshold
XML
<param-name>BulkSelectionThreshold</param-name>
<param-value>1000</param-value> 

The threshold for activating the bulk selection feature.

When a field has more than the specified number of child items, the SuperWEB2 selection tree will display the Bulk Selection button instead of the actual field items.

If you want to disable the bulk selection feature, set BulkSelectionThreshold to a negative value.

Configure the Bulk Selection Threshold - SuperWEB2
session-timeout
XML
<session-config>
  <session-timeout>20</session-timeout>
</session-config>

The session timeout for SuperWEB2 users, in minutes.

This setting does not appear in web.xml by default, but you can add it if you want to control how quickly a SuperWEB2 user's session will expire if they leave their browser window open without interacting with SuperWEB2.

Adding this setting to SuperWEB2's web.xml file will override the default timeout setting (typically 30 minutes) that is configured for all Tomcat applications in the main Tomcat web.xml file (<tomcat_home>\conf\web.xml).

You will need to restart SuperWEB2 or the Tomcat service before any change to this setting will take effect.

 
JavaScript errors detected

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

If this problem persists, please contact our support.