Rapports
Dernière mise à jour
Dernière mise à jour
Les rapports d’information sont utilisés pour afficher des informations descriptives concernant les éléments de la couche. Ces rapports peuvent afficher des attributs extraits de la source de données spatiales de la couche ou encore des informations extraites d’autres bases de données. Chaque couche peut comporter zéro, un ou plusieurs rapports. Les rapports d’information sont présentés sous forme de pages Web ou de documents en format PDF.
L'onglet Rapports de l'interface de configuration de la couche offre les outils pour configurer les rapports.
L'onglet présente un tableau des rapports configurés pour la couche. Dans les applications JMap, les rapports sont présentés dans cet mème ordre. Il est possible de changer l’ordre à l’aide du menu Modifier.
Pour créer un nouveau rapport d’information, appuyez sur Créer.
Pour effacer des rapports, sélectionnez-les dans le tableau et appuyez sur Supprimer.
Il existe trois types de rapports : De base, Avancé et Personnalisé.
Les rapports de base sont générés sous forme de pages web. Ils contiennent des fonctions d’exportation en format Excel et d’impression. Les tables contenant les valeurs peuvent être triées en cliquant sur les entêtes des colonnes. Il est aussi possible de configurer les noms des champs à afficher dans les rapports.
Titre
Le titre du rapport.
Extraire les données de
Modèle (simple)
Modèle de rapport utilisé pour les rapports sur un seul élément de la carte
Modèle (multiple)
Modèle de rapport utilisé pour les rapports sur un ensemble d’éléments de la carte.
Attributs
Titre
Texte à afficher dans le rapport au lieu du nom de l’attribut.
Les rapports peuvent être générés en format HTML ou en format PDF. Ils supportent aussi l’intégration d’une carte géographique.
Format
HTML : Le rapport est généré sous la forme d’une page web. Des outils permettent d’exporter le contenu du rapport et de l’imprimer. S’il s’agit d’un rapport pour plusieurs éléments de la carte, il est alors possible de trier le contenu du rapport en cliquant sur les entêtes des colonnes. PDF : Le rapport est généré en format PDF. Ce format est mieux adapté pour l’impression car il possède une meilleure mise en page. Par contre, le contenu du rapport est plus statique qu’avec le format HTML.
Titre
Le titre du rapport.
Extraire les données de
Modèle (simple)
Modèle (multiple)
Avec les rapports de type avancé, il est possible de choisir le modèle de rapport à utiliser. Deux modèles sont livrés par défaut avec JMap, soit un modèle de rapport de base et un modèle de rapport avec une carte géographique intégrée. Chacun de ces modèles est aussi disponible en 2 versions : pour un seul élément et pour une sélection d’éléments multiples.
Les fichiers de modèles (.rpttemplate) de rapports sont placés dans le répertoire JMAP_HOME/applications/templates/reports. Vos modèles doivent être placés dans le sous-répertoire single ou multiple, selon qu’ils sont en version élément simple ou éléments multiples.
Les rapports de type personnalisé sont des rapports externes à JMap qu’il est possible d’appeler au moyen d’une URL. Ces rapports peuvent provenir d’outils de rapports (p.e. Crystal Reports, Jaspersoft, etc.) ou encore de simples pages web.
Une syntaxe spéciale permet de formater les paramètres à passer pour l’ouverture du rapport.
Titre
Le titre du rapport.
URL du rapport
Entrez l’URL qui permettra d’ouvrir le rapport externe. Il est probable que vous deviez passer certains paramètres dans l’URL du rapport pour identifier les éléments pour lesquels on souhaite ouvrir un rapport. Les valeurs des paramètres proviennent généralement des attributs liés des éléments de la carte. Une syntaxe spéciale est utilisée pour le formatage des paramètres.
Par exemple, si votre rapport doit être appelé par cette URL : http://myserver/reports/myreport?id=3, si l’attribut 0 contient les valeurs du paramètre, la syntaxe à utiliser sera : http://myserver/reports/myreport?id=%0
Mais si votre rapport peut inclure des informations sur une sélection multiple d’éléments de la carte, la syntaxe des paramètres peut prendre une des 2 formes différentes.
Si votre rapport doit être appelé par cette URL :
http://myserver/reports/myreport?id=3,4,5,
et si l’attribut 0 contient les valeurs du paramètre, la syntaxe à utiliser sera :
http://myserver/reports/myreport?%param[%0,’id’,’,’]
Cette syntaxe utilise l’expression %param[Indice attribut, nom du paramètre, séparateur].
%n
Remplacée par la valeur d’attribut lié correspondante pour l’élément. Par exemple, %0 fait référence au premier attribut lié, %1 au deuxième, et ainsi de suite.
%f
Remplacée par une date ou un nombre formaté.
%p
Remplacée par le nom du projet en cours.
%u
Remplacée par le nom de l’utilisateur actuellement connecté.
%s
Remplacée par l’identifiant de la session en cours.
%h
Remplacée par le nom de l’hôte ou l’adresse de l’instance JMap Server à laquelle le client est connecté.
%o
Remplacée par le numéro du port (http ou direct) de l’instance JMap Server à laquelle le client est connecté.
%t
Remplacée par l’heure actuelle (date et heure).
Les rapports de types de base et avancé peuvent prendre leurs données dans les attributs de la couche ou dans une base de données externe connectée à JMap.
Sélectionner l’option Couche courante afin de créer un rapport simple qui n’interroge que les attributs de la couche (voir plus bas pour l’option Base de données externe). Sélectionner ensuite les attributs à inclure dans le rapport en utilisant les cases à cocher. Seuls les attributs sélectionnés seront présentés à l’utilisateur. Les autres seront exclus du rapport. Finalement, il est possible spécifier des titres pour les attributs. Ceux-ci seront affichés à l’utilisateur au lieu des noms réels des attributs.
Sélectionner l’option Base de données externe afin d’indiquer à JMap qu’il faut présenter des informations provenant d’une autre base de données, et non pas de la couche. Cette option permet d’interroger toute base de données possédant un champ qui correspond à un des attributs de la couche.
Attributs
Base de données
Sélectionnez la base de données d’où seront extraites les données du rapport. La base de données à interroger doit préalablement avoir été configurée dans JMap Admin.
Requête SQL
Saisissez la requête SQL de type SELECT qui sera utilisée pour extraire les données de la base de données. Cette requête peut comporter plusieurs tables. La requête doit inclure le champ clé utilisé pour effectuer la jointure avec un attribut de la couche. Vous devez ensuite appuyer sur Exécuter afin d’exécuter la requête une fois.
Champs de jointure
Table
Sélectionnez la table qui contient le champ de jointure.
Champ
Parmi les champs de la table sélectionnée, sélectionnez le champ qui servira à faire la jointure avec la couche.
Attribut
Parmi les attributs de la couche, sélectionnez celui qui servira à faire la jointure avec les données de la base de données.
Pour les rapports prenant leurs données dans une base de données externe, il est possible de définir les titres champs à afficher dans le rapport, au lieu des noms des champs de la base de données. Appuyez sur Titres pour définir ces titres.
Couche courante : Obtenir les données du rapport directement dans les attributs de la couche. Voir . Base de données externe : Obtenir les informations du rapport d’une base de données externe, connectée à JMap. La base de données doit contenir un champ permettant de faire le lien avec un attribut de la couche. Voir .
Les rapports de type avancé sont basés sur l’outil de rapport BIRT (). Un modèle de rapport par défaut est fourni avec JMap. Il est aussi possible d’utiliser l’application BIRT report Designer afin de créer des rapports personnalisés, ou encore de modifier le modèle fourni pour l’adapter à vos besoins (ajouter un logo, changer les couleurs, etc.). Pour plus d’information sur le développement de rapports, consultez le site web de BIRT ().
Couche courante : Obtenir les données du rapport directement dans les attributs de la couche. Voir . Base de données externe : Obtenir les informations du rapport d’une base de données externe, connectée à JMap. La base de données doit contenir un champ permettant de faire le lien avec un attribut de la couche. Voir .
Modèle de rapport utilisé pour les rapports sur un seul élément de la carte. Deux modèles sont disponibles : inforequest.rpttemplate : Modèle de base qui contient une table disposée verticalement. inforequestMap.rpttemplate : Semblable au modèle de base mais contient aussi une carte géographique. Voir .
Modèle de rapport utilisé pour les rapports sur un ensemble d’éléments de la carte. Deux modèles sont disponibles : selectionreport.rpttemplate : Modèle de base qui contient une table disposée horizontalement. selectionreportMap.rpttemplate : Semblable au modèle de base mais contient aussi une carte géographique. Voir .
Si votre rapport doit être appelé par cette URL :
http://myserver/reports/myreport?id=3,id=4,id=5
et si l’attribut 0 contient les valeurs du paramètre, la syntaxe à utiliser sera :
http://myserver/reports/myreport?%param[%0,’id’]
Cette syntaxe utilise l’expression %param[Indice attribut, nom du paramètre]. Il est aussi possible d’inclure d’autres variables pour la composition de l’URL, telles que %f, %p, %u, %h, etc.
Voir la section pour plus d’information à ce sujet.
Deux formats sont possibles :
%f[%n^D^dd/MM/yyyy]
où %n correspond à un attribut contenant une date, D indique que nous désirons afficher une date formatée et dd/MM/yyyy est la suite du format, tel qu’indiqué dans la documentation de la classe Java .
%f[%n^N^##0,00]
où %n correspond à un attribut contenant un nombre, N indique que nous désirons afficher un nombre formaté, et ##0,00 est la suite du format, tel qu’indiqué dans la documentation de la classe Java .
