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
¶meters=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.