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
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.
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.
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.
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": "..." } }
}
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.
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.
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.
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.
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.
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>"
}
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.
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.
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.
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"
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.
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.
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.
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.
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.
Dettaglio dei verdetti e delle note
| Verdetto | Significato |
|---|---|
confirmed | Il report corrispondente proposto è quello giusto |
corrected | Il corrispondente è un altro, indicato a mano |
rejected | Il candidato è sbagliato e l'equivalente è ancora da trovare |
absent | Verificato che in WhiteNet 12 un equivalente non esiste |
suspended | Sospeso: 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".
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.
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.
I sei stati e la regola che li assegna
| Colore | Significato | Palla a |
|---|---|---|
| Bianco | Nessuno ha ancora guardato il report: manca l'analisi | Analisi |
| Giallo | L'analisi c'è, manca la verifica di prodotto | Verifica di prodotto |
| Verde | Verificato e firmato, colonne comprese | Cliente |
| Rosso | Nessun equivalente trovato nella 12 | Nessuno |
| Blu | Sospeso: serve una risposta del cliente | Cliente |
| Nero | Sospeso: report non utilizzato dal cliente | Nessuno |
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.
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.
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.