Adapter Message Schemas

  • Article

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

The XML messages associated with the BizTalk adapters that are provided with Commerce Server, which are also known informally as the Commerce Server adapters, are described by several message schemas. These schemas can be divided into the following categories:

  • BizTalk Server property schemas. This schema is required for writing and promoting context properties.

  • Commerce Server system schemas. These describe message bodies that contain Commerce Server data.

  • Commerce Server adapter schemas. These describe adapter-specific message bodies that do not contain Commerce Server data.

This topic discusses each of these schema categories separately.

Note

For information about the association of Commerce Server adapter message types and the message body schemas that they use, organized by message type, see the tables within the section Adapter Message Types.

BizTalk Server Property Schemas

The Commerce Server adapters share a single BizTalk Server property schema that has the following full name:

Microsoft.CommerceServer.GlobalPropertySchemas.CommonAdapterPropertySchema

This property schema is installed into the default BizTalk application when the Commerce Server adapters are installed. Make sure that this property schema is in the same BizTalk application to which you add the Commerce Server adapters, moving it as necessary from the BizTalk application into which it is originally installed.

This property schema is required so that the following context properties can be promoted for routing purposes:

  • CommerceServerMessageType

  • CommerceServerCommandResult

  • Sitename

Some Commerce Server adapter messages contain other context properties. In addition, BizTalk Server itself maintains many context properties.

Commerce Server System Schemas

The Commerce Server systems that construct XML representations of their data for inclusion in the messages that are generated by the Commerce Server adapters are also designed to generate one or more XSD schemas that describe those XML representations. If your Commerce Server adapter solution involves validating or otherwise examining any of these messages within BizTalk Server, you must deploy these schemas to the BizTalk application in which the Commerce Server adapters reside. The BizTalk project that is included in the adapters SDK includes default versions of these schemas that correspond to the default schemas of the various Commerce Server systems from which they originate. However, because it is likely that you will modify one or more of the Commerce Server system schemas to suit the individual needs of your Web application, you may have to generate up-to-date versions of these schemas and deploy them to BizTalk Server. For more information about the adapter SDK and the methods supplied to generate up-to-date Commerce Server system schemas, see BizTalk Adapters SDK and Generating and Using the XSD Files Required by Different Commerce Server Systems, respectively.

The following table shows the default versions of the Commerce Server system schemas, included in the adapters SDK, that are used by various adapter messages. If you generate up-to-date versions of these schemas, you may name them differently.

Note

For readability, the common and leading string "CommerceServer" has been left off the adapter message strings in the following table (for example, the message type CommerceServerCatalogExport is listed as CatalogExport). Also, the conditions that affect when a particular schema is used, such as whether a response communicates success or failure, or schema choice that depends on a transport property setting, are noted where they are appropriate.

Commerce Server system schema

(default version)

Adapter message types

Basket.xsd

  • OrdersAcceptBasket messages

  • OrdersAcceptBasketResponse messages that indicate success, when Save Baskets As POs = False

  • OrdersExport messages

  • OrdersQueryResponse messages that indicate success

DefaultCatalog.xsd

  • CatalogExport messages

  • CatalogImport messages

  • CatalogImportResponse messages that indicate success

  • CatalogQueryResponse messages that indicate failure

  • CatalogQueryResponse messages that indicate success

DefaultInventory.xsd

  • InventoryExport messages

  • InventoryImport messages

  • InventoryImportResponse messages that indicate success

  • InventoryQueryResponse messages that indicate failure

  • InventoryQueryResponse messages that indicate success

OrderGroupCollection.xsd

  • OrdersExport messages

  • OrdersQueryResponse messages that indicate failure

  • OrdersQueryResponse messages that indicate success

ProfileDocument.xsd

  • ProfilesExport messages

  • ProfilesImport messages

  • ProfilesUpdate messages

PurchaseOrder.xsd

  • OrdersAcceptBasketResponse messages that indicate success, when Save Baskets As POs = True

  • OrdersExport messages

  • OrdersQueryResponse messages indicating success

  • OrdersSavePurchaseOrder messages

Commerce Server Adapter Schemas

Some messages that are generated by the Commerce Server adapters do not include XML representations of data that originates in the Commerce Server systems with which they interact. These messages still have message bodies, and the Commerce Server adapters SDK includes the schemas that describe these message bodies. If your Commerce Server adapter solution involves validating or otherwise examining any of these messages within BizTalk Server, you must deploy the corresponding adapter schemas to the BizTalk application in which the Commerce Server adapters reside. The BizTalk project that is included in the adapters SDK includes these schemas. Unlike the Commerce Server system schemas, the adapter schemas will not change as you modify the schemas associated with the various Commerce Server systems. Therefore, if you decide to deploy one or more of the adapter schemas to your BizTalk application, you will only have to deploy them one time. For more information about the adapter SDK, see BizTalk Adapters SDK.

The following table shows the Commerce Server adapter schemas, included in the adapters SDK, that are used by various adapter messages.

Note

For readability, the common and leading string "CommerceServer" has been left off the adapter message strings in the following table (for example, the message type CommerceServerCatalogExport is listed as CatalogExport). Also, the conditions that affect when a particular schema is used, such as whether a response communicates success or failure, or schema choice that depends on a transport property setting, are noted where they are appropriate.

Commerce Server adapter schema

Adapter message types

CatalogQuery.xsd

  • CatalogQuery messages

CatalogResponseMessage.xsd

  • CatalogImportResponse messages that indicate failure

InvalidProfilesMessageResponse.xsd

  • ProfilesImportResponse messages that indicate failure

  • ProfilesUpdateResponse messages that indicate failure

InventoryQuery.xsd

  • InventoryQuery messages

InventoryResponseMessage.xsd

  • InventoryImportResponse messages that indicate failure

OrdersAcceptBasketErrorResponse.xsd

  • OrdersAcceptBasketResponse messages that indicate failure

OrdersQuery.xsd

  • OrdersQuery messages

OrdersQueryExpr.xsd

  • Orders search expression schema

OrdersSavePurchaseOrderResponse.xsd

  • OrdersSavePurchaseOrderResponse messages that indicate success or failure

OrderUpdate.xsd

  • OrdersUpdateOrderProperties messages

ProfilesDelete.xsd

  • ProfilesDelete messages

ProfilesDeleteResponse.xsd

  • ProfilesDeleteResponse messages that indicate success or failure

ProfilesImportResponse.xsd

  • ProfilesImportResponse messages that indicate success

ProfilesQuery.xsd

  • ProfilesQuery messages

ProfilesQueryExpr.xsd

  • Profies search expression schema

ProfilesQueryResponseMessage.xsd

  • ProfilesQueryResponse messages that indicate success or failure

ProfilesUpdateResponse.xsd

  • ProfilesUpdateResponse messages that indicate success

UpdatePurchaseOrderPropertiesResponseMessage.xsd

  • OrdersUpdateOrderPropertiesResponse messages that indicate success or failure

See Also

Other Resources

Adapter Message Types

Generating and Using the XSD Files Required by Different Commerce Server Systems

BizTalk Adapters SDK

BizTalk Adapter Concepts