XLSX

O conector XLSX permite ler e transformar arquivos .xlsx em JSON diretamente em fluxos da Fluid. Não requer autenticação nem conexão. É útil para manipular planilhas recebidas por FTP, SFTP, APIs ou arquivos base64.

Não há documentação externa vinculada, pois o processamento é feito internamente pela Fluid.

Este conector não requer conexão.

O conector possui duas operações principais para leitura de arquivos .xlsx:

Descrição: Selecione esta operação para transformar um arquivo .xlsx já carregado na memória (via FTP/SFTP ou outro passo anterior) em um objeto JSON.

Campos requeridos:

Campos opcionais:

Descrição: Transforme diretamente um conteúdo .xlsx codificado em base64 para JSON.

Campos requeridos:

Campos opcionais:

A operação Criar arquivo XLSX do conector XLSX permite criar um arquivo Excel (.xlsx) a partir de dados JSON e retorna o arquivo gerado em formato base64. Esta operação é útil para gerar relatórios, planilhas e outros documentos estruturados a partir de dados dinâmicos.

Parâmetros de Entrada

A operação Criar arquivo XLSX requer os seguintes parâmetros:

Campos Obrigatórios



Campos Opcionais



Exemplo de JSON de Entrada

Criando XLSX com dados de objetos (recomendado)

Criando XLSX com dados de array simples

Exemplo de JSON de Saída

Resposta de Sucesso

A operação Leitura Paginada (readPage) do conector XLSX permite converter um arquivo .xlsx em JSON de forma paginada, ou seja, lendo apenas um intervalo específico de linhas da planilha. Isso é especialmente útil para processar arquivos grandes de forma segmentada, evitando sobrecarga de memória e permitindo o tratamento dos dados em lotes.

Parâmetros gerais

Entrada XLSX

A operação readPage suporta dois formatos de entrada para o arquivo XLSX. Você deve escolher um deles:

Opção 1 — Base64 (useBase64)

Utilize esta opção quando o conteúdo do arquivo XLSX estiver disponível em formato Base64 (por exemplo, recebido via API ou extraído de outra integração).

Opção 2 — Path (usePath)

Utilize esta opção quando o arquivo XLSX estiver disponível em cache, inserido por um passo anterior do fluxo (ex.: FTP, SFTP, etc.).

Exemplos:

Exemplo 1 — Leitura paginada com Base64

Neste exemplo, o arquivo é fornecido em Base64 e a leitura é feita das linhas 1 a 100, com tratamento de cabeçalho habilitado.

Exemplo 2 — Leitura paginada com Path (arquivo em cache)

Neste exemplo, o arquivo foi inserido em cache por um passo anterior (ex.: download via FTP) e a leitura é feita das linhas 50 a 150, sem tratamento de cabeçalho.

Exemplo 3 — Leitura paginada até o final do arquivo

Quando o parâmetro end_row é deixado em branco ou com valor 0, a leitura será feita a partir da start_row até a última linha da planilha.

A operação appendSheet permite adicionar uma nova aba (planilha) a um arquivo XLSX existente no diretório temporário do fluxo. Além de criar a aba, a operação permite opcionalmente populá-la com dados estruturados (JSON) no momento da criação. Essa funcionalidade é ideal para organizar relatórios em múltiplas abas de forma dinâmica e eficiente.

Parâmetros de Entrada

A operação permite adicionar novas linhas ao final de uma página existente em um arquivo XLSX, mantendo toda a estilização original da planilha (como cores, fontes, bordas e células mescladas) intacta. O conector identifica automaticamente a última linha preenchida com conteúdo real e insere os novos dados logo abaixo, evitando pular linhas em branco ou criar espaços vazios indesejados.

Parâmetros

Os dados a serem inseridos devem ser passados através de Template, em formato JSON de matriz (array de arrays). Cada item representa uma linha a ser adicionada:

Exemplo de Preenchimento (Template)

Dicas e Boas Práticas

Quando os dados são um array de objetos, as chaves do primeiro objeto são usadas como cabeçalhos da planilha:

Entrada:

Resultado na planilha:

Para dados tabulares simples onde você controla completamente a estrutura:

Entrada:

Resultado na planilha:

Um objeto único será convertido em uma linha com suas chaves como cabeçalhos:

Entrada:

Resultado na planilha:

Neste tópico iremos criar um fluxo de conversão de um .xlsx em json via tráfego em base64 (muito comum o tráfego desses tipos de arquivos via api's)

Assim ficará a Parametrização do nosso primeiro e único passo:

Na aba Propriedades informamos o nome do passo:

Com o passo configurado basta disparar o fluxo sem a necessidade de informar um payload de entrada:

Após o disparo, o resultado do fluxo aparecerá em realtime no canvas:

Ao clicar em detalhes, temos a planilha no formato json convertida pelo conector XLSX:

O conector XLSX é uma solução rápida e sem autenticação para transformar planilhas em dados estruturados dentro dos fluxos da Fluid. Ideal para pipelines de integração que envolvem dados tabulares.