Gestion des tâches
Cette fonction permet de créer de nouvelles tâches batch, ou de modifier les caractéristiques des tâches existantes.
Prérequis
Gestion de l'écran
Écran de saisie
La gestion des tâches s'effectue sous un seul onglet. Une tâche batch se caractérise par un code permettant de l’appeler, ainsi que par un ensemble de caractéristiques techniques définissant le script à lancer. Une tâche batch peut être :
- un programme ADONIX (script),
- un état (impression),
- des tâches système définies par un fichier de commande (script shell sous UNIX™, script sous Windows™).
Une tâche batch est définie par le nom d'une fonction ou par le nom d'un script. Si une tâche est définie comme une fonction, elle hérite des conditions de transfert de paramétrages et d'autorisations (sites autorisés, etc.). Une tâche de ce type peut être incluse dans un groupe de tâches batch.
La plupart des fonctions batch relèvent de ce cas, mais certaines fonctions rares, déterminées par le nom du script, n'en font pas partie.
La création de nouvelles tâches batch de type script (process) suppose la création d'un script standard avec ADONIX AGL, ainsi que la description de la fonction associée.
Un traitement batch peut nécessiter la saisie dynamique de paramètres dans une boîte de dialogue lors de la soumission de chaque tâche. Cette fenêtre peut également être appelée si la tâche est lancée directement. La standardisation du développement des tâches batch gère l’appel à un écran de saisie de paramétrage et renvoie les valeurs correspondantes pour l’exécution, soit immédiatement si la tâche est lancée directement, soit ultérieurement en mode différé.
Bloc numéro 1
| Code tâche(CODTAC) |
|
Une tâche batch est un programme que le serveur peut exécuter périodiquement ou sur demande d’un utilisateur. |
| Intitulé (ZDES) |
Bloc numéro 2
| Actif (ENAFLG) |
|
Sélectionnez cette case à cocher pour activer la fiche courante. Les enregistrements non sélectionnés conservent leur contenu et paramétrage, mais ne pourront pas être utilisés en rappelant leur code dans :
Les habilitations sur une fonction donnée peuvent interdire la création d'une fiche active. Dans ce cas, la case est désactivée par défaut. Elle est modifiable uniquement par un utilisateur autorisé, ou via un Workflow de signature. Si vous désactivez cette case à cocher pour désactiver la tâche, vérifiez si la tâche est liée à des abonnements. Après avoir été désactivée, la tâche ne sera pas exécutée lors de sa prochaine itération. |
| Module (MODULE) |
|
Sélectionnez un module pour le paramétrage. Ce champ vous permet de spécifier si l'écran doit être créé dans la base de données du dossier. Ce sera le cas si le module auquel l'écran est rattaché est actif pour le dossier. |
| Balise d'exécution (RTTAG) |
Bloc numéro 3
| Type tâche (TYPTAC) |
|
Précise s'il s'agit d'un script Adonix ou d'un script exécuté dans le système d'exploitation (script DOS ou Shell). |
Bloc numéro 4
| Time-out (minutes) (TIMOUT) |
|
Permet de spécifier une durée maximale en minutes pour l'exécution de la tâche. Au-delà de cette valeur, le serveur tue la tâche (si la valeur spécifiée est 0, il n’y a pas de time-out). Warning Cette durée est la durée minimale. Le délai réel au-delà duquel la tâche sera arrêtée dépend également des paramètres généraux du serveur. En effet, le contrôle d'arrêt de la tâche s'effectue à intervalles réguliers, lesquels peuvent être définis par un paramétrage. |
| Retard admissible (minutes) (RETARD) |
|
Permet de préciser le retard admissible pour le début des requêtes. Une demande qui n'a pas été exécutée à la date de début planifiée + retard, sera signalée comme étant « hors délai ». La requête peut ne pas être lancée à temps pour plusieurs raisons :
Un retard égal à zéro signifie que la tâche n'a pas de contrainte de délai d'exécution. |
| Niveau autorisation (NIVEAU) |
|
Le niveau sera comparé au niveau d'accès de chaque utilisateur qui tente de lancer cette tâche. Il sera refusé si le niveau de l'utilisateur est insuffisant. |
| Contraintes horaires (HOR) |
|
Ce code est utilisé pour associer une Contrainte horaire à une tâche afin de limiter les temps d'exécution possibles lorsqu'ils sont directement soumis au serveur batch. Lorsqu'elle est soumise par un groupe de tâches, seules les contraintes de temps attachées au groupe sont appliquées. Il en va de même pour un abonnement : les temps d'exécution ne sont pas contrôlés par rapport au code de contrainte de tâche, mais un calendrier d'exclusion est défini directement dans l'abonnement). |
Bloc numéro 5
| Fonction (FONCTION) |
|
Lorsqu'une tâche batch correspond à l'exécution d'une fonction, elle est définie ici. Cela permet d'initialiser le contexte et la vérification les droits d'accès. |
| Script (TRAIT) |
|
Le nom du traitement ou du script système est renseigné ici, lorsque la tâche n'est pas définie par un code fonction. |
| AIDE |
| PARAM |
|
Lorsqu'une tâche batch est définie par une fonction et que cette fonction reconnaît un paramètre (code # dans la fonction), la valeur de ce paramètre est renseignée ici (le nom défini dans le champ Aide de saisie pour la fonction est indiqué avant le champ pour guider l'utilisateur). |
Bloc numéro 6
Bloc numéro 7
Boutons spécifiques
|
Copie |
Messages d’erreur
En plus des messages d'erreur génériques, les messages ci-dessous peuvent apparaître lors de la saisie.
La tâche ne peut pas être associée à un abonnement lorsqu'elle est désactivée.La tâche est utilisée dans un abonnement. Elles seront désactivés lors de leur prochaine itération : $1$.
Tables utilisées
Annexe technique
Pour être conforme aux normes de développement web, une tâche batch doit remplir les critères suivants :
- La fonction qui la définit doit faire référence à une action de type « script standard » (GTRAITE), qui ne contient pas de fenêtre principale,
- elle peut contenir une boîte de dialogue initiale, mais elle peut aussi ne pas en contenir,
- l'action « OUVRE_BATCH » doit inclure l'ouverture des tables nécessaires pour les étiquettes de contrôle de la boîte de dialogue mentionnée précédemment.
La méthodologie précédente d'exécution des tâches batch décrite dans la version 120 reste valable. Toutefois, elle doit contenir l'exécution des scripts qui ne fonctionneront qu'en mode client-serveur. Il est donc fortement conseillé de ne pas l'utiliser.