Guía de error

Atributo requerido faltante en JATS XML

El mensaje atributo requerido faltante (missing required attribute) indica que un elemento JATS está presente pero le falta un atributo que el esquema declara obligatorio. A diferencia de un elemento mal ubicado, aquí la etiqueta es correcta; lo que falta es metadata en forma de atributo que el validador necesita para clasificar y procesar el contenido.

Este error es especialmente común en conversiones automáticas desde Word o en plantillas incompletas. La buena noticia es que suele corregirse en segundos una vez identificado el atributo ausente.

Atributos obligatorios más frecuentes

Elemento raíz `<article>`

<!-- Incorrecto -->
<article dtd-version="1.3">

<!-- Correcto -->
<article article-type="research-article"
         dtd-version="1.3"
         xmlns:xlink="http://www.w3.org/1999/xlink">

Atributo	Función
`article-type`	Clasifica el artículo (research-article, review-article, etc.)
`dtd-version`	Versión del esquema JATS (1.3 actual)

Referencias, figuras y tablas

Elementos que reciben referencias cruzadas requieren id único:

<!-- Incorrecto -->
<ref>
  <element-citation publication-type="journal">...</element-citation>
</ref>

<!-- Correcto -->
<ref id="ref1">
  <element-citation publication-type="journal">...</element-citation>
</ref>

Lo mismo aplica a <fig id="fig1">, <table-wrap id="tbl1"> y <sec id="sec1">.

`<element-citation>`

<element-citation publication-type="journal">

El atributo publication-type es obligatorio y debe reflejar el tipo real: journal, book, web, thesis, etc.

Afiliaciones y países

<aff id="aff1">
  <institution content-type="orgname">Universidad Nacional</institution>
  <country country="MX">México</country>
</aff>

SciELO y PMC exigen id en <aff> y código ISO en el atributo country.

Por qué importan estos atributos

Los atributos no son decorativos: habilitan funcionalidad:

article-type determina qué secciones se esperan en el body.
id conecta <xref ref-type="bibr" rid="ref1"> con la referencia real.
publication-type indica qué subelementos son obligatorios en la cita.
xml:lang en <abstract> permite indexación multilingüe.

Sin ellos, el XML puede parecer completo visualmente pero fallar en harvesters y repositorios.

Checklist de validación previa

Antes de enviar un lote, verifique:

<article> tiene article-type y dtd-version
Namespace xmlns:xlink declarado si hay gráficos o enlaces
Cada <ref>, <fig>, <table-wrap> y <sec> referenciada tiene id único
Cada <element-citation> tiene publication-type
Cada <aff> tiene id y <country country="XX">
<abstract> tiene xml:lang cuando hay metadatos multilingües

Use el validador JATS para detectar automáticamente atributos faltantes.

Corrección en plantilla

Si el mismo atributo falta en múltiples artículos, el problema está en la plantilla o el convertidor, no en autores individuales. Actualice la plantilla XML de la revista y regenere los artículos afectados.

Ejemplo de plantilla mínima:

<?xml version="1.0" encoding="UTF-8"?>
<article xmlns:xlink="http://www.w3.org/1999/xlink"
         article-type="research-article"
         dtd-version="1.3"
         xml:lang="es">
  <front>...</front>
  <body>...</body>
  <back>...</back>
</article>