O Dropbox é um serviço de armazenamento de âmbito geral, mas que pode ser usado como buckets de arquivos físicos (ex.: imagens, PDF, arquivos compactados) do nosso sistema. 


Aviso

Esta documentação tem por objetivo informar sobre o procedimento básico de criação de uma chave do bucket no Dropbox, para informações mais aprofundadas, consulte a documentação oficial. O Cronapp possui um serviço de cloud que integra este serviço de forma mais simples aos seus projetos, para mais detalhes, acesse o tópico Armazenamento da documentação serviços de cloud.

Pré-requisitos

Antes de começar a seguir os passos do tutorial é preciso ter certeza de que se tem um ambiente minimamente preparado para reproduzir o exemplo. Abaixo estão os requisitos principais.

  1. Projeto do tipo mobile criado. Caso haja dúvidas de como criar esse tipo de projeto acesse o link Criar projeto;

  2. Possuir uma conta no Dropbox.

Passos

Criando app de armazenamento

Acesse o Painel de desenvolvedores do Dropbox, clique em "Painel de controle do aplicativo", após isso, clique em "Create app", como mostrado na figura 1. A criação do app no Dropbox é necessário para acessarmos o armazenamento, pois ele irá disponibilizar a "chave de armazenamento" e a "chave secreta".


Figura 1 - Área de criação de app


Após isso, você será levado a área de configuração, onde terá que selecionar 3 opções. (Figura 1.2)


Figura 1.2 - Configurando e criando app


  1. Choose an API: campo que libera a segunda opção, você terá que ativar para controlar o nível de acesso à sua aplicação.
  2. Choose the type of acess you need: seleciona o tipo de acesso que você precisa, no exemplo, marcamos "App folder", pois queremos acesso apenas à pasta de armazenamento especifica do app que estamos criando.
    • App folder: acesso apenas à pasta de armazenamento criada para o app.
    • Full Dropbox: acesso total à todas as pastas e arquivos do seu usuário no Dropbox.
  3. Name your app: nome da sua aplicação de armazenamento, após isso clique em Create app.

Obtendo token de acesso 

Agora, após criar seu app no tópico anterior, você será direcionado a área de informações do seu app, onde precisará fazer um pequeno ajuste nas permissões e obter também o token de acesso que será inserido no Cronapp.

Começaremos alterando as permissões da pasta, acesse a aba "Permissions" (1 da figura 2), verifique que há três tipos de permissões, são elas "Account Info", "Files and folders" e "Collaboration". Em "Account Info" marque apenas a opção com o final ".read" para indicar que será apenas para leitura, os demais tipos, marque ".write" e ".read" para termos acesso total à pasta por meio do token. Por último, clique em "Submit" para salvar as alterações e siga os passos da figura 2.1.


É necessário que os campos listados na imagem estejam com a caixa de escrita (.write) marcada para que não ocorram erros de permissão na hora de armazenar os arquivos.


Figura 2 - Atribuindo permissões


Após as permissões serem atribuídas, volte para a aba anterior chamada  "Settings" e selecione se o token terá ou não um tempo para expirar (1 da figura 2.1), em seguida, clique no botão "Generate" e o token será gerado no mesmo local do botão (2 da figura 2.1) e copie para inserir no seu projeto.


Figura 2.1 - Área para gerar o token de acesso

Inserindo o token no seu projeto

Após copiar o token que foi gerado no tópico anterior, acesse o Diagrama de dados e insira o token no atributo da classe que você deseja. (Figura 3)


Figura 3 - Abrindo página de edição do atributo


Após clicar no símbolo para abrir a edição do atributo desejado, 


Figura 3.1 - Configurando token para o atributo


  1. Defina o tipo do atributo para "Arquivo no Cloud" ou "Imagem no Cloud";
  2. Selecione o tipo de armazenamento para "Dropbox";
  3. Insira o token que você copiou no tópico anterior e salve.


Por fim, gere a Camada de persistência e a View.

Nesta página

  • No labels