Gestione dei report tramite il Generatore di report › Oggetti dati › Variabili di runtime

Variabili di runtime

Gli oggetti dati possono utilizzare variabili di runtime per modificare in maniera dinamica il comportamento e i criteri di selezione.

Per gli oggetti dati Query è possibile utilizzare variabili di runtime nelle query SQL. Come prerequisito, definire queste variabili di runtime nell'elenco Variabili. Tale elenco include variabili Query predefinite ed è possibile aggiungerne altre proprie.

Ad esempio, considerare un report basato su una query SQL che visualizza un elenco di utenti. L'oggetto dati può assumere un valore Last_Name come variabile di runtime per indicare i caratteri iniziali del cognome. Gli utenti dell'oggetto dati vengono richiesti per il valore Last_Name. È possibile utilizzare la variabile di runtime di tipo Stringa denominata %Last_Name% nell'istruzione SQL. Utilizzare questa variabile per limitare i risultati a record utente che iniziano con il valore immesso dall'utente. L'istruzione SQL seguente offre un esempio di query:

SELECT first_name,middle_name,last_name FROM ca_contact WHERE (ca_contact.last_name like '%Last_Name%%')

Nota: la richiesta agli utenti viene visualizzata solo per le variabili di runtime nella query SQL.

Per oggetti dati di plug-in, è possibile passare variabili di runtime alla classe Java come coppie di nome e valore. Come prerequisito, verificare che la classe Java del plug-in di report prenda la coppia di nome e valore per l'oggetto dati del plug-in.

Ad esempio, considerare la classe di plug-in com.ca.usm.reporting.Plugins.RequestFulfillmentReport. Questa classe di plug-in prende un parametro di tipo Data denominato START_DATE. Perciò, START_DATE viene richiesto nell'oggetto dati che utilizza questa classe di plug-in. In questo caso, effettuare una delle seguenti operazioni:

• Codificare START_DATE come costante
• Richiedere all'utente il valore START_DATE di data e passare tale valore al plug-in

È possibile utilizzare variabili di sistema contestuali con variabili di runtime per gli scopi seguenti:

• Come valori predefiniti in caso di richiesta all'utente
• Come valori costanti da passare al plug-in
• Come valori da utilizzare in una query

Le variabili di sistema contestuali sono come segue:

Aggiunta di una variabile di runtime query

È possibile definire una variabile di runtime personalizzata da utilizzare con un oggetto dati Query. Un esempio consiste nell'aggiunta di una variabile di runtime della query che è una variabile di tipo a discesa.

Per aggiungere una variabile di runtime query

1. Fare clic su Amministrazione, Generatore di report.

   Viene visualizzata la pagina Generatore di report, con l'opzione Oggetti dati selezionata nel menu a sinistra sotto il menu principale.

2. Eseguire una delle seguenti operazioni:
   • Aggiungere un nuovo oggetto dati
   • Modificare un oggetto dati esistente

   La pagina cambia a seconda dell'azione di creazione o modifica dell'oggetto dati.

3. Fare clic su Crea variabile.

   Viene visualizzata la finestra di dialogo Crea variabile di runtime o Modifica variabile runtime.

4. Specificare il nome, il tipo e altri dati nei campi forniti. Attenersi alle indicazioni seguenti:
   • Per specificare dati avanzati, fare clic su Avanzate.
   • Per visualizzare la guida in linea, fare clic sull'icona a forma di punto interrogativo. L'icona si trova all'estremità della barra del titolo della finestra di dialogo.
5. Fare clic su Crea variabile.

   Il sistema del catalogo salva la definizione della variabile.

È possibile utilizzare la variabile in una query SQL per un oggetto dati Query. Agli utenti viene richiesto di immettere un valore quando eseguono l'oggetto dati.

Nota: quando si aggiunge una variabile di runtime della query di tipo a discesa, il limite del numero di valori dell'elenco a discesa è 1000. Se la query del report restituisce un numero di valori oltre 1000, il sistema tronca i valori aggiuntivi. Di conseguenza, l'utente non può visualizzarli nell'elenco a discesa. Se necessario, è possibile aumentare il numero di valori visualizzati nell'elenco a discesa oltre 1000. Per maggiori dettagli, consultare la Guida all'implementazione.