Sintaxis básica de los mandatos
Todos los mandatos del flujo de compra de WebSphere Commerce tienen la
sintaxis básica siguiente:
http://nombre_sistpral/vía/Mandato?parámetro1=valor&parámetro2=valor&parámetro3=valor
El siguiente es un ejemplo:

Para leer los diagramas de sintaxis, que se asemejan a los mapas de vías
férreas, comience por el ángulo superior izquierdo y siga la línea
(imagínese que se trata de las vías de un tren). No olvide los
siguientes convenios:
El nombre_sistpral y la vía se determinan por la ubicación en la que se ha instalado el producto.
El delimitador que va a continuación del nombre de mandato es
?. El delimitador entre parámetros sucesivos es &. No es
necesario utilizar el signo & antes del primer parámetro.
En los diagramas de sintaxis, el valor del parámetro se presenta
generalmente como s, que significa serie. Si un parámetro requiere
códigos predefinidos o si impone restricciones que no son obvias
en el tipo de datos, esto se explicará en la descripción.
Mientras se sigue la línea de izquierda a derecha si no hay forma de evitar un parámetro que está en la línea principal como, por ejemplo, el URL, significa que el parámetro es obligatorio.
Si un parámetro está fuera de la línea principal como, por ejemplo,
langId, y se puede evitar, el parámetro es opcional.
Si un parámetro tiene una línea que regresa a la parte izquierda como, por ejemplo, listId, significa que el parámetro se puede repetir, como se indica a continuación:
&listId=1&listId=2&listId=3
El siguiente diagrama de sintaxis ilustra conjuntos alternativos de
parámetros obligatorios. Puede utilizar:
&logonId=s&challengeAnswer=s
o también puede utilizar
&logonPassword=s&logonPasswordOld=s&logonPasswordVerify=s

El siguiente diagrama de sintaxis muestra memberId, un parámetro
que a veces es obligatorio. Esto se ilustra con una línea
discontinua. En la descripción de OrgEntityAdd,
encontrará una explicación sobre cuándo es obligatorio el parámetro y cuándo es
opcional.

Parámetros
Hay algunos parámetros comunes que están disponibles para la mayoría de los mandatos:
- storeId
- Asocia el mandato a una tienda específica. Es especialmente útil
con mandatos que operan a nivel de centro comercial porque obliga al mandato
a operar únicamente dentro del ámbito de la tienda.
- langId
- Especifica el idioma que se utilizará mientras dure
el mandato. Los valores del parámetro se almacenan en la tabla LANGUAGE.
Si está soportado, el idioma especificado reemplaza al idioma por omisión del
usuario. Si, por el contrario, el idioma especificado no está
soportado, se utiliza el idioma por omisión de la tienda o del sitio.
- forUser
- Especifica el ID de conexión de un usuario para el que otro usuario
está llevando a cabo acciones. Este parámetro sólo lo puede utilizar
una persona con autorización para procesar pedidos como, por ejemplo, un
Representante de servicio al cliente, un Supervisor de servicio al cliente,
un Director de operaciones,
un Director de logística,
un Comerciante o
un Vendedor.
Este parámetro es útil cuando un cliente llama a un centro de llamadas
y solicita
asistencia para completar una compra. En ese caso, el operador del
centro de llamadas se conecta y completa el pedido utilizando la identidad
del cliente que llama.
- forUserId
- Igual que forUser, pero identifica al usuario mediante el ID de usuario interno, como se encuentra en la
tabla USERS.
- URL
- La dirección web a la que se llama cuando el mandato se ejecuta
satisfactoriamente. El valor de este parámetro se determina del modo
siguiente: Empiece por los parámetros de entrada del mandato, excepto el
URL.
Añada, sustituyéndolas cuando se produzca un conflicto de nombres, las parejas
nombre-valor adicionales creadas por este mandato.
Finalmente, añada, sustituyéndolas cuando se
produzca un conflicto de nombres, las parejas nombre-valor
que se encuentran en el URL.
Ejemplos
Al mostrar ejemplos, el URL abarca a menudo varias líneas. A efectos de legibilidad,
se organizarán de este modo:
http://misistpral/webapp/wcs/stores/servlet/AddressUpdate?addressId=128
&firstName=Jeffery&URL=/webapp/wcs/stores/servlet/
Tenga en cuenta que un mandato URL aparece generalmente en una sola línea.