Condividi tramite

Lezione 6: Aggiunta di un sottoreport con parametri

  • Articolo

Data creazione: 17 luglio 2006

I sottoreport rappresentano un modo per incorporare report in un report principale. A differenza dei report drill-through che aprono un report distinto nella stessa finestra, i sottoreport vengono visualizzati come elementi di report incorporati nel report principale. Nonostante qualsiasi report possa essere un sottoreport, è in genere necessario formattare un report affinché possa essere utilizzato come sottoreport ed essere visualizzato in modo ottimale nel report principale.

In questa lezione il report ContactInformation verrà aggiunto come sottoreport al report Resellers Worldwide. Verranno descritte le procedure per aggiungere il sottoreport a una tabella e impostarne le proprietà nel report principale, inclusa l'associazione dei parametri del report principale a quelli del sottoreport.

Per aprire il progetto Server report Advanced Parmeters Tutorial

  1. In SQL Server Business Intelligence Development Studio aprire il progetto Server report Advanced Parameters Tutorial, se non è ancora aperto.

  2. In Esplora soluzioni fare doppio clic sul report Resellers Worldwide. Il report verrà aperto nella visualizzazione Layout.

Nella procedura seguente verrà aggiunto un parametro multivalore ContactDisplayFields a questo report principale. Quando si impostano le proprietà del parametro nel sottoreport, il parametro multivalore ContactDisplayFields del report principale viene associato al parametro multivalore FieldsToDisplay del sottoreport.

Per aggiungere il parametro multivalore ContactDisplayFields

  1. Nella visualizzazione Layout fare clic sull'area di progettazione. Verranno visualizzati i menu Report e Formato.

  2. Scegliere Parametri report dal menu Report. Verrà visualizzata la finestra di dialogo Parametri report.

  3. Fare clic su Aggiungi. Verrà creato un nuovo parametro con valori predefiniti.

  4. Nella sezione Proprietà digitare ContactDisplayFields nella casella di testo Nome. Verificare che il tipo di dati sia String.

  5. Nella casella di testo Messaggio di richiesta immettere Information to display in the subreport:.

  6. Selezionare la casella di controllo Consenti nessun valore.

  7. Selezionare la casella di controllo Multivalore.

  8. Nella sezione Valori disponibili verificare che Non da query sia selezionato e utilizzare la tabella seguente per impostare i valori disponibili:

    Etichetta Valore

    Phone

    Phone

    Email

    EmailAddress

    None

    <Vuoto>

  9. Nella sezione Valori predefiniti selezionare Non da query e incollare l'espressione seguente nella casella di testo Valore: EmailAddress.

  10. Fare clic su OK.

  11. Fare clic su Anteprima.

Poiché è stato creato un elenco di valori disponibili, il valore Seleziona tutto è stato aggiunto automaticamente all'elenco a discesa del parametro ContactDisplayFields.

Nella procedura seguente verrà aggiunto un parametro multivalore denominato Colors. In questa esercitazione verranno impostati due valori per il parametro multivalore Colors. Quando si impostano le proprietà del parametro per il sottoreport, si associa un singolo valore di questo parametro multivalore ai parametri del sottoreport BackgroundColor e FontColor.

Per aggiungere il parametro multivalore Colors

  1. Nella visualizzazione Layout scegliere Parametri report dal menu Report. Verrà visualizzata la finestra di dialogo Parametri report.

  2. Fare clic su Aggiungi. Verrà creato un nuovo parametro con valori predefiniti.

  3. Nella sezione Proprietà digitare Colors nella casella di testo Nome. Verificare che il tipo di dati sia String.

  4. Sostituire il messaggio di richiesta esistente con il testo seguente: Choose background and font colors:.

  5. Selezionare la casella di controllo Multivalore.

  6. Deselezionare la casella di controllo Consenti nessun valore.

  7. Nella sezione Valori disponibili verificare che Non da query sia selezionato. Lasciare vuota la tabella dei valori.

  8. Nella sezione Valori predefiniti selezionare Non da query e incollare i due valori seguenti nelle caselle di testo Valore: #C9DEF6 e SlateBlue.

    È necessario impostare due valori per questo parametro. Il primo valore della matrice verrà passato al sottoreport come il colore di sfondo, mentre il secondo valore verrà passato come il colore del tipo di carattere.

    In questo esempio il valore del colore di sfondo è il codice colore RGB esadecimale #C9DEF6, mentre il colore del tipo di carattere è il colore Web SlateBlue.

  9. Fare clic su OK.

  10. Fare clic su Anteprima.

    Poiché non è stato definito un elenco di valori disponibili per il parametro Colors, nell'elenco a discesa del parametro non verrà visualizzato il valore Seleziona tutto.

Nella procedura seguente verrà preparata una posizione nella tabella in cui aggiungere l'elemento del report sottoreport. Verrà aggiunta una seconda riga all'intestazione di gruppo della tabella. Le colonne verranno unite in modo che ci siano due sole caselle di testo in tale riga, una con larghezza sufficiente per visualizzare il sottoreport. Verrà quindi impostata la visibilità della riga di intestazione in modo che il valore del parametro ShowSalesDetails funzioni nel modo previsto, ovvero quando il parametro è vero la riga di dettaglio delle informazioni di contatto è visibile.

