Personalizzare la web part Visualizzatore di report
Si applica a: SQL Server 2016 (13.x) Reporting Services e versioni successive Server di report di Power BI SharePoint 2013 e versioni successive ❌ SharePoint Online
Per contenuti relativi a versioni precedenti di SQL Server Reporting Services (SSRS), si veda Che cos’è SQL Server Reporting Services?
È possibile usare la web part Visualizzatore report per visualizzare report eseguiti in un server di report configurato per l'integrazione con SharePoint. I report che è possibile visualizzare includo file di definizione dei report, con estensione rdl, e report di Generatore report. I report verranno aperti automaticamente in una nuova pagina della web part Visualizzatore report. Se si desidera che un determinato report sia sempre visibile nella pagina, aggiungere una web part Visualizzatore report a un sito o a una pagina Web esistente.
Nota
Anche se hanno lo stesso nome, la Web part Visualizzatore di report installata tramite il componente aggiuntivo Reporting Services è diversa dalla Web part Visualizzatore di report inclusa nel file RSWebParts.cab. Le istruzioni contenute in questo argomento sono specifiche per la Web part Visualizzatore di report installata tramite il componente aggiuntivo Reporting Services.
È possibile personalizzare la web part Visualizzatore report nei modi seguenti:
Modificare l'aspetto della web part impostandone le proprietà.
Scegliere le caratteristiche di report interattive disponibili sull'apposita barra degli strumenti.
Specificare quali aree di visualizzazione rendere disponibili. La web part Visualizzatore report dispone di un'area di visualizzazione dei report, un'area Parametri e un'area Credenziali.
Non è possibile estendere la web part Visualizzatore report per supportare altri tipi di file, né sostituire la barra degli strumenti dei report con una barra personalizzata o aggiungere nuove funzionalità. Per personalizzare le funzionalità standard è necessario creare una web part personalizzata.
Impostazione delle proprietà della web part
A una web part sono associate proprietà personalizzate per la configurazione di funzionalità specifiche. In genere le web part dispongono anche di proprietà comuni a tutte le web part.
Modificare le proprietà predefinite
La web part Visualizzatore report include proprietà predefinite ottimali per l'apertura di report su richiesta da una raccolta o una cartella. Per impostazione predefinita, tutti i controlli disponibili vengono visualizzati nella barra degli strumenti. Altezza e larghezza sono impostate per usare tutto lo spazio disponibile nella pagina Web. Per modificare le proprietà predefinite è possibile personalizzare la web part tramite Impostazioni sito.
Scegliere Impostazioni sito dal menu Azioni sito.
In raccolte selezionare web part.
Selezionare ReportViewer.dwp.
Aprire il riquadro degli strumenti e impostare le proprietà che si desidera utilizzare.
Personalizzare un Visualizzatore report incorporato in una pagina Web
È possibile impostare proprietà per adattare il Visualizzatore report alla pagina Web. Al visualizzatore possono essere applicati lo stesso stile e gli stessi colori della pagina che lo contiene. È possibile nascondere completamente o in parte la barra degli strumenti, la mappa documento e l'area dei parametri per sfruttare al massimo l'area di visualizzazione del report all'interno dello spazio assegnato. Per il report vengono sempre utilizzati gli stili definiti al momento della creazione. Non è concesso personalizzare l'aspetto del report dopo la sua pubblicazione in una raccolta di SharePoint.
Se si incorpora la web part Visualizzatore report in una pagina Web, è consigliabile impostare la proprietà URL report su un report specifico. In caso contrario, nel Visualizzatore report vengono visualizzate le istruzioni per il collegamento di un report. Non è possibile personalizzare o rimuovere le istruzioni.
Proprietà personalizzate della web part Visualizzatore report
Per l'impostazione delle proprietà personalizzate, si noti che alcune di esse vengono usate solo se la web part Visualizzatore report è incorporata in una pagina. Tra le proprietà personalizzabili ci sono il titolo, l'altezza, la larghezza, il tipo di colore e la zona. Altre proprietà, ad esempio le impostazioni relative alla barra degli strumenti e le impostazioni relative ai parametri, vengono utilizzate indipendentemente dal fatto che Visualizzatore report sia incorporato in una pagina o apra un report in modalità Pagina intera.
Le proprietà personalizzate della web part Visualizzatore report sono elencate di seguito.
Proprietà | Descrizione |
---|---|
Report | Percorso completo di un report presente nel sito di SharePoint corrente oppure in un sito disponibile nella stessa farm o applicazione Web. Se si desidera impostare proprietà aggiuntive, per ottenere risultati ottimali selezionare Applica dopo avere specificato l'URL del report. |
Destinazione collegamento ipertestuale | Codice HTML standard che specifica il frame di destinazione per la visualizzazione dei contenuti collegati nel documento corrente. Per i report che includono collegamenti ipertestuali a siti Web esterni, è possibile specificare se un documento di destinazione sostituisce il report esistente nella finestra corrente oppure viene aperto in una nuova finestra del browser. I valori validi includono _Top, _Blanke _Self. _Top usa la finestra corrente, _Blank carica il documento in una nuova finestra del browser e _Self apre il documento nel frame corrente. Anche se nel linguaggio HTML _Parent è un valore valido per l'attributo Target, evitare l'uso di questo valore per una web part Visualizzatore report incorporata in una pagina. |
Titolo web part generata automaticamente | Titolo generato che include il nome della web part Visualizzatore report seguito dal nome del report, separati da un trattino. Se il report non ha titolo, verrà utilizzato il nome di file del report. Il titolo è visibile quando si aggiunge una web part a una pagina. Se questa casella di controllo è selezionata, il titolo viene generato a ogni aggiornamento della pagina. |
Collegamento dettagli web part generata automaticamente | Collegamento ipertestuale generato automaticamente e visualizzato sopra la web part. È possibile selezionare collegamento per aprire il report in una nuova pagina, in modalità Pagina intera. |
Mostra voce di menu Generatore report | Visualizza o nasconde l'opzione del menu Azioni che consente di aprire Generatore report. |
Mostra voce di menu di sottoscrizione | Visualizza o nasconde l'opzione del menu Azioni che consente di creare una sottoscrizione per il report. |
Mostra voce di menu di stampa | Visualizza o nasconde l'opzione del menu Azioni che consente di stampare il report. |
Mostra voce di menu di esportazione | Visualizza o nasconde l'opzione del menu Azioni che consente di esportare il report. |
Mostra pulsante di aggiornamento | Visualizza o nasconde il pulsante di aggiornamento sulla barra degli strumenti. |
Mostra controlli per la navigazione tra le pagine | Visualizza o nasconde i pulsanti per la navigazione nel report sulla barra degli strumenti. Questa opzione consente di modificare la visibilità di tutti i controlli per la navigazione. |
Mostra pulsante Indietro | Visualizza o nasconde il pulsante Indietro sulla barra degli strumenti. |
Mostra controlli di ricerca | Visualizza o nasconde i controlli di ricerca sulla barra degli strumenti. I controlli di ricerca consentono a un utente di cercare testo nel report di cui è stato eseguito il rendering. Questa opzione consente di modificare la visibilità di tutti i controlli di ricerca. |
Mostra controllo zoom | Visualizza o nasconde il controllo zoom sulla barra degli strumenti. |
Mostra pulsante feed ATOM | Visualizza o nasconde il pulsante del feed ATOM sulla barra degli strumenti. |
Posizione barra degli strumenti | Determina la posizione della barra degli strumenti all'interno del visualizzatore di report. I valori validi includono Top e Bottom. |
Area dei messaggi di richiesta | I valori validi includono Visualizzato, Compressoe Nascosto. Visualizzato consente di visualizzare l'area Parametri per i report che includono valori con parametri e richiedono l'input dell'utente prima dell'esecuzione. Usare Hidden se tutti i parametri del report sono specificati e non si vuole visualizzare l'area relativa. |
Larghezza area parametri | È possibile specificare l'unità di misura e il valore. Il valore predefinito è 200 pixel. L'unico requisito per questa proprietà è che il valore sia maggiore di zero. |
Mappa documento | Controllo per la navigazione del report che viene definito nel report e consente di accedere con un clic a sezioni specifiche del report. È disponibile nei report HTML. La mappa documento è visualizzata in un'area comprimibile accanto all'area di visualizzazione del report. I valori validi includono Visualizzato, Compressoe Nascosto. Se per un determinato report è definita una mappa documento, quest'area viene espansa per impostazione predefinita, a meno che non sia contrassegnata come nascosta o compressa nelle proprietà della web part. Se la mappa documento è compressa, sarà possibile selezionare la freccia per espanderla. |
Larghezza area mappa documento | È possibile specificare l'unità di misura e il valore. Il valore predefinito è 200 pixel. L'unico requisito per questa proprietà è che il valore sia maggiore di zero. |
Carica parametri | Consente di recuperare le proprietà dei parametri per il report. Non tutti i report utilizzano parametri. Se il report non dispone di parametri, non viene restituito alcun valore. Se si impostano le proprietà per un report appena caricato, è possibile che venga visualizzato un errore per segnalare che la connessione all'origine dei dati è stata eliminata. Se si verifica questo errore, reimpostare la connessione e quindi completare l'impostazione delle proprietà dei parametri, dopo aver specificato la connessione. Per altre informazioni sull'impostazione della connessione, vedere Creare e gestire origini dati condivise (Reporting Services in modalità integrata SharePoint). Per ottenere risultati ottimali, selezionare Applica prima di fare clic su Carica parametri. Dopo il caricamento delle proprietà dei parametri, è possibile impostarle come avviene normalmente nella pagina delle proprietà dei parametri del report. Per altre informazioni sull'impostazione dei parametri, vedere Impostazione dei parametri per un report pubblicato (Reporting Services in modalità integrata SharePoint). |
Personalizzare una barra degli strumenti
La barra degli strumenti è visualizzata sotto il titolo e si estende nella parte superiore del report. Include il menu Azioni , oltre a controlli per la navigazione dei report impaginati, l'aggiornamento e lo zoom. È disponibile anche un controllo mappa documento per i report che dispongono di una mappa documento. Nel menu Azioni sono disponibili comandi per l'esportazione del report, la ricerca di testo o numeri nel report, la stampa del report e l'apertura del report in Generatore report.
Non è possibile aggiungere nuovi comandi al menu Azioni, ma è possibile personalizzare il menu modificando le opzioni visibili agli utenti. Per modificare la visibilità dei pulsanti e dei controlli della barra degli strumenti, impostare le opzioni della sezione Visibilità degli elementi della barra degli strumenti della web part. È inoltre possibile rimuovere il comando Stampa o formati di esportazione specifici, rendendo non disponibili tali caratteristiche sul server di report. I controlli per la navigazione tra le pagine sono disponibili solo per i report che includono interruzioni di pagina. In caso contrario il report è costituito da una singola pagina di lunghezza variabile. Il pulsante Aggiorna consente di rielaborare il report usando i parametri correnti. Per visualizzare tutti i controlli su una riga, impostare la larghezza complessiva della web part su un valore non inferiore a 400 pixel.
Personalizzazione dell'area di visualizzazione
L'area di visualizzazione viene utilizzata per la visualizzazione dei report L’area di visualizzazione rapporti è condivisa con le aree Parametri e Credenziali, se vengono utilizzate. Se è necessario immettere credenziali, verrà visualizzata un'area di visualizzazione report vuota con accanto l'area Credenziali. Tale area viene chiusa dopo l'immissione delle credenziali e l'avvio del report. Il testo visualizzato per richiedere l'impostazione delle credenziali può essere personalizzato modificando le proprietà di connessione all'origine dei dati. Per altre informazioni, vedere Creare e gestire origini dati condivise (Reporting Services in modalità integrata SharePoint).
L'area Parametri contiene alcuni campi in cui è possibile immettere valori prima dell'esecuzione del report Questa viene utilizzata solo se la definizione del report include parametri. Se è visualizzata l'area Parametri o l'area Credenziali, le dimensioni dell'area di visualizzazione del report vengono modificate in modo da usare la larghezza rimanente della web part. È possibile personalizzare la larghezza dell'area Parametri impostando le proprietà della web part. È inoltre possibile specificare le etichette da visualizzare accanto ai singoli parametri della pagina. Per altre informazioni sulla modifica delle etichetta dei parametri, vedere Impostazione dei parametri per un report pubblicato (Reporting Services in modalità integrata SharePoint).