Befehl 'OrderItemAdd'

Dieser Befehl fügt der Liste der Artikel weitere Artikel oder Produkte hinzu, die ausgeliefert werden sollen. 

osoiadd.gif (14233 Byte)

Parameterwerte

http://host_name/pfad/
(Obligatorisch) Der vollständig qualifizierte Name Ihres WebSphere Commerce Servers und der Konfigurationspfad.
forUser
Die Anmelde-ID des Benutzers in dessen Namen der Befehl ausgeführt wird; nur eine Person mit der Berechtigung, Bestellungen verarbeiten zu können, kann diesen Parameter angeben.
forUserId
Identisch mit "forUser"; hier wird jedoch der Benutzer mit einer internen Benutzer-ID identifiziert, wie in der Tabelle USERS angegeben.
langId
Setzt die bevorzugte Sprache für die Dauer der Sitzung oder setzt die bevorzugte Sprache zurück; die unterstützten Sprachen sind in der Tabelle STORELANG enthalten.
URL
(Obligatorisch) Die URL-Adresse, die nach der erfolgreichen Ausführung des Befehls aufgerufen werden soll.
storeId
(Obligatorisch) Die Referenznummer des Geschäfts; diese ist obligatorisch, da Sie nicht in einem Einkaufszentrum einkaufen können
catEntryId_i
(Obligatorisch) Die Referenznummer des Artikels, das in die Bestellung aufgenommen werden soll
partNumber_i
Wenn dieser Parameter angegeben ist, wird der Parameter 'catEntryId' ignoriert.  Die Parameter 'partNumber' und 'memberId' ermitteln eine 'catentry_id' durch Auswählen von PARTNUMBER und MEMBER_ID in der Tabelle CATENTRY, und dieser Befehl verhält sich, als wäre diese Referenznummer als Wert für 'catEntryId' angegeben worden.
memberId_i
Die Kennung für das Mitglied, das der Eigner des Katalogs ist, in dem die Bestellung platziert wird.
attrName_i
Ein beliebiges eindeutiges Attribut, das für den Artikel definiert ist.
attrValue_i
Der Wert des Attributs in 'attrName'.
quantity_i
(Obligatorisch) Die Menge des der Bestellung hinzuzufügenden Artikels.
UOM_i
Die Maßeinheit für 'quantity_i'. Dieser Wert muss mit einem der Primärschlüssel in der Tabelle QTYUNIT übereinstimmen. Wenn dieser Parameter nicht angegeben wird, wird der Wert der Spalte QUANTITYMEASURE in der Tabelle CATENTSHIP für die Zeile verwendet, deren CATENTRY_ID mit dem Bestellartikel übereinstimmt, und der Wert des Parameters 'quantity_i' wird mit der Spalte NOMINALQUANTITY derselben Zeile in der Tabelle CATENTSHIP multipliziert.
addressId_i
Die Referenznummer der Adresse, an die die Produkte und Artikel versendet werden.
shipModeId_i
Die Referenznummer des Versandmodus, nach dem das Produkt oder der Artikel versendet werden soll.
comment_i
Ein Kommentar, der in die erstellten oder aktualisierten Bestellartikel aufgenommen werden soll.
contractId_i
Die Kennung des Vertrags für die Bestellung, der der Artikel hinzugefügt wird. Es gibt für jedes Geschäft einen Standardvertrag; Sie können jedoch weitere Verträge einrichten
field1_i
Ein für das Geschäft reservierter ganzzahliger Wert.
field2_i
Ein für das Geschäft reservierter Textwert. Dieser Parameter kann maximal 254 Zeichen enthalten.
offerId_i
Die Kennung des Angebots für die Bestellung, der der Artikel hinzugefügt wird.
orderId
Die Kennung der Bestellung, der der Artikel hinzugefügt wird.
outOrderName
Gibt die Namen der Referenznummern der erstellten bzw. aktualisierten Bestellungen an, die der Umleitungs-URL hinzugefügt werden sollen.  Verwenden Sie diesen Parameter und 'outOrderItemName' beim Verketten von Befehlen.  
outOrderItemName
Die Namen der Referenznummern der erstellten bzw. aktualisierten Bestellartikel, die der Umleitungs-URL hinzugefügt werden sollen.
listId
Die Kennung der Liste interessanter Artikel. Wenn Sie diesen Parameter angeben, erstellt der Befehl 'OrderItemAdd' eine neue Bestellung, die alle Artikel in der Liste enthält.
orderDesc
Gibt die Beschreibung der Bestellung für eine von diesem Befehl erstellte neue Bestellung an.
remerge
Eine Liste der OrderItems (Bestellartikel), die (wenn möglich) mit anderen OrderItems in derselben Bestellung und mit dem gleichen Attribut 'correlationGroup' zusammengefügt werden sollen. OrderItems werden nur zusammengefügt, wenn ihr Lagerbestandsstatus "NALC" ist oder wenn sie in einem der Parameter 'allocate', 'backorder' und 'reverse' angegeben werden.
merge
Eine Liste der OrderItems, die (wenn möglich) mit anderen OrderItems in derselben Bestellung - unabhängig vom Attribut 'correlationGroup' - zusammengefügt werden sollen. OrderItems werden nur zusammengefügt, wenn ihr Lagerbestandsstatus "NALC" ist oder wenn sie in einem der Parameter 'allocate', 'backorder' und 'reverse' angegeben werden.
check
Eine Liste der OrderItems, die vom Task-Befehl 'CheckInventory' geprüft werden sollen.
allocate
Eine Liste der OrderItems, die mit dem Task-Befehl 'AllocateExistingInventory' aus dem bestehenden Lagerbestand zugeordnet werden sollen.
backorder
Eine Liste der OrderItems, für die mit dem Task-Befehl 'AllocateExpectedInventory' ein Lieferrückstand erstellt werden soll. Wenn die Parameter 'allocate' und 'backorder' denselben OrderItem angeben, wird kein Lieferrückstand erstellt, wenn eine Lagerbestandszuordnung möglich ist.
reverse
Eine Liste der OrderItems, deren Zuordnungen freigegeben werden sollen (d. h. deren Zuordnung aus dem vorhandenen oder erwarteten Lagerbestand rückgängig gemacht werden soll), indem der Task-Befehl 'DeallocateExistingInventory' bzw. 'DeallocateExpectedInventory' aufgerufen wird.
configurationId_i
Wenn der Bestellartikel ein konfiguriertes dynamische Kit ist, ist dies die Konfigurations-ID.

