Condividi tramite

  • Articolo

Creazione del progetto server di report e del report AdventureWorks2008R2_Base (SSRS)

In Business Intelligence Development Studio è possibile creare più origini dati condivise, set di dati condivisi e report, nonché distribuirli tutti in un passaggio. In questa esercitazione verranno creati un progetto e una soluzione server di report, nonché un report di base. Per ognuno dei report di esempio AdventureWorks, verrà fatta una copia del report di base come passaggio iniziale per la compilazione di ogni singolo report.

Lezioni dell'esercitazione

In questa esercitazione verranno illustrate le operazioni seguenti:

  • Creare e configurare un progetto server di report

  • Aggiungere un report vuoto al progetto.

  • Aggiungere un'origine dati condivisa al progetto e un riferimento all'origine dati condivisa al report.

  • Aggiungere un parametro di report booleano.

  • Aggiungere e configurare l'intestazione di pagina con il logo e il nome del report.

  • Aggiungere e configurare il piè di pagina con la descrizione del report.

  • Impostare la visibilità condizionale per consentire a un utente di mostrare o nascondere il contenuto in base alle esigenze in due modi: in base a un elemento Toggle della casella di testo o a un parametro booleano.

  • Aggiungere il testo della descrizione con visibilità condizionale che può essere impostata dall'utente in base al parametro booleano.

  • Aggiungere il testo della descrizione alla proprietà Description del report. La descrizione del report viene visualizzata nel server di report.

  • Aggiungere il testo dello scenario con visibilità condizionale che può essere attivata/disattivata dall'utente. Il testo dello scenario è un testo personalizzato che descrive le domande a cui il report deve rispondere.

  • Impostare le dimensioni della pagina per esportare il file in formato pdf.

  • Visualizzare l'anteprima del report ed eseguirne una verifica.

  • Distribuire e verificare il report.

Il tempo stimato per completare l'esercitazione è di 15 minuti.

Requisiti

Per l'elenco di requisiti, vedere Prerequisiti per i report di esempio di AdventureWorks 2008R2 (SSRS).

Suggerimenti

Per un elenco di suggerimenti generali, vedere Suggerimenti relativi alla progettazione di report (Generatore report 3.0 e SSRS).

Impostare le proprietà del progetto

Per creare una soluzione e impostare le proprietà del progetto

  1. Avviare BI Development Studio.

    Nota

    Se il Controllo account utente è supportato e abilitato nel sistema operativo, per distribuire i report in un server di report, è necessario eseguire BI Development Studio con privilegi elevati. Per ulteriori informazioni, vedere Prerequisiti per i report di esempio di AdventureWorks 2008R2 (SSRS).

  2. Creare un nuovo progetto server di report denominato Report di esempio AdventureWorks 2008R2.

    Nota

    Se i report di esempio AdventureWorks 2008R2 sono stati installati da CodePlex, utilizzare un nome univoco per il progetto server di report in modo da evitare conflitti di denominazione.

  3. Aprire le pagine delle proprietà per il progetto. Effettuare le operazioni seguenti:

    1. Impostare TargetDatasetFolder su AdventureWorks 2008R2/Datasets.

    2. Impostare TargetDataSourceFolder su AdventureWorks 2008R2/DataSources.

    3. Impostare TargetReportFolder su AdventureWorks 2008R2.

    4. Impostare TargetReportPartFolder su AdventureWorks 2008R2/ReportParts.

    5. Impostare TargetServerURL sul server di report o sul sito di SharePoint, ad esempio http://<nome server>/reportserver.

    6. Verificare che TargetServerVersion sia SQL Server 2008 R2.

  4. Accettare gli altri valori predefiniti e creare il progetto.

Aggiungere un report vuoto

Per aggiungere un report vuoto

  1. In Esplora soluzioni fare clic con il pulsante destro del mouse sulla cartella Report, scegliere Aggiungi, quindi fare clic su Nuovo elemento.

  2. In Modelli fare clic su Report.

  3. Impostare Nome su AdventureWorks2008R2_Base.rdl.

  4. Fare clic su Aggiungi.

Creare un'origine dati condivisa nel progetto e nel report

Per creare un'origine dati condivisa per i dati di AdventureWorks

  1. In Esplora soluzioni creare un'origine dati condivisa del progetto per il database AdventureWorks.

    1. Impostare Nome su AdventureWorks2008R2.

    2. Compilare una stringa di collegamento simile alla seguente:

      Data Source=(servername); Initial Catalog=AdventureWorks2008R2

    3. Specificare le credenziali.

  2. Al riquadro Dati report aggiungere un riferimento all'origine dati del report che punta all'origine dati del progetto.

  3. Modificare il valore di Nome in AdventureWorks2008R2.

  4. Selezionare Usa riferimento a origine dati condivisa e fare clic su AdventureWorks2008R2.

