Ler XLS/XLSX

Realiza a conversão dos dados recebidos de XLS/XLSX para um objeto Javascript.

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.

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

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

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.

1KB

ler-xls-xlsx.floui.json

Modelo de fluxo