L’Interactive Report (o Report Interattivo) è uno dei componenti principali di Oracle APEX.

Viene usato quando vuoi visualizzare i record restituiti da una query in formato tabellare.

Implementare un report basato su Interactive Report richiede da parte tua davvero pochissimo ma, allo stesso tempo, offre tantissimo in termini di funzionalità out-of-the-box.

Questa area di reporting interattiva consente agli utenti di personalizzare il layout dei dati scegliendo le colonne da visualizzare, supporta filtri ed ordinamenti avanzati e permette di definire regole di formattazione condizionale.

Possono anche definire interruzioni, aggregazioni, grafici e colonne formula. Infine, puoi salvare tutte le viste che crei per richiamarle in un successivo momento e puoi scaricare in locale i dati in diversi formati come Excel o CSV.

In questo articolo tutorial vedremo come implementare in pochissimi minuti un Interactive Report e quali sono le sue funzionalità principali.

Cosa ti serve per implementare un Interactive Report

Per costruire un report APEX basato su Interactive Report hai bisogni di:

• La query SQL che deve essere eseguita.
• Un ambiente Oracle APEX su cui lavorare.

Non hai un ambiente APEX a disposizione? Non preoccuparti, leggi la guida su come ottenere un ambiente Oracle APEX di prova in meno di 10 minuti.

Come creare un’applicazione con un Interactive Report

Vediamo come creare la tua prima applicazione basata su Interactive Report.

Crea una nuova applicazione

Se non lo hai già fatto, ovviamente.

Se hai già una applicazione APEX e vuoi aggiungere una nuova pagina con un report interattivo, puoi tranquillamente saltare al paragrafo successivo.

Per creare una nuova applicazione, esegui i seguenti passaggi.

• Collegati ad Oracle APEX e seleziona App Builder

• Clicca sul bottone Create

• Seleziona New Application

• Dai un nome alla tua applicazione
• Premi Create Application

Crea una nuova pagina di tipo Interactive Report

• Dall’App Builder di Oracle APEX, clicca sull’applicazione di interesse
• Clicca sul bottone Create Page

• Seleziona il tipo pagina Report e clicca Next

• Seleziona il componente Interactive Report e clicca su Next

• Dai un nome alla pagina e clicca su Next

• Crea automaticamente (se vuoi) la voce di menù dalla quale potrai richiamare la tua pagina

• Indica qual è la sorgente dalla quale l’Interactive Report deve prendere i dati da mostrare.
• Ci sono diverse opzioni: in questo tutorial useremo una query SQL.
  • Source Type SQL Query
  • SQL Statement: inserisci la query che avrai precedentemente preparato.
  • In questa fase puoi trascurare eventuali parametri, li inseriremo successivamente.
• Clicca Create

• Il sistema creerà una pagina con un componente di tipo Interactive Report

• Possiamo fin da subito eseguire l’applicazione per vedere il risultato.
• In alto a destra, clicca sul bottone Esegui

• Questo è il risultato che dovresti ottenere

Bene, se sei arrivato fino a questo punto del tutorial dovresti aver creato la tua prima pagina con Interactive Report.

Come avrai avuto modo di vedere è già un’applicazione funzionante completa, che può essere utilizzata fin da subito.

Il tutto in meno di 5 minuti. Fantastico.

Nel prossimo paragrafo ti mostrerò come raffinarla ulteriormente.

Come gestire i parametri di ricerca di un’Interactive Report

La pagina che abbiamo creato contiene un report interattivo che esegue automaticamente una query senza parametri.

Tuttavia, potresti aver bisogno di definire nella pagina uno o più parametri di ricerca affinché l’estrazione che viene eseguita sia già filtrata.

Per inserire dei parametri, esegui i seguenti passaggi.

• Accedi alla definizione della pagina e clicca sul componente Interactive Report.
• Premi il pulsante destro del mouse e seleziona Create Page Item.

• Il sistema ha creato un nuovo componente (item) di cui andremo a definire alcune proprietà

• Seleziona il Page Item e imposta le seguenti proprietà
  • Name: nome del campo da filtrare
  • Type: tipo di campo. Ad esempio Text Field
  • Label: il nome del campo che l’utente vede quando accede alla maschera
• Ovviamente puoi creare tutti i Page Item che vuoi e del tipo che preferisci (Popup LOV, Select List, Date Picker, ecc.)

• Dopo aver create tutti i Page Items che vuoi usare come parametri, clicca sull’Interactive Report.

