We’ve developed some resources to help you work effectively from home during COVID-19 Click to learn more

The web.config file

In this article

    The web.config file for 6.web is an XML file that can be changed as needed. Administrators can use configuration files to set policies that affect how applications run on their computers. Read more on MSDN.

    There are some SuperOffice-specific sections. Sections defined under the SuperOffice sectionGroup include:

    1. Security
    2. Mail
    3. Factory
    4. Diagnostics
    5. Data 
    6. Documents
    7. Globalization
    8. Services
    9. Scripting
    10. BatchService

    There are some client-specific options, section defined under the Client sectionGroup

    1. HelpFiles

    Security

    Warning: Do not change these values unless absolutely sure

    Authentication TrustedDomains(String) Check if a domain name is trusted.  Note -  separate section within the SuperOffice Security group section, it needs to be declared before it can be defined. See Integrated login
    Cryptography Cryptographic options, see table below. Note: change any of these keys at your own peril
    Sentry
    Ignore the Sentry mechanism, everything will be allowed (default 'False')
    Relates to the Sentry system in SuperOffice. The sentry system can be thought of as the traffic cop, controlling access to the data in the database. Each object in Netserver has an associated sentry which is responsible for enforcing rules such as "private appointments are visible only to its owner". Sentry rules focus on ownership, group membership and user-level access. 

    The Cryptography section is used for encrypting and decrypting user credentials.

    SymmetricKey Base64 encoded key-string as documented by System.Security.Cryptography.RijndaelManaged.
    SymmetricIV Base64 encoded vector-string as documented by System.Security.Cryptography.RijndaelManaged.
    SymmetricSecret String value representing the user-defined secret, used when creating a hash (signature) to verify that the encrypted-decrypted value has not been tampered with.

    Mail

    Configuration of mail parameters

    Reader
    The Key used for mail reader - default EasyMail
    Sender
    The Key used for mail sender - default EasyMail

    Factory

    The Factory is part of a NetServer extension mechanism to support plug-ins. To utilize the methods you must develop your own method and configure it in a specific way in the configuration file to identify that you are enhancing a provided method. 

    Diagnostics

    Settings related to logging.

    CheckBrowserVersion Boolean value. Check working browsers with SuperOffice Research and Product Development (Online through a WebService). Default = True. If you experience poor performance during login, set this to False.
    EnableScaffolding Boolean value determines whether to log verbose, detailed, information.
    EnableStackTracing
    Should stack traces be collected by various events
    LogError Boolean value determines whether to log all error messages. Default = True
    LogFailureAudit Boolean value determines whether to log when an access failure occurs / failed authentications (default 'True')
    LogFolder
    Folder (e.g. UNC path) where the logfile is to reside. Note that the owner of the process needs to have access to manipulate files in this folder
    LoggedServices List of services to be logged; default blank means all, otherwise comma-separated list of service names (without the Agent suffix, for instance: BLOB, Appointment)
    LogInformation
    Log general information. This includes successful SQL's passed to the database. Only permit this option while debugging a bug. This will be a severe performance hit! (default 'False')
    LogLongQueries Should long-running queries be logged in textual form to a special file? default false
    LogLongQueriesAsXML
    Should long-running queries be logged to a special file (Query_year.month.day.log) in XML serialized format, for later analysis and reruns using the QueryWorkbench tool
    LogMail Log mail server communication
    LogMailFolder Folder to output mail logs. Note that the owner of the process needs to have access to manipulate files in this folder
    LogServiceCalls Should calls to the service layer be logged
    LogSuccessAudit Boolean value determines whether to log when access is granted / successful authentications (default 'False')
    LogTimes Log time it takes
    LogToEventLog Boolean value determines whether to write message to OS Event Log. (Information Level Ignored)
    LogToFile Boolean value determines whether to log all Log-Levels to a file. (default 'False')
    LogToSuperOffice Boolean value. Log to SuperOffice Research and Product Development (Online through a WebService). If you experience poor performance during login, set this to False.
    LogToTrace Boolean value determines whether to log all Log-Levels to trace output. Log to a Trace that can be listened to by TraceListener. (default 'False')
    LogWarning
    Log warnings (default 'False')
    LongQueryTreshold
    Threshold for logging a long-running query, in milliseconds. Queries that execute in less than this time are not logged as long-running. The time is from the moment the SQL text is sent to the database, until the first row (for a select) or the 'nn rows affected' return value is received.
    SuperOfficeErrorServiceUrl
    The URL used when logging to SuperOffice Research and Product Development (Online through a WebService)

    Data

    The Data section group contains three sections, Database, Explicit and ImplicitAnonymous. Combined, these sections define which server and database the caller will connect, as well as what state settings to use. Which state settings take affect are determined by how the caller decides to connect, Explicit or ImplicitAnonymous.

    The Session section relates to the lifetime of a Netserver communication session, such as the duration of a transaction, or group of transactions, and maintains the credentials defined in one of the following sections.

    Mode String value representing the mode of the session object. Permitted values: Thread, Process and Context

    -Thread: Session is stored in a thread static manner.  Each executing thread has a separate instance of session.  If the session is accessed on a different thread, it will contain a different value.  For further reference, see System.ThreadStaticAttribute.

    - Process: Session is stored in a process static manner.  This is the normal option for windows applications.

    - HttpContext: Recommended in ASP.NET applications. Added to prevent ASP.NET thread switches from changing identities in the middle of an ASP.net request.

    - Context: Session is stored in a context static manner. For further reference, see System.ContextStaticAttribute.

    The Database section relates to location and database-vendor specific settings. Supported database servers include SQL Server, Oracle, Sybase, and DB2. 

    CommandTimeout Integer value representing the command timeout in seconds.
    ConnectionString String value representing the connection string .
    DatabaseMajor String value representing the database. MSSQL, Oracle, Sybase or DB2
    DatabaseMinor Integer value representing the version number of Database
    DatabaseName String value representing the name of the database. Also used for distinct service name.
    Server String value representing the computer or server name where the database resides.
    TablePrefix String value representing the prefix of the SuperOffice CRM tables in the database.  Default is “CRM5”.

    IBM DB2 and Sybase Specific Settings

    DynamicLoadedDataBaseDriver String representing the location of the driver file.
    DynamicLoadedDataBaseDriverPolicy String representing the location of the policy file.
    DynamicLoadedConnectionType String representing the connection type.

    The Explicit section relates to employee and partner access to the SuperOffice database.

     

    CommonDBConnection Boolean value determining what authentication mechanism to use when authenticating a user.
    If this value is “True”, DBUser and DBPassword are used in the database connection.  Otherwise, the credentials provided in the authentication (e.g. SoSession class) will be used.  “True” is default for server (e.g. like web) applications and “False” is default for client (e.g. like Windows forms) applications.
    DBPassword String value representing the DBUser database password.
    DBUser String value representing a database username with access privileges.
    EmployeeAllowed Boolean value determining whether an employee is permitted access.
    ExternalPersonAllowed Boolean value determining whether an external person is permitted access.
    SystemAllowed Boolean value determining whether a system user is permitted access.

    The ImplicitAnonymous section relates to anonymous access to the SuperOffice database. Implicit Anonymous is what you get when you do not explicitly authenticate as a user. Usually disabled in SIX.web, which uses explicit users.

    Allowed Boolean value determining whether anonymous access is permitted.
    DBPassword String value representing the database password used to connect to the database.
    DBUser String value representing the database user (not the CRM5 user) used to connect to the database.
    SoPassword String value representing the SuperOffice CRM5 user password
    SoUser String value representing the SuperOffice CRM5 username of the Anonymous user

    Documents

    The Documents section exposes seven settings related to SuperOffice documents. It is used as a way for NetServer to know where the document archive is, what temporary directory to use, as well as exposes a way to allow NetServer to impersonate a user with read and write access to those directories if that is required. See Table Four for complete setting property definitions.

    ArchiveDomain String value representing the ArchiveUsers domain name.
    ArchivePassword String value representing the password of the ImpersonateUser.
    ArchivePath String value representing the path to the SO_ARC directory. The default template path is calculated from this folder if not set.
    ArchiveUser String value representing the ArchiveUsers domain name.
    ArchiveDomain String value representing the domain of the user to impersonate with
    BufferSize Integer value representing the internal buffer size in KB. Default buffer size is 32KB.
    ImpersonateUser True if impersonate is turned on. If So_arc is located on a different server in the domain you need to turn
    TemplatePath String value representing the UNC path of template folder. (Optional) - if not set defaults to archivepath + \Template
    TemporaryPath
    Temporary folder for working with documents. String value representing the temp directory for streaming files (must resolve to the same location for farms/clusters).

    Globalization

    The Globalization section exposes two settings related to user origin values. This section allows an applications country code and whether to use the country code for all employees and external people. See Table Five for complete setting property definitions.

    ApplicationCountry String value representing the country id for associates that are not persons (e.g. anonymous and system users).  Default is GBR (England).
    ApplicationCountryCode String value representing the country for associates that are persons (e.g. employees and external users). Default is GBR (England).
    UseApplicationCountryForPersons Boolean value determines whether to use the applications country for all persons (e.g. employees and external users).

    Services

    This section is used to specify whether an application is working locally or remotely. 

    DefaultMode String value representing the default operational mode, Local, Remote, or Switch.
    RemoteBaseURL String value representing the base url and filename of the NetServer web services application file, SuperOffice.Services.Stub.
    SwitchDefault String value representing the default mode for the switch. Can be Local or Remote. Default = Remote
    SwitchFailover Integer value representing the timeout before failover in seconds. Default = 60

    Scripting

    EnableScripting Turn on or off the use of scripts
    ScriptPath Path to the scripts. Defaults to \script if not set.
    TimeoutLimit Time in milliseconds allowed for the script to use. Default 20 sec.
    MaxTimeouts Integer value representing the number of timeouts the script are allowed before it is disabled. Default 5. Default = 5

    BatchService

    ServiceName Default = SuperOffice Batch Service
    MaxTasks Default = 16
    CPUTreshold Default = 100
    PollingInterval Default = 2
    DiagnosticsWebUri Default = http://localhost:8002
    RunTasksInProcess New from 6.3 SR1: Boolean value to start by IIS in the same process.
    Defaults to false.
    ImpersonateReporterPlugin Default = False

    HelpFiles

    baseurl

    New from 6.3 SR1:
    String value representing the URL to helpfiles. E.g. in large serverfarm environments you may point to one helpfile location.

    Default = ""

    See Also