.gif) Important |
|---|
|
This topic is applicable only for BizTalk Server 2006 R2 Service Pack 1 (SP1).
|
You must configure the send handler properties if you want the WCF-Custom adapter to look up the custom bindings from locations other than machine.config.
Why Should WCF-Custom Adapter Look up Custom Bindings from Locations Other than machine.config?
Custom bindings used by BizTalk Server are registered in the machine.config. Before loading the binding, the WCF-Custom adapter looks for the binding in machine.config. However, machine.config is ideally used to store configuration information that is required across all applications running on a particular computer. On the other hand, WCF custom bindings may be required only by BizTalk Server and not by all the applications running on the computer. So, while storing the custom binding configuration in machine.config serves the purpose, it is not the most optimal location.
With BizTalk Server SP1, the adapter handler properties provide an additional location from which the WCF-Custom adapter can look up the custom binding information. Note that this does not replace the configuration information already stored in machine.config.
Additional Considerations
Keep the following points in mind while configuring the WCF-Custom send handler properties:
-
The binding configuration must be available either in the machine.config or in the adapter handler properties. The binding configuration must not be duplicated at both locations.
-
If the binding configuration is already available in the machine.config and you try to set the same binding for the adapter handler properties, you get an error as soon as you try to set the property.
-
If the binding configuration is already set for the adapter handler properties and you then update the machine.config with the same binding configuration, you will get a runtime error and it is also logged in the event log.
-
The assemblies referred in the binding configuration must be present in the Global Assembly Cache (GAC) before you set the adapter handler properties.
Configuring the Adapter Handler Properties
Use the procedure in this topic to configure a WCF-Custom send handler.
To configure the adapter handler properties
-
In the BizTalk Administration Console, expand BizTalk Server 2006 R2 Administration, expand BizTalk Group, expand Platform Settings, and then expand Adapters.
-
In the expanded adapter list, click WCF-Custom, in the right pane, right-click the send handler that you want to configure, and then click Properties.
-
In the Adapter Handler Properties dialog box, on the General tab, in the Host Name list, select the host with which the send handler will be associated, and then click Properties.
-
In the WCF-Custom Transport Properties dialog box, on the WCF Extensions tab, do the following:
|
Use this
|
To do this
|
|---|
|
Import
|
Imports a WCF configuration file with WCF custom bindings. Clicking this button opens the Import WCF configuration dialog box to browse and locate a WCF configuration file. Note that the file should be a valid WCF configuration file. For more information about WCF configuration schema, see “Windows Communication Foundation Configuration Schema” at http://go.microsoft.com/fwlink/?LinkId=163953.
|
|
Export
|
Exports the WCF custom binding configuration to a WCF configuration file. Clicking this button opens the Export WCF configuration dialog box to browse and save the WCF configuration file.
|
|
Clear
|
Clears the existing WCF custom binding configuration from the adapter handler properties.
|
Other Resources
Configuring the WCF-Custom Adapter