Excel

Leitura e escrita de planilhas Excel, direto no arquivo ou no Excel na tela

Abrir Planilha

excel.open_workbook

Abre arquivo Excel, direto ou no Excel na tela

Como usar

Abre um arquivo Excel e guarda a planilha na variável usada pelos demais comandos. Em "Abrir com", "Só o arquivo" lê e grava o arquivo direto, sem precisar do Excel instalado. "Excel, na tela" abre a planilha no Excel para você acompanhar o robô trabalhando; "Excel, oculto" usa o Excel sem mostrar a janela. Com o Excel, as fórmulas são calculadas na hora, arquivos .xls antigos funcionam e ficam disponíveis Executar Macro e Atualizar Dados e Fórmulas. Planilhas que continuarem abertas no Excel no fim do robô são fechadas sem salvar. Com "Ler resultado das fórmulas", as células com fórmula trazem o valor calculado; desmarque para ler a fórmula. Use "Somente leitura" para abrir planilhas grandes mais rápido.

Exemplo: Abra C:\Robos\entrada\pedidos.xlsx com "Excel, na tela" em {workbook} para acompanhar o preenchimento.

Campos

Campo	Tipo	Padrão	Detalhes
Arquivo *	Arquivo
Abrir com	Opção	`Só o arquivo (sem abrir o Excel)`	Na tela, você vê o robô preenchendo a planilha. As opções com Excel precisam do Excel instalado na máquina.Opções: Só o arquivo (sem abrir o Excel), Excel, na tela (acompanhar o robô), Excel, oculto
Salvar planilha na variável *	Variável de saída	`workbook`

+ Avançado (2)

Campo	Tipo	Padrão	Detalhes
Somente leitura	Sim/Não	`Não`
Ler resultado das fórmulas	Sim/Não	`Sim`

Resultado: guardado na variável workbook (Objeto).

Criar Planilha

excel.create_workbook

Cria nova planilha vazia

Como usar

Cria uma planilha nova, com uma aba. Escreva os dados e use Salvar Planilha com um caminho para gravar o arquivo. Com "Abrir com: Excel, na tela", a planilha nova aparece no Excel e você acompanha o preenchimento.

Exemplo: Crie {workbook}, escreva o relatório e salve como C:\Robos\saida\relatorio.xlsx.

Campos

Campo	Tipo	Padrão	Detalhes
Abrir com	Opção	`Só o arquivo (sem abrir o Excel)`	Na tela, você vê o robô preenchendo a planilha. As opções com Excel precisam do Excel instalado na máquina.Opções: Só o arquivo (sem abrir o Excel), Excel, na tela (acompanhar o robô), Excel, oculto
Salvar planilha na variável *	Variável de saída	`workbook`

Resultado: guardado na variável workbook (Objeto).

Selecionar Aba

excel.select_sheet

Seleciona aba por nome ou índice

Como usar

Escolhe a aba ativa pelo nome ou posição; os comandos com o campo Aba vazio usam a aba ativa. Pode criar a aba se ela não existir.

Exemplo: Selecione a aba "Resumo", criando se não existir.

Campos

Campo	Tipo	Padrão	Detalhes
Planilha *	Variável	`workbook`
Aba *	Texto

+ Avançado (1)

Campo	Tipo	Padrão	Detalhes
Criar se não existir	Sim/Não	`Não`

Ler Célula

excel.read_cell

Lê valor de uma célula (ex: A1)

Como usar

Lê o valor de uma célula (como B2) e guarda numa variável, com o tipo certo: número, texto, data ou vazio.

Exemplo: Leia a célula F1 da aba "Parâmetros" em {data_corte}.

Campos

Campo	Tipo	Padrão
Planilha *	Variável	`workbook`
Aba	Texto
Célula *	Texto	`A1`
Salvar resultado na variável *	Variável de saída	`cell_value`

Resultado: guardado na variável cell_value (Qualquer).

