Search

 

Version: 4.3.0 +

Applicable to: Futurama Website

 

Description

In case Futurama is running in Website mode it is possible to save session information. The saved session information can be used for different purposes:

  • permanent saving in a database (sql or oracle), so the web sessions can be reproduced and/or analysed.
  • capturing (temporarily or not) session information. In case of expiration of a session (when the timeout period set in ISS/.Net is exceeded), the expired session can be reproduced. This can be obtained by saving the information in either a database or in memory.

Settings regarding the monitoring of session are set in the monitor-section of the configuration file.

Configuration

Settings

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 monitor element is set.

Explanation

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

enabled

Indicates whether the saving of session-information is enabled or disabled. Notes:

  • this attribute is required
  • possible values are 'True' and 'False' 
mode

Indicates where the session-information will be saved. Notes:

  • possible values are Sql, Oracle and Memory
  • for saving information in a Sql or Oracle database, the correct database (tables, stored procedures) has to be installed. See the installation description of the Futurama module 'Futurama Monitoring' for more details 
  • it is optional to write erros in the Sql or Oracle database. This has to be configured in the log-section.
connectionString

Indicates the location of the Sql or Oracle database where the session-information will be saved. Notes:

  • this attribute applies only in the case the attribute 'mode' is set to 'Sql' or 'Oracle'.
  • this attribute requires a correct installed database and correct assigned rights.
  • in the connection string both the server name and the database name and the userid and the password has to be mentioned. For example for SQL Server Server=servername;Database=name_logging_database;UID=logginguser;Password=password;
sessionTimeOut

Indicates the number of minutes that the session-information will be saved in memory. Notes:

  • this attribute applies only in the case the attribute 'mode' is set to 'Memory'
logStartOnly

Indicates whether only the start of a new session should be saved or all actions during a session. Notes:

  • possible values are 'True' (only the start of a new session) and 'False' (all the actions during a session) 

Compatibility

These configuration settings are available from Futurama version 4.3.0. In previous versions you can find the monitor settings in the generic appSettings section of the configuration file. If the new monitor-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:

where:

{Enabled} is true if:

{Mode} is respectively Sql, Oracle or Memory when the value of

equals to 'SqlServer', 'Oracle' or 'Memory'.

{Connectionstring} is value of:

{Timeout} is value of:

{Logstart} is value of:

Related Topics

- Cache: Settings regarding the caching of Futurama documents

- Debug: Settings to debug while developing with Futurama

- 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

- 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

Feedback

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

Updated: 2013-05-24