URL OrderQuotationCheck
Vérifiez les commandes de devis puis redirigez vers l'une des trois URL spécifiées, en fonction des résultats de la vérification.
Structure de l'adresse URL
- http:// host_name/ path/
- Nom entièrement qualifié de votre Transaction server et du chemin de configuration.
Valeurs des paramètres
- orderQuotationRelId
- Spécifie l'ID des objets OrderQuotationRel à vérifier. La valeur par défaut de ce paramètre est "*initial*parent.", une abréviation OrderQuotationRel spécifiant tous les objets OrderQuotationRel dont le type est "initial" et dont le parent est l'une des commandes en attente actuelles pour l'utilisateur actuel. (Les abréviations OrderQuotationRel sont décrites plus en détail dans l'aide aux URL du sous-système de gestion des commandes.) Ce paramètre peut être répété.
- outOkOrderQuotationRelIdName
- Définit les paires nom-valeur à ajouter à l'URL de redirection. Les valeurs des paires nom-valeur ajoutées sont les identificateurs des objets OrderQuotationRel vérifiés qui ont une commande enfant. Ce paramètre peut être utilisé plusieurs fois.
- outTimeoutOrderQuotationRelIdName
- Définit les paires nom-valeur à ajouter à l'URL de redirection. Les valeurs des paires nom-valeur ajoutée sont les identificateurs des objets OrderQuotationRel vérifiés qui n'ont pas encore de commande enfant mais dont les valeurs d'attribut timeoutTime sont inférieures à la durée actuelle. Ce paramètre peut être utilisé plusieurs fois.
- outWaitOrderQuotationRelIdName
- Définit les paires nom-valeur à ajouter à l'URL de redirection. Les valeurs des paires nom-valeur ajoutées sont les identificateurs des objets OrderQuotationRel vérifiés qui ont une commande enfant mais dont les valeurs d'attribut timeoutTime ne sont pas inférieures à la durée actuelle. Ce paramètre peut être utilisé plusieurs fois.
- okURL
- Spécifie l'URL de redirection qui est renvoyée si des commandes enfant existent pour tous les objets OrderQuotationRel vérifiés. Ce paramètre est obligatoire.
- waitURL
- Spécifie l'URL de redirection qui est renvoyée si certains des objets OrderQuotationRel vérifiés n'ont pas encore de commandes enfant, mais qu'aucun d'entre eux n'a de durée de délai d'attente timeoutTime inférieure à la durée actuelle. La valeur de ce paramètre est définie par défaut sur la valeur du paramètre okURL.
- timeoutURL
- Spécifie l'URL de redirection qui est renvoyée si certains des objets OrderQuotationRel vérifiés n'ont pas encore de commandes enfant, mais ont une durée de délai d'attente timeoutTime inférieure à la durée actuelle. La valeur de ce paramètre est définie par défaut sur la valeur du paramètre waitURL.
- errorURL
- Spécifie l'URL de redirection qui est renvoyée si certains des objets OrderQuotationRel vérifiés indiquent qu'un statut d'erreur a été renvoyé à partir du système externe demandé pour fournir des informations de devis inférieures à la durée actuelle. Ce paramètre est facultatif.
Exemple 1
L'exemple suivant vérifie les réponses à une précédente requête de devis initiaux pour le panier de actuel. Il redirige vers l'une des quatre URL différentes, selon que
- Certaines réponses ont indiqué qu'une erreur s'est produite
- Toutes les réponses ont été reçues sans erreur
- Certaines réponses n'ont pas été reçues et leurs valeurs de délai d'attente ont été dépassées
- Certaines réponses n'ont pas encore été reçues, mais aucune n'a encore expiré
Les identificateurs des objets OrderQuotationRel qui ont été reçus, qui ont expiré ou sont toujours en attente sont renvoyés dans les propriétés de réponse receivedRelIds, timedoutRelIds et waitingRelIds.
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
Exemple 2
L'exemple suivant vérifie les réponses à une précédente requête de devis finaux pour le panier de magasin avec l'identificateur de commande 1234. Sinon, c'est la même chose que l'exemple 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
Comportement
- Si le paramètre errorURL a été spécifié et que certains des objets OrderQuotationRel spécifiés indiquent qu'un statut d'erreur a été renvoyé à partir du système externe demandé pour fournir des informations de devis, redirigez vers l'URL spécifiée par le paramètre errorURL.
- Sinon, si tous les objets OrderQuotationRel spécifiés indiquent une commande enfant, redirigez vers l'URL spécifiée par le paramètre okURL.
- Sinon, si certains des objets OrderQuotationRel spécifiés n'ont pas de commande enfant mais ont une durée de délai d'attente inférieure à la durée actuelle, redirigez vers l'URL spécifiée par le paramètre timeoutURL.
- Sinon, redirigez vers l'URL spécifiée par le paramètre waitURL.
- Ajoutez des paires nom-valeur aux propriétés de réponse spécifiées par les paramètres outOkOrderQuotationRelIdName, outTimeoutOrderQuotationRelIdName et outWaitOrderQuotationRelIdName.
- Si certains des objets OrderQuotationRel spécifiés indiquent un statut d'erreur, ajoutez des paires nom-valeur aux propriétés de réponse. Les noms des paires nom-valeur sont "failOrderQuotationRelId", et les valeurs sont les identificateurs de ces objets OrderQuotationRel.
Conditions d'exception
- Si la valeur du paramètre d'entrée spécifié est manquante ou non valide, la commande lance une ECApplicationException avec un message d'erreur _ERR_BAD_MISSING_CMD_PARAMETER et une vue d'erreur GenericApplicationError.