Excel

As ações do Excel permitem que você leia, atualize e crie arquivos do Excel em suas automações. Todas as ações do Excel oferecem suporte aos formatos de arquivo.xlsx e .xlsm. Os identificadores da pasta de trabalho mantêm referências em várias operações.

nota

Embora os valores possam ser lidos em arquivos.xlsm, a execução de macros não é suportada.

Criar nova pasta de trabalho

Cria um arquivo Excel em branco. Produz um identificador de pasta de trabalho que você pode usar para atualizar a planilha nas etapas subsequentes.

Propriedades:

• Identificador da pasta de trabalho (saída): nome da variável que armazena a referência da pasta de trabalho para ações futuras (padrão:) workbook_id

Abrir pasta de trabalho existente

Carrega um arquivo Excel existente. Retorna um identificador de pasta de trabalho que você pode usar para atualizar a planilha nas etapas subsequentes. Suporta somente arquivos Excel (.xlsx).

Propriedades:

• Arquivo Excel (obrigatório): o arquivo.xlsx a ser aberto, normalmente armazenado em uma variável (por exemplo,) my_file

• Identificador da pasta de trabalho (saída): nome da variável que armazena a referência da pasta de trabalho (padrão:) workbook_id

Requisitos de arquivo:

• Deve ser um arquivo Excel (.xlsx) válido

• O arquivo deve estar acessível como um objeto de arquivo de mídia

Salvar pasta de trabalho

Salva as atualizações em um arquivo do Excel. Permite que você atualize o nome e o tipo de arquivo da pasta de trabalho salva.

Propriedades:

• Nome do arquivo (obrigatório): nome do arquivo salvo sem extensão (por exemplo, “Relatório mensal”)

• Tipo de arquivo (lista suspensa): formato de saída - atualmente suporta XLSX (padrão: XLSX)

• Arquivo salvo (saída): variável que armazena o objeto de arquivo salvo (padrão:saved_file)

Leia a planilha

Obtém dados de uma variedade de células. A ação armazena a saída em uma variável da tabela de dados.

Propriedades:

• Identificador da pasta de trabalho (obrigatório): a pasta de trabalho a ser lida (por exemplo,) workbook_id

