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:

Parameters

  • SessionUserAgentFilter

  • SessionIPFilter

Example


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>


Description

These settings are commented out by default.

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

More Information

Enable Protection Against Session Hijaking


Parameters

  • AGENCY_ID

  • AGENCY_NAME

  • USER_GENERATED_STRUCTURE_AGENCY_ID

  • RSE_CONCEPT_ID

  • RSE_CONCEPT_NAME

  • RSE_CONCEPT_DESCRIPTION

Example


XML
<param-name>AGENCY_ID</param-name>
<param-value>AGENCY_ID</param-value>
...


Description

These settings configure various parameters that will be used when exporting table data to SDMX format.

More Information

Branding SDMX Downloads


Parameter

facelets.DEVELOPMENT

Example


XML
<param-name>facelets.DEVELOPMENT</param-name>
<param-value>true</param-value>


Description

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

You must set this to false before going into production.


Parameter

logoutRedirectionURL

Example




XML
<param-name>logoutRedirectionURL</param-name>
<param-value>login.xhtml</param-value>




Description

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.

More Information

Use Direct URLs to Open a Specific Dataset or Table


Parameter

publicBaseResourceUrl

Example



XML
<param-name>publicBaseResourceUrl</param-name>
<param-value>http://localhost:8080/webapi</param-value>



Description

The public URL used to access this SuperWEB2 web application. This is used to inform SuperADMIN how to connect to the application's web services.

More Information

Configure Folders and Shared Tables


Parameter

administratorGroup

Example


XML
<param-name>administratorGroup</param-name>
<param-value>administrators</param-value>



Description

Denotes which SuperADMIN group contains administrator users.


Parameter

BulkSelectionThreshold

Example


XML
<param-name>BulkSelectionThreshold</param-name>
<param-value>1000</param-value>


Description

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.

More Information

Configure the Bulk Selection Threshold


Parameter

session-timeout

Example


XML
<session-config>
  <session-timeout>20</session-timeout>
</session-config>


Description

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.