HTMLReportGenerator

Catégories

Cartographie et rapports

Spécifique à un format

Web

Permet de créer des rapports web basiques constitués d'éléments empilés verticalement en utilisant la géométrie et les attributs des entités.

La sortie HTML est stockée dans l'attribut html_content pour être facilement écrite dans une page HTML à l'aide du Writer HTML. Les éléments pris en charge comprennent le texte, les tableaux, les graphiques (à barres, linéaires et à secteurs), les cartes présentant une variété de fournisseurs de cartes de base (Esri Leaflet, Mapbox Leaflet et Google Maps). Le style utilise le CSS Twitter bootstrap. La sortie de ce Transformer est liée à des bibliothèques et des fichiers CSS hébergés via un CDN (Content Delivery Network). Les sorties nécessitent donc une connexion Internet pour rendre certaines entités telles que les cartes et les graphiques.

La sortie de ce Transformer est destinée alimenter le Transformer HTMLLayouter pour concevoir des pages avec une mise en page plus sophistiquée.

Configuration

Ports d'entrée

Toutes les entrées sont fournies par un seul port. Plusieurs entités peuvent être utilisées pour créer une seule entité de sortie stockant une seule page HTML de sortie dans l'attribut html_content.

Ports de sortie

Ce Transformer prend en charge Regrouper par et produit une seule entité par groupe (ou simplement une seule entité si Regrouper par n'est pas utilisé) contenant une seule page HTML dans l'attribut html_content. Tous les attributs d'entrée (autres que les attributs Regrouper par) et les géométries seront perdus sur l'entité de sortie.

Paramètres

Regrouper par

Si le paramètre Regrouper par est défini, une page HTML par groupe est produite.

Traitement des regroupements

Sélectionnez le moment du traitement où les groupes sont traités :

Quand toutes les entités sont reçues

Comportement par défaut. Le traitement ne se produira dans ce Transformer que lorsque toutes les entrées seront présentes.

Quand le groupe change (avancé)

Ce Transformer traitera les groupes en entrée dans l'ordre. Les changements de la valeur du paramètre Regrouper par sur le flux d'entrée déclencheront le traitement du groupe en cours de regroupement. Cela peut améliorer la vitesse globale (en particulier avec plusieurs groupes de taille égale), mais peut provoquer un comportement indésirable si les groupes en entrée ne sont pas ordonnés.

Il y a deux raisons typiques d'utiliser Quand le groupe change (avancé). La première concerne les données entrantes qui sont destinées à être traitées en groupes (et qui sont déjà classées ainsi). Dans ce cas, c'est la structure qui dicte l'utilisation de Regrouper par - et non des considérations de performance.

La seconde raison possible est le potentiel gain de performances.

Les gains de performance sont plus visibles quand les données sont déjà triées (ou lues en utilisant une déclaration SQL ORDER BY) puisque moins de travail est requis de la part de FME. Si les données doivent être ordonnées, elles peuvent être triées dans le traitement (bien que la surcharge de traitement supplémentaire puisse annuler tout gain).

Le tri devient plus difficile en fonction du nombre de flux de données. Il peut être quasiment impossible de trier des flux de données multiples dans l'ordre correct, car toutes les entités correspondant à une valeur Regrouper par doivent arriver avant toute entité (de tout type d'entité ou jeu de données) appartenant au groupe suivant. Dans ce cas, l'utilisation de Regrouper par avec Lorsque toutes les entités sont reçues peut être une approche équivalente et plus simple.

Note  De multiples types d'entités et entités de multiples jeux de données ne vont généralement pas arriver dans l'ordre correct.

Comme pour beaucoup de scénarios, tester différentes approches dans votre traitement avec vos données est le seul moyen sûr d'identifier le gain de performance.

Titre de la page

Cet attribut permet aux utilisateurs de spécifier un titre HTML (Il s'agit du titre qui apparaîtra dans l'onglet du navigateur).

