XLS

objetivo o conector xls tem como objetivo permitir o processamento, transformação e modernização de arquivos de planilha legados no formato excel 97 2003 ( xls / ole2) principais cenários de uso modernização de dados legados conversão direta de relatórios antigos xls para o formato moderno xlsx extração de dados tabulares leitura de planilhas xls e transformação direta em coleções organizadas em formato json para alimentação de fluxos de trabalho e bancos de dados automação de processos financeiros e contábeis processamento automático de extratos e relatórios gerados por sistemas legados suporte flexível de entrada e saída leitura via arquivos físicos na pasta temporária ou via conteúdos codificados em base64 / data uris recurso conversão o recurso de conversão agrupa todas as ações destinadas a transformar arquivos no formato xls para formatos estruturados (json) ou modernos (xlsx) operação converter para json permite extrair os dados contidos em uma aba do arquivo xls e transformá los diretamente em uma estrutura de dados json parâmetros da operação parâmetro tipo obrigatório descrição tipo de conversão object sim origem da planilha xls (base64 ou arquivo na pasta temporária) nome da planilha string não nome da aba (sheet) que será convertida se omitido, converte a primeira aba (sheet1) tratar cabeçalhos boolean não define se a primeira linha será usada como chave dos objetos padrão true opções do tipo de conversão opção parâmetro tipo obrigatório descrição base64 valor de entrada string sim conteúdo do arquivo xls codificado em base64 (ou data uri) arquivo na pasta temporária nome do arquivo string sim nome do arquivo xls previamente salvo no /tmp (ex file xls) tratamento de cabeçalhos (header) habilitado (true) a primeira linha é tratada como cabeçalho a resposta retornará um array de objetos no formato \[{"coluna1" "valor1", "coluna2" "valor2"}] desabilitado (false) a resposta retornará uma matriz com todas as linhas brutas no formato de array de arrays \[\["coluna1", "coluna2"], \["valor1", "valor2"]] seleção de aba (sheet name) caso o campo nome da planilha seja deixado em branco, o conector identificará e converterá automaticamente a primeira aba contida no arquivo xls exemplo de resposta (com header true) \[ { "id" "1", "nome" "alice", "cargo" "desenvolvedora" }, { "id" "2", "nome" "bob", "cargo" "arquiteto" } ] operação converter para xlsx permite converter uma planilha legada no formato xls para o formato moderno xlsx (openxml) parâmetros da operação parâmetro tipo obrigatório descrição tipo de conversão object sim origem da planilha xls (base64 ou arquivo na pasta temporária) nome da planilha string não nome da aba que será convertida se omitido, converte a primeira aba (sheet1) salvar na pasta temporária object não define se o resultado xlsx será salvo no /tmp ou retornado em base64 tratar cabeçalhos boolean não define se a primeira linha será usada como cabeçalho padrão true opções do tipo de conversão opção parâmetro tipo obrigatório descrição base64 valor de entrada string sim conteúdo do arquivo xls codificado em base64 (ou data uri) arquivo na pasta temporária nome do arquivo string sim nome do arquivo xls previamente salvo no /tmp (ex file xls) opções de salvar na pasta temporária (save to tmp) opção parâmetro tipo obrigatório descrição sim nome do arquivo string sim nome do arquivo xlsx que será salvo na pasta temporária (ex file xlsx) não (nenhum) o arquivo retornado será disponibilizado diretamente em base64 na resposta salvar na pasta temporária vs retorno em base64 sim ( true) o arquivo xlsx gerado é gravado diretamente no diretório temporário do servidor (/tmp/{flowexecid}/), otimizando a memória durante a execução do fluxo a resposta conterá os metadados do arquivo gerado { "success" true, "file name" "relatorio xlsx", "message" "xlsx file created successfully in temporary folder!" } não ( false) o arquivo xlsx gerado é convertido para base64 e retornado no corpo da resposta da operação { "success" true, "file name" "relatorio xlsx", "base64" "uesdbbqabgaiaaaaiq ", "message" "xlsx file created successfully!" } na prática converter para json converter arquivo xls da pasta temporária para json com cabeçalho tipo de conversão arquivo na pasta temporaria nome do arquivo extrato xls tratar cabeçalhos true converter conteúdo base64 de arquivo xls para json (sem cabeçalho) tipo de conversão base64 valor de entrada data\ application/vnd ms excel;base64,0m8r4kgxgue tratar cabeçalhos false converter para xlsx converter xls em base64 e salvar no /tmp como dados xlsx tipo de conversão base64 valor de entrada 0m8r4kgxgue salvar na pasta temporária sim nome do arquivo dados xlsx converter xls da pasta temporária e receber o base64 na resposta tipo de conversão arquivo na pasta temporaria nome do arquivo relatorio antigo xls salvar na pasta temporária não observações finais formato legado o conector é específico para o formato binário excel 97 2003 ( xls) para manipulação nativa de planilhas modernas, utilize o conector xlsx conclusão o conector xls oferece a flexibilidade necessária para transformar planilhas legadas em fontes de dados estruturadas ou formatos modernos, permitindo que sua aplicação interaja com relatórios antigos de forma inteligente, rápida e segura