Oracle APEX (Application Express) include un motore di stampa nativo che genera PDF direttamente dai report SQL. Non serve software esterno: usa Apache FOP (Formatting Objects Processor) integrato o un server di stampa esterno (BI Publisher, ORDS Printing). Ecco come configurare ed esportare report in PDF.
Prerequisiti
- Oracle Database 11g/12c/19c/21c/23c con APEX installato (5.0+)
- Workspace APEX con ruolo Developer o Admin
- Accesso ad App Builder
Metodo 1: Stampa nativa APEX (FOP integrato) - Per report classici
1. Crea/Modifica un Report Classico (Classic Report)
- App Builder → La tua applicazione → Pagina con report
- Region tipo Classic Report → Edit
- Source: query SQL che restituisce i dati
2. Abilita la stampa
- Region → Attributes → Enable Printing: Yes
- Printing → Report Query: seleziona la query (o creane una "Report Query" separata in Shared Components)
- Printing → Report Layout: scegli o crea un layout
3. Crea Report Layout (Shared Components → Report Layouts)
- Shared Components → Report Layouts → Create
- Name: `Employee_Report_Layout`
- Layout Type: Generic Layout (semplice, tabellare) o Named Columns (personalizzato)
- Format: PDF
- Template: carica file .rtf (Word → Salva come RTF) o .xsl-fo (avanzato)
- Per Generic: APEX genera automaticamente tabella con colonne della query
4. Crea Report Query (se non usa query della region)
- Shared Components → Report Queries → Create
- Query Name: `Employee_Query`
- SQL Query: `SELECT empno, ename, job, sal, deptno FROM emp ORDER BY deptno, ename`
- Report Layout: seleziona quello creato sopra
5. Aggiungi bottone "Stampa PDF" nella pagina
- Page Designer → Region (report) → Buttons → Create Button
- Button Name: `PRINT_PDF`
- Label: `Stampa PDF`
- Action: Submit Page (o Redirect to URL con `REQUEST=PRINT_PDF`)
- Branch (Processing): On Submit → `PRINT_PDF` → Action: Redirect to URL → URL: `f?p=&APP_ID.:&APP_PAGE_ID.:&SESSION.:PRINT_REPORT=&APP_PAGE_ID.`
6. Test
- Run Page → Clicca "Stampa PDF"
- Browser scarica/apre `report.pdf`
Metodo 2: Interactive Report (IR) - Download PDF nativo
Gli Interactive Report hanno export PDF built-in (senza layout personalizzato):
- Crea Region → Interactive Report
- Actions menu (icona ingranaggio/azioni) → Download → PDF
- Genera PDF con dati correnti (filtri, ordinamenti, colonne visibili applicati)
Limite: layout fisso, no intestazioni personalizzate, no logo, no pie di pagina.
Metodo 3: PL/SQL + APEX_UTIL / APEX_ZIP (Programmatico, flessibile)
-- In un processo PL/SQL (es. su click bottone)
DECLARE
l_report_blob BLOB;
BEGIN
-- Genera PDF da Classic Report region
l_report_blob := APEX_UTIL.GET_PRINT_DOCUMENT (
p_report_query_name => 'Employee_Query', -- Report Query name
p_report_layout_name => 'Employee_Report_Layout', -- Report Layout name
p_report_layout_type => 'rtf', -- o 'xsl-fo'
p_document_format => 'pdf' -- pdf, rtf, xls, html
);
-- Invia al browser
OWA_UTIL.MIME_HEADER('application/pdf', FALSE);
HTP.P('Content-Disposition: inline; filename="employee_report.pdf"');
OWA_UTIL.HTTP_HEADER_CLOSE;
WPG_DOCLOAD.DOWNLOAD_FILE(l_report_blob);
END;
Metodo 4: ORDS REST + PDF (Moderno, decoupled)
- Abilita ORDS (Oracle REST Data Services) con modulo stampa
- Configura `printing` in `defaults.xml`:
`localhost:8080/ords/fop ` - Chiama endpoint REST da frontend (JS, mobile, altro):
`GET /ords/ws/app/print/report?query=Employee_Query&layout=Employee_Report_Layout&format=pdf`
Layout RTF: consigli pratici
- Crea in Word: Inserisci tabella → Mailing → Avvia stampa unione → Directory → Seleziona destinatari → Usa elenco esistente → file XML/CSV esportato da query APEX
- Inserisci campi unione: `«EMPNO»`, `«ENAME»`... (devono matchare nomi colonne query ESATTI, maiuscoli)
- Salva come .rtf
- Carica in APEX Report Layout
Risoluzione problemi comuni
| Problema | Causa / Soluzione |
|---|---|
| PDF vuoto / "No data found" | Query non restituisce righe. Test query in SQL Workshop. |
| Errore "FOP error" / "Transformer configuration" | Layout RTF malformato. Semplifica: rimuovi campi unione complessi, tabelle annidate, oggetti galleggianti. |
| Caratteri speciali (à, è, ñ, €) corrotti | Font nel RTF non supporta Unicode. Usa font Unicode (Arial Unicode MS, DejaVu Sans) nel template RTF. O usa layout XSL-FO con font embedding. |
| Timeout / lentezza | Query pesante. Ottimizza SQL, indici, paginazione. Aumenta `max_row_count` in APEX. |
| PDF non scarica (browser blocca popup) | Usa `Content-Disposition: attachment` o apri in nuova scheda `target="_blank"`. |
Alternative enterprise
- Oracle BI Publisher: layout complessi, bursting, scheduling, multi-formato, enterprise
- JasperReports / Jaspersoft: open source, integra con APEX via PL/SQL o REST
- PL/PDF, PL/FOP: package PL/SQL per generazione PDF programmatica fine-grained
- Come impostare uno screensaver su Windows 10/11
- Come creare PDF da file DWF con Autodesk Design Review
Windows 2016
- Come creare una cartella per icone desktop inutilizzate (Windows XP, Vista, 7)
- Differenze tra "coding" (codifica) e "programming" (programmazione)
- Come trovare una proprietà (terreno) usando coordinate GPS
- Rimuovere punti bianchi e hot pixel in Photoshop: strumento Pennello correttivo
- Installare Yahoo Messenger 9.0 su Windows XP
- Come risolvere i conflitti di indirizzo IP in Windows XP
- Creare un gioco Java con NetBeans: guida pratica per sviluppatori
- Come importare documento Word in foglio Excel come oggetto