Processus modèle : tâche

Owned by Christine Ihler
Last updated: 27/09/2021

Gestion des tâches des processus modèles

Tâches

Les tâches sont les opérations que doit exécutés le processus.
Accès

  • Menu Processus : Définition des processus / Tâche
  • Zoom en-tête de processus modèle bouton "Tâche"

Données communes

Informations à renseigner qu'elle que soit le type de tâche.

Libellé : Libellé de la tâche, sera affichée dans les formulaires et dans la liste des "tâches en-cours". A partir de la version X.4, il est possible de rajouter des balises avec des mot clé, des références à un champ du processus ou un champ d'une tables liées au processus. Les balises sont évaluées : au niveau du zoom des tâches à traiter et du widget des taches à traiter.
Etape critique : Positionner un flag étape critique : permet de dire que la fin de cette étape marque un non-retour. Lorsque cette étape sera terminée, le flag "tâche critique atteinte" sera remonté au niveau de l'en-tête du processus et celui si ne pourra plus être annulé par son "créateur".
Type de tâche : défini l'opération qui doit être exécutée.
Priorité : Définit la priorité de la tâche. Le scrutateur traite les tâches par ordre de priorité
Etape : Etape associée à la tâche. (une étape est considérée comme terminée lorsque toutes les tâches appartenant à cette étape sont terminée)
Durée d'attente : Définit l'attente minimale entre le lancement d'une tâche et la fin de l'étape précédente.
Durée théorique : Permet de calculer une date de fin théorique d'une tâche. Le calcul est fait au moment du passage à l'état "A traiter". Ne concerne que les tâches "manuelles"
Condition :Condition testée si la suite qui déclenche la tâche est de type "condition de tâche suivante réalisée" ou "condition de tâche suivante non réalisée"
Etape terminée : La tâche ne sera pas exécutée tant que cette étape n'est pas terminée.

Utilisation des fonctions

On peut utiliser des fonctions dans le paramétrage des tâches.
Les fonctions doivent être présentes dans le module « sptmctrl.dhop » (ou sa surcharge)
Appel d'une fonction sans paramètre : FONCTION.NomFonction
Appel d'une fonction avec paramètre : FONCTION.NomFonction.Param
Le paramètre de la fonction peut être :

Une valeur du formulaire : FORMULAIRE.Nomchamp ou FORM.NomChamp
Un mot clé : MotCLe.Mot
Une valeur de champ : NomRecord.NomChamp
Une chaîne

Chargement des enregistrements lors du traitement des tâches

