Report e Stampa

 

Introduzione

Il sistema di stampa si basa sulla generazione di pagine HTML, visualizzabili in qualunque browser e quindi stampabili mediante la funzione di strampa del browser stesso. Per la generazione delle pagine HTML, il motore di GA utilizza dei template nei quali verranno sostituiti appositi TAG con i valori contenuti nel Database.

 

I Template di Stampa

I template inclusi con GA, coprono le necessità più comuni, ma essendo sostanzialmente file HTML ognuno potrà crearsi il template più adatto alle proprie necessità. L'importante è rispettare i tag. GA quando eseguirà il report e compilerà il template, estrarrà dal database tutti i campi disponibili, anche se nel template fornito non sono visualizzati tutti. Con poche modifiche sarà possibile aggiungere e rimuovere le informazioni volute.

 

I Nomi file e gruppi di Template

GA per identificare i report corretti da generare, utilizza il nome file del template HTML. Quindi nel momento in cui verrà creato un nuovo Template, una parte del Nome File dovrà rispettare le regole di GA, altrimenti in report non potrà essere eseguito. Un esempio del nome potrebbe essereIT_02_NomeDelTemplate.html Vediamo nel dettaglio come comporre il nome:

  • IT: corrisponde alla lingua in cui verrà eseguito GA
  • 02: è il gruppo del report
  • NomeDelTemplate: Nome Descrittivo può essere impostato a piacere
  • .html: Estensione del file, mandatoria. i file .htm non sono caricati come template

 

Lingua

La lingua è impostata nelle opzioni di GA. Il codice lingua è contenuto nel file Language. I report forniti con GA sono solo in Italiano e Inglese. Se viene impostata una lingua, per cui non sono presenti template, vengono caricati quelli in inglese. Le lingue per ora ammesse sono:

  • IT: Italiano
  • EN: Inglese
  • DE: Tedesco

 

Gruppo dei report

Il Gruppo di report, identifica univocamente il tipo di dati e di estrazione che viene effettuata da GA. Identifica anche il tipo di report, se a scheda singola o tabellare.

Report a Scheda Singola

  • 01 Scheda Specie Fauna con foto
  • 02 Elemento singolo in vasca con foto
  • 03 Singolo Rilevamento Acqua, con tutti i dettagli
  • 04 Dettaglio Vasca con Attrezzatura e foto

Report a Tabulari

  • 52 Lista Tabulare Elementi Fauna in Vasca con alcuni dettagli, con alcuni filtri disponibili
  • 53 Lista Rilevamenti Valori Acqua, con filtro per data disponibile
  • 55 Lista Manutenzioni con filtro per data disponibile
  • 57 Lista delle spese effettuate filtrate per vasca e data
  • 59 Lista della spesa - Wishlit non filtrato

 

Template Rilasciati con GA

  • IT_01_Specie_Fauna_Scheda_A4_Portrait.html

Visualizza in una scheda A4 Verticale i dettagli di una Specie Fauna con tutti i dettagli e la foto

  • IT_02_SchedaPesce_A4_Portrait.html

Visualizza in una scheda A4 Verticale i dettagli di un pesce e un elemento fauna con foto e i relativi Log

  • IT_03_Acqua_Singolo_A4_Landscape.html

Visualizza in una scheda A4 in orizzontale tutti i valori dell'acqua per un singolo rilevamento

  • IT_04_Vasca_Detail_A4_Portrait.html

Visualizza in una scheda A4 Veritcale i dellagli di una vasca, compreso l'elenco delle attrezzature

  • IT_52_ElencoPesci_A4_Landscape.html

Visualizza una lista A4 in orizzontale tutti i pesci o elementi fauna in una vasca, con possibilità di inserire dei filtri

  • IT_53_Acqua_Lista_Dolce_A4_Landscape.html

Visualizza una lista A4 in orizzontale tutti i rilevamenti dei valori dell'acqua, filtrabili per data

  • IT_55_ElencoManutenzioni_A4_Landscape.html

Visualizza la lista di manutenzioni in formato A4, filtrabili per data

  • IT_57_Spese_A4_Landscape.html

Visualizza la lista delle spese effettuate per una vasca, filtrabili per data

  • IT_59_WishList_A4_Landscape.html

Visualizza la lista della spesa in formato A4 con il totale, senza nessun filtro

 

 

I Tag Supportati

Mediante i TAG, GA sostiruisce nel Template i valori di GA.

 

Parametri del Report

  • [*Par_Ver*] [*/Par_Ver*]

Questo tag identifica la versione del Report.

  • [*Par_Note*] [*/Par_Note*]

Questo tag identifica la descrizione e l'utilizzo del report che verrà viasualizzata in GA quando il template verrà selezionato.

 

 

Valori fissi

  • [*Version*] [*/Version*]

Versione di Gestione Acquario che ha generato il report

  • [*Now*] [*/Now*]

Data e ora in cui viene generato il report

  • [*PageTitle*] [*/PageTitle*]

