Ler XLS/XLSX | Guia do usuário

Campo

Tipo

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

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.

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).

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:

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.

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.