Comando DynamicKitConfigurationAdd

Questo comando consente di configurare kit dinamici. Un kit contiene più articoli, viene ordinato e restituito come un'unica unità ed ha un prezzo unico ed un'unica SKU. Le informazioni relative agli articoli contenuti in un kit dinamico vengono controllate da un configuratore esterno. 

Esistono due metodi per richiamare questo comando: mediante un file XML oppure mediante i parametri URL. Tali metodi non sono esclusivi e pertanto è possibile utilizzarli insieme. Tuttavia, i valori all'interno del file XML hanno la precedenza.

osdyncfgx.gif (3955 byte)

Valori del parametro se si utilizza il metodo di richiamo XML

http://host_name/path/
(Obbligatorio) Il nome completo del WebSphere Commerce Server e il percorso di configurazione.
xmlConfiguration
Un file XML che definisce come il kit dinamico deve essere configurato. Il file XML deve utilizzare il seguente file DTD (productConfiguration.dtd), che definisce il file XML che deve essere utilizzato con il metodo di richiamo 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>

Di seguito viene riportato un file XML di esempio:

<?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
(Obbligatorio) L'URL da richiamare quando il comando viene eseguito correttamente.

Valori del parametro se si utilizza il metodo di richiamo del file URL

http://nome_host/percorso/
Il nome completo di WebSphere Commerce Server ed il percorso di configurazione
configurationId
(Obbligatorio) L'ID di configurazione univoco che rappresenta la configurazione.
catEntryId
(Obbligatorio) L'ID della voce di catalogo del kit dinamico.
valuta
La valuta mediante la quale vengono forniti i prezzi dei componenti di un kit dinamico.
URL
(Obbligatorio) L'URL da richiamare quando il comando viene eseguito correttamente.
componentId
(Obbligatorio soltanto se non viene fornito partNumber) L'ID della voce di catalogo che rappresenta un componente del kit dinamico. Questo valore è facoltativo, tuttavia se non viene specificato, deve essere fornito il parametro partNumber.
partNumber
(Obbligatorio soltanto se non viene fornito componentId)  Il numero di parte della voce di catalogo che rappresenta un componente del kit dinamico. Questo valore è facoltativo, tuttavia se non viene specificato, deve essere fornito il parametro componentId. 
memberId
Se viene fornito un valore per partNumber allora questo è l'ID membro utilizzato per determinare la voce di catalogo dall'indice univoco partnumber+memberid. Questo valore è facoltativo se viene fornito un valore per partNumber. Se non viene fornito alcun ID membro, allora l'ID membro dell'organizzazione del negozio corrente viene utilizzata per risolvere la voce di catalogo dall'indice univoco.
quantità
(Obbligatorio) Il numero di questo componente all'interno del kit dinamico.
price
Il prezzo del componente. Questo valore è facoltativo, tuttavia, se viene fornito il prezzo per un componente, allora è necessario fornire un prezzo per tutti gli altri componenti.

Esempio
Il seguente esempio descrive una configurazione 250 per un kit dinamico con catentryId 15555. I componenti della configurazione sono tre articoli di WebSphere Commerce: 1111, "ABC-1112" e 1113. Le quantità ed i prezzi unitari di ciascuno sono i seguenti:

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

Azione
Configura kit dinamici.

Condizioni di eccezione
Nessuna.

Argomenti correlati

Riferimento correlato

IBM copyright