Primeira vez?
Dicas para usuários de primeira viagem!
6 minute read
OpenDataBio é um software para ser instalado num servidor e acessível online. Você pode instalar localmente no seu computador como ambiente de desenvolvimento ou para seu uso pessoal. A instalação via Docker facilita a instalação do aplicativo.
Tipos de usuário
Atenção
Se você se registrou, alguém precisa atribuir você como **usuário pleno** para que você possa inserir dados.- Se você estiver instalando, o primeiro login para uma instalação do OpenDataBio deve ser feito com o usuário super-administrador padrão:
admin@example.orgepassword1. Essas configurações devem ser alteradas, senão a instalação fica aberta à qualquer pessoa lendo estas instruções. - Quando um usuário se auto-cadastra numa instalação do OpenDataBio, ele não tem permissão de edição ou inserção de dados, ele apenas ganha um cadastro e acesso aos conjuntos de dadosabertos para
usuários registradose permite que o usuário faça downloads, os quais exigem login. - Usuário pleno pode contribuir com dados
- Apenas super-administradores podem atribuir o papel de
usuário plenopara usuários registrados - diferentes instalações do OpenDataBio podem ter políticas diferentes sobre como você pode obter acesso de usuário pleno.
Ver mais em Usuários.
Prepare seu perfil de usuário-completo
- Criar um registro de Pessoa para você, e ligar ele como sua
pessoa padrãono seu perfil de usuário. Assim, os formulários da interface utilizarão essa Pessoa facilitando a entrada de dados. - Você precisará de pelo menos 1 conjunto de dados para entrar seus dados
- isso não é necessário para importar dados de bibliotecas compartilhadas, como Pessoas, Localidades, Taxons e Referências Bibliográficas).
- Você poderá criar tantos projetos e conjuntos de dados que precisar. Entenda bem esses Objetos de Controle de Acesso do OpenDataBio.
Entrando e editando dados
Existem várias maneiras entrar e editar dados no OpenDataBio:
- Registro por registro por meio da interface web, com ajuda de serviços de API para taxons e referências bibliográficas.
- Através de Formulários via interface Web, onde você pode entrar Medições.
- Através do aplicativo para Android ODBCollect, para o qual você pode criar diferentes tipos de Formulários ODBCollect e usar para coletar dados offline e enviar diretamente para o banco de dados.
- Usando a Application Programming Interface -API do OpenDataBio, que facilita o processamenta de dados em lote (batch):
- importar dados de arquivos CSV, XLXS ou ODS usando a interface (Menu Importar)
- através do R, usando o pacote OpenDataBio R, que é um cliente para essa API.
- criando o seu próprio cliente em outra linguagem
- Ao usar os serviços da API OpenDataBio você deve preparar seus dados ou arquivo para importação e atualização de acordo com as opções de campo dos verbos POST e PUT para o
endpointespecífico que você está tentando importar. Verifique também a referência rápida da API.
R Tutorials
Veja os [tutoriais](/docs/tutorials/02-post-data-r-vignette) para exemplos de como usar o pacote do R e a API para obter e importar dados.Dicas para inserir dados
- Se for inserir dados pela primeira vez, recomendamos que você utilize a interface pelo seu navegador e crie pelo menos um registro para cada objeto que atenda às suas necessidades. Em seguida, experimente as configurações de privacidade do seu espaço de trabalho conjunto de dados e verifique se você pode acessar os dados quando estiver conectado ou não. Ou seja, entenda como os dados ficam organizados e veja como obtê-los.
- Use Conjunto de dados para um conjunto independente de dados que deve ser distribuído como um grupo. Os conjuntos de dados são publicações dinâmicas, têm autor, dados e título e versões estáticas podem ser geradas, facilitando o download e a distribuição.
- Embora o ODB tente minimizar a redundância, dar flexibilidade aos usuários tem um custo em algumas definições, como por exemplo, Variáveis e [Pessoas](/docs/concepts/objetos auxiliares/#person) que podem receber registros duplicados. Portanto, deve-se ter cuidado ao criar tais registros. Os administradores podem criar um código de conduta para os usuários de uma instalação ODB para minimizar tal redundância, customizando a instalação.
- Siga uma ordem de importação de novos dados a partir das bibliotecas de uso comum. Por exemplo, você deve primeiro registrar Taxons, Pessoas, Variáveis e qualquer outra biblioteca comum antes de importar Indivíduos ou Medições. Localidades podem ou não ser necessário importar antes. Se for apenas coordenada geográfica não é necessário.
- OpenDataBio pode ser instalado com dados previamente organizados para algumas Localidades, unidades administrativas, Município, Estado, País, Unidades de Conservação Federais e Terras Indígenas, e uma base da árvore da vida para Taxons complementada pela filogenia das plantas com sementes até o nível de Ordem conforme a árvore do Angiosperm Phylogeny WebSite.
- Não há nenhuma necessidade de importar localidades do tipo
POINTpara importar Indivíduos porque o ODB cria a localidade para você se informar latitude e longitude, e detectará para você a qual são as localidades registradas à qual o indivíduo pertence. Ou seja, ODB detecta as unidades administrativas (Município, Estados, Pais), as Unidades de Conservação e Terras Indígenas e também classes ambientais, dependendo das Localidades registradas na base de dados. Você pode usar a API de validação de localidades para validar previamente as coordenadas. - Existem diferentes maneiras de criar localidades do tipo PARCELA e TRANSECTOS - saiba mais em Localidades.
- A criação de taxons exige apenas a especificação de um
nome- ODB pesquisará os serviços de nomenclatura para você, encontrará o nome, metadados e taxons pais ou taxons aceitos, se o seu nome for um sinônimo, e importará todos os eles. Se necessário até encontrar na base algum taxon na hierarquia ancestral. Por exemplo, se informar Ocotea guianensis, mas apenas a ordem Laurales estiver cadastrada na base, ODB irá buscar e cadastrar para você todo o caminhoLauraceae >> Ocotea >> Ocotea guianensis, com autoria, referencia bibliográfica e link ao repositório nomenclatural onde encontrou os dados. Se você estiver importando nomes publicados, basta informar este único atributo. Se o nome taxonômico não for publicado é necessário informar campos adicionais. Portanto, separe a importação em lote de nomes publicados e não publicados em dois conjuntos. - O campo
notesde qualquer modelo é para texto simples ou para dados formatados como objectos JSON. A opção Json permite que você armazene dados estruturados personalizados em qualquer modelo que tenha o camponotes. Você pode, por exemplo, armazenar como notas alguns campos secundários de fontes originais ao importar dados, mas pode armazenar quaisquer dados adicionais que não sejam fornecidos pela estrutura do banco de dados do OpenDataBio. Esses dados não serão validados pelo OpenDataBio e a padronização depende de você. As notas Json serão importadas e exportadas como um texto JSON e serão apresentadas na interface como uma tabela formatada; URLs em seu Json serão apresentados como links.