Mandato InterestItemListCopy
Este mandato a nivel de sitio crea o actualiza una lista de artículos de
interés copiando artículos de interés de una lista de artículos de interés a otra.

Valores de los parámetros
- http://nombre_sistpral/vía de acceso/
-
El nombre totalmente calificado del servidor WebSphere Commerce y la vía de acceso de configuración
- langId
- Establece o restaura el idioma preferido para la duración de la sesión;
los idiomas soportados para una tienda se encuentran en la tabla STORELANG.
- forUser
- El ID de conexión del usuario en cuyo nombre se ejecutará el
mandato; este parámetro sólo lo puede especificar una persona con
autorización para procesar pedidos.
- forUserId
- Igual que forUser, pero identifica al usuario mediante el ID de usuario interno, como se encuentra en la
tabla USERS.
- URL
- El URL al que se debe llamar cuando el mandato se completa satisfactoriamente.
- storeId
-
El número de referencia de la tienda para la que se ejecuta este mandato. Si el
valor de este parámetro viene implícito del mandato anterior, storeId no es
necesario; de lo contrario, debe especificar storeId.
- catEntryId
-
Especifica el número de referencia de los artículos de interés, de la columna CATENTRY_ID de la
tabla IITEM, que se han de copiar de la lista de artículos de interés.
Si se especifica "*", el mandato se comporta como si se hubiesen especificado todos
los artículos de interés de la lista de artículos de interés dada; los valores no válidos
de catEntryId se pasan por alto.
- inListMemberId
-
El número de referencia del usuario cuya lista de artículos de interés se copiará; si
este parámetro no se especifica, el valor por omisión es el usuario actual.
- inListId
-
Especifica la lista de artículos de interés de entrada de la que se copiará; se pueden
utilizar abreviaturas.
- Si se especifica ".", se invoca el mandato de tarea GetCurrentIIListsCmd para que obtenga la lista de artículos de interés actual y la utilice; si
el mandato de tarea
GetCurrentIIListsCmd determina que no hay ninguna lista de artículos de interés actual,
se utiliza la lista que se ha actualizado más recientemente.
- Si se especifica "*", el mandato se comporta como si se hubiesen
especificado todas las listas de artículos de interés del usuario.
- inListIdName
-
Especifica los nombres de parejas nombre-valor que se han de añadir al URL
de redirección. Los valores de las parejas nombre-valor añadidas son los números de referencia
de la lista de artículos de interés especificada mediante el parámetro inlistId. Este
parámetro se proporciona para poder especificar una lista de artículos de interés
sin utilizar inlistId explícitamente.
- outListId
-
Especifica la lista de artículos de interés en la que copiar artículos de interés; se pueden
utilizar abreviaturas
- Si se especifica ".", se copiará en todas las listas de artículos de interés
actuales del usuario. El mandato de tarea
GetCurrentIIListsCmd se invoca para obtener las listas de artículos de interés actuales;
si el mandato de tarea
GetCurrentIIListsCmd determina que no hay ninguna lista de artículos de interés actual, se
utiliza la lista actualizada más recientemente
- Si se especifica "*", el mandato se comporta como si se hubiesen
especificado todas las listas de artículos de interés del usuario.
- Si se especifica "**", se crea una nueva lista de artículos de interés
y todos los artículos de interés se copiarán en ella.
- Si se omite este parámetro, no se copia nada.
- outListIdName
-
Especifica los nombres de parejas nombre-valor que se han de añadir al URL
de redirección. Los valores de las parejas nombre-valor añadidas son los números de referencia
de la lista de artículos de interés especificada mediante el parámetro outlistId. Este
parámetro se proporciona para poder especificar una lista de artículos de interés
sin utilizar outlistId explícitamente.
- outListDesc
-
Especifica una descripción de la lista de artículos de interés de salida. Si ya existe
y ya tiene una descripción, será reemplazada por esta nueva descripción.
Si la lista de artículos de interés de salida se está creando y no se proporciona ninguna
descripción, se utiliza la descripción de la lista de artículos de interés de entrada.
De lo contrario, por omisión la descripción se queda en blanco.
- displaySeq
-
Especifica la secuencia de visualización para las listas de artículos de interés en las
que se copian artículos de interés. Si este parámetro no se especifica y se crea un
nuevo orden, su valor de secuencia de visualización se establece en uno más que el de la secuencia
de visualización máxima entre las listas existentes, o en "1" si no hay ninguna
lista de artículos de interés para este cliente.
Los signos más (+) utilizados en los ejemplos siguientes se almacenan
en la base de datos como espacios.
Ejemplo 1
Este ejemplo crea una nueva lista de artículos de interés, copiando todos los productos
de la lista de artículos de interés actual del cliente que tiene el número de referencia 1. Se especifica
una descripción para la nueva lista de artículos de interés. El mandato también redirige a un URL que
muestra la nueva lista. El parámetro outListId se utiliza para especificar que el parámetro
listId debe pasarse al mandato InterestItemDisplayCmd.
El valor del parámetro listId para el mandato
InterestItemDisplayCmd es el número de referencia de la nueva lista de artículos de interés.
http://nombre_sistpral/webapp/wcs/stores/servlet/InterestItemListCopy?
inListId=1&catEntryId=*&outListId=*
&outListDesc=La+nueva+descripción+de+lista&outListIdName=listId
&URL=/webapp/commerce/InterestItemDisplay
Ejemplo 2
Este ejemplo crea una nueva lista de artículos de interés vacía con la misma descripción
que la lista de artículos de interés 4.
http://nombre_sistpral/webapp/wcs/stores/servlet/InterestItemListCopy?
inListId=4&outListId=**&URL=/
Ejemplo 3
El ejemplo siguiente modifica la descripción de la lista de artículos de interés 12. Si no existe esa lista, se produce un error:
http://nombre_sistpral/webapp/wcs/stores/servlet/InterestItemListCopy?
outListId=12&outListDesc=La+nueva+descripción&URL=/
Ejemplo 4
El ejemplo siguiente fusiona todas las listas de artículos de interés actuales
del usuario actual en una lista nueva, cuya descripción es "El contenido
de todos mis carros de la compra actuales". El URL de redirección
contiene una pareja nombre-valor outlistId=<nnn>, donde
<nnn> es el número de referencia de la nueva lista de artículos de interés.
http://nombre_sistpral/webapp/wcs/stores/servlet/InterestItemListCopy?
inListId=.&catEntryId=*&outListId=**&outListIdName=outlistId
&outListDesc=El+contenido+de+todos+mis+carros+de+la+compra+actuales&URL=/
Ejemplo 5
El ejemplo siguiente copia todos los artículos de la lista de
artículos de interés actual del cliente en todas las listas de artículos de interés existentes
del cliente. Al mismo tiempo, crea una nueva lista de artículos de interés que contiene
todos los artículos de interés de todas las listas de artículos de interés actuales.
Los artículos que ya existan en las listas de artículos de interés de salida serán sustituidos.
http://nombre_sistpral/webapp/wcs/stores/servlet/InterestItemListCopy?
inListId=.&catEntryId=*&outListId=*&outListId=**&inListIdName=inlistId
&outListIdName=outlistId&URL=/demomall/basemall.htm
Comportamiento
- Llama al mandato de tarea GetCurrentIIListsCmd si inListId
y outListId se especifican como ".", para determinar las listas de artículos de interés
de entrada o de salida actuales.
- Llama al mandato de tarea AuthIIListAccessCmd dos veces.
Una vez para comprobar el permiso de lectura para cada una de las listas de artículos de interés
de entrada especificadas, y la segunda para comprobar el permiso de grabación para cada una de
las listas de artículos de interés de salida especificadas.
- Copia todos los artículos de interés de las listas de artículos de interés de entrada a las
listas de artículos de interés de salida, y luego actualiza la descripción y la secuencia
de visualización de las listas de artículos de interés de salida.
- Si una entrada de catálogo en las listas de artículos de interés de salida hace referencia
a la misma entrada de catálogo en la lista de artículos de interés de entrada, se sustituye.
- Los artículos de interés se copian en orden cronológico de creación o actualización, como
se especifica en la columna LASTUPDATE de la tabla IITEM.
Condiciones de excepción
Si el mandato de tarea asignado al mandato de tarea AuthIIListAccessCmd
falla, la función establece la tarea de excepción AuthIIListAccessErr
para manejar el error.