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âmetro	Descrição	Valor padrão	Tipo 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"
      }
}