Comando InterestItemListCopy
Questo comando al livello sito crea o aggiorna un elenco articoli di interesse copiando gli articoli da un elenco a un altro.

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 per cui viene eseguito questo comando. Se il valore per questo parametro viene riportato dal comando precedente, storeId non viene richiesto, altrimenti è necessario specificarlo.
- catEntryId
-
Specifica il numero di riferimento degli articoli di interesse, dalla colonna CATENTRY_ID della tabella IITEM, da copiare dall'elenco articoli di interesse.
Se viene indicato "*", il comando funziona come se fossero stati indicati tutti gli articoli di interesse nell'elenco indicato; i valori non validi dicatEntryId verranno ignorati.
- inListMemberId
-
Il numero di riferimento dell'utente proprietario dell'elenco articoli di interesse che verrà copiato; se questo
parametro non è specificato, il valore predefinito è l'utente corrente
- inListId
-
Specifica l'elenco articoli di interesse da cui eseguire la copia; è possibile utilizzare le abbreviazioni
- Se viene specificato ".", il comando GetCurrentIIListsCmd viene invocato per ottenere l'elenco articoli di interesse corrente. Se il comando
GetCurrentIIListsCmd stabilisce che non non è presente un elenco articoli di interesse, viene utilizzato quello aggiornato più di recente.
- Se viene specificato "*", il comando funziona come se fossero stati specificati tutti gli elenchi articoli di interesse.
- inListIdName
-
Specifica i nomi delle coppie nome-valore da aggiungere all'URL di reindirizzamento. I valori delle coppie nome-valore aggiunte sono i numeri di riferimento degli elenchi articoli di interesse specificati da inlistId. Questo parametro viene fornito per poter specificare un elenco articoli di interesse senza utilizzare esplicitamente inlistId.
- outListId
-
Specifica l'elenco articoli di interesse in cui copiare gli articoli; è possibile utilizzare le
abbreviazioni
- Se viene specificato ".", verranno copiati tutti gli elenchi articoli di interesse correnti. Il comando
GetCurrentIIListsCmd viene utilizzato per ottenere gli elenchi correnti degli articoli di interesse; se il comando
GetCurrentIIListsCmd determina che non esistono elenchi correnti, viene utilizzato quello più aggiornato
- Se viene specificato "*", il comando funziona come se fossero stati specificati tutti gli elenchi articoli di interesse del cliente.
- Se viene specificato "**", viene creato un nuovo elenco, in cui saranno copiati tutti gli articoli di interesse.
- Se questo parametro viene omesso, non verrà eseguita alcuna operazione di copia.
- outListIdName
-
Specifica i nomi delle coppie nome-valore da aggiungere all'URL di reindirizzamento. I valori delle coppie nome-valore aggiunte sono i numeri di riferimento degli elenchi articoli di interesse specificati da outlistId. Questo parametro viene fornito per poter specificare un elenco articoli di interesse senza utilizzare esplicitamente outlistId.
- outListDesc
-
Specifica una descrizione dell'elenco articoli di interesse in uscita. Se esiste già e contiene anche una descrizione, questa verrà sostituita dalla nuova descrizione.
Se l'elenco articoli di interesse in uscita viene creato senza fornire alcuna descrizione, verrà utilizzata la descrizione dell'elenco.
Altrimenti, si utilizza la descrizione predefinita, che è uno spazio vuoto.
- displaySeq
-
Specifica la sequenza di visualizzazione per gli elenchi in cui vengono copiati gli articoli di interesse. Se questo parametro non viene specificato e viene creato un nuovo ordine, la sequenza di visualizzazione viene impostata su un valore in più della sequenza massima tra gli elenchi esistenti, oppure su "1" se questo cliente non dispone di elenchi articoli di interesse.
I segni più (+) utilizzati negli esempi di seguito
vengono memorizzati nel database come spazi.
Esempio 1
Questo esempio crea un nuovo elenco articoli di interesse copiando tutti i prodotti, dall'elenco del cliente, che abbiano
numero di riferimento 1. Viene specificata una descrizione per il nuovo elenco. Il comando inoltre riporta a un URL che visualizza il nuovo elenco. Il parametro outListId viene utilizzato per specificare che il parametro listId deve essere trasmesso al comando InterestItemDisplayCmd. Il valore del parametro listId per il comando
InterestItemDisplayCmd è il numero di riferimento del nuovo elenco articoli di interesse.
http://host_name/webapp/wcs/stores/servlet/InterestItemListCopy?
inListId=1&catEntryId=*&outListId=*
&outListDesc=The+new+list+Description&outListIdName=listId
&URL=/webapp/commerce/InterestItemDisplay
Esempio 2
Questo esempio crea un nuovo elenco articoli di interesse vuoto, con la stessa descrizione dell'elenco 4.
http://host_name/webapp/wcs/stores/servlet/InterestItemListCopy?
inListId=4&outListId=**&URL=/
Esempio 3
L'esempio seguente modifica la descrizione dell'elenco 12. Se questo elenco non esiste, si verifica un errore:
http://host_name/webapp/wcs/stores/servlet/InterestItemListCopy?
outListId=12&outListDesc=The+new+Description&URL=/
Esempio 4
L'esempio seguente unisce tutti gli elenchi correnti di articoli di interesse del cliente in un unico elenco, la cui descrizione è "Il contenuto di tutti i carrelli acquisti personali". L'URL di reindirizzamento contiene una coppia nome-valore
outlistId=<nnn>, di cui
<nnn> è il numero di riferimento del nuovo elenco articoli di interesse.
http://host_name/webapp/wcs/stores/servlet/InterestItemListCopy?
inListId=.&catEntryId=*&outListId=**&outListIdName=outlistId
&outListDesc=The+contents+of+all+my+current+shopping+carts&URL=/
Esempio 5
L'esempio seguente copia tutti gli articoli di un elenco articoli di interesse del cliente in tutti gli elenchi esistenti di articoli di interesse del cliente. Allo stesso tempo crea un nuovo elenco articoli di interesse, che contiene tutti gli articoli presenti negli elenchi correnti.
Gli articoli già esistenti negli elenchi articoli di interesse in uscita verranno sostituiti.
http://host_name/webapp/wcs/stores/servlet/InterestItemListCopy?
inListId=.&catEntryId=*&outListId=*&outListId=**&inListIdName=inlistId
&outListIdName=outlistId&URL=/demomall/basemall.htm
Azione
- Richiama il comando GetCurrentIIListsCmd se vengono specificati i parametri inListId
e outListId come ".", per determinare gli elenchi correnti di articoli di interesse in entrata o in uscita.
- Richiama due volte il comando di attività AuthIIListAccessCmd.
La prima volta per leggere il permesso di lettura per tutti gli elenchi articoli di interesse in entrata specificati; la seconda volta per controllare il permesso di lettura per ciascun elenco articoli di interesse in uscita specificato.
- Esegue una copia degli articoli dagli elenchi articoli di interesse in uscita, quindi aggiorna la
descrizione e visualizza la sequenza di tali elenchi.
- Se una voce di catalogo presente negli elenchi articoli di interesse in uscita si riferisce alla stessa voce di catalogo nell'elenco articoli di interesse in entrata, viene sostituita.
- Gli articoli di interesse vengono copiati in ordine cronologico di creazione o di aggiornamento, come specificato nella colonna LASTUPDATE della tabella IITEM.
Condizioni di errore
Se il comando assegnato a AuthIIListAccessCmd riporta un errore,
la funzione imposta l'attività di eccezione AuthIIListAccessErr
per gestire l'errore.