# 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:
De XLS/XLSX para um objeto JSON;
De XLS/XLSX para um objeto JSON com range;
Captura o valor de uma célula do XLS/XLSX;
|
| 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="/files/lQlLRR918ZjbrnusXH62" %}
Modelo de fluxo
{% endfile %}
{% endtab %}
{% endtabs %}
---
# 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.floui.io/guia/conectores/categorias/manipulacao-de-dados/ler-xls-xlsx.md?ask=
```
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.
