Organizar e publicar datasets

Quem pode fazer o quê

• Visitantes e visualizadores podem consultar ou baixar o conteúdo permitido pela política, mas não alteram o dataset.
• Colaboradores podem trabalhar com os registros autorizados, mas não devem definir participantes, política ou publicação.
• Administradores do dataset configuram acesso, participantes, metadados e versões.
• Superadministradores podem intervir em qualquer dataset para manter o sistema, mas a curadoria e a decisão de publicar pertencem aos responsáveis científicos pelo dataset.

Dataset e versão de dataset

Um dataset é um conjunto gerenciado que pode continuar mudando. Ele organiza registros e participantes e define como esses dados devem ser acessados.

A visibilidade configurada no dataset e a visibilidade permitida para seus registros determinam quem pode encontrá-los nas listas, exploradores, mapas e exportações. Tornar a página do dataset visível não significa publicar todos os registros nem conceder licença de uso. Da mesma forma, associar um registro a mais de um dataset pode envolver políticas diferentes; confira a política efetiva antes de prometer acesso.

Uma versão de dataset é um snapshot preparado para distribuição. Ela possui UUID, data e arquivos próprios e não deve mudar silenciosamente quando os registros do dataset forem editados depois.

Use a página do dataset para o trabalho contínuo. Use o UUID da versão para links, citações e análises que precisam apontar para conteúdo fixo.

Preparar o dataset

Antes de publicar, o administrador deve:

1. confirmar o título, a descrição e o projeto;
2. revisar administradores, colaboradores e visualizadores;
3. definir visibilidade e política de acesso;
4. conferir licença, política de uso e acordo de download;
5. ordenar autores e criadores e registrar seus papéis;
6. associar referências e marcar citações obrigatórias;
7. revisar os registros e os filtros que definem o escopo;
8. decidir se a lista taxonômica pode ser compartilhada;
9. verificar datasets relacionados e os metadados explicativos.

Uma política não é apenas texto informativo: ela orienta a forma de uso e pode afetar a visibilidade dos registros. Alterações devem ser discutidas com os responsáveis pelo dataset antes da publicação.

Criar e conferir uma versão

1. Abra a ação de criação de versão no dataset.
2. Defina versão, data, escopo e filtros.
3. Confira autores, licença, política, citação e metadados.
4. Gere a versão e acompanhe o UserJob relacionado, quando houver.
5. Abra a página pública pelo UUID.
6. Baixe o arquivo principal e, quando existir, o arquivo de mídias.
7. Confira README, metadados dos campos, contagem de registros e uma amostra dos dados.
8. Teste o acordo de download e a visibilidade com uma conta que não seja administradora.

Os arquivos de versões são persistentes. Administradores da instalação devem incluí-los nos backups junto com o banco de dados; não devem tratar esses arquivos como exportações temporárias.

Depois da publicação

Administradores do dataset podem consultar o registro de uso e exportá-lo para relatórios. Esse registro indica acessos e downloads; não altera permissões nem prova, sozinho, como os dados foram utilizados.

Se os dados precisarem de correção, corrija o dataset gerenciado e publique uma nova versão. Não substitua silenciosamente os arquivos de uma versão já citada.

Relação com a API e o R

A API pode listar datasets, consultar registros associados e preparar exportações. O R é adequado para revisar o escopo e a consistência dos dados antes da publicação. O ato de publicar, entretanto, deve ser realizado por um administrador responsável, depois da revisão de política, autoria e metadados.