Wiki Markup
\[DI-2205\] Abrir arquivo do S3 / Open file From S3

Obtém um arquivo de um bucket Amazon S3.
Image Added
Figura 1 – Bloco Abrir arquivo do S3
(info)
Este é um bloco proveniente do plugin Amazon S3, para instalá-lo, acesse no menu do sistema Plugin > Instalar Plugin, no campo de busca pesquise por "Amazon S3" e avance até finalizar a instalação. Recompile e reabra o projeto para conseguir visualizar os blocos servidor. 
(dica)
É possível utilizar esse bloco para obter os arquivos contidos no Armazenamento em nosso Serviços de Cloud, veja como obter os dados de acesso no tópico Exemplo.

Compatibilidade

• Bloco servidor: cronapp.AmazonS3Service.obterArquivo()

Retorno

Retorna o endereço em que o arquivo obtido do bucket S3 foi salvo.

Parâmetros

Chave de acesso

No bucket da Amazon, este campo corresponde a caixa de seleção Access Key, da aba de configuração "Select AWS access type" nas configurações do AWS Iam User. No Cronapp este campo corresponde ao campo "Chave de acesso" da janela de configuração do bucket (destaque 4 da figura 2).

• Posição: 1
• Inglês: Access key
• Tipo: String
• Exemplo:  "AKIAY2KVNQTZB7CCAOOT"

Chave secreta

No bucket da Amazon, a chave secreta, ou Secret Acess Key, é gerada ao finalizar a criação de um usuário. No Cronapp este parâmetro corresponde ao campo "Senha de acesso" da janela de configuração do bucket (destaque 5 da figura 2).

• Posição: 2
• Inglês: Secret key
• Tipo: Texto / String
• Exemplo: "GrXNP6X6zS5SZNgky5B+xZ8LDpBCKCo+XzMwJv/8"

Nome do bucket

No bucket da Amazon, este parâmetro corresponde ao parâmetro Name, do formulário de criação do bucket. No Cronapp, podemos relacioná-lo ao campo "Nome" da janela de configuração do bucket (destaque 6 da figura 2).

• Posição: 3
• Inglês: Bucket name
• Tipo: Texto / String
• Exemplo: "s3.storage.cloud.cronapp.io"

Arquivo de origem

Caminho do arquivo que consta no bucket. É necessário informar o nome e extensão do arquivo.

• Posição: 4
• Inglês: Local file
• Tipo: Texto / String
• Exemplo: "imagemS3/cronapp-nuvem.png" 

Caminho de destino

Caminho do arquivo que será salvo no projeto. É necessário informar a extensão do arquivo.

• Posição: 5
• Inglês: Path to save
• Tipo: Texto / String
• Exemplo: "src/main/webapp/public/assets/imagem/cronapp-nuvem-s3.png"

Região

No bucket da Amazon, este parâmetro corresponde ao parâmetro Aws Region, do formulário de criação do bucket. No Cronapp, podemos relacioná-lo ao campo correspondente ao texto selecionado no campo "CNAME" da janela de configuração do bucket (destaque 7 da figura 2).

• Posição: 6
• Inglês: Region
• Tipo: String
• Exemplo:  "US_EAST_1"

Exemplo
A configuração dos parâmetros no bloco é diretamente influenciada pelas configurações do bucket Amazon S3. Neste exemplo específico, estamos utilizando o Serviço de Cloud Armazenamento, fornecido pelo Cronapp.
Para acessar o Serviço de Cloud, clique no ícone em forma de nuvem (destaque 1 na figura 2) e, em seguida, vá para a aba "Armazenamento" (2). Neste exemplo, já temos um bucket previamente criado, consulte a documentação de Serviços de Cloud para obter informações detalhadas sobre como criar um bucket.
Para visualizar a janela com os parâmetros necessários para o bloco, é necessário editar o bucket (3). Uma vez que a janela estiver aberta, basta copiar os campos correspondentes e colá-los nos parâmetros correspondentes no bloco.
Image Added
Figura 2 – Acesso e configuração do bucket S3
Utilizando o bloco Salvar aquivo no S3, enviamos uma imagem do nosso projeto para o bucket S3. Agora, iremos recuperar esse arquivo com a ajuda do bloco Abrir arquivo do S3, portanto, no parâmetro "Arquivo de origem", devemos informar o endereço do arquivo que consta no bucket, e no parâmetro "Caminho de destino", informamos o endereço no qual o arquivo será armazenado no nosso projeto.
O parâmetro destacado em azul no campo 7 da figura 2 deve ser inserido como o último parâmetro no bloco.

Image Added

Image Added