• Nel tab delle proprietà, modifica la query aggiungendo le condizioni in base alle quali deve essere filtrata la ricerca.
• I parametri che devi inserire nella query devono chiamarsi come i Page Items

• Clicca sulla proprietà Page Items to Submit

• Seleziona i Page Items che devono essere dinamicamente passati alla query dell’Interactive Report

• Esegui la pagina per verificare il risultato.
  • Inserisci i parametri
  • Clicca il pulsante GO per eseguire la query

Come configurare un Interactive Report

In questo paragrafo vedremo quali sono le principali configurazioni che è bene tenere a mente quando lavori con un Interactive Report.

Di default, Oracle APEX crea un Interactive Report con praticamente tutte le opzioni più significative abilitate, per cui da parte tua potrebbe non essere necessario fare alcuna modifica.

Per modificare le proprietà di un Interactive Report, selezionalo della struttura della pagina clicca sul tab Attributes

Setup Search Bar

Da questa sezione potete specificare diverse opzioni:

• Include Search Bar: mostra/nascondi la barra di ricerca che include un campo di ricerca (Search Fields), il menù Actions e la possibilità di selezionare delle viste predefinite (Reports Select List). Se decidi di nasconderla tutte le opzioni successive verranno disattivate

• Search Field: mostra/nasconde il campo di ricerca
• Finder Drop Down: mostra/nasconde la ricerca per singolo campo

• Report Select List: mostra/nasconde la selezione delle viste predefinite

• Rows Per Page Selector: mostra/nasconde la selezione del numero di righe da visualizzare

• Search Button Label: personalizza la label del bottone di ricerca

• Maximum Rows Per Page: definisci qual è il numero massimo di righe visualizzabili alla volta

Setup Actions Menu

Tramite le configurazioni di questa sezione puoi abilitare le varie funzionalità che trovi disponibili sotto il menù Actions.

Vediamo insieme quali sono le funzionalità di maggior interesse

• Actions Menu: mostra/nascondi il bottone Actions
• Filter: mostra/nascondi l’opzione per creare dei filtri avanzati, che poi possono essere salvati in una vista privata

• Select Columns: abilita la possibilità di nascondere le colonne della griglia, utile per creare delle viste personalizzate

• Sort: abilita la possibilità di definire un ordinamento sui valori dei campi

• Control Break: permette di aggregare i dati in funzione di uno o più criteri di rottura, basati sui valori dai campi

• Highlight: abilita alla creazione di regole che colorano le righe in funzione di una condizione custom

• Compute: permette di definire delle colonne formula

• Aggregate: permette di mostrare dei valori aggregati

• Chart: permette di creare grafici

• Group By: permette di creare viste aggregate

• Pivot: permette di creare delle viste pivot

• Save Report: abilita l’utente a poter creare delle proprie viste personalizzate private

• Download: abilita la possibilità di scaricare in diversi formati (XLS, CSV, ecc.) i dati del report

Setup Download

In questa sezione puoi stabilire in quali formati (tra quelli previsti) è possibile scaricare localmente i dati (purché sia stata abilitata la relativa Action)

Inoltre potete definire come deve chiamarsi il file che viene prodotto.

Come usare un Interactive Report

Adesso ti mostrerò le principali funzionalità di un Interactive Report.

Conoscere queste caratteristiche è, secondo me, molto utile perché, come scoprirai, permettono a ciascun utente di personalizzare e salvare tutte le viste private che desiderano.

Per chi sviluppa applicazioni questo aspetto è decisivo perché molto probabilmente molte delle richieste di personalizzazione che gli utenti ti chiederanno sono già fornite out-of-the-box da Oracle APEX.

Per fare questo esercizio, utilizzerò una applicazione di demo che ho creato appositamente per questo tutorial.

Puoi accedere a questa applicazione da questo link.

Come creare filtri

Il Report Interattivo supporta la possibilità di applicare molto facilmente dei filtri ai dati che vengono visualizzati in diversi modi.

Metodo 1: filtri veloci

• Accedi al report
• Clicca sulla colonna per la quale vuoi impostare un filtro
• Seleziona il valore del filtro da applicare

• Il filtro viene applicato

• Cliccando su filtro è possibile modificare la condizione

• In generale puoi creare tutti i filtri che vuoi

Metodo 2: ricerca globale

• Accedi al report
• Scrivi nel campo di ricerca la stringa che vuoi cercare
• Premi il bottone per avviare la ricerca

