Validare CSV con uno schema di colonne e trovare gli errori

Questo validatore confronta l’intestazione con le colonne esatte attese da Lei, quindi esamina ogni riga con regole esplicite per stringhe, numeri, interi, booleani e date ISO. Invece di fermarsi alla prima cella errata, restituisce l’elenco completo delle violazioni con numeri di riga e nomi di colonna. Può eseguirlo gratuitamente nel browser oppure usare l’API al costo di $0.002 per richiesta in un flusso automatizzato.

Definisca il contratto prima di controllare il file

Descriva ogni colonna attesa tramite tre proprietà: nome esatto, tipo e obbligatorietà. L’ordine è importante perché i dati CSV sono posizionali; un’intestazione nome,id non è intercambiabile in sicurezza con id,nome, anche se entrambe contengono gli stessi nomi. Il validatore confronta quindi l’intera intestazione con lo schema prima di esaminare le righe. Una colonna mancante, aggiuntiva, rinominata, duplicata o riordinata genera un errore di input anziché un report fuorviante. I tipi supportati sono string, number, integer, boolean e date. I numeri accettano la notazione decimale e scientifica; gli interi devono essere numeri interi sicuri; i booleani ammettono true o false senza distinzione tra maiuscole e minuscole; le date usano YYYY-MM-DD con controllo dei giorni di calendario. Una stringa accetta qualsiasi valore non vuoto, mentre required stabilisce separatamente se una cella vuota è consentita. Un intero facoltativo può quindi mancare, ma, se presente, deve comunque essere valido.

Interpreti correttamente le violazioni

Il risultato inizia con l’indicatore valid e con i conteggi di righe, colonne e violazioni. Quando valid è false, l’array violations identifica ogni problema mediante numero di riga, nome della colonna, codice stabile e messaggio leggibile. La numerazione segue il CSV: la riga 1 è l’intestazione e il primo record si trova alla riga 2. Lei può quindi aprire il file originale e raggiungere subito la posizione indicata. Una violazione required segnala che una cella obbligatoria è vuota. Una violazione type indica che un valore presente non soddisfa il tipo dichiarato. Le righe con un numero eccessivo o insufficiente di campi ricevono column_count nella colonna speciale _row, perché il problema strutturale non può essere assegnato con certezza a una singola cella. Il parser gestisce virgole tra virgolette, virgolette con escape, interruzioni di riga incorporate e file CRLF; la punteggiatura legittima in un campo racchiuso tra virgolette non sposta quindi le colonne successive.

Inserisca la convalida all’ingresso del flusso

Convalidi il file il più vicino possibile al punto in cui entra nel Suo sistema. Può rifiutare il caricamento di un partner prima che raggiunga il database, controllare un’esportazione pianificata prima dei calcoli successivi o presentare in un importatore tutte le celle correggibili. Poiché l’algoritmo è deterministico e non usa la rete, lo stesso CSV e lo stesso schema producono sempre il medesimo report. L’output è quindi adatto sia ai controlli automatici sia alla correzione interattiva. Tratti una mancata corrispondenza dell’intestazione diversamente dalle violazioni di riga: la prima indica che il file non rappresenta il set di dati atteso; le seconde riguardano record riconoscibili da correggere. Il validatore segnala soltanto i problemi e non modifica, converte, ritaglia o sostituisce mai i valori originali. Se la pipeline richiede normalizzazione, la esegua come passaggio distinto e consapevole, quindi convalidi nuovamente rispetto al contratto effettivamente richiesto dalla destinazione.