URL InterestItemListCopy
Cette commande au niveau du site crée ou met à jour une liste d'articles présélectionnés en copiant des articles présélectionnés d'une liste d'articles personnalisés vers une autre.
Structure de l'adresse URL
- http:// host_name/path/
- Nom entièrement qualifié de votre Transaction server et du chemin de configuration.
Valeurs des paramètres
- langId
- Définit ou redéfinit la langue préférée pour la durée de la session ; les langues prises en charge dans le magasin sont répertoriées dans la table STORELANG.
- forUser
- ID de connexion de l'utilisateur pour lequel l'adresse URL sera exécutée. Seul un utilisateur habilité à traiter les commandes peut indiquer ce paramètre.
- forUserId
- Identique à forUser, mais identifiant l'utilisateur par son ID interne, répertorié dans la table USERS.
- URL
- Obligatoire : Adresse URL à appeler une fois que la commande a abouti.
- storeId
- Numéro de référence du magasin sous lequel cette URL et exécutée. Si la valeur de ce paramètre provient de la commande précédente, storeId n'est pas nécessaire. Sinon, définissez-le.
- catEntryId
- Définit le numéro de référence d'articles présélectionnés, de la colonne CATENTRY_ID de la table IITEM à copier depuis la liste d'articles présélectionnés. Si la valeur est "*" , la commande se comporte comme si tous les articles de la liste de présélection concernée étaient indiqués ; les valeurs incorrectes de catEntryId sont ignorées. Ce paramètre peut être utilisé plusieurs fois.
- inListMemberId
- Numéro de référence de l'utilisateur dont la liste d'articles présélectionnés sera copiée ; si ce paramètre n'est pas spécifié, la valeur par défaut est l'utilisateur actuel.
- inListId
- Spécifie la liste d'articles présélectionnés d'entrée depuis laquelle copier ; des abréviations peuvent être utilisées
- inListIdName
- Définit les noms des paires nom-valeur à ajouter à l'URL de redirection. Les valeurs des paires nom-valeur ajoutées sont les numéros de référence de la liste d'articles présélectionnés spécifiée par inlistId. Ce paramètre est fourni de manière à ce qu'une liste d'articles présélectionnés puisse être spécifiée sans utiliser explicitement inlistId. Ce paramètre peut être utilisé plusieurs fois.
- outListId
- Spécifie la liste d'articles présélectionnés vers laquelle copier les articles présélectionnés ; des abréviations peuvent être utilisées
- outListIdName
- Définit les noms des paires nom-valeur à ajouter à l'URL de redirection. Les valeurs des paires nom-valeur ajoutées sont les numéros de référence de la liste d'articles présélectionnés spécifiée par outlistId. Ce paramètre est fourni de manière à ce qu'une liste d'articles présélectionnés puisse être spécifiée sans utiliser explicitement outlistId. Ce paramètre peut être utilisé plusieurs fois.
- outListDesc
- Spécifie une description de la liste d'articles présélectionnés de sortie. Si elle existe déjà et qu'elle a déjà une description, cette nouvelle description la remplacera. Si la liste d'articles présélectionnés de sortie est créée et qu'aucune description n'est fournie, la description de la liste d'articles présélectionnés d'entrée est utilisée. Sinon, la description est vide par défaut.
- displaySeq
- Spécifie la séquence d'affichage des listes d'articles présélectionnés vers lesquelles les articles présélectionnés sont copiés. Si ce paramètre n'est pas spécifié et qu'une nouvelle commande est créée, sa séquence d'affichage est définie sur une séquence d'affichage supérieure à la séquence d'affichage maximale parmi les listes existantes, ou "1" s'il n'y a pas de listes d'articles présélectionnés pour ce client.
Les signes plus (+) utilisés dans les exemples ci-dessous sont stockés dans la base de données en tant qu'espaces.
Exemple 1
Cet exemple crée une nouvelle liste d'articles présélectionnés en copiant tous les produits de la liste d'articles présélectionnés en cours du client ayant le numéro de référence 1. Une description de la nouvelle liste d'articles présélectionnés est spécifiée. La commande redirige é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 à la commande InterestItemDisplayCmd. La valeur du paramètre listId pour la commande InterestItemDisplayCmd est le numéro de référence de la nouvelle liste d'articles présélectionnés :
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
Cet exemple crée une nouvelle liste d'articles présélectionnés vide avec la même description que la liste d'articles présélectionnés 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 présélectionnés 12. En l'absence d'une telle liste, une erreur se produit :
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 présélectionnés en coursdu client en une seule nouvelle liste dont la description est "Contenu de tous mes paniers en cours". L'URL de redirection contient une paire nom-valeur outlistId=<nnn>, où <nnn> est le numéro de référence de la nouvelle liste d'articles présélectionnés.
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 d'articles présélectionnés actuelle du client vers toutes les listes d'articles présélectionnés existantes du client. Dans le même temps, il crée une nouvelle liste d'articles présélectionnés contenant tous les articles présélectionnés de toutes les listes d'articles présélectionnés actuelles. Les articles qui existent déjà dans les listes d'articles présélectionnés de sortie seront 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 de tâche GetCurrentIIListsCmd si inListId et outListId sont spécifiés comme "." pour déterminer les listes d'articles présélectionnés d'entrée ou de sortie en cours.
- Appelle deux fois l'instruction de tâche AuthIIListAccessCmd. Une fois pour vérifier l'autorisation de lecture de chacune des listes d'articles présélectionnés d'entrée spécifiées et une deuxième fois pour vérifier l'autorisation d'écriture de chacune des listes d'articles présélectionnés de sortie spécifiées.
- Copie tous les articles présélectionnés des listes d'articles présélectionnés d'entrée sur les listes d'articles présélectionnés de sortie, puis met à jour la description et la séquence d'affichage des listes d'articles présélectionnés de sortie.
- Si une entrée de catalogue dans les listes d'articles présélectionnés de sortie fait référence à la même entrée de catalogue dans la liste d'articles présélectionnés d'entrée, elle est remplacée.
- Les articles présélectionnés sont copiés dans l'ordre chronologique de leur création ou mise à jour, comme spécifié dans la colonne LASTUPDATE de la table IITEM.
Conditions d'exception
Si l'instruction de tâche affectée à la tâche AuthIIListAccessCmd échoue, la fonction définit la tâche d'exception AuthIIListAccessErr pour traiter l'erreur.