Comece com arquivos comparáveis.
Escolha um lançamento anterior e outro posterior descrevendo o mesmo tipo de disco. A comparação diz que CSV, JSON registram matrizes e objetos JSON contendo páginas, registros ou itens. Os downloads de referência de defesa usam um formato compatível.
Os arquivos não precisam de colunas idênticas, mas precisam de um campo identificador em comum. Uma identificação de registro, identificação de origem, PMID ou rota canônica pode ser útil quando ele mantém o mesmo significado entre os lançamentos. Um número de fila criado após a triagem geralmente é inadequado.
Selecione o identificador deliberadamente.
A ferramenta sugere um identificador reconhecível quando se está presente. Confirme que identifica o nível de registro que pretende comparar. Identificações de eventos podem se repetir legitimamente em uma tabela de nível de espécime; nesse caso, um espécime ou identificador de resultados pode ser a chave relevante.
Identificadores em branco ou duplicados param a comparação. Isso impede que uma fileira repetida seja descartada silenciosamente ou contada como uma adição inexplicável. OGuia de eventos duplicadosexplica como distinguir uma duplicata de uma revisão ou uma observação ligada.
Leia os quatro resultados.
Um identificador adicionado aparece apenas no arquivo posterior. Um identificador removido aparece apenas no arquivo anterior. Um registro alterado mantém seu identificador, mas difere em pelo menos um outro campo. Um registro inalterado mantém os mesmos campos e valores sob as regras de comparação da ferramenta.
Esses resultados dizem respeito aos arquivos. Uma observação removida pode refletir uma correção duplicada ou filtro de exportação ao invés de desaparecer de doença. Uma citação não cria um novo evento de saúde animal. Leia as notas antes de interpretar uma contagem.
Entender diferenças de valor
Os valores de CSV permanecem em texto. Números JSON, texto, valores nulos, matrizes e objetos mantêm seus tipos. O valor de texto "1" e o JSON número 1 são valores diferentes. Um campo ausente, uma corda vazia e nula também são diferentes.
Números JSON usam a precisão numérica do navegador. Mantenha identificadores inteiros longos e valores que exigem precisão decimal exata como texto citado em ambos os arquivos. A ferramenta rejeita números não-finitos, valores inteiros inseguros e aninhamento além de 50 níveis ao invés de tratar silenciosamente identificadores arredondados como o mesmo registro.
Ordem da chave do objeto é ignorada, enquanto ordem do array é mantida. Se um campo contém uma lista de links em uma ordem diferente, ele pode se registrar como alterado. A ferramenta não infere se a diferença é cientificamente importante ou meramente de apresentação.
Identificadores são comparados como texto, preservando o espaço em volta. Se uma fonte acidentalmente adiciona espaços, inspecione e corrija o registro subjacente deliberadamente em vez de confiar em uma regra de normalização invisível.
Trabalhe através do exemplo
O exemplo fictício contém três registros anteriores e três posteriores. Um identificador é adicionado, um removido, um alterado e outro mantido inalterado. O título e versão alterados aparecem como diferenças de campo separadas dentro de um registro alterado.
Use o exemplo para verificar como os resultados são organizados antes de escolher seus arquivos. Não contém observações de fazenda ou de vigilância. Limpar a ferramenta remove suas seleções de arquivos atuais e mostra comparação.
Mantenha o resultado completo com sua fonte liberada.
A página mostra uma visualização limitada de identificadores adicionados e removidos e campos alterados. Baixe a comparação JSON para manter todos os resultados. Valores longos são encurtados na tela, mas preservados no download.
Mantenha os arquivos originais, seus rótulos de lançamento e a comparação juntos. OGuia de lançamento-changelogAjuda a transformar diferenças verificadas em uma explicação legível. OReferência de liberação de dadosdescreve preservação de uma liberação específica.