Documento Metodo di analisi Progetto WhiteNet 11 to 12 Aggiornato 25/09/2026 Stato In uso

Come funziona l'analisi dei report

Questo documento spiega, fase per fase, come viene costruito il confronto fra i report di prodotto di WhiteNet 11 e quelli di WhiteNet 12: da dove vengono i dati, cosa decide una macchina, cosa decide una persona e dove il metodo ha dei limiti dichiarati. Ogni fase ha un riassunto breve; il dettaglio con il codice si apre cliccando.

Torna al documento di analisi
331
Report WN11 in esame
137
Report WN12 censiti
2258
Card tecniche estratte
115
Confronti colonne svolti
154
Report rilevati in uso

In due parole

Il confronto fra le due versioni non si può fare leggendo due elenchi di nomi, perché i report sono costruiti in modo diverso: in WhiteNet 11 vivono a database, in WhiteNet 12 vivono nel codice sorgente. Il metodo ricostruisce quindi una scheda tecnica per ogni report delle due versioni, le accosta con un modello linguistico e sottopone ogni accostamento al giudizio di una persona che conosce la piattaforma.

La macchina propone e ordina il lavoro, la persona decide. Il colore che compare nel documento indica a chi è la palla in quel momento: è una misura di avanzamento, non di fiducia del sistema.

Le fasi

01

L'elenco dei report WN11

Il punto di partenza è l'elenco fornito dal cliente: 331 report di prodotto, ciascuno con nome, area funzionale e percorso di menu. È il perimetro di tutto il lavoro: nessun report entra o esce dall'analisi senza passare da qui.

IN elenco del cliente  ·  OUT 331 voci con nome, area, percorso
Dettaglio

Le voci vengono normalizzate e conservate in forma strutturata. Ogni riga dell'analisi nasce da una di queste e ne porta i tre campi originali per tutta la lavorazione, in modo che il nome mostrato al cliente resti sempre quello che il cliente conosce.

{
  "wn11_name": "Totali ore periodo corrente",
  "wn11_area": "Fogli presenze",
  "wn11_path": "Risorse Umane > Presenze e spese > Report"
}

I nomi possono ripetersi: lo stesso titolo compare in punti di menu diversi. Sono report distinti e vanno tenuti distinti, e il percorso è l'unica cosa che li separa.

02

Le schede tecniche WN11

Per capire cosa fa davvero un report della 11 non basta il nome: serve la sua definizione. Viene letta dal database, dove ogni report di prodotto è profilato con la query che lo alimenta, le viste che interroga, i filtri di ricerca, le colonne in uscita e le voci di menu che lo richiamano. Ne escono 2258 schede.

IN profili a database WN11  ·  OUT 2258 schede tecniche
Dettaglio e struttura di una scheda

Ogni scheda tiene insieme il lato funzionale (come si chiama, dove sta nei menu) e il lato tecnico (da dove prende i dati). È questa doppia natura a rendere possibile l'accostamento successivo.

{
  "profile":       "FORMRECORDSETVIEWER WN_W_CON_PREST_TOT_CAUS_PERIODO_CORR",
  "caption":       "Totali ore periodo corrente",
  "menu_paths":    [ { "menu": "...", "label": "..." } ],
  "all_tables":    [ "WN_T_CON_PREST", "WN_T_CLI_TES", ... ],
  "search_fields": "C_FILAPP_COD|LOOKUP, C_PERIODO|MANDATORY, ...",
  "result_fields": "PREST.C_LAV_COGNOME, ... , N_MARGINEMARKUP, ...",
  "sql_sections":  { "MAIN": { "select": "...", "from": "...", "where": "..." } }
}
Una cosa che è andata storta e poi è stata corretta. Nella prima versione dell'estrazione la definizione veniva troncata a 500 caratteri: i report con molte colonne arrivavano all'analisi con un elenco incompleto, e il confronto risultava più povero del vero. Corretto il 28/07/2026 e tutte le schede sono state riestratte.
03

L'elenco dei report WN12

In WhiteNet 12 i report non stanno a database ma nel codice: ciascuno è descritto da un profilo che dichiara il nome tecnico, il servizio che lo serve, l'area e l'elenco delle colonne della griglia dei risultati con le rispettive etichette. Da qui nascono i 137 report censiti.

