Vous êtes sur la page 1sur 73

SAFE X3 – CRYSTAL REPORT

Safe X3

Support de formation
Crystal Report
Version 6

Copyright © Sage 2009-2010 Page 1


SAFE X3 – CRYSTAL REPORT

Copyright © Sage 2009-2010 Page 2


SAFE X3 – CRYSTAL REPORT

SOMMAIRE

SOMMAIRE ................................................................................................................................................. 3
1. CONCEVOIR UN ETAT ............................................................................................................................ 5
1.1. CHOIX DE L’ODBC ...................................................................................................................................... 5
1.2. CONNEXION A LA BASE ................................................................................................................................. 6
1.3. SELECTION D’UNE OU PLUSIEURS TABLES ......................................................................................................... 7
1.4. TYPE DE JOINTURE....................................................................................................................................... 8
1.5. ONGLET CONCEPTION .................................................................................................................................. 9
1.6. CHAMP BASE DE DONNEE ........................................................................................................................... 10
1.7. LISTE DES ELEMENTS INSERABLES.................................................................................................................. 11
1.8. OBJET TEXTE ............................................................................................................................................ 12
1.9. EXERCICE N°1 .......................................................................................................................................... 13
1.10. GROUPE ................................................................................................................................................. 14
1.11. EXERCICE N°2 .......................................................................................................................................... 16
1.12. TRI DE GROUPES ....................................................................................................................................... 17
1.13. TRI D’ENREGISTREMENTS............................................................................................................................ 18
1.14. EXERCICE N°3 .......................................................................................................................................... 19
1.15. RESUME ................................................................................................................................................. 20
1.16. TOTAL CUMULE ........................................................................................................................................ 21
1.17. EXERCICE N°4 .......................................................................................................................................... 22
1.18. CHAMP DE PARAMETRE.............................................................................................................................. 23
1.19. SELECTION D’ENREGISTREMENTS.................................................................................................................. 24
1.20. EXERCICE N°5 .......................................................................................................................................... 25
1.21. CHAMPS DE FORMULE ............................................................................................................................... 26
1.22. EXERCICE N°6 .......................................................................................................................................... 27
1.23. CHAMPS SPECIAUX .................................................................................................................................... 28
1.24. EXERCICE N°7 .......................................................................................................................................... 29
1.25. MENU CONTEXTUEL SUR CHAMP .................................................................................................................. 30
1.26. MENU CONTEXTUEL SUR SECTION ................................................................................................................ 31
1.27. EXERCICE N°8 .......................................................................................................................................... 33
1.28. SOUS RAPPORT......................................................................................................................................... 34
1.29. ENREGISTRER L’ETAT ................................................................................................................................. 35
2. SPECIFICITES SAGE ERP X3 ................................................................................................................... 36
2.1. ETATS MODELE ......................................................................................................................................... 36
2.2. PARAMETRES FONCTIONNELS ...................................................................................................................... 38
2.3. PARAMETRES SUPERVISEUR ........................................................................................................................ 39
2.4. EXERCICE N°9 .......................................................................................................................................... 40
2.5. MENUS LOCAUX ....................................................................................................................................... 41
2.6. MENUS LOCAUX DANS LANGUE TRADUITE....................................................................................................... 42
2.7. MENUS LOCAUX EN ACCES DIRECT ................................................................................................................ 43
2.8. EXERCICE N°10 ........................................................................................................................................ 45
2.9. TEXTES TRADUITS ...................................................................................................................................... 46
2.10. EXERCICE N°11 ........................................................................................................................................ 49

Copyright © Sage 2009-2010 Page 3


SAFE X3 – CRYSTAL REPORT

2.11. CLOB ET BLOB .......................................................................................................................................... 50


2.12. MONTANT EN LETTRES ............................................................................................................................... 51
2.13. CODES A BARRES (X3, ABEL X3) .................................................................................................................. 52
2.1. CODES A BARRES (GEODE, GX) ................................................................................................................... 53
2.2. DATE NON RENSEIGNEE DANS SAGE ERP X3 .................................................................................................. 54
3. SAGE ERP X3 ....................................................................................................................................... 55

3.1. ORGANISATION CLIENT ET SERVEUR .............................................................................................................. 55


3.2. ARBORESCENCE DES DOSSIERS ..................................................................................................................... 56
3.3. DICTIONNAIRE ETAT .................................................................................................................................. 57
3.4. LANCEMENT IMPRESSION EN TEST ................................................................................................................ 60
3.5. FORMATS D’EXPORT DISPONIBLES ................................................................................................................ 60
3.6. PARAMETRES DE CONFIGURATION SUPPORTES ............................................................................................... 60
3.7. AFFECTATION ETAT A UNE FONCTION SAGE ERP X3 ........................................................................................ 61
3.8. EXERCICE N°12 ........................................................................................................................................ 62
3.9. LANCEMENT IMPRESSION BATCH .................................................................................................................. 63

4. LES HABILITATIONS ............................................................................................................................. 64

4.1. PARAMETRAGE DANS SAGE ERP X3 ............................................................................................................. 64

5. MODIFIER UN ETAT : ........................................................................................................................... 65


5.1. AFFECTATION SOURCE ODBC, ETC ............................................................................................................... 65
5.2. EXERCICE N°13 ........................................................................................................................................ 66

6. LES PERFORMANCES............................................................................................................................ 67

7. TRAITEMENT D’INIT............................................................................................................................. 68
8. ERREURS FREQUENTES ........................................................................................................................ 69

9. OUTILS D’ANALYSE .............................................................................................................................. 70

9.1. GESTION DES IMPRESSIONS ......................................................................................................................... 70


9.2. SURVEILLANCE IMPRESSIONS ....................................................................................................................... 71

10. ANNEXE - EXERCICE ......................................................................................................................... 72

Copyright © Sage 2009-2010 Page 4


SAFE X3 – CRYSTAL REPORT

1. CONCEVOIR UN ETAT

1.1. CHOIX DE L’ODBC

1. Concevoir un état : choix de l’ODBC

3 © 2006 Sage – Division Moyennes & Grandes Entreprises

ODBC
Elle permet de s’affranchir de la base de données et donc permet la portabilité des états.

Paramètre avancé de la boite de connexion X3


Si Type de configuration=« valeur par défaut »,
le client X3 crée la source ODBC et l’associe au dossier X3 et à la base de données.
Source créée en automatique : ADX_dossierX3

Copyright © Sage 2009-2010 Page 5


SAFE X3 – CRYSTAL REPORT

1.2. CONNEXION A LA BASE

1. Concevoir un état : Connexion à la base

4 © 2006 Sage – Division Moyennes & Grandes Entreprises

Information de connexion

Service : source ODBC


ID utilisateur : nom du dossier X3
Mot de passe : tiger

Copyright © Sage 2009-2010 Page 6


SAFE X3 – CRYSTAL REPORT

1.3. SELECTION D’UNE OU PLUSIEURS TABLES

1. Concevoir un état : sélection d’une ou plusieurs tables


Exemple : état STOCK00

Base de données / Expert base de données…

5 © 2006 Sage – Division Moyennes & Grandes Entreprises

Pseudonyme :
On déclare une table n fois, lorsqu’on a besoin de lire n enregistrements.
Dans ce cas, la table sera identifiée par un pseudonyme.

Copyright © Sage 2009-2010 Page 7


SAFE X3 – CRYSTAL REPORT

1.4. TYPE DE JOINTURE

1. Concevoir un état : type de jointure

Jointure interne
Jointure externe gauche

