|
|
(4 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>
| + | |
− | | + | |
− | ===loggingConfiguration===
| + | |
− | See [[Configuration_Files/Logging.config]].
| + | |
− | | + | |
− | ===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]]
| + | |