Fonctions

Spécifie le code de la fonction. Les codes qui commencent par "GES" sont générées automatiquement par le superviseur de gestion d'objet.

Lorsqu'une fonction est créée, il est indispensable de la référencer dans un menu, afin que cette fonction puisse être appelée. Les menus sont paramétrés par utilisateur, mais un utilisateur de référence existe, appelé ADMIN, dont le nom est modifiable à l'aide du paramètre ADMUSR. Ces menus contiennent toutes les fonctions et peuvent servir de modèle pendant la création des menus. Par conséquent, un menu de référence indiquant où la fonction se trouve est défini à cet endroit.

Le menu supérieur dans l'arborescence standard des menus est appelé GENE. Toutes les fonctions doivent être référencées, que ce soit dans ce menu GENE ou dans un autre menu accessible via le menu GENE. Les contraintes suivantes existent :

  il n'est pas possible d'avoir plus de 30 choix dans un menu,

  il n'est pas possible d’avoir plus de 4 niveaux de sous-menus.

L’intitulé de menu est le texte traduisible qui apparaît dans le menu utilisateur pour nommer la fonction.

Indique le rang auquel la fonction apparaîtra dans le menu ci-dessus. Dans un menu, les fonctions sont triées par rang dans l'ordre ascendant.

Indique le module qui utilise cette fonction. Si la fonction est utilisée dans plusieurs modules, choisissez "Superviseur".

Si ce champ ne contient pas de valeur, la fonction sera toujours active et générera une ligne de menu pour l'utilisateur ADMIN. Si ce champ correspond à un code activité inactif, la fonction ne sera pas active. Si ce champ commence par X, Y ou Z, la validation de dossiers ne met pas à jour la fonction.

Indique le type de fonction : traitement ou sous-menu.

S’il est renseigné, le traitement correspond :

• soit au nom du traitement à exécuter à la condition qu'il n’ouvre pas la fenêtre,
• soit au nom du menu.

Pour une fonction de type traitement, la méthode recommandée consiste à renseigner l'action, si elle n'est pas de type "traitement divers", plutôt que de renseigner directement le traitement.

Lorsque la fonction est liée à un objet, le champ "Type accès objet" est automatiquement défini. Il est utilisé pour proposer les 3 codes suivants pour les autorisations fonctionnelles : C (Création), M (Modification), D (Suppression).
Pour n’importe quel objet, il sera possible de limiter les autorisations fonctionnelles en n’autorisant pas la création et/ou la modification et/ou la suppression.

Lorsque le champ "Autorisation site" est défini, il permet de définir dans le détail les autorisations fonctionnelles par site ou groupe de site.

Remarque : ce paramétrage n'est pas disponible pour GESFCY.

Cette case à cocher permet de rendre la fonction exécutable même si le dossier a été défini en mode "mono-module", c'est-à-dire qu'il n'autorise aucune fonction ni module. Un dossier est défini en mode mono-module par une fonction exclusive.

Ces deux champs sont utilisés pour définir le nom des deux codes d'état pouvant être appelés par les fonctions d’impression de fichiers et d’énumération de fichiers. Ces codes sont contenus dans les variables suivantes : GREPORT1 et GREPORT2. De manière générale, la fonction d’impression concerne l’enregistrement courant (la fonction n'est en principe pas disponible s'il n'y a pas d’enregistrement courant), tandis que la fonction Liste est disponible dans tous les cas. Dans le cas d'une fonction liée à l'objet, le superviseur gère ces boutons (activation, désactivation, exécution). Pour toutes les autres fonctions, le développeur dans la fonction est supposé gérer l'appel à ces deux états, ainsi que l'activation.

Paramétrage des autorisations relatives à cette fonction, pour le menu "Navigation/Aller à la fonction" :

 Autorisée : cette fonction est accessible depuis la navigation,

 Interdite vers cette fonction : cette fonction n'est pas accessible depuis la navigation si, par exemple, un contexte d'appel est nécessaire,

 Interdite depuis cette fonction : la navigation est interdite depuis cette fonction lorsque, par exemple, il est nécessaire de protéger le contexte courant,

 Interdite dans tous les cas : il est interdit d’accéder à cette fonction depuis la navigation et d’accéder à la navigation depuis cette fonction.

Ce tableau est utilisé pour définir les codes option (maximum 20) sous la forme d'une lettre et d'un commentaire associé. Les lettres minuscules sont réservées pour les développements spécifiques/personnalisés. Pour chaque autorisation fonctionnelle, cette lettre peut être sélectionnée (ou non) afin d’ajouter les options à la fonction. Lors de l'exécution d'une fonction, le superviseur charge la variable globale GUSRAUZ(n) avec les codes option autorisés. n est l'index qui indique la décomposition des autorisations par site. Le développeur peut lier une partie de son traitement à la présence (ou non) d’un code option dans cette variable.

Ce champ permet de définir la fonction qui régira l'accès à ce paramètre. Cela permet d'éviter les erreurs d'autorisations relatives aux accès. Voici un exemple. Le bouton Validation dans la fonction « Facture tiers client » (GESBIC) correspond à la fonction BPCVAL. Il est donc possible de contrôler l'accès au bouton selon les autorisations définies dans la fonction BPCVAL.

Ce code activité régit la présence (ou non) de l'option dans la fonction.

Ce tableau est utilisée pour définir une liste de variables globales qui doivent être affectées afin de donner au traitement d’appel un contexte plus spécifique. Ces variables sont initialisées par la fonction lorsque le traitement est appelé depuis le menu.

Spécifie la valeur à affecter à la variable de la même ligne. Veillez à respecter son type (aucun contrôle n’est réalisé).

Ce code activité permet de protéger la variable pendant une mise à jour de dossier.

L'action qui sera exécutée au lancement de la fonction est définie ici. L'action doit exister dans le dictionnaire et ne doit pas être de type "Traitement divers". Si c'est le cas, l’action ne doit pas appeler la fonction mais doit appeler le traitement directement. Dans cet optique, renseignez le nom du traitement dans le premier onglet.

Possibilité de renseigner les valeurs des paramètres de l'action.