Version: 4.3.0 +

Applicable to: Futurama Website


In case Futurama is running in Website mode it is possible to configure settings for debugging. These settings are set in the debug-section of the configuration file.



Within the element the next code has to be included:


Next to this code, also within the element the next code has to be included:


The futuramaSettings element is the general part for more configuration settings. Within this element the debug element is set.


Within the debug element some attributes can be set. Below the possible values of these attributes.


[Obsolete] This property is superseded by the new showNotifier property and only functional until Futurama version 17.01


Indicates whether the Futurama module Futurama Insight is activated or not. Notes:

  • this attribute is only used in Website mode
  • default value is 'false'
  • this attribute is optional. If this tag is not included the default value is used
  • a license is required for using Futurama Insight. This license is part of the general license file
showNotifier (Futurama 17.01+)

This property allows an errorstatus notification-icon to be shown in the topright of a Futurama Web application. This notifier will show how many warnings or errors have been encountered while processing the last webserver request by floating the cursor over the notifier icon, and reading the tooltip that will present itself.

When the notifier itself is clicked, a list of logfiles will be shown that are generated during the applications runtime. When one of these logfiles is clicked, a new window will show the Logviewer that shows the contents of this logfile. This is especially useful when debugging any errors that might have occurred. Please refer to the following document to learn more about Analysing logfiles with LogViewer.

The possible values for the showNotifier property are as follows:

  • Never: (default) The notifier is never shown or rendered.
  • OnError: The notifier will only be visible when an error has occurred.
  • OnWarningOrError: The notifier will only be visible when an error or warning has occurred.
  • Always: The notifier will always be visible.

The notifier might not work properly for older versions of Microsoft Internet Explorer (7.0 and earlier).

abortOnDocumentLoadError (Futurama 19.05+)

This optional property can be set to ‘true’ or ‘false’ (default value). When set to ‘true’ it will cause the document loader to abort operation whenever an error occurs when opening or converting the document. This is mostly useful for testing purposes, and should be omitted when it’s not needed.


These configuration settings are available from Futurama version 4.3.0. In previous versions you can find the debug settings in the generic appSettings section of the configuration file. If the new debug-section is not included in the configuration file of Futurama version 4.3.0 or higher, Futurama will switch to its compatibility mode. This means that the 'old' appSettings will be loaded. It is recommended to convert these old settings to the new configuration. Below the mapping between the old and the new configuration.

Futurama Website

New configuration:


{Warnings} is value of:

{Insight} is value of:

Related Topics

- Cache: Settings regarding the caching of Futurama documents

- Format: Format settings of Futurama

- Identity provider: Settings how to use an external identity provider for determining the access to a website

- Log: Settings for displaying errors, warnings, information messages and developers messages

- Mail: Definition of the mailserver that is used to send e-mails with Futurama Vision

- Mapping: Settings for default locations of Futurama files

- Monitor: Settings for getting session information

- Rendering: Settings to allow Futurama to generate customized HTML

- Security: Additional possible security settings when using Futurama Website

- Server: Settings when using Futurama Export either in server or in batch mode

- Vision: Configuration of the connection between Futurama and Futurama Vision


If you have any questions about this subject or if you want to provide us feedback please send us an e-mail.

Updated: 2016-08-31