DSpace para repositórios institucionais

O DSpace implementa um provedor OAI-PMH e expõe registros em diferentes formatos de metadados (ex.: oai_dc, qdc, dim, mets, perfis como OpenAIRE). A interface OAI encontra-se no backend do DSpace (módulo dspace-oai) e mapeia os campos internos para cada formato por meio de crosswalks (XSLTs).

Habilitar e apontar a interface OAI-PMH

A) Habilite o módulo OAI no arquivo dspace/config/modules/oai.cfg:
oai.enabled = true
oai.path = oai  # URL final: ${dspace.server.url}/oai/
oai.storage = solr # recomendado
oai.url = ${dspace.server.url}/${oai.path}
oai.config.dir = ${dspace.dir}/config/crosswalks/oai

Esses parâmetros controlam se a interface OAI está ativa, o caminho base e onde estão os arquivos de configuração/crosswalks.

B) Defina o identificador OAI (domínio da sua instância) quando necessário:

# Por padrão é derivado do dspace.ui.url; se precisar, faça:
# oai. identifier.prefix = repositorio.suainstituicao.br

Este prefixo compõe o <repositoryIdentifier> e os oai:<prefixo>:<handle>

C) Escolher e ajustar os formatos de metadados (crosswalks):

Os crosswalks OAI ficam, por padrão, em: [dspace]/config/crosswalks/oai/metadataFormats/

Cada formato é um XSL que transforma o “modelo XOAI” interno do item no XML de saída do OAI-PMH. Exemplos oficiais:

1. oai_dc.xsl (Dublin Core simples)

2. qdc.xsl (Qualified Dublin Core)

3. dim.xsl (DSpace Intermediate Metadata)

4. etdms.xsl, mods.xsl, 

Ex.: para expor Qualified Dublin Core, use metadataPrefix=qdc nas requisições OAI ou ajuste o qdc.xsl se precisar mudar o mapeamento (o XSL pode traduzir de qualquer schema interno para QDC) - https://github.com/DSpace/DSpace/blob/main/dspace/config/crosswalks/oai/metadataFormats/oai_dc.xsl

D) Definir quais formatos e contextos o OAI oferece:

O DSpace usa a biblioteca XOAI e organiza a configuração via xoai.xml, onde se declara:

• Formats: lista de metadataPrefix disponíveis (ex.: oai_dc, qdc, dim, mets).

• Contexts: “perfis” de exportação (ex.: driver, openaire) que aplicam transformações/constrangimentos adicionais.
  O oai.cfg aponta oai.config.dir para a pasta dos arquivos XOAI e crosswalks.

Alguns repositórios mantêm variações desse arquivo, mas a estrutura padrão (Formats, Contexts, Transformers) é a mesma e controla quais metadataPrefix aparecem em ListMetadataFormats.

E) Testar endpoints e formatos

Com o Tomcat ativo e o índice OAI criado:
Identify
https://SEU_BACKEND/server/oai/request?verb=Identify

ListMetadataFormats
.../oai/request?verb=ListMetadataFormats

ListRecords (ex.: QDC)
.../oai/request?verb=ListRecords&metadataPrefix=qdc

É importante confirmar a presença de oai_dc (obrigatório pelo protocolo) e de outros formatos que foram habilitados.

OAI-PMH requer carimbo de data à granularidade de segundos no padrão YYYY-MM-DDThh:mm:ssZ. Se o seu endpoint retornar datas inválidas, os validadores podem rejeitar o repositório.

O provedor OAI-PMH do DSpace depende de um índice Solr específico do OAI. Esse índice não se atualiza sozinho a partir do banco; é preciso alimentá-lo periodicamente com o comando de CLI dspace oai import. Esse comando trabalha de forma incremental (indexa apenas o que mudou desde a última execução) e pode, quando necessário, fazer uma reindexação completa com a opção -c (clear). 

Se faz necessário criar alguns arquivos de configuração para automação da atualização do OAI:

1o. arquivo: /etc/systemd/system/dspace-oai.service
2o. arquivo: /etc/systemd/system/dspace-oai.timer

Depois faz-se necessário ativá-los da seguinte forma:
systemctl daemon-reload
systemctl enable --now dspace-oai.timer. Tantocom .timer quanto com .service.