Blog8 min

Validar XML JATS: o que cada validador verifica (JATS, SPS, PMC)

Guia para validar XML JATS conforme o destino: o que o padrão JATS verifica, o que o SPS da SciELO exige e o que o PMC revisa, e o que nenhum dos três comprova.

Publicado por OJS ONE

Operamos o OJS desde 2012, desde a versão 2.4.

Revisado tecnicamente em

Validar XML JATS não é uma tarefa, são três: o padrão JATS verifica se o documento usa o formato comum; o SPS da SciELO exige o perfil e o estilo da coleção; o PMC avalia completude e preservação do seu arquivo. Um arquivo pode passar em uma camada e falhar na seguinte, e nenhuma das três garante aceitação em um indexador.

Este texto responde à pergunta que aparece quando chega uma devolução de validação: o que exatamente cada ferramenta está verificando, o que nenhuma pode comprovar e como preparar um único artigo para vários destinos. O critério de erros de conteúdo é tratado em XML JATS: erros que um XML válido pode conservar.

Validar XML JATS: três camadas, três perguntas. 1) JATS · formato: Estrutura e etiquetas válidas segundo o padrão?; 2) SPS · perfil SciELO: JATS + especificações PMC + estilo SciELO?; 3) PMC · arquivo: Completo e conversível em XML de preservação?. O que nenhuma camada prova: Nem a qualidade científica do conteúdo nem a aceitação em um índice.

Três camadas, três perguntas diferentes

Resposta direta: cada camada responde a uma pergunta diferente, e confundi-las é a causa mais comum de falsas tranquilidades.

  • JATS (camada de formato): o documento está bem formado segundo o padrão? O JATS «provides a common XML format in which publishers and archives can exchange journal content»1 e oferece «a set of XML elements and attributes for describing the textual and graphical content of journal articles»1. É a camada mais baixa: estrutura e etiquetas.
  • SPS da SciELO (camada de perfil): o documento cumpre o perfil que a SciELO exige para recebê-lo? «O arquivo XML que o SciELO necessita deve estar em conformidade com o SciELO Publishing Schema (SciELO PS)»2, e essa documentação é composta por «DTD JATS 1.0 + especificações PMC + Estilo SciELO»2: padrão, especializações e regras de estilo da coleção.
  • PMC (camada de arquivo): o conteúdo entra completo e preservável no repositório da NLM? No PMC, os envios «are reviewed for completeness»3 e «the submitted files are converted to archival XML to ensure the long-term preservation of the content»3, nos formatos «NISO Z39.96-2015 JATS XML and txt»3.

A consequência prática: «passa no JATS» não significa «passa no SPS», e «passa no SPS» não diz nada sobre o processo de revisão do PMC.

Como validar XML JATS conforme o destino

Resposta direta: primeiro você define o destino, depois escolhe a ferramenta dessa camada e depois registra o relatório.

  1. Defina destino e perfil: SciELO (e qual versão do SPS a sua coleção exige), PMC, outro repositório ou nenhum com perfil próprio? Sem esse dado, qualquer validação é uma foto sem contexto.
  2. Camada de formato: valide o documento contra o esquema do tag set correspondente (bem formado primeiro, esquema depois). Essa camada detecta elementos fora do lugar, atributos inválidos e estrutura quebrada.
  3. Camada de perfil SciELO: para SPS ≥ 1.10 existe o validador oficial publicado pela SciELO («spsvalidator SPS >= 1.10»4). Para perfis anteriores, use as ferramentas que a documentação da SciELO indica para a sua versão.
  4. Camada de conteúdo: percorra o documento com base nas regras editoriais da coleção: autorias, afiliações, resumos em dois idiomas, palavras-chave, referências e coerência com o PDF e o HTML publicados.
  5. Registre o resultado: guarde o relatório de validação com a data e a versão da ferramenta. A SciELO diz isso explicitamente: «a validação deverá ser feita a cada envio»2; uma validação aprovada no mês passado não cobre o envio de hoje.

Se a sua revista entrega a vários destinos, a ordem inversa poupa retrabalho: prepare o artigo com a camada mais estrita primeiro (perfil de destino), e as camadas mais baixas caem sozinhas.

Como preparar um artigo para vários destinos

Resposta direta: com uma única preparação rigorosa do conteúdo e uma passada de validação por destino, não um arquivo diferente por indexador.

  • Estrutura desde o início: seções com títulos reais, tabelas como tabelas, figuras com legendas e referências em um único bloco ordenado. Um documento assim produz uma camada de formato limpa sem correções de fundo1.
  • Metadados completos antes de marcar: autorias com afiliação, resumo, palavras-chave e identificadores declarados na fonte. O que a SciELO pede está no seu perfil2; se o seu destino também quer DOIs ou ROR, eles se resolvem antes de gerar o XML, não depois.
  • Perfis em paralelo, não em série: se você entrega à SciELO e ao PMC, execute a validação do SPS e a revisão de completude do PMC sobre o mesmo artigo na mesma rodada de correções3. Corrigir duas vezes, com semanas de diferença, multiplica o trabalho.
  • Uma versão, três saídas: o PDF e o HTML publicados devem contar a mesma história que o XML. Se o resumo difere entre formatos, nenhuma validação detecta isso: é revisão editorial.

O que olhar no relatório de validação

