ordersWebService Element

The ordersWebService element provides the means to configure the behavior of the Orders Web service. This element is required, and should be used only in the web.config file for the Orders Web Service (<drive>:\Inetpub\wwwroot\OrdersWebService\Web.config).

Note

Any changes made to the attributes of this element are not applied by the server until the Web application is restarted using IISReset.

The table below lists and describes the attributes of the ordersWebService element.

Attribute

Data type

Description

authorizationPolicyPath

String

The file path to the Windows Authorization Manager authorization policy store.

If the disableAuthorization attribute is true, then this attribute is not validated.

This attribute is optional.

disableAuthorization

String

If the value of this attribute is true, the Web service will not perform authorization checks, which allows full access to all authenticated users. If false, authorization checks will be performed.

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

This attribute is optional.

searchResultsLimit

String

The maximum number of records that can be returned from a search operation. This only affects SELECT bulk query operations through the agent/Web service.

The value of this attribute must represent an integer. The default value is 500.

This attribute is optional.

siteName

String

The name of the site. This is automatically set during the pup process.

This attribute is required.

presentationConfiguration Element

The presentationConfiguration element in the Web.config file contains general configuration information about the presentation configuration files in use by the Profiles System of Commerce Server.

The presentationConfiguration element has no attributes.

cultureConfig Element

The cultureConfig element describes a presentation configuration file.

The following table lists and describes the attributes of the cultureConfig element.

Attribute

Data Type

Description

filePath

String

The name and path of a culture-specific presentation configuration file. If a fully specified path is not included with the file name, the file with the specified name will be searched for in the default directory.

The data in these presentation configuration files will be returned through the GetSearchableProperties method.

This attribute is required.

isDefault

Bool

If true, the presentation configuration file will be the default when presentation information is not available in the user-requested culture. If false or if this attribute is not specified, the presentation configuration file will not be the default. Only one cultureConfig element can be marked as the default.

This attribute is optional.

Remarks

Note

At least one cultureConfig element should be specified in the presentationConfiguration element. If none are specified, a Windows NT event will be logged and the Web service will continue to run.

The following example shows how to specify two presentation configuration files with one being the default. The files will be searched for in the default directory.

Code

<ordersWebService siteName="CSharpSite" disableAuthorization="false" 
   authorizationPolicyPath="OrdersAuthorizationStore.xml" 
   searchResultsLimit="500">
     <presentationConfiguration>
       <cultureConfig 
          filePath="en_OrdersPresentationInfo.xml" 
          isDefault="true" 
       />
       <cultureConfig filePath="de_OrdersPresentationInfo.xml" />
     </presentationConfiguration>
</ordersWebService>

See Also

Other Resources

Web.Config Configuration Settings