How to Configure the Profiles Transport Properties for a Send Endpoint

Before you can configure the transport properties for a Commerce Server Core Systems Profiles send adapter, you must create an appropriate send port within the BizTalk Server Administration Console. For information about the aspects of these tasks specific to Commerce Server Core Systems adapters, see How to Configure a Send Endpoint for a BizTalk Adapter.

Almost all the configuration properties associated with Commerce Server Core Systems Profiles send adapter endpoints are configured within the Transport Properties dialog box associated with the send port you have created for this adapter. This topic explains these properties and how to set them.

Note

When you configure the Profiles send adapter endpoint for queries, it will only return the number of results up to the SearchResultLimit value in the Web.config file, regardless of the actual size of the query results. For example, if you set SearchResultLimit to 500 (the default value) and your query returns 1000 results, you will see only 500 results.

To configure the Profiles transport properties for a send port

  1. In the BizTalk Server Administration Console, in the left pane, navigate to your Commerce Server Core Systems send port or ports.

    Note

    You may also perform these steps in Visual Studio 2008.

  2. In the right pane, right-click the appropriate Profiles send port, and then click Properties.

    The Send Port Properties dialog box opens.

  3. Select the General tab in the left pane. In the Transport box in the right pane, click the Configure button associated with the Type selection (in which you have previously selected Commerce Server Profiles).

    The Commerce Server Profiles Transport Properties dialog box opens.

  4. In the Commerce Server Profiles Transport Properties dialog box, configure the operation of this Profiles send adapter endpoint.

    Note

    By default, when you configure transport properties for Commerce Server Core Systems adapter endpoints, no Web service calls are made to validate the parameters you specify. However, you can set a key in the registry that will instruct the adapters to perform additional parameter validation that includes several Web service calls. For more information about this registry key, see Endpoint Configuration Validation.

    Transport property

    Description

    Adapter Endpoint Parameters - Registry Subkey

    A required string that is used as a unique subkey within the following registry location:

    HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Commerce Server 2007 BizTalk Adapters\Profiles

    This location, ending with the provided subkey, is used by the Commerce Server Core Systems Profiles send adapter to store information such as the date and time this adapter endpoint was last run and the GUID it uses for tracing.

    Adapter Endpoint Parameters - Namespace

    A string that specifies a namespace to be used in conjunction with the solicit and response messages associated with this send adapter endpoint.

    For more information about how this property is used, see Using the Namespace Transport Property.

    Adapter Endpoint Parameters - Updates Overwrite

    A Boolean value that determines whether profile updates will automatically overwrite existing properties, with True specifying automatic overwriting.

    The setting of this property affects only messages of type CommerceServerProfilesUpdate. If you set this property to False, the last-modified date/time of the profile in the profiles update message will be compared with the last-modified date/time of the corresponding profile in the Profiles System. If the former is later than the latter, which indicates that the adapter update contains newer information than what exists in the Profiles System, the update will be allowed and should succeed. A successful response message will be generated by the adapter and submitted to BizTalk Server.

    If the former is earlier than the latter, which indicates that the information in the Profiles System is newer than that contained in the adapter update, the update will not be allowed and a failed response message will be generated by the adapter and submitted to BizTalk Server.

    If you set this property to True, the last-modified date/time check will not be performed, and the adapter update will be allowed to overwrite the information in the Profiles System.

    The default value is False.

    Adapter Message Type - Endpoint Message Type

    A drop-down list choice that determines which of the possible Profiles message types will be handled by this send adapter. The possible values are:

    • Delete Profile. Process only messages of type CommerceServerProfilesDelete. Other message types, if used, must be processed by a different Profiles send adapter.

    • FromContext. Process all Profiles send adapter messages, using the context property CommerceServerMessageType to determine the type of each message.

    • Import Profiles. Process only messages of type CommerceServerProfilesImport. Other message types, if used, must be processed by a different Profiles send adapter.

    • Query Profiles. Process only messages of type CommerceServerProfilesQuery. Other message types, if used, must be processed by a different Profiles send adapter.

    • Update Profiles. Process only messages of type CommerceServerProfilesUpdate. Other message types, if used, must be processed by a different Profiles send adapter.

    The default value is Import Profiles.

    Connection Information - Web Service URL

    A required string that specifies the URL of the Commerce Server Core Systems  Profiles Web Service.

    The default URL of the Profiles Web Service is http://hostname/ProfilesWebService/ProfilesWebService.asmx.

    Connection Information - Connection Timeout

    A number that specifies the Web service time-out duration, in seconds. Use "-1" to specify that there is no time-out duration.

    The default value is 100.

    Connection Information - Proxy Connection Information - Local bypass

    A Boolean value that specifies whether to bypass the proxy server when you use a local address, with True specifying to bypass the proxy server.

    The default value is False.

    Connection Information - Proxy Connection Information - Port

    A string that specifies the port number on the proxy server through which you connect to the Profiles Web Service. There is no default value.

    Connection Information - Proxy Connection Information - Proxy Password

    A string that specifies the password to use when logging on to the proxy server.

    Connection Information - Proxy Connection Information - Proxy Server

    A string that specifies the URL of the proxy server, if any. Proxy server URLs must begin with "http://" or "https://".

    Connection Information - Proxy Connection Information - Proxy Username

    A string that specifies the user name to use when logging on to the proxy server.

    Connection Information - Web Service Password

    A string that specifies the password to use when logging on to the Profiles Web Service. This property is relevant only when a value is specified for the Web Service Username property.

    Connection Information - Web Service Username

    A string that specifies the user name to use when logging on to the Profiles Web Service. If a name is not specified, BizTalk Server will use the running host instance credentials when logging on to the Profiles Web Service.

    For more information about host instances, see the BizTalk Server documentation.

    User Defined Context Properties - Site name

    A string that specifies the name of the Web site that this send adapter supports. There is no default value.

See Also

Other Resources

How to Add a BizTalk Adapter

How to Configure a Send Endpoint for a BizTalk Adapter

Configuring a Profiles Adapter Endpoint