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

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 :

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

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

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

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 :

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.).

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

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 :

I-B. L'onglet Paramètres▲

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

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.

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 :

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

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

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

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

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 :

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).

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

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.

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.

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.

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

Deux champs :

• Impression ;
• Liste.

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

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

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

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.

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

Nous cliquons droit sur une ligne puis Insertion Ligne.

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

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

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

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

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 :

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 :

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

• le nom du champ : BPCINV ;
• le masque entre [ ] : SIHO.

Il faut ici se souvenir de INVDAT et SIHO.

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

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 :

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

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.

• Le forum d'entraide Crystal ReportsLe forum d'entraide Crystal Reports
• Présentation générale des ERPPrésentation générale des ERP, par Fleur Anne Blain, par Fleur Anne Blain
• Initiation à Crystal ReportsInitiation à Crystal Reports, par Fleur Anne Blain, par Fleur Anne Blain

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