How to Configure a Receive Endpoint for a BizTalk Adapter

  • Article

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

Before completing the steps described in this topic you should be familiar with how the BizTalk Server concepts of receive endpoints, receive locations, and receive ports are used in relation to the receive adapters in general, and to Commerce Server receive adapters in particular. For more information, see Receive Endpoints, Receive Ports, and Receive Locations.

Most of the configuration properties for receive endpoints are not specific to the Commerce Server receive adapters. Indeed, the configuration properties that are specific to the Commerce Server receive adapters are all found in the following four variations of the Transport Properties dialog box (shown with links to their corresponding How To topics):

This topic provides the steps required to create a receive adapter endpoint for a Commerce Server receive adapter, which are the same steps regardless of the type of Commerce Server receive adapter. It does not discuss the steps required to configure the properties that are specific to each type of Commerce Server receive adapter, nor does it discuss the steps required to configure the properties of a receive adapter endpoint that are common to all receive adapters regardless of whether they are Commerce Server receive adapters. For the former type of information, see the links above, and for the latter type of information, see the BizTalk Server documentation.

To create a new receive adapter endpoint, you need to create a new receive port and a new receive location.

To create a new receive port

  1. In the BizTalk Server Administration Console, in the console tree, navigate to the BizTalk group and BizTalk application in which you want to create the new receive port.

    Note

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

  2. Right-click Receive Ports, click New, and then click One-way Receive Port. The Receive Port Properties dialog box opens.

  3. On the General tab, type an appropriate name and description for this receive port in the Name and Description boxes, respectively.

    Note

    Choose a name that will help you identify the Commerce Server adapter with which you intend to use this receive port. For example, CatalogReceivePort might be a good name to use for a receive port intended for use with the Catalog receive adapter.

  4. On the General tab and the other tabs, configure other BizTalk Server receive port properties that are not specific to receive ports being used with the Commerce Server adapters. For more information about these other properties, see the BizTalk Server documentation.

  5. Click OK to save the receive port property settings and close the Receive Port Properties dialog box.

To create a new receive location

  1. In the BizTalk Server Administration Console, in the console tree, navigate to the BizTalk group and BizTalk application in which you want to create the new receive location.

    Note

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

  2. Right-click Receive Ports, click New, and then click One-way Receive Location. The Select a Receive Port dialog box opens.

  3. Click the receive port you created above, and then click OK. The Receive Location Properties dialog box opens.

  4. On the General tab, type an appropriate name and description for this receive location in the Name and Description boxes, respectively.

    Note

    Choose a name that will help you identify the Commerce Server adapter with which you intend to use this receive location. For example, CatalogReceiveLocation might be a good name to use for a receive location intended for use with the Catalog receive adapter.

  5. On the General tab, in the Transport section, in the Type drop-down list, choose the Commerce Server adapter for which you are creating this receive endpoint.

  6. Click Configure to configure the transport properties that are specific to the type of Commerce Server receive adapter that you chose in the previous step. The relevant Commerce Server System Transport Properties dialog box opens.

    At this point, you must configure at least the required properties of this Commerce Server receive adapter endpoint. You may return to this dialog box at a later time to configure the optional properties. For more information about the configuration properties in this dialog box, see one of the following How To topics:

    When you have finished configuring at least the required properties of this Commerce Server receive adapter endpoint, click OK to return to the Receive Location Properties dialog box.

  7. On the General tab and the other tabs, configure other BizTalk Server receive location properties that are not specific to receive locations being used with the Commerce Server adapters. For more information about these other properties, see the BizTalk Server documentation.

  8. Click OK to save the receive location property settings and close the Receive Location Properties dialog box.

See Also

Other Resources

How to Add a BizTalk Adapter

Receive Endpoints, Receive Ports, and Receive Locations

How to Configure a Send Endpoint for a BizTalk Adapter

Configuring the BizTalk Adapters