Un feed XML organizza informazioni in elementi e attributi, così che software diversi possano leggerle secondo una struttura condivisa. Quando contiene dati relativi a offerte identificate con SPID, la verifica riguarda sia la correttezza formale del documento sia la coerenza dei valori descritti. Un controllo sistematico rende più semplice mantenere aggiornate le informazioni e integrarle in applicazioni o cataloghi.

Controllare la sintassi del documento

La prima verifica riguarda la buona formazione dell’XML. Ogni elemento deve avere un tag di apertura e uno di chiusura corrispondenti; gli elementi vuoti possono invece usare la forma abbreviata prevista dalla sintassi. I tag sono sensibili alle maiuscole, e l’ordine di chiusura deve rispettare la struttura di annidamento. Anche caratteri riservati, come la e commerciale, vanno rappresentati con le entità appropriate quando compaiono nel contenuto.

È utile controllare inoltre la dichiarazione XML, la codifica dei caratteri e la presenza di un solo elemento radice. Un parser può segnalare la posizione di un problema con numero di riga e colonna: queste indicazioni aiutano a individuare rapidamente il punto da esaminare. La validazione automatica può essere inserita nel processo di pubblicazione del feed, così che ogni nuova versione venga sottoposta agli stessi controlli.

Definire una struttura coerente

La sintassi corretta è solo il primo livello. Per verificare che il feed rispetti il modello previsto, si può usare uno schema XSD o una definizione equivalente. Lo schema specifica quali elementi sono ammessi, quali sono obbligatori, in quale ordine compaiono e quali tipi di dato possono contenere. Può anche stabilire vincoli, come la cardinalità di un elemento o il formato di una data.

Per un feed informativo, il modello potrebbe distinguere identificativo dell’offerta, descrizione, data di aggiornamento, requisiti di accesso e condizioni associate allo SPID. La scelta dei nomi dovrebbe essere uniforme in tutti i record. Se un campo rappresenta una data, conviene adottare un formato standard, come anno-mese-giorno, evitando varianti che i sistemi destinatari potrebbero interpretare in modi diversi.

Esaminare i dati sulle offerte

Un controllo semantico confronta i valori con il significato assegnato a ciascun campo. Per esempio, un identificativo dovrebbe essere univoco, una data dovrebbe essere valida e una condizione di accesso dovrebbe usare una formulazione coerente con il vocabolario definito per il feed. Le descrizioni possono essere controllate anche rispetto a limiti di lunghezza e caratteri ammessi, per favorire una visualizzazione uniforme.

In un flusso che raccoglie informazioni su bonus senza deposito con spid, è utile separare i dati descrittivi dalle informazioni operative: requisiti, periodo di validità e modalità di verifica dell’identità possono occupare campi distinti. Questa organizzazione permette ai sistemi di elaborare ogni elemento in modo prevedibile e ai redattori di confrontare agevolmente le diverse voci.

Individuare incongruenze con controlli automatici

Oltre alla validazione tramite schema, semplici regole possono evidenziare valori duplicati, campi vuoti o date non compatibili con il formato stabilito. Un confronto tra versioni successive del feed aiuta a riconoscere quali record sono stati aggiunti o aggiornati. Anche i registri di validazione sono utili: riportano l’esito dei controlli e permettono di documentare gli interventi effettuati.

È opportuno provare il feed con un campione rappresentativo prima di distribuirlo. Il test può includere caratteri accentati, descrizioni di diversa lunghezza e tutti i valori previsti dai campi enumerati. Una volta definita una procedura ripetibile, sintassi, schema e coerenza semantica diventano passaggi complementari. Il risultato è un flusso XML più leggibile e utilizzabile nei diversi strumenti che ne elaborano i dati.