Dictionnaire des états

• Code état (champ RPTCOD)

Code identifiant la fiche courante.

• Intitulé (champ ZRPTDES)

Destiné à 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 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 est modifiable uniquement 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)

Groupe d'impression auquel vous associez l'état. Grâce à cette information, vous pourrez lancer l'état depuis le menu impression avec le sous-menu RPTxx (ou xx est le numéro 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é.

Un droit d'accès pour ce groupe doit être défini dans la gestion des utilisateurs.

• Multi-langues (champ MULLAN)

Si cette case est cochée, l'état est généré dans toutes les langues gérées par le dossier.

Si cette case n'est pas cochée, l'état est généré uniquement dans la langue de conception.

• Langue origine (champ LAN)

Ce champ permet de réserver l'état à une langue (langue dans laquelle l'état à été conçu).

• Type (champ PRTNAT)

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

• par la formule complément si celle-ci existe (dans le champ Formule complément),
• ou par la destination,
• ou par le type si la formule complément et la destination ne sont pas renseignés.

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 le paramètre associé au type. A chaque type correspond un paramètre, dans lequel vous devez saisir une destination.

Normal

Paramètre PRT1

Fax

Paramètre PRT2

Thermique

Paramètre PRT3

Couleur

Paramètre PRT4

 Les valeurs de ce menu local (menu local 22) sont modifiables.

• Imprimante ZPL (champ GESZPL)

Si cette case est cochée, l'é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, vous ne pouvez 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)

Ce champ, même s'il n'est pas renseigné, sert à la recherche d'une destination par utilisateur et par état. Cette destination, si elle est trouvée, sera prioritaire par rapport à celle indiquée dans le champ Destination.

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 :

• Pour l'état X, vous avez défini un complément avec la valeur 'PAR', correspondant à l'imprimante Y.
• La formule de l'état X contient l'expression "PARAM(site)".
• Au moment d'imprimer l'état, si le paramètre Site est égal à PAR, l'imprimante sera initialisée à Y.

• Script 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,
• de préparer des fichiers avant l'impression,
• de mettre à jour des champs dans la base de données (exemple : case à cocher d'édition).

Ces traitements d'initialisation sont exécutés pour chaque état.

Un traitement est réservé au développement standard et un traitement est réservé au spécifique. La mise à jour du traitement spécifique ne nécessite pas de protection par code activité. Vous pouvez consulter cette documentation : Aide développement.

• Script spécifique (champ TRTSPE)

• Non exécutable (champ EXEFLG)

Si cette case est cochée, 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 valeur 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 cohérente avec celle saisie sur l'état Crystal Report. La mise à jour de ce champ ne nécessite pas de protection par code activité.

• Format papier (champ FORETA)

• Statut (champ DEVSTA)

• Utilisateur (champ DEVUSR)

• Date (champ DEVDAT)

• Autorisation site (champ AUZFCY)

La case à cocher Autorisation site permet d'indiquer si l'accès à cet état est contrôlé par site.

Si la case est cochée, vous devez alors indiquer par rapport à quelle fonction (champ Fonction). Vous pouvez indiquer une fonction générique RPTxx où xx représente le groupe d'impression.
 La gestion d'une autorisation par site nécessite que l'état Crystal Report soit conçu pour restreindre l'impression des données aux sites autorisés.

• Fonction (champ FNC)

• Code d'accès (champ ACS)

Ce code d'accès permet l'autorisation ou l'interdictiond'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 propose 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 :

Saisissez uniquement 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é à 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 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,etc.). Utilisez le raccourci clavier ESC + F12 ou l'icône Sélection pour ouvrir la liste des types.

• 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 :

Saisissez uniquement 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 (par exemple, numéro 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)

Ce champ est 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é à 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 de la fiche concernée.