Base
6 de©données
2006 Sage /– Expert base de &données…
Division Moyennes Grandes Entreprises

Méthode :
1- Effacer les liaisons automatiques
2- Créer les liaisons manuellement

Règles sur l’ensemble des liaisons :


- Liaison sur champs de même nature
- 1 table maître de laquelle partent les premières liaisons
- Toutes les tables doivent être liées
- 1 table ne peut être pointée que par une seule table
Mais 1 table peut être à l’origine de plusieurs liaisons

Type de jointure
Jointure interne :
c’est la jointure standard
sélection enregistrements dont la valeur du champ lié correspond à la liaison dans les 2 tables.
Jointure externe gauche :
jointure interne +
enregistrement de la table d’origine sans correspondance dans la table de destination
Jointure externe droite :
jointure interne +
enregistrement de la table de destination sans correspondance dans la table d’origine

En standard, on utilise essentiellement :


- des jointures internes et externes gauche
- des liaisons =

Copyright © Sage 2009-2010 Page 8


SAFE X3 – CRYSTAL REPORT

1.5. ONGLET CONCEPTION

1. Concevoir un état : onglet de conception

7 © 2006 Sage – Division Moyennes & Grandes Entreprises

Les sections
Entête état
Entête page
Détail pour chaque enregistrement de plus petit niveau
Pied page
Pied état

Entête groupe pour chaque groupe


Pied groupe

Règles sur les sections :


- 1 section peut se découper en sous-section
- Les groupes sont facultatifs
- Plusieurs groupes peuvent être déclarés
- Expert section : saisie de paramètres pour chaque section

Copyright © Sage 2009-2010 Page 9


SAFE X3 – CRYSTAL REPORT

1.6. CHAMP BASE DE DONNEE

1. Concevoir un état : champ base de données

8 © 2006 Sage – Division Moyennes & Grandes Entreprises

Les champs de la base de donnée


Champ Nom du champ dans X3 _0
Champ dimensionné Nom du champ dans X3 _n ( n >= 0 )

Alignement des champs (tout type de champ)


Alignement horizontal et vertical des champs à l’aide de guide
Important à respecter pour export excel

Copyright © Sage 2009-2010 Page 10


SAFE X3 – CRYSTAL REPORT

1.7. LISTE DES ELEMENTS INSERABLES

1. Concevoir un état : liste des éléments insérables

9 © 2006 Sage – Division Moyennes & Grandes Entreprises

Liste des éléments insérables


texte
Résumé (+ pauvre que total cumulé )
Groupe
Sous-état
Objet graphique : ligne, cadre

Copyright © Sage 2009-2010 Page 11


SAFE X3 – CRYSTAL REPORT

1.8. OBJET TEXTE

1. Concevoir un état : Objet texte

Insertion / Objet texte

10 © 2006 Sage – Division Moyennes & Grandes Entreprises

Normes à respecter pour la traduction des états :


Ne pas mette de blanc en début et fin de texte
Séparer chaque mot par un seul blanc
Laisser un seul blanc entre le texte et le caractère « : »
Eviter les textes qui dépassent l’espace d’affichage du champ
Faire commencer le texte par une Majuscule, le reste en minuscules.
Ne pas faire de tabulation
Ne pas concaténer dans un même champ, un texte avec un paramètre ou une formule

Copyright © Sage 2009-2010 Page 12


SAFE X3 – CRYSTAL REPORT

1.9. EXERCICE N°1


Objectif : créer un état qui sera basé sur la table SORDER.
On éditera une ligne par enregistrement de cette table

1. Nouveau + créer un nouveau document en tant qu’état vide

2. choix de l’ODBC.

3. Choix de la table SORDER.

4. Insertion des champs de cette table dans la section de détail :

BPCORD n° client
ORDDAT date commande
SOHNUM n° commande
SALFCY site de vente
ORDNOT H.T.
ORDATI T.T.C.
CUR devise

5. Insertion des champs texte pour le titre des colonnes.

6. Souligner les titres de colonnes.

7. Enregistrer votre état sous le nom de ZLISTCDE.rpt sous le répertoire


C:\SageX3\X3V5T\DOSSIERS\X3\REPORT

Notes

Copyright © Sage 2009-2010 Page 13


SAFE X3 – CRYSTAL REPORT

1.10. GROUPE

1. Concevoir un état : Groupe


Exemple : état STOCK00

Insertion / Groupe…
11 © 2006 Sage – Division Moyennes & Grandes Entreprises

Les groupes
Les sections d’entête et pied de groupe encadre la section détail
Si on définit plusieurs groupes, ils s’emboîtent.
Groupement sur un champ ou sur une formule ( ex : 1ère lettre du champ )
Tri croissant ou décroissant des groupes entre eux.

Copyright © Sage 2009-2010 Page 14


SAFE X3 – CRYSTAL REPORT

1. Concevoir un état : Groupes


Exemple : état STOCK00

Rapport / Expert Groupe…


12 © 2006 Sage – Division Moyennes & Grandes Entreprises

Expert groupe
Vu d’ensemble des groupes
Possibilité d’ajouter, de modifier, de supprimer ou de déplacer un ou plusieurs groupes

Copyright © Sage 2009-2010 Page 15


SAFE X3 – CRYSTAL REPORT

1.11. EXERCICE N°2


Objectif : Regrouper les lignes détails par client et trier ces clients entre eux.
Regrouper les lignes détails par devise et trier ces devises.

1. Insérer un groupe
2. Définir le groupe sur le champ no client et trier les groupes par ordre croissant.
3. Mettre une couleur de fond pour l’entête de groupe.
4. Définir un autre groupe sur le champ devise et trier ces groupes par ordre croissant.

Notes

Copyright © Sage 2009-2010 Page 16


SAFE X3 – CRYSTAL REPORT

1.12. TRI DE GROUPES

1. Concevoir un état : Tri de groupes


Exemple : état STOCK00

Etat / Expert
Rapport / Expert
Tri de
Trigroupe…
d’enregistrement…
13 © 2006 Sage – Division Moyennes & Grandes Entreprises

Expert tri de groupe


Caractéristique supplémentaire par rapport aux options de groupe
Par défaut : aucun

 Peu ou pas utilisé en standard

Copyright © Sage 2009-2010 Page 17


SAFE X3 – CRYSTAL REPORT

1.13. TRI D’ENREGISTREMENTS

1. Concevoir un état : Tri d’enregistrements


Exemple : état STOCK00

Rapport / Expert Tri d’enregistrement…


14 © 2006 Sage – Division Moyennes & Grandes Entreprises

Expert tri d’enregistrement


Tri des enregistrements à l’intérieur du groupe de plus bas niveau
Par défaut : aucun

Copyright © Sage 2009-2010 Page 18


SAFE X3 – CRYSTAL REPORT

1.14. EXERCICE N°3


Objectif : Pour chaque client, Trier les commandes sur leur date de commande.

1. Etat + Trier des enregistrements


2. Tri des enregistrements :
par ordre décroissant sur la date de commande.

Notes

Copyright © Sage 2009-2010 Page 19


SAFE X3 – CRYSTAL REPORT

1.15. RESUME

1. Concevoir un état : Résumé


Exemple : état STOCK00

Insertion / Résumé…
15 © 2006 Sage – Division Moyennes & Grandes Entreprises

Copyright © Sage 2009-2010 Page 20


SAFE X3 – CRYSTAL REPORT

1.16. TOTAL CUMULE

1. Concevoir un état : Total cumulé


Exemple : état STOCK00

16 © 2006 Sage – Division Moyennes & Grandes Entreprises