Creare parametri di report

Un parametro di report viene creato automaticamente per ogni variabile di query del set di dati, parametro di input della stored procedure o parametro del set di dati condiviso. Un parametro può anche essere creato manualmente.

Nel report di base verrà creato un parametro booleano in modo che un utente possa mostrare o nascondere le informazioni facoltative nel report, ad esempio la descrizione del report o i risultati dell'espressione.

Per aggiungere un parametro booleano per la visibilità condizionale

  1. Dal riquadro Dati report aggiungere un parametro denominato ShowAll.

  2. Nella pagina Generale impostare Messaggio di richiesta su Mostrare tutte le informazioni?

  3. Impostare Tipo di dati su Boolean.

  4. Nella pagina Valori predefiniti selezionare Imposta valori.

  5. Aggiungere un valore e impostarlo su false.

Dopo la prima pubblicazione dei parametri in un server di report o in un sito di SharePoint, non è possibile sovrascrivere le proprietà dei parametri da BI Development Studio. In base alle caratteristiche di progettazione, i parametri pubblicati vengono gestiti solo nel server di report. Per modificare un valore della proprietà dopo la relativa pubblicazione, è necessario aggiornare direttamente la proprietà nel server di report o eliminare il report e distribuirlo nuovamente.

Aggiungere l'intestazione di pagina

Per aggiungere l'intestazione di pagina, il logo e il nome del report

  1. Aggiungere un'intestazione di pagina dal menu Report.

  2. Al riquadro Dati report aggiungere un'immagine. Passare alla cartella del progetto e selezionare AdventureWorksLogo.jpg.

  3. Trascinare l'immagine nell'intestazione di pagina.

  4. Nella finestra di dialogo Proprietà immagine impostare Nome su Logo.

  5. Verificare che l'origine dell'immagine sia Incorporata.

  6. Dopo aver aggiunto l'immagine, trascinare i relativi handle per espandere le dimensioni fino a circa 2,5 pollici a intervalli di 0,5 pollici.

  7. Nel riquadro Dati report espandere Campi predefiniti e trascinare Nome report sul lato destro dell'intestazione di pagina. Formattare in base alle esigenze.

  8. Trascinare la parte inferiore dell'intestazione di pagina verso l'alto per rimuovere lo spazio vuoto aggiuntivo.

Aggiungere il piè di pagina

È possibile aggiungere una descrizione al report nel piè di pagina e nascondere il contenuto in modo condizionale. L'utente può decidere se visualizzare le informazioni. Per visualizzare una descrizione nel server di report, aggiungere le informazioni alla proprietà Description per il report.

Per aggiungere il piè di pagina e una descrizione nascosta per impostazione predefinita

  1. Aggiungere un piè di pagina.

  2. In Proprietà piè di pagina deselezionare l'opzione Stampa sulla prima pagina.

  3. Aggiungere una casella di testo con il testo seguente: <Sostituire con descrizione>.

  4. Impostare il valore Nome della casella di testo su tbDescription.

  5. Espandere le dimensioni della casella di testo per riempire il piè di pagina.

  6. Selezionare la casella di testo.

    Nota

    Il primo clic in una casella di testo attiva la modalità di modifica. Per selezionare la casella di testo dopo l'attivazione della modalità di modifica, premere ESC. Per ulteriori informazioni, vedere Suggerimenti relativi alla progettazione di report (Generatore report 3.0 e SSRS).

  7. Nella pagina Visibilità in Proprietà casella di testo selezionare Mostra o nascondi in base a un'espressione e aggiungere il testo seguente: =NOT Parameters!ShowAll.Value.

Utilizzare l'operatore NOT affinché per la visibilità venga impostata la proprietà Hidden nella casella di testo. Per l'utente, il parametro @ShowAll è definito come un'azione positiva. Quando @ShowAll è true, il testo non è nascosto.

Aggiungere una descrizione

Per aggiungere la descrizione come proprietà del report

  1. Fare clic sullo sfondo del report per visualizzare Proprietà report nel riquadro Proprietà.

  2. Individuare Description e copiare e incollare il testo della descrizione dal passaggio precedente.

Nota

Il numero massimo di caratteri in una descrizione è 512.

Dopo la prima pubblicazione del testo della descrizione, non è possibile sovrascrivere la proprietà Description da BI Development Studio. Per modificare un valore della proprietà dopo la relativa pubblicazione, è necessario aggiornare direttamente la proprietà nel server di report o nel sito di SharePoint oppure eliminare il report e distribuirlo nuovamente.

Aggiungere il testo dello scenario

Nel testo dello scenario viene descritto lo scopo del report. In alcuni report, questo testo può fornire all'utente istruzioni relative alle caratteristiche del report. Per impostazione predefinita, il testo dello scenario è nascosto, tuttavia l'utente può attivarlo o disattivarlo.