Cette section permet aux utilisateurs d'ajouter, d'ordonner et de supprimer des éléments de la page dans la liste. La page de sortie affichera les éléments dans l'ordre où ils sont spécifiés dans cette liste.

La configuration de chaque élément se fait dans la partie de droite de la fenêtre.

Prévisualisation dans le Navigateur

Ce bouton, situé en bas du Transformer, permet à l'utilisateur de visualiser un aperçu de la page qu'il crée dans son navigateur par défaut. En cliquant sur ce bouton, vous obtiendrez un aperçu de la mise en page approximative de la page. La génération de l'aperçu peut ne pas fonctionner si certains paramètres sont dans l'état invalide. Dans de nombreux cas, la page finale sera différente, car l'aperçu ne connaît pas les valeurs réelles qui seront envoyées lors de l'exécution.

Paramètres du contenu

Diagramme (Barres)

Cet élément crée un graphique à barres réactif de base à l'aide de la bibliothèque chart.js. Cet élément de page attend plusieurs entités d'entrée et combine les données de ces entités en un seul graphique. Chaque entité d'entrée crée une nouvelle barre sur l'axe des x du graphique.

Étiquette Axe des X

Ce paramètre permet d'insérer une étiquette sur l'axe des X du diagramme.

Attribut étiquette des repères X

Cet attribut contrôle les valeurs qui apparaîtront sous chaque barre le long des X.

Étiquette Axe des Y

Ce paramètre permet d'insérer une étiquette sur l'axe des Y du diagramme.

Séries de données

Ce tableau permet à l'utilisateur de spécifier plusieurs séries de données différentes pour son graphique à barres. Dans la colonne Attribut de données, l'utilisateur doit sélectionner un attribut numérique qui sera tracé comme données de comptage (ou la hauteur de la barre) pour une entité donnée. Le champ Couleur permet à l'utilisateur de spécifier une couleur unique pour chaque série de données.

Graphique (Ligne)

Cet élément crée un graphique linéaire réactif de base à l'aide de la bibliothèque chart.js. Cet élément de page attend plusieurs entités d'entrée et combine les données de ces entités en un seul graphique. Chaque entité d'entrée crée un nouveau point sur l'axe des x du graphique.

Étiquette Axe des X

Ce paramètre permet d'insérer une étiquette sur l'axe des X du diagramme.

Attribut étiquette des repères X

Ce champ d'attribut obligatoire contrôle les valeurs qui apparaîtront sous chaque barre le long de l'axe des x. Notez que les points de données seront toujours espacés uniformément le long de l'axe des x. Si vous avez besoin de la flexibilité nécessaire pour avoir des valeurs d'axe des x non uniformément espacées, envisagez d'utiliser ChartGenerator pour générer une image de graphique statique qui peut être ajoutée à la page comme élément "Image".

Étiquette Axe des Y

Ce paramètre permet d'insérer une étiquette sur l'axe des Y du diagramme.

Séries de données

Ce tableau permet à l'utilisateur de spécifier plusieurs séries de données différentes pour son graphique linéaire. Dans la colonne Attribut de données, l'utilisateur doit sélectionner un attribut numérique qui sera tracé comme données de l'axe des y (ou la hauteur du point) pour une entité donnée. Le champ Couleur permet à l'utilisateur de spécifier une couleur unique pour chaque série de données.

Graphique (Secteurs)

Cet élément crée un graphique circulaire responsive de base à l'aide de la bibliothèque chart.js. Cet élément de page attend plusieurs entités d'entrée et combine les données de ces entités en un seul graphique. Chaque entité d'entrée crée une tranche dans le camembert.

Attribut étiquette

Cet attribut contrôle l’étiquette associée à chaque secteur, utilisée à la fois en légende et en info bulle.

Attribut données

La valeur de cet attribut numérique déterminera la taille d'une tranche donnée. Les tranches seront pondérées en fonction de la valeur de cet attribut.

Schéma couleur

Ici, un schéma de couleurs peut être spécifié pour le graphique circulaire. Les options comprennent Rouge à Blanc, Bleu à Blanc, Rouge à Vert, Arc-en-ciel, Pastel et Foncé.