Total cumulé
Le total cumulé prend en compte tous les détails même supprimés
Il faut donc appliquer un formule de sélection dans le total cumulé

exemple d’utilisation dans l’état STOCK12G :


Le total par société n'est pas affiché si des articles n'ont pas la même unité de stock.
On crée un total cumulé de type ‘compte distinct’ sur l’unité
On supprime le total par société si le total cumulé précédent est supérieur à 1

Copyright © Sage 2009-2010 Page 21


SAFE X3 – CRYSTAL REPORT

1.17. EXERCICE N°4


Objectif : Totaliser les commandes.

1. Effectuer un sous-total HT et TTC par devise de chaque client


2. Effectuer un comptage des commandes par client

Notes

Copyright © Sage 2009-2010 Page 22


SAFE X3 – CRYSTAL REPORT

1.18. CHAMP DE PARAMETRE

1. Concevoir un état : Champs de paramètre

17 © 2006 Sage – Division Moyennes & Grandes Entreprises

Identification des paramètres


Identifié par le caractère ?

Leur rôle
Rendre paramétrable un état
Communication avec X3 (X3 leur envoie des valeurs)

Utilisation
Dans les formules de sélection d’enregistrement
Dans les formules de sections
Etc

Paramètre X3DOS
Doit être structuré de la façon suivante :
dossier;serveur;port;version;langue

L’exécution d’un état depuis le Designer Crystal nécessite une bonne alimentation de ce paramètre.

Copyright © Sage 2009-2010 Page 23


SAFE X3 – CRYSTAL REPORT

1.19. SELECTION D’ENREGISTREMENTS

1. Concevoir un état : Sélection d’enregistrements


Exemple : état STOCK00

Rapport / Expert Sélection…


18 © 2006 Sage – Division Moyennes & Grandes Entreprises

Sélection par bornes de valeurs, d’un champ pouvant être vide


On utilise une formule pour la borne de début.
Si on a 2 blancs dans le paramètre, alors on l’alimente avec un seul blanc.
Exemple :
stringVar locdeb :=" ";
if {?locdeb}=" " then locdeb :=" " else locdeb :={?locdeb}

Copyright © Sage 2009-2010 Page 24


SAFE X3 – CRYSTAL REPORT

1.20. EXERCICE N°5


Objectif : Sélection des clients.

1. Création de 2 paramètres de type « chaîne » :


?clientdeb borne de début pour le client
?clientfin borne de fin pour le client

2. Création de la formule de sélection, pour sélectionner les enregistrements :


Compris entre les paramètres ?clientdeb et ?clientfin

3. Afficher en entête d’état les sélections

Notes

Copyright © Sage 2009-2010 Page 25


SAFE X3 – CRYSTAL REPORT

1.21. CHAMPS DE FORMULE

1. Concevoir un état : Champs de formule


Exemple : état STOCK00

19 © 2006 Sage – Division Moyennes & Grandes Entreprises

Identification des formules


Identifié par le caractère @

Construction d’une formule


Utilisation de : variable, fonction, champ, total, résumé …
Une ligne de commentaire commence par les caractères //
Chaque fonction doit se terminer par le caractère ; pour enchaîner sur une autre fonction.

Déclaration d’une variable


Locale : active dans la formule courante
Globale : active dans tout l’état
Partagée : active dans l’état et les sous-état.

Doit être re-déclarée dans chaque formule ou elle est utilisée

Alimentation de la variable X par la valeur « toto »


X := « toto »

Pour les états standard traduisibles


Pas de texte « en dur » dans les formules
Utiliser les menus locaux réservés à Crystal pour stocker les textes
Utiliser ensuite la fonction TextOfChapter

Copyright © Sage 2009-2010 Page 26


SAFE X3 – CRYSTAL REPORT

1.22. EXERCICE N°6


Objectif : Ajout de champs d’autre table.

Ajout des tables clients,


1. Insérer la table BPCUSTOMER des clients par :
base de donnée + ajouter 1 base de données à l’état.
2. Lier cette table et la table SORDER des commandes.
Pour cela vérifier dans le modèle de données le type de lien nécessaire et les champs servant à la
jointure.

3. Insérer la table TABPAYTERM et la lier à la table SORDER


4. Ajouter à la formule de sélection, un filtre sur le champ TABPAYTERM.PTELIN = 1

5. Insérer la table SALESREP et la lier à la table SORDER sur le 1er représentant

6. Insérer la table SALESREP sous le pseudonyme SALESREP2 et la lier à la table SORDER sur
le 2ème représentant

Ajout des champs suivants : nom du client de la commande


Insérer le champ BPCUSTOMER.BPCNAM suite au BPCNUM dans la section entête de groupe.
Insérer le champ TABPAYTERM.PTE sur la section de détail
Insérer le champ SALESREP.REPNAM sur la section de détail
Insérer le champ SALESREP2.REPNAM sur la section de détail.

Notes

Copyright © Sage 2009-2010 Page 27


SAFE X3 – CRYSTAL REPORT

1.23. CHAMPS SPECIAUX

1. Concevoir un état : Champs spéciaux

20 © 2006 Sage – Division Moyennes & Grandes Entreprises

Les champs spéciaux


Ne s’utilisent pas dans une formule
Dans une formule, on a les fonctions équivalentes dans : propriétés du document

Champs spéciaux utilisés dans les états X3


Date et heure d’impression
Numéro de page

Copyright © Sage 2009-2010 Page 28


SAFE X3 – CRYSTAL REPORT

1.24. EXERCICE N°7


Objectif : Ajout d’informations données par Crystal par les champs spéciaux.

1. En entête de l’état, Insérer la date et heure d’impression


2. En pied de page, Insérer le n° de page

Notes

Copyright © Sage 2009-2010 Page 29


SAFE X3 – CRYSTAL REPORT

1.25. MENU CONTEXTUEL SUR CHAMP

1. Concevoir un état : menu contextuel sur champ


Exemple : état STOCK00

21 © 2006 Sage – Division Moyennes & Grandes Entreprises

Menu contextuel
Permet de mettre en forme le champ
 Particulièrement utilisé

Copyright © Sage 2009-2010 Page 30


SAFE X3 – CRYSTAL REPORT

1.26. MENU CONTEXTUEL SUR SECTION

1. Concevoir un état : menu contextuel sur section


Exemple : état STOCK00

22 © 2006 Sage – Division Moyennes & Grandes Entreprises

Menu contextuel sur section


Expert section
 Particulièrement utilisé

Copyright © Sage 2009-2010 Page 31


SAFE X3 – CRYSTAL REPORT

1. Concevoir un état : menu contextuel sur section


Exemple : état STOCK00

23 © 2006 Sage – Division Moyennes & Grandes Entreprises

« Expert Section » vous permet d’ajouter des options à vos section et de les rendre actives ou
inactives en fonction d’une formule.
Si une formule sur une option est renseignée, celle-ci est visible par la couleur rouge de l’image
« X+2 ».

Exemple, pour tous les entêtes d’état standard sur l’option « Supprimé » nous avons la formule
suivante :
if {?impselections} =0 then true else false

{?impselections} étant un paramètre permettant d’indiquer à l’état si l’utilisateur souhaite imprimer ou


non l’entête.

Copyright © Sage 2009-2010 Page 32


SAFE X3 – CRYSTAL REPORT

1.27. EXERCICE N°8


Objectif : Afficher une ligne de détails différentes en fonction de la présence du représentant 1
et du représentant 2 de la commande dans l’enregistrement.

1. Créez 2 sections de détails.


