Befehl 'DynamicKitConfigurationAdd'

Dieser Befehl konfiguriert dynamische Kits. Ein Kit enthält mehrere Artikel, wird als Einheit bestellt und zurückgegeben und hat einen Preis und eine Artikelnummer. Die Informationen zu den Artikeln in einem dynamischen Kit werden von einem externen Konfigurationsprogramm gesteuert.

Es gibt Methoden zum Aufrufen dieses Befehls: über URL-Parameter oder über eine XML-Datei. Die Methoden schließen sich nicht gegenseitig aus, sondern können parallel verwendet werden. Die Werte in der XML-Datei haben dabei immer Vorrang.

osdyncfgx.gif (3955 Byte)

Parameterwerte bei Aufruf per XML

http://host_name/pfad/
(Obligatorisch) Der vollständig qualifizierte Name Ihres WebSphere Commerce Servers und der Konfigurationspfad.
xmlConfiguration
Eine XML-Datei, die definiert, wie der dynamische Kit konfiguriert werden soll. Die XML-Datei sollte die folgende DTD-Datei (productConfiguration.dtd) verwenden. Sie definiert die XML-Datei, die bei Aufruf per URL verwendet werden sollte: 

<!ELEMENT Configuration (ComponentList)>
<!ATTLIST Configuration
ConfigurationId CDATA #REQUIRED
ReferenceId CDATA #IMPLIED
ConfiguratorURL CDATA #IMPLIED
WCSURL CDATA #IMPLIED
DynamicKitId CDATA #IMPLIED>
<!ELEMENT ComponentList (Component+)>
<!ATTLIST ComponentList
Currency CDATA #IMPLIED>
<!ELEMENT Component EMPTY>
<!ATTLIST Component
WCSItemId CDATA #IMPLIED
WCSPartNumber CDATA #IMPLIED
MemberId CDATA #IMPLIED
Quantity CDATA #REQUIRED
UnitPrice CDATA #IMPLIED>

Nachfolgend ein Beispiel für eine XML-Datei:

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE Configuration SYSTEM "productConfiguration.dtd">
<Configuration ConfigurationId = "250" DynamicKitId = "15555">
<ComponentList Currency = "CAD">
<Component WCSItemId = "1111" Quantity = "5" UnitPrice = "50.00"/>
<Component WCSPartNumber = "ABC-1112" MemberId = "15" Quantity = "6" UnitPrice = "55.00"/>
<Component WCSItemId = "1113" Quantity = "7" UnitPrice = "60.00"/>
</ComponentList>
</Configuration>

URL
(Obligatorisch) Die URL-Adresse, die nach der erfolgreichen Ausführung des Befehls aufgerufen werden soll.

Parameterwerte bei Aufruf per URL-Datei

http://host_name/pfad/
Der vollständig qualifizierte Name Ihres WebSphere Commerce-Servers und der Konfigurationspfad.
configurationId
(Obligatorisch) Die eindeutige Konfigurations-ID der Konfiguration.
catEntryId
(Obligatorisch) Die ID des Katalogeintrags des dynamischen Kits.
currency
Die Währung, in der die Preise der Komponenten des dynamischen Kits angegeben werden.
URL
(Obligatorisch) Die URL-Adresse, die nach der erfolgreichen Ausführung des Befehls aufgerufen werden soll.
componentId
(Nur erforderlich, wenn partNumber nicht angegeben wird) Die ID des Katalogeintrags, der eine Komponente des dynamischen Kit ist. Dieser Wert ist optional; wird er jedoch nicht angegeben, muss ein Wert für den Parameter partNumber angegeben werden.
partNumber
(Nur erforderlich, wenn componentID nicht angegeben wird)  Die Teilenummer des Katalogeintrags, der eine Komponente des dynamischen Kit ist. Dieser Wert ist optional; wird er jedoch nicht angegeben, muss ein Wert für den Parameter componentID angegeben werden. 
memberId
Wenn ein Wert für partNumber angegeben wird, ist dies die Member-ID, die zur Ermittlung des Kalogeintrags im eindeutigen Index aus partNumber + memberId verwendet wird. Dieser Wert ist optional, wenn ein Wert für partNumber angegeben wird. Wenn keine Member-ID angegeben wird, wird die Member-ID der Organisation des aktuellen Geschäfts verwendet, um den Katalogeintrag im eindeutigen Index aufzulösen.
quantity
(Obligatorisch) Die Menge der Komponente im dynamischen Kit.
price
Der Preis dieser Komponente. Dieser Wert ist optional; wenn jedoch für eine Komponente ein Preis angegeben wird, ist auch für alle anderen Komponenten ein Preis erforderlich.

Beispiel
Das folgende Beispiel beschreibt eine Konfiguration mit der ID 250 für ein dynamisches Kit mit der Katalogeintrags-ID 15555. Die Komponenten der Konfiguration sind drei WebSphere Commerce-Artikel: 1111, "ABC-1112" und 1113. Die Artikel weisen folgende Mengen und Stückpreise auf:

http://myhostname/webapp/wcs/stores/servlet/DynamicKitConfigurationAdd?
&configurationId=250&catEntryId=15555&componentId=1111&quantity=5&price=50
&componentId=ABC-1112&quantity=6&price=55&componentId=1113&quantity=7&price=60

Verhalten
Konfiguriert dynamische Kits.

Ausnahmebedingungen
Keine.

Verwandte Konzepte

Verwandte Referenzen

IBM Copyright