Rendu au format HTML (Générateur de rapports)

  • Article

L’extension de rendu HTML effectue le rendu d’un rapport paginé au format HTML. Elle peut également produire des pages HTML entièrement formées ou des fragment HTML à incorporer dans d'autres pages HTML. La sortie HTML est générée avec l'encodage UTF-8.

L’extension de rendu HTML est l’extension de rendu par défaut pour les rapports qui sont affichés dans un navigateur, notamment lors d’une exécution dans le portail web SQL Server 2016 (13.x) Reporting Services ou versions ultérieures (SSRS) . L'extension de rendu HTML peut rendre un document HTML complet ou un fragment. Dans le cas d’un fragment HTML, les balises HEAD, HTMLet BODY du document HTML sont supprimées. Seul le contenu de la balise BODY est affiché. Ce résultat est utile pour incorporer le code HTML à celui généré par une autre application.

Dans certains scénarios, les paramètres de rapport peuvent être utilisés pour lancer des attaques par injection de script lors du rendu de rapports en HTML. Pour plus d’informations sur la sécurisation des rapports, consultez Sécuriser les rapports et les ressources.

Pour plus d’informations sur les navigateurs, consultez Prise en charge des navigateurs pour Reporting Services.

Notes

Il est possible de créer et de modifier des fichiers de définition de rapports (.rdl) paginés dans le Générateur de rapports Microsoft, dans Power BI Report Builder et dans le Concepteur de rapports de SQL Server Data Tools.

Rendu au format MHTML

L'extension de rendu HTML peut également rendre des rapports au format MHTML (MIME Encapsulation of Aggregate HTML Documents). MHTML étend HTML pour intégrer des objets encodés, comme les images, dans le document HTML. Avec l'extension de rendu MHTML, vous pouvez incorporer dans un fichier unique des ressources telles que des images, des documents ou d'autres fichiers binaires en tant que structures MIME dans le rapport HTML. L'incorporation de rapports MHTML dans des messages électroniques se révèle également utile, car toutes les ressources sont incluses dans le rapport. Bien que ce soit en fait l’extension de rendu HTML qui assure le rendu MHTML, cette fonctionnalité peut également être appelée extension de rendu MHTML.

Prise en charge des navigateurs

Cette extension de rendu prend en charge les versions de navigateur suivantes :

  • Internet Explorer 5.5 et versions ultérieures

  • Firefox 1.5 et versions ultérieures

  • Safari 3.0 et versions ultérieures

En raison des spécificités des navigateurs, le rapport rendu peut varier légèrement d'un navigateur à l'autre. Par exemple, la zone de texte contient une propriété nommée WritingMode. Cette propriété n’est pas prise en charge dans Firefox.

Règles de rendu spécifiques à HTML

Les règles spécifiques à HTML suivantes s'appliquent lors du rendu :

  • Le convertisseur génère une structure de table HTML destinée à contenir tous les éléments de chaque collection ReportItems, s’il en existe plusieurs.

  • Chaque élément dans la structure de table occupe une cellule unique.

  • Les cellules vides sont réduites autant que possible pour réduire la taille de la table HTML.

  • Une ligne de cellules vides est ajoutée sur le bord supérieur et une autre colonne sur le bord gauche pour améliorer la vitesse à laquelle les navigateurs peuvent rendre la table.

  • Des largeurs et hauteurs fixes sont attribuées aux lignes ou colonnes de la table qui ne contiennent aucun élément, seulement des espaces entre les éléments.

  • Toutes les autres lignes et colonnes peuvent s'agrandir selon la taille de chaque élément de rapport.

  • Toutes les coordonnées et tailles d'élément de rapport sont converties en millimètres. Toutes les autres tailles, notamment les propriétés de style, conservent leurs unités d'origine. Les différences de taille et position inférieures à 0,2 mm sont traitées comme égales à 0 mm.

Interactivité

Certains éléments interactifs sont pris en charge au format HTML. La section ci-dessous fournit une description de comportements spécifiques.

Afficher et masquer

Un élément de rapport dont la visibilité peut être activée/désactivée est rendu par une image bascule +/- et est interactif. Lorsque l’utilisateur sélectionne l’élément, un rappel au serveur a lieu pour rendre à nouveau la sortie avec l’état d’affichage ou de masquage modifié.

Plan du document

Les étiquettes Explorateur de documents sont rendues et accessibles par navigation en utilisant l'Explorateur de documents dans le contrôle de visionneuse. Pour les en-têtes de région de données omis, les étiquettes sont rendues dans la première cellule enfant. En l’absence de cellule enfant, l’étiquette est rendue dans l’enfant qui précède.

Signets

Les liens de signet sont rendus et apparaissent sous la forme de liens hypertexte. Les cibles de signet sont rendues et accessibles par navigation en sélectionnant les liens de signet. Lorsqu’un lien de signet est sélectionné, le rapport passe à la première occurrence de l’étiquette de signet cible. Ensuite, lorsque cela est possible, le navigateur défile de manière à ce que le lien du signet se trouve en haut de la fenêtre. Des balises d’ancrage HTML (<a>) sont utilisées pour marquer les cibles de signet.

Tri interactif

Si un tri utilisateur est défini pour une zone de texte, l'extension de rendu HTML rend les icônes de tri dans la zone de texte à droite de son contenu. Si un rapport contient une zone de texte où le tri de l’utilisateur est défini, JavaScript est rendu. JavaScript provoque une publication sur le serveur lorsque l’image de tri est sélectionnée.

Les liens hypertexte et les liens d’extraction sont affichés sous forme de liens hypertexte dans les éléments de rapport à l’aide de balises d’ancrage HTML (<a>) placées autour de l’élément sur lequel ils sont définis.

La fonctionnalité de recherche permet aux utilisateurs de rechercher une chaîne de texte dans le rapport.

Des fonctionnalités supplémentaires de recherche sont fournies par le contrôle Web Forms ReportViewer.

Polices sur l’ordinateur client

Lorsqu'une police personnalisée est utilisée dans le rapport, l'ordinateur utilisé pour consulter le rapport (l'ordinateur client) doit avoir la police personnalisée installée pour que le rapport s'affiche correctement. Si la police n’est pas installée sur l’ordinateur client, le rapport affiche une police système par défaut au lieu de la police personnalisée.

Paramètres d'informations de périphérique

Vous pouvez modifier certains paramètres par défaut de ce convertisseur, notamment le mode de rendu, en modifiant les paramètres d'informations de périphérique. Pour plus d’informations, consultez Paramètres d’informations de périphérique HTML.

Contenu connexe