2. Dans la première insérez le libellé « Représentant 1 » et le premier représentant
3. Dans la deuxième idem avec le premier représentant et le deuxième représentant.
4. Conditionnez l’affichage de ces deux sections. Si seul le premier représentant est renseigné alors
la première section doit être affiché et la deuxième effacée. Si le premier et le deuxième
représentant sont renseignés alors la première section doit être effacée et la deuxième affichée.
Si aucun représentant n’est présent alors les deux sections sont effacées.
5. Créer un changement de page à chaque changement de no client.
6. Effacer la dernière page vide de votre état en utilisant la formule « OnLastRecord ».

Notes

Copyright © Sage 2009-2010 Page 33


SAFE X3 – CRYSTAL REPORT

1.28. SOUS RAPPORT

1. Concevoir un état : Sous-rapport

24 © 2006 Sage – Division Moyennes & Grandes Entreprises

Sous-rapport
État à part entière inséré à l’intérieur d’un état principal
Possède ces propres caractéristiques ( tables, groupements, tris, sélections )
Un seul niveau de sous-états
Liaison avec l’état principal par des paramètres, pour renseigner les liens, cliquez droit sur le sous-
rapport puis sur « Changer les liens du sous-rapport… »
Solution de dernier recours, car pénalise les performances, surtout si placé en section détail.

Cas d’emploi
Tables de données non associables par liaison
Imprimer 2 tableaux de détails distincts ( Ex : DICOX3 – liste du dictionnaire des tables )
Conserver le niveau de détail désiré ( ex : BONPRELIV – bon de prépa livraison )

Copyright © Sage 2009-2010 Page 34


SAFE X3 – CRYSTAL REPORT

1.29. ENREGISTRER L’ETAT

1. Concevoir un état : Enregistrer l’état

25 © 2006 Sage – Division Moyennes & Grandes Entreprises

Pour les états à livrer


Pour les états à livrer standard ou spécifique, ne pas enregistrer avec les données.

Par contre, si un client à un problème sur un de nos états, il peut sauvegarder avec données son
états, pour nous l’envoyer.

Copyright © Sage 2009-2010 Page 35


SAFE X3 – CRYSTAL REPORT

2. SPECIFICITES SAGE ERP X3

2.1. ETATS MODELE

2. Spécificités Sage X3 : Etats modèle


2 états modèles : ATEMPLATE_RPT1 paysage
ATEMPLATE_RPT2 portrait
 3 logos
 4 niveaux de rupture

26 © 2006 Sage – Division Moyennes & Grandes Entreprises

Copyright © Sage 2009-2010 Page 36


SAFE X3 – CRYSTAL REPORT

2. Spécificités Sage X3 : Etats modèle


3 logos : ATEMPLATE_LOGO1
ATEMPLATE_LOGO2
ATEMPLATE_LOGO3
 Pièce jointe de la fiche dossier
 Affectés dans les modèles par un sous-état

27 © 2006 Sage – Division Moyennes & Grandes Entreprises

Copyright © Sage 2009-2010 Page 37


SAFE X3 – CRYSTAL REPORT

2.2. PARAMETRES FONCTIONNELS

2. Spécificités Sage X3 : Paramètres fonctionnels


Exemple : état STOCK00

28 © 2006 Sage – Division Moyennes & Grandes Entreprises

Paramètres fonctionnels
15 caractères max.
Pour les bornes début - fin, la norme est xxxxxxdeb et xxxxxxfin ( xxxxxxstr et xxxxxxend )

Exemple
{?impselections} flag d’impression des critères sélection
{?numreq} no de requête
{?usr} code utilisateur
{?etat} code état

Paramètres multiple
1 paramètre xxx dans X3 et dans crystal
Dans crystal, ce paramètre doit être coché « Permettre valeurs multiples » et « valeurs discrètes et
valeurs de plage »
Critère de sélection :
{TABCOUNTRY.CRY_0} in {?pays}

Copyright © Sage 2009-2010 Page 38


SAFE X3 – CRYSTAL REPORT

2.3. PARAMETRES SUPERVISEUR

2. Spécificités Sage X3 : Paramètres superviseur


Exemple : état STOCK00

29 © 2006 Sage – Division Moyennes & Grandes Entreprises

Paramètres superviseur
Sont à créer dans l’état si nécessaire

X3TIT titre de l’état ( section EE & EP )


X3OPE nom opérateur de login ( section EE )
X3ETA code état ( section EP )
X3DOS code dossier ( section EP )
valeur : dossier;serveur;port;version; langue
X3EDT Information de l’éditeur ( section PP )
X3CLI raison sociale
X3LAN langue de demande d’impression
X3SIT liste des sites interdit
X3PRF profil fonction de l’utilisateur
X3FCT fonction du dictionnaire de l’état
X3USR code opérateur de login
X3FCY pour Geode, le site
X3DEP pour Geode, le déposant

X3PRF, X3FCT & X3USR seront utilisés pour le contrôle des habilitations

Copyright © Sage 2009-2010 Page 39


SAFE X3 – CRYSTAL REPORT

2.4. EXERCICE N°9


Objectif : Déclaration et utilisation des paramètres système X3.

1. Insérer les informations suivantes dans la section entête d’état :

le code de l’état
le titre de l’état
le code opérateur

Notes

Copyright © Sage 2009-2010 Page 40


SAFE X3 – CRYSTAL REPORT

2.5. MENUS LOCAUX

2. Spécificités Sage X3 : Menus locaux


Exemple : état STOCK00

30 © 2006 Sage – Division Moyennes & Grandes Entreprises

TextForCode (Dossier, Champ, Valeur) :


Cette fonction permet de récupérer le libellé associé à une valeur de menu local.
Ce libellé sera exprimé dans la langue de l’utilisateur.
La recherche se fait à partir d’un champ de type de donnée M ou MM.

Dossier : dossier exprimé sous la forme : dossier;serveur;port;version;langue


Champ : nom du champ d'une table (Table.Champ).
Valeur : valeur du champ pour laquelle on cherche le libellé, code numérique.

Fichiers utilisés : Menus, MenuFRA, MenuENG, … pour les langues du dossier

Texte limité à 123 caractères


Remarque : prise en compte de la personnalisation du vocabulaire

Copyright © Sage 2009-2010 Page 41


SAFE X3 – CRYSTAL REPORT

2.6. MENUS LOCAUX DANS LANGUE TRADUITE

2. Spécificités Sage X3 : Menus locaux dans langue traduite

31 © 2006 Sage – Division Moyennes & Grandes Entreprises

TranslatedTextForCode (Dossier, Langue, Champ, Valeur) :


Cette fonction permet de récupérer le libellé associé à une valeur de menu local dans une langue
donnée.
La recherche se fait à partir d’un champ de type de donnée M ou MM.

Dossier : dossier exprimé sous la forme : dossier;serveur;port;version;langue


Langue : code alphabétique de 3 caractères. Doit être une langue du dossier.
Champ : nom du champ d'une table (Table.Champ).
Valeur : valeur du champ pour laquelle on cherche le libellé, code numérique.

Remarque : prise en compte de la personnalisation du vocabulaire

Copyright © Sage 2009-2010 Page 42


SAFE X3 – CRYSTAL REPORT

2.7. MENUS LOCAUX EN ACCES DIRECT

2. Spécificités Sage X3 : Menus locaux en accès direct

32 © 2006 Sage – Division Moyennes & Grandes Entreprises

TextOfChapter (Dossier, Langue, Menu, Valeur) :


