Excel

Descubra mais sobre o componente Excel e saiba como utilizá-lo na Digibee Integration Platform.

O Excel lê e salva arquivos de Excel.

Parâmetros

Dê uma olhada nos parâmetros de configuração do componente. Parâmetros suportados por expressões Double Braces estão marcados com (DB).

ParâmetroDescriçãoValor padrãoTipo de dado

Operation

Ação a ser executada pelo componente (Read, Create, Read Specific Sheets, Read One Cell, Read Multiple Cell e Update One Cell).

Read

String

Excel Full Path

Caminho no qual o arquivo de Excel está localizado.

/Users/example.xlsx

String

File Name (DB)

Nome do arquivo ou full file path (ex: tmp/processed/file.txt).

example.xlsx

String

Sheet Name

Nome da planilha.

Planilha1

String

Cell

Especificação da célula da planilha.

A:1

String

Cells

Lista de células da planilha.

["A:1", "B:2", "C:6"]

Array de Strings

Cell Value

Valor a ser substituído em uma célula específica.

example

String

Sheets

Lista de nomes das planilhas.

["Planilha2", "Planilha4"]

Array de Strings

JSON Data

JSON a ser utilizado na geração do arquivo de Excel.

[{"src":"Images/Sun.png","name":"sun1","hOffset":250,"vOffset":250,"alignment":"center"},{"src":"Images/Sun.png","name":"sun1","hOffset":250,"vOffset":250,"alignment":"center"},{"src":"Images/Sun.png","name":"sun1","hOffset":250,"vOffset":250,"alignment":"center"},{"src":"Images/Sun.png","name":"sun1","hOffset":250,"vOffset":250,"alignment":"center"},{"src":"Images/Sun.png","name":"sun1","hOffset":250,"vOffset":250,"alignment":"center"}]

Array de Objetos (JSON)

Read All Sheets

Se a opção estiver ativada, todas as planilhas do arquivo de Excel serão lidas.

False

Booleano

Fail On Error

Se a opção estiver habilitada, a execução do pipeline com erro será interrompida; do contrário, a execução do pipeline continua, mas o resultado vai mostrar um valor falso para a propriedade "success".

True

Booleano

Fluxo de Mensagens

Operação Read

Lê um arquivo de Excel e gera um objeto de JSON com planilhas e linhas.

Os seus parâmetros são:

  • Read All Sheets (obrigatório)

  • Excel Full Path (obrigatório)

  • Sheet Name (obrigatório apenas se a opção Read All Sheets não estiver ativada)

Saída

Se você quiser ler todas as planilhas:

{
     "Sheet1": [{"A1": "A1 Content"},{"A2": "A2 Content"} ...],
     "Sheet2": [{"A1": "A1 Content"},{"A2": "A2 Content"} ...],
     ...
}

Se você quiser ler apenas uma planilha específica:

{
     "Sheet_Specified": [{"A1": "A1 Content"},{"A2": "A2 Content"} ...]
}

Operação Read Specific Sheets

Lê planilhas específicas passadas através de uma lista.

Os seus parâmetros são:

  • Excel Full Path (obrigatório)

  • Sheets (obrigatório)

Saída

{
      "Sheet_Specified1": [{"A1": "A1 Content"},{"A2": "A2 Content"} ...],
      "Sheet_Specified2": [{"A1": "A1 Content"},{"A2": "A2 Content"} ...],
      ...
}

Operação Read One Cell

Lê uma célula específica de um arquivo de Excel.

Os seus parâmetros são:

  • Sheet Name (obrigatório)

  • Excel Full Path (obrigatório)

  • Cell (obrigatório)

Saída

{
      "A1": "A1 Content"
}

Operação Read Multiple Cells

Lê múltiplas células de uma planilha de um arquivo de Excel passado através de uma lista.

Os seus parâmetros são:

  • Sheet Name (obrigatório)

  • Excel Full Path (obrigatório)

  • Cells (obrigatório)

Saída

{
     "A1": "A1 Content",
     "B1": "B1 Content",
     "X1": "X1 Content"
}

Operação Create

Cria um arquivo de Excel a partir do JSON passado.

Os seus parâmetros são:

  • Sheet Name

  • JSON Data (obrigatório)

  • File Name

Saída

{
     "localFilename": "path/to/the/file",
     "success": true
}

Operação Update One Cell

Atualiza uma célula específica de um arquivo de Excel.

Os seus parâmetros são:

  • Excel Full Path (obrigatório)

  • Cell (obrigatório)

  • Cell Value (obrigatório)

Saída

{
      "localFilename": "path/to/the/file",
      "success": true,
      "cellUpdated": {
           "A1": "A1 new Content"
      }
}

Atualizado