SOAP Adapter Configuration Properties
The following table lists the configuration properties that you can set for a SOAP adapter receive location:
| Property name | Type | Description | Restrictions | Comments |
|---|---|---|---|---|
| UseSSO | VT_BOOL | Specify whether to use Single Sign-On. | - Valid values are: - -1 (true) - 0 (false) |
The default value is 0 (false). |
The following code shows the format of the XML string you use to set the properties:
<CustomProps>
<UseSSO vt="11">0</UseSSO>
</CustomProps>
The following table lists the configuration properties that you can set for a SOAP adapter send port:
| Property name | Type | Description | Restrictions | Comments |
|---|---|---|---|---|
| ProxyPort | VT_I4 | Specify the proxy server port for this send port. | None | This property does not require a value unless the UseProxy property is set to -1 (true). The default value is 80. |
| AuthenticationScheme | VT_BSTR | Specify the type of authentication to use with the destination server. | Valid values are: - Anonymous - Basic - Digest - NTLM |
The default value is Anonymous. |
| Username | VT_BSTR | Specify the user name to use for authentication with the destination server. | Minimum length: 0 Maximum length: 256 |
This property does not require a value unless the AuthenticationScheme property is set to Basic or Digest and the UseSSO property is set to 0 (false). |
| UseProxy | VT_BOOL | Specify whether the SOAP send handler uses a proxy server. | Valid values are: - -1 (true) - 0 (false) |
The default value is 0 (false). |
| UseSoap12 | VT_BOOL | Specify to generate proxy code that will support the SOAP 1.2 protocol. | If this option is not selected, SOAP 1.1-compliant proxy code will be generated. Valid values are: - -1 (true) - 0 (false) |
The default value is 0 (false). |
| UsingOrchestration | VT_BOOL | Specify whether to use the Web service proxy associated with the address for this send port. | Valid values are: - -1 (true) - 0 (false) |
The default value is -1 (true). |
| UseSSO | VT_BOOL | Specify that Enterprise Single Sign-On is used. | Valid values are: - -1 (true) - 0 (false) |
The default value is 0 (false). |
| ProxyAddress | VT_BSTR | Specify the name of the proxy server. | This property is only valid if the UseProxy property is set to -1 (true). | None |
| Password | VT_NULL | Specify the password to use for authentication with the destination server. | This value is always set to null when exporting a binding file. This field must be manually populated with the password before importing the binding file into the target BizTalk Server configuration. | This property does not require a value unless the AuthenticationScheme property is set to Basic or Digest and the UseSSO property is set to 0 (false). |
| AssemblyPath | VT_BSTR | Specify the path to the assembly containing the Web service proxy. | None | None |
| TypeName | VT_BSTR | Specify the name of the class that contains the Web method to be invoked. | None | None |
| MethodName | VT_BSTR | Specify the method of the class that will be invoked. | None | None |
| UseHandlerSetting | VT_BOOL | Specify whether to use the SOAP send handler's default proxy configuration. | Valid values are: - -1 (true) - 0 (false) |
The default value is -1 (true). |
| ClientCertificate | VT_BSTR | Specify the thumbprint of the client certificate to use for establishing a connection. | Minimum length: 0 Maximum length: 59 |
None |
| ProxyPassword | VT_NULL | Specify the password to use for authentication with the proxy server. | This value is always set to null when exporting a binding file. This field must be manually populated with the password before importing the binding file into the target BizTalk Server configuration. | This property does not require a value if UseProxy is set to 0 (false). |
| ProxyUsername | VT_BSTR | Specify the username to use for authentication with the proxy server. | None | This property does not require a value unless the UseProxy property is set to -1 (true). |
The following code shows the format of the XML string you use to set the properties:
<CustomProps>
<ProxyPort vt="3">80</ProxyPort>
<AuthenticationScheme vt="8">Basic</AuthenticationScheme>
<Username vt="8">domain\testuser</Username>
<UseProxy vt="11">-1</UseProxy>
<UseSoap12 vt="11">-1</UseSoap12>
<UsingOrchestration vt="11">-1</UsingOrchestration>
<UseSSO vt="11">0</UseSSO>
<ProxyAddress vt="8">proxy</ProxyAddress>
<Password vt="1" />
<ProxyPort vt="3">80</ProxyPort>
<AssemblyPath vt="8">C:\Websvc.dll</AssemblyPath>
<TypeName vt="8">Websvc.svc</TypeName>
<MethodName vt="8">WebMethod</MethodName>
<UseHandlerSetting vt="11">0</UseHandlerSetting></
<ClientCertificate vt="8">23779A5EEA9693A37409021EFCDAB713A3680C34</ClientCertificate>
<ProxyPassword vt="1" />
<ProxyUsername vt="8">proxyuser</ProxyUsername>
</CustomProps>