Jump to: navigation, search

Difference between revisions of "Configuration File Example"


(loggingConfiguration)
(Redirected page to Configuration Files)
 
(3 intermediate revisions by the same user not shown)
Line 1: Line 1:
All the configuration files (UBIK.Studio.exe.config, UBIK.EnterpriseService.exe.config, web.config) have to comply with syntax and other guidelines as given in [https://msdn.microsoft.com/en-us/library/1xtk877y%28v=vs.110%29.aspx Configuring Apps by using Configuration Files].
+
#REDIRECT [[Configuration_Files]]
 
+
For the configuration file ''web.config'' of the [[Web Service]] see the [http://msdn.microsoft.com/en-us/library/ms733830%28v=vs.110%29.aspx Configuring Services] for further information.
+
 
+
= General =
+
These sections will be found in all of the configuration files.
+
 
+
===configSection===
+
In the configSection tag service specific configurations can be defined. These settings include logging and exception handling in the {{UBIK}} web service. This tag should not be changed in general.
+
<syntaxhighlight lang="xml">
+
  <configSections>
+
    <section name="loggingConfiguration" type="Microsoft.Practices.EnterpriseLibrary.Logging.Configuration.LoggingSettings, Microsoft.Practices.EnterpriseLibrary.Logging, Version=5.0.414.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35" requirePermission="true" />
+
    <section name="exceptionHandling" type="Microsoft.Practices.EnterpriseLibrary.ExceptionHandling.Configuration.ExceptionHandlingSettings, Microsoft.Practices.EnterpriseLibrary.ExceptionHandling, Version=5.0.414.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35" requirePermission="true" />
+
  </configSections>
+
</syntaxhighlight>
+
 
+
===exceptionHandling===
+
In this tag the settings for exception handling can be specified.
+
<source lang="xml">
+
  <exceptionHandling>
+
    <exceptionPolicies>
+
      <add name="System.Exception">
+
        <exceptionTypes>
+
          <add name="All Exceptions" type="System.Exception, mscorlib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089"
+
            postHandlingAction="None">
+
            <exceptionHandlers>
+
              <add name="System.Exception" type="Microsoft.Practices.EnterpriseLibrary.ExceptionHandling.Logging.LoggingExceptionHandler, Microsoft.Practices.EnterpriseLibrary.ExceptionHandling.Logging, Version=5.0.414.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35"
+
                logCategory="EXCEPTION" eventId="100" severity="Error" title="System.Exception"
+
                formatterType="Microsoft.Practices.EnterpriseLibrary.ExceptionHandling.TextExceptionFormatter, Microsoft.Practices.EnterpriseLibrary.ExceptionHandling, Version=5.0.414.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35"
+
                priority="0" />
+
            </exceptionHandlers>
+
          </add>
+
        </exceptionTypes>
+
      </add>
+
    </exceptionPolicies>
+
  </exceptionHandling>
+
</source>
+
 
+
===runtime===
+
Runtime specific configurations can be defined, as for example the ''[[Injection_Management#Plugin_Folders|probing]]'' path for [[Injection_Management|plugins]].
+
<source lang="xml">
+
<runtime>
+
<assemblyBinding xmlns="urn:schemas-microsoft-com:asm.v1">
+
<probing privatePath="lib;Injection"/>
+
<dependentAssembly>
+
<assemblyIdentity name="Xceed.Wpf.Themes.Metro" publicKeyToken="ba83ff368b7563c6" culture="neutral"/>
+
<bindingRedirect oldVersion="0.0.0.0-2.4.14475.10340" newVersion="2.4.14475.10340"/>
+
</dependentAssembly>
+
<dependentAssembly>
+
<assemblyIdentity name="Xceed.Wpf.Themes" publicKeyToken="ba83ff368b7563c6" culture="neutral"/>
+
<bindingRedirect oldVersion="0.0.0.0-2.4.14475.10340" newVersion="2.4.14475.10340"/>
+
</dependentAssembly>
+
<dependentAssembly>
+
<assemblyIdentity name="Xceed.Wpf.Toolkit" publicKeyToken="ba83ff368b7563c6" culture="neutral"/>
+
<bindingRedirect oldVersion="0.0.0.0-2.4.14475.10340" newVersion="2.4.14475.10340"/>
+
</dependentAssembly>
+
<dependentAssembly>
+
<assemblyIdentity name="Xceed.Wpf.ListBox" publicKeyToken="ba83ff368b7563c6" culture="neutral"/>
+
<bindingRedirect oldVersion="0.0.0.0-2.4.14475.10340" newVersion="2.4.14475.10340"/>
+
</dependentAssembly>
+
<dependentAssembly>
+
<assemblyIdentity name="Xceed.Wpf.Themes.Office2007" publicKeyToken="ba83ff368b7563c6" culture="neutral"/>
+
<bindingRedirect oldVersion="0.0.0.0-2.4.14475.10340" newVersion="2.4.14475.10340"/>
+
</dependentAssembly>
+
</assemblyBinding>
+
</runtime>
+
</source>
+
 
+
===system.serviceModel===
+
In this section the web services are configured:
+
* Behaviours for services and endpoints
+
* Bindings (provides different configurations for data services and endpoints specified by the name which then is used in the service/client configuration). See [http://msdn.microsoft.com/en-us/library/ms733099%28v=vs.110%29.aspx Details] for further information and [http://msdn.microsoft.com/en-us/library/hh924831%28v=vs.110%29.aspx Configuring Timeout Values on a Binding] for information about Timeout configuration.
+
* Services (used for the data service and the session management service)
+
* Clients (the client definition is used by the data service to connect to the session management service defined in the appSettings)
+
:The client's endpoint addresses are ignored as they are replaced by the settings provided in appSettings at service runtime!
+
 
+
==== behaviors ====
+
<source lang="xml">
+
<system.serviceModel>
+
  <behaviors>
+
    <serviceBehaviors>
+
      <behavior name="httpBehavior">
+
        <!-- To avoid disclosing metadata information, set the value below to false and remove the metadata endpoint above before deployment -->
+
        <serviceMetadata httpsGetEnabled="true"/>
+
        <!-- To receive exception details in faults for debugging purposes, set the value below to true.  Set to false before deployment to avoid disclosing exception information -->
+
        <serviceDebug includeExceptionDetailInFaults="true"/>
+
      </behavior>
+
    </serviceBehaviors>
+
    <endpointBehaviors>
+
      <behavior name="httpBehavior">
+
        <webHttp/>
+
      </behavior>
+
    </endpointBehaviors>
+
  </behaviors>
+
  ...
+
</system.serviceModel>
+
</source>
+
 
+
==== bindings ====
+
See [[Configuration_Files/Bindings.config]].
+
 
+
==== services ====
+
<source lang="xml">
+
<system.serviceModel>
+
  ...
+
  <serviceHostingEnvironment multipleSiteBindingsEnabled="true" minFreeMemoryPercentageToActivateService="0"/>
+
  <services>
+
    <service name="UBIK.Service.UBIKContent" behaviorConfiguration="httpBehavior">
+
      <endpoint address="" behaviorConfiguration="httpBehavior" binding="webHttpBinding" bindingConfiguration="WebHttpBinding_UBIKContent" contract="UBIK.Service.IUBIKContent"/>
+
      <endpoint address="/SOAP" binding="wsHttpBinding" bindingConfiguration="WSHttpBinding_UBIKContent" contract="UBIK.Service.IUBIKContent"/>
+
    </service>
+
    <service name="UBIK.Service.USAM" behaviorConfiguration="httpBehavior">
+
      <endpoint address="" binding="webHttpBinding" behaviorConfiguration="httpBehavior" bindingConfiguration="WebHttpBinding_UBIKContent" contract="UBIK.Service.IUSAM"/>
+
      <endpoint address="/SOAP" binding="wsHttpBinding" bindingConfiguration="WSHttpBinding_IUSAM" contract="UBIK.Service.IUSAM"/>
+
    </service>
+
  </services>
+
  ...
+
</system.serviceModel>
+
</source>
+
 
+
==== client ====
+
See [[Configuration_Files/Client.config]].
+
 
+
<headertabs />
+
 
+
== See also ==
+
* [[Web Service Configuration]]
+
 
+
[[Category:Web Service]]
+

Latest revision as of 14:58, 12 May 2015