Cette fonction permet de récupérer le libellé associé à une valeur de menu local dans une langue
donnée.
La recherche se fait à partir d’un numéro de menu local.

Dossier : dossier exprimé sous la forme : dossier;serveur;port;version


Langue : code alphabétique de 3 caractères. Doit être une langue du dossier.
Menu : numéro de menu local.
Valeur : valeur du champ pour laquelle on cherche le libellé, code numérique.

Remarque : prise en compte de la personnalisation du vocabulaire

Copyright © Sage 2009-2010 Page 43


SAFE X3 – CRYSTAL REPORT

2. Spécificités Sage X3 : Menus locaux en accès direct

Formule textofchapter en invisible en entête d’état

33 © 2006 Sage – Division Moyennes & Grandes Entreprises

TextOfChapter :
Les textes « en dur » sont interdits dans les formules si l’état est traduisible.
Un menu local est réservé pour chaque module ( tranche 2281 – 2300 )
Ces menus locaux servent à stocker les textes qui seront utilisés dans les formules.
On bénéficie également de la personnalisation du vocabulaire.

Formule textofchapter
1 seule fois en entête d’état
La mettre en invisible
Permet de récupérer tous les textes nécessaires dans des variables globales.

Formules
Utilisation de ces variables pour imprimer un texte.

Copyright © Sage 2009-2010 Page 44


SAFE X3 – CRYSTAL REPORT

2.8. EXERCICE N°10


Objectif : Ajout d’un champ de type menu local.

On choisit le champ SOHCAT« catégorie de commande».

1. Créer le paramètre système X3 pour récupérer le dossier


2. Créer la formule ml_sohcat qui récupère le texte du menu local
3. Insérer cette formule dans la section détail
4. Créer un paramètre de début et de fin SOHCATDEB & SOHCATFIN
5. Ajouter ces paramètres dans la formule de sélection
6. Ajouter ces informations de sélection sur l’entête d’état.

Laisser le choix d’imprimer ou non l’entête d’état


1. Créer le paramètre impselections qui indique le choix de l’utilisateur (oui / non)
2. Conditionner l’affichage de l’entête d’état par ce paramètre

Notes

Copyright © Sage 2009-2010 Page 45


SAFE X3 – CRYSTAL REPORT

2.9. TEXTES TRADUITS

2. Spécificités Sage X3 : Textes traduits


Exemple : état ARCCLIENT

34 © 2006 Sage – Division Moyennes & Grandes Entreprises

X3TranslatedText :
X3Translatedtext (Dossier, Langue, Clé du texte)
Cette fonction renvoie la désignation traduite issue du fichier ATEXTRA.
A utiliser sur un champ de type de donnée AXX.

Dossier : dossier;serveur;port;version
Langue : code alphabétique de 3 caractères. Doit être une langue de connexion.
Clé du texte : « Nom table~ Nom champ~Identifiant 1~Identifiant 2~ »
champ alphanumérique

Exemple, si l’identifiant est un champ numérique :

WhilePrintingRecords;
stringVar X3TEX :=
"ATABDIV~LNGDES~"+totext(ATABDIV.NUMTAB_0},0,"",".")+"~"+{ATABDIV.CODE_0}+"~";
X3TranslatedText ({?X3DOS},{?X3LAN},X3TEX)

Fichiers textrafra, textraeng, … pour les langues de TABLAN traduites


dans répertoire X3/report/dossier

Texte limité à 80 caractères

Cela concerne tous les textes traduisibles des tables cochées « génération textes traduisibles » sauf
les désignations articles.

Copyright © Sage 2009-2010 Page 46


SAFE X3 – CRYSTAL REPORT

Attention !

Seront cochées, les tables ayant déjà des textes traduits en 140.
Les tables ayant des textes traduits apparus à partir de la version V5 ne seront pas cochées.

En effet, si la case est cochée, tous les textes traduits des enregistrements de cette table sont stockés
dans un fichier séquentiel utilisé ensuite par Crystal. Etant donné le nombre considérable de textes
devenus de type "traduit" en version V5, on adopte une nouvelle méthode pour l'impression du texte
traduit dans l'état Crystal.

Recommandation :

On ne peut pas modifier cette case, sans modifier les états Crystal liés à cette table.
On ne peut pas modifier cette case, si la table est déjà livrée en clientèle, dans le cas ou des
états spécifiques sont développés.

Copyright © Sage 2009-2010 Page 47


SAFE X3 – CRYSTAL REPORT

2. Spécificités Sage X3 : Textes traduits


Table et vue Onglet conception Exemple : état TABCOUNTRY

Formule de sélection

{TABCOUNTRY.CRY_0} in {?paysdeb} to {?paysfin} and


{AVWTEXTRA.CODFIC_0}="TABCOUNTRY" and
{AVWTEXTRA.ZONE_0}="CRYDES" and
{AVWTEXTRA.LAN_0}={?X3LAN}

35 © 2006 Sage – Division Moyennes & Grandes Entreprises

Liens sur vue AVWTEXTRA


Par la valeur code pays

Formule de sélection
Table
Champ
Langue

Pour des problèmes de performance, préférez la vue à la formule X3TRANSLATEDTEXT.

Copyright © Sage 2009-2010 Page 48


SAFE X3 – CRYSTAL REPORT

2.10. EXERCICE N°11


Objectif : Ajout d’un texte traduit.

On récupère le texte traduit pour la désignation de la condition de paiement dans la langue de


connexion X3.

1. Créer la formule tra_desnum


2. Créer le paramètre X3LAN
3. Insérer cette formule dans la section détail

Notes

Copyright © Sage 2009-2010 Page 49


SAFE X3 – CRYSTAL REPORT

2.11. CLOB ET BLOB

2. Spécificités Sage X3 : Clob et Blob


Exemple : état ARCCLIENT

36 © 2006 Sage – Division Moyennes & Grandes Entreprises

Les clobs
A utiliser sur un champ de type de donnée ACB ou AC0
Positionner le champ au format RTF si nécessaire.

Les blobs
A utiliser sur un champ de type de donnée ABB ou AB0

Copyright © Sage 2009-2010 Page 50


SAFE X3 – CRYSTAL REPORT

2.12. MONTANT EN LETTRES

2. Spécificités Sage X3 : Montant en lettres


Exemple : état CHEQUE

37 © 2006 Sage – Division Moyennes & Grandes Entreprises

AmountToWord (Dossier, Langue, Devise, Montant)


permet de convertir en toutes lettres, dans une langue donnée, un montant exprimé en chiffres.
La dll U2LToWord supporte les langues suivantes : GER, ENG, FRA, ITL, DUT, POR, SPA.

Dossier : dossier;serveur;port;version
Langue : le code de la langue d'expression, sur trois caractères
(doit être présent dans la table des langues de Sage ERP X3).
Devise : le code de la devise
(doit être défini dans la table des codes devises de Sage ERP X3)
Montant : le montant que l'on veut exprimer en lettres

Fichiers X3Curxxx.txt dans répertoire X3/lan (xxx=code langue)


un fichier par langue. une ligne par devise.

AmountToDigit (Dossier, Langue, Devise, Montant) norme anglaise


permet de convertir en toutes lettres, dans une langue donnée, un montant exprimé en « chiffres-
lettres ».

Texte limité à 255 caractères

Copyright © Sage 2009-2010 Page 51


SAFE X3 – CRYSTAL REPORT

2.13. CODES A BARRES (X3, ABEL X3)

2. Spécificités Sage X3 : Codes à barres (X3, Abel X3)


Exemple : état SETICOL

