Déployez vos états Crystal Reports dans l'ERP X3

Ce tutoriel a pour but d'expliquer en détail comment déployer un état Crystal Reports dans l'ERP X3.

Article lu   fois.

L'auteur

Site personnel

Liens sociaux

Viadeo Twitter Facebook Share on Google+   

Introduction

Nous allons voir dans ce tutoriel comment créer un état dans X3, comment lui passer des paramètres, lui définir un endroit d'édition ou des valeurs par défaut.

Nous venons de créer un état ZDEVELOPPEZ.rpt qui liste les factures client. Nous avons créé trois paramètres dans Crystal Reports :

datedeb

Date de début de période

datefin

Date de fin de période

client

Code du client sélectionné


Nous allons donc paramétrer cet état depuis X3 afin de pouvoir en lancer l'impression.

Ce tutoriel s'appuie sur la version 140 de Adonix X3.

I. Création de l'état et passage de paramètres (Dictionnaire des états)

Pour accéder aux différentes options proposées par X3, il faut commencer par aller dans le menu Développement / Dictionnaire traitements / Etats

Crystal Reports et X3

Nous disposons alors de trois fonctions :

  • Dictionnaires des états : c'est ici que nous allons définir l'état et ses paramètres ;
  • Code impressions : c'est ici que nous pouvons « regrouper » les impressions pour attacher plusieurs états à une fonction ;
  • Valeurs par défaut : c'est ici que nous définirons les valeurs par défaut des états, afin de ne pas tout le temps saisir les paramètres
Crystal Reports et X3

C'est ici que nous allons définir notre état Crystal Reports. Deux onglets s'offrent à nous.

I-A. L'onglet général

Nous renseigner dans cet onglet les principales caractéristiques de l'état. L'écran est ainsi :

Crystal Reports et X3

Le code état est le code que nous allons donner à cet état dans X3. Par convention, nous utilisons le même nom que le fichier Crystal Reports. Dans notre état, nous allons donc prendre ZDEVELOPPEZ.

L'intitulé est tout simplement le nom que l'on souhaite donner. Nous prenons Etat pour developpez.

Actif est une case à cocher. Nous la cochons afin de rendre l'état actif.
Code activité est si nous le rattachons à une activité ou un traitement spécifique.

Le module est la catégorie à laquelle vous souhaitez rattacher l'état (superviseur, paramétrage, ventes, stocks, etc.).

Crystal Reports et X3

Le groupe est un affinement de la catégorie. Par exemple, notre état concerne les ventes et plus précisément les analyses.

Crystal Reports et X3

Le bloc caractéristiques de la sortie va définir les paramètres d'impression. Nous définissons si l'état doit sortir en portrait ou en paysage.
La destination est la sortie de l'état. En laissant le champ vide par défaut, la sortie sera Prévisualisation, c'est-à-dire que l'état s'affichera d'abord à l'écran. Nous pourrions choisir une imprimante directement.
Il est possible de rendre obligatoire la destination.

Le bloc Crystal Reports représente évidemment les caractéristiques de l'impression de l'état.
Les champs Traitement standard et Traitement spécifique servent à indiquer les traitements qui doivent s'appliquer lors de l'impression. Un traitement est un développement X3 qui va permettre de traiter des informations lors de l'impression de l'état. Par exemple, nous pourrions avoir un champ « Imprimé » qui renvoie Oui/Non. Nous aurions un traitement qui à l'exécution de l'état rmodifie ce champ pour le passer à Oui.

Nom état est suivi de cinq champs vides. Cela signifie que nous pouvons lancer 5 états différents en même temps à la seule condition bien sûr qu'ils aient tous les mêmes caractéristiques et paramètres.
Il faut mettre le nom du .rpt dans le champ. Pour notre exemple, nous prenons donc ZDEVELOPPEZ

Enfin, le bloc Accessibilité concerne les autorisations pour l'édition. Nous pouvons en effet déterminer si l'édition n'est possible que si l'on se trouve dans telle fonction ou si l'utilisateur a le code d'accès qui convient.
Nous pouvons déclencher un batch avec l'édition de l'état.

Nous venons de renseigner le premier onglet et nous obtenons ceci :

