Un groupe de tâches est une liste de tâches batch qui sont :

  • lancées en une fois (soit par soumission du groupe, soit par abonnement)
  • exécutées séquentiellement dans le temps (chaque tâche s'exécute lorsque la précédente se termine) en créant chacune leur propre trace.
  • enchaînées à condition que la tâche précédente se soit terminée sans erreur.

Leur définition se fait simplement en donnant une liste de tâches dans un tableau.

Pré-requis

SEEREFERTTO Reportez-vous à la documentation de Mise en oeuvre

Gestion de l'écran

Ecran de saisie

La définition d'un groupe de tâches se fait sur un seul onglet dans lequel on saisit, outre les tâches à lancer, des informations générales (module, contrainte horaire, niveau minimum d'exécution).

Bloc numéro 1

Groupe (champ CODGRP)

Un groupe de tâche permet de rassembler plusieurs tâches qui doivent être exécutées dans l'ordre, les unes après les autres. 
Intitulé (champ ZDES)

Intitulé associé au code précédent

Caractéristiques

Actif (champ 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 autres enregistrements, comme les documents et paramètres,
  • les traitements en masse.

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.
Module (champ MODULE)

Sélectionnez un module pour le paramétrage.

Ce champ vous permet de renseigner si l'écran doit être créé dans la base de données du dossier. Il l'est si le module auquel l'écran est rattaché est actif pour le dossier.
Niveau autorisation (champ NIVEAU)

Ce niveau sera comparé au niveau d'accès de chaque utilisateur qui essaiera de déclencher cette tâche. Il y aura refus si le niveau de l'utilisateur est insuffisant.
Contraintes horaires (champ HOR)

Le code contrainte horaire permet de connaître les tranches horaires durant lesquelles le groupe de tâches peut être lancé.
Continuer si erreur (champ CNTERR)

Cette case permet, lorsqu'elle est cochée, permet d'ignorer une erreur dans une tâche batch, afin de :

  • lancer la tâche suivante lorsqu'on exécute un groupe de tâches
  • réexécuter la tâche lorsqu'elle est lancée de façon répétitive avec une fréquence donnée.

Si elle n'est pas cochée, en cas d'erreur dans une tâche, les tâches suivantes seront "Avortées".
Les erreurs qui peuvent interrompre une tâche sont les suivantes :

  • variable GOK différente de 1 : indique généralement qu'il y a eu une erreur dans une transaction de mise à jour de la base.
  • variable GERRBATCH supérieure à 100 : cette variable, qui peut être positionnée dans le traitement qui exécute la tâche, permet au développeur de distinguer des erreurs mineures d'erreurs majeures.
  • variable GERREUR différente de 0 : dans certains traitements, cette variable est positionnée dans un sous-programme de gestion d'erreur déclenché par l'instruction "Onerrgo". Il s'agit dans ce cas d'une exception remontée par le moteur (variable inexistante, division par zéro, par exemple).
Balise d'éxecution (champ RTTAG)

Tableau Tâches

Séquence (champ SEQ)

Indiquez ici l'ordre dans lequel vous souhaitez exécuter les tâches du groupe. Ces champs permettent d'exécuter les tâches d'un groupe en parallèle ou en série.


Exemple de tâches en parallèle :

Séquence Code tâche
10 Tâche1
10 Tâche2
20 Tâche3
20 Tâche4

Exemple de tâches en série :

Séquence Code tâche
10 Tâche1
20 Tâche2
30 Tâche3
40 Tâche4

Le remplissage des champs Séquence est obligatoire.
Code tâche (champ CODTAC)

Une tâche "batch" est un programme qui peut être exécuté par le serveur périodiquement ou à la demande d'un utilisateur.
Balise d'éxecution (champ RTTAGTAC)

Boutons spécifiques

Copie

Messages d'erreur

Outre les messages génériques, les messages d'erreur suivants peuvent apparaître lors de la saisie :

Code tâche incorrect

La tâche en question ne peut pas être lancée via un abonnement (il s'agit d'une tâche qui n'a pas été normalisée pour fonctionner en mode Web : les rares tâches de ce type sont reconnaissables au fait qu'aucune fonction ne leur est associée).

Tables mises en oeuvre

SEEREFERTTO Reportez-vous à la documentation de Mise en oeuvre