Le concepteur de rapports comporte trois blocs : Script, catégorie - bloc dans lequel la requête SQL elle-même est rédigée.
Décrit dans la section Travail avec les requêtes ; Tables - bloc dans lequel les colonnes du rapport sont ajoutées et configurées.
Décrit dans la section Travail avec les colonnes ; Paramètres - bloc dans lequel les paramètres variables sont configurés pour exécuter le rapport.
Décrit dans la section Travail avec les paramètres ; Dans ce bloc, l'utilisateur rédige une requête SQL qui devra charger des données depuis les tables de la base de données.
Les requêtes sont rédigées en SQL.
L'utilisateur doit avoir des compétences de base en programmation SQL pour rédiger des requêtes.
Le SQL au niveau de base peut être appris en très peu de temps (jusqu'à 1 jour).
Les requêtes de base nécessaires pour créer des rapports de base sont décrites dans la section Requêtes SQL de base.
Ce bloc de documentation décrit les actions possibles avec un bloc de code SQL déjà rédigé ; le travail avec les requêtes de base nécessaires à la création de rapports de base est décrit dans la section Requêtes SQL de base.
Le code de la requête SQL est saisi dans le bloc « Script, Catégorie : » : Après la rédaction du code du script, les opérations suivantes sont possibles : Exécuter pour vérifier - pour exécuter le rapport, cliquez sur le bouton .
Après avoir appuyé sur le bouton, le script commencera à s'exécuter ; cela peut prendre de quelques secondes à plusieurs minutes, selon la complexité et la quantité de données téléchargées.
Si le compilateur de code détecte une erreur dans le code, il l'affichera en bas dans le bloc rouge : S'il n'y a pas d'erreurs, un message apparaîtra en bas de la fenêtre indiquant que le rapport est en cours de chargement, et à la fin du chargement, une fenêtre avec le résultat de la requête s'ouvrira.
Si la requête peut théoriquement afficher plus de 10 000 lignes, il est conseillé d'utiliser les limites TOP 1000 ou TOP 10000 après la commande SELECT pour la vérifier ; Arrêter le rapport - si le rapport prend très longtemps à charger, ou si vous avez décidé d'arrêter l'exécution - cela peut être fait en cliquant sur .
Ce bouton devient rouge et actif lorsque le rapport est en cours d'exécution.
Transfert des champs sélectionnés dans SELECT vers les colonnes du rapport.
Les colonnes sont toujours ajoutées au rapport avec une requête. Pour ajouter des colonnes, cliquez sur le bouton .
Après avoir cliqué, le système déterminera lui-même les colonnes et leurs noms et les ajoutera au rapport : Le système affichera également ces colonnes dans le bloc « Tables », où l'utilisateur peut les personnaliser.
Les paramètres des colonnes sont décrits dans la section « Travail avec les colonnes ».
Le système ajoute automatiquement toutes les colonnes. Les colonnes inutiles sont supprimées en cliquant sur .
Elles peuvent être ajoutées ultérieurement depuis le bloc « Table ».
Transfert des paramètres du rapport vers le champ « Paramètres » pour la configuration.
Pour transférer les paramètres, cliquez sur .
Après avoir cliqué, le système déterminera lui-même ce que sont les paramètres et transférera leurs noms vers le champ « Paramètres ».
Les paramètres qui n'ont pas été migrés sont affichés en rouge dans l'éditeur de requêtes SQL, et ceux qui ont été migrés en vert.
Chaque paramètre doit être configuré ; la façon de les configurer et les formats dans lesquels les paramètres peuvent apparaître dans le code SQL est décrite dans la section « Travail avec les paramètres ».
Tous les champs sélectionnés via SELECT dans la requête SQL sont affichés à deux endroits - au-dessus du constructeur et dans le bloc « Tables » : Le système affichera également ces colonnes dans le bloc « Tables », où l'utilisateur peut les personnaliser.
Les paramètres des colonnes sont décrits dans la section « Travail avec les colonnes ».
Le système ajoute automatiquement toutes les colonnes. Les colonnes inutiles sont supprimées en cliquant sur .
Elles peuvent être ajoutées ultérieurement depuis le bloc « Table ».
Transfert des paramètres du rapport vers le champ « Paramètres » pour la configuration.
Pour transférer les paramètres, cliquez sur .
Après avoir cliqué, le système déterminera lui-même ce que sont les paramètres et transférera leurs noms vers le champ « Paramètres ».
Les paramètres qui n'ont pas été migrés sont affichés en rouge dans l'éditeur de requêtes SQL, et ceux qui ont été migrés en vert.
Chaque paramètre doit être configuré ; la façon de les configurer et les formats dans lesquels les paramètres peuvent apparaître dans le code SQL est décrite dans la section « Travail avec les paramètres ».
Tous les champs sélectionnés via SELECT dans la requête SQL sont affichés à deux endroits - au-dessus du constructeur et dans le bloc « Tables » : Initialement, tous les champs sont automatiquement ajoutés au rapport après avoir cliqué sur le bouton dans la fenêtre de requête SQL, et sont affichés au-dessus du constructeur et dans le bloc « Tables ».
Après la suppression d'un champ, vous pouvez le rajouter en cliquant sur le + à côté de son nom dans le bloc « Tables ».
L'utilisateur peut modifier l'ordre d'affichage des champs - simplement en faisant glisser leurs noms dans le bloc supérieur.
L'utilisateur peut également modifier la taille des colonnes en les étirant.
L'apparence des colonnes dans le bloc supérieur correspond entièrement à la façon dont elles seront affichées dans le rapport.
Pour modifier les paramètres d'un champ, cliquez sur son nom - une fenêtre avec les paramètres suivants s'ouvrira : Style général - modification du style général du rapport.
Le processus est similaire à l'édition dans tout autre éditeur de texte ; Développer par - ce champ est décrit en détail dans la section Développer par et Regrouper par ; Regrouper par - ce champ est décrit en détail dans la section Développer par et Regrouper par ; Nom - l'utilisateur définit le nom de cette colonne dans le rapport ; Clé - indique quelles données extraire dans la colonne.
Par exemple, il y a une requête : SELECT SKU_ID SKU, STORE_ID STORE FROM SALES_SKU Si l'utilisateur place le code du champ STORE dans les paramètres de la colonne SKU, les données de la colonne STORE seront affichées dans la colonne SKU du rapport.
Mais cela n'est possible que si une seule colonne SKU est affichée ; si les colonnes SKU et STORE sont toutes les deux affichées, l'ajout du code de champ ne fonctionnera pas.
Vous ne pouvez pas ajouter un code de champ au même champ.
Type de données - sélection du type de données à afficher dans le champ.
Les types de données suivants sont pris en charge : Texte - pour les champs textuels - par exemple « Nom de l'article » ; Nombre - pour les champs numériques - par exemple, « Volume des ventes » ; Date - pour les champs avec n'importe quel format de date - par exemple, « Semaine des ventes » ou « Date des ventes » ; Format - ce champ apparaît si vous sélectionnez le type de données « Nombre » ou « Date ».
Lien - permet à l'utilisateur d'ajouter un lien vers une autre page, des données ou autre chose.
Par exemple, il y a une requête : SELECT SKU_ID SKU, SITE_LINK LINK FROM MONITORING La colonne SKU affiche les codes produits et la colonne LINK affiche les liens vers le site.
Dans ce cas, si l'utilisateur sélectionne un lien vers LINK dans le champ « Lien » des paramètres de la colonne SKU, dans le rapport, lorsque l'utilisateur clique sur le numéro dans la colonne SKU, un lien de la colonne LINK s'ouvrira.
Le lien ne peut être ajouté qu'à d'autres colonnes ; Largeur - l'utilisateur peut limiter la largeur possible du champ dans le rapport.
La valeur doit être saisie en pixels. Si la largeur est automatique, le champ sera étiré pour s'adapter au texte.
Style cellule - modification d'un style distinct pour l'affichage des informations dans le rapport.
Le processus est similaire à l'édition dans tout autre éditeur de texte ; Ces deux champs de paramètres de colonne sont toujours définis ensemble.
Ces paramètres vous permettent d'implémenter des colonnes croisées - lorsque plusieurs données provenant d'autres colonnes sont affichées dans une seule colonne.
Par exemple, cela permet à l'utilisateur d'afficher les données de ventes de produits pour plusieurs semaines sur une seule ligne, sans ajouter manuellement une colonne distincte pour chaque semaine.
Cette fonctionnalité sera expliquée plus en détail dans l'exemple ci-dessous.
L'utilisateur a créé une requête pour afficher les ventes de la première semaine des 5 dernières années pour l'article sélectionné 56 dans tous les magasins (Magasin 1 et Magasin 2) : En conséquence, il a obtenu le rapport suivant : Vous pouvez constater que le rapport affiche 10 lignes, mais dans un format peu pratique.
Il serait beaucoup plus pratique si toutes les semaines et les ventes étaient affichées sur une seule ligne avec le produit, ce qui donnerait seulement deux lignes pour chaque magasin.
Sous cette forme : Pour de telles transformations, utilisez Développer par.
Tout d'abord, l'utilisateur doit supprimer de l'affichage la colonne dont les données devront être développées et insérées dans une autre colonne.
Dans cet exemple, il s'agit de la colonne avec les semaines - WEEK WK.
Il est donc nécessaire de cliquer en haut dans la rangée des colonnes sur l'icône à côté de la colonne WEEK ; L'étape suivante consiste à cliquer sur l'icône à côté de la colonne dans laquelle vous souhaitez afficher une autre colonne.
Dans notre cas, il s'agit des colonnes Ventes et Stock - cliquez donc sur le bouton à côté des deux colonnes - après avoir cliqué, choisissez quelle colonne doit être affichée à l'intérieur - dans notre cas, c'est WK (Semaine) ; Après cela, WK est également affiché dans le champ Développer par des paramètres des colonnes correspondantes.
Pour Développer par, l'utilisateur peut utiliser toutes les colonnes qui ne sont pas affichées dans le rapport, mais qui sont présentes dans la requête.
Ensuite, l'utilisateur doit configurer dans quelle colonne les données seront regroupées.
Dans cet exemple, il est nécessaire que les données soient regroupées par magasins - c'est-à-dire que dans le champ Regrouper par, sélectionnez STR (le nom de la colonne qui extrait les données par magasins dans la requête SQL).
L'utilisateur ne peut sélectionner Regrouper par que pour une seule colonne ; dans les autres colonnes avec Développer par, cette sélection sera automatiquement reportée.
Après avoir complété tous les paramètres, l'utilisateur peut cliquer sur et voir comment les données sont affichées : Les paramètres sont des valeurs que l'utilisateur sélectionne lors de l'exécution d'un rapport.
Cela permet à l'utilisateur de sélectionner uniquement les données qui répondent à ses critères.
Les paramètres sont automatiquement transférés depuis le code dans l'éditeur SQL vers le bloc « Paramètres » après avoir cliqué sur le bouton .
Une fois que les paramètres sont apparus dans le bloc « Paramètres », ils peuvent être configurés.
Il existe deux types de paramètres : :paramètre - ces paramètres transmettent une valeur spécifique et doivent être spécifiés dans le code comme : where variable = :paramètre; [liste_paramètre] - ces paramètres transmettent un ensemble de valeurs et doivent être spécifiés dans le code comme : where variable [liste_paramètre]; Par exemple, si l'utilisateur doit transmettre le nombre « 5 » comme paramètre, il utilise le format :paramètre après le signe égal.
En conséquence, après le démarrage du rapport, le paramètre fonctionnera dans le code comme : where valeur = 5.
Si l'utilisateur doit transmettre un ensemble - par exemple (1,3,8), il utilise le format [liste_paramètre] sans signe égal.
En conséquence, après le démarrage du rapport, le paramètre fonctionnera dans le code comme : where valeur in (1,3,8).
L'utilisateur peut utiliser tous les noms de paramètres pratiques, l'essentiel est d'utiliser le format correct.
Pour configurer un paramètre, cliquez sur le nom du paramètre dans le bloc « Paramètres ».
Après avoir cliqué, une fenêtre s'ouvre avec les paramètres suivants : ID - identifiant du paramètre - il est extrait automatiquement selon le champ auquel il est appliqué, il ne peut pas être modifié ; Nom - nom du paramètre - doit être égal au nom du paramètre dans le code ; Affichage - nom du paramètre qui sera affiché lors de l'exécution du rapport ; Type - sélection du type de paramètre - il est très important de spécifier le bon type pour un fonctionnement correct du paramètre et éviter les erreurs.
Les types de paramètres suivants sont pris en charge : Texte - le paramètre transmettra une valeur textuelle, ne peut être utilisé qu'avec le format de paramètre : paramètre ; Nombre - le paramètre transmettra une valeur numérique, ne peut être utilisé qu'avec le format de paramètre : paramètre ; Date - le paramètre transmettra la date au format AAAA-MM-JJ, ne peut être utilisé qu'avec le format de paramètre : paramètre ; Semaine - le paramètre transmettra la date au format de semaine ISO - AAAASS, ne peut être utilisé qu'avec le format de paramètre : paramètre ; Mois - le paramètre transmettra la date au format de mois ISO - AAAAMM, ne peut être utilisé qu'avec le format de paramètre : paramètre ; Liste - le paramètre transmettra un ensemble de valeurs dans n'importe quel format.
Il est utilisé lorsqu'il est nécessaire de transmettre plus d'une valeur.
Par exemple (1, 3, 8) ou (magasin, entrepôt) ou (202015, 202025).
Ne peut être utilisé qu'avec le format de paramètre [liste_paramètre] ; Sélection - le paramètre transmettra un ensemble de valeurs sélectionnées par une requête spéciale, indiquée dans le champ « Requête ».
Ne peut être utilisé qu'avec le format de paramètre : paramètre ; Min - valeur minimale du paramètre.
Peut être utilisé pour les nombres, les dates, les semaines, les mois ; Max - valeur maximale du paramètre.
Peut être utilisé pour les nombres, les dates, les semaines, les mois ; Requête - remplie uniquement pour le format « Sélection ».
Pour afficher les requêtes possibles, l'utilisateur doit saisir le texte « select » dans le champ, les requêtes disponibles apparaîtront automatiquement dans une liste.
Lors de l'exécution du rapport, les informations extraites de la requête seront affichées dans une liste déroulante lors de la sélection de la valeur du paramètre.
Les requêtes suivantes sont actuellement automatiquement prises en charge (mais vous pouvez également en créer d'autres) : report_select_stores - utilisé pour sélectionner un magasin dans la liste pour la valeur du paramètre ; report_select_groups - utilisé pour sélectionner un groupe dans la liste pour la valeur du paramètre ; report_select_managers - utilisé pour sélectionner un responsable dans la liste pour la valeur du paramètre ; report_select_contracts - utilisé pour sélectionner un contrat dans la liste pour la valeur du paramètre ; report_select_suppliers - utilisé pour sélectionner un fournisseur dans la liste pour la valeur du paramètre ; report_select_whs - utilisé pour sélectionner un entrepôt dans la liste pour la valeur du paramètre ; report_select_fcst - utilisé pour sélectionner un numéro de prévision dans la liste pour la valeur du paramètre ; Index - ne peut être saisi que pour les paramètres de type Date, Semaine, Mois.
L'index permet à l'utilisateur de soustraire ou d'ajouter automatiquement une valeur au paramètre.
Ainsi, si l'utilisateur définit le paramètre Date et l'Index à -10, alors par défaut lors de l'exécution du rapport, la valeur de date affichée sera de 10 jours inférieure à la date par défaut spécifiée dans le champ « Valeur ».
Si le champ valeur est laissé vide, la date sera soustraite de la date actuelle ; Valeur - une valeur par défaut est saisie qui sera affichée lors de la sélection des options avant l'exécution du rapport.
Ci-dessous sont présentées des variantes de définition des paramètres dans une requête SQL pour différents types de données : where sku_id = :sku_id - utilisé pour sélectionner un SKU spécifique par le code MySales.
Lors de l'exécution du rapport, un numéro SKU est transmis au paramètre.
Le type de paramètre doit être « Nombre » ; where sku_id [sku_id_list] - utilisé pour sélectionner plusieurs SKUs par code MySales.
Lors de l'exécution du rapport, un ensemble de numéros SKU séparés par des virgules est transmis au paramètre.
Le type de paramètre doit être « Liste » ; where item_code = :item_code - utilisé pour sélectionner un SKU spécifique en utilisant le code interne.
Lors de l'exécution du rapport, un code texte est transmis au paramètre.
Le type de paramètre doit être « Texte » ; where item_code [item_code_list] - utilisé pour sélectionner plusieurs SKUs par le code interne.
Lors de l'exécution du rapport, un ensemble de codes texte SKU séparés par des virgules est transmis au paramètre.
Le type de paramètre doit être « Liste » ; where ((sku_id = :sku_id) or (:sku_id = 0)) - paramètre complexe - utilisé pour permettre d'afficher tous les SKUs ou un seul spécifique.
Dans ce cas, pour afficher tous les SKUs, la valeur 0 est saisie pour le paramètre au démarrage du rapport, ou le numéro d'un SKU spécifique pour afficher un seul SKU ; Les exemples ci-dessus de définition de paramètres dans le code sont applicables à tous les types de paramètres et de champs.
Pour travailler avec le composeur de rapports, il est très important de comprendre la structure de la base de données afin de savoir quelles données extraire de quelles tables, quels sont les noms des champs, et comment lier les données de différentes tables.
L'utilisateur peut afficher la structure de la base en cliquant sur et en choisissant « Afficher la base de données ».
Après la sélection, une fenêtre s'ouvrira dans laquelle toutes les tables et tous les champs qu'elles contiennent seront affichés.
Une recherche est disponible dans la fenêtre de la base de données, ce qui permet à l'utilisateur de trouver les tables et les colonnes.