En-tête

Permet à l'utilisateur d'entrer du texte comme en-tête ou paragraphe.

Texte

Paramètre requis qui permet à l'utilisateur d'entrer du texte à afficher dans la page.

Niveau d'en-tête

Cela permet à l'utilisateur de définir le niveau d'en-tête du texte. S'il est défini sur Aucun, le texte sera ajouté à la taille normale d'un paragraphe (balise <p>).

Identifier

Paramètre facultatif qui permet à l'utilisateur de spécifier l'attribut id pour cet élément d'en-tête ou de paragraphe. S'il est laissé vide, aucun attribut id ne sera défini.

Alignement du texte

Permet à l'utilisateur de spécifier l'alignement du texte sur la page. Les options comprennent Gauche, Droite, Centre et Justifié.

Couleur

Permet de spécifier la couleur du texte.

Image

Cet élément permet soit de lier une image, soit de l'intégrer dans la page.

Méthode de jointure

Ce paramètre permet à l'utilisateur de choisir s'il veut établir un lien vers une image en utilisant une URL ou un chemin relatif ou s'il veut intégrer le contenu réel de l'image dans sa page. Notez que cette dernière option peut faire gonfler considérablement la taille de la page HTML pour les grandes images.

URL de l'image

Cette option n'est activée que lorsque la méthode de jointure est définie sur liée. Elle permet à l'utilisateur de spécifier une image via un chemin relatif ou une URL externe.

Fichier image

Cette option n'est activée que lorsque la méthode de jointure est définie sur intégrée. Elle permet à l'utilisateur de spécifier une image sur le disque à intégrer dans la page. Ce paramètre attend un chemin d'accès valide à un fichier png ou jpeg. Si ce chemin d'accès est défini à partir d'un attribut, l'utilisateur doit s'assurer que l'image existe sur le disque au moment où les entités atteignent ce Transfomer. Si vous souhaitez utiliser une image créée dynamiquement dans le cadre d'un flux de travail, pensez à utiliser le Transformer FeatureWriter avant ce Transformer pour écrire cette image sur le disque et l'utiliser dans le rapport au sein d'un seul traitement.

Texte en cas d'erreur

Cette option permet de spécifier un texte qui s'affiche si le chargement de l'image échoue.

Liste

Permet de créer une liste de texte à partir d'un attribut.

Eléments de la liste.

Attribut utilisé pour remplir les valeurs de la liste.

Marqueurs des éléments de la lite.

Cette option permet de définir si la liste est matérialisée par des puces, des numéros, des lettres ou rien.

Couleur du texte

Permet de définir la couleur du texte de la liste.

Contenu des badges

Cet attribut ne peut être défini que si Eléments de liste comme marqueurs a pour valeur Aucun. Si cet attribut est défini, des badges de style "bootstrap" seront placés sur le côté droit de la liste.

Carte (Esri Leaflet)

Cet élément permet de créer une carte web représentant les géométries des entités entrantes comme des couches.

Note  Les tuiles utilisées pour générer des cartes intégrées peuvent être soumises à des limitations d'utilisation et à d'autres restrictions. Veuillez consulter les conditions d'utilisation.

Attribut étiquette

Cette option permet à l'utilisateur de spécifier la valeur d'un attribut à utiliser pour étiqueter chaque entité sur la carte au sein d'une info-bulle.

Echappement HTML

Ce paramètre détermine si les valeurs de l'attribut Label seront mises en évidence par l'encodage HTML.

Si Oui (par défaut) : les valeurs d'attribut en entrée comme <b>input</b> resteront inchangées.

Si Non : les entrées seront analysées comme si elles contenaient des balises HTML, ce qui fera que des entrées comme <b>input</b> apparaîtront comme b.

Couleur de couche

Cette option permet de spécifier un couleur pour la couche.

Carte de fond

Cette option permet à l'utilisateur de choisir dans la liste des cartes de base Esri disponibles. Les options comprennent : Rue, Terrain, Satellite, Gris, Gris sombre, Relief ombré, Topographique, et National Geographic.

