Skip to content

Pubmed XML: validar demais elementos obrigatórios de Journal (PublisherName, JournalTitle, Issn) + warning para opcionais incompletos #1254

Description

@Rossi-Luciano

Contexto

A #1250 corrigiu o tratamento de Journal/PubDate ausente (obrigatório pela DTD do PubMed), mas a revisão da @robertatakenaka em #1250 apontou um problema mais amplo: esse tratamento não deveria ser exclusivo de PubDate.

Conferindo o DTD oficial (https://dtd.nlm.nih.gov/ncbi/pubmed/in/PubMed.dtd):

<!ELEMENT Journal (PublisherName, JournalTitle, Issn, Volume?, Issue?, PubDate)>

Ou seja, quatro elementos são obrigatórios dentro de Journal (sem ?): PublisherName, JournalTitle, Issn e PubDate. Só PubDate recebeu tratamento até agora (MissingRequiredElementError, movido para dentro de xml_pubmed_pub_date_pipe em #1250/#1234). xml_pubmed_publisher_name_pipe, xml_pubmed_journal_title_pipe e xml_pubmed_issn_pipe continuam gerando <Journal> silenciosamente inválido pelo DTD quando o dado de origem não existe.

Subtarefas

  • Aplicar o mesmo padrão de xml_pubmed_pub_date_pipe (raise MissingRequiredElementError("Journal/PublisherName"), etc.) em xml_pubmed_publisher_name_pipe, xml_pubmed_journal_title_pipe e xml_pubmed_issn_pipe.
  • Corrigir xml_pubmed_issn_pipe: a condição atual é if issn != "":, que não trata issn is None corretamente (deveria ser if not issn: para o caso obrigatório).
  • Adicionar um mecanismo de WARNING (não exceção) para elementos opcionais que, uma vez presentes, têm sub-requisitos e estão incompletos — ex.: já existe um caso assim resolvido silenciosamente em Author (FirstName/LastName sempre em par, ver feat(pubmed): adicionar Suffix e CollectiveName em AuthorList #1245), que hoje duplica o nome disponível sem avisar.
  • Decidir e documentar onde esse warning é emitido/reportado (a CLI em lote de Pubmed XML: CLI em lote (.zip) e registro como comando instalável #1241 já tem um caminho de warning por artigo que pode ser reaproveitado).

Origem

Levantado pela @robertatakenaka em revisão de código: #1250 (comment)

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

Labels

Type

No type

Projects

No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions