Processi dati / 06
Trasformare JSON e XML in un modello di destinazione affidabile.
I dati sono tecnicamente leggibili ma vengono comunque rifiutati. Nomi dei campi, tipi o strutture non corrispondono all’applicazione di destinazione. Sviluppiamo mapping tracciabili che gestiscono anche valori vuoti, casi particolari e modifiche al formato sorgente.
La situazione iniziale
La validità sintattica non garantisce la correttezza operativa.
Un’interfaccia XML fornisce articoli con attributi e namespace. La destinazione richiede oggetti JSON, stringhe univoche e un array per tutte le varianti. Un singolo elemento XML non deve produrre improvvisamente un tipo di destinazione diverso da quello di più elementi.
Definiamo separatamente le specifiche della sorgente, quelle della destinazione e le regole di trasformazione. Valori obbligatori, null e stringhe vuote ricevono un significato operativo; numeri e indicazioni temporali non vengono alterati mediante conversioni indiscriminate in testo.
Cosa gestisce DataSource
Percorsi dei campi, tipi e validazione.
Modellare
Rilevare campi, attributi, liste e riferimenti. Elaborare i namespace XML tramite il loro URI senza affidarsi soltanto a prefissi liberamente modificabili.
Trasformare
Implementare mappatura, conversione dei tipi e normalizzazione come regole versionate. Conservare esplicitamente precisione decimale, ID e fusi orari.
Validare
Verificare formato sorgente e specifiche della destinazione. Le regole operative integrano JSON Schema o XML Schema; segnalare i casi non validi con un percorso del campo significativo.
Scenario tecnico / Esempio illustrativo
Un articolo XML diventa un oggetto con tipi chiaramente definiti.
Esempio illustrativo con namespace e ID stringa. Il prefisso p è sostituibile; l’URI del namespace determina l’associazione. Qui il prezzo rimane volutamente una stringa decimale.
Dati di esempio e regole proposte. Le interfacce e le regole aziendali concrete vengono verificate per il vostro progetto.
<p:product xmlns:p="urn:example:catalog" id="004218">
<p:price currency="EUR">49.90</p:price>
</p:product>
→ {
"sku": "004218",
"price": "49.90",
"currency": "EUR"
}Gestione degli errori, sicurezza ed esercizio
Gestire in modo visibile le difformità dello schema.
Sicurezza del parser
Disattivare entità XML esterne e risorse esterne non controllate. Limitare dimensione, profondità e numero degli elementi; i dati importati non sono programmi affidabili.
Cambio di versione
Documentare insieme versione della mappatura e schema sorgente. Verificare nuovi campi obbligatori con dati di test rappresentativi e distribuirli in modo controllato.
Riferimenti degli errori
Indicare il record e il percorso del campo interessati. Utilizzare payload sensibili solo tramite canali diagnostici protetti ed esplicitamente autorizzati.
Domande funzionali
I dettagli che contano prima dell’implementazione.
JSON · XML · Namespace · Tipi di dati · Mappatura · Schema
La conversione è senza perdita di informazioni?
Solo con un modello concordato. XML comprende attributi, namespace e contenuti misti; JSON non li rappresenta automaticamente in modo equivalente.
Serve sempre uno schema?
È importante avere specifiche verificabili. Uno schema formale è utile, ma non sostituisce regole come riferimenti articolo validi o transizioni di stato consentite.
Che cosa accade ai campi sconosciuti?
In base alle specifiche vengono ignorati, conservati o rifiutati. Il comportamento viene stabilito esplicitamente, senza rimandare la decisione all’esercizio in produzione.
Per il confronto tecnico
Partire dal vostro processo concreto.
Portate esempi sorgente anonimizzati, schema di destinazione, definizioni dei campi e casi problematici. Strutture di lista vuote, con un singolo elemento e con più elementi facilitano la verifica.
Nel primo incontro chiariamo accessi disponibili, responsabilità dei dati e un primo flusso circoscritto. Poi concordiamo perimetro, responsabilità e condizioni.
Per iniziare bastano esempi anonimizzati. Non inviate password, token o dati personali di produzione nella prima richiesta.
Attività correlate
La prossima connessione nel suo contesto.
Automatizzare le importazioni CSV
Il file arriva ogni giorno. Qualcuno corregge le colonne, lo carica e controlla poi gli errori. DataSource trasforma questa attività ricorrente in un import documentato, con regole chiare per dati incompleti e non validi.
Integrazione REST API
La documentazione è disponibile e una richiesta di test funziona. Nell’uso quotidiano mancano comunque dati o si generano duplicati. DataSource collega la vostra API REST al processo aziendale concreto e pianifica anche il caso in cui la risposta non arrivi.
Automatizzare i processi dei dati prodotto
L’ERP fornisce le anagrafiche, il PIM i testi e un fornitore le caratteristiche tecniche. Le liste manuali collegano queste informazioni solo temporaneamente. Creiamo un flusso definito dal campo di riferimento fino all’export verificato per ogni canale.