• Il sistema crea un filtro che estrae tutte le righe che contengono nelle colonne di tipo testo la stringa che è stata inserita nella barra di ricerca

Metodo 3: menù Action

• Accedi al Report
• Clicca su Action
• Clicca su Filter

• Inserisci i parametri del filtro che desideri
• Premi il bottone Apply per applicarlo alla vista corrente

Come ordinare le colonne

Puoi ordinare i dati visualizzati dal Report Interattivo in 2 modi.

Metodo 1: ordinamento veloce

• Clicca sulla colonna che vuoi ordinare
• Seleziona il criterio di ordinamento

• Viene applicato l’ordinamento

Metodo 2: tramite il menù Action

• Clicca su Action -> Data -> Sort

• Applica i criteri di ordinamento che desideri
• Clicca su Apply

Come nascondere, mostrare e riordinare le colonne

Puoi creare le tue viste personalizzate nascondendo o riordinando le colonne come più preferisci.

• Clicca su Actions > Columns

• Seleziona le colonne da mostrare o da nascondere
• Seleziona il loro ordinamento
• Clicca su Apply

Come creare regole di formattazione condizionale

L’Interactive Report permette di creare delle regole di formattazione di righe e/o celle in funzione di una condizione personalizzata.

Questa funzionalità ricorda molto la formattazione condizionale di Excel.

Vediamo come fare.

• Clicca su Action > Format > Highlight

• Compila le informazioni richieste
  • Nome: nome alla regola di formattazione
  • Highlight Type: specifica se la regola agisce su tutta la riga o solo su una cella specifica
  • Background Color: colore di sfondo della riga
  • Text Color: colore del testo della riga
  • Highlight Condition: specifica la regola che fa scattare la condizione

Come creare un grafico

• Clicca su Action > Chart

• Seleziona il tipo di grafico che vuoi creare

• Inserisci i parametri per la formattazione del grafico

• Clicca su Apply

Come creare una Pivot

Oracle APEX da la possibilità di creare viste Pivot dei dati.

Facciamo un esempio pratico: voglio vedere all’interno di ciascun dipartimento, quanti dipendenti ci sono per ogni ruolo.

• Clicca su Actions > Pivot

Specifica i parametri per la costruzione della Pivot

• Pivot Columns: le informazioni che vuoi vedere in colonna.
• Row Columns: le informazioni che vuoi vedere in riga
• Function: quale funzione analitica applicare

• Clicca su Apply

Come creare una colonna formula

Puoi creare delle colonne formula che mostrano dei dati che vengono calcolati direttamente dal report con una formula custom che devi scrivere.

• Clicca su Action > Data > Compute

• Inserisci la formula che vuoi calcolare

• Clicca su Apply

Come aggiungere valori totali

Supponiamo di voler vedere lo stipendio medio mensile e annuale

• Clicca su Action > Data > Aggregate

• Inserisci i parametri per il calcolo

• Clicca su Apply

• Il sistema farà vedere alla fine della tabella (dopo l’ultima riga) i valori totali configurati.

Come aggiungere i valori sub totali

La funzione Aggregate permette di fare dei calcoli analitici su tutto il record set.

Tuttavia potrebbe essere interessante mostrare anche i sub-totali.

Vediamo come fare.

• Clicca su Action > Format > Control Break

• Specifica in funzione di quale campo applicare il criterio di rottura

• Clicca su Apply

Come salvare un report privato

Uno degli aspetti a mio avviso più interessanti dell’Interactive Report consiste nella possibilità di salvare le configurazioni alle viste (filtri, ordinamento, ecc.) che poi possono essere richiamate in un secondo momento senza doverle ricreare nuovamente

Oracle APEX ti da la possibilità di salvare tutte le viste private che vuoi.

Questo significa che puoi personalizzare i report in modi diversi in funzione delle tue esigenze e richiamare questi report tutte le volte che ti servono.

Come salvare un report

• Clicca su Action > Report > Save Report

• In funzione del tuo profilo (amministratore o utente finale) avrai la possibilità di salvare dei report pubblici, che poi saranno disponibili a tutti gli utenti della tua applicazione, oppure solo report privati.

• Dai un nome al report e clicca su Apply

Come richiamare un report

• Accedi all’Interactive Report.
• Seleziona dal menù a tendina il report che vuoi richiamare.

Come scaricare i dati in locale

L’ultima cosa che vediamo in questo tutorial è come scaricare in locale i dati.

• Clicca su Action > Download

• Seleziona il formato del file che vuoi generare e premi Download.