IN profili del codice WN12  ·  OUT 137 report con colonne ed etichette
Dettaglio e come si legge un profilo

Di ogni profilo si leggono le colonne dei risultati, non i filtri: sono quelle che l'utente vede nella griglia. Per ogni colonna si prendono il nome tecnico del campo e l'etichetta italiana predefinita.

def wn12_columns(profile_path):
    """Colonne della griglia risultati WN12 (search.columns), non i filtri."""
    d = json.loads(Path(profile_path).read_text(encoding='utf-8-sig'))
    cols = (d.get('search') or {}).get('columns') or []
    return [{'field': c.get('fieldName'),
             'label': ((c.get('label') or {}).get('default') or '').lstrip('*').strip()}
            for c in cols]

Esempio reale di due colonne dichiarate in un profilo della 12:

{"fieldName": "effectMarg",     "label": {"key": "reportHourTotal-MARGIN",      "default": "*Margine"}}
{"fieldName": "effectMargPerc", "label": {"key": "causes-EFFECT_MARG_PERC",     "default": "*Margine effettivo (%)"}}

L'asterisco iniziale è una convenzione del sistema e viene rimosso.

04

Aggancio fra report ed elenco tecnico

Il nome che il cliente usa e la denominazione tecnica interna non coincidono quasi mai. Ogni voce dell'elenco viene quindi agganciata alla propria scheda confrontando il nome con la denominazione della scheda e con le etichette dei menu, e tenendo il punteggio di somiglianza più alto.

IN 331 voci + 2258 schede  ·  OUT voce agganciata alla scheda, con punteggio
Dettaglio del criterio di somiglianza
def find_best_card(wn11_name, cards):
    """Trova la scheda tecnica piu' simile per denominazione o voce di menu."""
    best_score, best_card = 0, None
    for card in cards:
        if card.get("caption"):
            s = fuzzy_score(wn11_name, card["caption"])
            if s > best_score: best_score, best_card = s, card
        for mp in card.get("menu_paths", []):
            s = fuzzy_score(wn11_name, mp.get("label", ""))
            if s > best_score: best_score, best_card = s, card
    return best_card, best_score

Il punteggio resta attaccato alla riga per tutta la lavorazione: un aggancio debole è un segnale che tutto quello che viene dopo va guardato con più attenzione, perché poggia su una scheda che potrebbe non essere quella giusta.

05

Accostamento semantico fra i report

Per ogni report della 11 viene costruita una descrizione che mette insieme nome, area, percorso, viste interrogate, filtri e colonne principali. Questa descrizione e l'elenco completo dei report della 12 vengono sottoposti a un modello linguistico, che indica quale report della 12 corrisponde, con quanta fiducia e per quale ragione.

IN descrizione WN11 + elenco WN12  ·  OUT candidato, fiducia, motivazione
Dettaglio, glossario di dominio e forma della risposta

Al modello viene dato un glossario del dominio: distinguere un contratto di somministrazione da un contratto di prestazione, per esempio, non si deduce dal nome.

GLOSSARIO DOMINIO — APL (Agenzia per il Lavoro Temporaneo):
- SupplyContract (WN12) = Contratto di SOMMINISTRAZIONE con il cliente
- ProvContract  (WN12) = Contratto di PRESTAZIONE (singola missione del lavoratore)
- Supply e Prov sono entita' separate in WN12. Non confonderle.
- "Listino" / "tariffe" -> condizioni economiche del contratto di somministrazione
- Area "invoicing" = solo fatturazione (non gestione contratti)

La risposta ha una forma fissa e volutamente povera: un candidato, un numero, una frase.

{
  "match_idx":  <numero del report WN12, oppure null>,
  "confidence": <0.0 - 1.0>,
  "reasoning":  "<una frase breve in italiano>"
}
Cosa significa quel numero. È la fiducia che il modello dichiara sulla propria conclusione, non la percentuale di colonne ritrovate e nemmeno una misura di somiglianza fra i due report. Un valore alto senza report corrispondente significa che il modello è convinto che in WhiteNet 12 quel report non esista.
06

Soglia e pulizia