• Nome da planilha (obrigatório): nome da planilha ou guia (padrão: “Planilha1")

• Intervalo de células (opcional): especificação de intervalo - suporta vários formatos:

  • Célula inicial: “A2" (lê todos os dados do ponto de ancoragem)

  • Alcance exato: “A1:B10"

  • Intervalo de colunas: “A:B”

  • Intervalo de linhas: "1:3”

  • Vazio: lê a folha inteira

• Incluir cabeçalhos (caixa de seleção): trata a primeira linha como cabeçalhos de coluna quando ativada. Quando desativado, usa a nomenclatura padrão (Coluna0, Coluna1 etc.) (padrão: TRUE)

• Tabela de dados (saída): variável que armazena os dados extraídos (padrão:excel_table)

Manipulação da fórmula:

• A ação calcula automaticamente as fórmulas e armazena os resultados na tabela de dados.

Célula de leitura

Obtém o valor de uma célula. Usado para ler um valor de célula individual de uma planilha.

Propriedades:

• Identificador da pasta de trabalho (obrigatório): a pasta de trabalho a ser lida (por exemplo,) workbook_id

• Nome da planilha (obrigatório): nome da planilha (padrão: “Planilha1")

• Referência da célula (obrigatório): localização da célula (por exemplo, “A1")

• Valor da célula (saída): variável que armazena o conteúdo da célula (padrão:cell_value)

Gravar na planilha

Produz uma tabela de dados em uma planilha. Usado para gravar uma variedade de linhas e colunas em uma planilha.

Propriedades:

• Tabela de dados (obrigatória): A tabela de dados a ser gravada (por exemplo,my_table)

• Identificador da pasta de trabalho (obrigatório): pasta de trabalho de destino (por exemplo,) workbook_id

• Nome da planilha (obrigatório): planilha de destino (padrão: “Planilha1")

• Iniciar na célula (opcional): posição inicial para posicionamento de dados (padrão: “A1")

• Incluir cabeçalhos (caixa de seleção): grava cabeçalhos de coluna quando ativado (padrão: TRUE)

Escrever para a célula

Exibe um valor para uma célula. Usado para atualizar células individuais em uma planilha.

Propriedades:

• Valor a ser gravado (obrigatório): conteúdo da célula (por exemplo, “Pedido #12345 “)

• Identificador da pasta de trabalho (obrigatório): pasta de trabalho de destino (por exemplo,) workbook_id

• Nome da planilha (obrigatório): planilha de destino (padrão: “Planilha1")

• Referência da célula (obrigatório): localização da célula alvo (por exemplo, “A1")

Escrever nova linha

Adiciona uma linha de dados à planilha. A nova linha é anexada ao final dos dados existentes.

Propriedades:

• Valores de linha (obrigatório): matriz de valores para a nova linha, começando pela primeira coluna (por exemplo, ["Q1", “Vendas”, 100])

• Identificador da pasta de trabalho (obrigatório): pasta de trabalho de destino (por exemplo,) workbook_id

• Nome da planilha (obrigatório): planilha de destino (padrão: “Planilha1")

Validação de dados:

• Deve fornecer valores como um formato de matriz

• Os valores são escritos sequencialmente a partir da primeira coluna

Criar nova planilha

Adiciona uma planilha em branco. A nova planilha é adicionada ao final da pasta de trabalho.

Propriedades:

• Identificador da pasta de trabalho (obrigatório): pasta de trabalho de destino (por exemplo,) workbook_id

• Nome da planilha (obrigatório): Nome da nova planilha (por exemplo, “Dados de vendas”)

Folha de cópia

Cria uma cópia da planilha. A nova planilha é criada na mesma pasta de trabalho.

Propriedades:

• Identificador da pasta de trabalho (obrigatório): pasta de trabalho de destino (por exemplo,) workbook_id

• Nome da planilha a ser copiada (obrigatório): nome da planilha de origem (por exemplo, “Planilha original”)

• Nome da nova planilha (obrigatório): Nome da planilha duplicada (por exemplo, “Folha original (cópia)”)

Renomear planilha

Atualiza o nome de uma planilha existente.

Propriedades:

• Identificador da pasta de trabalho (obrigatório): pasta de trabalho de destino (por exemplo,) workbook_id

• Nome da planilha atual (obrigatório): nome da planilha existente (por exemplo, “Planilha1")

• Nome da planilha atualizado (obrigatório): Novo nome para a planilha (por exemplo, “Dados do primeiro trimestre”)

Excluir planilha

Remove uma planilha de uma pasta de trabalho. Não é possível excluir a última planilha restante de uma pasta de trabalho.

Propriedades:

• Identificador da pasta de trabalho (obrigatório): pasta de trabalho de destino (por exemplo,) workbook_id

• Nome da planilha a ser excluída (obrigatório): planilha a ser removida (por exemplo, “Planilha1")

Restrições:

• Não é possível excluir a última planilha restante em uma pasta de trabalho

Definir cor da célula

Atualiza a cor de fundo da célula. Usado para destacar um intervalo específico de células.

Propriedades:

• Cor da célula (obrigatório): formato de código hexadecimal RGB (por exemplo, "FF0000" para vermelho)

• Identificador da pasta de trabalho (obrigatório): pasta de trabalho de destino (por exemplo,) workbook_id

• Nome da planilha (obrigatório): planilha de destino (por exemplo, “Planilha1")

• Intervalo de células (obrigatório): intervalo para formatar - suporta:

  • Célula única: “A1"

  • Alcance exato: “A1:B10"

  • Intervalo de colunas: “A:B”

  • Intervalo de linhas: "1:3”

Obtenha a cor da célula

Lê a cor de fundo da célula. Produz a cor no formato de código hexadecimal RGB (por exemplo, "FF0000" para vermelho).

Propriedades:

• Identificador da pasta de trabalho (obrigatório): pasta de trabalho de origem (por exemplo,) workbook_id

• Nome da planilha (obrigatório): planilha de origem (por exemplo, “Planilha1")

• Referência de célula (obrigatório): Célula a ser lida (por exemplo, “A1")

• Cor da célula (saída): variável que armazena código hexadecimal RGB (padrão:) cell_color

Ocultar linhas

Faz linhas ocultas na planilha. Os dados permanecem intactos, mas não são visíveis.

Propriedades:

• Identificador da pasta de trabalho (obrigatório): pasta de trabalho de destino (por exemplo,) workbook_id

• Nome da planilha (obrigatório): planilha de destino (por exemplo, “Planilha1")

• Linha inicial (obrigatório): número da primeira linha a ser ocultado (a numeração do Excel começa em 1)

• Linha final (opcional): número da última linha a ser ocultada. Se estiver vazio, somente a linha inicial ficará oculta

Numeração de linhas:

• Os números das linhas do Excel começam em 1 (não 0)

• Deve fornecer valores inteiros

Exibir linhas

Torna as linhas ocultas visíveis. Usado para mostrar linhas anteriormente ocultas.

Propriedades:

• Identificador da pasta de trabalho (obrigatório): pasta de trabalho de destino (por exemplo,) workbook_id

• Nome da planilha (obrigatório): planilha de destino (por exemplo, “Planilha1")

• Linha inicial (obrigatório): número da primeira linha a ser exibido (a numeração do Excel começa em 1)

• Linha final (opcional): número da última linha a ser exibida. Se estiver vazio, somente a linha inicial ficará visível

Melhores práticas e limitações

Gerenciamento de identificadores de pasta de trabalho

• Armazene identificadores da pasta de trabalho em variáveis descritivas (por exemplo,,) sales_workbook report_file

• Reutilize o mesmo identificador em várias ações na mesma pasta de trabalho

• Sempre crie ou abra uma pasta de trabalho antes de realizar operações de dados

Especificações de alcance

• Use intervalos exatos (“A1:B10") para operações de dados precisas

• Use intervalos de colunas (“A:B”) ao trabalhar com colunas inteiras

• Use intervalos de linhas (” 1:3 “) para operações de cabeçalho ou resumo

• Deixe o intervalo vazio para processar folhas inteiras

Otimização do desempenho

• Leia intervalos inteiros quando possível, em vez de células individuais

• Operações de gravação em lote usando tabelas de dados em vez de gravações de células individuais

• Salve pastas de trabalho somente quando todas as modificações estiverem concluídas

Limitação

A compatibilidade de arquivos é limitada somente ao formato Excel moderno (.xlsx) - arquivos antigos do Excel (.xls) não são suportados.