Escrever Célula

excel.write_cell

Escreve valor em uma célula

Como usar

Escreve um valor numa célula. Números e datas são gravados como tal; texto começando com = vira fórmula.

Exemplo: Escreva {status} na célula G{linha} para marcar o pedido processado.

Campos

Campo	Tipo	Padrão	Detalhes
Planilha *	Variável	`workbook`
Aba	Texto		Nome ou índice; vazio = aba ativa
Célula *	Texto	`A1`
Valor *	Texto

Ler Intervalo

excel.read_range

Lê intervalo de células (ex: A1:D10)

Como usar

Lê um intervalo (como A2:D50) como lista de linhas, cada linha uma lista de valores. Para tabelas com cabeçalho, Ler Aba para DataFrame costuma ser mais prático.

Exemplo: Leia A2:C{ultima_linha} em {linhas} e percorra com Para Cada.

Campos

Campo	Tipo	Padrão	Detalhes
Planilha *	Variável	`workbook`
Aba	Texto		Nome ou índice; vazio = aba ativa
Intervalo *	Texto	`A1:D10`
Salvar resultado na variável *	Variável de saída	`values`

Resultado: guardado na variável values (Lista).

Escrever Intervalo

excel.write_range

Escreve uma lista/DataFrame em intervalo

Como usar

Escreve uma lista de linhas ou uma tabela de dados (DataFrame) a partir da célula inicial, com o cabeçalho do DataFrame se marcado.

Exemplo: Escreva {resultado} a partir de A1 da aba "Saída".

Campos

Campo	Tipo	Padrão	Detalhes
Planilha *	Variável	`workbook`
Aba	Texto		Nome ou índice; vazio = aba ativa
Célula inicial *	Texto	`A1`
Dados (lista ou DataFrame) *	Variável	`data`
Escrever cabeçalho do DataFrame	Sim/Não	`Sim`

Ler Aba para DataFrame

excel.read_sheet_df

Carrega aba inteira como DataFrame Pandas

Como usar

Lê uma aba inteira direto do arquivo como tabela de dados (DataFrame), usando a linha do cabeçalho para nomear as colunas. É o jeito mais rápido de trabalhar com tabelas: filtre e agrupe com os comandos de Dados e percorra com Iterar Linhas.

Exemplo: Leia a aba "Pedidos" de pedidos.xlsx em {df} e filtre os com Situação = "Pendente".

Campos

Campo	Tipo	Padrão	Detalhes
Arquivo Excel *	Arquivo
Aba	Texto		Nome ou índice; vazio = aba ativa
Linha do cabeçalho	Número	`1`	0 = sem cabeçalho
Salvar resultado na variável *	Variável de saída	`dataframe`

Resultado: guardado na variável dataframe (Tabela (DataFrame)).

Escrever DataFrame na Aba

excel.write_df_sheet

Exporta DataFrame para aba

Como usar

Grava uma tabela de dados (DataFrame) numa aba do arquivo Excel. Se o arquivo existir, escolha: substituir a aba, criar arquivo novo ou acrescentar as linhas ao fim da aba.

Exemplo: Grave {df_resumo} na aba "Resumo" de resultado.xlsx, substituindo a aba.

Campos

Campo	Tipo	Padrão	Detalhes
DataFrame *	Variável	`dataframe`
Arquivo Excel *	Arquivo
Aba *	Texto	`Planilha1`
Se o arquivo existir	Opção	`Substituir a aba`	Opções: Substituir a aba, Sobrescrever o arquivo, Acrescentar linhas

+ Avançado (1)

Campo	Tipo	Padrão	Detalhes
Escrever índice	Sim/Não	`Não`

Obter Última Linha

excel.get_last_row

Retorna número da última linha com dados

Como usar

Devolve o número da última linha com dados, na aba toda ou só numa coluna. Use para saber onde acrescentar novos registros ou até onde ler.

