Champs (processus modèle)

Owned by Bertrand Littel
Last updated: 03/05/2023 by Christine Ihler
6 min read

 

Données modèles

Permet de définir des modèles de champ de données.
Accès zoom " donnée"

  • Menu Processus : Fichiers / Définition des données

  • Zoom définition des champs de processus : F8/F9 sur champ "donnée"




Nature : Type de champ utilisé pour stocker les valeurs de la donnée

  •  

    • Titre : Titre pour mise en forme des formulaires (long. : 80)

    • Séparateur : Ligne de séparation pour mise en forme des formulaires

    • Libellé : champ alpha (long. : 80)

    • Libellé long : champ alpha (long. : 250)

    • Date : champ date enregistré sous la forme AAAAMMJJ (long = 8)

    • Heure : champ heure enregistré sous la forme hhmmss (long = 6)

    • Date Heure : champ date + heure enregistré sous la forme AAAAMMJJ hhmmss (long = 14)

    • Entier court : Champ numérique de type entier (long = 4)

    • Entier long : Champ numérique de type entier (long = 10)

    • Montant : Champ numérique de type décimal avec 2 chiffres après la virgule (long = 16)

    • Code 8 : Champ alpha pour code court (long = 8)

    • Code 20 : Champ alpha pour code long (long = 20)

    • Multi-choix : Champ alpha pour code multi-choix (long = 30)

    • Multi-lignes : Champ de type mémo


Conversion : permet de définir s'il y a lieu de convertir les données lors de la saisie dans les formulaires
N° de zoom : détermine quel zoom doit être associé au champ dans le masque de saisie des formulaires.
Maj en-tête : définit quel champ de l'en-tête de processus est associé à la donnée. La mise à jour des données est faite dans les cas suivants :

  •  

    • Lors de la création d'un processus avec passage de paramètres. Exemple Lancement d'un processus lors de la modification d'une commande client avec param =  .

Les données Type et n° de pièce de l'en-tête du processus seront renseignées avec les informations de la commande en cours.

  •  

    • Lors de la création d'un processus automatique avec les données d'initialisations des champs correspondants associés à la première tâche.

    • A l'activation des tâches non manuelles (si on a positionné l'option 'initialisation' à oui pour la tâche en cours).

    • A la validation de la saisie d'un formulaire de processus

Attention il convient de respecter le typage suivant pour que la mise à jour puisse se faire
Champ de l'en-tête (Données identifiantes) :
Code                    Libellé                                  Nature de champ utilisable pour la mise à jour
USERPRINC        Collaborateur                      Code 20 ou Multi-choix
USERGRP           Groupe d'utilisateur            Code 20 ou Multi-choix
TICOD                 Type de tiers                        Code 8 ou Multi-choix
TIERS                  Tiers                                     Code 20 ou Multi-choix
PICOD                 Type de pièce                      Code 8 ou Entier court ou Multi-choix

PREFPINO          Prefixe du N° de pièce       Code20 ou Multi-choix 
PINO                    N° de pièce                         Entierlong ou Multi-choix 
REF                     Référence Article                Libelle, LibelleLong ou Multi-choix
CONTACT           Contact                                 Code 8 ou Multi-choix
EVTNO                N° d'évènement                  Entier long ou Multi-choix
PROJET              Code projet                          Code 8 ou Multi-choix
AFFAIRE            Code affaire                         Code 8 ou Multi-choix
AGILEOID           Identifiant Agiléo                Entier long ou Multi-choix
INDIVIDU            Code Individu                     Code 20 ou Multi-choix
ENTIERCOURT   Entier court                       Entier court ou Multi-choix
ENTIERLONG     Entier long                         Entier long ou Multi-choix
MONTANT          Montant                             Montant ou Multi-choix

Valeur multi-choix

Définit quel sont les valeurs qui seront proposées dans le multi-choix.
On peut saisir
une liste de valeur sous la forme" libellé , code" (ex : Devis,1;Commande,2;BL,3;Facture,4)
une procédure (ex : FONCTION.Chargement_Liste_TachesAgileo).
Fonction de chargement de multi-choix
Type Chargement de multi-choix
Module sptmctrl.dhop
Argument 1 Données saisies dans le champ paramètres
Retour Liste des éléments du multichoix sous la forme (lib1,val1;lib2,val2; …libn,valn)
Ou le nom d'une liste nommée d'éléments de type spEltChoix

Initialisation

Définit la valeur d'initialisation de la donnée.
On peut renseigner :
une valeur
un mot-clé (Collaborateur, CollaborateurTache, CollaborateurTache.Nom, Manageur, Correspondant1, Correspondant2, ou Remplacant)
une donnée du formulaire (FORMULAIRE.codeChamp)
le nom d'une procédure (ex : FONCTION.Initialiser_Collaborateur).