Per aggiungere un elemento Toggle per il testo con visibilità condizionale

  1. Nella parte superiore a sinistra del report sotto l'intestazione di pagina aggiungere una casella di testo con il testo seguente:

    Fare clic su + per visualizzare la storia dello scenario.

  2. Impostare il Nome della casella di testo su tbToggle.

  3. Scegliere uno stile per il carattere in base alle esigenze.

Per mostrare o nascondere una casella di testo in base a un elemento Toggle

  1. Nella parte superiore a destra del report sotto l'intestazione di pagina aggiungere una casella di testo.

  2. Impostare il Nome della casella di testo su tbScenario.

  3. Nella casella di testo immettere il testo seguente: <Sostituire con la descrizione dello scenario di questo report>.

  4. In Quando il report viene eseguito inizialmente della pagina Visibilità in Proprietà casella di testo selezionare Nascondi.

  5. Selezionare La visualizzazione può essere attivata/disattivata tramite questo elemento del report.

  6. Nell'elenco a discesa selezionare tbToggle.

Nelle lezioni successive, verrà creato il testo dello scenario per ogni report e verranno aggiunti i collegamenti da parole specifiche del testo ai segnalibri negli elementi del report correlati.

Impostare le dimensioni della pagina per esportare nei file in formato pdf

La progettazione del report non è WYSIWIG. Il report sottoposto a rendering non viene visualizzato fino alla relativa anteprima o esecuzione. In base alle caratteristiche di progettazione, ogni area dati si espanderà automaticamente per contenere tutti i dati del set di dati correlato. Lo spazio vuoto nell'area di progettazione del report viene conservato.

Se si intende stampare un report o esportarlo in un formato compatibile con la stampa, per evitare di avere più pagine orizzontali, è necessario impostare in modo esplicito la larghezza della pagina ed eliminare lo spazio vuoto nel report.

Per impostare le dimensioni della pagina per i file pdf o altri formati di stampa

  1. Rimuovere o ridurre lo spazio vuoto aggiuntivo nel report avvicinando gli elementi del report e trascinando i bordi del report accanto a quelli dei relativi elementi.

  2. Fare clic con il pulsante destro del mouse sullo sfondo dell'area di progettazione del report, quindi scegliere Righello.

  3. Aprire Proprietà report dal menu Report.

  4. Nella pagina Imposta pagina effettuare le operazioni seguenti:

    1. Impostare Larghezza su 7,9375 pollici.

    2. Verificare che i margini Destro e Sinistro non siano maggiori di 1 pollice.

  5. Utilizzare il righello per verificare che la pagina sia ora minore di 7 pollici.

Visualizzare l'anteprima del report

Per visualizzare l'anteprima e verificare il report

  1. Visualizzare l'anteprima del report.

  2. Verificare che il report venga eseguito automaticamente.

  3. Nella barra degli strumenti del visualizzatore di report verificare che per ShowAll siano disponibili i pulsanti di opzione True e False. Per impostazione predefinita, il valore è False.

  4. Nell'intestazione di pagina vengono visualizzati il logo e il nome del report.

  5. Viene visualizzata una casella di testo con un elemento Toggle. Quando si fa clic sull'elemento Toggle, viene visualizzato il testo dello scenario.

  6. Quando si imposta ShowAll su True e si esegue il report, la descrizione viene visualizzata nel piè di pagina.

Distribuire il report

Per distribuire il report

  1. In Esplora soluzioni fare clic con il pulsante destro del mouse sul progetto, quindi scegliere Distribuisci. Controllare la presenza di errori nella riga di stato di BI Development Studio o nel riquadro di output.

    Nota

    Poiché il report dipende da un'origine dati condivisa, alla prima distribuzione del report è necessario distribuire l'intero progetto. Nelle esercitazioni successive, è possibile distribuire individualmente i report.

  2. In un browser, passare al server di report o al sito di SharePoint, ad esempio https://localhost/reports o http://SharePointsite/subsite/reports.

  3. Verificare che l'origine dati condivisa e il report vengano visualizzati nelle cartelle specificate.

  4. Verificare che venga visualizzata la descrizione per il report.

  5. Modificare l'origine dati condivisa in modo da utilizzare le credenziali immesse dal server di report. Nel report di base non si recuperano dati da AdventureWorks, pertanto il report viene eseguito senza errori. Le esercitazioni rimanenti richiedono che le credenziali per l'origine dati siano immesse dal server di report o dal sito di SharePoint.

  6. Verificare che il report venga eseguito.

Passaggi successivi

Sono stati creati un progetto di report e un report di base. Ora è possibile creare un report di esempio. Per ulteriori informazioni, vedere Esercitazioni: Creazione dei report di esempio di AdventureWorks 2008R2 (SSRS).