alfaSettings.json configuration

The example alfaSettings.json configuration file includes the following settings as well as a number of deactivated lines which are not for standard use.

Configuration relevant fields are in AlfabetPresentationSessionServiceConfig and AlfabetRuntimeConfig.

AlfabetPresentationSessionServiceConfig fields:

Field Required Setting
AlfabetPresentationSessionServiceConfig settings
msfile

Enter the absolute or relative path to the alfabetms.xml configuration file containing the server alias for the Alfabet Web Application. All backslashes in the path must be escaped with a backslash:

  • "msfile":"C:\\Installationdirectory\\Programs\\alfabetms.xml",
easyin

If you define a user name in this field, the login screen of the Alfabet user interface will be prefilled with this user name. This field must be left empty for production environments. Only use this field for test or configuration instances.

alias Enter the name of the server alias for the Alfabet Web Application.
sessionTimeout Without user activity, an Alfabet session will time out after 20 minutes. You can alter the timeout value with this field in the format hh:mm. The timeout should not exceed 1 hour.
AlfabetRuntimeConfig settings
Debug Set the Debug field to false unless issues are encountered and debugging is required. If the Debug field is set to true and the field UseNLog is set to true , log files will be written in the runtime directory of the Alfabet Web Application and error messages displayed in browsers will reveal web server details.
ApplicationRuntimeMode Set ApplicationRuntimeMode to Standard for production environments. Additional options:
ApplicationRuntimeID Include the ApplicationRuntimeID in the configuration and set it to an arbitrary non-empty alphanumeric value to disable reloading of content files (js, css, icons) on every application restart.
EnableVersionHeader Set the EnableVersionHeader field to true if you want the operating system version to be included in the full version information about Alfabet and to be displayed in the About Alfabet dialog.
SolutionAssembliesSearchStrategy Set the SolutionAssembliesSearchStrategy to Production . This setting influences the loading of .dll files. Settings other then Production are only relevant for Alfabet BD GmbH internal development tasks.
CacheDurationInSeconds Set the maximum number of seconds that content may remain in the browser cache. After the cache duration expires, the browser will have to re-load the content from the Web server instead of re-using it from the cache.
ExperimentalFeatures If you encounter problems with the execution of right rules, you can re-set the default batch calculation of right rules either completely to a one by one calculation, or exclude right rules with WITH statements from batch calculation only. The specification is done in the following syntax:
  • "ExperimentalFeatures":{
    • "LocalRightsRulesBatchExecution":"mode"
    • }

You can set the following modes:

  • full: The default setting for batch calculation of right rules. This setting results in the best performance.
  • simple: Right rules with WITH statements are excluded from batch calculation and are calculated separately.
  • disabled: Right rules are calculated one by one. This setting results performance loss for right rules calculation and shall only be used if problems are encountered. It is recommended to report the issues with right rules calculation to Alfabet Support .
ShowBacktoAppLinkonLogout Set this attribute to false to hide the link to the login page from the logout page of the Alfabet user interface which is displayed after logout of the user and after a session expired. The default value is true.
AppInsights settings An example providing information about information that may be added to apply Azure® AppInsights ® analysis on Alfabet use. This section is commented out because it is not used in the standard implementation.