Dictionnaire des états
Cette fonction permet de capitaliser l'ensemble des états Crystal Report utilisables depuis l'un des produits de la gamme X3. Dans ce dictionnaire des états, vous renseignez :
- les caractéristiques générales,
- les caractéristiques de la sortie,
- les traitements éventuellement associés,
- les droits d'accès,
- les paramètres de lancement,
- les sources de données, lorsque l'état a accès à des tables d'un autre dossier.
Une charte pour le développement des états Crystal Report a été définie : vous pouvez consulter la documentation Charte des états Crystal Report.
Pré-requis
Reportez-vous à la documentation de Mise en oeuvre
Gestion de l'écran
En-tête
L'en-tête permet d'identifier l'état, et de donner ses caractéristiques générales.
Code état (champ RPTCOD) |
Code identifiant la fiche courante. |
Intitulé (champ ZRPTDES) |
Onglet Général
Utilisez cet onglet pour renseigner les informations liées à la gestion globale de l'état.
Duplication d'un état en local
Un utilisateur peut dupliquer un état dans sa sandbox pour modifier l'état localement. Pour dupliquer l'état dans votre sandbox et pour repartager l'état avec les autres utilisateurs, suivez ces étapes :
1. Dans le tableau Crystal reports, cliquez sur Transférer depuis l'icône Actions au début de la ligne de l'état. Le statut 'Demande de transfert' s'affiche dans le champ Statut.
2. Enregistrez la fiche. Le statut 'Sandbox' s'affiche dans le champ Statut. L'état a été dupliqué dans votre sandbox et vous pouvez modifier l'état. Tant qu'un état est dans une sandbox, aucun autre utilisateur ne peut modifier l'état.
3. Pour repartager l'état avec les autres utilisateurs :
- Cliquez sur Publier avec modifications depuis l'icône Actions au début de la ligne si vous avez modifié l'état. Le statut 'Demande de publication avec modifications' s'affiche dans le champ Statut.
- Cliquez sur Abandonner les modifications depuis l'icône Actions au début de la ligne si vous n'avez pas modifié l'état. Le statut 'Demande de publication sans modifications' s'affiche dans le champ Statut.
4. Enregistrez la fiche. Le statut 'Partagé' s'affiche dans le champ Statut. L'état est à nouveau partagé avec les autres utilisateurs.
Généralités
Actif (champ ENAFLG) |
Sélectionnez cette case à cocher pour activer la fiche courante. Les enregistrements non sélectionnés conservent leur contenu et paramétrage, mais ne pourront pas être utilisés en rappelant leur code dans :
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. Elle est modifiable uniquement par un utilisateur autorisé, ou via un Workflow de signature. |
Code activité (champ CODACT) |
Un code activité vous permet de :
Si le code activité est désactivé :
|
Intitulé court (champ ZRPTSHO) |
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. |
Langue
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). |
Caractéristiques de la sortie
Type (champ PRTNAT) |
Au lancement de l'impression, la destination est déterminée :
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
Fax
Thermique
Couleur
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 :
|
Scripts
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 :
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) |
Accessibilité
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) |
Tableau Crystal reports
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) |
Les différents statuts de l'état sont les suivants : Partagé
Demande de transfert
Sandbox
Demande de publication sans modifications
Demande de publication avec modifications
|
Utilisateur (champ DEVUSR) |
Les champs Utilisateur et Date sont automatiquement alimentés avec votre nom d'utilisateur et la date du jour quand le statut de l'état devient 'Sandbox'. |
Date (champ DEVDAT) |
Autorisations
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. |
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. |
Action de déroutement STANDARD |
Onglet Paramètres
Dans ce tableau, définissez les paramètres nécessaires à l'exécution d'un état Crystal Reports.
Tableau Paramètres
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) | ||||||||||||||||||
Type (champ PARTYP) | ||||||||||||||||||
Vous devez définir ici le type de la zone. Les principaux types sont :
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 :
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. |
Segmentation
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 depuis l'icône Actions sur le paramètre de segmentation. |
Onglet Données
Si l'état s'appuie sur au moins une table d'un autre dossier, vous devez obligatoirement indiquer la source de données liée à chaque dossier supplémentaire sous la forme « solution;dossier ». Le dossier doit être un dossier lié dans la gestion dossier. Le nombre de sources de données est limité à cinq. 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, vous pouvez utiliser la variable GDOSX3.
Ensuite, pour chaque source de données, vous devez indiquer les tables utilisées dans l'état. Si une table n'est pas référencée, elle sera automatiquement associée à la source de donnée du dossier courant. De ce fait, les tables du dossier courant ne doivent pas être référencées ici.
Le nom de la table doit être celui utilisé dans Crystal (cela peut être le nom de pseudonyme, s’il en existe dans Crystal).
Le nombre de tables est limité à 10 (cette limite est due au serveur d’impression).
Le nom d'une table est limité à 200 caractères.
Tableau Sources de données
Intitulé (champ ZSRC) |
Dossier par défaut (champ DOSSIER) |
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. |
Tableau Tables
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) |
Création d'un état Crystal Report
Pour créer un état Crystal Report, suivez les étapes ci-dessous :
1. Créez l'état Crystal, par l'outil Crystal Designer, sur le poste client, dans le répertoire RptDev.
2. Tester l'état par l'outil Crystal Designer.
3. Créez la fiche dictionnaire dans X3.
4. Testez l'état depuis X3, en sélectionnant le mode 'Développeur état' depuis le menu Outils, accessible depuis le menu principal en mode client-serveur.
5. Transférez l'état sur le serveur, depuis le dictionnaire des états, sur le champ Nom état, par le menu contextuel.
Modification d'un état Crystal Report
Pour modifier un état Crystal Report, suivez les étapes ci-dessous :
1. Transférer l'état sur le client, depuis le dictionnaire des états, sur le champ Nom état, par le menu contextuel.
2. Modifier et tester l'état par l'outil Crystal Designer.
3. Testez l'état depuis X3, en sélectionnant le mode 'Développeur état' depuis le menu Outils, accessible depuis le menu principal en mode client-serveur.
4. Transférez l'état sur le serveur, depuis le dictionnaire des états, sur le champ Nom état, par le menu contextuel.
Etats
Par défaut, les états suivants sont associés à la fonction :
AREPORT : Dictionnaire des états
Mais ceci peut être modifié par paramétrage.
Boutons spécifiques
Impression |
Ce bouton permet de lancer l'impression de l'état courant directement depuis cette fonction. |
Copie
Ce bouton permet de recopier le dictionnaire de l'état vers un autre dossier. Bloc numéro 1
Bloc numéro 2
|