URL(s) des couches supplémentaires

Ce paramètre permet de spécifier une liste de couches ArcGIS Online (séparées par des virgules) pouvant être affichées en complément.

Map (Google)

Cet élément permet à l'utilisateur de créer une simple carte Web présentant les géométries des entités d'entrée sous forme de couche. Notez que ce Transformer ne prend en charge qu'une seule carte Google par page. Pour créer une page Web contenant plusieurs cartes Google, vous devez créer plusieurs pages (à l'aide de l'élément Regrouper par ou de plusieurs Transformers HTMLReportGenerator), puis les réassembler en une seule page à l'aide du Transformer HTMLLayouter.

Note  Les tuiles utilisées pour générer des cartes intégrées peuvent être soumises à des limitations d'utilisation et à d'autres restrictions. Veuillez consulter les conditions d'utilisation.

Attribut étiquette

Cette option permet à l'utilisateur de spécifier la valeur d'un attribut à utiliser pour étiqueter chaque entité sur la carte au sein d'une info-bulle.

Echappement HTML

Ce paramètre détermine si les valeurs de l'attribut Label seront mises en évidence par l'encodage HTML.

Si Oui (par défaut) : les valeurs d'attribut en entrée comme <b>input</b> resteront inchangées.

Si Non : les entrées seront analysées comme si elles contenaient des balises HTML, ce qui fera que des entrées comme <b>input</b> apparaîtront comme b.

Couleur de couche

Cette option permet de spécifier un couleur pour la couche.

Jeton d'accès

Ce champ facultatif permet à l'utilisateur de spécifier son jeton d'accès à l'API Google Maps. Notez que cela n'est pas nécessaire pour créer une simple carte Web Google Maps.

Carte (Mapbox Leaflet)

Cet élément permet à l'utilisateur de créer une simple carte Web présentant les géométries des entités d'entrée sous forme de couche. Notez que cet élément de page nécessite que l'utilisateur crée ou possède un compte Mapbox pour obtenir un jeton d'accès Mapbox.

Consulter http://www.mapbox.com pour créer un compte gratuit.

Note  Les tuiles utilisées pour générer des cartes intégrées peuvent être soumises à des limitations d'utilisation et à d'autres restrictions. Veuillez consulter les conditions d'utilisation.

Attribut étiquette

Cette option permet à l'utilisateur de spécifier la valeur d'un attribut à utiliser pour étiqueter chaque entité sur la carte au sein d'une info-bulle.

Echappement HTML

Ce paramètre détermine si les valeurs de l'attribut Label seront mises en évidence par l'encodage HTML.

Si Oui (par défaut) : les valeurs d'attribut en entrée comme <b>input</b> resteront inchangées.

Si Non : les entrées seront analysées comme si elles contenaient des balises HTML, ce qui fera que des entrées comme <b>input</b> apparaîtront comme b.

Couleur de couche

Cette option permet de spécifier un couleur pour la couche.

Jeton d'accès

Ce champ obligatoire permet à l'utilisateur de spécifier son jeton d'accès à l'API Mapbox. Ce jeton est nécessaire pour que le plan de base s'affiche correctement.

Id carte

Cette option permet à l'utilisateur de saisir l'identifiant de style d'une carte créée avec son compte Mapbox. La valeur par défaut est mapbox/streets-v11 car cette carte devrait être présente sur tous les comptes.

Map (Mapbox GL JS)

Cet élément permet à l'utilisateur de créer une simple carte Web présentant les géométries des entités d'entrée sous forme de couches. Des sources de données externes peuvent également être spécifiées en tant que couches supplémentaires. Notez que cet élément de page nécessite que l'utilisateur crée ou possède un compte Mapbox pour obtenir un jeton d'accès Mapbox.

Consulter http://www.mapbox.com pour créer un compte gratuit.

Jeton d'accès