Crystal Reports et X3

I-B. L'onglet Paramètres

Cet onglet se présente sous forme de tableau. Il correspond à une ligne par paramètres :

Crystal Reports et X3

Paramètre correspond au nom de paramètre. Il doit être nommé exactement comme dans Crystal Reports.

Intitulé paramètre sera l'invite que l'on va proposer à l'utilisateur. Il faut donc choisir un intitulé explicite.

Type est le type de données (A=alphanumérique, D=date, etc.)
Il est possible de choisir M pour menu local. Nous aurons donc le choix du menu local.

Longueur est le nombre de caractères acceptés pour le paramètre.

Menu est saisissable si nous avons choisi M pour le type. Nous devons donc choisir le numéro du menu local.

D/F correspond en fait à Début/Fin. Nous avons créé dans CR, datedeb et datefin. X3 nous permet de ne renseigner que datedeb tout en passant D/F à oui. Il comprend alors qu'il y a également un paramètre de fin.

Crystal Reports et X3

Saisie rend le paramètre saisissable ou non par l'utilisateur.

Valeur par défaut (début et fin) nous permet de rentrer des valeurs par défaut qui sont modifiables par l'utilisateur. Néanmoins, ces valeurs par défaut ne sont pas dynamiques. Nous verrons donc plus loin comment faire.

Une fois nos paramètres renseignés, nous obtenons ceci :

Crystal Reports et X3

Il ne nous reste plus qu'à cliquer sur le bouton Créer en bas de l'écran.

Crystal Reports et X3

Nous venons de créer notre état ZDEVELOPPEZ. Nous avons déterminé qu'il concernait les ventes et plus spécialement les analyses des ventes.
Nous nous rendons alors dans le menu Impressions / Impressions groupes / Ventes / Analyses

Crystal Reports et X3

Nous choisissons ZDEVELOPPEZ puis nous cliquons sur OK. Nous pouvons alors saisir nos paramètres :

Crystal Reports et X3

Une fois ces paramètres renseignés, nous cliquons sur Imprimer en bas de l'écran.

Crystal Reports et X3

Nous aurions pu créer un paramètre qui n'imprime que les factures « facturées » (!= proforma).
Cela reviendrait à créer dans CR un paramètre facture et le conditionner. Dans X3, en reprenant ce paramètre, nous lui mettrions le Menu local n°1 (correspond à oui/non). Ainsi :

Crystal Reports et X3

Ainsi lorsque nous retournons éditer l'état nous avons bien une nouvelle ligne de paramètre (X3 met par défaut la première valeur du menu).

Crystal Reports et X3

En double cliquant la case et en appuyant sur F12, nous avons le choix des valeurs :

Crystal Reports et X3

II. Définition de l'endroit d'impression (Codes impressions)

Nous avons édité notre état depuis les groupes d'impressions. Il peut néanmoins être utile de rattacher un ou plusieurs états dans un écran.

Les états ne sont pas attachés à un écran, mais à une fonction. Ainsi, lorsqu'il existe plusieurs transactions de saisies et plusieurs écrans, nous ne plaçons l'état qu'une fois.

Dans notre exemple, notre état concerne les factures. Il est donc logique que nous puissions l'éditer depuis les transactions de factures.
Avant de rentrer dans le menu Ventes / Factures, une info-bulle nous indique le nom de la fonction.

Crystal Reports et X3

Notre fonction s'appelle donc GESSIH.
GES = gestion
S = sales (ventes)
I = invoices (factures)
H = head (en-tête)

Nous nous rendons dans Développement / Dictionnaire traitements / Fonctions.

Crystal Reports et X3

Nous allons sur la fonction GESSIH et observons le bloc Impression.

Crystal Reports et X3

Deux champs :

  • Impression ;
  • Liste.

Le champ impression permettra d'éditer depuis le bouton « Imprimer » de la fonction ou via Ctrl + P

Crystal Reports et X3

Le champ Liste permettra d'éditer depuis le menu Fichier / Liste ou via Ctrl + L

Crystal Reports et X3

En appuyant sur le bouton Imprimante, nous obtenons cette fenêtre :

Crystal Reports et X3

