ReportBuilder Le nouveau moteur d impression «ReportBuilder» a été intégré dans Gestimum, il vous permettra de créer facilement vos propres modèles d impression. ReportBuilder est un produit, sophistiqué et puissant, plein d'astuces. CREER UN NOUVEAU MODELE - Placez vous soit sur le menu d impression en sélectionnant Nouveau modèle ReportBuilder, soit à partir de n importe quel fenêtre d impression. - Sélectionnez dans «Nom du modèle», le libellé «Nouveau modèle ReportBuilder». - Cliquez sur l icône trois points, saisissez le nom du nouveau modèle. - L extension sera gérée automatiquement par Gestimum qui mettra à disposition ce nouveau modèle dans le module où il a été créé. PRESENTATION - L environnement ReportBuilder vous propose les onglets suivants : 1.1. Onglet Données : Permet la sélection de la table de données qui contient les champs à la création du rapport. Sélectionnez directement la table ou laissez vous guider par l assistant. Page 1
Lors de l insertion d une table celle-ci se présente sous la forme suivante Icône Description Aperçu : Permet de visualiser le résultat de votre requête Tables : Choisissez la/les tables nécessaires dont vous avez besoin pour votre rapport Champs : Choisissez les champs de la/des table(s) choisie(s) précédemment Calculs : Permet de faire des calculs sur les champs (max, min, avg en SQL) Groupe : Permet de regrouper les champs (clause Group By en SQL) Recherche : Ajout de conditions (clause Where en SQL ) Tri : Trier les éléments d une table en ordre croissant ou décroissant selon un/ des champs choisi(s) Lien : Permet de faire une jointure avec une autre table SQL : Visualiser la requête générée en mode texte 1.2. L onglet Calculs : 1.3. L onglet Conception : Cette partie vous permettra de sélectionner et appliquer des calculs nécessaires à votre rapport. Le langage utilisé est le Pascal Cette fenêtre est composée des trois parties : En-tête : Les données insérées dans cet ensemble s afficheront dans l entête du rapport. Détail : Les données insérées seront affichées dans le corps du rapport. Bas : Les données insérées seront affichées dans le pied du document Page 2
Icône Description Sélectionner l objet : Curseur de la sélection Texte : Permet d afficher du texte Mémo : Permet d afficher un mémo, c'est-à-dire plusieurs lignes de texte Texte formaté : Permet d afficher un texte enrichi (Gras, italique, couleur, ) Variable système : Permet d afficher la date, l heure, le numéro de page en cours, le nombre de pages Variable : Permet d afficher le résultat d une formule de calcul, écrit en langage Pascal. Image : Permet d afficher une image. Les formats supportés sont : JPG, JPEG, BMP, GIF, ICO, EMF et WMF. Forme : Forme de type rond, rectangulaire, carré, etc Ligne : Permet l insertion d une ligne (Horizontale, verticale). Code barre : Champ qui permet d associer un code pour obtenir un code barre DB_Texte : Permet l insertion d un champ de la base de donnée DBMémo : Permet l impression d un champ mémo disponible dans la base de donnée DBTexteFormaté : DBCalculé : Possibilité d effectuer des calculs avec les données en utilisant des sommes, soustractions, etc. DBImage : Possibilité d insérer une image stockée dans la base de données DBCodeABarre : Convertit une donnée en code barre Page 3
Région : Permet de regrouper plusieurs zones, afin de leur donner le même aspect et/ou le même comportement SousRapport : Permet d afficher un ensemble de données issu d une autre table, par exemple les lignes d une facture Option qui permet de déplacer un groupe de composants pixel par pixel Option qui permet d homogénéiser la taille d un groupe de zones sélectionnées. Option qui permet d aligner un groupe de composants sélectionnés. Option pour espacer de manière régulière un groupe de composants sélectionnés. Option qui permet de centrer un groupe d icônes sélectionnés Créer un nouveau rapport 1.3.1. Paramétrage de base Sélectionner les outils de travail dans la barre d outils A partir du menu Affichage / Barre d outils, nous vous conseillons d ajouter toutes les barres que vous enlèverez plus tard en fonction de vos besoins. Veuillez à conserver Arborescence du rapport et Arborescence des données. Arborescence des données : Affiche les différentes tables et les champs de la base de données sélectionnés dans l onglet Données. Arborescence du rapport : Affiches les différents champs (variables, Mémo ) insérés dans votre rapport Page 4
Correspondance des champs pouvant être perçu dans l arborescence du rapport Texte Mémo Texte Formaté Variable système Variable Image Forme Ligne Code Barre DBTexte DBMémo DBTexteFormaté DBCalculé DBImage DBCodeBarre Région Sous Rappot Saut de page Tableau croisé Choisir l unité de mesure de votre rapport Onglet CONCEPTION puis Rapport/Unités, il est préférable de travailler en millimètres pour permettre le cadrage du modèle sur la page et identifier plus facilement les espacements à gérer. Les marges Fichier/Mise en forme Page/ Onglet Marge (Les marges sont exprimées selon l unité choisie précédemment) 1.4. L onglet Aperçu Permet de visualiser votre rapport Page 5
Rechercher du texte dans le rapport Affichage du rapport avec un zoom de 52% Affichage du rapport avec un zoom de 95% Affichage du rapport avec un zoom de 100% CREATION D UNE FACTURE ETAPE PAR ETAPE 1.5. Entête du document Les données de l entête du document que vous souhaitez afficher sur l entête de chacune des pages doivent être insérées dans la bande «EN-TETE» de l onglet conception. 1.5.1. Insertion d un logo Cliquez sur l icône Image ( ) puis, par le menu contextuel «Photo» associez l image souhaitée. Page 6
Remarque : Sélectionnez l option ConserverLeRatioVisuel pour conserver la qualité de l image lorsque vous adaptez la taille de l image à votre document. 1.5.2. Sélection de données La sélection des données qui seront affichées dans le document à créer doit être effectuée dans L onglet Données. A partir du menu Fichier/Nouveau/Designer de requête sélectionnez les tables nécessaires : - Les Coordonnées de la société sont disponibles dans la table Préférences de la société qui correspond à la table SOCIETE dans Gestimum. - Double cliquez pour sélectionner la table. - Cliquez sur l onglet Champs et sélectionnez dans la liste les champs dont vous avez besoin (exemple : le capital correspond dans Gestimum au champ SOC_CAPITA, Siret, RCS, NAF ) puis appuyez sur Nom des champs dans la base de donnée Gestimum 1.5.3. Lien entre les tables - Lorsque vous sélectionnez une table ayant un lien commun avec une autre, on visualise dans cette fenêtre en caractère gras la Table Associée. Page 7
1.5.4. Coordonnées de la société - Retournons dans L onglet Conception. Vous pouvez apercevoir dans l arborescence des données l apparition de la table SOCIETE. Table sélectionnée dans l onglet données Page 8
Nom du logo que l on a inséré dans l entête du document (il est possible de modifier son nom en faisant clique droit puis renommer) Champs sélectionnés Correspondant à la table SOCIETE - Il est alors possible de faire glisser ces champs par drag & drop vers l entête du rapport. Nom de l alias du champ sélectionné (Libellé du champ) Valeur du champ correspondant - Pour visualiser la valeur du champ, vous pouvez accéder par le menu Affichage/Afficher données Ce qui donne : Page 9
Remarque : Cette méthode est intéressant si on le souhaite afficher les coordonnées de la société les uns en dessous des autres. S il faut aligner les champs les uns derrière les autres, cette méthode n est pas adaptée puisque l on ne connaît pas la longueur d un champ et les données risquent de se chevaucher. Explication en Image Onglet Conception Onglet Aperçu 1.5.5. Ajout d une variable On peut noter l espace qu il y a entre les 2 valeurs des champs de l image ci-dessus. Pour rendre votre rapport plus dynamique. Nous allons donc créer une Variable qui vous permettra de gérer l affichage des champs à l aide de la saisie d un peu de code. - Dans l onglet conception cliquez sur l icône Variable et insérez-le dans l entête. - Vérifiez que le type de la variable soit de type chaîne. Page 10
- Puis, sélectionnez l option Calculs - La fenêtre suivante s affiche : - Faites glisser les champs par un drag & drop comme précédemment, puis ajouter le texte souhaité. Dans notre exemple voici ce que cela donne : - Le signe + permet de concaténer les chaînes. - Pour vérifier si votre calcul est correct passez par l option du menu contextuel Compiler. Si le code est correct vous verrez en bas à gauche le message suivant : - Cliquez sur et retournez dans l onglet aperçu pour vérifier le résultat.* Page 11
- Si vous souhaitez un retour à la ligne entre vos champs, il faut ajouter le code ascii chr(13) 1.5.6. Mise en forme automatique Par le menu contextuel sur la variable vous pouvez sélectionner Mise en forme automatique, cette option ajuste automatiquement la variable au contenu. Elle ne fonctionne que si les données sont dans le sens Horizontal, sinon, vous devez ajuster la taille de votre variable. 1.5.7. Retour à la ligne sur mot Option à sélectionner pour prendre en compte le retour à la ligne chr(13). - L onglet Aperçu : 1.5.8. Coordonnées du Tiers Les coordonnées du tiers figurant sur le document de vente se trouvent dans la table DOCUMENTS. - Retournez dans l onglet Données /Icône Tables, puis ajoutez la nouvelle table Documents. - Sélectionnez par exemple les champs Raison sociale (DOC_F_RS), Adresse (DOC_F_RUE), Code postal (DOC_F_CP), Ville (DOC_F_VILL) du tiers. Page 12
- Ajoutez ces champs dans l entête de l Onglet Conception - Onglet Aperçu 1.5.9. Choix de la table de base du rapport (Pipeline de données) En fonction du modèle à réaliser et des résultats qu on souhaite obtenir, nous devons choisir une table de base qui gère les données à traiter. Chaque rapport permet le choix d une seule table. Cela n empêche pas de pouvoir sélectionner plusieurs tables et d afficher des données de chacune d entre elles dans un rapport. La sélection de la table Maître détermine la table de départ pour le choix de données et elle sera assujettie à un choix de critères. Le choix de la table se fait dans l onglet Conception par le menu Rapport/Donnée - Dans le modèle que nous sommes en train de réaliser, nous devons sélectionner Documents car les données de cette table détermineront le contenu de cette partie du rapport. Cette table est composée des plusieurs enregistrements alors que la table Préférences ne contient qu un seul enregistrement unique qui se répétera par document imprimé et ne nécessite pas un critère de sélection. 1.5.10. Critères de Filtre ReportBuilder vous permet de filtrer un certain nombre de données en définissant des Critères de filtre. Vous pouvez renseigner ces critères à partir de l onglet Données/ Icône Champs / Onglet Recherche/ Critères. Vous pouvez choisir d imprimer par exemple seulement les documents de type «Bon de livraison». Remarque Par défaut lorsque vous êtes dans ReportBuilder, et qu un document est sélectionné le N de document (DOC_NUMERO) est automatiquement renseigné dans la fenêtre de Critères. Page 13
1.6. Corps du document Les lignes qui composent le corps du document se trouvent dans la table LIGNES dans Gestimum. - Retournez dans l onglet Données / Icône Tables, puis sélectionnez la table lignes, ainsi que les champs que vous souhaitez faire figurer. - Nous allons donc prendre le code de l article (ART_CODE), le libellé de cet article (LIG_LIB), la quantité (LIG_QTE), le prix unitaire (LIG_P_BRUT), et le Total c'est-à-dire la quantité * prix unitaire (LIG_TOTAL). Pensez à ajouter le champ N de document qui vous permettra de faire le lien avec la table DOCUMENTS, de ce fait, vous pouvez afficher dans votre document tous les articles se rapportant à ce N de document. 1.6.1. Lier la table Détail avec la table Maître (lien extérieur) : Vous devez faire l association des tables pour définir qui est la table Détail et qui est la table Maître. Cette information vous permettra de déterminer : que pour une ligne du fichier Documents, plusieurs lignes détail lui sont associées. - A partir de l onglet Données, cliquez sur l icône Lien. Page 14
- Sélectionnez dans la fenêtre Maître la table DOCUMENTS. - Le champ qui lie les deux tables s affiche dans la fenêtre Champs liés. - Vous avez le choix pour inclure les enregistrements des documents en fonction des lignes trouvées. Nous vous conseillons d utiliser l option N 2. 1.6.2. Créer un sous rapport (SubReport) Le corps du document peut être composé d un ou de plusieurs Sous rapports. L intérêt de gérer les sous rapports est de pouvoir gérer plusieurs niveaux de détail ou d imprimer plusieurs rapports en un seul. Chaque sous Rapport doit être associé à une table différente (pipeline de données). Pour afficher et filtrer les données de la table LIGNES, vous pouvez créer un sous rapport (Onglet Conception/ menu Rapport/Donnée). - Dans l onglet Conception, cliquez sur l icône SousRapport puis cliquez dans la bande Détail. - Un onglet Principal identifiera les données de la table Documents et un nouvel onglet SubReport sera ajouté. - Le contenu de cet onglet s affichera dans la partie Détail. Page 15
Structure d un Sous Rapport Le sous rapport est composé de trois bandes : Titre, Détail et Sommaire. - Le Titre du sous rapport est l équivalent à l Entête du rapport qui se répète de manière identique dans le corps du document. - Le Détail sera la partie variable du sous rapport et imprimera le détail des données. - Le Sommaire du sous rapport est l équivalent au pied du détail du rapport. Création des Groupes Les groupes permettent de regrouper et trier les informations sur un ensemble de critères. - Dans notre exemple nous n avons pas besoin des parties Titre ni Sommaire, vous pouvez les désélectionner à partir du menu Rapport /Titre /Sommaire. - Pour ajouter un Groupe, sélectionnez dans le menu Rapport/ l option Groupes. - Les différents critères de regroupement sont disponibles dans la liste déroulante, sélectionnez le N de document (DOC_NUMERO) qui permet de regrouper les lignes d un même document par le bouton Ajouter. - Sélectionnez «Champs données», puis «Réimprimer les en-têtes de groupe sur les pages subséquentes». - Cliquez sur OK, les bandes En-tête de groupe et Bas du groupe apparaissent. Page 16
1.6.3. Ajouter des éléments dans le corps du document - Vous avez créé un sous rapport associé à la table LIGNES. - Disposez les libellés des Titres de chaque colonne dans l entête de groupe que vous venez de créer, à l aide de l icône Texte. - Placez les champs correspondants de la table LIGNES disponibles dans l arborescence de données (Affichage/ Barre d outils/ Affichage de données) dans la partie Détail.. 1.6.4. Création d un fond de page Page 17
Personnalisez la présentation de vos documents à l aide des outils ReportBuilder. - Pour créer une présentation en arrière plan du corps du document, passez par l option Style de page du menu Rapport. - Une bande Style de page s ajoute à la fin de la fenêtre. - Dessinez les encadrements souhaités dans cette partie à l aide des outils de dessin. - Pour faire l encadrement arrondi, cliquez sur l icône Formes. - Choisissez parmi les options disponibles dans la barre d outils : Rectangle arrondi. - - Pour les traits verticaux, utilisez l icône Ligne dans la barre d outil le trait dessinez proposera les options suivantes : Gauche, haut, bas, droit. - Remarque Après avoir réalisé la présentation souhaitée, ne décochez pas l option sélectionnée : Rapport/Style de page. Vous perdrez votre mise en forme. Page 18
1.7. Pied du document Les éléments du pied sont disponibles dans la table DOCUMENTS. Ces éléments peuvent être placés dans le rapport principal partie Bas qui est déjà associé à cette table à partir de laquelle, on obtient également les données du tiers. Et voici votre document terminé! Page 19