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.0Panoramica
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
- Scegli il file da controllare: il separatore viene riconosciuto da solo.
- Scegli le regole: un set dell’archivio oppure un file CSV di regole.
- Premi Valida: si apre la tabella dei risultati, con gli errori evidenziati.
Dalla tabella puoi anche correggere le celle e salvare il file.
🔍 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.
1Il file da controllare
- Premi Sfoglia… accanto a File CSV da validare.
- Il programma legge le prime righe e riconosce il separatore (virgola, punto e virgola o tab). Controllalo e, se è sbagliato, cambialo a mano.
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.
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
| Azione | Come |
|---|---|
| Modificare una cella | Doppio clic, F2, Invio o digitare |
| Confermare / annullare | Invio (passa alla riga sotto) / Esc |
| Incollare un blocco | Ctrl+V |
| Svuotare le celle | Canc |
| Annullare | Ctrl+Z o Annulla modifica |
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.
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.
1Le colonne della tabella
| Colonna | Significato |
|---|---|
| # | Numero della regola; si applicano in quest’ordine |
| Colonna | Nome della colonna del file dati, come nell’intestazione |
| Tipo | Tipo di controllo (vedi sotto) |
| Confronto | Operatore, solo per il tipo Lunghezza |
| Dato | Valore di riferimento del controllo |
| Su / Giù | Sposta la regola di una posizione |
| Elimina | Rimuove la regola |
Tipi di controllo
| Tipo | Sigla | Il valore è corretto se… | Esempio |
|---|---|---|---|
| Lunghezza | L | la sua lunghezza rispetta il confronto (< <= = >= >) con il numero indicato | = e 16 per un codice fiscale |
| Regular expression | R | corrisponde all’espressione regolare | ^[0-9]{5}$ per un CAP |
| Scelta | S | è uno dei valori del dato, separati da | | A|B|C |
| Scelta IgnoreCase | SI | come Scelta, senza distinguere maiuscole e minuscole | a = A |
| Uguale | U | è uguale al dato | IT |
| Uguale IgnoreCase | UI | come Uguale, senza distinguere maiuscole e minuscole | it = IT |
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.