Hinweis: Die Parameter 'remerge', 'merge', 'check', 'allocate', 'backorder' und 'reverse' sind nur dann anwendbar, wenn ATP-Lagerbestandzuordnung aktiviert ist (siehe die Spalte ALLOCATIONGOODFOR in der Tabelle STORE). Sie stellen Listen von OrderItems (Bestellartikeln) dar, die an den Task-Befehl 'AllocateInventory' weitergegeben werden, der wiederum die Task-Befehle 'CheckInventoryAvailability', 'AllocateExistingInventory', 'AllocateExpectedInventory', 'DeallocateExistingInventory' und 'DeallocateExpectedInventory' wie unten angegeben aufruft. Darüber hinaus akzeptieren diese Parameter OrderItem-Abkürzungen, die in der Hilfe für die Befehle des Bestellsubsystems detailliert beschrieben sind.

Folgendes sind die ATP-Standardparameterwerte:

Beispiel 1
Im folgenden Beispiel werden drei Einheiten des Produkts mit der Referenznummer 24 allen aktuellen anstehenden Bestellungen des Kunden (die unter dem Geschäft erstellt wurden, das Katalogeintrag 24 verkauft) hinzugefügt, und diese Produkte sollen an die Adresse geliefert werden, die der Adressreferenznummer 2 entspricht. Anschließend wird der Befehl OrderItemDisplay aufgerufen.
     http://myhostname/webapp/wcs/stores/servlet/OrderItemAdd?addressId=2
     &URL=/webapp/wcs/stores/servlet/OrderItemDisplay&catEntryId=24&quantity=3

Beispiel 2
Im folgenden Beispiel werden zehn Einheiten des Katalogs mit der Referenznummer 2 der neuen Bestellung des aktuellen Kunden hinzugefügt. Der Parameter 'orderId' wird der Umleitungs-URL hinzugefügt, wobei 'value' die Referenznummer der erstellten Bestellung ist. Anschließend wird der Befehl 'OrderItemDisplay' aufgerufen.
     http://myhostname/webapp/wcs/stores/servlet/OrderItemAdd?catEntryId=2&quantity=10
     &orderId=**&outOrderName=orderId&URL=/webapp/wcs/stores/servlet/OrderItemDisplay

Beispiel 3
Bei diesem Beispiel wird ein Bundle hinzugefügt, das aus den folgenden Elementen besteht:
Artikel 312200001
Artikel 312200301
Produkt 312200200 mit Attribut 312200201
     http://myhostname/webapp/wcs/stores/servlet/OrderItemAdd?catEntryId_1=312200001
     &quantity_1=1&shipModeId_1=1&catEntryId_2=312200301&quantity_2=1
     &shipModeId_2=1&catEntryId_3=312200200&attrName_3=312200201
     &attrValue_3=Value+2200200+1&quantity_3=1&shipModeId_3=1&URL=OrderItemDisplay

Beispiel 4
Im folgenden Beispiel werden zwei Produkte mit mehreren Attributen zu einem Einkaufskorb hinzugefügt, wobei der erste Katalogeintrag über zwei Attribute und der zweite Katalogeintrag über drei Attribute verfügt:          http://myhostname/webapp/wcs/stores/servlet/OrderItemAdd?catEntryId_1=111&attrName_1=1
&attrValue_1=a&attrName_1=2&attrValue_1=b&quantity_1=1&catEntryId_2=222&attrName_2=21
&attrValue_2=aa&attrName_2=22&attrValue_2=bb&attrName_2=33&attrValue_2=cc&quantity_2=1
&URL=OrderItemDisplay

Verhalten

Ausnahmebedingungen

 Verwandte Konzepte

Verwandte Referenzen

IBM Copyright