Per aggiungere una nuova riga all'intestazione di gruppo della tabella e unirne le caselle di testo

  1. Fare clic nella tabella. Verranno visualizzati i quadratini di ridimensionamento della tabella.

  2. Fare clic con il pulsante destro del mouse sulla riga di intestazione della tabella. Il contenuto della casella di testo inizia con =Fields!Store.Value. Scegliere Inserisci riga sotto. Verrà visualizzata una seconda riga di intestazione.

  3. Con la riga selezionata selezionare 8 nell'elenco a discesa delle dimensioni carattere nella barra degli strumenti del report.

    Per ridurre lo spazio vuoto attorno al sottoreport, ridurre la riga in cui è contenuto il sottoreport. L'elemento di report sottoreport può essere espanso ma non ridotto.

  4. Selezionare le caselle di testo delle colonne 2, 3 e 4, fare clic con il pulsante destro del mouse e scegliere Unisci celle. Nella nuova riga di intestazione verranno visualizzate solo due caselle di testo.

  5. Con la nuova riga di tabella selezionata, nella finestra Proprietà andare a Visibility ed espandere il nodo. Impostare Hidden su =Not Parameters!ShowSalesDetails.Value.

Per aggiungere un sottoreport al report principale

  1. In Esplora soluzioni fare clic sul report ContactInformation.rdl e trascinarlo nella seconda casella di testo nella riga di intestazione, accanto alla casella di testo Contact Information.

  2. Fare clic con il pulsante destro del mouse nell'area grigia del sottoreport e scegliere Proprietà. Verrà visualizzata la finestra di dialogo Proprietà sottoreport.

  3. Fare clic sulla scheda Parametri e quindi fare clic nella prima casella di testo Nome parametro. Verrà visualizzato l'elenco a discesa con i quattro parametri definiti per ContactInformation. Utilizzare la tabella seguente per impostare i parametri del sottoreport.

    Nome parametro Valore parametro

    ContactID

    =Fields!StoreContactID.Value

    FieldsToDisplay

    =Parameters!ContactDisplayFields.Value

    BackgroundColor

    =Parameters!Colors.Value(0)

    FontColors

    =Parameters!Colors.Value(1)

  4. Fare clic su OK.

  5. Fare clic sull'handle di riga della nuova riga di intestazione di gruppo. Nella finestra Proprietà andare a Height e impostare il valore su 0,01 o il valore minimo che è possibile impostare per l'altezza della riga in modo da eliminare lo spazio vuoto superfluo.

  6. La proprietà Height dell'elemento del report sottoreport nel report principale determina l'altezza minima. L'elemento si espande per contenere il report a cui è associato.

  7. Fare clic nell'area grigia del sottoreport. Nella finestra Proprietà andare a Width e impostare il valore su 3 o sulla larghezza corrispondente alla larghezza della definizione del sottoreport.

    Per eliminare lo spazio vuoto superfluo, la larghezza dell'elemento sottoreport deve essere inferiore o uguale alla larghezza del sottoreport indicata nella relativa definizione. Nel report principale il sottoreport si può espandere ma non ridurre.

  8. Visualizzare l'anteprima del report. Selezionare diversi valori per FieldsToDisplay e verificare che nel sottoreport vengano visualizzate le selezioni eseguite.

    Poiché ci sono ora otto parametri, la barra degli strumenti del report risulta troppo piena. Per nascondere la barra degli strumenti in modalità anteprima, fare clic su Mostra o nasconde l'area dei parametri nella barra degli strumenti del report.

Nella procedura seguente il parametro Colors verrà impostato come parametro interno. I parametri interni possono essere utilizzati come variabili interne nel report. I relativi valori non possono essere impostati mediante la barra degli strumenti del report o in altri modi.

Per impostare un parametro del report come interno

  1. Scegliere Parametri report dal menu Report. Verrà visualizzata la finestra di dialogo Parametri report.

  2. Nell'elenco Parametri selezionare Colors.

  3. Nella sezione Proprietà selezionare l'opzione Interno.

    Se si imposta un valore di parametro su Interno, il parametro verrà visualizzato solo nella definizione del report. Quando si pubblica il report nel server, non sarà possibile gestire tale parametro dal server di report. Nella barra degli strumenti del report non verrà visualizzato alcun messaggio di richiesta per questo parametro e se si utilizza il report come sottoreport, il parametro non verrà visualizzato nell'elenco dei parametri del sottoreport da un report principale.

  4. Fare clic su OK.

  5. Fare clic su Anteprima (facoltativo). Nella barra degli strumenti non verrà visualizzato alcun messaggio di richiesta per il parametro Colors.

Nella lezione 8, dopo aver pubblicato il report nel server di report, verranno nascosti numerosi parametri del report Resellers Worldwide affinché il tutto abbia un aspetto più ordinato.

Passaggi successivi

In questa lezione è stata aggiunta una riga aggiuntiva all'intestazione di gruppo della tabella, sono state unite celle ed è stato aggiunto un sottoreport con parametri a una cella. È stata inoltre impostata la visibilità della riga in base al valore del parametro del report ShowSalesDetails. Nella lezione successiva verrà aggiunto un parametro al report di esempio esistente AdventureWorks "Territory Sales Drilldown". Vedere Lezione 7: Creazione di un report drill-through.

Vedere anche

Altre risorse

Utilizzo di parametri in Reporting Services
Utilizzo di elementi di report

Guida in linea e informazioni

Assistenza su SQL Server 2005