Nous pouvons éditer trois états différents. Il s'agit donc d'un groupe d'impression définit dans Développement / Dictionnaire Traitements / Etat / Codes Impressions.
C'est ici que nous décidons des codes impressions afin de regrouper plusieurs états en une même fonction.

Crystal Reports et X3

Les codes impressions apparaissent sous la forme d'un tableau de trois colonnes.

Code interne

Code état

Intitulé

SBONFAC

SBONFAC

Facture

SBONFAC

SBONFAC_PRI

Factures

SBONFAC

TRTCLIENT

Traites clients


Nous cliquons droit sur une ligne puis Insertion Ligne.

Crystal Reports et X3

Et nous renseignons correctement la ligne. Nous voulons sur le code impression SBONFAC, ajouter l'état ZDEVELOPPEZ.

Crystal Reports et X3

Lorsque nous retournons dans les factures et que nous sélectionnons l'imprimante, nous obtenons bien :

Crystal Reports et X3

Ces codes impressions peuvent également être utilisés pour les listes.

III. Gestion des valeurs par défaut

Lorsque nous sommes dans les factures et que nous éditons l'état ZDEVELOPPEZ, par défaut les paramètres de date vont du 01/01/2007 au 31/12/2007 et le paramètre client n'est pas renseigné :

Crystal Reports et X3

Il s'avère fort pratique de modifier ces paramètres par défaut et qu'ils prennent les valeurs de la facture que nous sommes en train de visionner.

En d'autres termes, le paramètre date prendrait la valeur du 12/06/2008 et le paramètre client la valeur 0304 :

Crystal Reports et X3

En plaçant le curseur sur les champs Client fac et Date puis en cliquant sur le bouton F6, nous obtenons des informations très intéressantes :

Crystal Reports et X3

Deux informations sont très importantes et figurent dans le titre de la fenêtre :

  • le nom du champ : BPCINV ;
  • le masque entre [ ] : SIHO.
Crystal Reports et X3

Il faut ici se souvenir de INVDAT et SIHO.

Nous allons cette fois dans Développement / Dictionnaire traitements / Etat / Valeurs par défaut

Crystal Reports et X3

Nous appuyons sur nouveau et nous entrons le nom de la fonction GESSIH et le nom de l'état ZDEVELOPPEZ.

Les valeurs par défaut apparaissent sous forme de tableau avec quatre colonnes. Il faut renseigner :

  • Paramètre : le nom du paramètre. Ex. : datedeb ou client ;
  • Activité : tout comme l'état, à n'utiliser que si vous utilisez un code d'activité spécifique ;
  • Valeur par défaut (début) : la valeur du paramètre (Masque+Champ). Ex. : [M:SIH0]INVDAT ou [M:SIH0]BPCINV ;
  • Valeur par défaut (fin) : la valeur de paramètre de fin. Nous reprenons la même date que le début : M:SIH0]INVDAT.

Nous obtenons donc cette fenêtre :

Crystal Reports et X3

Lorsque nous retournons éditer notre état, nous constatons que les valeurs par défaut sont bien renseignées :

Crystal Reports et X3

IV. Conclusion

Nous avons vu dans ce tutoriel comment bien paramétrer un état Crystal Reports dans X3. Ceci est un exemple simple, mais il est possible de paramétrer de manière bien plus poussée un état. Il est également intéressant de s'informer sur les traitements spécifiques qui peuvent minimiser le nombre de tables à utiliser dans Crystal Reports.

V. Liens utiles

VI. Remerciements

Je souhaite remercier Fleur-Anne BlainFleur-Anne Blain et Bruno2rBruno2r pour les corrections qu'ils m'ont faites pour ce tutoriel.

Vous avez aimé ce tutoriel ? Alors partagez-le en cliquant sur les boutons suivants : Viadeo Twitter Facebook Share on Google+   

  

Copyright © 2020 Adrien Artero. Aucune reproduction, même partielle, ne peut être faite de ce site ni de l'ensemble de son contenu : textes, documents, images, etc. sans l'autorisation expresse de l'auteur. Sinon vous encourez selon la loi jusqu'à trois ans de prison et jusqu'à 300 000 € de dommages et intérêts.