URL AddJob

Cette URL planifie un travail pour le compte d'un site ou d'un magasin.

La synchronisation d'un travail planifié est spécifiée par une heure de début et un intervalle. Les tâches planifiées peuvent être récurrentes, s'exécuter à un intervalle spécifique ou ne s'exécuter qu'une seule fois.

Structure de l'adresse URL

http:// host_name/path/
Nom entièrement qualifié de votre Transaction server et du chemin de configuration.

Valeurs des paramètres

langId
Définit ou redéfinit la langue préférée pour la durée de la session ; les langues prises en charge dans le magasin sont répertoriées dans le tableau .STORELANG
URL
Obligatoire : Adresse URL à appeler une fois que la commande a abouti.
nom
Utilisateur au nom duquel le planificateur exécute le travail. Ce paramètre est tiré de la colonne LOGONID de la table USERREG>.
pathInfo
Obligatoire : Commande HCL Commerce qui sera exécutée, par exemple SendTransactedMsg.
queryString
Paramètres de la commande à exécuter. Tous les caractères spéciaux, tels que &, =, / et ? doivent être codés.
début
Obligatoire : Heure à laquelle la première exécution de ce travail doit se produire, au format : JJ:MM:AAAA:HH:MM:SS ; seules les valeurs HH:MM:SS sont obligatoires.
hôte
Nom de l'hôte autorisé à exécuter ce travail. Si ce paramètre est omis, le travail peut être exécuté par n'importe quel hôte. Ce paramètre est nécessaire uniquement si le planificateur s'exécute sur plusieurs hôtes et si un travail doit être limité à un seul d'entre eux. Le nom d'hôte doit figurer sous la forme : name
intervalle
Nombre de secondes entre deux exécutions successives de ce travail. Si ce paramètre est omis, le travail n'est exécuté qu'une seule fois.
tentatives
Nombre de tentatives d'exécution du travail faites par le planificateur en cas d'échec. Ce paramètre doit être utilisé avec le paramètre de délai. Les deux paramètres doivent être présents pour une nouvelle tentative d'exécution du travail.
delay
Nombre de secondes devant s'écouler avant une nouvelle tentative d'exécution du travail. Ce paramètre doit être utilisé avec le paramètre de tentatives d'exécution. Les deux paramètres doivent être présents pour une nouvelle tentative d'exécution du travail.
schedulePolicy
Indique la stratégie devant être mise en oeuvre par le planificateur lorsque l'exécution du travail a échoué. Deux valeurs sont possibles pour ce paramètre :
  • 0 - Le travail est exécuté une seule fois et l'exécution suivante est planifiée pour plus tard ; il s'agit du paramètre par défaut.
  • 1 - Le travail est exécuté autant de fois que nécessaire pour reconstituer toutes les exécutions manquées.
priorité
Numéro associé à la priorité du travail. Cette valeur sera insérée dans la colonne SCCPRIORITY de la table SCHCONFIG. Un nombre élevé indique un travail avec un niveau de priorité élevé.
applicationType
Type d'application utilisée pour exécuter le travail qui est ajouté. Le rôle de ce paramètre est de contraindre les travaux mobilisant de nombreuses ressources à utiliser un nombre limité d'unités d'exécution. Les types d'application et les règles régissant leur accès aux ressources sont définis par l'utilisateur dans le fichier de configuration XML du serveur. Le type d'application par défaut est la valeur null.
storeId
Magasin qui possède le travail planifié.
checkCmdId
Instruction de tâche qui implémente l'interface CheckForWorkCmd utilisée pour déterminer si une commande doit être exécutée ou non.

Exemple 1

L'exemple suivant ajoute un travail avec un point de départ spécifié :


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

Exemple 2

L'exemple suivant planifie un travail qui passe une commande avec le numéro de référence 3. Il s'exécute pour le compte de l'utilisateur wcsadmin, à partir du 21 février 2001 à 12:15 et se répète toutes les 5 minutes (300 secondes). Si la commande échoue, une tentative sera effectuée pour la récupérer en l'exécutant une fois, 60 secondes après l'échec :


   
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

Comportement

  • Définit un travail que le serveur en arrière-plan doit exécuter.
  • Ajoute une entrée aux tables SCHCONFIG et SCHACTIVE. Si l'heure de début a omis l'année, le mois ou le jour, la valeur correspondant à la date actuelle est utilisée. Seules les combinaisons suivantes de point de départ peuvent être omises :
    • an
    • année et mois
    • année, mois et jour
  • Le planificateur exécute la commande au nom de l'utilisateur spécifié par le paramètre name. Ellle s'exécute le nombre de fois indiqué par le paramètre d'intervalle, et relance le travail en fonction des valeurs des paramètres attempts et delay.

Conditions d'exception

Paramètres requis manquants ou valeurs de paramètre incorrectes.