URL AddJob

Este URL planifica un trabajo en nombre de un sitio o una tienda.

La programación de un trabajo planificado se especifica mediante una fecha y hora de inicio y un intervalo. Los trabajos planificados pueden ser recurrentes, y ejecutarse en un intervalo de tiempo específico, o ejecutarse una sola vez.

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 restablece el idioma preferido durante el tiempo que dura la sesión; los idiomas soportados para una tienda se encuentran en la tabla STORELANG.
URL
Se necesita: El URL al que se debe llamar cuando el mandato se completa satisfactoriamente.
name
El usuario en cuyo nombre el planificador ejecuta el trabajo. Este parámetro se extrae de la columna LOGONID en la tabla USERREG.
pathInfo
Se necesita: El mandato de HCL Commerce que se ejecutará, por ejemplo, SendTransactedMsg.
queryString
Los parámetros del mandato que se ha de ejecutar. Todos los caracteres especiales como, por ejemplo, , =, / y ?, deben estar codificados.
iniciar
Se necesita: La hora a la que debe llevarse a cabo la primera ejecución de este trabajo en el formato: AAAA:MMM:DD:HH:MM:SS; solo son obligatorios los valores HH:MM:SS.
host
El nombre del sistema principal que tiene permiso para ejecutar este trabajo. Si se omite este parámetro, el trabajo lo puede ejecutar cualquier host. El parámetro solo es necesario si el planificador se está ejecutando en varios sistemas principales y hay un trabajo que debe restringirse a uno de ellos. El nombre host debería tener la siguiente forma: name
interval
El número de segundos entre las sucesivas ejecuciones de este trabajo. Si se omite este parámetro, el trabajo se ejecuta una sola vez.
attempts
El número de veces que el planificador reintenta el trabajo si éste no se ejecuta satisfactoriamente. Este parámetro debe utilizarse junto con el parámetro Segundos entre reintentos. Ambos parámetros deben estar presentes para reintentar el trabajo.
delay
El número de segundos que deben transcurrir antes de reintentar un trabajo anómalo. Este parámetro debe utilizarse junto con el parámetro de Intentos para el trabajo. Ambos parámetros deben estar presentes para reintentar el trabajo.
schedulePolicy
Especifica la política que ha de utilizar el planificador cuando la ejecución del trabajo ha fallado. Se definen dos valores posibles:
  • 0 - El trabajo se ejecuta una sola vez y la siguiente ejecución se planifica para el futuro; este es el valor predeterminado.
  • 1 - El trabajo se ejecuta tantas veces como sea necesario para recuperar todas las ejecuciones fallidas.
prioridad
El número asociado a la prioridad de este trabajo. Este valor se insertará en la columna SCCPRIORITY de la tabla SCHCONFIG. Un número mayor indica un trabajo con una prioridad más alta.
applicationType
El tipo de aplicación que se utiliza para ejecutar el trabajo que se va a añadir. La finalidad de este parámetro es restringir los trabajos que consumen muchos recursos a un número limitado de hebras. Los tipos de aplicaciones, y las normas que rigen su acceso a los recursos, los define el usuario en el archivo de configuración de servidor XML. El tipo de aplicación predeterminado es "null".
storeId
La tienda que es propietaria del trabajo planificado.
checkCmdId
Un mandato de tarea que implementa la interfaz CheckForWorkCmd utilizada para determinar si un mandato se ha de ejecutar o no.

Ejemplo 1

El ejemplo siguiente añade un trabajo con una hora de inicio especificada:


http://myhostname/webapp/wcs/stores/servlet/AddJob?start=2000:07:15:14:15:20
    
&pathInfo=InterestItemDisplay&URL=basemall.jsp&name=login999&queryString=listId%3D

Ejemplo 2

El ejemplo siguiente planifica un trabajo que formaliza un pedido con el número de referencia 3. Se ejecuta en nombre del usuario wcsadmin, empezando el 21 de febrero de 2001 a las 12:15 PM y se repite cada 5 minutos (300 segundos). Si el mandato no se ejecuta satisfactoriamente, se realizará un intento de recuperación ejecutándolo una vez, 60 segundos después de la anomalía:


   
http://myhostname/webapp/wcs/stores/servlet/AddJob?pathInfo=OrderProcess
   
&parameters=orderId%3D3&interval=300&name=wcsadmin&start=2001:12:15:00:00:00
    &attempts=1&delay=60&URL=/demomall/basemall.html

Comportamiento

  • Establece un trabajo para que lo ejecute el servidor subordinado.
  • Añade una entrada a las tablas SCHCONFIG y SCHACTIVE. Si en la fecha y hora de inicio se ha omitido el año, el mes o el día, se utiliza el valor correspondiente a la fecha actual. Solo pueden omitirse las siguientes combinaciones de fecha y hora de inicio:
    • año
    • año y mes
    • año, mes y día
  • El planificador ejecuta el mandato en nombre del usuario especificado en el parámetro name. Se ejecuta el número de veces que indique el parámetro interval y reintenta el trabajo según los valores de los parámetros attempts y delay.

Condiciones de excepción

Faltan parámetros necesarios o hay valores de parámetro no válidos.