Rendering in formato HTML (Generatore report 2.0)

L'estensione per il rendering HTML genera report 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.

Per i report visualizzati in un browser, inclusi quelli eseguiti in Gestione report, viene utilizzata l'estensione per il rendering HTML per impostazione predefinita. L'estensione per il rendering HTML può generare frammenti HTML o documenti HTML completi. Se viene generato un frammento HTML, i tag HEAD, HTML e BODY del documento HTML vengono rimossi. Viene eseguito il rendering solo del contenuto del tag BODY. Questa funzionalità è particolarmente utile se si desidera incorporare il frammento HTML nel codice HTML prodotto da un'altra applicazione.

Nota sulla protezioneNota sulla protezione

Quando si definisce un parametro di tipo String all'interno del report, viene visualizzata una casella di testo che può accettare qualsiasi valore. Se un parametro di report non è associato a un parametro di query e i valori del parametro sono inclusi nel report, un utente del report può digitare la sintassi delle espressioni, lo script o un URL nel valore del parametro ed eseguire il rendering del report in HTML. Se il report viene in seguito visualizzato da un altro utente che fa clic sul contenuto dei parametri di cui è stato eseguito il rendering, è possibile che venga inavvertitamente eseguito il collegamento o lo script dannoso.

Per ridurre il rischio di eseguire inavvertitamente script dannosi, aprire solo i report sottoposti a rendering provenienti da fonti attendibili. Per ulteriori informazioni su come proteggere i report, vedere "Protezione di report e risorse" nella documentazione di Reporting Services nella documentazione online di SQL Server.

Per ulteriori informazioni sui tipi di browser e sul rendering dei report, vedere "Supporto browser in Reporting Services" nella documentazione relativa a Reporting Services inclusa nella documentazione in linea di SQL Server e Esportazione di report (Generatore report 2.0).

Rendering in formato MHTML

L'estensione per il rendering HTML può inoltre eseguire il 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. La casella di testo contiene ad esempio una proprietà denominata WritingMode 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 è disponibile 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. Di seguito è riportata 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 fa clic sull'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.

Segnalibri

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 facendo clic sui collegamenti a segnalibro. Quando si fa clic su un collegamento a un segnalibro, il report passa alla prima occorrenza dell'etichetta del segnalibro di destinazione. Se possibile, il contenuto della finestra del browser viene fatto scorrere in modo che il collegamento sia visualizzato all'inizio della finestra. Per contrassegnare le destinazioni dei segnalibri, vengono utilizzati 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 è stato definito l'ordinamento dell'utente, viene eseguito il rendering del codice JavaScript che provoca un postback al server quando si fa clic sull'icona di ordinamento.

Collegamenti ipertestuali e collegamenti drill-through

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

Cerca

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.

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 ulteriori informazioni, vedere Reporting Services Device Information Settings.