Procédure d'initialisation
Type initialisation
Module sptmctrl.dhop
Argument 1 Donnée à initialiser (passage par paramètre)
Argument 2Données saisies dans le champ paramètres
Lancement des fonctions d'initialisation
Avant la première tâche d'un processus manuel, et chaque fois que le scrutateur lance les tâches à activer :
On exécute les fonctions d'initialisations de données si l'option est cochée dans le formulaire de la tâche et si la donnée est non vide.
On exécute les fonctions de traitement avant tâche
Cas des tâches manuelles
Après la modification d'un champ avec option" réinitialisation des données en aval" : on re exécute les fonctions d'initialisations des données suivantes (et cela même s'il elles contiennent déjà une valeur)
Spécificités des processus automatiques :
Les fonctions d'initialisations sont lancées lors de la création du processus. Les données de l'en-tête sont également mise à jour. (Si la donnée USERPRINC est mise à jour on met aussi à jour le dossier et l'établissement de l'en-tête du processus avec ceux de l'onglet Processus de l'utilisateur principal)
Les fonctions de traitements avant de la 1ère tâche ne sont pas traitées.

Contrôle

Permet le contrôle de la valeur saisie. Exécutée après la saisie d'un champ dans un formulaire.
Fonction de contrôle
Type Contrôle
Module sptmctrl.dhop
Argument 1 Valeur de la donnée à contrôler
Argument 2 Données saisies dans le champ paramètres
Argument 3N° de l'erreur (passage par paramètre)
Argument 4 Nom du fichier qui contient l'erreur (passage par paramètre)
Retour 0 si OK. Sinon autre valeur + n° err renseignée

Recherche de libellé

Permet l'affichage du libellé d'un champ.
Appelée lors du chargement d'un masque de saisie d'un formulaire et lors de la saisie après le contrôle des données.
Fonction de recherche de libellé
Type Recherche de libellé
Module sptmctrl.dhop
Argument 1 Valeur de la donnée à contrôler
Argument 2Donnés saisie dans le champ paramètres
Retour Valeur du libellé

Traitement après modification

Utilisée uniquement dans les tâches manuelles.
Procédure lancée en sortie de champ, après les fonctions de contrôles et de recherche de libellé.
Procédure de traitement après modification
Type Traitement de sortie de champ
Module sptmctrl.dhop
Argument 1 : Valeur de la donnée que l'on vient de modifier
Argument 2 : Données saisies dans le champ paramètres

Liste des fonctions et procédures

Les fonctions et procédures doivent être référencées dans la table des fonctions (Accès Menu Processus : Fichiers / Fonction et procédure)

Champs de processus

Le zoom "champs de Processus" permet de définir les champs qui seront utilisés dans le processus.
Les champs pourront être mis à jour par passage de paramètres lors de la création du processus, par une fonction d'initialisation, ou par saisie dans un formulaire du processus.
Accès zoom "Définition des champs de processus" :

  • Menu Processus : Définition des processus / Données

  • Zoom en-tête de processus modèle bouton "Champ"



Lors de la création d'un champ de processus, le champ nature, ainsi que les données de chargement de multi-choix, d'initialisation, de contrôle, de recherche de libellé et de traitement après sont associés à la donnée modèle sont reprises par défaut.
Code : Code du champ. c'est la valeur qui sera utilisée pour récupérer la valeur du champ dans les diverses opérations du processus

Invite : C'est le libellé qui sera utilisé comme invite dans les formulaires de saisie.

  •  

    • Si un champ n'a pas d'invite de saisie, il sera positionné sur la même ligne de saisie que le champ précédent du masque

    • Pour un champ de type "Titre" si aucune donnée d'initialisation n'est saisie, on initialisera le champ avec la valeur de l'invite.

N° d'ordre : le n° d'ordre permet de définir l'ordre dans le lequel les champs sont présent dans les masques des formulaires
Réinitialisation des champs suivants : Si cette option est activée, Après la modification d'un champ dans un formulaire, tous les champs avec un n° d'ordre supérieur sont réinitialisés. Attention cette réinitialisation écrasera les anciennes valeurs des champs. Elle sera valable pour tous les champs suivants dans tous les formulaires. A partir de la version X.4, il est possible de paramétrer une réinitialisation plus précise au niveau des formulaires de tâches.
Attention : Le nombre de champ est limité à 100 par processus si on gère des formulaires.
Remarque : pour positionner 2 champs sur la même ligne dans un formulaire de saisie il ne faut pas mettre d'invite de saisie sur le 2ème champ