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.
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.
Last updated
Was this helpful?