Académique Documents
Professionnel Documents
Culture Documents
Safe X3
Support de formation
Crystal Report
Version 6
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
6. LES PERFORMANCES............................................................................................................................ 67
7. TRAITEMENT D’INIT............................................................................................................................. 68
8. ERREURS FREQUENTES ........................................................................................................................ 69
1. CONCEVOIR UN ETAT
ODBC
Elle permet de s’affranchir de la base de données et donc permet la portabilité des états.
Information de connexion
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.
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
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
Les sections
Entête état
Entête page
Détail pour chaque enregistrement de plus petit niveau
Pied page
Pied état
2. choix de l’ODBC.
BPCORD n° client
ORDDAT date commande
SOHNUM n° commande
SALFCY site de vente
ORDNOT H.T.
ORDATI T.T.C.
CUR devise
Notes
1.10. GROUPE
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.
Expert groupe
Vu d’ensemble des groupes
Possibilité d’ajouter, de modifier, de supprimer ou de déplacer un ou plusieurs groupes
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
Etat / Expert
Rapport / Expert
Tri de
Trigroupe…
d’enregistrement…
13 © 2006 Sage – Division Moyennes & Grandes Entreprises
Notes
1.15. RESUME
Insertion / Résumé…
15 © 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é
Notes
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.
Notes
6. Insérer la table SALESREP sous le pseudonyme SALESREP2 et la lier à la table SORDER sur
le 2ème représentant
Notes
Notes
Menu contextuel
Permet de mettre en forme le champ
Particulièrement utilisé
« 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
Notes
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 )
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.
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}
Paramètres superviseur
Sont à créer dans l’état si nécessaire
X3PRF, X3FCT & X3USR seront utilisés pour le contrôle des habilitations
le code de l’état
le titre de l’état
le code opérateur
Notes
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.
Notes
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
WhilePrintingRecords;
stringVar X3TEX :=
"ATABDIV~LNGDES~"+totext(ATABDIV.NUMTAB_0},0,"",".")+"~"+{ATABDIV.CODE_0}+"~";
X3TranslatedText ({?X3DOS},{?X3LAN},X3TEX)
Cela concerne tous les textes traduisibles des tables cochées « génération textes traduisibles » sauf
les désignations articles.
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.
Formule de sélection
Formule de sélection
Table
Champ
Langue
Notes
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
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
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)
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.
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
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.
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
Montants en lettre
Les données communes à toutes les applications et solutions.
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.
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)
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.
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.
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
sources de données :
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
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.
Rappel :
L’impression d’un état en exploitation est copiée dans le répertoire Report du client.
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
Notes
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.
4. LES HABILITATIONS
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.
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)
5. MODIFIER UN ETAT :
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".
Notes
6. LES PERFORMANCES
• Liens des tables entre elles Utiliser jointure interne & liaison =
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)
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.
8. ERREURS FREQUENTES
Faire attention aux liaisons internes, si l’enregistrement de la table de destination est facultatif
9. OUTILS D’ANALYSE
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
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)
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.
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