Decidi se stai confrontando layout o dati
Due documenti JSON possono utilizzare un rientro diverso pur contenendo gli stessi dati. Confronta JSON analizza i valori: l'ordine della proprietà dell'oggetto non ha importanza, ma l'ordine dell'array lo fa. La formattazione rende una struttura più facile da leggere senza stabilire che i suoi campi soddisfino lo schema o lo scopo della destinazione.
Utilizzare versioni chiaramente identificate e conservare ciò che è prima e ciò che è dopo. Ispezionare un cambiamento noto per comprendere il rapporto. La stringa "2" differisce dal numero 2. Se un codice come "001" deve mantenere zeri iniziali, mantenerlo come stringa piuttosto che trasformarlo in un numero semplicemente per semplificare il confronto. Questa scelta riguarda sia l’interpretazione che la conservazione.
Leggi i percorsi nel rapporto di differenza
Ogni differenza mostra un percorso JSON Pointer e se un valore è stato aggiunto, rimosso o modificato. In /users/0/name, 0 seleziona il primo elemento array. È diverso dalla posizione di una pagina PDF o da un'etichetta di tabella stampata: gli indici di matrice iniziano a zero piuttosto che uno.
Chiavi contenenti / utilizzare 1 e chiavi contenenti utilizzare 0. Il percorso /a~1b interroga una proprietà denominata a/b. Un percorso vuoto restituisce l'intero documento. JSON Pointer non supporta JSONPath, jolly o frammenti di URI. Immettere un percorso esatto e verificare che esista prima di fare affidamento sul valore estratto come risposta alla query.
Comprendere gli input e i limiti rifiutati
Il confronto e la ricerca del puntatore rifiutano chiavi duplicate, interi al di fuori dell'intervallo di sicurezza e nidificano oltre i cento livelli. Nascondere lo spazio bianco non risolve questi problemi. Se un identificatore di grandi dimensioni deve essere testo, la sua rappresentazione di origine deve conservarlo come stringa; l'accettazione di un numero arrotondato non ripristina l'identificatore originale.
Il confronto accetta un milione di caratteri per documento e fino a mille differenze. Dividere grandi strutture in unità significative e registrare quali frammenti sono stati confrontati. Un percorso mancante differisce da una proprietà che detiene nullo. Ispezionare sia la sorgente che il percorso per distinguere un errore di selezione da un valore vuoto valido prima di interpretare l'output.
Preparare tabelle di revisione senza perdere il contesto
La tabella da JSON a Markdown accetta una serie di oggetti e raccoglie le chiavi da ogni riga. Le proprietà mancanti e null producono celle vuote, mentre le strutture nidificate appaiono come JSON compatte. I personaggi speciali sono evasi e le interruzioni di riga appaiono come . Questo supporta la revisione umana, ma non preserva ogni distinzione come esportazione reversibile.
Per le sorgenti CSV che necessitano solo di un separatore diverso, utilizzare Modifica delimitatore CSV. La sostituzione delle virgole come testo ordinario può rompere le celle citate. Controlla le intestazioni, gli zeri iniziali e una cella contenente la punteggiatura. Salvare il JSON originale accanto al rapporto di differenza o alla tabella in modo che le ambiguità possano essere investigate sulla fonte completa piuttosto che su una visualizzazione semplificata.
Un valore modificato
Confronta i due oggetti JSON dell’esempio. Cambia solo il nome del primo utente e l’ordine delle proprietà.
Prima: {"users":[{"name":"Ana"}],"a/b":2}
Dopo: {"a/b":2,"users":[{"name":"Luis"}]}La differenza è /users/0/name, da Ana a Luis. Il riordino delle proprietà non aggiunge differenze. /a~1b restituisce 2.
L’indice 0 seleziona il primo elemento. Il percorso /users/1/name non esiste e non equivale a un valore null.