OrderQuotationCheck command

This command checks to see if child orders exist for the specified OrderQuotationRel objects and redirects to one of three specified URLs depending on the results of the check.

Command structure

http://host_name/path/
The fully qualified name of your WebSphere Commerce Server and the configuration path.

Diagram of the command structure: the command starts with the fully qualified name of your WebSphere Commerce Server and the configuration path, followed by the command name, OrderQuotationCheck  and the ? character. End the command with a list of parameters in the form of name value pairs. Separate each name value pair with the & character. For a detailed description of the parameters and their values, refer to the list entitled Parameter values.

Parameter values

orderQuotationRelId
Specifies the ID of the OrderQuotationRel objects to be checked. The default value of this parameter is "*initial*parent.", an OrderQuotationRel abbreviation specifying all of the OrderQuotationRel objects whose type is "initial" and whose parent is one of the current pending orders for the current user. (OrderQuotationRel abbreviations are described in more detail in the help for Order Management subsystem commands.) This parameter can be repeated.
outOkOrderQuotationRelIdName
Specifies the names of name-value pairs that should be added to the redirection URL. The values of the added name-value pairs are the identifiers of the checked OrderQuotationRel objects that have a child order. This parameter can be repeated.
outTimeoutOrderQuotationRelIdName
Specifies the names of name-value pairs that should be added to the redirection URL. The values of the added name-value pairs are the identifiers of the checked OrderQuotationRel objects that do not yet have child orders but whose timeoutTime attribute values are less than the current time. This parameter can be repeated.
outWaitOrderQuotationRelIdName
Specifies the names of name-value pairs that should be added to the redirection URL. The values of the added name-value pairs are the identifiers of the checked OrderQuotationRel objects that do not yet have child orders but whose timeoutTime attribute values are not less than the current time. This parameter can be repeated.
okURL
Specifies the redirection URL that is returned if child orders exist for all the checked OrderQuotationRel objects. This parameter is required.
waitURL
Specifies the redirection URL that is returned if some of the checked OrderQuotationRel objects do not yet have child orders but none of them has a timeoutTime less than the current time. The value of this parameter defaults to the value of the okURL parameter.
timeoutURL
Specifies the redirection URL that is returned if some of the checked OrderQuotationRel objects do not yet have child orders but have a timeoutTime less than the current time. The value of this parameter defaults to the value of the waitURL parameter.
errorURL
Specifies the redirection URL that is returned if some of the checked OrderQuotationRel objects indicate that an error status was returned from the external system requested to provide quotation information less than the current time. This parameter is optional.

Example 1

The following example checks for responses to a previous request for initial quotations for the current shopcart. It redirects to one of four different URLs, depending on whether some responses have indicated that an error occurred, all responses have been received without error, some responses have not been received and their timeout values have been exceeded, or some responses have not been received but none have timed out yet. The identifiers of the OrderQuotationRel objects that have been received, timed out, or are still waiting are returned in the receivedRelIds, timedoutRelIds, and waitingRelIds response properties respectively. 

     http://myhostname/webapp/wcs/stores/servlet/OrderQuotationCheck?storeId=1111
          &orderQuotationRelId=*initial*parent.
          &errorURL=ShowErrorResponse
          &okURL=AllResponsesReceived
          &timeoutURL=SomeResponsesTimedOut
          &waitURL=ShowWaitingMessagePauseAndCheckAgain
          &outOKOrderQuotationRelIdName=receivedRelIds
          &outTimeoutOrderQuotationRelIdName=timedoutRelIds
          &outWaitOrderQuotationRelIdName=waitingRelIds

Example 2

The following example checks for responses to a previous request for final quotations for the shopcart with order identifier 1234. Otherwise, it is the same as Example 1. 

     http://myhostname/webapp/wcs/stores/servlet/OrderQuotationCheck?storeId=1111
          &orderQuotationRelId=*final*parent1234
          &errorURL=ShowErrorResponse
          &okURL=AllResponsesReceived
          &timeoutURL=SomeResponsesTimedOut
          &waitURL=ShowWaitingMessagePauseAndCheckAgain
          &outOKOrderQuotationRelIdName=receivedRelIds
          &outTimeoutOrderQuotationRelIdName=timedoutRelIds
          &outWaitOrderQuotationRelIdName=waitingRelIds

Behavior

Exception conditions