Rendering in HTML (Generatore di report)

  • Articolo

L'estensione per il rendering HTML esegue il rendering di un report impaginato in formato HTML. Può inoltre generare pagine HTML complete o frammenti di HTML da incorporare in altre pagine HTML. Tutto il codice HTML viene generato con la codifica UTF-8.

L'estensione per il rendering HTML è quella predefinita per i report visualizzati in un browser, anche se eseguiti nel portale Web di SQL Server 2016 (13.x) Reporting Services o versioni successive (SSRS). L'estensione per il rendering HTML può generare frammenti HTML o documenti HTML completi. Se viene generato un frammento HTML, i tag HEAD, HTMLe BODY del documento HTML vengono rimossi. Viene eseguito il rendering solo del contenuto del tag BODY . Questo risultato è particolarmente utile se si desidera incorporare il frammento HTML nel codice HTML prodotto da un'altra applicazione.

In alcuni scenari i parametri del report possono essere utilizzati per avviare attacchi intrusivi negli script durante il rendering di report in HTML. Per altre informazioni sulla sicurezza dei report, vedere Garantire la sicurezza di report e risorse.

Per altre informazioni sui browser, vedere Supporto browser per Reporting Services.

Nota

È possibile creare e modificare file di definizioni di report impaginati (con estensione rdl) in Generatore report di Microsoft, Power BI Report Builder e Progettazione report di SQL Server Data Tools.

Rendering in formato MHTML

L'estensione per il rendering HTML può inoltre consentire l'esecuzione del rendering dei report in formato MHTML (MIME Encapsulation of Aggregate HTML Documents). MHTML estende HTML per incorporare oggetti codificati, ad esempio immagini, in documenti HTML. Tale estensione consente di incorporare risorse, quali immagini, documenti o altri file binari, come strutture MIME nel codice HTML del report, in un singolo file. I report MHTML sono utili anche per l'incorporamento di elementi in messaggi di posta elettronica, in quanto tutte le risorse vengono incluse nel report. Sebbene il rendering MHTML venga eseguito dall'estensione per il rendering HTML, talvolta questa funzionalità viene denominata anche estensione per il rendering MHTML.

Supporto browser

Questa estensione per il rendering supporta le seguenti versioni di browser:

  • Internet Explorer 5.5 e versioni successive

  • Firefox 1.5 e versioni successive

  • Safari 3.0 e versioni successive

In considerazione delle caratteristiche dei diversi browser, è possibile che il report visualizzabile sia leggermente diverso a seconda del browser. Ad esempio, la casella di testo contiene una proprietà chiamata WritingMode. Questa proprietà non è supportata in Firefox.

Regole di rendering specifiche di HTML

Durante il rendering vengono applicate le seguenti regole specifiche di HTML:

  • Il renderer compila una struttura di tabella HTML in cui inserire tutti gli elementi di ogni raccolta ReportItems, se ne esiste più di una.

  • Ogni elemento all'interno della struttura della tabella occupa una singola cella.

  • Le celle vuote vengono compresse il più possibile per ridurre le dimensioni del codice HTML.

  • Al bordo superiore viene aggiunta una riga di celle vuote, mentre a quello sinistro viene aggiunta un'altra colonna per incrementare la velocità di rendering della tabella nei browser.

  • Alle righe o alle colonne della tabella che non contengono elementi, ma solo spazi tra elementi, vengono assegnate larghezze e altezze fisse.

  • Le dimensioni di tutte le altre righe e colonne possono aumentare in base alle dimensioni dei singoli elementi del report.

  • Tutte le coordinate e le dimensioni degli elementi del report vengono convertite in millimetri. Tutte le altre dimensioni, incluse le proprietà dello stile, mantengono le unità di misura originali. Le differenze di dimensioni e posizioni inferiori a 0,2 mm vengono considerate come 0 mm.

Interattività

In HTML sono supportati alcuni elementi interattivi. La sezione seguente è una descrizione di comportamenti specifici.

Elementi visualizzati e nascosti

Il rendering di un elemento del report la cui visibilità può essere attivata o disattivata prevede l'inclusione di un'immagine dell'elemento Toggle (+/-). Tale elemento è inoltre selezionabile con il mouse. Quando si seleziona l'elemento, viene effettuata una nuova chiamata al server per eseguire il rendering dell'output con lo stato di visualizzazione modificato.

Mappa documento

È possibile eseguire il rendering di etichette della mappa documento e passare a esse utilizzando la mappa documento nel controllo visualizzatore. Per le intestazioni omesse dell'area dati, il rendering delle etichette viene eseguito sulla prima cella figlio. Se non è presente alcuna cella figlio, il rendering dell'etichetta viene eseguito sull'elemento figlio che la precede.

Bookmarks

I collegamenti a segnalibro vengono sottoposti a rendering e visualizzati come collegamenti ipertestuali. È possibile eseguire il rendering di destinazioni dei segnalibri e passare a esse selezionando i collegamenti a segnalibro. Quando viene selezionato un collegamento a un segnalibro, il report passa alla prima occorrenza dell'etichetta del segnalibro di destinazione. Quindi, quando possibile, il browser viene scorso in modo che il collegamento segnalibro si trovi nella parte superiore della finestra. Per contrassegnare le destinazioni dei segnalibri, vengono usati i tag di ancoraggio HTML (<a>).

Ordinamento interattivo

Se per una casella di testo è stato definito l'ordinamento dell'utente, l'estensione per il rendering HTML esegue il rendering delle icone di ordinamento nella casella di testo a destra del relativo contenuto. Se un report contiene una casella di testo in cui è definito l'ordinamento dell'utente, viene eseguito il rendering di JavaScript. JavaScript genera un postback nel server quando l'immagine di ordinamento è selezionata.

Il rendering di collegamenti ipertestuali e collegamenti drill-through restituisce collegamenti ipertestuali in elementi del report racchiudendo l'elemento in cui sono definiti tra tag di ancoraggio HTML (<a>).

La caratteristica Cerca consente agli utenti di cercare una stringa di testo all'interno del report.

Ulteriori funzionalità di ricerca vengono fornite dal controllo Web Form ReportViewer.

Tipi di carattere nel computer client

Quando nel report è usato un tipo di carattere personalizzato, questo tipo di carattere deve essere installato nel computer usato per visualizzare il report, ovvero il computer client, per garantire una corretta visualizzazione del report. Se il tipo di carattere non è installato nel computer client, nel report viene visualizzato un tipo di carattere predefinito di sistema invece di quello personalizzato.

Impostazioni relative alle informazioni sul dispositivo

Modificando le impostazioni relative alle informazioni sul dispositivo, è possibile modificare alcune impostazioni predefinite per questo renderer, tra cui la modalità di rendering. Per altre informazioni, vedere Impostazioni relative alle informazioni sul dispositivo HTML.

Contenuto correlato