URL OrderItemDisplay

Lista todos los artículos de pedido que están en estado pendiente.

URL

OrderItemDisplay

Mandato de controlador

com.ibm.commerce.orderitems.commands.OrderItemDisplayCmd

Clase de implementación

com.ibm.commerce.orderitems.commands.OrderItemDisplayCmdImpl

Mandatos llamados

Estructura de URL

http:// host_name/ path/: El nombre completo de Transaction server y la vía de acceso de configuración.

Este diagrama muestra la estructura del URL OrderItemDisplay.

Valores de parámetros

forUser: El ID de conexión de otro usuario en cuyo nombre se ejecutará el mandato. Solo una persona con autorización para realizar la acción "becomeUser" en este mandato puede especificar este parámetro y ejecutarlo OrderItemDisplay en nombre de otro usuario.
forUserId: Igual que forUser, pero identifica al usuario mediante el ID de usuario interno que aparece en la tabla USERS.
langId: Establece o restablece el idioma preferido durante el tiempo que dura la sesión; los idiomas soportados para una tienda se encuentran en la tabla STORELANG.
storeId: El número de referencia de la tienda de los pedidos a listar. Si omite este parámetro, se utiliza el storeId de la sesión. Se produce un error si omite este parámetro y no hay ningún storeId en la sesión.
orderId: Especifica cero o más pedidos, utilizando números de referencia de pedido o una de las siguientes abreviaturas especiales: ".", "*", ". t" o "* t". Consulte Abreviaturas de pedidos para obtener una descripción de estas abreviaturas. Si se omite este parámetro, el valor predeterminado es "*". Los pedidos especificados deben pertenecer a la tienda especificada. (De lo contrario, el mandato de tarea com.ibm.commerce.order.utils.ResolveOrdersCmd generará una excepción ECApplicationException que especifica el mensaje de error _ERR_INVALID_ORDER_REFNUM.) Este parámetro se puede repetir.
outOrderName: Especifica los nombres de pares nombre-valor que se han de añadir a las propiedades de respuesta que se pasan al mandato de vista. El valor de cada par nombre-valor añadida es una matriz de los números de referencia de los pedidos especificados. Si este parámetro se omite, toma por omisión el valor de "orderId". Este parámetro puede repetirse.
addressId: El número de referencia de la dirección para los artículos que se han de visualizar. Si se omite este parámetro, se visualizan todos los artículos de pedido para los pedidos especificados.
remerge: Una lista de los artículos de pedido que deben fusionarse con otros artículos de pedido del mismo pedido y con el mismo atributo correlationGroup, si es posible. Este parámetro puede repetirse.
merge: Una lista de los artículos de pedido que deben fusionarse con otros artículos de pedido del mismo pedido si es posible, independientemente de sus atributos correlationGroup. Este parámetro puede repetirse.
check: Una lista de artículos de pedido que debe comprobar el mandato de tarea com.ibm.commerce.fulfillment.commands.CheckInventoryAvailabilityCmd. Este parámetro puede repetirse.
allocate: Una lista de artículos de pedido que deben asignarse del inventario existente. Este parámetro puede repetirse.
backorder: Una lista de artículos de pedido que deben asignarse del inventario esperado. Este parámetro puede repetirse.
reverse: Una lista de artículos de pedido cuyas asignaciones deben liberarse (es decir, desasignarse del inventario existente o esperado según corresponda). Este parámetro puede repetirse.
doPrice: Especifica si el mandato debe realizar las subtareas de cálculo de precios. Establézcalo para que realice las tareas de precios (Y) o no (N). Desactivar estas tareas puede dar como resultado un mejor rendimiento, pero es posible que los usuarios no obtengan el precio más reciente o la autorización para el producto cuando se produzcan los cambios.
doInventory: Especifica si el mandato debe realizar las subtareas de cálculo de inventario. Establézcalo para que realice las tareas de precios (Y) o no (N). Desactivar estas tareas puede dar como resultado un mejor rendimiento, pero es posible que los usuarios no obtengan el mejor nivel de inventario actual cuando se produzcan los cambios.

Nota: Los parámetros remerge, merge, check, allocate, backorder y reverse solo son aplicables si el inventario ATP está habilitado. (Consulte la columna INVENTORYSYSTEM en la tabla STORE.) Representan las listas de artículos de pedido que se pasarán al mandato de tarea DoinventoryAction que llama al mandato de tarea com.ibm.commerce.fulfillment.commands.AllocateInventoryCmd, que invoca los mandatos de tarea com.ibm.commerce.fulfillment.commands.CheckInventoryAvailabilityCmd, com.ibm.commerce.fulfillment.commands.AllocateExistingInventoryCmd, com.ibm.commerce.fulfillment.commands.AllocateExpectedInventoryCmd, com.ibm.commerce.fulfillment.commands.DeallocateExistingInventoryCmd y com.ibm.commerce.fulfillment.commands.DeallocateExpectedInventoryCmd que se especifican a continuación. Además, estos parámetros aceptan abreviaturas de artículo de pedido, las cuales se describen en la ayuda para los URL del subsistema de gestión de pedidos.

