Abonnements
Utilisez cette fonction pour définir des abonnements lancés régulièrement par le serveur batch. Ces abonnements sont exécutés selon un planning prédéterminé. Sont concernées les tâches et les groupes de tâches. Vous pouvez définir une partie ou l'ensemble des paramètres appliqués aux règles d'exécution des tâches, par exemple la période concernée ou la fréquence.
Pour les tâches batch comptables
Si le paramètre MULBATCH – Tâche batch multi-instances (chapitre CPT, groupe ACC) a pour valeur Oui, vous pouvez créer une tâche comptable par ligne dans la fonction Tâches comptables (GESBTC). Chaque tâche est liée à un unique abonnement lié au un dossier particulier.
Si le paramètre MULBATCH - Tâche batch multi-instances (chapitre CPT, groupe ACC) a pour valeur Non, il n'y a qu'une seule tâche comptable.
Vous ne pouvez pas changer le statut Actif d'un abonnement comptable dans cette fonction. Pour cela, vous devez utiliser la fonction Surveillance tâche compta (VALPCE). Vous trouverez plus d’informations sur la fonction VALPCE ici.
Prérequis
Gestion de l'écran
Écran de saisie
Les conditions de lancement (identification du dossier et de l’utilisateur dont l’identification permet de lancer la tâche récurrente) et les heures concernées sont renseignées dans cet écran.
Bloc numéro 1
| Code abonnement(CODABT) |
|
Identifie le code de l'abonnement. |
| Intitulé (champ NOMABT) |
|
Intitulé associé au code précédent |
Caractéristiques
| Dossier (DOSSIER) |
|
Il définit le nom du dossier dans lequel la tâche sera lancée (le code du dossier courant est proposé par défaut). |
| Code utilisateur (champ USER) |
|
Il définit le code de l'utilisateur sous l'identité duquel la tâche sera lancée (par défaut, le code de l'utilisateur courant est proposé). |
| Mot de passe (PASSE) |
|
Lorsque le dossier ou la tâche à exécuter n'est pas le dossier ou la tâche courante, ou si l'utilisateur ne correspond pas au code utilisateur courant, il est nécessaire de renseigner le mot de passe correspondant afin de procéder à l'identification. |
| Groupe (GRP) |
|
Définit un groupe de tâches à lancer. Assurez-vous que le groupe ne contient ni tâche inactive, ni sous-groupe inactif, ni sous-groupe comportant une tâche inactive. Si le groupe contient une tâche inactive, s’il contient un sous-groupe inactif ou si un sous-groupe contient une tâche inactive, une erreur est affichée dans la trace serveur.tra. |
| Code tâche(TACHE) |
|
Définit le code de la tâche qui sera lancée automatiquement par le serveur batch. |
| Langue (LAN) |
Bloc numéro 3
| 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 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. |
| Dernière exécution (DJOUR) |
|
Lorsque l'abonnement a déjà exécuté des tâches, ce champ indique la date de la dernière exécution. |
Périodicité
| Périodicité (PERIO) |
|
Ce champ définit la fréquence d'exécution de la tâche. Si la périodicité est mensuelle, il est possible d’indiquer un jour du mois (compris entre 1 et 31) et/ou de sélectionner la case Fin de mois. Si la périodicité est hebdomadaire, vous devez sélectionner un ou plusieurs jours de la semaine. |
| Jours exclus (CAL) |
|
Saisissez un Code de calendrier de serveur batch pour exclure des jours spécifiques de l'exécution des abonnements. |
Hebdomadaire
| JOUR |
|
Sélectionnez le ou les jour(s) où la tâche sera exécutée chaque semaine. |
Mensuel
| Quantièmes (QUANT) |
|
Si vous avez sélectionné Mensuel, vous pouvez indiquer un jour du mois entre 1 et 31, et/ou sélectionner l'option Fin de mois. |
| Fin de mois (FDM) |
|
Si vous avez choisi Mensuel, sélectionnez cette case à cocher pour exécuter la tâche le dernier jour de chaque mois, sauf si la date est exclue par un Code de calendrier. |
Plage horaire
| Heure début (HDEB) |
|
Saisissez une heure de début et de fin pour limiter l'exécution de la tâche à cette période de temps. |
| Heure fin (HFIN) |
| Fréquence (mn) (FRQ) |
|
Saisissez le nombre de minutes entre plusieurs itérations d'une tâche. Par exemple, si la première exécution ne traite pas tous les No. enregistrements, la tâche s'exécute à nouveau après le nombre de minutes défini. |
| Une seule requête (ONE) |
|
Sélectionnez cette case si l'abonnement est défini selon une fréquence. Lorsque cette case est sélectionnée, une seule requête est lancée par jour pour exécuter le script demandé. Dès que le script est terminé, la tâche se met en veille pendant le nombre de minutes définies par la fréquence, et reprend son exécution jusqu'à l'heure de fin. La requête affiche le statut En cours pendant tout l'intervalle d'exécution. Cela permet de s'assurer que la requête est toujours présente en mémoire une fois lancée, au détriment d'autres tâches si le nombre maximum de tâches lancées simultanément est atteint. |
| Épuration (EPUR) |
|
Cette case à cocher peut uniquement être sélectionnée pour un abonnement défini selon une fréquence. Lorsque cette case est sélectionnée, aucune trace des exécutions successives de la tâche n'est conservée dans la fonction de gestion des requêtes. Seule la requête en cours et la requête précédente sont conservées dans la table correspondante. |
| Continuer si erreur (CNTERR) |
|
Si cette case à cocher est sélectionnée, un abonnement est lancé à nouveau, même en cas d'erreur. |
Heures fixes
| Heure (HEURE) |
|
Quand la tâche n'est pas définie selon une fréquence, vous pouvez choisir de la lancer à trois heures différentes dans une journée. |
| Exécution forcée (FORCE) |
|
Cette case à cocher peut uniquement être sélectionnée si des heures fixes d'exécution ont été définies pour un l'abonnement concerné. Cela permet de s'assurer que la demande d'exécution est créée, même si l'heure est dépassée au moment où le serveur batch traite les abonnements de la journée. Par exemple, si une tâche est programmée à 7:00, 10:00 et 15:00, mais si le serveur batch démarre un matin à 8:00 :
|
Tableau Date relative
Boutons spécifiques
Barre de menu
|
Sélectionnez cette option pour relancer l'abonnement si les horaires définis incluent l'heure actuelle, et que la tâche n'est pas déjà en train de tourner.
|
Messages d’erreur
Tous les messages d'erreur sont des messages génériques.
Tables mises en œuvre
Fonctionnement technique des abonnements
Au démarrage du serveur batch (ou après le passage de minuit lorsque le serveur batch tourne continuellement), tous les abonnements d'une journée sont créés sous la forme de demandes d'exécution de tâches visibles dans le gestionnaire des tâches batch.
Pour les abonnements avec une périodicité déterminée, une seule demande d'exécution est créée : à la fin de l'exécution d'une tâche, une nouvelle demande d'exécution est créée.
Ainsi, après la première exécution d'un abonnement avec une fréquence déterminée :
- dans la Gestion des requêtes, toute interruption (d'une tâche en cours), ou toute suppression (d'une tâche en attente) de l'exécution suivante interrompt le script, qui ne sera relancé que le lendemain,
- par défaut, toute modification de la périodicité ne sera prise en compte que le lendemain.