Prima di utilizzare Jasper Report è necessario procedere all'installazione del modulo stesso in OpenERP.

Download diretto:

Il modulo Jasper Report per la versione 6 di openerp è scaricabile all'indirizzo:

 http://www.nan-tic.com/ftp/downloads/jasper_reports.zip

Utilizzo di Launchpad:

Per chi preferisce utilizzare il launchpad è possibile usare il comando:

 bzr clone lp:openobject-client-kde

verrà creata una cartella chiamata openobject-client-kde all'interno della quale troverete la cartella server-modules e quindi la cartella jasper-reports che contiene il modulo da installare.

Copiare la cartella jasper_reports in server/bin/addons

quindi effettuare il login in OpenERP con diritti amministrativi ed utilizzare il comando:

 Amministrazione->Moduli->Aggiorna Lista Moduli

Una volta aggiornato l'elenco dei moduli selezionare il modulo jasper_reports e procedere alla sua installazione.

Ad installazione completata troverete nel menu Amministrazione→Personalizzazione il sottomenù:

Jasper Reports
- Create Data Template
- Jasper Reports

iReport è un software multipiattaforma per la creazione di report, non strettamente legato ad OpenERP.
E' scaricabile dal sito:

http://jasperforge.org/projects/ireport

Selezionate il pulsante download, scegliete la versione adatta al Vostro sistema operativo ed eseguite l'installazione.

Per utilizzare iReport con OpenERP è necessario specificare un Data source. Nel caso specifico si deve usare il comando presente in OpenERP disponibile dopo l'installazione del modulo jasper_reports.

Amministrazione->Personalizzazione->Jasper Reports->Create Data Template.

Nella schermata Create Data Template si deve selezionare il modello e la profondità della struttura dati.
Ad esempio per gli ordini di vendita si deve selezioare il modello sale.order (primo livello), se si è interessati anche alle righe dell'ordine il modulo corrispondente è sale.order.line (secondo livello).
Nell'esempio adottato in questo documento useremo i seguenti valori:

Model: sale.order
Depth: 2

la schermata si presenterà come segue:

a questo punto cliccare sul pulsante Create e vi apparirà una nuova schermata

cliccando sul pulsante Salva Come vi verrà chiesto di salvare un file chiamato jasper.xml.
Questo file conterrà l'elenco dei campi ed il Data source in formato XPath da usare con iReport.

Aprite il software iReport, scegliete Nuovo… dal menù File

Nel wizard che apparirà scegliete Report e Blank A4, quindi cliccate sul pulsante Launch Report Wizard.

Assegnamo un nome al progetto (Nome del report) e scegliamo la directory in cui salvare i progetti (Posizione), quindi cliccare sul pulsante Avanti.

Cliccare sul pulsante Nuovo per specificare un nuovo Data source.

Selezionate XML file datasource e cliccate sul pulsante Avanti.

• Indicate un nome per il Data source (Nome)
• Selezionate il file jasper.xml che avete salvato al punto Creazione del template per iReport
• Selezionate la voce Usa l'espressione report XPath quando riempi il report
• Cliccare sul pulsante Salva
  

Verificare che sia selezionato il nuovo Data source OpenERP Vendite, quindi cliccate sul pulsante Avanti più volte ed infine sul pulsante Termina per uscire dal Wizard.

La schermata di iReport è suddivisa in due sezioni:

1. Sulla sinistra è presente il Report Inspector che contiene in una struttura ad albero tutti gli oggetti del report.
2. Nella parte centrale è presente l'area di editing divisa nelle varie sezioni.

Cliccate con il tasto destro sulla radice e selezionate la voce Edit Quesry

Seleazionate la scheda Report query ed impostate il valore di Query language su XPath, in questo modo sulla destra verrà visualizzata la struttura ad albero (simil XML) dei campi relativi agli ordini di vendita ed agli oggetti ad esso legati (cliente, prodotti, righe ordinem fatture, ecc.).

NOTA: La struttura include i campi degli oggetti relazionati agli Ordini di Vendita, perchè nella fase di creazione del template abbiamo specificato una profondità (Depth) pari a due.

Per selezionare i campi da utlizzare nel report è sufficiente trascinare nel riquadro in basso i campi desiderati.
Terminata la selezione cliccare sul pulsante OK