* Conoscenza del computer >> sistemi >  >> Windows 2016

Come generare report PDF da Oracle APEX (Application Express)

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)

  1. App Builder → La tua applicazione → Pagina con report
  2. Region tipo Classic Report → Edit
  3. Source: query SQL che restituisce i dati

2. Abilita la stampa

  1. Region → Attributes → Enable Printing: Yes
  2. Printing → Report Query: seleziona la query (o creane una "Report Query" separata in Shared Components)
  3. Printing → Report Layout: scegli o crea un layout

3. Crea Report Layout (Shared Components → Report Layouts)

  1. Shared Components → Report Layouts → Create
  2. Name: `Employee_Report_Layout`
  3. Layout Type: Generic Layout (semplice, tabellare) o Named Columns (personalizzato)
  4. Format: PDF
  5. Template: carica file .rtf (Word → Salva come RTF) o .xsl-fo (avanzato)
  6. Per Generic: APEX genera automaticamente tabella con colonne della query

4. Crea Report Query (se non usa query della region)

  1. Shared Components → Report Queries → Create
  2. Query Name: `Employee_Query`
  3. SQL Query: `SELECT empno, ename, job, sal, deptno FROM emp ORDER BY deptno, ename`
  4. Report Layout: seleziona quello creato sopra

5. Aggiungi bottone "Stampa PDF" nella pagina

  1. Page Designer → Region (report) → Buttons → Create Button
  2. Button Name: `PRINT_PDF`
  3. Label: `Stampa PDF`
  4. Action: Submit Page (o Redirect to URL con `REQUEST=PRINT_PDF`)
  5. 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

  1. Run Page → Clicca "Stampa PDF"
  2. Browser scarica/apre `report.pdf`

Metodo 2: Interactive Report (IR) - Download PDF nativo

Gli Interactive Report hanno export PDF built-in (senza layout personalizzato):

  1. Crea Region → Interactive Report
  2. Actions menu (icona ingranaggio/azioni) → Download → PDF
  3. 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)

  1. Abilita ORDS (Oracle REST Data Services) con modulo stampa
  2. Configura `printing` in `defaults.xml`:
    `localhost:8080/ords/fop`
  3. 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

ProblemaCausa / 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 (à, è, ñ, €) corrottiFont 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 / lentezzaQuery 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

Windows 2016