Specifying configuration settings
To optimize the performance of your application, you might want to customize how your application interacts with the eConnect Integration Service. For example, if you use eConnect to send large eConnect XML documents, you might want to increase the settings that specify maximum message size.
To specify configuration settings, you add one or more key nodes to the <appSetting> node of the configuration file. The configuration file you update depends upon whether you are using a reference to the Microsoft.Dynamics.GP.eConnect assembly or a service reference to the eConnect Integration Service.
Reference type |
Configuration file |
Description |
|---|---|---|
Reference |
<ApplicationName>.exe.config |
Add configuration keys to the application configuration file of your .NET application. |
Service reference |
Microsoft.Dynamics.GP.eConnect.Service.exe.config |
Add configuration keys to the configuration file of the eConnect Integration Service. The configuration file for the service is typically found in the folder C:\Program Files\Microsoft Dynamics\eConnect 12.0\Service |
To specify a configuration setting, you add a <key> node to the appSetting section of the configuration file. In the key node, you specify the name of the configuration setting and the value to use. The eConnect Integration Service enables you to supply custom values for the following configuration settings.
Name |
Description |
|---|---|
MaxReadQuotaSize |
Specifies the maximum size of read messages. |
MaxReceivedMessageSize |
Specifies the maximum size of an XML document. |
ProcTimeOut |
Specifies the number of seconds to wait before a time out occurs |
RequireProxyService |
Specifies whether to use the identity of the logged on user or the service identity when accessing SQL server. Set the value to true when you want the application to use the service identity. If your application includes a service reference to eConnect, the application always uses the service identity to access SQL. The value of this configuration setting is ignored. |
SendTimeout |
Specifies the length of time to wait when connecting to the eConnect Integration Service. Used when the RequiredProxyService is set to True. |
ServiceAddress |
Specifies the URL of the eConnect Integration Service. |
ServiceOperationTimeout |
Specifies the length of time to wait for an operation to complete. Used when the RequiredProxyService is set to True. |
TransactionIsolationLevel |
Specifies the isolation level of the transaction. The typical transaction isolation level for eConnect is ReadUncommitted. |
TransactionTimeoutSeconds |
Specifies the length of time to wait for a SQL transaction to complete. |
For more infomation about the configuration settings, see Configuration Class in the eConnect .NET Reference section.
If you add configuration settings to the configuration file of your application, you can also use the Configuration class in the Microsoft.Dynamics.GP.eConnect namespace to programmatically set configuration settings. Any configuration value set by the Configuration class override the value set in your application configuration file.
The following steps show how to add configuration settings to an eConnect .NET application. To begin, open the configuration file in a text editor.
Warning: Before you edit the Microsoft.Dynamics.GP.eConnnect.Service.exe.config file, make a copy of the file and store the file in a safe location. If you encounter problems with the service, use the saved copy to restore the existing service configuration.
Adding appSettings to the configuration file
To use custom configuration settings, add an <appSettings> node to the <configuration> of the application or service configuration file.
The following XML example shows how to add appSettings to an application configuration file.
<?xml version="1.0" encoding="utf-8" ?>
<configuration>
<appSettings>
</appSettings>
</configuration>
Adding configuration values
To specify custom configuration settings, add individual key and value information for each setting.
The following XML example adds configuration information for the SendTimeout, MaxReadQuotaSize, and MaxReceivedMessageSize. Notice how MaxReadQuotaSize and MaxReceivedMessageSize use the maximum value for those configuration settings.
<appSettings>
<add key="SendTimeout" value="60" />
<add key="MaxReadQuotaSize" value="2147483647" />
<add key="MaxReceivedMessageSize" value="2147483647" />
</appSettings>
Saving the configuration
To use your custom configuration settings, save the configuration file and restart your application.
If you edited the Microsoft.Dynamics.GP.eConnnect.Service.exe.config file. Stop and restart the eConnect Integration Service before restarting your application.