Comando OrderItemUpdate

Questo comando esegue tutto quello che esegue il comando OrderItemAdd (ovvero aggiunge prodotti e articoli a uno o più ordini all'interno dell'elenco ordini). E' possibile anche aggiornare gli OrderItems in un ordine esistente.

osoiupda.gif (15097 byte)

Valori dei parametri

http://nome_host/percorso/
(Obbligatorio) Il nome completo del WebSphere Commerce Server e il percorso di configurazione.
forUser
L'ID di collegamento dell'utente per conto del quale viene eseguito il comando; solo una persona con l'autorizzazione per elaborare ordini può specificare questo parametro.
forUserId
Come per forUser, ma con identificazione dell'utente mediante l'ID utente interno, come rilevato nella tabella USERS.
langId
Imposta o reimposta la lingua prescelta per la durata della sessione; le lingue supportate per un negozio si trovano nella tabella STORELANG
URL
(Obbligatorio) L'URL da richiamare quando il comando viene eseguito correttamente.
orderItemId_i
L'identificativo di OrderItem da aggiornare. Se specificato, i parametri catEntryId_i e partNumber_i (per lo stesso valore di i) vengono ignorati.
storeId
L'identificativo del negozio, che è obbligatorio solo se si desidera aggiungere agli ordini prodotti o articoli Il valore storeId è necessario per verificare se un articolo è disponibile nel negozio. Una volta specificato il valore storeId, esso viene memorizzato nella cache per gli usi futuri.
catEntryId_i
L'identificativo di una voce di catalogo da utilizzare per creare un nuovo OrderItem.
partNumber_i
Se specificato, il parametro catEntryId_i viene ignorato. Quando vengono specificati i parametri partNumber_i e memberId_i, essi determinano una voce di catalogo selezionando le colonne PARTNUMBER e MEMBER_ID nella tabella CATENTRY. Questo comando funziona come se l'identificativo della voce di catalogo fosse stata specificata come il valore di catEntryId_i.
memberId_i
L'identificativo per il membro proprietario del catalogo in cui verrà effettuato l'ordine.
attrName_i
Qualsiasi attributo definito per l'articolo.
attrValue_i
Il valore dell'attributo in attrName.
quantity_i
La quantità dell'articolo da aggiungere nell'ordine. Questo parametro è necessario quando viene specificato catEntryId_i o partNumber_id. E' facoltativo quando viene specificato OrderItemId_i.
UOM_i
L'unità di misura per quantity_i. Tale valore dovrebbe corrispondere alle chiavi principali nella tabella QTYUNIT. Quando non viene specificato, allora il valore della colonna QUANTITYMEASURE della tabella CATENTSHIP per la riga con lo stesso CATENTRY_ID, viene utilizzato come OrderItem, e il valore del parametro di quantity_i viene moltiplicato tramite la colonnaNOMINALQUANTITY della stessa riga nella tabella CATENTSHIP.
addressId_i
L'identificativo dell'indirizzo cui vengono spediti prodotti e articoli.
shipModeId_i
Il numero di riferimento della modalità di spedizione utilizzata per il prodotto o l'articolo.
comment_i
Un commento da includere negli articoli dell'ordine creati o aggiornati.
contractId_i
L'ID del contratto associato all'ordine.
field1_i
Un valore intero riservato al negozio.
field2_i
Un valore di testo riservato al negozio. Questo parametro accetta fino a 254 caratteri.
offerId_i
L'ID dell'offerta associata all'ordine.
orderId
E' un identificativo creato internamente che specifica zero o più ordini da aggiornare, utilizzando i numeri di riferimento ordine oppure una delle abbreviazioni speciali "**", ".", "*", ".t", "*t". Per una descrizione di queste abbreviazioni, consultare Abbreviazioni ordini. Se non esistono ordini in sospeso per un determinato negozio, ne verrà creato uno nuovo. Se viene specificato più di un ordine in sospeso, verranno create o aggiornate anche le voci presenti nell'ordine per ciascun ordine specificato.
outOrderName
Specifica i nomi delle coppie nome-valore da aggiungere all'URL di reindirizzamento. I valori delle coppie nome-valore aggiunte sono i numeri di riferimento degli ordini creati o aggiornati.
outOrderItemName
Specifica i nomi delle coppie nome-valore da aggiungere all'URL di reindirizzamento. I valori delle  coppie nome-valore aggiunte sono i numeri di riferimento delle voci dell'ordine aggiornate o aggiunte.
listId
L'ID elenco di articoli.  Quando si specifica questo parametro, il comando OrderItemUpdate creerà un nuovo ordine contenente tutti gli articoli presenti nell'elenco. E' possibile utilizzare una delle abbreviazioni speciali "." e "*". Per ulteriori informazioni, consultare la sezione sulle abbreviazioni del catalogo.
orderDesc
Specifica la descrizione per il nuovo ordine creato con questo comando
remerge
Un elenco di OrderItems che devono essere unificati con altri OrderItems nello stesso ordine e con lo stesso attributo correlationGroup, se possibile. OrderItems non sono unificati a meno che InventoryStatus sia "NALC", o non sono specificati da uno o più assegnazioni, backorder e parametri inversi.
merge
Un elenco di OrderItems che devono essere unificati con altri OrderItems nello stesso ordine, indipendentemente dall'attributo correlationGroup.
check
Un elenco di OrderItems che devono essere verificati dal comando attività CheckInventoryAvailability.
allocate
Un elenco di OrderItems che devono essere assegnati da un inventario esistente.
backorder
Un elenco di OrderItems che devono essere assegnati dall'inventario atteso se non vengono assegnati dall'inventario esistente.
reverse
Un elenco di OrderItems le cui assegnazioni devono essere rilasciate (ovvero, deve essere annullata l'assegnazione dell'inventario esistente o atteso).
configurationId_i
Se questo OrderItem rappresenta un Kit dinamico configurato, questo è l'ID di configurazione.

