Skip to content

Campo v63 de citação excede limite de 15 caracteres do schema Crossref 4.4.0 #333

Description

@samuelveigarangel

Descrição

Durante a geração do XML Crossref para o documento scl_S0100-55022026000500602, a validação contra o schema Crossref 4.4.0 falha com o seguinte erro:

Element '{http://www.crossref.org/schema/4.4.0}edition_number': [facet 'maxLength']
The value has a length of '20'; this exceeds the allowed maximum length of '15'., line 99

O valor inválido é emitido dentro de uma citação bibliográfica (<citation>), na referência ref2:

<citation key="ref2">
    ...
    <edition_number>2a ed. ampl. e atual</edition_number>
    ...
</citation>

O erro se repete na segunda journal_article (versão EN), na linha 323.

Origem do dado na API ArticleMeta

O valor vem do campo v63 (edição) da citação retornada pela API do ArticleMeta:

"v63": [
    {
        "_": "2a ed. ampl. e atual"
    }
]

Esse conteúdo representa a descrição textual completa da edição (20 caracteres), não um número de edição compacto conforme esperado pelo Crossref.

Restrição do schema Crossref 4.4.0

No schema Crossref 4.4.0, o elemento <edition_number> possui restrição de tamanho e formato:

  • Schema: common4.4.0.xsd (referenciado por crossref4.4.0.xsd)
  • Elemento: <edition_number>
  • Restrição: maxLength = 15, minLength = 1
  • Documentação: "The edition number of a book. edition_number should include only a number and not additional text such as 'edition'. For example, you should submit '3', not 'third edition' or '3rd edition'."
  • Referência local no repositório: tests/xsd/scielo_crossref/common4.4.0.xsd (linhas 720–738)

Trecho relevante do XSD:

<xsd:element name="edition_number">
    ...
    <xsd:simpleType>
        <xsd:restriction base="xsd:string">
            <xsd:maxLength value="15"/>
            <xsd:minLength value="1"/>
        </xsd:restriction>
    </xsd:simpleType>
</xsd:element>

Documentação oficial Crossref:

Impacto

  • A submissão do XML com referências falha na validação do schema.
  • O sistema recorre ao fallback e envia o XML sem referências (XML only with front metadata), perdendo as citações bibliográficas na submissão ao Crossref.

Comportamento esperado

O campo v63 deve conter apenas o número da edição da referência citada (ex.: "2"), respeitando o limite de 15 caracteres e o formato esperado pelo Crossref.

Comportamento observado

O v63 está sendo preenchido com texto descritivo longo ("2a ed. ampl. e atual") que excede o limite e invalida todo o lote de citações no XML Crossref.

Documento afetado

  • PID: S0100-55022026000500602
  • Collection: scl
  • Document ID (DOI Manager): scl_S0100-55022026000500602
  • DOI: 10.1590/1981-5271v50.supl.1-20260018
  • Periódico: Revista Brasileira de Educação Médica

Relacionado

Possíveis ações

  1. Investigar a origem do parse do campo v63 no pipeline de citações (ArticleMeta / xylose / conversão legado).
  2. Validar/sanitizar o valor de v63 na ingestão ou na API, extraindo apenas o número da edição quando possível.
  3. Como mitigação no exportador Crossref, omitir <edition_number> em citações cujo v63 exceda 15 caracteres (não corrige a causa raiz, mas evita invalidar o lote inteiro).

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions