Guida per l'utente › Report › Tipi di report › Report in formato libero › Parametri del report in formato libero

Parametri del report in formato libero

Le due stringhe immesse nei campi Stringa di connessione e Query della pagina dei dettagli del report in formato libero sono sufficienti per la generazione di un report in formato libero. Tuttavia, la flessibilità e l'utilità del report possono essere migliorate molto aggiungendo i parametri al file XML predefinito contenuti nel campo Parametri. Una volta che tutti i parametri siano stati definiti, viene visualizzata una finestra popup per immettere i valori di tali parametri per la generazione del report.

Il file XML predefinito è come segue:

<custom>
     <connection>
          <params>
               <!--<param name='@UID' disp_name='User id' type='TEXT' size='10'><value>user id</value></param>- > 
               <!--<param name='@PWD' disp_name='Password' type='PASSWORD' size='10'><value>password</value></param>- > 
          </params>
     </connection>
     <query>
          <params>
               <!--<param name='@PRM1' disp_name='PARAM 1' type='TEXT' size='10'><value>param1 value</value></param>- > 
               <!--<param name='@PRM2' disp_name='PARAM 2' type='LIST'><value>value 1</value><list><item><value>value 1</value><text>text 1</text></item><item><value>value 2</value><text>text 2</text></item></list></param>- > 
               <!--<param name="@PRM3" disp_name="PARAM 3" type="LIST">
                    <value>value</value>
                    <list>
                         <list_query>select customer_id value, customer_name text from t_customers</list_query>
                    </list>
               </param>- > 
          </params>
     </query>
     <pdf>
          <!--<option><name>pameter name</name><value>parameter value</value></option>- > 
     </pdf>
     <chart>
          <!--<precision>Numeric value from 0 to 5</precision>- > 
     </chart>
     <!--<ContainsHTML>0/1</ContainsHTML>- > 
     <!--<headstyle>
          <titlerow bgcolor="value or color name"></titlerow>
          <firstcolumn bgcolor="value or color name"></firstcolumn>
     </headstyle>
</custom>

Il file XML contiene le seguenti sezioni principali:

• <connection>: contiene le informazioni di connessione per il database su cui viene eseguita la query
• <query>: contiene la query SQL
• <pdf>: contiene le opzioni di stampa PDF per l'output, tra cui il formato carta, l'orientamento e così via

Ogni parametro compreso in <connection> e <query> dispone di un proprio nodo di <param> che include i seguenti attributi:

• name: il nome del parametro.
• disp_name: nome del parametro che viene visualizzato nella finestra popup.
• type: il tipo di parametro, che può essere uno dei seguenti:
• TEXT (Testo): input di testo
• PASSWORD (Password): testo visualizzato come asterischi
• DATE (Data): campo del calendario
• LIST (Elenco): elenco a discesa con selezioni multiple
• list_query: elenco a discesa con più selezioni che abilita l'elenco dinamico di valori. Ad esempio:

  <list>

  <list_query>select some_value value, some_text text from some_table</list_query>

  </list>

  Nota: l'istruzione select deve sempre contenere due colonne, una per il valore e una per la visualizzazione del testo.

• size: il numero massimo di caratteri consentito nel campo di input.

I parametri all'interno di <pdf> includono i seguenti attributi:

• name: il nome del parametro
• value: il valore del parametro