38 © 2006 Sage – Division Moyennes & Grandes Entreprises

Code à barre dans X3 et Abel X3

format : code 39
fonction : BarcodeC39 (en paramètre, le champ sur lequel on veut appliquer le code barres)
police : C39T36L.tff
taille : 24 (en fonction de la place disponible)

Copyright © Sage 2009-2010 Page 52


SAFE X3 – CRYSTAL REPORT

2.1. CODES A BARRES (GEODE, GX)

2. Spécificités Sage X3 : Codes à barres (géode GX)


Exemple : état ETIQOPE
Les paramètres

Formule @barre placée sur l'état

Formule de mise en forme de la police

39 © 2006 Sage – Division Moyennes & Grandes Entreprises

Code à barre dans géode GX

format : code 128


taille : 72 (c'est taille max, si place disponible dans le document)

Paramètres au lancement de l'état permettent de choisir entre 3 code barres 128 distincts, et 3 polices
distinctes.
Ils sont non saisis et initialisés par les paramètres C128 et C128FNT.

Paramètre pour la fonction : code128 A(1) (valeur A,B ou C)


A : BarcodeC128A(code)
B : BarcodeC128B(code)
C : BarcodeC128C(code)

Paramètre pour la police : police M(391) (valeur 1,2 ou 3)


1 : Normal "Code128"
2 : Large "Code128Wide"
3 : Etroite "Code128Narrow"

Copyright © Sage 2009-2010 Page 53


SAFE X3 – CRYSTAL REPORT

2.2. DATE NON RENSEIGNEE DANS SAGE ERP X3

2. Spécificités Sage X3 : Date non renseignée dans Sage X3


Exemple : état BOMPRN

40 © 2006 Sage – Division Moyennes & Grandes Entreprises

Date non renseignée dans le produit Sage ERP X3

Le moteur Sage ERP X3 affecte la valeur suivante à une date non renseignée :
31.12.1599 pour Oracle
01.01.1753 pour Sql-serveur

Copyright © Sage 2009-2010 Page 54


SAFE X3 – CRYSTAL REPORT

3. SAGE ERP X3

Après avoir réalisé l’état Crystal Report (le fichier .rpt), celui-ci doit être rattaché et lancé depuis la
solution X3.

3.1. ORGANISATION CLIENT ET SERVEUR

3. Sage X3 : Organisation client & serveur

• Les états  Dossier/REPORT/Langue Sur le serveur

• Les états *.rpt


 C:\Documents and Settings\All Users\Application Data\Sage\Sage X3 Client/dossier/langue/Report

Sur le client
• Les menus locaux menus, menuFRA, menuENG, …
 C:\Documents and Settings\All Users\Application Data\Sage\Sage X3 Client/dossier/ /GEN/ALL/MENL

• Les textes traduits textraFRA, textraENG, …


 C:\Documents and Settings\All Users\Application Data\Sage\Sage X3 Client/dossier/ /GEN/ALL/MENL

• Les montants en lettres X3CurFRA, X3CurENG, …


 Sage X3 Client/lan
41 © 2006 Sage – Division Moyennes & Grandes Entreprises

Etats, menus locaux, textes traduits


Toutes les données dépendantes d'une application ou d'une solution
Pour optimiser les performances, pour chaque état on peut avoir un *.rpt supplémentaire
Est nommé : Nom-etat_CrDll_dossier.rpt

Montants en lettre
Les données communes à toutes les applications et solutions.

version de référence pour les états


sur le serveur
Toute création ou modification d’un état doit s’effectuer sur le poste client dans le répertoire Rptdev.

Pour exécuter un état depuis X3


Transfert automatique du serveur vers le répertoire client Report.

Copyright © Sage 2009-2010 Page 55


SAFE X3 – CRYSTAL REPORT

3.2. ARBORESCENCE DES DOSSIERS

• Dossier mère  les états standards sont livrés dans ce dossier

• Dossier applicatif  créer les états spécifiques, dans le répertoire REPORT de ce


dossier. Le code état doit commencer par X, Y ou Z.

Attention !! Si on modifie un état standard, il devient spécifique.


Il faut alors le copier dans le dossier applicatif et le renommer.

Principe de l’arborescence des dossiers

A l’exécution depuis X3, recherche de l’état dans le dossier applicatif.


Puis, s’il n’est pas trouvé, recherche de l’état dans le dossier mère X3.

Copyright © Sage 2009-2010 Page 56


SAFE X3 – CRYSTAL REPORT

3.3. DICTIONNAIRE ETAT


Les états Crystal sont à définir dans le dossier X3 pour le standard ou le(s) dossier fils pour le
spécifique via le menu :
« Développement / Dictionnaire de traitement / Etats »

3.3.1. Onglet « Général »

Il s’agit ici de définir tous les paramètres utiles au lancement de l’état Crystal Report : _ la langue
d’origine
_ La destination
_ Les droits utilisateurs
_ Les droits utilisateurs

Multi-langues
Génération automatique des états traduits par l’industrialisation.
Etats générés ont le même nom, placés dans des répertoires « langue »
Dictionnaire est unique
Pour état non traduisible, la norme de nommage est xx-yyyyyyyyyyyy ( xx code filiale, yyyyyyyyyyyy
code état)
Code filiale : C chinese, G germany, I italy, P Portugal, S spain, UK united kingdom, US inited states

Langue origine
Langue dans laquelle un état est créé.
Pour un état multi-langues, c'est la langue de l'état d'origine.

Destination
doit exister dans la table des destinations.
si c'est un fax ou une imprimante thermique ou couleur, doit correspondre avec le type imprimante
précisé sur l'état.

Obligatoire
Au lancement de l’impression, le champ destination ne sera pas modifiable.
Flag saisissable si le champ "Destination" est renseigné.

Formule complément
Permet la recherche d'une Destination dans le paramétrage pour le triplet (état, utilisateur,
complément) ou (état, utilisateur, vide).
La formule est évaluée après saisie des paramètres.
Elle peut contenir soit des globales, soit des expressions de type PARAM(paramètre_de_l'état), etc.

Nom d'état
Cinq états peuvent maintenant être imprimés consécutivement.
La saisie des paramètres pour tous les états est regroupée au lancement.
Pour une sortie fichier, on génère 1 fichier par état. Ils seront nommés : fichier.ext fichier_1.ext
fichier_2.ext … fichier_n.ext
Le traitement d’init est exécuté pour chaque état.

3.3.2. Onglet « Paramètres »

Il s’agit ici de définir tous les paramètres X3, excepté superviseur, passés à Crystal Report :
_ Les paramètres de type bornes (clients, site, date…)
_ Les paramètres d’impressions (Impselections)

Copyright © Sage 2009-2010 Page 57


SAFE X3 – CRYSTAL REPORT

Possibilité de saisir un champ utilisé pour la segmentation. Ce champ sera a saisir par la suite lors du
lancement de l’impression sur click droit sur le champ dédié à la segmentation puis « segmentation ».

Les paramètres
Le code paramètre doit être le même côté X3 et Crystal
L’ordre de déclaration des paramètres est sans importance
le type de donnée permet une sélection mais pas de contrôle
Menu local pour le type M ou MM, permet une sélection et un contrôle
Le menu local 1 est converti dans Crystal aux valeurs (0/1)
Ne pas utiliser le type VCR mais un type de donnée lié à l’objet (ex : SOH dans ARCCLIENT)
Ne pas déclarer les paramètres systèmes
champ CONTROLE : formule dans laquelle on peut tester valeur
Champ PARAMETRE OBJET : 1er élément de clé pour un objet avec 2 partie de clé
Options :
Code option de sélection pour un type de donnée lié à 1 objet.
Pris en compte dans la fenêtre sélection, et contrôle sur saisie du paramètre
(rappel:pas de contrôle lié à l’objet sur les bornes)
Accès :
Si on n’a pas les droits de modification sur ce code accès,
le paramètre est ni saisissable ni même visualisable
Il est initialisé par la valeur par défaut.

Particularité pour les bornes début – fin


Dans l’état, 2 paramètres nommés xxxxxxdeb & xxxxxxfin ou ( xxxxxxstr & xxxxxxend )
Dans x3, on ne déclare que la borne début.

Paramètres multiple
1 paramètre xxx dans X3 et dans crystal
Dans Crystal, ce paramètre doit être coché « Permettre valeurs multiples » et « valeurs discrètes et
valeurs de plage »
Dans X3 seul le paramètre doit être déclaré avec l’option « Type de valeur » à multiple.

Ajout ou modification paramètre


Pensez à appliquer sur le dictionnaire de l’état un code activité spécifique.

Segmentation (champ de paramétrage)


Pour éclater l’édition en plusieurs, par tranche de valeur pour le paramètre saisi.

Segmentation
Possibilité de segmenter une édition
Par clic droit sur le paramètre prévu à cet effet

Type de sortie
Pré-visualisation
Imprimante
Message
Fichier

3.3.3. Onglet « Données »

Il s’agit ici de définir plusieurs sources de données à l’état Crystal Report.

sources de données :

Copyright © Sage 2009-2010 Page 58


SAFE X3 – CRYSTAL REPORT

Sources de données supplémentaires à celle de la solution & du dossier courants


Sous forme « solution;dossier »
Doit être un dossier lié dans la gestion dossier
Nb de sources de données est limité à 5.
Nb de tables limité à 10 sur le serveur d’impression (pas de limite pour le client Sage ERP X3)
Champ de paramétrage. Attention, les tables associées ne sont pas considérées comme du
paramétrage.
GDOSX3 : variable contenant le dossier mère pour tout produit
GSOLCPT : contient la solution X3.
GDOSCPT : contient le dossier X3.

Tables :
Table associée à une source de donnée différente de celle du dossier (10 tables maxi par source)
Si la table n’est pas répertoriée, elle est associée à la source de donnée du dossier courant
Nom de table doit être celui utilisé dans Crystal
Nom de pseudo s’il en existe dans Crystal
Le nom est de 200 caractères maxi.

Pré-requis :
Création préalable de ces sources de données. Il faut pour cela :

- pour le client Sage ERP X3 : s’être connecté aux dossiers correspondants à la source de données

- pour le serveur d’édition : avoir publié la solution Sage ERP X3 correspondants à la source de
données

Cas d’emploi pour tables système :


Tableau 1 : GDOSX3
Tableau 2 : tables systèmes utilisées pour l’édition
Ex : ACODIF

Copyright © Sage 2009-2010 Page 59


SAFE X3 – CRYSTAL REPORT

3.4. LANCEMENT IMPRESSION EN TEST

Le mode « développeur état » permet de dupliquer l’état sur le serveur vers le poste client de
développement et d’utiliser celui-ci au lancement depuis X3 permettant de modifier et de tester l’état
sans gêner les autres utilisateurs.

Mode « Développeur état »


Disponibles si le paramètre utilisateur DEVCRY = oui
On le trouve dans le menu « Outils »
Ce mode permet le lancement de votre état stocker dans le répertoire RptDev directement depuis le
menu X3 « Développement / Dictionnaire de traitement / Etats ».

Création d’un état :


Développer l’état dans le répertoire de développement RptDev.
Lancer l’état depuis X3, pour tests.
Lorsque l’état est valide, exporter l’état du répertoire RptDev du client vers le serveur.

Modification d’un état :


Avant toute modification, copier l’état du serveur vers le répertoire RptDev du client.
Puis, une fois modifié, recopiez cet état du répertoire RptDev du client vers le serveur

Rappel :
L’impression d’un état en exploitation est copiée dans le répertoire Report du client.

Copie des états


Menu contextuel du champ « nom état ».
Puis « Copie vers le client »
« Copie vers le serveur »

3.5. FORMATS D’EXPORT DISPONIBLES

Etat Crystal Report (.RPT)


MS Excel 97-2000 (.XLS)
MS Excel 97-2000 / données uniquement (.XLS)
MS Word (.DOC)
Texte Riche (.RTF)
Texte ASCII (.TXT)
Texte ASCII paginé (.TXT)
Portable document format (.PDF)

3.6. PARAMETRES DE CONFIGURATION SUPPORTES

Orientation du papier (portrait / paysage)


Taille du papier
Nombre de copies
Source d’alimentation du papier
Sortie en mode duplex
Groupage des copies
Plage d’impression (page de début / page de fin)

Copyright © Sage 2009-2010 Page 60


SAFE X3 – CRYSTAL REPORT

3.7. AFFECTATION ETAT A UNE FONCTION SAGE ERP X3


L’appel aux états Crystal se paramètre via le menu « Développement>Dictionnaire de
traitements>Objets » ou « Développement>Dictionnaire de traitements>Fonctions »
Les champs Impression (dédié à l’impression d’un objet) ou liste (dédié à l’impression de plusieurs
objets) peuvent contenir soit
_ Un état à imprimer, dans ce cas l’utilisateur pourra lancer l’impression de l’état par le menu de l’objet
« Fichier>Imprimer>Fiche ou Liste »
_ Un code impression regroupant plusieurs états, requête…

Le regroupement code impression et état se fait dans le menu « Paramétrage / Destination / Code
impression »

L’initialisation des paramètres par les champs des masques de la fonction se fait par le menu
« Paramétrage / Destination / Valeurs par défaut »
Exemple avec l’état « ARCCLIENT » et la fonction « GESSOH »

Fonction
Paramétrage identique sur une fonction

Copyright © Sage 2009-2010 Page 61


SAFE X3 – CRYSTAL REPORT

3.8. EXERCICE N°12


Objectif : Appel de l’état depuis X3.
3.

1. Définir l’état ZLISTCDE dans le dictionnaire des états


2. Créer les paramètres dans le dictionnaire des états
3. Lancer l’impression depuis le menu impression
4. Ajouter la liste ZLISTCDE dans la gestion des commandes de vente GESSOH.
5. Lancer l’impression depuis les commandes

Notes

Copyright © Sage 2009-2010 Page 62


SAFE X3 – CRYSTAL REPORT

3.9. LANCEMENT IMPRESSION BATCH

Le lancement en batch permet l’impression des états Crystal, prenant un temps d’impression
long. Pour que les utilisateurs puissent visualiser à leur arrivés les états imprimés pendant la nuit.

Lancement en mode batch :


Via le menu « Exploitation>serveur batch>Soumission des requêtes »

Code tâche : AIMP


Puis renseignement des paramètres de l’état.

Copyright © Sage 2009-2010 Page 63


SAFE X3 – CRYSTAL REPORT

4. LES HABILITATIONS

4.1. PARAMETRAGE DANS SAGE ERP X3

Contrôle au niveau du profil fonction


Autorisation sur impression différée

Se trouve dans le menu « Paramétrage / Utilisateur / Profil fonction »

Filtre état états autorisés


« * » 1 nombre de caractères éventuellement nul
« ? » 1 seul caractère
« # » 1 seul chiffre
« ! » 1 seule lettre

Par exemple, avec un filtre tel que AB??*, l'utilisateur n'aura les droits complets que sur les états qui
commencent par AB et ont au moins 4 caractères.

Accès au groupe d’états

Profil fonction ADMIN n’a aucune restriction.

Contrôle par état


Dans le menu « Développement / Dictionnaire traitements / Etats / Dictionnaire des états »

Exécutable si :
Exécutable exécutable depuis le menu impression
Code accès droit en exécution de l’utilisateur
Fonction droit d’accès à la fonction (on utilise la fonction de consultation, si elle existe)

Fiche dictionnaire consultable si :


Code accès droit en consultation de l’utilisateur

Fiche dictionnaire modifiable si :


Code accès droit en modification de l’utilisateur

Copyright © Sage 2009-2010 Page 64


SAFE X3 – CRYSTAL REPORT

5. MODIFIER UN ETAT :

5.1. AFFECTATION SOURCE ODBC, ETC

5. Modifier un état : affectation source ODBC, etc

54 © 2006 Sage – Division Moyennes & Grandes Entreprises

Avant toute modification d’état


Affecter la source ODBC liée au dossier sur lequel vous voulez travailler.

Aller dans le menu : Base de données / Définir l'emplacement de la source de données


Puis remplacer chaque table dont la source de donnée est incorrect :
_ Cliquez sur 1 table ( tableau supérieur )
_ Puis cliquez sur la même table sur le dossier X3 sur lequel on veut travailler ( tableau inférieur )
_ Puis cliquez sur le bouton "mettre à jour"

Vérifier ensuite l'ensemble de vos tables, pour bénéficier de leur nouvelle description :
_ Aller dans le menu : Base de données / Vérifier la base de données
_ Un message s'affichera pour chaque table mise à jour.
_ Puis, l'opération se terminera par un message final "La base de données est maintenant à jour".

Copyright © Sage 2009-2010 Page 65


SAFE X3 – CRYSTAL REPORT

5.2. EXERCICE N°13


Objectif : Modifier un document standard

On choisit l’état ARCCLIENT.rpt.

1. Créer un menu local.


2. Ajouter un champ spécifique qui s’appuie sur ce menu local dans la table SORDER.
3. Valider les menus locaux.
4. Convertir l’état standard à votre base de données.
5. Ajouter votre champ spécifique dans l’état

Notes

Copyright © Sage 2009-2010 Page 66


SAFE X3 – CRYSTAL REPORT

6. LES PERFORMANCES

• Capacité mémoire  Crystal utilise beaucoup de mémoire.

• Organisation des données  Alimenter une table de travail par


traitement d’initialisation, si nécessaire.

• Volumétrie  Utiliser la segmentation, si nécessaire

• Liens des tables entre elles  Utiliser jointure interne & liaison =

• Fonctions de la dll U2LText  utiliser WhilePrintingRecords

• Sous-états  A n’utiliser que si nécessaire

Dans l’outil Crystal Report menu « Fichier>Options… » onglet Base de données

Vues
Utilisation des vues dans les états standards X3

Propriétaire LIKE
Permet de faire un filtre sur les dossiers X3
A utiliser si on atteint la limite de Crystal sur le nombre de tables ( et donc le nombre de dossiers)

Sélectionner des données distinctes pour la recherche


Ne pas cocher cette option
Si l’option est cochée, on peut constater des problèmes sur les états contenant des blob ou clob

Option « Exécuter requête en mode asynchrone »


Ne pas cocher cette option
Si l’option est cochée, des problèmes de verrouillage d'enregistrements peuvent se produire sous
"SQL Server 2000"
Ou l’impression peut s’interrompre avec le message "Erreur API CR "ImpCrystal_Event" - Erreur ID :
707"

Dans l’outil Crystal Report menu « Fichier>Options… » onglet « Création de rapport »


Si vous ne souhaitez pas enregistrer les données avec l’état décochez l’option.

Copyright © Sage 2009-2010 Page 67


SAFE X3 – CRYSTAL REPORT

7. TRAITEMENT D’INIT

Permet :
• D’écriture du traitement avant et après l’impression
• Pendant la saisie des paramètres de lancement
• Préparer les données à imprimer dans un fichier temporaire
• Mettre à jour des données dans les tables du produit Sage X3

Exemple ARCCLIENT :
• Sélection des enregistrements à traiter
• Mise à jour d’un flag d’impression sur chaque commande.
• Stockage de la clé de ces enregistrements dans la table AREPORTM
• Construction de l’état sur la table principale AREPORTM

Attention :
Un traitement d’init étant lié au fonctionnement de l’état Crystal, dans certains cas celui-ci devra aussi
être modifiés avec l’état. Pensez donc à vérifier l’existence d’un traitement lié à l’état avant la
modification de celui-ci.

Copyright © Sage 2009-2010 Page 68


SAFE X3 – CRYSTAL REPORT

8. ERREURS FREQUENTES

L’état ne s’imprime pas :


• Aucun enregistrement ne correspond à la sélection

 Faire attention aux liaisons internes, si l’enregistrement de la table de destination est facultatif

Les lignes de détails sont répétées n fois :


• Ce n’est donc pas le niveau de détail le plus fin

 Appliquez un filtre de sélection sur la table qui pose problème


 En dernier recours, faire un sous-état pour isoler la table qui pose problème

Copyright © Sage 2009-2010 Page 69


SAFE X3 – CRYSTAL REPORT

9. OUTILS D’ANALYSE

9.1. GESTION DES IMPRESSIONS


Accessible via le menu « Fichier>Gestion des impressions … »

Permet de visualiser, en local, la liste des tâches en cours d'exécution


Permet de supprimer une tâche de la liste ou changer sa priorité (selon l'habilitation).

Le statut :
0 : Demande en file d’attente
1 : Début d’exécution
2 : Demande en cours d’exécution
5 : Exécution terminée
6 : l’exécution a échoué
99 : Erreur interne

Les boutons MONTER & DESCENDRE :


Ils permettent de changer la priorité d'exécution d'un job par rapport à un autre
( quand le job est dans l'état JOBSTARTED).

Copyright © Sage 2009-2010 Page 70


SAFE X3 – CRYSTAL REPORT

9.2. SURVEILLANCE IMPRESSIONS


Accessible par le menu « Impressions / Surveillance impressions»

Permet de visualiser, pour un serveur d'impression donné, la liste des tâches en cours d'exécution
Permet de supprimer une tâche de la liste ou changer sa priorité (selon l'habilitation).

Champ Serveur:
Nom serveur d’édition+port serveur d’édition (voir information dans la console)

Menu contextuel sur une tâche


Supprimer une requête
Changer la priorité d’une requête

Phases
Réception demande
Lecture paramètres
Mise à jour du cache
Traitement Pièces jointes
Attente disponibilités processus d'impression
Prise en compte par processus d'impression
Prise en compte par le Print Engine Crystal
Impression terminée
Erreur

Statut : OK ou KO

Temps
Attente : temps écoulé depuis la prise en compte par le serveur d’impression.
Exécution : temps écoulé depuis la prise en compte par le processus d’impression.

Copyright © Sage 2009-2010 Page 71


SAFE X3 – CRYSTAL REPORT

10. ANNEXE - EXERCICE

Objectif : Affichez Une ligne sur deux en gris clair.

1. Pour ce faire allez dans les sections puis dans l’onglet couleur, une formule peut-être ajouté pour
conditionner l’utilisation d’une couleur.

Notes

Copyright © Sage 2009-2010 Page 72


SAFE X3 – CRYSTAL REPORT

Copyright © Sage 2009-2010 Page 73