CSV Val Ed GUI

CSV Val Ed – Guida illustrata

Guida illustrata a CSV Val Ed

Controlla i file CSV con le tue regole, trova le celle sbagliate a colpo d’occhio, correggile e salva. Cosa fa, come si usa e cosa fare se qualcosa non torna.

Windows · LinuxNessuna installazioneVersione 0.6.0

Panoramica

CSV Val Ed verifica un file CSV secondo un insieme di regole: lunghezza dei campi, formato (espressione regolare), valori ammessi e uguaglianza. Le regole si scrivono nel Generatore oppure si caricano da un file; quelle usate più spesso si salvano nell’archivio interno.

1Tre passi

  1. Scegli il file da controllare: il separatore viene riconosciuto da solo.
  2. Scegli le regole: un set dell’archivio oppure un file CSV di regole.
  3. Premi Valida: si apre la tabella dei risultati, con gli errori evidenziati.

Dalla tabella puoi anche correggere le celle e salvare il file.

File CSVdati da controllare Regolearchivio o file CSV Risultaticelle in rosso, correzioni
Dal file ai risultati

🔍 Separatore automatico

Riconosce virgola, punto e virgola o tab leggendo le prime righe.

📏 Sei tipi di controllo

Lunghezza, espressione regolare, scelta, uguale, con o senza distinzione tra maiuscole.

🟥 Errori evidenziati

Tabella in stile foglio di calcolo, con salto da un errore all’altro.

✏️ Correzione sul posto

Modifica, incolla, annulla: gli errori si ricalcolano subito.

💾 Salvataggio fedele

Mantiene separatore, codifica UTF-8 e tipo di fine riga.

🗄️ Archivio dei set

Le regole più usate restano salvate e si ricaricano in un clic.

Avvio

Non serve installare nulla: avvia CSV Val Ed.exe (Windows) oppure installa il pacchetto Linux. La finestra ha tre schede.

Validazione

Sceglie il file da controllare e le regole, poi avvia il controllo.

Generatore regole

Crea, modifica e salva i set di regole.

Impostazioni

Dimensione del testo dell’interfaccia.

Validazione

La prima scheda: scegli il file, scegli le regole, premi Valida.

Validazione Generatore regoleImpostazioni File CSV da validare C:\dati\clienti.csv Sfoglia… Separatore: ; , tab riconosciuto dal file Regole Archivio File Set di regoleAnagrafica clienti▾ Ricorda questa scelta all’avvio Valida ✔ Controllo eseguito: 12 errori ⚠ Colonna “Telefono” non presente nel file dati: regola ignorata
La scheda Validazione (dati di esempio)

1Il file da controllare

  1. Premi Sfoglia… accanto a File CSV da validare.
  2. Il programma legge le prime righe e riconosce il separatore (virgola, punto e virgola o tab). Controllalo e, se è sbagliato, cambialo a mano.
La prima riga del file deve contenere le intestazioni. I nomi delle colonne si confrontano con quelli delle regole senza distinguere maiuscole e minuscole.

2Le regole

Due sorgenti possibili:

  • Archivio: scegli un set salvato dalla tendina Set di regole. Se è vuota, creane uno nel Generatore.
  • File: scegli un file CSV di regole, senza intestazione. Anche qui il separatore (virgola o punto e virgola) è riconosciuto da solo.

3Valida

Il pulsante Valida si attiva quando file dati, separatore e regole sono scelti. Il controllo parte solo da qui: se cambi qualcosa, i risultati precedenti vengono scartati e va premuto di nuovo.

Si apre la schermata dei risultati. Nella finestra principale restano il messaggio di stato (verde se tutto è andato bene, rosso in caso di errore) e gli avvisi arancioni, per esempio una colonna delle regole assente nel file (la regola viene ignorata). Apri la tabella dei risultati la riapre dopo la chiusura.

Ricordare la scelta

La casella Ricorda questa scelta all’avvio salva la sorgente delle regole e i separatori, e li ripristina al prossimo avvio. Il file dati non viene mai ricordato: va scelto ogni volta. Se il file di regole ricordato non esiste più compare un avviso e la scelta resta salvata. Disattivando la casella la scelta viene cancellata.

La schermata dei risultati

Tutto il file in una tabella in stile foglio di calcolo, con le intestazioni in alto e il numero di riga a sinistra (la riga 1 è l’intestazione).

1Gli errori

  • Le celle che violano le regole sono rosse; quella dell’errore corrente è arancione con un bordo.
  • La barra in alto mostra Errore 3 di 12, le frecce ◀ ▶ e il dettaglio: riga, colonna, valore e motivo. La tabella scorre fino alla cella.
  • Scorciatoie: F3 successivo, Maiusc+F3 precedente.
  • Passando il mouse su una cella rossa compare il motivo.
← Chiudi Errore 3 di 12 ◀ ▶ Riga 6 · CAP · “1234A” · non rispetta ^[0-9]{5}$ ● Salva #NomeCAPPaeseCodice fiscale 2Rossi20100ITRSSMRA80A01H501U 3Bianchi00184ITBNCLRA75C41F205Z 4Verdi10121FRVRDGPP70B12L219X 5Neri50123ITNRENNA90D55 6Gialli1234AITGLLLCU85M10H501Q 7Blu40121XXBLUMRC82T05A944K NRENNA90D55 1234A XX Rosso = non valida · Arancione = errore corrente
La tabella dei risultati (dati di esempio)

