Instruction DynamicKitConfigurationAdd

Cette instruction affiche les kits dynamiques. Un kit contient plusieurs produits, est commandé puis renvoyé comme une unité et n'a qu'un seul prix et qu'un seul SKU. Les informations relatives aux produits qui constituent un kit dynamique sont contrôlées par un configurateur externe. 

Il existe deux méthodes pour appeler cette instruction : par l'intermédiaire des paramètres d'URL ou d'un fichier XML. Elles ne sont pas exclusives, si bien que les deux méthodes peuvent être utilisées ensemble. Les valeurs du fichier XML ont la priorité sur celles des paramètres de l'URL.

osdyncfgx.gif (3955 octets)

Valeurs des paramètres en cas d'utilisation de la méthode d'appel par le fichier XML

http://host_name/path/
(Obligatoire) Nom qualifié complet et chemin de configuration de votre serveur WebSphere Commerce Server
xmlConfiguration
Fichier XML qui définit la manière dont le kit dynamique doit être configuré. Il doit utiliser le fichier DTD productConfiguration.dtd, qui définit le fichier XML devant être utilisé avec la méthode d'appel URL :

<!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>

Voici un exemple de fichier XML :

<?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
(Obligatoire) URL devant être lancée lorsque l'instruction aboutit.

Valeurs des paramètres en cas d'utilisation de la méthode d'appel par le fichier URL

http://nom_hôte/chemin/
Nom qualifié complet de WebSphere Commerce Server et chemin de configuration.
configurationId
(Obligatoire) ID de configuration unique qui représente cette configuration.
catEntryId
(Obligatoire) ID de l'entrée de catalogue du kit dynamique.
currency
Devise dans laquelle les prix des composants du kit dynamique sont proposés.
URL
(Obligatoire) URL devant être lancée lorsque l'instruction aboutit.
componentId
(Obligatoire uniquement si le paramètre partNumber n'est pas fourni) ID de l'entrée de catalogue qui représente un composant du kit dynamique. Cette valeur est facultative ; toutefois, si cette valeur n'est pas précisée, elle doit être fournie pour le paramètre partNumber.
partNumber
(Obligatoire uniquement si le paramètre componentId n'est pas fourni)  Numéro de référence de l'entrée de catalogue qui représente un composant du kit dynamique. Cette valeur est facultative ; toutefois, si cette valeur n'est pas précisée, elle doit être fournie pour le paramètre componentId. 
memberId
Si une valeur pour le paramètre partNumber est précisée, il s'agit alors de l'ID membre utilisé pour déterminer le catentry à partir de l'index à entrée unique partnumber+memberid. Cette valeur est facultative si une valeur pour le paramètre partNumber est précisée. Si aucun ID membre n'est précisé, c'est celui de l'entreprise du magasin actuel qui est utilisé pour convertir le catentry à partir de l'index à entrées uniques.
quantity
(Obligatoire) Numéro de ce composant dans le kit dynamique.
price
Prix de ce composant. Cette valeur est facultative ; toutefois, si le prix est fourni pour l'un des composants, un prix est également requis pour les autres composants.

Exemple
L'exemple suivant décrit une configuration 250 pour un kit dynamique avec catentryId 15555. Les éléments de la configuration sont trois articles de WebSphere Commerce : 1111, "ABC-1112", et 1113. Les quantités et les prix unitaires pour chacun sont indiqués comme suit :

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

Comportement
Kits dynamiques de configuration.

Conditions d'exception
Aucune.

Rubriques connexes

Référence connexe

IBM copyright