Instruction InterestItemListCopy
Cette instruction de niveau site crée ou met à jour une liste d'articles en copiant des éléments d'une telle liste à une autre.

Valeurs des paramètres
- http://host_name/path/
-
Nom qualifié complet de votre serveur WebSphere Commerce et chemin de configuration
- langId
- Affecte ou réinitialise la langue préférée pour la durée de la session ; les langues prises en charge pour un magasin figurent dans la table STORELANG
- forUser
- ID de connexion de l'utilisateur au nom duquel l'instruction est exécutée. Seule une personne disposant des droits de traitement des commandes peut spécifier ce paramètre.
- forUserId
- Identique à forUser, mais identifie l'utilisateur par l'ID d'utilisateur interne, tel qu'elle est indiquée dans la table USERS.
- URL
- URL devant être lancée lorsque l'instruction aboutit.
- storeId
-
Numéro de référence du magasin sous lequel cette instruction est exécutée. Si la valeur de ce paramètre provient de l'instruction précédente, storeId n'est pas requis. Dans le cas contraire, spécifiez storeId.
- catEntryId
-
Indique le numéro de référence d'articles, à partir de la colonne CATENTRY_ID de la table IITEM, pour une copie
depuis la liste d'articles. Si "*" est indiqué, l'instruction se comporte comme si tous les articles de la liste correspondante étaient
spécifiés. Les valeurs incorrectes de catEntryId ne sont pas prises en compte.
Si "*" est indiqué, l'instruction se comporte comme si les articles de la liste correspondante étaient indiqués.
- inListMemberId
-
Numéro de référence de l'utilisateur dont la liste d'articles sera copiée. Lorsque
ce paramètre n'est pas indiqué, la valeur par défaut est l'utilisateur actuel.
- inListId
-
Indique la liste d'articles en entrée à l'origine de la copie ; abréviations peut être utilisé.
- Si "." est indiqué, l'instruction d'activité
GetCurrentIIListsCmd est appelée pour obtenir la liste
actuelle d'articles et l'utiliser. Si l'instruction d'activité
GetCurrentIIListsCmd détermine qu'il n'y a pas de liste actuelle d'articles, la liste la plus récemment mise à jour est utilisée.
- Lorsque "*" est indiqué, l'instruction se comporte comme si toutes
les listes d'articles du client étaient mentionnées.
- inListIdName
-
Indique les noms des paires nom-valeur à ajouter à l'URL de réacheminement. Les valeurs des paires nom-valeur ajoutées
sont les références de la liste d'articles spécifiée par
inlistId. Ce paramètre est fourni afin qu'une liste d'articles puisse être indiquée
sans utiliser inlistId explicitement.
- outListId
-
Indique la liste d'articles dans laquelle copier les articles ; abréviations peut être utilisé.
- Lorsque "." est indiqué, une copie a lieu dans toutes les listes actuelles d'articles. l'instruction d'activité
GetCurrentIIListsCmd est appelée pour obtenir les listes actuelles d'articles.
Lorsque l'instruction d'activité
GetCurrentIIListsCmd détermine qu'il n'y a pas de liste actuelle d'articles, la liste la plus récemment mise à jour est utilisée.
- Lorsque "*" est indiqué, l'instruction se comporte comme si
toutes les listes d'articles du client étaient spécifiées.
- Lorsque "**" est indiqué, une nouvelle liste d'articles est créée et tous les articles sont copiés dans cette liste.
- Si ce paramètre est omis, aucune copie n'a lieu.
- outListIdName
-
Indique les noms des paires nom-valeur à ajouter à l'URL de réacheminement. Les valeurs des paires nom-valeur ajoutées sont les numéros de référence de la liste d'articles indiquée dans outlistId. Ce paramètre est fourni afin qu'une liste d'articles puisse être indiquée sans utiliser outlistId explicitement.
- outListDesc
-
Indique une description de la liste d'articles en sortie. Si cette dernière existe déjà
et comporte une description, l'ancienne description est remplacée par la nouvelle.
La description de la liste d'articles en entrée est utilisée lorsque la liste d'articles en sortie est créée
et qu'aucune description n'est fournie.
L'alternative est alors une description par défaut à blanc.
- displaySeq
-
Indique la séquence d'affichage pour les listes d'articles dans lesquelles les
articles sont copiés. Lorsque ce paramètre n'est pas indiqué et lorsqu'une nouvelle commande
est créée, sa séquence d'affichage est définie à une valeur supérieure d'une unité à la valeur
de la séquence maximale d'affichage parmi les listes existantes ou à "1" en
l'absence de listes d'articles pour cet utilisateur.
Les signes plus (+) utilisés dans les exemples ci-dessous
sont stockés dans la base de données sous forme d'espaces.
Exemple 1
L'exemple suivant crée une nouvelle liste d'articles en copiant tous les produits de référence 1
de la liste d'articles du client. La description
de la nouvelle liste est indiquée. L'instruction réachemine également vers une URL
qui affiche la nouvelle liste. Le paramètre outListId est utilisé pour spécifier
que le paramètre listId doit être transmis à l'instruction
InterestItemDisplayCmd. La valeur du paramètre listId pour l'instruction
InterestItemDisplayCmd
est la référence de la nouvelle liste d'articles.
http://host_name/webapp/wcs/stores/servlet/InterestItemListCopy?
inListId=1&catEntryId=*&outListId=*
&outListDesc=The+new+list+Description&outListIdName=listId
&URL=/webapp/commerce/InterestItemDisplay
Exemple 2
L'exemple suivant créé une nouvelle liste d'articles vide avec la même description que pour la liste d'articles 4.
http://host_name/webapp/wcs/stores/servlet/InterestItemListCopy?
inListId=4&outListId=**&URL=/
Exemple 3
L'exemple suivant modifie la description de la liste d'articles 12. Une erreur se produit en l'absence de cette liste :
http://host_name/webapp/wcs/stores/servlet/InterestItemListCopy?
outListId=12&outListDesc=The+new+Description&URL=/
Exemple 4
L'exemple suivant fusionne toutes les listes d'articles d'un client en une seule liste nouvelle, dont la description est "Contenu de tous mes chariots actuels". L'URL de réacheminement
contient une paire nom-valeur outlistId=<nnn>, dans laquelle
<nnn> est la référence de la nouvelle liste d'articles.
http://host_name/webapp/wcs/stores/servlet/InterestItemListCopy?
inListId=.&catEntryId=*&outListId=**&outListIdName=outlistId
&outListDesc=The+contents+of+all+my+current+shopping+carts&URL=/
Exemple 5
L'exemple suivant copie tous les articles de la liste actuelle d'articles du client
dans toutes les listes d'articles du client. Simultanément, il créé
une nouvelle liste d'articles avec tous les articles des listes actuelles.
Les articles qui existent déjà dans les listes d'articles de sortie sont remplacés.
http://host_name/webapp/wcs/stores/servlet/InterestItemListCopy?
inListId=.&catEntryId=*&outListId=*&outListId=**&inListIdName=inlistId
&outListIdName=outlistId&URL=/demomall/basemall.htm
Comportement
- Appelle l'instruction d'activité
GetCurrentIIListsCmd
lorsque inListId et outListId sont indiqués ".",
pour déterminer les listes actuelles d'articles en entrée ou de sortie.
- Appelle deux fois l'instruction d'activité
AuthIIListAccessCmd.
Le premier appel est pour vérifier le droit de lecture pour chaque liste d'articles spécifiée en entrée et le deuxième, pour vérifier le droit d'accès en écriture pour chaque liste d'articles de sortie.
- Copie tout article des listes d'articles en entrée dans les listes d'articles de sortie,
et met à jour la description et la séquence d'affichage des listes d'articles de sortie.
- Lorsqu'une entrée de catalogue dans des listes d'articles de sortie renvoie à la même entrée
dans la liste d'articles en entrée, elle est remplacée.
- Les articles sont copiés par ordre chronologique de leur création ou de leur mise à jour, comme indiqué dans la colonne LASTUPDATE de la table IITEM.
Conditions d'exception
Lorsque l'instruction d'activité affectée à l'instruction
d'activité AuthIIListAccessCmd
échoue, la fonction définit la tâche d'exception AuthIIListAccessErr pour gérer l'erreur.