Resposta direta: três coisas: o que falhou, com qual ferramenta e versão, e o que ficou pendente de propósito.

  1. Erros contra avisos: o erro bloqueia o envio; o aviso pede critério. Anote quais você aceitou e por quê, para que a próxima revisão não reabra decisões já tomadas.
  2. Identificação da execução: ferramenta, versão e data (para SPS ≥ 1.10, «spsvalidator SPS >= 1.10»4 é o nome que deve aparecer no registro). Sem essa identificação, o relatório não serve como evidência de nada.
  3. Pendências declaradas: se um campo ficou incompleto por uma limitação do insumo, que fique escrito com responsável e data. O silêncio ali vira um erro publicado.

Esse relatório, guardado com o número, é o que transforma «já validamos» em uma afirmação verificável.

O que nenhum dos validadores pode comprovar

Resposta direta: nenhum dos três valida a qualidade científica do conteúdo nem decide a indexação.

  • Um documento estruturalmente válido pode conservar erros de dados e de conteúdo: por isso separar validação técnica de revisão editorial não é opcional (desenvolvido no texto sobre erros de controle editorial).
  • A validação não substitui a revisão de leitura: uma tabela válida pode continuar ilegível no celular.
  • Nenhuma ferramenta garante aceitação: a avaliação da SciELO, do DOAJ ou de qualquer indexador é decidida por cada instituição com os seus critérios.
  • O nosso teste empírico ilustra o ponto com uma saída real: o XML gerado pelo OJS 3.6.0.0 passou na verificação de boa formação e falhou contra o SPS (comprovamos isso no teste do OJS 3.6).

Erros comuns ao validar

  • Validar uma única vez e dar o arquivo por encerrado para sempre; o padrão e o perfil são verificados a cada envio2.
  • Acreditar que «XML válido» significa «pronto para a SciELO»: são camadas distintas, como vimos acima.
  • Validar contra o perfil errado: um SPS de outra versão não comprova o cumprimento do que a sua coleção exige.
  • Corrigir erros de estrutura sem olhar o conteúdo: você conserta a camada baixa e deixa o erro editorial publicado.
  • Não guardar o relatório: sem evidência, a próxima correção parte do zero e ninguém sabe o que foi verificado.
  • Delegar a validação a quem também diagrama, sem um segundo olhar: quem produz o arquivo tem menos chances de ver o próprio erro.
  • Corrigir às cegas: mudar etiquetas até a ferramenta se calar, sem entender a regra que o documento descumpria.
  • Ignorar os avisos porque «não bloqueiam»: muitos são a antessala de um erro de conteúdo publicado.
  • Misturar perfis de coleções distintas: o SPS da SciELO e as regras de outra coleção não são intercambiáveis; valide contra o que o seu destino exige2.
  • Acreditar que a aprovação de ontem cobre o envio de hoje: a validação se executa a cada envio2.

Perguntas frequentes

Passar na validação JATS significa que a SciELO aceita o meu artigo?

Não. A SciELO exige conformidade com o seu perfil (o SPS2) e além disso aplica os seus processos editoriais; uma ferramenta não decide pela coleção. A validação do seu arquivo, com o perfil correto, continua sendo obrigatória a cada envio2.

Que ferramenta uso para o SPS 1.10?

O validador oficial publicado pela SciELO para essa versão: «spsvalidator SPS >= 1.10»4. Para versões anteriores, confirme na documentação da SciELO quais se aplicam à sua coleção antes de corrigir qualquer coisa.

E se a minha revista entrega ao PMC e à SciELO ao mesmo tempo?

Prepare o artigo com base no perfil mais estrito dos dois e execute as camadas em ordem: formato, perfil de cada destino, conteúdo. O esforço extra está na primeira preparação; depois, cada envio repete verificações, não refaz o arquivo.

Encerramento. Saber o que cada camada verifica transforma uma devolução vaga em uma lista concreta de correções. Com o Jatson produzimos e validamos XML JATS por destino a partir do artigo aceito, com o relatório de cada revisão; se quiser que vejamos o estado dos seus arquivos atuais, fale com a equipe.

Fontes

  1. NISO. ANSI/NISO Z39.96-2024, JATS: Journal Article Tag Suite, version 1.4. https://www.niso.org/publications/z3996-2024-jats (consultado em 18 de novembro de 2026).
  2. SciELO. Perguntas Frequentes Sobre a Adoção de XML. https://docs.scielo.org/projects/scielo-pc-programs/en/latest/faq-scielo-xml.html (consultado em 18 de novembro de 2026).
  3. PMC/NLM. Author Manuscripts in PMC. https://pmc.ncbi.nlm.nih.gov/about/authorms/ (consultado em 18 de novembro de 2026).
  4. SciELO. Repositório spsvalidator. https://github.com/scieloorg/spsvalidator (consultado em 18 de novembro de 2026).

Jatson · produção editorial

Do Word aceito a PDF, HTML e XML JATS validado

O Jatson produz os três formatos a partir do artigo aceito e entrega o relatório de validação de cada envio. A sua equipe deixa de marcar à mão.

  • XML conforme o SPS da SciELO
  • HTML pronto para leitura na página do artigo
  • Pronto para carregar no OJS

Jatson · produção editorial

Do Word aceito a PDF, HTML e XML JATS validado

O Jatson produz os três formatos a partir do artigo aceito e entrega o relatório de validação de cada envio. A sua equipe deixa de marcar à mão.

Conhecer o Jatson

Compartilhar