Udostępnij za pośrednictwem


How to Configure the Orders Transport Properties for a Send Endpoint

For the latest version of Commerce Server 2007 Help, see the Microsoft Web site.

Before you can configure the transport properties for a Commerce Server Orders 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 adapters, see How to Configure a Send Endpoint for a BizTalk Adapter.

Almost all the configuration properties associated with Commerce Server Orders 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.

To configure the Commerce Server Orders transport properties for a send port

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

    Note

    You may also perform these steps in Microsoft Visual Studio 2005 or Visual Studio 2008.

  2. In the right pane, right-click the appropriate Orders 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 Orders).

    The Commerce Server Orders Transport Properties dialog box opens.

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

    Note

    By default, when you configure transport properties for Commerce Server 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\Orders

    This location, ending with the provided subkey, is used by the Commerce Server Orders 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 - Basket Pipeline

    A string that specifies the name of the pipeline that is run to validate baskets. This name is in the Web.config file for the Orders Web Service.

    This property is applicable only to the processing of CommerceServerOrdersAcceptBasket messages.

    The default value is acceptbasket.

    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 - Save Baskets As POs

    A Boolean value that specifies whether baskets submitted by this send adapter endpoint should be saved as purchase orders or as baskets within the Commerce Server Orders System. True specifies that baskets should be saved as purchase orders.

    This property is applicable only to the processing of CommerceServerOrdersAcceptBasket messages.

    The default value is False.

    Adapter Message Type - Endpoint Message Type

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

    • Accept Baskets. Process only messages of type CommerceServerOrdersAcceptBasket. Other message types, if used, must be processed by a different Orders send adapter.

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

    • Orders Queries. Process only messages of type CommerceServerOrdersQuery. Other message types, if used, must be processed by a different Orders send adapter.

    • Save Purchase Orders. Process only messages of type CommerceServerOrdersSavePurchaseOrder. Other message types, if used, must be processed by a different Orders send adapter.

    • Update Order Properties.Pprocess only messages of type CommerceServerOrdersUpdateOrderProperties. Other message types, if used, must be processed by a different Orders send adapter.

    The default value is Save Purchase Orders.

    Connection Information - Web Service URL

    A required string that specifies the URL of the Commerce Server Orders Web Service.

    The default URL of the Orders Web Service is http://hostname/OrdersWebService/OrdersWebService.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, where True specifies that the proxy server is bypassed.

    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 Orders 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 Orders 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 Orders Web Service. If a name is not specified, BizTalk Server will use the running host instance credentials when logging on to the Orders 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 an Orders Adapter Endpoint