Gli accostamenti vengono filtrati con una regola dichiarata: vale come candidato solo chi ha un report della 12 indicato e una fiducia pari o superiore a 0,75. Chi resta senza candidato viene marcato come assenza da verificare, non come errore.

IN accostamenti grezzi  ·  OUT 197 con candidato, 37 deboli, 97 senza
Dettaglio della regola
positivo = candidato WN12 presente AND confidence >= 0.75
senza candidato -> no_match

La soglia è una scelta di prudenza: preferisce dichiarare un'assenza da verificare piuttosto che proporre un accostamento fragile. Un'assenza sbagliata costa una verifica in più; un accostamento sbagliato dato per buono costa una decisione sbagliata a valle.

07

I nomi leggibili delle colonne

Le colonne della 11 hanno nomi tecnici abbreviati; quelle della 12 hanno etichette italiane già pronte. Per poter confrontare due elenchi comparabili, i nomi tecnici della 11 vengono tradotti usando le descrizioni registrate a database, con una copertura del 79% sulle colonne che entrano in analisi.

IN nomi tecnici WN11  ·  OUT etichette italiane, dove disponibili
Dettaglio, e cosa succede dove la traduzione manca

La stessa sigla può avere descrizioni diverse in tabelle diverse: la traduzione viene quindi cercata prima fra le tabelle effettivamente usate da quel report, e solo dopo in forma generale.

N_PAG_COD_CCNL   in WN_T_EXPORT_PAGHE_PREST   ->  "Codice paghe ccnl"
C_CLI_CCNL       in WN_T_CLI_TES              ->  "CCNL cliente"
C_CCNL_DES       in WN_T_COSTIRICAVIPAGHE     ->  "Descrizione CCNL"
Dove la descrizione non esiste, il nome mostrato viene ricostruito dalla sigla e può risultare poco comprensibile. È un limite noto e visibile: un nome che sembra storpiato indica una colonna priva di descrizione a database, non un errore di analisi.
08

Il confronto colonna per colonna

Per i report con un candidato si confrontano le colonne in uscita delle due versioni. Il risultato ha tre blocchi: colonne appaiate, colonne della 11 non ritrovate nella 12, colonne presenti solo nella 12. La corrispondenza è molti a molti, perché due colonne della 11 possono confluire in una sola della 12 e viceversa.

IN colonne delle due versioni  ·  OUT 115 confronti a tre blocchi
Dettaglio: da dove vengono le colonne, cosa si chiede al modello

Le colonne della 11

La fonte principale è l'elenco delle colonne della griglia. Dove non è valorizzato, si ricorre in ordine alle varianti per tipo di gestione e infine alle colonne estratte dalla query.

"""Colonne in uscita del report WN11, ripulite dagli alias di tabella.

`ResultFields` e' la scelta di visualizzazione della griglia; su ~45 schede su 331
non e' valorizzata. In quel caso le colonne ci sono lo stesso, altrove:
  1. varianti per gestione — ResultFieldsNewGest/OldGest/CDC1/NOCDC1: si prende
     l'unione, ogni gestione vede il suo sottoinsieme;
  2. SELECT della query MAIN — se non c'e' nessuna ResultFields*, la griglia
     mostra le colonne estratte dalla query."""

Una colonna calcolata resta intera: la virgola dentro una funzione non la spezza.

def split_top_level(s):
    """Spezza su virgola ignorando quelle dentro parentesi o apici.
    Serve per la SELECT: DECODE(N_X,0,'a',1,'b') e' UNA colonna, non cinque."""

La richiesta al modello

"Sei un analista di migrazione dati. Confronti le colonne di un report legacy
 con le colonne di un report nuovo. Devi dire quali colonne legacy hanno un
 equivalente nel nuovo e quali no. Sii conservativo: se non sei sicuro che due
 colonne indichino lo stesso dato, marcala come incerta, non come coperta.
 Attenzione ai falsi amici (es. 'partita IVA' vs 'partita IVA intermediaria'
 NON sono la stessa cosa)."

E la regola del molti a molti, dichiarata esplicitamente:

La corrispondenza e' MOLTI A MOLTI: emetti una coppia per ogni legame reale.
- piu' colonne WN11 su una sola WN12: cognome e nome che nella 12 sono un campo
  unico "Lavoratore" -> due coppie, entrambe con wn12 "Lavoratore".