Exemplo: Obtenha a última linha da coluna A em {ultima_linha} e escreva o novo registro em A{ultima_linha + 1}.

Campos

Campo	Tipo	Padrão	Detalhes
Planilha *	Variável	`workbook`
Aba	Texto		Nome ou índice; vazio = aba ativa
Salvar resultado na variável *	Variável de saída	`last_row`

+ Avançado (1)

Campo	Tipo	Padrão	Detalhes
Somente na coluna	Texto		Ex.: `A`

Resultado: guardado na variável last_row (Número).

Obter Última Coluna

excel.get_last_column

Retorna letra da última coluna com dados

Como usar

Devolve a letra da última coluna com dados da aba.

Exemplo: Obtenha a última coluna em {ultima_coluna} para ler o cabeçalho completo A1:{ultima_coluna}1.

Campos

Campo	Tipo	Padrão	Detalhes
Planilha *	Variável	`workbook`
Aba	Texto		Nome ou índice; vazio = aba ativa
Salvar resultado na variável *	Variável de saída	`last_column`

Resultado: guardado na variável last_column (Texto).

Inserir Linha

excel.insert_row

Insere uma linha na posição especificada

Como usar

Insere linhas vazias na posição informada, empurrando as de baixo.

Exemplo: Insira 1 linha na posição 2 para colocar o registro mais recente no topo.

Campos

Campo	Tipo	Padrão	Detalhes
Planilha *	Variável	`workbook`
Aba	Texto		Nome ou índice; vazio = aba ativa
Linha *	Número	`2`
Quantidade	Número	`1`

Deletar Linha

excel.delete_row

Remove uma linha

Como usar

Remove linhas a partir da posição informada, subindo as de baixo. Ao apagar várias em sequência, vá de baixo para cima para não pular linhas.

Exemplo: Delete a linha {linha} quando o pedido estiver cancelado.

Campos

Campo	Tipo	Padrão	Detalhes
Planilha *	Variável	`workbook`
Aba	Texto		Nome ou índice; vazio = aba ativa
Linha *	Número	`2`
Quantidade	Número	`1`

Copiar Intervalo

excel.copy_range

Copia intervalo de células

Como usar

Copia os valores de um intervalo para outra posição, na mesma aba ou em outra.

Exemplo: Copie A1:F1 (cabeçalho) da aba "Modelo" para A1 da aba "Mês atual".

Campos

Campo	Tipo	Padrão	Detalhes
Planilha *	Variável	`workbook`
Aba	Texto		Nome ou índice; vazio = aba ativa
Intervalo de origem *	Texto	`A1:D10`
Aba de destino	Texto
Célula de destino *	Texto	`F1`

Formatar Células

excel.format_cells

Aplica formatação (fonte, cor, borda)

Como usar

