orders Element

The orders element in the Web.config file describes the details of the Orders System configuration. The orders element is optional. However, if you include the orders element in the Web.config file, you must also include certain elements within the orders element. The required elements are identified later in this topic.

Put the orders element within the CommerceServer element.

The following table lists the attributes of the orders element.

Attribute

Data Type

Description

honorStatus

String

Determines whether Commerce Server will control when orders can be modified.

The value of this attribute must represent a boolean. The default value is "false".

This attribute is optional.

newOrderStatus

String

The status that Commerce Server should give to a newly created order.

The default value is "NewOrder".

This attribute is optional.

sqlCommandTimeoutSeconds

String

The time, in seconds, after which most orders system APIs that access the database will time out. See the description of the sqlLongRunningCommandTimeoutSeconds attribute for the orders system APIs that use a different time-out value.

The default value is "60".

This attribute is optional.

sqlLongRunningCommandTimeoutSeconds

String

The time, in seconds, after which the following orders system APIs will time out:

  • GetPurchaseOrdersAsXml

  • DeletePurchaseOrders

  • DeleteBaskets

  • SearchPurchaseOrder

  • SearchBaskets

The default value is "28800".

This attribute is optional.

For more information about how to use the honorStatus attribute and the newOrderStatus attribute, see How to Coordinate Updates to Orders.

The following table contains a list of the elements that the orders element can contain, along with a link to more information about each element.

Element

Required?

Reference Information

addressMap

Optional

addressMap Element

Types

Required

Types Element

Limits

Optional

Limits Element

MappingFiles

Optional

MappingFiles Element

SerializationBindings

Optional

SerializationBindings Element

Note

If you omit the orders element, the default values for the addressMap element will be used to map the properties of an address in the Profiles System to the properties of an OrderAddress object in the Orders System. However, if you include the orders element but omit the addressMap element within the orders element, then no address profile properties will be mapped to an OrderAddress object. For more information about the default values for the addressMap element, see addressMap Element.

Note

To make the Orders Web service behave the same as the application, the orders element and all of its attributes and sub-elements must be the same in both the Web.config file for the Orders Web service and the Web.config file for the application.

See Also

Other Resources

How to Coordinate Updates to Orders

Web.Config Configuration Settings