Los valores predeterminados de los parámetros de ATP son los siguientes:

remerge=*n
merge=*n
check=***
allocate=*n
backorder=*n
reverse=*n

Ejemplo 1

El ejemplo siguiente muestra todos los productos y artículos que corresponden al número de referencia de dirección 2 y todos los pedidos pendientes del cliente. Los números de referencia de estos pedidos se pasan al mandato OrderItemDisplay utilizando el parámetro orderId.


     http://
myhostname/webapp/wcs/stores/servlet/OrderItemDisplay?addressId=2

Ejemplo 2

El ejemplo siguiente primero crea un nuevo pedido con un único artículo utilizando el mandato OrderItemAdd y luego muestra los detalles de envío para los artículos.


http://myhostname/webapp/wcs/stores/servlet/OrderItemAdd?catEntryId=322200305&quantity=1&orderId=**&URL=OrderItemDisplay

Ejemplo 3

El ejemplo siguiente muestra cómo utilizar los parámetros doPrice y doInventory. En este ejemplo, los precios de artículos de pedido no se renuevan si el artículo no ha caducado y no se realizan acciones de inventario.


http://myhostname/webapp/wcs/stores/servlet/OrderItemDisplay?orderId=1234
&storeId=10001&catalogId=10001&doPrice=N&doInventory=N

Comportamiento

Validar el ID de dirección y renovarlo si no es válido

Para todos los artículos de pedido en el pedido especificado:

Llamar a UpdateShippingAddressCmd para actualizar la dirección de envío si el ID de dirección se ha renovado
Llamar a CheckAndResetOrderItemPriceFlagCmd para comprobar y restablecer el distintivo de bit de precio si el precio ha caducado
Llamar a ResolveOrderItemPriceCmdImpl para calcular el mejor precio y actualizar el total del pedido
Pasar el parámetro doPrice a ResolveOrderItemPriceCmd para controlar si los artículos de pedido pueden saltarse de nuevo el cálculo de precio
Llamar a OrderItemsCmdHelper para actualizar el total de productos
Llamar a OrderItemsCmdHelper para verificar la transacción comercial y los métodos de pago si es necesario
Si doInventory = Y, llamar a DoInventoryActionCmd para comprobar el inventario
Si el parámetro deleteOrderitemOutofStock que se ha pasado indica delete:
- Si el parámetro deleteOrderitemOutofStock que se ha pasado indica delete:
De lo contrario:
- Si es ATP: Generar una excepción si se han agotado las existencias
- Si no es ATP: Añadir un rastreo al registro

Condiciones de excepción

Si el número de referencia de dirección especificado no hace referencia a un objeto de dirección existente en la tabla de base de datos ADDRESS, el mandato genera una excepción ECApplicationException con el mensaje de error _ERR_INVALID_ADDR y la vista de error GenericApplicationError.
Si la columna PRICEREFFLAGS de la tabla de base de datos STORE indica que ninguno de los acuerdos comerciales para un artículo de pedido está disponible para el usuario del artículo de pedido, el mandato genera una excepción ECApplicationException con el mensaje de error _ERR_NO_ELIGIBLE_TRADING y la vista de error GenericApplicationError.
Si el mandato de tarea no devolvió un precio para un artículo de pedido, el mandato genera una excepción ECApplicationException con el mensaje de error _ERR_RETRIEVE_PRICE y la vista de error GenericApplicationError.
Si un artículo de pedido especifica un ID de configuración pero no hay ningún componente en la tabla de base de datos OICOMPLIST con ese ID de configuración para el artículo de pedido, el mandato genera una excepción ECApplicationException con el mensaje de error _ERR_INVALID_COMPONENT_LIST y la vista de error GenericApplicationError.
Si el mandato de tarea no devolvió un precio para un componente de artículo de pedido o un componente de artículo de pedido especifica un precio en una moneda que es diferente de la moneda del artículo de pedido (y que no puede convertirse a dicha moneda), el mandato genera una excepción ECApplicationException con el mensaje de error _ERR_COMPONENT_PRICE_CALCULATION y la vista de error GenericApplicationError.
Si los artículos de pedido tienen acuerdos comerciales que especifican métodos de pago incompatibles con los de los artículos de pedido o que especifican cuentas que son diferentes de las de otros artículos de pedido, el mandato genera una excepción ECApplicationException con el mensaje de error _ERR_TRADINGS_INCOMPATIBLE_ACCOUNT_PAYMENT y la vista de error InvalidInputErrorView.