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.

    Referencia relacionada

    IBM copyright