Skip to end of metadata
Go to start of metadata

SuperWEB2 is supplied with built-in online help that users can access from the button on the top-right:

The default help is supplied as a set of static HTML pages. If you want to customise or brand the online help, you can either:

  • Customise the existing HTML help pages, for example by adding your own logo or changing some of the text. You can do this simply by editing the relevant HTML pages in <tomcat_home>\webapps\webapi\online-help\
  • Replace the help with your own help pages, in which case you need to edit some settings in the configuration.properties file.

Replace the Help with your Own Version

The location of the help is controlled by the following settings in the <tomcat_home>\webapps\webapi\WEB-INF\classes\configuration.properties file:

#================================================================================================================
# ONLINE HELP
#================================================================================================================
# String. Default null.
# URL path to the online help homepage
externalLink.helpUserGuideURL=/webapi/online-help/index.html
# String. Default null.
# URL path to the online help page for Map View
externalLink.helpIconURL=/webapi/online-help/Map-View---SuperWEB2.html
# String. Default null.
# URL path to the online help page for Table View
externalLink.helpCatalogueURL=/webapi/online-help/Getting-Started---SuperWEB2.html
# String. Default null.
# URL path to the online help page for Table View
externalLink.helpCustomiseTableURL=/webapi/online-help/Getting-Started---SuperWEB2.html
# String. Default null.
# URL path to the online help page for Table View
externalLink.helpGraphViewURL=/webapi/online-help/Graph-View---SuperWEB2.html
# String. Default null.
# URL path to the online help page for Map View
externalLink.helpMapViewURL=/webapi/online-help/Map-View---SuperWEB2.html
# String. Default null.
# URL path to the online help page for My Custom Data
externalLink.helpMyCustomDataURL=/webapi/online-help/My-Custom-Data---SuperWEB2.html
# String. Default null.
# URL path to the online help page for Table View
externalLink.helpMyTablesURL=/webapi/online-help/Save-and-Reload-Tables---SuperWEB2.html

To replace the help with your own version, replace them with the appropriate links to your own version of the help. If the help is located on the same server, provide the full absolute path to the help file; if it is located on another server, provide a fully qualified URL. For example:

Alternative help located on the same server as SuperWEB2:

externalLink.helpUserGuideURL=/webapi/customhelp/index.htm

Alternative help located on a different server:

externalLink.helpUserGuideURL=http://www.myserver.com/help/userguide.html

The help link is context-sensitive. The following table explains where each of the links appears in SuperWEB2:

LinkAppears On
helpUserGuideURL
The login page. This should be a link to the home page for your documentation.
helpIconURL
This setting is no longer used.
helpCatalogueURL
The dataset catalogue page.
helpCustomiseTableURL
The Table View tab.
helpGraphViewURL
The Graph View tab.
helpMapViewURL
The Map View tab.
helpMyCustomDataURL
The Custom Data tab.
helpMyTablesURL
The Saved Tables tab.

Issues Displaying Online Help in Internet Explorer

There is a known issue with Internet Explorer that prevents the online help from opening properly on some versions of IE. In these cases a new window or tab opens, but it is blank and does not show the help page.

If you encounter this issue, please follow the steps in this Microsoft knowledgebase article: https://support.microsoft.com/en-us/kb/2574731

When executing the commands, make sure you use a command prompt that has administrator privileges.

  • No labels