ZIP File V2

Saiba mais sobre o conector ZIP File V2 e como usá-lo na Digibee Integration Platform.

O ZIP File V2 compacta arquivos no formato .zip, com ou sem redução de tamanho.

Parâmetros

Dê uma olhada nos parâmetros de configuração do conector. Parâmetros suportados por expressões Double Braces estão marcados com (DB).

Aba General

Parâmetro	Descrição	Valor padrão	Tipo de dado
ZIP Operation	Define o tipo de operação (Compress, Multiple Compress ou Decompress).	Compress	String
Compression Method	Método de compactação a ser utilizado. As opções são: Store: Não compacta o arquivo. Recomendado para arquivos que já estão compactados ou que não precisam de compactação. Processamento mais rápido. Deflate: Compacta o arquivo. Adequado para a maioria dos tipos de dados, especialmente textos e arquivos com padrões repetidos. Processamento mais lento.	Store	String
ZIP Encryption Method	Método de criptografia ZIP a ser utilizado. As opções são: Zip Standard: Método básico de criptografia, compatível com a maioria das ferramentas ZIP. Segurança menor. AES: Advanced Encryption Standard. Oferece maior segurança, mas pode não ser compatível com todas as ferramentas ZIP.	Zip Standard	String
ZIP AES Key Strength	Define a força da chave de criptografia ao utilizar AES como ZIP Encryption Method. As opções são: Key Strength 128 e Key Strength 256.	Key Strength 128	String
File Name (DB)	Nome ou caminho completo do arquivo a ser compactado (por exemplo, tmp/processed/file.txt). Na operação Multiple Compress, este campo também aparece ao clicar em Add no parâmetro Files.	data.csv	String
Output File Name (DB)	Nome do arquivo ZIP a ser gerado.	data.zip	String
Fail On Error	Se ativado, interrompe a execução do pipeline ao ocorrer um erro. Se desativado, a execução continua, mas a propriedade "success" será definida como false.	False	Booleano

Aba Advanced

Parâmetro	Descrição	Valor padrão	Tipo de dado
Set password	Quando ativado, protege o arquivo ZIP com uma senha.	False	Boolean
Account	Conta utilizada pelo conector. Disponível apenas se o parâmetro Use Dynamic Account estiver desativado.	N/A	Account
Use Dynamic Account	Quando ativado, o conector utilizará a conta de forma dinâmica. Caso contrário, a conta será usada de forma estática.	False	Boolean
Scoped	Quando ativado, a conta armazenada será isolada de outros subprocessos. Nesse caso, subprocessos enxergarão sua própria versão dos dados da conta. Não é compatível com contas usadas em headers ou corpo da requisição. Disponível apenas se Use Dynamic Account estiver ativo.	False	Boolean
Account Name	Nome da conta dinâmica utilizada pelo conector. Essa conta deve ter sido previamente configurada por um conector Store Account no pipeline para que o processo funcione. Disponível apenas se Use Dynamic Account estiver ativo.	N/A	String

Aba Documentação

Parâmetro	Descrição	Valor padrão	Tipo de dado
Documentation	Campo opcional para descrever a configuração do conector e quaisquer regras de negócio relevantes.	N/A	String

Fluxo de mensagens

Entrada

O conector aceita qualquer mensagem de entrada, que pode ser referenciada com Double Braces ({{ }}).

Saída

Em caso de sucesso:

{
  "fileName": "data.csv",
  "success": true
}

Em caso de erro:

{
  "success": false,
  "message": "File data.csv already exists.",
  "exception": "com.digibee.pipelineengine.exception.PipelineEngineRuntimeException"
}

ZIP File V2 em ação

Resposta bem-sucedida

{
  "success": true,
  "outputFileName": "data.zip"
}

• outputFileName: Nome do arquivo ZIP gerado.

• success: true se a operação foi concluída com sucesso; caso contrário, false.

Resposta com erro

{
  "exception": "java.io.FileNotFoundException: /tmp/pipeline-engine/3b3755ad-4256-429a-8898-2f7eea80f7db/data1.csv (No such file or directory)",
  "message": "Encountered an I/O error while executing ZipFileConnector",
  "success": false
}

• success: false quando a operação falha.

• message: Descrição do erro ocorrido.

• exception: Detalhes técnicos do erro.

Manipulação de arquivos no pipeline

O pipeline utiliza uma área temporária e local para manipulação de arquivos, que é isolada e acessível apenas durante a execução.

Isso significa que o acesso aos arquivos funciona como um sistema de arquivos virtual. Os nomes dos arquivos podem conter qualquer caractere válido, extensões e caminhos relativos, como:

• data.csv

• processing/data.csv

Qualquer tentativa de acesso a caminhos absolutos será bloqueada durante a execução do pipeline.