# Ler XLS/XLSX {% hint style="warning" %} Atenção, os dados precisam estar em binário para seguir com a conversão em objetos Javascript. A aba Instruções contém um exemplo de como o arquivo pode ser lido dentro do Fluxo. {% endhint %} {% tabs %} {% tab title="Parâmetros" %}

Parâmetros de configuração

| Campo | Tipo | Descrição | | ----------------------------------------------------------- | -------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Descrição | Campo de texto | Descrição visual do conector no editor de fluxo | | Modo | Seletor |

Permite selecionar a forma em que o conteúdo em XLS/XLSX será lido e convertido para planilha. Opções:

| | Incluir células vazias | Seletor | Disponível quando é selecionado o modo De XLS/XLSX para um objeto JSON. Informa se deve ou não ignorar células vazias. | | Conteúdo da planilha XLS/XLSX | Campo de texto | Informa o caminho do conteúdo XLS/XLSX, dentro do objeto msg, para ser lido e convertido. O conteúdo precisa estar em binário para ser lido. | | Usar linha de cabeçalho como chave/valor na saída dos dados | Seletor | Disponível quando é selecionado o modo De XLS/XLSX para um objeto JSON ou De XLS/XLSX para um objeto JSON com range. Informa se deve usar a linha do cabeçalho da planilha (nome das colunas) como chave no objeto JSON. | | Célula que começará a busca | Campo de texto | Disponível quando é selecionado o modo De XLS/XLSX para um objeto JSON com range. Informa o início da captura dos dados da planilha para conversão em objeto JSON. | | Célula que terminará a busca | Campo de texto | Disponível quando é selecionado o modo De XLS/XLSX para um objeto JSON com range. Informa o fim da captura dos dados da planilha para conversão em objeto JSON. | | Células a serem buscadas, separadas por vírgula | Campo de texto | Disponível quando é selecionado o modo Captura o valor de uma célula do XLS/XLSX. Informa o caminho de células específicas para serem capturadas na planilha e convertidas em objeto JSON. | | Output Path | Campo de texto | Refere-se ao caminho de saída do conteúdo convertido no contexto de execução do conector | | {% endtab %} | | | {% tab title="Payload" %} ## Sucesso Caso optado por realizar a transformação padrão de XLSX/XLS para objeto, com ou sem range, a saída estará disponibilizada como lista de objetos JSON da seguinte forma. Cada objeto da lista é referente a uma linha (registro) da planilha.

Sucesso na conversão para objeto Javascript

A captura de células da planilha por range ocorre em formato de matriz ou grade, onde o primeiro valor define o ponto inicial da captura e o segundo valor determina o ponto final. O resultado incluirá todas as células dentro desse intervalo. Por exemplo, em uma planilha com as colunas A, B, C, D e as linhas 1, 2, 3, 4, ao definir um range de A1 até C3, serão capturadas todas as células dentro desse espaço (A1, A2, A3, B1, B2, B3, C1, C2 e C3).

Exemplo de captura de range

Ao capturar o valor específico de uma ou várias células o conteúdo será disponibilizado como um simples objeto JSON. Onde a chave é o identificador da célula e o valor é o conteúdo desta célula. Exemplo:

Exemplo de captura de valores específicos

{% endtab %} {% tab title="Instruções" %} ## Leitura da planilha Para realizar a conversão de uma planilha em objeto JSON, é necessário, primeiramente, que esta planilha seja lida no fluxo e convertida em binário. Há várias abordagens possíveis para realizar esta leitura, um exemplo é ler uma planilha armazenada dentro do Storage do Workspace da seguinte forma: * O conector File Reader irá localizar o arquivo XLS/XLSX no Storage do Workspace e irá converter em binário. * O conector Ler XLS/XLSX irá acessar o caminho da planilha convertida em binário, realizar a leitura e a conversão para objeto Javascript.

Exemplo de leitura de arquivo em Fluxo

Separamos a estrutura do fluxo utilizado nas capturas de tela. Para usá-lo, acesse um fluxo através da sua conta Floui e importe o arquivo abaixo. {% file src="" %} Modelo de fluxo {% endfile %} {% endtab %} {% endtabs %}