Avant le traitement des tâches on charge des enregistrements publics en fonction des données présentes dans l'en-tête du processus.

  • Module commun
    • MUSER (Utilisateur) si collaborateur du processus présent
    • MUSERGRP (Groupe d'utilisateurs) si Groupe d'utilisateurs présent
  • Commerce et logistique
    • PRO (Pospect) si type de tiers = prospect et Code tiers présent
    • CLI (Client) si type de tiers = client et Code tiers présent
    • FOU (Fournisseur) si type de tiers = fournisseur et Code tiers présent
    • TIA (Tiers interne) si type de tiers = interne et Code tiers présent
    • T2 (contact) si code tiers et code contact présents
    • ENT (en-tête de pièce) si type de pièce,  préfixe et et numéro de pièce présents
    • ART (Article) si code article présent
    • CTRLFAENT (Contrôle facture) si N° de contrôle facture présent
    • DHBENT (DataHub) si Numéro de DataHub présent
  • CRM
    • EVTTIERS (Evénement CRM) si code évènement CRM présent
  • Paie
    • PINDIVIDU (Individu paie) si code individu présent
    • PCONT (Contrat de paie) : dernier contrat de paie actif si code individu présent
  • Compta
    • CAT (Ecriture en attente) si n° d'écriture présent
  • Gestion à l'affaire
    • PRJAV (Opportunité) si le code opportunité est présent
    • PRJAP (Affaire) si code affaire présent
    • GPAELEM (Elément d'affaire) si indice et élément d'affaire présents
    • GPAACTIVITE (Activité d'affaire) si indice, élément d'affaire et activité présents
    • GPAEVT (Evènement d'affaire) si indice, élément d'affaire et évènement d'affaire présents
  • Gestion des ressources matérielles
    • GMMAT (Matériel) si N° de matériel présent

Ouverture pour chargements complémentaires

Faire une surcharge de la fonction SP_Lire_Tables_liees_entete_Ap du module sptm000.dhop.

Recherche du libellé des champs du processus

Le libellé des champs du processus est accessible par

Il correspond au libellé saisi dans la définition du champ

Recherche du libellé de la valeur des champs du processus

Le libellé de la valeur des champs du processus est accessible par

Il sera recherché à l'aide de la fonction de recherche de libellé saisie dans la définition du champ


Tâche "Générer un événement"


Données de l’événement créé :
Code : Le code de l'événement est celui paramétré au niveau de la tâche.
Statut : Les statuts rendez-vous ou tâche sont ceux du code événement sauf si on modifie un statut par l'intermédiaire de la chaîne de paramètres.
Utilisateur : Le code utilisateur de l'évènement créé est pris par le premier champ non vide trouvé :

    • Utilisateur renseigné dans le champ 'A réaliser par' de la tâche.
    • Utilisateur de la tâche
    • Collaborateur du processus


Mode test : si on est en mode test l'utilisateur de l'évènement est l'administrateur du processus
On peut aussi forcer la valeur de l'utilisateur de l'évènement à l'aide d'un paramètre
Date : La date est positionnée avec la date et l'heure courante mais elle peut être modifiée par le paramétrage de la chaîne de paramètres.
Libellé : Le libellé est positionné avec la zone 'libellé evt' de la tâche qui est analysée et traduite : Elle peut contenir des noms de champs ou des mots clés ou des données de formulaire.
Note : La note est constituée par la note traduite de la tâche
Fichiers joints : Si la case 'Attacher les fichiers joints' est cochée, les fichiers joints de l'entête de processus opérationnel sont rattachés à l'événement.
Collaborateur : Il est possible de rattacher plusieurs collaborateurs à l'événement, en utilisant la zone 'Destinataire'. Syntaxe possible :

Les crochets sont optionnels

    • Ce champ peut contenir une énumération d'items séparés par ";" ou ";;"
    • Chaque item peut représenter un code collaborateur, un groupe, un manager de groupe, un mot clé correspondant à un collaborateur, une donnée de formulaire de type CODE20.
    • Mode test : si on est en mode test les collaborateurs ne sont pas associés à l'évènement mais leur nom est ajouté en fin de la note de l'évènement.

Paramètre : Il est possible de forcer la valeur des données de l'évènement généré. La chaîne de paramètre permet de forcer des champs avec des valeurs. Les crochets sont optionnels.

    • Syntaxe :


Tâche "Modifier un évènement"

L'évènement modifié est celui renseigné dans l'en-tête du processus.
Le code évènement s'il est renseigné remplacera le code existant.
Les données de l'évènement à modifier doivent être renseignées dans le champ paramètre.
La note de la tâche en cours est insérée dans la note de l'évènement
L'option "attacher les fichiers joints" permets de rattaché à l'évènement modifié les fichiers joints à l'en-tête du processus en cours.

Tâche "Envoi de mail"


Eléments du mail :
Destinataires : liste des destinataires du mail. Enumérations de codes utilisateur, et/ou de groupes d'utilisateur, et/ou d'adresses mail. Utilisation possible des mots clés et de données de formulaire. Si le processus est en mode test (Case à cocher sur la fiche du processus modèle), les mails sont envoyés à l'administrateur du processus et les destinataires sont rajoutés à la fin du texte du message.
Répondre à : Définit le compte émetteur pour positionner le destinataire en cas de réponse
Objet : Objet du mail.
Détail : Corps du message.
Dans le champ destinataires, on peut utiliser :

  • Des adresses mail
  • Des codes utilisateur : on recherchera l'adresse mail de l'utilisateur et de son remplaçant le cas échéant
  • Des groupes : si une adresse mail est saisie au niveau du groupe, on ne prendra que celle-ci. Sinon on rajoutera l'adresse de tous les membres actifs du groupe ainsi que l'adresse du responsable du groupe, plus leur remplaçant le cas échéant.
  • Des mots-clés : Administrateur, Collaborateur (Collaborateur du processus), CollaborateurTache (Collaborateur de la tâche), Manager (du collaborateur du processus), Correspondant1(du collaborateur du processus, Correspondant2(du collaborateur du processus), Remplacant (du collaborateur du processus), Tiers, et Contact
  • Des champs du formulaire : contenant un code groupe ou un code utilisateur
  • Des Manager de groupe

  • Des fonctions : Fonction.NomFonction.Param

Si on met plusieurs destinataires, il faut les séparer par ";"
On peut rajouter l'information devant les adresses
Mode test : Si le processus est en mode test le mail ne sera adressé qu'à l'administrateur du processus. La liste des destinataires est ajoutée en fin de mail

Dans l'objet et dans le détail du mail, on peut utiliser des :

Ex : mail envoyé au collaborateur du processus et à son manager lors d'une demande d'achat
DAction : Renseigner ici les données à ajouter au fichier DACTION qui sera associé au mail.
Un fichier DACTION associé à un mail permet l'ouverture direct d'un programme Diva depuis OutLook

Droit à la déconnexion

Dans le cadre du droit à la déconnexion, vous pouvez dorénavant limiter les plages horaires d'envoi de mail à l'aide d'un calendrier.
Si ce calendrier est présent, les tâches envoi de mail ne sont effectuées que pendant les horaires de travail définies dans ce calendrier.
Le calendrier doit être positionné au niveau des paramètres généraux :
Menu : Administration / Paramètre / Paramètres généraux

Tâche "manuelle"

Une tâche manuelle est associée à une saisie de formulaire. Elle peut être réalisé par :

  • Un utilisateur
  • Un membre d'un groupe désigné par une affectation de la tâche (Si l'option "choisir le collaborateur valideur" est cochée)
  • Tous les membres d'un groupe (Si l'option "validation par tous les membres" est cochée)

Dans le champ "A réaliser par" on peut utiliser :

  • Un code utilisateur
  • Un code de groupe d'utilisateurs
  • Un mot clé (MotCle.NomMotCle)
  • Un champ du processus (Form.NomChamp)
  • Une fonction Fonction.NomFonction ou Fonction.NomFonction.Param


Ex : tâche validation RH. Doit être faite par un utilisateur du "groupe rh"


Mode test : Si le processus est en mode "test" la tâche sera à traiter par l'administrateur du processus

1ère tâche des processus manuels : si la première tâche est une tâche manuelle elle sera toujours effectuée par l'utilisateur courant et la saisie du formulaire attaché est lancée directement. On ne tient pas compte de l'information saisie dans le champ "A réaliser par". Inutile d'utiliser une suite "choix manuel", un bouton "valider" est créé automatiquement.
Dans le cas d'un processus déclenché par une ACTION le bouton abandonner est inactif
Si on veut que la première saisie soit effectuée par un autre utilisateur que l'utilisateur courant il faut rajouter une tâche "Sans action" avec suite inconditionnelle vers la tâche manuelle.

Tâche "Programme batch" ou "Programme batch wait"

Permet d'appeler un programme par « ProgramCall ».
Avant l'appel du programme, les droits utilisateurs sont changés aux profits des droits du créateur du processus (procUser)
ATTENTION : Pour que ce changement de droits puisse se faire il faut que l'utilisateur qui a lancé le scrutateur est le droit 'HIP'. Dans le cas contraire les droits utilisateurs restent ceux de l'utilisateur courant.
Passage de données et ouverture avant l'appel du programme par « ProgramCall » :
Ping("Status",1)
Ping("spxz" , SPxz)
Ping("zechange", MZ)
Ping("Param", Param)
Ping("SOPEENT",SOPEENT)
Ping("SOPETACHE",SOPETACHE)
SP_Xmt_Call('Appeler_Programme_Batch_AV')
Exemple :

Si on veut passer plusieurs paramètres il faut les séparer par ';;'
Les paramètres peuvent être :
des mots clés : MOTCLE .motcle
des valeurs de formulaire FORMULAIRE.CodeChamp
des fonctions: Fonction.NomFonction ou Fonction.NomFonction.Param.
des valeurs de champs : NomRecord.NomChamp
Des chaînes
On peut rajouter une fonction de formatage au paramètres (voir « Tâche fonction »)

Tâche "Fonction"

Une tâche de type "Fonction" permet d'appeler une fonction présente dans un module de l'ERP

Fonctions utilisables dans une tâche de type fonction

Appel de la fonction "nom_fonction".

Les fonctions doivent être référencées dans la table des fonctions de tâche (Accès Menu Processus : Fichiers / Fonction d'action de tâche).

il faut préciser le module d'appartenance de la fonction, et le nombre de paramètres attendus (max 9)


Paramétrage d'une tâche de type "fonction"

Au niveau de la tâche de type fonction, il faut préciser la fonction que l'on veut appeler et les paramètres à passer.


Les paramètres de la fonction doivent être séparés par ' ;;'
Les paramètres peuvent être :
des mots clés : MOTCLE .motcle
des valeurs de formulaire FORMULAIRE.CodeChamp
des fonctions: Fonction.NomFonction ou Fonction.NomFonction.Param.
des valeurs de champs : NomRecord.NomChamp
Des chaînes
On peut rajouter une fonction de formatage aux paramètres.
Le format doit être indiqué entre { } et compréhensible par la fonction 'String' du langage.
Exemple {LU}FORM.valideur : Pour faire un cadrage gauche et forcer en majuscule le champ »valideur » du processus
Le format doit être une combinaison des caractères suivantes :

  • L Cadrage à gauche
  • M Centrage
  • R Cadrage à droite
  • A Eliminer tous les blancs
  • B N blancs : 1 blanc
  • 0 Remplacer les espaces par 0
  • * Remplacer les espaces par *
  • U Tout majuscules
  • L(L minus)Tout minuscules
  • 1 Premier car. de la chaîne majuscule puis minuscule
  • E Premier mot à espace
  • C Ne conserve que le premier mot
  • I Inversion ( AZE — EZA )
  • F Filtrage des caractères non affichables
  • D(d,f)Suppression des caractères situés entre la position d et la position f incluses

Tâche "Lancement processus"

Il faut renseigner le nom du processus et des paramètres si besoin.
Les paramètres peuvent être :
des mots clés : MOTCLE .motcle
des valeurs de formulaire FORMULAIRE.CodeChamp
des fonctions: Fonction.NomFonction ou Fonction.NomFonction.Param.
des valeurs de champs : NomRecord.NomChamp
Des chaînes
On peut rajouter une fonction de formatage au paramètres (voir « Tâche fonction »)
Collaborateur du nouveau processus
Le collaborateur du nouveau processus est celui défini dans le champ « à réaliser par ».
Si le champ « à réaliser par » est vide c'est l'administrateur du processus en cours qui sera pris en compte.
A partir de la version 10.4 :

  • On peut utiliser : un code utilisateur, un mot clé, un champ de formulaire, ou une fonction dans le champ « à réaliser par ».
  • Si le champ «à réaliser par » n'est pas renseigné, on prend le collaborateur du processus en cours
  • Si le champ «à réaliser par » n'est pas renseigné et que le collaborateur du processus en cours n'est pas défini, on prend l'administrateur du processus en cours.

Tâche "Validation étape Agiléo"

Préciser dans "Paramétres" la réponse attendue par la tâche du workflow Agiléo
Le numéro de tâche du workflow Agiléo doit être renseigné dans la donnée "Identifiant Agiléo" de l'en-tête du processus.
Si Agiléo attend des paramètres issus d'un champ de formulaire, il faut que ceux si soient visibles dans la tâche en-cours. La nature des champs doit être de type libellé long.
Ils sont alors envoyé à agiléo sous la forme " Identifiant donnée = valeur donnée"

La chaîne envoyée à Agiléo sera : Accepter=True
Si en plus le processus a un champ nommé "Décideur" dans lequel on a saisi la valeur "Monsieur X"
La chaîne envoyée à Agiléo sera : refuser=True, Décideur=Monsieur X