URL de InterestItemAdd

Utilice este URL con SSL (Secure Sockets Layer) para asegurarse de que la contraseña de conexión y la información personal del cliente están cifradas. Para ello, escriba el URL con el protocolo seguro HTTPS.

Estructura de URL

http:// host_name/path/

El nombre completo de Transaction server y la vía de acceso de configuración.

Valores de parámetros

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 URL. Este parámetro solo puede especificarlo una persona que tenga autorización para procesar pedidos.

forUserId

Igual que forUser, pero el usuario se identifica mediante el ID de usuario interno que aparece en la tabla USERS.

URL

Se necesita: El URL al que se debe llamar cuando el mandato se completa satisfactoriamente.

storeId

Se necesita: El número de referencia de tienda que está asociado a la entrada de catálogo y para el cual se procesa el URL.

catEntryId_ i

Se necesita: El número de referencia de la entrada de catálogo que se debe añadir a la lista de artículos de interés.

attrName_ i

Es cualquier ID de referencia de atributo que está definido en la tabla ATTRVALUE para la entrada de catálogo. Este parámetro puede repetirse. Este parámetro es necesario cuando se trabaja con beans de producto.

attrValue_ i

Es la columna STRINGVALUE o INTEGERVALUE del atributo, definida en la tabla ATTRVALUE, para la entrada de catálogo. Este parámetro puede repetirse. Este parámetro es necesario cuando se trabaja con beans de producto.

listId

Es el número de referencia de la lista de artículos de interés. Se pueden utilizar abreviaturas:

• Si una entrada de catálogo especificada ya no existe, no se añade.
• Si no se especifica este parámetro, el URL se comporta como si se hubiera especificado ".".
• Si el parámetro intenta añadir una entrada de catálogo a la lista que ya está en la lista, el resultado depende del valor del parámetro updateable.
• Si se especifica ".", se invoca el URL de tarea GetCurrentIIListsCmd para obtener la lista de artículos de interés actual del cliente y el URL se comporta como si se hubiera especificado la lista de artículos de interés actual. Si el URL de tarea GetCurrentIIListsCmd determina que no existe ninguna lista de artículos de interés actual, se utiliza la lista actualizada más recientemente. Si no existe ninguna lista, la tarea crea una nueva.
• Si se especifica "*", el URL se comporta como si se hubieran especificado todas las listas de artículos de interés del cliente.

Este parámetro puede repetirse.

listIdName

Cuando finaliza el proceso de este URL, si se utiliza la redirección para hacer que se procese un segundo URL, listIdName especifica el nombre de parámetro del segundo URL que utilizará el valor del parámetro listId en el primer URL. La mayoría de las veces, el segundo URL también tiene un parámetro listId y por tanto listIdName=listId. Este parámetro puede repetirse.

quantity_ i

Es la cantidad del artículo. El valor predeterminado es 1. Este parámetro se puede repetir.

UOM_ i

Es la unidad de medida. El valor predeterminado está asociado a la tienda. Este parámetro puede repetirse.

field1_ i, field2_ i, field3_ i

Valor almacenado en las columnas reservadas para la tienda FIELD1, FIELD2 y FIELD3 de la tabla IITEM. Este parámetro puede repetirse.

updatable_ i

Indica qué se debe hacer cuando un URL solicita añadir una entrada de catálogo a una lista y la entrada ya se encuentra en la lista:

• 1=Actualizar
• 0=Emitir una excepción
• Sin especificar=Toma el valor 1 por omisión

Este parámetro puede repetirse.

Ejemplo

En el ejemplo siguiente, la versión deluxe de la entrada de catálogo, que tiene el número de referencia 9 y es vendida por la tienda con el número de referencia 1, se añade al pedido actual del cliente y luego se invoca el URL InterestItemDisplay. En el ejemplo se presupone que 3 es un ID de atributo válido para el artículo y que tiene el valor de atributo "deluxe" definido en la tabla ATTRVALUE.

https://host_name/webapp/wcs/stores/servlet/InterestItemAdd?
storeId=1&catEntryId=9&URL=/webapp/commerce/InterestItemDisplay
&attrName=3&attrValue=deluxe

Comportamiento

• El URL invoca el URL de tarea GetCurrentIIListsCmd cuando el valor especificado para el parámetro listId es ".", o ninguno, para determinar a qué lista de artículos de interés se deben añadir las entradas de catálogo.
• Se invoca el URL de tarea AuthIIListAccessCmd para comprobar si existe permiso de escritura para cada lista de artículos de interés especificada.
• Se invoca el URL de tarea ResolveSkuCmd para determinar el artículo correspondiente a la entrada de catálogo.
• Se comprueba que la entrada de catálogo que se debe añadir a la lista de interés del usuario no pertenece a un conjunto de productos que está excluido del contrato del usuario.
• Se añade la entrada de catálogo a la tabla IITEM.
• Cuando el proceso finaliza satisfactoriamente, se invoca el URL especificado.
• Se normaliza y redondea la cantidad de acuerdo con la unidad de medida.

Condiciones de excepción

• Si el URL de error asignado al URL de tarea AuthIIListAccessCmd falla, el URL establece la tarea de excepción AuthIIListAccessErr para manejar el error.
• Si el URL de error asignado al URL de tarea ResolveSkuCmd determina que falta un atributo de producto necesario, el URL establece la tarea de excepción ProductAttributeErrorView para manejar el error. Si el URL determina que un producto con el atributo especificado no existe en la base de datos, el URL define la misma tarea de excepción ProductAttributeErrorView para manejar el error.

Notas

• El URL de InterestItemAdd solo carga de beans de artículo, puesto que los beans de producto deben resolverse en un bean de artículo utilizando nombres de atributos y valores de atributo. Por lo tanto, cuando especifique un catentry_id de bean de producto, debe proporcionar los valores para attrName_ i y attrValue_ i. Si no se proporcionan estos valores, el URL no puede resolver el bean de producto en un bean de tema.