Creazione di un report con parametri

Iniziare creando un report le cui informazioni provengano dal database Microsoft Access di esempio fornito con Crystal Reports.

Nota

Xtreme.mdb è il database di esempio fornito con Crystal Reports. Per individuare la posizione di Xtreme.mdb sul disco rigido, per la versione di Crystal Reports in uso, vedere Posizione del database di esempio Xtreme. È necessario connettersi al database tramite la voce DSN ODBC. Per informazioni sul nome di questa voce per la versione di Crystal Reports in uso, vedere Voce DSN ODBC per il database di esempio Xtreme.

Per creare un report con parametri

1. Se viene visualizzata la finestra di dialogo Registrazione guidata, è necessario registrare la copia di Crystal Reports. Sono disponibili due opzioni:

   • Fare clic su Avanti per effettuare subito la registrazione.
   • Fare clic su Registra in seguito per effettuare la registrazione in un secondo momento.

Dopo aver scelto l'opzione desiderata, procedere con il passaggio successivo.

2. Nel riquadro Crea un nuovo documento Crystal Report della finestra di dialogo Galleria Crystal Reports, selezionare Uso della procedura guidata Report.

3. Nel riquadro Scegli un esperto selezionare Standard, quindi fare clic su OK.

   Viene visualizzata la finestra di dialogo Procedura guidata per la creazione di report standard.

4. Nel riquadro Origini dati disponibili della finestra Procedura guidata per la creazione di report standard, espandere la cartella Crea nuova connessione.

5. Dalla sottocartella, espandere la cartella ODBC (RDO).

6. Nella finestra ODBC (RDO), selezionare la voce DSN ODBC corretta per la versione di Crystal Reports in uso, come descritto in Voce DSN ODBC per il database di esempio Xtreme, quindi fare clic su Avanti.

7. Lasciare vuoti i campi ID utente e Password, quindi fare clic su Fine.

La cartella ODBC (RDO) si espande e visualizza il database di esempio Xtreme.

8. Espandere il nodo Tabelle, quindi selezionare la tabella Clienti.

9. Fare doppio clic sulla tabella Clienti per spostarla nel riquadro Tabelle selezionate, quindi scegliere Avanti.

10. Espandere la tabella Clienti, quindi tenendo premuto il tasto Ctrl fare clic su Nome cliente, Titolo contatto, Indirizzo1, Cognome contatto e Città.

11. Fare clic sul simbolo > per spostare questi campi nel riquadro Campi da visualizzare, quindi scegliere Avanti.

12. Nel riquadro Campi disponibili, in Campi report, selezionare Clienti.Città, fare clic sul simbolo > per spostare il campo nel riquadro Raggruppa in base a, quindi scegliere Fine.

Il report CustomersByCity viene creato e caricato nella finestra principale di Visual Studio.

A questo punto è possibile aggiungere un parametro denominato Città e compilarlo con i valori predefiniti.

Per aggiungere un parametro Città

Explorer Campo deve essere visibile poiché garantisce l’accesso alle diverse funzionalità del report, inclusi i parametri.

1. Se Explorer Campo non è visibile, nella barra degli strumenti di Crystal Reports fare clic sul pulsante Alterna visualizzazione campi.

   Nota
   Per visualizzare Explorer Campo, è possibile anche selezionare il menu Crystal Reports e scegliere Explorer Campo.

2. In Explorer Campo, fare clic con il pulsante destro del mouse su Campi parametro, quindi selezionare Nuovo….

3. Nella finestra di dialogo Crea campo parametro:

1.  Impostare Nome su "Città".
2.  Impostare Testo richiesta su "Selezionare una o più città".
3.  Impostare Tipo valore su Stringa.
4.  Scegliere Consenti valori multipli.
5.  Selezionare Valore/i discreto/i.
6.  Fare clic su Valori predefiniti....

4. Nella finestra di dialogo Imposta valori predefiniti:

1.  Impostare Sfoglia tabella su "Clienti".
2.  Impostare Sfoglia campo su "Città".
3.  Fare clic su \>\> (doppia freccia destra) per spostare l’intero elenco di città nell’elenco Valori predefiniti.

5. Fare clic su OK per chiudere la finestra di dialogo Imposta valori predefiniti.

6. Fare clic su OK per chiudere la finestra di dialogo Crea campo parametro.

Per connettere il parametro Città alla colonna Città del database

A questo punto, utilizzare l’Esperto selezione per impostare una formula che connetta la colonna Città del database al campo parametro Città appena creato.

1. Nella barra degli strumenti di Crystal Reports, fare clic su Esperto selezione.

2. Nella finestra di dialogo Scegli campo, in Campi report, selezionare Clienti.Città, quindi scegliere OK.

3. Nella finestra di dialogo Esperto selezione, nella scheda Clienti.Città, impostare l’elenco a discesa su è uguale a.

4. Nel nuovo elenco visualizzato a destra, selezionare la prima opzione disponibile, {?Città}, quindi fare clic su OK.

<table>
<colgroup>
<col style="width: 100%" />
</colgroup>
<thead>
<tr class="header">
<th><img src="images\Aa983431.alert_note(it-it,VS.90).gif" alt="Note" class="note" />Nota</th>
</tr>
</thead>
<tbody>
<tr class="odd">
<td><p>Questa selezione, {?Città}, corrisponde al parametro Città creato in precedenza.</p></td>
</tr>
</tbody>
</table>

5. Dal menu File, scegliere Salva tutto.

6. Nella parte inferiore della finestra, fare clic su Anteprima report principale.

   Nota
   Il pulsante Anteprima è una nuova funzionalità del componente Crystal Reports Designer incorporato fornito con Crystal Reports per Visual Studio 2005 o versioni successive.

7. Nella finestra di dialogo Immetti valori dei parametri, selezionare almeno una città dall'elenco Valori discreti, scegliere Aggiungi, quindi fare clic su OK.

Il report viene visualizzato in modalità anteprima, con il valore del parametro Città selezionato.

8. Nella parte inferiore della finestra, fare clic su Report principale per uscire dalla modalità anteprima.

9. Aprire il Web Form.

10. Dal menu Visualizza, scegliere Finestra di progettazione.

Il report viene visualizzato in modalità Anteprima in fase di progettazione, che mostra il layout grafico del report sul Web Form.

11. Dal menu File, scegliere Salva tutto.

Per verificare il sito Web basato su codice ridotto

Il report viene creato e designato come report per il controllo CrystalReportSource. A questo punto è possibile creare ed eseguire il progetto.

1. Dal menu Genera, scegliere Genera soluzione.

2. Se si verificano errori di generazione, correggerli.

3. Dal menu Debug, scegliere Avvia.

Viene visualizzata una pagina di richiesta di parametri, in cui si richiede di selezionare una richiesta da un controllo DropDownList. Questo è il risultato previsto per due motivi:

  - Non è stato ancora configurato il tag Parameters nel report.
  - Nel riquadro Smart Task per il controllo CrystalReportViewer, la casella di controllo Attiva prompt del parametro report è selezionata per impostazione predefinita.

4. Selezionare un parametro e fare clic su Inoltra.

5. Il report CustomersByCity viene visualizzato nel browser Web e mostra la città selezionata.

6. Tornare a Visual Studio e fare clic su Interrompi per uscire dalla modalità di debug.