Aplica formatação a um intervalo: negrito, cor da fonte e do fundo (hex, como FF0000), formato de número (como #,##0.00 ou dd/mm/aaaa) e borda fina.

Exemplo: Deixe A1:F1 em negrito com fundo D9E1F2 e aplique #,##0.00 na coluna de valores.

Campos

Campo	Tipo	Padrão	Detalhes
Planilha *	Variável	`workbook`
Aba	Texto		Nome ou índice; vazio = aba ativa
Intervalo *	Texto	`A1:D1`
Negrito	Sim/Não	`Não`
Cor da fonte	Texto		Ex.: `#000000`
Cor de fundo	Texto		Ex.: `#FFFF00`

+ Avançado (2)

Campo	Tipo	Padrão	Detalhes
Formato de número	Texto		Ex.: `#,##0.00`
Borda fina	Sim/Não	`Não`

Adicionar Gráfico

excel.add_chart

Insere gráfico na planilha

Como usar

Insere um gráfico (colunas, barras, linhas ou pizza) a partir de um intervalo de dados, na célula indicada, com título opcional.

Exemplo: Adicione um gráfico de colunas de A1:B13 na posição H2 com o título "Vendas por mês".

Campos

Campo	Tipo	Padrão	Detalhes
Planilha *	Variável	`workbook`
Aba	Texto		Nome ou índice; vazio = aba ativa
Intervalo de dados *	Texto	`A1:B10`
Tipo de gráfico	Opção	`Colunas`	Opções: Colunas, Barras, Linhas, Pizza
Posição (célula)	Texto	`H2`
Título	Texto

Auto Filtro

excel.auto_filter

Aplica filtro automático

Como usar

Liga o filtro automático do Excel no intervalo (ou na área usada), para quem abrir a planilha filtrar as colunas.

Exemplo: Aplique o auto filtro no relatório antes de enviar ao financeiro.

Campos

Campo	Tipo	Padrão	Detalhes
Planilha *	Variável	`workbook`
Aba	Texto		Nome ou índice; vazio = aba ativa
Intervalo (vazio = área usada)	Texto

Executar Macro

excel.run_macro

Executa uma macro VBA da planilha aberta no Excel

Como usar

Executa uma macro (VBA) de uma planilha aberta com "Abrir com: Excel" e guarda o que ela devolver. Informe o nome da macro, como AtualizarPrecos ou Modulo1.AtualizarPrecos, e os argumentos na ordem, um por linha. A planilha precisa ter as macros (em geral, um arquivo .xlsm).

Exemplo: Execute a macro FecharMes com o argumento {mes} e guarde o resultado em {macro_result}.

Campos

Campo	Tipo	Padrão	Detalhes
Planilha *	Variável	`workbook`
Nome da macro *	Texto		Ex.: `Modulo1.AtualizarPrecos`
Argumentos (na ordem)	Lista		Um argumento por linha; deixe vazio se a macro não recebe nenhum
Salvar resultado na variável *	Variável de saída	`macro_result`

Resultado: guardado na variável macro_result (Qualquer).

Atualizar Dados e Fórmulas

excel.refresh_all

Atualiza consultas e tabelas dinâmicas e recalcula

Como usar

Faz o mesmo que Dados > Atualizar Tudo no Excel: atualiza consultas, conexões e tabelas dinâmicas, espera terminar e recalcula todas as fórmulas. Funciona com planilhas abertas com "Abrir com: Excel".

Exemplo: Atualize {workbook} antes de ler os totais da aba "Resumo".

Campos

Campo	Tipo	Padrão	Detalhes
Planilha *	Variável	`workbook`

Salvar Planilha

excel.save_workbook

Salva o arquivo Excel

Como usar

Salva a planilha no mesmo arquivo ou, com um caminho, como um arquivo novo.

Exemplo: Salve {workbook} como C:\Robos\saida\pedidos_{data}.xlsx.

Campos

Campo	Tipo	Padrão	Detalhes
Planilha *	Variável	`workbook`
Salvar como (vazio = mesmo arquivo)	Arquivo

Fechar Planilha

excel.close_workbook

Fecha sem salvar (ou salvando)

Como usar

Fecha a planilha, salvando antes se marcado, e libera o arquivo para outros programas.

Exemplo: Feche {workbook} salvando, ao terminar de atualizar os status.

Campos

Campo	Tipo	Padrão	Detalhes
Planilha *	Variável	`workbook`
Salvar antes de fechar	Sim/Não	`Não`

Converter para PDF

excel.convert_to_pdf

Converte planilha para PDF (requer Excel instalado)

Como usar

Gera um PDF da planilha (ou só de uma aba) usando o Excel instalado na máquina, com a formatação de impressão dele.

Exemplo: Converta relatorio.xlsx em relatorio.pdf, só a aba "Resumo", para anexar no e-mail.

Campos

Campo	Tipo	Padrão	Detalhes
Arquivo Excel *	Arquivo
Arquivo PDF *	Arquivo

+ Avançado (1)

Campo	Tipo	Padrão	Detalhes
Somente esta aba	Texto