- una colonna WN11 su piu' WN12: un "contratto" che nella 12 e' spezzato in
  "Id contratto" e "Titolo contratto" -> due coppie, entrambe con wn11 "C_CONTRATTO".
Ogni colonna WN11 deve comparire almeno una volta: in "mappate" oppure in
"assenti". Mai in entrambe.

La forma del risultato

{
 "mappate": [{"wn11":"C_X","wn12":"Etichetta","confidenza":"alta|media|bassa","nota":""}],
 "assenti": [{"wn11":"C_Y","perche":"breve motivo"}],
 "in_piu":  [{"wn12":"Etichetta","nota":"colonna nuova senza corrispondente in 11"}]
}

Le coppie vengono poi raggruppate: quando più colonne sono legate fra loro, la tabella mostra il gruppo intero invece di dieci righe separate. Se la risposta del modello risulta incompleta o non interpretabile, il confronto non viene salvato: meglio nessun confronto che un confronto vuoto spacciato per fatto.

Attenzione a come si legge un raggruppamento. Se tre colonne della 11 risultano legate alla stessa colonna della 12, questo significa che i tre nomi sono stati ricondotti a quella colonna, non che quella colonna contenga i tre dati. È una distinzione sostanziale e va verificata caso per caso.
09

L'utilizzo reale

Il cliente rileva periodicamente quali report vengono aperti e quante volte. Questi dati vengono integrati nell'analisi: servono a distinguere i report vivi da quelli che esistono ma nessuno usa, e quindi a decidere dove vale la pena spendere la verifica. Ultima finestra: 30/06 - 23/09, 154 report rilevati, 124 già presenti in analisi.

IN rilevazioni del cliente  ·  OUT marcatura "in uso" e numero di accessi
Dettaglio: perché le rilevazioni si sommano e non si sostituiscono
"""Prima si prendeva solo il piu' recente, dando per scontato che ogni export
fosse cumulativo. Non lo e': quello "dal 30-06 al 04-08" ha 122 report e 3589
utilizzi contro i 278 e 7515 di quello che finisce il 20/07, e sui report in
comune i conteggi CALANO. Prendendo solo l'ultimo il perimetro "in uso" e'
passato da 207 righe a 106, buttando via 163 report che il cliente aveva usato
davvero. Un report usato a luglio resta usato: si uniscono, e per ogni report
vale il conteggio piu' alto visto."""

L'aggancio avviene sul codice tecnico della vista, non sul nome, perché è l'unico identificatore stabile fra la rilevazione e l'analisi. I report rilevati che non compaiono nell'elenco iniziale vengono contati a parte e dichiarati: sono report usati che il perimetro non copre.

10

Il giudizio umano

Nessun risultato prodotto fin qui è definitivo finché una persona che conosce entrambe le versioni non lo firma. Il verdetto, l'eventuale correzione del report corrispondente, le note di riga e di singola colonna vengono scritti direttamente sul documento e valgono più di qualunque conclusione automatica.

IN analisi proposta  ·  OUT verdetto, correzioni, note
Dettaglio dei verdetti e delle note
VerdettoSignificato
confirmedIl report corrispondente proposto è quello giusto
correctedIl corrispondente è un altro, indicato a mano
rejectedIl candidato è sbagliato e l'equivalente è ancora da trovare
absentVerificato che in WhiteNet 12 un equivalente non esiste
suspendedSospeso: non utilizzato dal cliente, oppure in attesa di una sua risposta

Accanto al verdetto esiste una firma separata sulla verifica delle colonne. Le due cose sono distinte perché rispondono a due domande diverse: "è il report giusto" e "le colonne sono state controllate una per una".

Perché sono separate. Fino ad agosto bastava che il confronto colonne esistesse perché una riga risultasse verificata. Ma generato non vuol dire controllato: la firma è stata resa esplicita proprio su segnalazione di chi svolge la verifica.

Le note sono interne per impostazione predefinita. Solo la parte che segue un marcatore esplicito entra nel documento destinato al cliente, copiata parola per parola, senza riscritture.

11

Il semaforo: chi ha la palla

Ogni riga del documento ha un colore, e quel colore indica a chi tocca la mossa successiva. È la chiave di lettura dell'intero documento.

