Gestion des 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é. Cela concerne 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. Pour chaque tâche, vous pouvez définir une Périodicité et Plage horaire.
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 modifier la Périodicité et la Plage horaire. Vous pouvez uniquement renseigner le Nb enregistrements.
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).
Prérequis
Reportez-vous à la documentation de Mise en oeuvre
Gestion de l'écran
Onglet Écran de saisie
On saisit ici à la fois les conditions de lancement (identification du dossier et de l'utilisateur sous l'identification duquel on lance l'abonnement) et les horaires concernés.
Bloc numéro 1
Code abonnement (champ CODABT) |
Identifie le code abonnement. |
Intitulé (champ NOMABT) |
Intitulé associé au code précédent |
Caractéristiques
Dossier (champ DOSSIER) |
Définit le nom du dossier dans lequel sera lancée la requête (le code du dossier courant est proposé par défaut). |
Code utilisateur (champ USER) |
Définit le code d'un utilisateur sous l'identité duquel la tâche sera lancée (le code de l'utilisateur courant est proposé par défaut). |
Mot de passe (champ PASSE) |
Lorsque le dossier ou la tâche doit être exécutée n'est pas le dossier courant, ou si l'utilisateur ne correspond pas au code utilisateur courant, il est nécessaire de saisir le mot de passe correspondant afin de s'identifier. |
Groupe (champ GRP) |
Définit un groupe de tâches à lancer. |
Code tâche (champ TACHE) |
Définit le code de la tâche qui sera lancée automatiquement par le serveur batch. |
Langue (champ 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 (champ DJOUR) |
Lorsque l'abonnement a déjà donné lieu à des exécutions de tâches, ce champ permet de connaître la date de dernière exécution. |
Périodicité
Périodicité (champ PERIO) |
Ce champ définit la périodicité d'exécution de la tâche. Si la période est le mois, on peut indiquer un quantième (date dans le mois comprise entre le 1 et le 31) et/ou cocher la case fin de mois. Si la période est hebdomadaire, il faut cocher un ou plusieurs jours de la semaine. |
Jours exclus (champ CAL) |
Saisissez un code de Calendrier pour exclure des jours spécifiques de l'exécution des abonnements. |
Hebdomadaire
champ JOUR |
Sélectionnez le ou les jour(s) où la tâche sera exécutée chaque semaine. |
Mensuel
Quantièmes (champ 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 (champ 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 du Calendrier. |
Plage horaire
Heure début (champ 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 (champ HFIN) |
Fréquence (mn) (champ 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 Nb enregistrements, la tâche s'exécute à nouveau après le nombre de minutes défini. |
Une seule requête (champ 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 traitement demandé. Dès que le traitement 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. |
Epuration (champ 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 (champ CNTERR) |
Si cette case à cocher est sélectionnée, un abonnement est lancé à nouveau, même en cas d'erreur. |
Heures fixes
Heure (champ 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 (champ 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
Zone date (champ DATZON) |
Utilisez ce champ pour saisir le nom de la zone d'écran à initialiser. |
Date de base (champ DATDEP) |
Permet de renseigner la date de référence pour le calcul. |
Incrément (champ DATNBR) |
Nombre à ajouter ou retirer de la date de référence. |
Unité de temps (champ DATJRS) |
Unité de temps |
Formule (champ DATFRM) |
Utilisez ce champ pour renseigner la formule appliquée dans l'environnement de saisie des paramètres de l'abonnement de la tâche batch : tables ouvertes, variables globales, variables utilisateurs, etc. |
Boutons spécifiques
Paramètres |
Cette action permet d'afficher les paramètres de la tâche. Lorsqu'un groupe de tâches est lancé, une fenêtre intermédiaire s'ouvre où vous pouvez choisir la tâche et ses paramètres.
|
Barre de menus
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.
|
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 fréquence déterminée, une seule demande d'exécution est créée ; à la fin de l'exécution de la 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 (tâche en cours), ou toute suppression (tâche en attente) de l'exécution suivante interrompt le traitement, qui ne sera relancé que le lendemain.
- Par défaut, toute modification de la fréquence ne sera prise en compte que le lendemain.