Nessun account? Il primo utente si crea da riga di comando con
bin/crea-utente-bi.php; gli altri da un AMMINISTRATORE
gia' autenticato (menu utente in alto).
Le dimensioni proposte sono quelle dei dati usati dagli oggetti di questo modulo. Il filtro si somma a quelli propri di ciascun oggetto e vale solo per gli oggetti che hanno quella dimensione: gli altri non cambiano e lo segnalano. Le KPI card non filtrano per dimensioni (hanno il proprio periodo o esercizio) e non sono toccate. Poi puoi salvarlo con "Salva vista".
Seleziona un modulo a sinistra, o creane uno nuovo.
Nuovo modulo
Salva come template
Il template è una copia del modulo senza tenant, disponibile per tutti i condomini. Dagli oggetti vengono tolti il tenant e i filtri a valore (esercizio, unità, fornitore…): nel nuovo modulo si reimpostano dalla barra dei filtri. Non scrivere dati di un condominio nel nome o nella descrizione.
Nuovo modulo da template
Il modulo nasce nel tenant (condominio) corrente, con te come proprietario.
Nuovo oggetto
La logaritmica aiuta quando i valori hanno ordini di grandezza molto diversi; i valori pari a zero o negativi non vengono disegnati.
Nei grafici impilati su scala logaritmica l'altezza di un segmento non è proporzionale al suo valore: leggi soprattutto il totale.
Per un condominio scegli il cubo da analizzare (spese, incassi, preventivo e consuntivo, saldi, riscaldamento, consumi).
Dati
Spunta i campi da mostrare (uno o più) e scegli una misura da calcolare.
Campi scelti (l'ordine conta)
La prima è quella principale: nei grafici a serie le dimensioni prima dell'ultima formano l'asse (l'ultima, le serie colorate), nelle griglie la colonna più a sinistra. Usa le frecce per cambiare l'ordine.
Filtri (opzionali, tutti applicati)
Confronta quanto è stato fatto con ciò che era previsto. Contratto e budget si leggono dall'applicativo sorgente a ogni esecuzione della sorgente; il budget è quello dei ricavi collegati a un tipo di operatore.
Per il contratto con l'ATS di solito l'importo a carico dell'ente; per il budget l'importo da tariffa.
Persone con almeno una prestazione nell'anno (ognuna conta nel mese del primo accesso) e valore di accesso e tutoring maturato a scaglioni, confrontati con lo stesso mese dell'anno precedente e con la quota di tutoring assegnata nel contratto.
Embedding via iframe
Il link generato e' scoped a questo solo modulo, sola lettura, e distinto dalla tua chiave API: puo' essere incollato in un <iframe> di un sito esterno. Revocabile in ogni momento, indipendentemente dalla chiave API.
Il link viene mostrato una sola volta: copialo ora.
Notifica HTTP POST (firmata HMAC-SHA256, header X-Bi-Firma) quando lo stato di un KPI cambia rispetto all'ultima notifica. Verificato periodicamente da bin/verifica-webhook-kpi.php (da schedulare esternamente), mai in tempo reale.
Utenti
Account di login con cui accedere a questa Dashboard (uid+password). Al login viene generata al volo una chiave API con lo stesso ruolo/ambito, come per le chiavi create da bin/genera-api-key.php.
Import dati
Importato subito nello staging del DWH (validato riga per riga). Solo le colonne indicate come obbligatorie e i controlli di formato minimi (Fase 2) — per regole di qualita'/deduplica avanzate o pianificazione ricorrente, usa bin/registra-import-demo.php come riferimento da riga di comando. Per MySQL/ODBC la query deve essere un SELECT: nessuna scrittura sulla fonte primaria.
La query puo' leggere solo le tabelle e i campi esportabili del dizionario dati di questo applicativo (niente *: elenca le colonne).
Funzioni registrate
Dizionario dati
Ricerca su campi del DWH, KPI del Semantic Layer e funzioni di import (Data Catalog, Fase 2).
Tipo
Nome
Descrizione
Percorso dati (lineage)
Sorgente → Staging → DWH → KPI, per una funzione di import.
Sorgenti dati
Ogni installazione legge, in sola lettura, dal database di un applicativo (WelfarePro, ...) e alimenta il DWH sotto il suo tenant. I dati identificativi (codice fiscale) diventano uno pseudonimo prima di essere scritti; l'età è ridotta a fascia. Le prestazioni si rileggono su una finestra mobile e si riallineano a ogni esecuzione.
Minuscole, cifre, "-" e "_".
Gli utenti con ruoli non globali vedono solo il proprio tenant.
Cifrata a riposo, non viene mai mostrata.
La prima esecuzione può usare una finestra più ampia.
Richiede lo script bin/esegui-sorgenti-pianificate.php schedulato.
Che cosa contiene il database di ciascun applicativo e quanto è sensibile. Una tabella non "esportabile" non può essere letta da nessuna estrazione; un campo NON_ESPORTABILE non esce mai dalla sorgente. Le modifiche valgono subito e restano anche dopo un nuovo rilevamento dello schema.
Tabella
Area
Campi
Esportabile
Seleziona una tabella per vederne i campi.
Costruisci una query scegliendo da elenchi, senza scrivere SQL: il sistema ti guida su FROM, JOIN, SELECT, WHERE, GROUP BY e ORDER BY e ti mostra l'SQL che ne risulta. Vedi solo le tabelle e i campi che il dizionario dati rende esportabili; i campi sensibili (codice fiscale, data di nascita) si possono solo contare. La lettura è sempre in sola lettura sull'applicativo.
1. Da quale tabella parti? FROM
2. Vuoi collegare altre tabelle? JOIN
3. Quali colonne vuoi vedere? SELECTGROUP BY
Una colonna normale mostra il valore; con "Conta", "Somma"… il risultato si raggruppa da solo per le colonne normali.
4. Vuoi restringere i dati? WHERE
5. Ordine e numero di righe ORDER BYLIMIT
La tua query in SQL
Scegli una tabella per iniziare.
Dimensioni e misure del cubo
Le dimensioni sono i "per cosa" con cui si raggruppano e si filtrano i dati (per sesso, per prestazione, per tipo di contratto…). Qui dai a ciascuna un nome parlante e un gruppo, e ne aggiungi di nuove collegandole a una colonna del DWH. Il nome si vede ovunque (oggetti, filtri, intestazioni); il codice tecnico resta lo stesso, quindi rinominare non rompe nulla. Le dimensioni usate da oggetti o viste non si disattivano né si eliminano.
Nome parlante
Gruppo
Colonna del DWH
Uso
Attiva
Aggiungi una dimensione
Sono proposte solo le colonne descrittive delle tabelle della stella: identificativi, misure e il codice fiscale pseudonimizzato non si possono usare come dimensione.
Le misure sono i "cosa" che si calcola (importi, durata, numero di prestazioni, utenti distinti…). Qui dai a ciascuna un nome parlante, un gruppo e un'unità, e ne aggiungi di nuove con una definizione guidata, senza scrivere SQL. Il codice tecnico resta lo stesso, quindi rinominare non rompe gli oggetti già costruiti. Le misure usate da oggetti non si disattivano né si eliminano.
Nome parlante
Gruppo
Unità
Definizione
Uso
Attiva
Aggiungi una misura
Funzioni ammesse:
Le colonne proposte per somme e differenze sono solo quelle numeriche della tabella dei fatti; i conteggi dei valori distinti non mostrano mai i valori, solo quanti sono.
Avvisi KPI
KPI del mese corrente fuori soglia (stato ATTENZIONE o CRITICO), nel tuo ambito. Per notificare sistemi esterni su una transizione di stato, usa i Webhook KPI.
Dettaglio
Conferma
Report pianificati
Il PDF di un modulo viene generato alle scadenze indicate con i tuoi permessi di accesso (stessi filtri di tenant e mascheramenti della Dashboard) e consegnato sul canale scelto. La consegna periodica è eseguita da bin/invia-report-pianificati.php, da schedulare esternamente.
Solo i moduli che puoi modificare.
5 campi, un solo minuto fisso, frequenza minima oraria.
Fino a 20 indirizzi, separati da virgola. Richiede il server e-mail configurato.
Server di posta in uscita usato per la consegna dei report. La password è cifrata a riposo e non viene mai mostrata.
Salva vista
Salva i filtri attivi come vista personale: solo tu la vedi e la puoi richiamare, anche su un modulo condiviso.