Dictionnaire des états

• Code état (champ RPTCOD)

Code identifiant la fiche courante.

• Intitulé (champ ZRPTDES)

Destiné notamment à figurer sur les états et les écrans dans lesquels le code de la fiche peut être saisi ou sélectionné. Ce texte permet de donner une description en clair de la fiche concernée.

• Actif (champ ENAFLG)

Cette case à cocher permet d'activer ou de désactiver la fiche courante sans pour autant perdre son contenu.
Une fiche désactivée ne peut pas être utilisée (par appel de son code) dans d'autres fiches (documents, paramétrages...), ou lors de traitements de masse.
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, et n'est pas modifiable autrement que par un utilisateur autorisé, ou via un circuit de signature défini par Workflow.

• Code activité (champ CODACT)

Un code activité permet :

• de rendre optionnel un élément du dictionnaire si la valeur associée au code activité est nulle.
• de signer les éléments spécifiques dès lors qu'ils sont marqués par un code commençant par X, Y ou Z.
• de dimensionner un nombre de lignes maximum lorsque le code activité marque des éléments d'un tableau.

Ainsi, si le code activité est non actif, l'élément marqué ne sera pas utilisable, et le code associé (s'il y en a) ne sera pas généré ni activable.

• Intitulé court (champ ZRPTSHO)

Cet intitulé permet de donner une désignation à la fiche.
Il est utilisé dans certains écrans ou états lorsqu'il n'y a pas assez de place pour visualiser l'intitulé long.

• Module (champ MODULE)

Module par lequel est utilisé l'état.

• Groupe (champ GRP)

