Digibee Storage
A Digibee Integration Platform oferece várias opções para armazenamento de arquivos. O Portal de Documentação ajuda os usuários a identificar a melhor solução. Esse artigo aborda Digibee Storage.
Atualizado
Isto foi útil?
A Digibee Integration Platform oferece várias opções para armazenamento de arquivos. O Portal de Documentação ajuda os usuários a identificar a melhor solução. Esse artigo aborda Digibee Storage.
Atualizado
Isto foi útil?
O Digibee Storage se conecta ao storage da Digibee Integration Platform, possibilitando que sejam realizadas as seguintes operações com arquivos: List, Download, Upload e Delete.
Dê uma olhada nos parâmetros de configuração do componente. Parâmetros suportados por estão marcados com (DB)
.
Operation
Operação a ser executada (Upload, Download, List ou Delete).
Upload
String
File Name (DB)
Nome do arquivo ou caminho completo (full file path) para o arquivo local, disponível apenas nas operações Download e Upload.
local-pdf-test.pdf
String
Remote File Name (DB)
Nome do arquivo remoto ou caminho relativo (ex.: tmp/file.txt) para o arquivo remoto. Este parâmetro é apresentado nas operações Download, Upload e Delete.
pdf-test.pdf
String
Page Size
Tamanho da página, ou seja, a quantidade de itens a serem retornados quando a operação List é utilizada. Se o valor não for especificado, todos os itens são retornados. Caso haja mais itens do que a quantidade determinada neste parâmetro, é possível solicitar uma segunda página (veja Page Token), a qual retorna os itens restantes. Disponível apenas se o parâmetro Operation assumir valor List.
Todos os itens retornados
Inteiro
Page Token
Token utilizado para solicitar a próxima página quando a operação List é executada. Nessa próxima página será retornada a quantidade de itens definidos no parâmetro Page Size.
N/A
String
Remote Directory
Diretório remoto base no qual será realizada a operação selecionada. Este parâmetro é apresentado nas operações List, Download, Upload e Delete.
Folder
String
Generate Download Link
Se a opção estiver ativada, um link público para download do arquivo é gerado. Este parâmetro é aplicável apenas na operação Upload.
False
Booleano
Link Expiration
Tempo para expiração do link, em milissegundos. Este parâmetro é válido apenas se a opção Generate Download Link estiver ativada.
N/A
Inteiro
Fail On Error
Se a opção estiver habilitada, a execução do pipeline com erro será interrompida; do contrário, a execução do pipeline continua, mas o resultado vai mostrar um valor falso para a propriedade "success".
False
Booleano
Não se espera nenhuma mensagem de entrada específica, mas apenas o preenchimento dos parâmetros obrigatórios que variam conforme a operação selecionada. Veja abaixo a obrigatoriedade de parâmetros para cada operação:
List: todos os parâmetros são opcionais
Download: File Name e Remote File Name
Upload: File Name e Remote File Name
Delete: Remote File Name
No caso da operação Update, o arquivo informado no parâmetro File Name precisa estar no diretório local do pipeline.
Ao executar o componente utilizando a operação List, a seguinte estrutura de JSON será gerada:
content: um vetor (array) de objetos para cada arquivo encontrado.
name: nome do arquivo remoto.
contentType: MIME type do arquivo.
contentEncoding: encoding do arquivo, caso exista.
createTime: timestamp da data de criação do arquivo.
bucket: bucket onde o arquivo se encontra.
size: tamanho do arquivo em bytes.
pageToken: token para recuperar próxima página quando o parâmetro Page Size é informado.
fileName: nome do arquivo local.
remoteFileName: nome do arquivo remoto.
remoteDirectory: nome da pasta base remota.
success: "true" se a última operação ocorreu com sucesso.
error: surge se um erro ocorreu e o Fail on Error é "false".
Ao executar o componente utilizando as operações Download, Upload e Delete, a seguinte estrutura de JSON será gerada:
fileName: nome do arquivo local.
remoteFileName: nome do arquivo remoto.
remoteDirectory: nome da pasta base remota.
success: "true" se a última operação ocorreu com sucesso.
Parâmetros
Operation: List
Remote Directory: DGB-413
Page Size: 2
Como é possível ver, o resultado acima retorna a propriedade pageToken com um valor de referência para a próxima página. Essa propriedade será retornada quando o parâmetro Page Size é configurado (no exemplo está definido com o valor 2) e também quando há mais arquivos a serem listados.
Parâmetros
Operation: List
Remote Directory: DGB-413
Page Size: 2
Page Token: ChVER0ItNDEzL2lzbzg4NTktMi50eHQ=
No resultado acima a propriedade pageToken não foi retornada. Isso sinaliza que não há mais arquivos a serem listados.
Parâmetros
Operation: Download
File Name: iso8859-2.txt
Remote File Name: iso8859-2.txt
Remote Directory: DGB-413
Será realizado o download do arquivo no diretório local do pipeline.
Arquivo local: file.txt
Parâmetros
Operation: Upload
File Name: file.txt
Remote File Name: file.txt
Remote Directory: DGB-413
Arquivo local: file.txt
Parâmetros
Operation: Upload
File Name: file.txt
Remote File Name: file.txt
Remote Directory: DGB-413
Generate A Download Link: true
Link Expiration (in ms): 604800000
Com a configuração dos parâmetros de entrada acima, o arquivo ficará disponível para download por 7 dias (604800000ms) através do link gerado na propriedade de saída urlGenerated.
Parâmetros
Operation: Delete
Remote File Name: file.txt
Remote Directory: DGB-413