Nota: I parametri remerge, merge, check, allocate, backorder e reverse sono applicabili solo se viene abilitato l'inventario ATP (consultare la colonna ALLOCATIONGOODFOR nella tabella STORE). Essi rappresentano l'elenco degli OrderItem che saranno trasferiti al comando di attività AllocateInventory, che richiama i comandi di attività CheckInventoryAvailability, AllocateExistingInventory, AllocateExpectedInventory, DeallocateExistingInventory e DeallocateExpectedInventory, come specificato di seguito. Inoltre, questi parametri accettano le abbreviazioni di OrderItem, che sono descritte minuziosamente nella guida ai Comandi del sottosistema dell'ordine.

I valori del parametro ATP predefiniti sono i seguenti:

Esempio 1
Il seguente esempio crea un record di spedizione per un'unità della voce di catalogo con numero di riferimento 18 e ha un attributo di monogramma CJK. Questo record di spedizione viene aggiunto agli ordini in sospeso correnti del cliente. Dopo avere eseguito il comando, viene richiamato il comando OrderItemDisplay.
    http://myhostname/webapp/wcs/stores/servlet/OrderItemUpdate?addressId=2
    &catEntryId=18&attrName=monogram&attrValue=CJK&quantity=1&shipModeId=4
    &URL=OrderItemDisplay

Esempio 2
Il seguente esempio aggiunge dieci unità della voce di catalogo numero 2 a tutti gli ordini in sospeso correnti del cliente. Dopo avere eseguito il comando, viene richiamato il comando OrderItemDisplay.
    http://myhostname/webapp/wcs/stores/servlet/OrderItemUpdate?catEntryId=2
    &quantity=10&orderId=*&outOrderName=orderId&URL=/webapp/wcs/stores/servlet/OrderItemDisplay

Esempio 3
Nel seguente esempio vengono aggiornati tre ID 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

Azione

Condizioni di eccezione

Argomenti correlati

Riferimento correlato

IBM copyright