# ZIP File V2

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](/documentation/connectors-and-triggers/pt-br/double-braces/overview.md) estão marcados com `(DB)`.

### **Aba General**

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

### **Aba Advanced**

<table data-full-width="true"><thead><tr><th>Parâmetro</th><th>Descrição</th><th>Valor padrão</th><th>Tipo de dado</th></tr></thead><tbody><tr><td><strong>Set password</strong></td><td>Quando ativado, protege o arquivo ZIP com uma senha.</td><td>False</td><td>Boolean</td></tr><tr><td><strong>Account</strong></td><td><a href="/spaces/cO0A6g1dOsu8BiHYqO67/pages/fS1QLzAg8rGSSJFwtrvy">Conta</a> utilizada pelo conector. Disponível apenas se o parâmetro <strong>Use Dynamic Account</strong> estiver <strong>desativado</strong>.</td><td>N/A</td><td>Account</td></tr><tr><td><strong>Use Dynamic Account</strong></td><td>Quando ativado, o conector utilizará a conta de forma dinâmica. Caso contrário, a conta será usada de forma estática.</td><td>False</td><td>Boolean</td></tr><tr><td><strong>Scoped</strong></td><td>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 <strong>Use Dynamic Account</strong> estiver <strong>ativo</strong>.</td><td>False</td><td>Boolean</td></tr><tr><td><strong>Account Name</strong></td><td>Nome da conta dinâmica utilizada pelo conector. Essa conta deve ter sido previamente configurada por um conector <a href="https://docs.digibee.com/documentation/pt-br/reference-guides/connectors/tools/store-account"><strong>Store Account</strong></a> no pipeline para que o processo funcione. Disponível apenas se <strong>Use Dynamic Account</strong> estiver ativo.</td><td>N/A</td><td>String</td></tr></tbody></table>

### **Aba Documentação**

<table data-full-width="true"><thead><tr><th>Parâmetro</th><th>Descrição</th><th>Valor padrão</th><th>Tipo de dado</th></tr></thead><tbody><tr><td><strong>Documentation</strong></td><td>Campo opcional para descrever a configuração do conector e quaisquer regras de negócio relevantes.</td><td>N/A</td><td>String</td></tr></tbody></table>

## **Fluxo de mensagens**

### **Entrada**

O conector aceita qualquer mensagem de entrada, que pode ser referenciada com [Double Braces](/documentation/connectors-and-triggers/pt-br/double-braces/overview.md) (`{{ }}`).

### **Saída**

Em caso de sucesso:

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

Em caso de erro:

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

## **ZIP File V2 em ação**

### **Resposta bem-sucedida**

```json
{
  "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**

```json
{
  "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.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.digibee.com/documentation/connectors-and-triggers/pt-br/connectors/files/zip-file-v2.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.