Titolo della Pagina HTML, che verrà visualizzata nella barra del browser o nel Tab del browser

 

 

Report a Scheda singola

I seguenti Tag, vengono utilizzati nei report a Scheda Singola, per visualizzare i dati di GA.

  • [*Field_NomeCampo*] [*Field_NomeCampo*]

NomeCampo equivale al nome dei campi del database, e vengono sostituiti con i valori recuperati relativi alla scheda in stampa

  • [*Field_NA_NomeCampo*] [*Field_NA_NomeCampo*]

Come i precedenti, ma in caso di valore vuoto, viene scritto n/d (localizzato nella lingua di GA)

 

Liste/Tabelle nel Report a Scheda singola

  • [*Table_NomeTabella_WHERE|condizione di Where|*] [*/Table_NomeTabella*]

Tutto quello compreso tra questi due tag verrà sostituito con l'HTML della tabella. Se non ci sono dati la tabella non verrà compilata. Esempio:

[*Table_PesciLog_WHERE| AND Data>#2005-11-2#|*]

Mediante questo esempio verrà eseguita una query sulla tabella PesciLog selezionando i record che hanno come data il 2 Novembre 2005

  • [*Table_Field_???*] [*/Table_Field_???*]

equivalgono al nome dei campi del database, e vengono sostituiti con i valori recuperati relativi ai nomi campi della tabella estratta

Di seguito un esempio completo che estrae i log di un Elemento Fauna:

   <table cellspacing="0" cellpadding="3" width="100%" align="center" border=0>
              <tr>
                <td>Date</td>
                <td>Note</td>
                <td>Size</td>
              </tr>  
              [*Table_PesciLog_WHERE||*]
              <tr>
                <td>[*Table_Field_Data*]</td>
                <td>[*Table_Field_Note*]</td>
                <td>[*Table_Field_Taglia*]</td>
              </tr>
              [*/Table_PesciLog*]      
   </table>

 

 

Report Tabellari con Intestazioni

Questi report riportano in formato tabulare i dati. Ad esempio tutti i rilevamenti dei valori dell'acqua per un dato periodo di tempo, oppure l'elenco di tutti i pesci in vasca.

  • [*Tabular_Field_NomeCampo*] [*/Tabular_Field_NomeCampo*]

NomeCampo equivale al nome dei campi del database, e vengono sostituiti con i valori recuperati relativi alla scheda in stampa

  • [*Tabular_FieldNA_NomeCampo*] [*/Tabular_FieldNA_NomeCampo*]

Come i precedenti, ma in caso di valore vuoto, viene scritto n/d (localizzato nella lingua di GA)

Di seguito un esempio completo che estrae una tabella con i log dell'acqua:

     <table cellspacing="0" cellpadding="3" width="100%" align="center" border=1>
              
              <tr bgcolor="#66CCFF">
                <td class="ExtTable"><strong>Data</strong></td>
                <td class="ExtTable"><strong>Temperatura</strong></td>
                <td class="ExtTable"><strong>Conducibilità</strong></td>
                <td class="ExtTable"><strong>PH</strong></td>
                <td class="ExtTable"><strong>KH</strong></td>
                <td class="ExtTable"><strong>GH</strong></td>
                <td class="ExtTable"><strong>CO2</strong></td>
                <td class="ExtTable"><strong>FE</strong></td>
                <td class="ExtTable"><strong>NO2</strong></td>
                <td class="ExtTable"><strong>NO3</strong></td>
                <td class="ExtTable"><strong>O2</strong></td>
                <td class="ExtTable"><strong>NH4</strong></td>
                <td class="ExtTable"><strong>CU</strong></td>
                <td class="ExtTable"><strong>PO4</strong></td>
                <td class="ExtTable"><strong>Cl</strong></td>
              </tr>
	      
              [*TabularData*]
              <tr>
                <td>[*Tabular_Field_Data*]</td>
                <td>[*Tabular_Field_Temp*]</td>
                <td>[*Tabular_Field_Cond*]</td>
                <td>[*Tabular_Field_PH*]</td>
                <td>[*Tabular_Field_KH*]</td>
                <td>[*Tabular_Field_GH*]</td>
                <td>[*Tabular_Field_CO2*]</td>
                <td>[*Tabular_Field_FE*]</td>
                <td>[*Tabular_Field_NO2*]</td>
                <td>[*Tabular_Field_NO3*]</td>
                <td>[*Tabular_Field_O2*]</td>
                <td>[*Tabular_Field_NH4*]</td>
                <td>[*Tabular_Field_CU*]</td>
                <td>[*Tabular_Field_PO4*]</td>
		<td>[*Tabular_Field_Cl*]</td>
              </tr>
              [*/TabularData*]

    </table>

Report Tabellari - Somma di prezzi

Nei report dove è previsto un elenco di prezzi, è possibile inserire il totale, calcolato in base ai singoli prezzi visualizzati.

Il tag da utilizzare è: [*Sum*]