IN verdetto + confronto colonne + firma  ·  OUT sei stati
I sei stati e la regola che li assegna
ColoreSignificatoPalla a
BiancoNessuno ha ancora guardato il report: manca l'analisiAnalisi
GialloL'analisi c'è, manca la verifica di prodottoVerifica di prodotto
VerdeVerificato e firmato, colonne compreseCliente
RossoNessun equivalente trovato nella 12Nessuno
BluSospeso: serve una risposta del clienteCliente
NeroSospeso: report non utilizzato dal clienteNessuno
def semaforo(x):
    v = human_verdict(x)
    if v == "suspended":
        return "nero" if motivo == "unused" else "blu"
    if v in ("rejected", "absent") or x.get("match_status") == "no_match":
        return "rosso"
    if v in ("confirmed", "corrected"):
        return "verde" if (colonne_confrontate and firmato) else "giallo"
    return "giallo" if colonne_confrontate else "bianco"

Il verde richiede entrambe le condizioni: il verdetto sul report e la firma sulle colonne. È lo stato più costoso da raggiungere e l'unico che comunica al cliente che quella riga è pronta per il suo controllo.

12

Pubblicazione e revisioni

Il documento che il cliente legge viene rigenerato a ogni pubblicazione a partire dai dati e dalle note del momento. Ogni versione resta archiviata e si può tornare indietro; ogni pubblicazione viene collaudata prima di sostituire quella in linea.

IN dati + note  ·  OUT documento, con storico delle revisioni
Dettaglio del collaudo

Prima di ogni sostituzione si verifica che la pagina si disegni davvero: numero di righe atteso e nessun errore nel browser. Il controllo esiste perché una pagina può essere servita correttamente e non mostrare nulla, e il solo codice di risposta del server non se ne accorge.

revisione 20260923-084700-giobi-update.html
331 righe · 0 errori JS · confronto riga per riga con la versione precedente

Prima di modificare i dati viene sempre presa una copia di sicurezza, e ogni modifica manuale lascia una traccia con la data e il motivo.

Limiti dichiarati del metodo

Sono limiti di costruzione, non difetti da correggere: conoscerli serve a leggere il documento per quello che è.

Il confronto è sui nomi, non sui valori

Le colonne vengono accostate confrontando come si chiamano e cosa rappresentano, non i dati che contengono. Non esiste un ambiente in cui gli stessi record esistano nelle due versioni con una chiave comune, quindi nessun numero viene messo a confronto con un altro numero.

Un nome uguale non garantisce lo stesso dato

Una colonna può chiamarsi allo stesso modo nelle due versioni e nascere da campi diversi. È accaduto su una colonna «Margine», dove la 11 mostra alternativamente margine o ricarico a seconda di un parametro di configurazione mentre la 12 tiene i due valori separati. Casi del genere si riconoscono solo leggendo la definizione del dato, ed è la ragione per cui la verifica umana non è sostituibile.

Non tutti i report hanno il confronto colonne

Il confronto richiede un candidato nella 12 e il profilo corrispondente. Dove il profilo non è disponibile nella versione in nostro possesso, il confronto non viene prodotto e la riga lo dichiara.

I filtri di ricerca non sono confrontati

L'analisi riguarda le colonne della griglia dei risultati. I campi della maschera di ricerca non rientrano nel confronto.

Il materiale della 12 è una versione di riferimento

I profili e le etichette provengono da un ambiente dimostrativo. Un report introdotto in una versione successiva può essere presente nei menu e assente fra i profili disponibili: in quel caso il report viene riconosciuto ma le sue colonne non sono confrontabili finché non arriva il materiale aggiornato.

Come leggere il risultato

L'automazione copre la parte che nessuno potrebbe fare a mano su 331 report: ricostruire le definizioni, accostarle e mettere in fila il lavoro. Alla persona resta il passaggio che decide l'esito, cioè stabilire se due colonne che si chiamano allo stesso modo contengono davvero lo stesso dato.

Il colore di ogni riga dice a che punto è quel passaggio. Fra un documento pieno di verdi e uno pieno di gialli cambia quanta verifica umana è già stata fatta, non quanto è accurata l'analisi che ci sta sotto.