2Selezione e copia

  • Clic e trascina per un blocco di celle; Maiusc+clic estende la selezione.
  • Clic su un’intestazione = colonna; clic su un numero di riga = riga; Ctrl+A = tutto.
  • Ctrl+C copia con tab tra le celle: incolla direttamente in Excel.

Modifica dei dati

AzioneCome
Modificare una cellaDoppio clic, F2, Invio o digitare
Confermare / annullareInvio (passa alla riga sotto) / Esc
Incollare un bloccoCtrl+V
Svuotare le celleCanc
AnnullareCtrl+Z o Annulla modifica
Dopo ogni modifica gli errori vengono ricalcolati: il contatore si aggiorna e le celle corrette tornano normali. Le intestazioni non si modificano, perché le regole le usano per riconoscere le colonne.

3Salvare

  • Salva sovrascrive il file aperto; Salva con nome… scrive un altro file, che diventa il file di lavoro. Un punto accanto al nome indica modifiche non salvate.
  • Si conservano separatore, codifica UTF-8 (con eventuale BOM) e tipo di fine riga. Le virgolette tornano solo dove servono: un file che aveva tutti i campi tra virgolette viene riscritto senza.
Se il file originale non era in UTF-8, i caratteri illeggibili sono già stati sostituiti in lettura e il salvataggio lo converte in UTF-8; la barra superiore lo segnala. Usa Salva con nome… per non perdere l’originale.

4Chiudere

← Chiudi (o Esc) torna alla finestra principale. Con modifiche non salvate il programma chiede se salvarle, scartarle o annullare la chiusura.

Generatore regole

Ogni riga della tabella è una regola, applicata nell’ordine in cui è scritta.

#ColonnaTipoConfrontoDatoSu / GiùElimina 1CAPRegular expression^[0-9]{5}$▲ ▼✕ 2Codice fiscaleLunghezza=16▲ ▼✕ 3PaeseScelta IgnoreCaseIT|FR|DE▲ ▼✕ Nome del setAnagrafica clienti Salva nell’archivio Carica dall’archivio… Nuovo set Importa CSV… Esporta CSV… Dati di esempio
La scheda Generatore regole

1Le colonne della tabella

ColonnaSignificato
#Numero della regola; si applicano in quest’ordine
ColonnaNome della colonna del file dati, come nell’intestazione
TipoTipo di controllo (vedi sotto)
ConfrontoOperatore, solo per il tipo Lunghezza
DatoValore di riferimento del controllo
Su / GiùSposta la regola di una posizione
EliminaRimuove la regola

Tipi di controllo

TipoSiglaIl valore è corretto se…Esempio
LunghezzaLla sua lunghezza rispetta il confronto (< <= = >= >) con il numero indicato= e 16 per un codice fiscale
Regular expressionRcorrisponde all’espressione regolare^[0-9]{5}$ per un CAP
SceltaSè uno dei valori del dato, separati da |A|B|C
Scelta IgnoreCaseSIcome Scelta, senza distinguere maiuscole e minuscolea = A
UgualeUè uguale al datoIT
Uguale IgnoreCaseUIcome Uguale, senza distinguere maiuscole e minuscoleit = IT
Nella tendina il tipo ha il nome esteso; nei file di regole si usa la sigla.

Gestire i set

Carica dall’archivio…

Apre un set salvato per modificarlo.

Nuovo set

Svuota la tabella per ricominciare.

Salva nell’archivio

Salva con il Nome del set. Se il nome esiste già, il set viene sovrascritto.

Elimina dall’archivio

Cancella il set indicato dal nome.

Importa / Esporta CSV…

Legge e scrive il set come file CSV, con il separatore scelto in Separatore CSV. Formato: nome colonna, tipo, confronto, dato, senza intestazione.

Esempio di file di regole (separatore ;):

CAP;R;;^[0-9]{5}$
Codice fiscale;L;=;16
Paese;SI;;IT|FR|DE

Impostazioni

Per ora c’è una sola opzione, ma utile.

🔎 Zoom

Ingrandisce o riduce testo, campi e pulsanti, da 80% a 200%. Usa il cursore oppure i valori predefiniti 100%, 125%, 150% e 200%. La scelta viene ricordata all’avvio.

Dove sono salvati i dati

L’archivio dei set e le impostazioni stanno in un unico file.

%APPDATA%\csvvaled\csvvaled.db

Per fare una copia di sicurezza dei set, copia questo file. Se l’archivio non si può aprire, il programma continua a funzionare usando solo i file di regole e lo segnala nella barra di stato.

Problemi comuni

«Archivio vuoto»

Non hai ancora salvato nessun set. Creane uno nel Generatore regole.

«Colonna … non presente nel file dati»

Il nome nelle regole non corrisponde all’intestazione del file. Controlla l’ortografia.

«Separatore»

Il file non si legge con il separatore scelto, oppure il riconoscimento ha sbagliato. Prova gli altri.

Errori di lunghezza o formato

La cella è evidenziata nella schermata dei risultati e il motivo compare nella barra in alto.

Caratteri strani dopo il salvataggio

Il file originale non era in UTF-8 (per esempio Windows-1252). Usa Salva con nome… per non sovrascrivere l’originale.

CSV Val Ed · v0.6.0 · BPF — bertolottipf.it. Le illustrazioni sono schematiche, con dati di esempio. Clicca su un’immagine per ingrandirla.