Search

 

User: System administrator, Developer

Prerequisites

- knowledge of ASP.NET

- intermediate knowledge/experience of Futurama

Introduction

In the several installation directories of Futurama, a configuration file can be placed. Using this file the behavior of ASP.Net can be regulated. Depending on the kind of installation a number of sections with settings can be configured. This page offers an overview.

 

 

Description

In the install directory of Futurama Website, Futurama Webservice, Futurama Export and Futurama Editor a configuration file can be placed. In these configuration files it is possible to regulate the behavior of ASP.Net. For example setting the authentication mode. Apart from these industry wide settings also a number of specific Futurama settings can be made in the configuration files. This can be done by adding a number of sections to the config file. Within these sections a number of settings can be defined that influence the behavior of Futurama.  These custom made settings can be read and used by the Futurama application. In this chapter these settings are described. More detailed information for each of the settings can be found in the subchapters.

Scope

The settings are applicable for Futurama version 4.3 and higher. In Futurama 4.2 and before another system of configuration was used. If a new Futurama version is used and these old settings are still in the configuration file, Futurama will automatically convert these old settings to the new structure. The conversion of these settings is described in the compatability paragraph. Futurama will also log information how old settings are converted to the new structure.

General structure

Within the element either a or a has to be included. Which section name is applicable depends on the configuration that is used. In the installation pages of the Futurama modules is explained which section name has to be used. Within this sectionGroup the different sections can be defined. Below an example of this configuration:


	

Next to this code, within the element a or a element has to be included (the element name is the same name as the sectionGroup name mentioned above. Within this or a element for each of the sesctions that are defined within the sectionGroup the specific settings can be chosen.

Sections

Mentioned below the different sections that can be included in the configuration file. Not all of these settings are applicable for each Futurama installation. In the installation chapters of the Futurama modules is described which sections cabn be used to determine the behavior of Futurama for the specific installation. The following sections are available:

- Cache: Contains settings that define whether and how Futurama stores sessions and results in memory

- Calculation: Contains settings that can be used to speed up calculations by using compiled code

- Debug: Contains settings that are relevant for the developer/tester of a Futurama application, such as the use of Futurama Insight

- Format: Contains settings that define how Futurama presents results such as amounts and dates

- IdentityProvider: Contains settings that define an external identity provider which is used to determine the access to a webpage

- Log: Contains settings that define whether and how Futurama logs errors, warningss and other messages

- Mail: Contains settings, such as the SMTPServer, that are used by Vision when sending automatic e-mails

- Mapping: Contains settings that define the location of (standard-)documents for Futurama applications

- Monitor: Contains settings that define the logging of actions that are performed during sessions by the user of the application

- Rendering: The render section allows the configuration of an XSLT file that allows Futurama to generate customized HTML from an intermediate language called FICO

- Security: Contains settings for additional security settings in Futurama

- Server: Contains settings for Futurama Server/Batch mode

- Vision: Contains settings that define the connection with Futurama Vision

- WebAPI: Settings to use Futurama Web API

Compatibility

The old settings that could be used to determine the behavior of Futurama (settings present in Futurama 4.2 and before) are automatically converted to one of the new sections. In the overview below it can be found to which section every setting has been moved. and to which name within this section.

appSetting Section Name
WebServiceUseCache Cache enabled
NumberOfDocsToCache Cache numberOfDocuments
SecondsBetweenLoad Cache secondsBetweenLoad
WebServiceCacheExpirationInMinutes Cache expirationInMinutes
ActuIT_WarnForErrors Debug showWarnings
EnableInsight Debug insight
RegionalSettingsCulture Format culture
XML_UseLowerCaseForBoolean Format lowerCaseXmlBooleans
ActuIT_FormulaLanguage Format editorLanguage
MinimumErrorToLog Log not applicable
ActuIT_FuturamaServer_LoggingMode Log not applicable
ActuIT_FuturamaServer_LoggingDirectory Log not applicable
DefaultXmlFile Mapping document
DefaultFolder Mapping folder
DirectoryPrefix Mapping parentFolder
BaseDir Mapping rootPath
ActuIT_FuturamaBatch_BaseDir Mapping rootPath
LoggingMode Monitor mode
EnableLogging Monitor enable
LoggingConnectString Monitor connectionString
ActuIT_SessionTimeOut Monitor sessionTimeOut
LogStartOnly Monitor logStartOnly
ServerNetTcpPort Server port
FuturamaLocation Server defaultFuturamaPath
ActuIT_Futurama_Server_StartDelay Server startDelay
ServerPort n.a. is no longer used
UseExternalSecurity n.a. is no longer used
ServerHttpMexPort n.a. is no longer used

Related Topics

- Cache: Contains settings that define whether and how Futurama stores sessions and results in memory

- Calculation: Contains settings that can be used to speed up calculations by using compiled code

- Debug: Contains settings that are relevant for the developer/tester of a Futurama application, such as the use of Futurama Insight

- Format: Contains settings that define how Futurama presents results such as amounts and dates

- IdentityProvider: Contains settings that define an external identity provider which is used to determine the access to a webpage

- Log: Contains settings that define whether and how Futurama logs errors, warningss and other messages

- Mail: Contains settings, such as the SMTPServer, that are used by Vision when sending automatic e-mails

- Mapping: Contains settings that define the location of (standard-)documents for Futurama applications

- Monitor: Contains settings that define the logging of actions that are performed during sessions by the user of the application

- Rendering: The render section allows the configuration of an XSLT file that allows Futurama to generate customized HTML from an intermediate language called FICO

- Security: Contains settings for additional security settings in Futurama

- Server: Contains settings for Futurama Server/Batch mode

- Vision: Contains settings that define the connection with Futurama Vision

- WebAPI: Settings to use Futurama Web API

Feedback

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

Updated: 2016-09-12