Il s'agit du groupe d'impression auquel, on associe l'état. Grâce à cette information, on pourra lancer l'état depuis le menu impression avec le sous-menu RPTxx ( ou xx est le no de l'élément du menu local 97 pour le champ « GROUPE »). La mise à jour de cette information ne nécessite pas de protection par code activité.

Groupe sur lequel on donne un droit d'accès dans la gestion des utilisateurs.

• Multi-langues (champ MULLAN)

Si cette case est cochée, cela indique que l'état a été généré dans toutes les langues gérées par le dossier, sinon l'état est uniquement  dans la langue de conception.

• Langue origine (champ LAN)

Ce champs permet de réserver l'état à une langue ; langue dans laquelle à été conçu l'état.

• Type (champ PRTNAT)

Au lancement de l'impression, la destination est déterminée :

• par la formule complément, si celle-ci existe
• sinon, par la destination
• ou enfin, si les 2 premiers éléments ne sont pas renseignés, par le type

Le type sert à déterminer une destination dans le cas ou la formule complément et la destination ne sont pas renseignées. Au lancement de l'impression, le superviseur détermine la destination par l'un des quatre paramètres associé au type. A chaque valeur du type correspond un paramètre, dans lequel on a saisit une destination :

• Normal :       paramètre PRT1
• Fax :             paramètre PRT2
• Thermique : paramètre PRT3
• Couleur :      paramètre PRT4

Remarque : Les valeurs de ce menu local 22 sont modifiables.

• Imprimante ZPL (champ GESZPL)

Indique que cet état peut-être imprimé sur une imprimante ZPL.

• Code paramétrage (champ CODZPL)

Ce code permet d'identifier le paramétrage d'une imprimante ZPL. Il est nécessaire pour que cet état puisse être imprimé sur ce type d'imprimante.

• Destination (champ PRTDEF)

Indique une fiche destination. Cette fiche contient les caractéristiques d'impression.

• Obligatoire (champ PRTOBL)

Si cette case est cochée, on ne peut pas modifier la destination au lancement de l'impression de l'état.

• Impressions liées (champ IMPLIE)

Le serveur d’édition est multi-processus, il peut donc traiter en parallèle N demandes. Par contre, une imprimante donnée ne peut imprimer qu’un seul état à la fois.

Ce qui veut dire que si deux états sont soumis, au même instant sur le même serveur d’édition, à destination de la même imprimante, toute la phase de traitement Crystal Report des états (requêtes SQL, mise en forme, etc…) est parallélisée, seule la phase de production « papier » est sérialisée.

Cette option permet de respecter l'ordre de définition des états dans la fiche dictionnaire ou en cas d'utilisation d'un paramètre de segmentation.

• Formule complément (champ PRTFRM)

Renseigné ou pas, ce champs sert à la recherche d'une destination par utilisateur et par état. Cette destination, si elle est trouvée, sera prioritaire par rapport à celle précisée au-dessus.

Au moment de l'impression, dans l'algorithme d'affectation de l'imprimante, cette zone sera comparée au complément défini dans la fonction d'affectation des imprimantes par utilisateur. Exemple: Si pour l'état X, on a défini un complément avec la valeur "PAR" correspondant à l'imprimante Y et que la formule de l'état X contient l'expression "PARAM(site)", alors, au moment d'imprimer l'état, si le paramètre "site" est égal à PAR, l'imprimante sera initialisée à Y.

• Traitement standard (champ TRTINI)

Traitements dans lesquels, il sera possible d'écrire des sous-programmes complémentaires à l'impression de cet état. Ils sont exécutés par la procédure d'impression juste avant d'exécuter l'état Crystal Reports. Ils permettent d'initialiser des variables définies dans le paramètrage de l'état ou éventuellement de préparer des fichiers avant l'impression, ou même de mettre à jour des champs dans la base de données (ex:flag d'édition). Ces traitements d'initialisation sont exécutés pour chaque état.

Un traitement est réservé au développement standard, et l'autre aux spécifiques. La mise à jour du traitement spécifique ne nécessite pas de protection par code activité.  Aide développement.

• Traitement spécifique (champ TRTSPE)

• Non exécutable (champ EXEFLG)

Ce champs permet d'indiquer que l'état n'est pas exécutable directement depuis le menu impression. C'est le cas des états qui sont directement liés à une fonction et dont la valeurs des paramètres d'impression sont issus de la fonction.

• Batch obligatoire (champ EXEBAT)

La mise à jour de ces informations ne nécessite pas de protection par code activité.

• Contraintes horaires (champ HOR)

• Nom état (champ CRYCOD)

De un à cinq états sont imprimés consécutivement lors du lancement de l'impression. La saisie des paramètres pour tous les états est regroupée au lancement. On génère un fichier par état. Ils seront nommés : fichier.ext, fichier_1.ext, fichier_2.ext, … fichier_n.ext. Pour chaque état, on indique l'orientation (portrait / paysage). Le traitement d'initialisation est exécuté pour chaque état.

• Orientation (champ ORIENT)

Format portrait ou paysage. Cette information doit être en cohérence avec celle saisie sur l'état Crystal Report. Possibilité d'avoir des états d'orientation différente. La mise à jour de ce champ ne nécessite pas de protection par code activité.

• Format papier (champ FORETA)

• Autorisation site (champ AUZFCY)

Indiquer si l'accès à cet état peut être contrôlé par site. Si oui, il faudra indiquer par rapport à quelle fonction. Il est possible d'indiquer une fonction générique RPTxx où xx représente le groupe d'impression.

• Fonction (champ FNC)

• Code d'accès (champ ACS)

Ce code d'accès permet l'autorisation ou l'interdiction d'exécution de l'état par un utilisateur.

• Paramètre (champ PARCOD)

Ce code sera utilisable sous Crystal Reports.

Une fenêtre de sélection permet de proposer l'ensemble des paramètres déjà existants sur les états. Pour une même notion, il est donc conseiller de réutiliser les mêmes nom de paramètre.

Automatisme et normes pour les paramètres exprimant une borne début et fin : Ne saisir que la borne de début. Son code doit se terminer par le suffixe « deb » ou « str ». Le paramètre pour la borne de fin est généré avec la même racine que la borne début et le suffixe « fin » ou « end ». Il n'apparait pas dans le tableau mais est passé à Crystal.

Automatisme et normes pour les paramètres exprimant une borne début et fin : Ne saisir que la borne de début. Son code doit se terminer par le suffixe « deb » ou « str ». Le paramètre pour la borne de fin est généré avec la même racine que la borne début et le suffixe « fin » ou « end ». Il n'apparait pas dans le tableau mais est passé à Crystal.

• Intitulé paramètre (champ ZPARNAM)

Destiné notamment à figurer sur les états et les écrans dans lesquels le code de la fiche peut être saisi ou sélectionné. Ce texte permet de donner une description en clair de la fiche concernée.

• Type (champ PARTYP)

Vous devez définir ici le type de la zone. Les principaux types sont :

A : Alphanumérique
C : Entier court
L : Entier long
DCB : Décimal
D : Date
M : Menu local

 D'autres types prédéfinis existent. Ils font généralement référence à une table annexe (devise, section,...). La touche F12 vous permet d'en obtenir la liste.

• Longueur (champ PARLNG)

Permet de définir la longueur d'un champ lorsque ce champ utilise un type de données générique dont la longueur n'est pas fixée. C'est le cas notamment pour les types A et DCB.

Pour les blob, comme pour les clob, il faut saisir la longueur qui sera une longueur maximale de stockage. La codification est la suivante :

• Menu (champ PARNOLIB)

Définit le numéro de menu local associée au champ défini sur la ligne.

Lorsqu'un champ est de type menu local, il est stocké sous la forme d'une valeur numérique (de 1 à 255) correspondant au rang d'un intitulé dans une table appelée menu local, stockée dans la table des messages APLSTD.

En saisie ou en affichage, on voit, selon les choix faits sur l'interface utilisateur :

• soit un intitulé pouvant être choisi dans une liste déroulante communément appelée combo box
• soit une liste de boutons de choix.

L'intérêt de ce type de saisie est que la liste des choix est présentée dans la langue de connexion de l'utilisateur.

Chaque numéro de menu local caractérise la liste des intitulés possibles. Par exemple, le menu local 1 correspond au choix Non / Oui dans cet ordre. Dans ce cas particulier, l'interface utilisateur peut aussi être la case à cocher.

• Type de valeur (champ PARSTREND)

Indique s'il faut saisir un intervalle de valeur.

Automatisme et normes pour les paramètres exprimant une borne début et fin : Ne saisir que la borne de début. Son code doit se terminer par le suffixe « deb » ou « str ». Le paramètre pour la borne de fin est généré avec la même racine que la borne début et le suffixe « fin » ou « end ». Il n'apparait pas dans le tableau mais est passé à Crystal.

• Sai (champ PARSAI)

Indique si le paramètre est saisissable ou pas au lancement de l'état.

• Valeur par défaut (début) (champ PARDEF1)

Il est possible de saisir une expression qui sera évaluée à la saisie pour initialiser le paramètre.

• Valeur par défaut (fin) (champ PARDEF2)

• Contrôle (champ PARCTL)

Il est possible de saisir une formule pour contrôler la saisie de ce paramètre. La variable VALEUR représente la valeur saisie du paramètre.

• Table de contrôle (champ PARCTLTAB)

On peut indiquer ici le code d'une table de contrôle pour vérifier la saisie du paramètre.

• Paramètre objet/dépendance (champ PARPAR)

Permet de saisir le premier élément de clé d'un objet, si cet objet a une clé à deux composantes. Exemple : n° table pour une table diverse.

Particularité pour une table diverse dépendante : ce champ permet de saisir l'élément maître de la table diverse "maître"; dans ce cas, le numéro de la table diverse est  à saisir dans la colonne "menu".

• Options (champ PAROPT)

Saisissable si le type de donnée est lié à un objet. Ce champ permet de définir une ou plusieurs options de filtre définies dans l'objet. Le superviseur contrôle la valeur saisie dans le paramètre en fonction des filtres positionnés. De même, la fenêtre de sélection, tient compte des filtres. 

• Code d'accès (champ PARACS)

Ce code d'accès permet d'interdire la saisie et la visualisation du paramètre.

En effet, si la zone est renseignée, seuls les utilisateurs ayant ce code d'accès avec le droit de modification pourront modifier le paramètre.

• Paramètre de segmentation (champ PARSEG)

Permet d'éclater l'impression en plusieurs impressions, dans le but d'améliorer les performances d'un état très volumineux. Il s'agit donc de définir ici le paramètre sur lequel seront à saisir les tranches de valeurs prises en compte pour l'éclatement de l'état.

Au lancement de l'état, la saisie de ces différentes tranches de valeurs doit se faire par clic droit sur le paramètre de segmentation.

• Intitulé (champ ZSRC)

Si l'état s'appuie sur au moins une table d'un autre dossier, on aura l'obligation d'indiquer la source de données liée à chaque dossier suplémentaire sous la forme « solution;dossier ». Il faut que le dossier soit un dossier lié dans le gestion dossier. Le nombre de sources de données est limité à 5. Le dossier saisi n'est, en fait, qu'une valeur par défaut, puisque la source est modifiable au lancement de l'impression. Si la solution n'est pas indiquée, le superviseur prend la solution courante; il en est de même pour le dossier. Pour atteindre les tables du dossier mère, on peut utiliser la variable GDOSX3, disponible pour tout produit. Pour atteindre les tables du dossier d'exploitation X3, depuis un autre produit (géode GX, Abel X3, Paie), les variables GSOLCPT et GDOSCPT contiennent respectivement la solution et le dossier X3.

• Dossier par défaut (champ DOSSIER)

• Table (champ TBL)

Tables associées à l'une des sources de donnée ci-dessus pour accéder à un autre dossier. Le nombre de tables par source de donnée est limité à 10. Le nom d'une table est limité à 200 caractères.

• Intitulé (champ LIBTBL)

• Numéro (champ NUM)

numéro identifiant l'une des sources de données du tableau ci-dessus.

• Source de données (champ LIBNUM)

Destiné notamment à figurer sur les états et les écrans dans lesquels le code de la fiche peut être saisi ou sélectionné. Ce texte permet de donner une description en clair de la fiche concernée.

• Toutes langues existantes (champ ALLLAN)

Si cette case est cochée, toutes les langues sont prises en compte pour l'opération.

Si la case n'est pas cochée, on prendra, selon les cas :

• la langue par défaut de l'utilisateur, si aucun code langue n'est saisi.
• la langue saisie par ailleurs sinon.

• Langue (champ LAN)

Permet de définir la langue de génération (quand la case permettant de générer dans toutes les langues n'est pas cochée).

• Tous types (champ ALLTYP)

Si cette case est cochée, tous les types de documentation sont pris en compte pour la génération. Il est à noter que, dans ce cas, on limite la génération aux documentations standard (seules les documentations de code inférieur à X sont prises en compte).

• Type (champ TYPEDOC)

Permet de définir le type de documentation à prendre en compte dans le traitement (quand on n'a pas coché la case pour les prendre tous en compte).

• Codes documentations (champ FUNDEB)

Permet de donner une borne sur les codes à prendre en compte pour la génération de documentation.

• champ FUNFIN

• Génération ADOCUMENT (champ GENDOC)

Ce radio-bouton permet créer/mettre à jour le squelette de la documentation (hiérarchie des paragraphes) à partir des éléments techniques trouvés dans le dictionnaire des données. On peut choisir de reprendre uniquement les documentations existantes ou créer de nouvelles documentations si besoin.

Les liens de documentation sont également pris en compte. Les paragraphes susceptibles d'être créés sont définis dans l'annexe technique correspondante.

• champ GENFIN

Ce radio-bouton permet de générer la documentation finale à partir du contenu des paragraphes de documentation. Cette documentation est créée dans différents sous-répertoires du répertoire défini par le paramètre utilisateur DIRDOC.

Il faut utiliser la génération "Selon code activité" pour obtenir la génération des documentations des fonctions ayant des codes activités >= "X"
La génération "Complète" ne traite que les codes activités standards.

• Uniquement les documentations validées (champ HLPVLD)

Permet de générer le document final uniquement pour les documentations validées.

• Aides sur champs liées aux documentations (champ HLPLNKFLD)

Si cette case est cochée, on traite spécifiquement les aides sur champs relatives aux documentations sur fonction ou objet traitées par ailleurs. Pour savoir quelles sont les aides sur champ à traiter, on explore les écrans associés aux paragraphes de documentation correspondants.

• Autres aides sur champs (champ HLPFLD)

Si cette case est cochée, on crée la documentation finale à partir du contenu des paragraphes de documentation. Cette documentation est créée dans le sous-répertoire FLD du répertoire défini par le paramètre utilisateur DIRDOC.

• Codes aides sur champs (champ HLPDEB)

Permet de donner une borne sur les codes à prendre en compte pour la génération de documentation.

• champ HLPFIN

• Répertoire de génération (champ REPERT)