Comando InterestItemAdd
Tale comando al livello sito aggiunge uno o più prodotti, o SKU, o entrambi, in uno o più elenchi articoli di interesse.
Utilizzare questo comando con SSL (Secure
Sockets Layer) per verificare che la password di accesso e le informazioni personali siano codificate. Per fare ciò, digitare il comando con il protocollo di sicurezza HTTPS.

Valori dei parametri
- http://nome_host/path/
-
Il nome completo di WebSphere Commerce Server e il percorso di configurazione
- langId
- Imposta o reimposta la lingua prescelta per la durata della sessione.
Le lingue supportate per un negozio si trovano nella tabella STORELANG.
- 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.
- URL
- L'URL da richiamare quando il comando viene completato con esito positivo.
- storeId
- Il numero di riferimento del negozio associato ad una voce di catalogo tramite il quale viene eseguito tale comando.
- catEntryId_i
-
Il numero di riferimento della voce di catalogo da aggiungere all'elenco degli articoli interesse.
- attrName_i
-
Qualsiasi ID di riferimento attributo definito nella tabella ATTRVALUE per la voce di catalogo
- attrValue_i
-
Le colonne STRINGVALUE o INTEGERVALUE dell'attributo, definito nella tabella ATTRVALUE, per la voce di catalogo
- listId
-
Il numero di riferimento dell'elenco articoli di interesse; abbreviazioni può essere utilizzato:
- Se una determinata voce di catalogo non esiste più, non viene aggiunta.
- Se questo parametro risulta mancante, il comando funziona come se "." fosse stato specificato.
- Se il parametro prova ad aggiungere una voce di catalogo all'elenco già esistente,il risultato dipende dall'impostazione del parametro da aggiornare.
- Se viene specificato ".", il comando GetCurrentIIListsCmd viene utilizzato per ottenere l'elenco articoli di interesse, per cui il comando funziona come se questo elenco fosse stato specificato.
Se il comando di attività GetCurrentIIListsCmd stabilisce che non esiste alcun elenco articoli di interesse, viene utilizzato l'elenco più aggiornato.
Se non è presente alcun elenco, l'attività ne crea uno nuovo.
- Se viene specificato "*", il comando funziona come se fossero stati specificati tutti gli elenchi articoli di interesse.
- listIdName
- Al termine di questo comando, se viene effettuato un reindirizzamento per poter eseguire un secondo comando, listIdName specifica il nome del parametro del secondo comando, in cui verrà utilizzato il valore del parametro listId del primo comando. Spesso il secondo comando contiene anche un parametro listId per cui &listIdName=listId
- quantity_i
- La quantità dell'articolo. Il valore predefinito è 1.
- UOM_i
- L'unità di misura. IL valore predefinito viene associato al negozio.
- field1_i, field2_i, field3_i
- Il valore memorizzato nelle colonne riservate al negozio FIELD1, FIELD2 e FIELD3 della tabella IITEM.
- updateable_i
- Cosa fare quando un comando richiede di aggiungere una voce di catalogo in un elenco e la voce è già presente in tale elenco:
- 1=Aggiorna la voce
- 0=Emette un'eccezione
- Non specificato=Assegna valore predefinito 1
Esempio
L'esempio seguente aggiunge la versione di lusso della voce di catalogo, con riferimento numero 9, venduta dal negozio con riferimento numero 1, all'ordine corrente del cliente, quindi richiama il comando InterestItemDisplay. Nell'esempio si assume che il
numero 3 sia l'ID di attributo valido per la voce e che abbia un valore attributo di
"lusso" definito nella tabella ATTRVALUE.
https://host_name/webapp/wcs/stores/servlet/InterestItemAdd?storeId=1&catEntryId=9
&URL=/webapp/commerce/InterestItemDisplay&attrName=3&attrValue=deluxe
Azione
- Il comando richiama l'operazione GetCurrentIIListsCmd quando il parametro listId
viene specificato come ".", oppure omesso, per determinare in quale elenco articoli di interesse vanno aggiunte le voci di catalogo.
- Il comando di attività AuthIIListAccessCmd
viene richiamato per controllare i permessi di scrittura per ciascun elenco di voci d'interesse specificato.
- Richiama il comando ResolveSkuCmd per determinare la SKU per la voce di catalogo.
- Assicurarsi che la voce di catalogo da visualizzare non sia un membro di un prodotto
che è stato escluso dal contratto dell'utente corrente.
- Aggiunge la voce di catalogo alla tabella IITEM.
- Completata l'operazione con esito positivo, viene richiamato l'URL specificato.
- Normalizza e arrotonda la quantità in base all'unità di misura.
Condizioni di errore
- Se il comando di errore assegnato all'attività AuthIIListAccessCmd non riesce, il comando imposta l'attività di eccezione AuthIIListAccesErr
per gestire l'errore.
- Se il comando di errore assegnato al comando di attività ResolveSkuCmd rileva che un attributo di prodotto richiesto risulta mancante, il comando imposta l'attività di eccezione ProductAttributeErrorView per gestire l'errore. Se il comando rileva che un prodotto con gli attributi
specificati non esiste nel database, viene impostata la stessa attività di eccezione ProductAttributeErrorView per gestire l'errore.