Ce champ obligatoire permet à l'utilisateur de spécifier son jeton d'accès à l'API Mapbox. Ce jeton est nécessaire pour que le plan de base s'affiche correctement.

Attribut étiquette

Ce paramètre facultatif permet à l'utilisateur de spécifier une valeur d'attribut utilisée pour étiqueter chaque entité sur la carte dans une infobulle cliquable.

Echappement HTML

Ce paramètre détermine si les valeurs de l'attribut Label seront mises en évidence par l'encodage HTML.

Si Oui (par défaut) : les valeurs d'attribut en entrée comme <b>input</b> resteront inchangées.

Si Non : les entrées seront analysées comme si elles contenaient des balises HTML, ce qui fera que des entrées comme <b>input</b> apparaîtront comme b.

Couleur de couche

Cette option permet à l'utilisateur de spécifier une couleur pour les couches géométriques et les couches vectorielles ajoutées.

Carte de fond

Cette option permet à l'utilisateur de saisir l'identifiant de stylemap d'une carte créée avec son compte Mapbox. La valeur par défaut est mapbox/streets-v11 car cette carte devrait être présente sur tous les comptes.

URL WMS

Ce champ facultatif permet à l'utilisateur de saisir une liste d'URL délimitées par des virgules vers des sources WMS à ajouter comme couches supplémentaires sur la carte de sortie. Par défaut, la taille des tuiles est de 512.

Couches vectorielles

Ce tableau permet à l'utilisateur de saisir une liste facultative de paires comprenant des URL de sources de couches vectorielles et des couches dans ces sources. Ces couches seront rendues comme des couches de lignes.

URL de couche d'entité

Le lien vers une source de couche vectorielle. Il doit être fourni avec le suffixe `{z}/{y}/{x}`. Notez que l'utilisation d'un service de tuiles vectorielles non-MapBox peut causer des problèmes CORS lors du chargement de la couche dans certains navigateurs.

Couche source

Le nom de la couche source dans le service de tuiles correspondant.

Séparateur

Permet de définir un élément séparateur ou une balise <hr>.

Épaisseur du séparateur (pixels)

Ce paramètre contrôle la taille des séparateurs.

Table

Cet élément crée une table HTML basique dont le contenu est issu des attributs des entités entrantes.

Style du tableau

Permet à l'utilisateur de choisir entre plusieurs styles de tableaux bootstrap, notamment : Basic, Bordered, Condensed, Combined, Hover, and Striped. Le style par défaut est Bordered.

Le style Combiné produira un tableau avec des styles bordé, condensé, survolé et rayé.

Paramétrage des colonnes

Ce tableau permet à l'utilisateur de configurer les colonnes du tableau HTML de sortie. La colonne 'Contenu de colonne' doit être définie comme une valeur d'attribut. Ces valeurs apparaîtront dans les lignes de la colonne. Le champ "Nom de colonne" permet à l'utilisateur de spécifier un nom pour chaque colonne.

HTML personnalisé

Permet à l'utilisateur d'entrer un HTML personnalisé.

HTML personnalisé

Texte brut formaté en HTML qui sera inséré dans la page de sortie. L'utilisateur doit s'assurer que le texte est du HTML valide.

Éditer les paramètres des Transformers

À l'aide d'un ensemble d'options de menu, les paramètres du Transformer peuvent être attribués en faisant référence à d'autres éléments de traitement. Des fonctions plus avancées, telles qu'un éditeur avancé et un éditeur arithmétique, sont également disponibles dans certains Transformers. Pour accéder à un menu de ces options, cliquez sur à côté du paramètre applicable. Pour plus d'informations, voir Options de menus et paramètres de Transformer.

Définir les valeurs

Il existe plusieurs façons de définir une valeur à utiliser dans un Transformer. La plus simple est de simplement taper une valeur ou une chaîne de caractères, qui peut inclure des fonctions de différents types comme des références d'attributs, des fonctions mathématiques et de chaînes de caractères, et des paramètres de traitement. Il existe un certain nombre d'outils et de raccourcis qui peuvent aider à construire des valeurs, généralement disponibles dans le menu contextuel déroulant adjacent au champ de valeur.

