Instruction OrderItemUpdate

Cette instruction peut effectuer toutes les opérations réalisées par OrderItemAdd (en d'autres termes, ajouter des produits et des articles dans une ou plusieurs commandes de la liste). Elle peut également mettre à jour les articles (OrderItems) d'une commande existante.

osoiupda.gif (15097 octets)

Valeur des paramètres

http://host_name/path/
(Obligatoire) Nom qualifié complet de votre serveur WebSphere Commerce Server et chemin de configuration
forUser
ID de connexion de l'utilisateur au nom duquel l'instruction est exécutée. Seule une personne disposant des droits de traitement des commandes peut spécifier ce paramètre.
forUserId
Identique à forUser, mais identifie l'utilisateur par l'ID d'utilisateur interne, tel qu'il est indiqué dans la table USERS.
langId
Définit ou restaure la langue préférée pour la durée de la session ; les langues prises en charge pour un magasin figurent dans la table STORELANG.
URL
(Obligatoire) URL devant être lancée lorsque l'instruction aboutit.
orderItemId_i
Identificateur de l'article de commande à mettre à jour. S'il est spécifié, alors les paramètres catEntryId_i et partNumber_i (pour la même valeur de i) sont ignorés.
storeId
Le numéro de référence de magasin, obligatoire uniquement si vous souhaitez ajouter des produits ou des articles aux commandes. Le paramètre storeId est obligatoire pour vérifier si l'article est disponible en magasin. Une fois que vous avez spécifié le paramètre storeId, il est placé dans la mémoire pour une utilisation ultérieure.
catEntryId_i
Identificateur d'une entrée de catalogue à utiliser pour créer un nouvel article de commande.
partNumber_i
Si ce paramètre est précisé, catEntryId_i est ignoré. Si les paramètres partNumber_i et memberId_i sont précisés, ils déterminent une entrée de catalogue en sélectionnant les colonnes PARTNUMBER et MEMBER_ID dans la table CATENTRY. Cette instruction fonctionne comme si l'identificateur de l'entrée de catalogue était considéré comme la valeur de catEntryId_i.
memberId_i
Identificateur du membre qui possède le catalogue concerné par la commande.
attrName_i
Tout attribut distinct défini pour l'article.
attrValue_i
Valeur de l'attribut dans attrName.
quantity_i
Quantité de l'article à ajouter à la commande. Ce paramètre est obligatoire lorsque sont spécifiés les paramètres catEntryId_i ou partNumber_id. Il est facultatif lorsque OrderItemId_i est spécifié.
UOM_i
Unité de mesure pour quantity_i. Cette valeur doit correspondre à une des clés principales de la table QTYUNIT. Lorsqu'elle n'est pas précisée, c'est la valeur de la colonne QUANTITYMEASURE de la table CATENTSHIP pour la rangée ayant la même valeur CATENTRY_ID que l'OrderItem qui est utilisée, et la valeur du paramètre quantity_i est multipliée par la colonne NOMINALQUANTITY de la même rangée dans la table CATENTSHIP.
addressId_i
Identificateur de l'adresse d'expédition des produits et articles.
shipModeId_i
Numéro de référence du mode d'expédition utilisé pour le produit ou l'article.
comment_i
Commentaire à associer aux articles de commande créés ou mis à jour.
contractId_i
ID du contrat associé à la commande.
field1_i
Valeur entière réservée au magasin.
field2_i
Valeur de type texte réservée au magasin. Ce paramètre peut contenir 254 caractères au maximum.
offerId_i
ID d'offre associée à la commande.
orderId
Identificateur généré de manière interne qui spécifie zéro ou plusieurs articles pour une mise à jour, à l'aide des références de commande ou de l'une des abréviations "**", ".", "*", ".t", "*t". Reportez-vous à la rubrique Abréviations de commande pour obtenir une description de ces abréviations.  Une nouvelle commande en attente est créée s'il n'en existe pas pour un magasin particulier.  Si plusieurs commandes en attente sont spécifiées, les entrées d'article sont créées ou mises à jour pour chacune des commandes spécifiées.
outOrderName
Indique les noms des combinaisons nom-valeur à ajouter à l'URL de réacheminement. Les valeurs des combinaisons nom-valeur sont les références des commandes créées ou mises à jour.
outOrderItemName
Indique les noms des combinaisons nom-valeur à ajouter à l'URL de réacheminement. Les valeurs des combinaisons nom-valeur ajoutées sont les références des articles créés ou mis à jour.
listId
ID de la liste d'articles. Lorsque vous spécifiez ce paramètre, l'instruction OrderItemUpdate crée une nouvelle commande contenant tous les articles de la liste. Vous pouvez utiliser l'une de ces abréviations spéciales : ".t", et "*". Reportez-vous à la rubrique Abréviations de commande pour obtenir une description.
orderDesc
Spécifie la description de la nouvelle commande créée par cette instruction.
remerge
Liste des OrderItems qui doivent être fusionnés avec d'autres OrderItems de la même commande et avec le même attribut correlationGroup, si cela est possible. Les OrderItems ne fusionnent pas, à moins que leur InventoryStatus ne soit "NALC", ou qu'ils soient spécifiés par un ou plusieurs paramètres tels que allocate, backorder et reverse.
merge
Liste des OrderItems qui doivent être fusionnés avec d'autres OrderItems de la même commande si possible, sans distinction d'attributs correlationGroup.
check
Liste des OrderItems qui doivent être contrôlés par l'instruction d'activité CheckInventoryAvailability.
allocate
Liste des OrderItems qui doivent être attribués à partir d'un stock existant.
backorder
Liste des OrderItems qui doivent être attribués à partir d'un stock prévu lorsqu'ils ne sont pas attribués à partir d'un stock existant.
reverse
Liste des OrderItems dont les attributions doivent être préparées (en d'autres termes, les attributions doivent être retirées du stock existant ou prévu concerné).
configurationId_i
Si l'OrderItem représente un kit dynamique configuré, c'est l'ID de configuration.

Remarque : les paramètres remerge, merge, check, allocate, backorder et reverse sont applicables uniquement si le stock ATP est activé (voir la colonne ALLOCATIONGOODFOR dans la table STORE). Ils représentent les listes d'articles de commande (OrderItems) qui seront transmises à l'instruction AllocateInventory, qui appelle les instructions CheckInventoryAvailability, AllocateExistingInventory, AllocateExpectedInventory, DeallocateExistingInventory et DeallocateExpectedInventory, comme indiqué ci-après. Ces paramètres acceptent également les abréviations d'OrderItem, qui sont présentées en détails dans la rubrique d'aide Instructions du sous-système commandes.

Les valeurs par défaut des paramètres ATP sont les suivantes :

Exemple 1
L'exemple ci-après crée un enregistrement pour l'expédition d'un exemplaire d'une entrée de catalogue portant le numéro de référence 18 et un attribut de monogramme CJK. Cet enregistrement de livraison s'ajoute aux commandes courantes en attente du client. L'instruction OrderItemDisplay est appelée lorsque cette instruction aboutit.
    http://myhostname/webapp/wcs/stores/servlet/OrderItemUpdate?addressId=2
    &catEntryId=18&attrName=monogram&attrValue=CJK&quantity=1&shipModeId=4
    &URL=OrderItemDisplay

Exemple 2
L'exemple suivant ajoute dix unités du produit portant le numéro de référence 2 à toutes les commandes du client actuellement en attente. L'instruction OrderItemDisplay est appelée lorsque cette instruction aboutit.
    http://myhostname/webapp/wcs/stores/servlet/OrderItemUpdate?catEntryId=2
    &quantity=10&orderId=*&outOrderName=orderId&URL=/webapp/wcs/stores/servlet/OrderItemDisplay

Exemple 3
L'exemple ci-après met à jour trois ID d'OrderItem.
    http://myhostname/webapp/wcs/stores/servlet/OrderItemUpdate?URL=OrderItemDisplay
    &quantity_1=2&quantity_2=7&orderItemId_1=117&orderItemId_2=118
    &orderItemId_3=113&quantity_3=2

Comportement

Conditions d'exception

Rubriques connexes

Référence connexe

IBM copyright