Troubleshooting the Orders System

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

This topic contains information about how to identify and fix problems that you might encounter when you work with the Commerce Server orders system.

Event Viewer

Commerce Server stores all events and errors in a single event log. You can view this log by using the Event Viewer provided with the operating system.

Web.config Settings

The Web.config file contains settings that control the time-out period for the SQL Server commands that access the transactions or transactionconfig database. If the SQL queries time out, you might want to increase the value of the sqlCommandTimeoutSeconds or the sqlLongRunningCommandTimeoutSeconds attributes of the orders element in the Web.config file.

Troubleshooting the Orders Pipelines

The DumpOrder.vbs script writes the contents of an order form to a file. You can add a Scriptor pipeline component that calls the DumpOrder.vbs script to any stage of a pipeline to examine the order form at a specific point in a pipeline. For more information about how to use the DumpOrder.vbs script, see How to Display the Contents of an Order Form.

If you are running a pipeline component within the debugger, you can display the contents of a dictionary as XML by executing the following line of code from the debugger:

(Microsoft.CommerceServer.Interop.IpersistXML)<dictionary>.SaveXML(0);

Where <dictionary> is the variable that represents the dictionary.

For information about how to troubleshoot problems in pipelines, see Troubleshooting Pipelines.

Event Tracing for Windows

Commerce Server has been instrumented to use Event Tracing for Windows (ETW). For more information about how to use ETW to trace Commerce Server events, see How to Trace Commerce Server Events.

Resolving Specific Errors

Shipping Method Not Currently Available

When you run the Total pipeline, you might receive an error that indicates "The selected shipping method is not currently available. Please choose another shipping method." This error occurs if you have not specified a shipping method for one or more line items in the order form. You specify the shipping method on a LineItem object by setting its ShippingMethodId property to a GUID that represents the shipping method for that line item.

Two errors messages encountered in the orders web service relate to the configuration of the presentation information. Presentation information file names are specified in the Web.config file. Presentation information files are expected to be located in the web service's VROOT folder. The error code 4308 "Orders presentation information was not configured in the configuration file" indicates an incomplete configuration file was referenced. Completing the file will resolve this error. The error code 4309 "None of the presentation information files specified in configuration file were marked as default" indicates that a default file needs to be set.

See Also

Other Resources

Troubleshooting Pipelines

Developing with the Orders System