Utilisation de l'éditeur de texte

L'éditeur de texte fournit un moyen efficace de construire des chaînes de textes (dont les expressions régulières) à partir de données source diverses, telles que des attributs, des paramètres et des constantes, et le résultat est directement utilisé dans le paramètre.

Editeur de texte

Utilisation de l'éditeur arithmétique

L'éditeur arithmétique fournit un moyen simple de construire des expressions mathématiques à partir de plusieurs données source, telles que des attributs et des fonctions, et le résultat est directement utilisé dans un paramètre.

Éditeur arithmétique

Valeur conditionnelle

Définit des valeurs selon un ou plusieurs tests.

Fenêtre de définition de conditions

Contenu

Les expressions et chaînes de caractères peuvent inclure des fonctions, caractères, paramètres et plus.

Lors du paramétrage des valeurs - qu'elles soient entrées directement dans un paramètre ou construites en utilisant l'un des éditeurs - les chaînes de caractères et les expressions contenant des fonctions Chaîne de caractères, Math, Date et heure ou Entité FME auront ces fonctions évaluées. Par conséquent, les noms de ces fonctions (sous la forme @<nom_de_fonction>) ne doivent pas être utilisés comme valeurs littérales de chaîne de caractères.

Fonctions chaînes de caractères

Ces fonctions manipulent les chaînes de caractères.

Caractères spéciaux

 Un ensemble de caractères de contrôle est disponible dans l'éditeur de texte.

Fonctions mathématiques

Plusieurs fonctions sont disponibles dans les deux éditeurs.
Fonctions Date/heure Les fonctions de dates et heures sont disponibles dans l'Editeur texte.

Opérateurs mathématiques

Ces opérateur sont disponibles dans l'éditeur arithmétique.

Fonctions d'entités

Elles retournent des valeurs spécifiques aux entités.

Paramètres FME

Les paramètres FME et spécifiques au traitement peuvent être utilisés.
Créer et modifier un paramètre publié Créer ses propres paramètres éditables.

Options - Tables

Les Transformers avec des paramètres de style table possèdent des outils additionnels pour remplir et manipuler des valeurs.

Réordonner

Activé une fois que vous avez cliqué sur un élément de ligne. Les choix comprennent :

  • Ajouter une ligne
  • Supprimer une ligne
  • Déplacer la ligne en cours au dessus
  • Déplacer la ligne en cours en dessous
  • Déplacer la ligne en cours en haut de liste
  • Déplacer la ligne en cours en bas de liste

Couper, Copier et Coller

Activé une fois que vous avez cliqué sur un élément de ligne. Les choix comprennent :

  • Couper une ligne - supprime et copie dans le presse-papiers.
  • Copie une ligne dans le presse-papiers.
  • Colle une ligne depuis le presse-papiers.

Copier, copier et coller peuvent être utilisés au sein d'un Transformer ou entre Transfromers.

Filtre

Commencez à taper une chaîne de caractères, et la matrice n'affichera que les lignes correspondant à ces caractères. Recherche dans toutes les colonnes. Cela n'affecte que l'affichage des attributs dans le Transformer - cela ne change pas les attributs qui sont sortis.

Importer

Le bouton d'import remplit la table avec un jeu de nouveaux attributs lus depuis un jeu de données. L'application spécifique varie selon les Transformers.

Réinitialiser/Rafraîchir

Réinitialise la table à son état initial, et peut fournir des options additionnelles pour supprimer des entrées invalides. Le comportement varie d'un Transformer à l'autre.

Note : Tous les outils ne sont pas disponibles dans tous les Transformers.

FME Community

FME Community est l'endroit où trouver des démos, des tutoriaux, des articles, des FAQ et bien plus encore. Obtenez des réponses à vos questions, apprenez des autres utilisateurs et suggérez, votez et commentez de nouvelles entités.

Voir tous les résultats à propos de ce Transformer sur FME Community.