Depois de definir uma instância do Excel, com a ação Iniciar o Excel ou Anexar ao Excel em execução, você pode usar ainda mais suas planilhas do Excel.
Para ler e extrair dados de um documento Excel, use a ação Ler da planilha do Excel. Você pode recuperar o valor de uma única célula ou uma tabela de dados. O exemplo a seguir lê as células A1 a E5:
Quando o fluxo é executado, a ação armazena os dados em uma variável da tabela de dados:
Para gravar os dados em uma planilha do Excel, use a ação Gravar na planilha do Excel. Essa ação pode gravar qualquer dado estático ou variável em uma célula especificada ou em várias células de uma planilha do Excel.
O exemplo a seguir grava a tabela de dados mencionada anteriormente na célula A51:
Cada célula na tabela de dados preenche a célula correspondente na pasta de trabalho. O resultado é que o intervalo de células A51 a E55 é preenchido com o conteúdo da tabela de dados.
Redimensionar colunas/linhas na planilha do Excel
Redimensiona uma seleção de colunas ou linhas na planilha ativa de uma instância do Excel.
| Argumento |
Opcional |
Aceita |
Valor padrão |
Descrição |
| Excel instance |
Não |
Instância do Excel |
|
Especifique a instância do Excel. Essa variável deverá ter sido especificada anteriormente em uma ação Iniciar o Excel. |
| Redimensionar destino |
N/A |
Coluna, linha |
Column |
Especificar se é para redimensionar colunas ou linhas |
| Intervalo de seleção |
N/A |
Único, Intervalo, Tudo disponível |
Único |
Especificar se você deve selecionar uma única coluna/linha, um intervalo de colunas/linhas ou todas as colunas/linhas disponíveis na planilha ativa |
| Column |
Não |
Valor do texto |
|
O número ou a letra do índice da coluna. A numeração da coluna começa no índice 1. |
| Start column |
Não |
Valor do texto |
|
O índice ou a letra da primeira coluna. A numeração da coluna começa no índice 1. |
| End column |
Não |
Valor do texto |
|
O índice ou a letra da última coluna. A numeração da coluna começa no índice 1. |
| Linha |
Não |
Valor numérico |
|
O número de índice da linha. A numeração começa em 1. |
| Start row |
Não |
Valor numérico |
|
O índice ou a primeira linha. A numeração começa em 1. |
| End row |
Não |
Valor numérico |
|
O índice ou a última linha. A numeração começa em 1. |
| Tipo de redimensionamento |
N/A |
Autoajuste, tamanho personalizado |
Ajustar automaticamente |
Especificar se você deve ajustar automaticamente as colunas/linhas selecionadas ou definir um tamanho personalizado |
| Espessura |
Não |
Valor numérico |
|
A largura das colunas selecionadas |
| Height |
Não |
Valor numérico |
|
A altura das linhas selecionadas |
Variáveis produzidas
Essa ação não produz variáveis.
Exceções
| Exceção |
Descrição |
| Falha ao redimensionar colunas/linhas |
Indica um problema ao redimensionar as colunas/linhas |
Executar macro do Excel
Executa uma macro especificada no documento de uma instância do Excel.
| Argumento |
Opcional |
Aceita |
Valor padrão |
Descrição |
| Excel instance |
Não |
Instância do Excel |
|
A instância do Excel com que se trabalhará. Essa variável deverá ter sido especificada anteriormente em uma ação Iniciar o Excel. |
| Macro |
Não |
Valor do texto |
|
A macro a ser executada. O texto deve consistir no nome da macro seguido por qualquer argumento (opcional), tudo separado por pontos e vírgulas. |
Variáveis produzidas
Essa ação não produz variáveis.
Exceções
| Exceção |
Descrição |
| Failed to run macro |
Indica um problema ao executar a macro especificada |
Obter planilha ativa do Excel
Recupera a planilha ativa de um documento do Excel.
| Argumento |
Opcional |
Aceita |
Valor padrão |
Descrição |
| Excel instance |
Não |
Instância do Excel |
|
A instância do Excel com que se trabalhará. Essa variável deverá ter sido especificada anteriormente em uma ação Iniciar o Excel. |
Variáveis produzidas
Exceções
| Exceção |
Descrição |
| Failed to retrieve active worksheet |
Indica um problema ao recuperar a planilha ativa |
Obter todas as planilhas do Excel
Recupera os nomes de todas as planilhas de um documento do Excel.
| Argumento |
Opcional |
Aceita |
Valor padrão |
Descrição |
| Excel instance |
Não |
Instância do Excel |
|
Especifique a instância do Excel. Essa variável deverá ter sido especificada anteriormente em uma ação Iniciar o Excel. |
Variáveis produzidas
Exceções
| Exceção |
Descrição |
| Failed to retrieve all worksheet names |
Indica um problema ao recuperar os nomes da planilha do Excel |
Excluir planilha do Excel
Exclui uma planilha específica de uma instância do Excel.
| Argumento |
Opcional |
Aceita |
Valor padrão |
Descrição |
| Excel instance |
Não |
Instância do Excel |
|
A instância do Excel com que se trabalhará. Essa variável deverá ter sido especificada anteriormente em uma ação Iniciar o Excel. |
| Delete worksheet with |
N/A |
Índice, Nome |
Name |
Se a planilha deve ser localizada por nome ou por índice |
| Worksheet index |
Não |
Valor numérico |
|
O número do índice da planilha a ser excluída. A numeração começa em 1. Isso significa que o índice da primeira planilha é 1, da segunda é 2 etc. |
| Worksheet name |
Não |
Valor do texto |
|
O nome da planilha a ser excluída |
Variáveis produzidas
Essa ação não produz variáveis.
Exceções
| Exceção |
Descrição |
| Can't find worksheet |
Indica que não foi possível encontrar uma planilha com o nome especificado |
| Failed to delete worksheet |
Indica um problema ao excluir a planilha especificada |
Renomear planilha do Excel
Renomeia uma planilha específica de uma instância do Excel.
| Argumento |
Opcional |
Aceita |
Valor padrão |
Descrição |
| Excel instance |
Não |
Instância do Excel |
|
Especifique a instância do Excel. Essa variável deverá ter sido especificada anteriormente em uma ação Iniciar o Excel. |
| Rename worksheet with |
N/A |
Índice, Nome |
Name |
Especificar se a planilha deve ser localizada por nome ou por índice |
| Worksheet index |
Não |
Valor numérico |
|
O índice da planilha a ser renomeada. A numeração começa em 1. Isso significa que o índice da primeira planilha é 1, da segunda é 2 etc. |
| Worksheet name |
Não |
Valor do texto |
|
O nome da planilha a ser renomeada |
| Worksheet new name |
Não |
Valor do texto |
|
O novo nome da planilha |
Variáveis produzidas
Essa ação não produz variáveis.
Exceções
| Exceção |
Descrição |
| Can't find worksheet |
Indica que não foi possível encontrar uma planilha com o nome especificado |
| Failed to rename worksheet |
Indica um problema ao renomear a planilha especificada |
Copiar planilha do Excel
Copia uma planilha de um documento do Excel e o colar no documento do Excel da mesma instância do Excel ou de uma diferente.
| Argumento |
Opcional |
Aceita |
Valor padrão |
Descrição |
| Excel instance |
Não |
Excel instance |
|
A instância do Excel com que se trabalhará. Essa variável deve ser especificada em uma ação Iniciar o Excel. |
| Copiar planilha com |
N/A |
Índice, Nome |
Name |
Especificar se a planilha deve ser localizada por nome ou por índice |
| Worksheet index |
No |
Valor numérico |
|
O índice da planilha a ser copiada. A numeração começa em 1. Isso significa que o índice da primeira planilha é 1, da segunda é 2 etc. |
| Worksheet name |
No |
Valor do texto |
|
O nome da planilha a ser copiada. |
| Instância do Excel de destino |
Νão |
Excel instance |
|
A instância do Excel do arquivo de destino. Essa variável deve ser especificada em uma ação Iniciar o Excel. |
| Worksheet new name |
No |
Valor do texto |
|
O novo nome da planilha |
| Colar planilha como |
N/A |
Primeira planilha, Última planilha |
Primeira planilha |
Especificar se a nova planilha do Excel copiada será adicionada antes ou depois das planilhas existentes |
Variáveis produzidas
Essa ação não produz variáveis.
Exceções
| Exceção |
Description |
| Falha ao copiar a planilha |
Indica um problema ao copiar uma planilha no Excel |
| Não é possível adicionar uma planilha com este nome |
Indica um problema ao tentar definir o nome da planilha após a cópia |
Ativar célula na planilha do Excel
Ativar uma célula na planilha ativa de uma instância do Excel, fornecendo coluna, linha e deslocamento.
| Argumento |
Opcional |
Aceita |
Valor padrão |
Descrição |
| Excel instance |
Não |
Instância do Excel |
|
Especifique a instância do Excel com que se trabalhará. Essa variável deverá ter sido especificada anteriormente em uma ação Iniciar o Excel. |
| Activate |
N/A |
Célula especificada de maneira absoluta, Célula especificada de maneira relativa |
Célula especificada de maneira absoluta |
Selecione como deseja especificar a célula a ser ativada, de maneira absoluta ou de maneira relativa, usando uma distância de deslocamento, que é o número de células entre a célula de referência ativada no momento e a célula real a ser ativada. |
| Column |
Não |
Valor do texto |
|
O valor numérico ou a letra da coluna da célula. |
| Direction |
N/A |
Para a esquerda, Para a direita, Acima, Abaixo |
Left |
Selecione a direção do deslocamento. Selecionar onde procurar a célula a ser ativada com base na posição da célula ativa no momento. |
| Offset from active cell |
Não |
Valor numérico |
|
A distância em células entre a célula ativa no momento e a célula desejada. A numeração começa em 0. |
| Linha |
Não |
Valor numérico |
|
O valor numérico da linha da célula. A numeração começa em 1. |
Variáveis produzidas
Essa ação não produz variáveis.
Exceções
| Exceção |
Descrição |
| Failed to activate cell |
Indica um problema ao ativar uma célula do Excel |
Selecionar células na planilha do Excel
Seleciona um intervalo de células na planilha ativa de uma instância do Excel.
Você tem três opções quando se trata de recuperar um intervalo de células por meio do Excel com a ação Selecionar células na planilha do Excel.
Para começar você precisa de uma Instância do Excel válida, que você pode criar usando a ação Iniciar o Excel fornecendo as respectivas entradas.
Para selecionar um intervalo de células fornecendo explicitamente as coordenadas do intervalo, selecione a opção Intervalo de células na propriedade Selecionar e, em seguida, forneça um intervalo inserindo o número ou letra das células que definem seu início e fim nas seguintes propriedades: Coluna inicial, Linha inicial, Coluna final, Linha final.
Para selecionar um intervalo de células, em relação à célula atualmente ativa, primeiro selecione a opção Intervalo de células relativas à célula ativa na propriedade Selecionar. Em seguida, defina a direção nos eixos X e Y com base na posição da célula atualmente ativa, bem como o deslocamento da célula ativa nos dois eixos, modificando as propriedades Direção do eixo X, Deslocamento do eixo X, Direção do eixo Y e Deslocamento do eixo Y.
Para selecionar um intervalo de células usando o nome do intervalo, selecione a opção Nomear células na propriedade Selecionar.
| Argumento |
Opcional |
Aceita |
Valor padrão |
Descrição |
| Excel instance |
Não |
Instância do Excel |
|
A instância do Excel com que se trabalhará. Essa variável deverá ter sido especificada anteriormente em uma ação Iniciar o Excel. |
| Select |
N/A |
Célula especificada de maneira absoluta, Célula especificada de maneira relativa |
Célula especificada de maneira absoluta |
Especificar se deve selecionar um intervalo de células explicitamente especificado ou um intervalo de células relativo à célula ativa no momento. |
| X Axis Direction |
N/A |
Para a esquerda, Para a direita |
Left |
A direção do deslocamento do eixo X. Onde procurar no eixo horizontal, com base na posição da célula ativada no momento. |
| Start column |
Não |
Valor do texto |
|
O índice ou a letra da primeira coluna. |
| X Offset |
Não |
Valor numérico |
|
O deslocamento no eixo X. |
| Start row |
Não |
Valor numérico |
|
O número da primeira linha. A numeração começa em 1. |
| End column |
Não |
Valor do texto |
|
O índice ou a letra da última coluna. |
| Y Axis Direction |
N/A |
Acima, Abaixo |
Acima |
A direção do deslocamento do eixo Y. Onde procurar no eixo vertical, com base na posição da célula ativa no momento. |
| End row |
Não |
Valor numérico |
|
O número da última linha. A numeração começa em 1. |
| Y Offset |
Não |
Valor numérico |
|
O deslocamento no eixo Y. |
Variáveis produzidas
Essa ação não produz variáveis.
Exceções
| Exceção |
Descrição |
| Failed to select cells |
Indica um problema ao selecionar as células especificadas |
Obter o intervalo de células selecionado da planilha do Excel
Recuperar o intervalo de células selecionado em uma estrutura que consiste na primeira coluna, primeira linha, última coluna e última linha.
| Argumento |
Opcional |
Aceita |
Valor padrão |
Descrição |
| Excel instance |
Não |
Instância do Excel |
|
A instância do Excel com que se trabalhará. Essa variável deverá ter sido especificada anteriormente em uma ação Iniciar o Excel. |
Variáveis produzidas
| Argumento |
Type |
Descrição |
| FirstColumnIndex |
Valor numérico |
O valor numérico da primeira coluna do intervalo |
| FirstRowIndex |
Valor numérico |
O valor numérico da primeira linha do intervalo |
| LastColumnIndex |
Valor numérico |
O valor numérico da última coluna do intervalo |
| LastRowIndex |
Valor numérico |
O valor numérico da última linha do intervalo |
Exceções
| Exceção |
Descrição |
| Failed to retrieve the selected range of cells |
Indica um problema ao recuperar o intervalo de células selecionado |
Copiar células da planilha do Excel
Copia um intervalo de células da planilha ativa de uma instância do Excel.
| Argumento |
Opcional |
Aceita |
Valor padrão |
Descrição |
| Excel instance |
Não |
Instância do Excel |
|
A instância do Excel com que se trabalhará. Essa variável deverá ter sido especificada anteriormente em uma ação Iniciar o Excel. |
| Copy mode |
N/A |
Valores da Célula única, Valores de um Intervalo de Células, Valores da Seleção |
Valores da Célula Única |
Especificar se é para copiar uma única célula, um intervalo de células ou a seleção atual de células |
| Start column |
Não |
Valor do texto |
|
O índice ou a letra da primeira coluna |
| Start row |
Não |
Valor numérico |
|
O índice da primeira linha |
| End column |
Não |
Valor do texto |
|
O índice ou a letra da última coluna |
| End row |
Não |
Valor numérico |
|
O índice da última linha |
Variáveis produzidas
Essa ação não produz variáveis.
Exceções
| Exceção |
Descrição |
| Failed to copy cells |
Indica um problema ao copiar as células do documento do Excel |
Colar células na planilha do Excel
Cola um intervalo de células na planilha ativa de uma instância do Excel.
| Argumento |
Opcional |
Aceita |
Valor padrão |
Descrição |
| Excel instance |
Não |
Instância do Excel |
|
Especifique a instância do Excel. Essa variável deverá ter sido especificada anteriormente em uma ação Iniciar o Excel. |
| Paste mode |
N/A |
Na célula especificada, Na célula ativa no momento |
Na célula especificada |
Especificar se deve colar em uma célula especificada ou na célula ativa no momento |
| Column |
Não |
Valor do texto |
|
O índice ou a letra da coluna da célula |
| Linha |
Não |
Valor numérico |
|
O número da linha |
Variáveis produzidas
Essa ação não produz variáveis.
Exceções
| Exceção |
Descrição |
| Failed to paste cells |
Indica um problema ao colar as células especificadas |
Excluir da planilha do Excel
Exclui uma célula ou um intervalo de células da planilha ativa de uma instância do Excel.
| Argumento |
Opcional |
Aceita |
Valor padrão |
Descrição |
| Excel instance |
Não |
Instância do Excel |
|
A instância do Excel com que se trabalhará. Essa variável deverá ter sido especificada anteriormente em uma ação Iniciar o Excel. |
| Retrieve |
N/A |
O valor de uma única célula, valores de um intervalo de células |
O valor de uma única célula |
Se é para excluir uma célula única ou uma tabela de um intervalo de células |
| Start column |
Não |
Valor do texto |
|
A coluna da célula (valor da célula única) ou a primeira coluna como um valor numérico ou uma letra |
| Start row |
Não |
Valor numérico |
|
A linha da célula (valor da célula única) ou número da primeira linha |
| End column |
Não |
Valor do texto |
|
A última coluna como um valor numérico ou uma letra |
| End row |
Não |
Valor numérico |
|
O número da última linha |
| Shift direction |
N/A |
Lado esquerdo, Para cima |
Left |
A direção do deslocamento |
Variáveis produzidas
Essa ação não produz variáveis.
Exceções
| Exceção |
Description |
| Falha ao excluir as células |
Indica um problema ao excluir as células especificadas |
Inserir linha na planilha do Excel
Insere uma linha acima da linha selecionada de uma instância do Excel.
| Argumento |
Opcional |
Aceita |
Valor padrão |
Descrição |
| Excel instance |
Não |
Instância do Excel |
|
A instância do Excel com que se trabalhará. Essa variável deverá ter sido especificada anteriormente em uma ação Iniciar o Excel. |
| Índice de linha |
Não |
Valor numérico |
|
O índice da linha acima da qual será adicionada uma nova linha. A numeração começa em 1. |
Variáveis produzidas
Essa ação não produz variáveis.
Exceções
| Exceção |
Descrição |
| Can't find row |
Indica que não foi possível encontrar uma linha com o índice especificado |
| Failed to insert row |
Indica um problema ao inserir uma linha na instância especificada do Excel |
Excluir linha da planilha do Excel
Exclui uma linha selecionada de uma instância do Excel.
| Argumento |
Opcional |
Aceita |
Valor padrão |
Descrição |
| Excel instance |
Não |
Instância do Excel |
|
A instância do Excel. Essa variável deverá ter sido especificada anteriormente em uma ação Iniciar o Excel. |
| Delete row |
Não |
Valor numérico |
|
O número do Índice da linha a ser excluída. A numeração começa em 1. |
Variáveis produzidas
Essa ação não produz variáveis.
Exceções
| Exceção |
Descrição |
| Can't find row |
Indica que não foi possível encontrar uma linha com o índice especificado |
| Failed to delete row |
Indica um problema ao excluir a linha especificada |
Inserir coluna na planilha do Excel
Insere uma coluna à esquerda de uma coluna selecionada de uma instância do Excel.
| Argumento |
Opcional |
Aceita |
Valor padrão |
Descrição |
| Excel instance |
Não |
Instância do Excel |
|
A instância do Excel com que se trabalhará. Essa variável deverá ter sido especificada anteriormente em uma ação Iniciar o Excel. |
| Column |
Não |
Valor do texto |
|
O número ou a letra do índice da coluna. Uma nova coluna será exibida no lado esquerdo da coluna indicada. |
Variáveis produzidas
Essa ação não produz variáveis.
Exceções
| Exceção |
Descrição |
| Can't find column |
Indica que não foi possível encontrar uma coluna com o nome especificado |
| Failed to insert column |
Indica um problema ao inserir uma coluna na instância especificada do Excel |
Excluir coluna da planilha do Excel
Exclui uma coluna selecionada de uma instância do Excel.
| Argumento |
Opcional |
Aceita |
Valor padrão |
Descrição |
| Excel instance |
Não |
Instância do Excel |
|
A instância do Excel com que se trabalhará. Essa variável deverá ter sido especificada anteriormente em uma ação Iniciar o Excel. |
| Delete column |
Não |
Valor do texto |
|
O número de índice ou a letra da coluna a ser excluída. |
Variáveis produzidas
Essa ação não produz variáveis.
Exceções
| Exceção |
Descrição |
| Can't find column |
Indica que não foi possível encontrar uma coluna com o nome especificado |
| Failed to delete column |
Indica um problema ao excluir a coluna especificada |
Localizar e substituir células na planilha do Excel
Localiza o texto e o substitui por outro na planilha ativa de uma instância do Excel.
| Argumento |
Opcional |
Aceita |
Valor padrão |
Descrição |
| Excel instance |
Não |
Instância do Excel |
|
A instância do Excel com que se trabalhará. Essa variável deverá ter sido especificada anteriormente em uma ação Iniciar o Excel. |
| Search mode |
N/A |
Localizar, Localizar e substituir |
Find |
O modo com o qual pesquisar |
| All matches |
N/D |
Valor booliano |
False |
Se é para localizar/substituir o texto em todas as células correspondentes encontradas ou somente na primeira célula correspondente |
| Text to find |
Não |
Valor do texto |
|
Texto a ser localizado na planilha |
| Text to replace with |
Não |
Valor do texto |
|
O texto usado para substituir as células correspondentes |
| Match case |
N/D |
Valor booliano |
False |
Se é para pesquisar dados com diferenciação entre maiúsculas e minúsculas |
| Match entire cell contents |
N/D |
Valor booliano |
False |
Se é para pesquisar células que contêm apenas o texto especificado |
| Search by |
N/D |
Linhas, Colunas |
Linhas |
A ordem na qual pesquisar o texto |
Variáveis produzidas
| Argumento |
Type |
Descrição |
| FoundColumnIndex |
Valor numérico |
O índice da coluna encontrada |
| FoundRowIndex |
Valor numérico |
O índice da linha encontrada |
| Cells |
Tabela de dados |
A lista de células que correspondem aos critérios |
Exceções
| Exceção |
Descrição |
| Failed to find and/or replace text |
Indica um problema ao localizar e/ou substituir o texto especificado |
Obter primeira linha livre na coluna da planilha do Excel
Recuperar a primeira linha livre, de acordo com a coluna da planilha ativa.
| Argumento |
Opcional |
Aceita |
Valor padrão |
Descrição |
| Excel instance |
Não |
Instância do Excel |
|
Especifique a instância do Excel. Essa variável deverá ter sido especificada anteriormente em uma ação Iniciar o Excel. |
| Column |
Não |
Valor do texto |
|
O índice ou a letra que identifica a coluna. A numeração da coluna começa no índice 1. |
Variáveis produzidas
| Argumento |
Type |
Descrição |
| FirstFreeRowOnColumn |
Valor numérico |
O valor numérico da primeira linha totalmente vazia da coluna especificada |
Exceções
| Exceção |
Descrição |
| Failed to retrieve first free row |
Indica um problema ao recuperar a primeira linha livre de uma instância do Excel |
Lê a fórmula dentro de uma célula no Excel.
| Argumento |
Opcional |
Aceita |
Valor padrão |
Descrição |
| Excel instance |
Não |
Excel instance |
|
A instância do Excel com que se trabalhará. Essa variável deve ser especificada em uma ação Iniciar o Excel. |
| Retrieve |
N/A |
A fórmula de uma única célula, a fórmula de uma célula nomeada |
A fórmula de uma única célula |
Especificar se a fórmula deve ser recuperada de uma célula especificada ou de uma célula nomeada |
| Start column |
No |
Valor do texto |
|
A coluna da célula (valor da célula única) ou a primeira coluna como um valor numérico ou uma letra |
| Start row |
Não |
Valor numérico |
|
A linha da célula (valor da célula única) ou número da primeira linha |
| Name |
No |
Valor do texto |
|
O nome das células |
Variáveis produzidas
| Argumento |
Type |
Description |
| CellFormula |
Valor do texto |
A fórmula de uma única célula |
| Exceção |
Description |
| Falha ao ler a fórmula da célula |
Indica um problema ao ler a fórmula de uma célula no Excel |
Obter o intervalo de tabelas da planilha do Excel
Recupera o intervalo de uma tabela na planilha ativa de uma instância do Excel.
| Argumento |
Opcional |
Aceita |
Valor padrão |
Descrição |
| Excel instance |
Não |
Excel instance |
|
A instância do Excel com que se trabalhará. Essa variável deve ser especificada em uma ação Iniciar o Excel. |
| Nome da tabela |
No |
Valor do texto |
|
Especificar o nome da tabela no Excel. |
| É dinâmica |
N/A |
Valor booliano |
False |
Determine se a tabela especificada é uma tabela dinâmica. |
Variáveis produzidas
| Argumento |
Type |
Description |
| FirstColumnIndex |
Valor numérico |
O valor numérico da primeira coluna da tabela |
| FirstRowIndex |
Valor numérico |
O valor numérico da primeira linha da tabela |
| LastColumnIndex |
Valor numérico |
O valor numérico da última coluna da tabela |
| LastRowIndex |
Valor numérico |
O valor numérico da última linha da tabela |
Exceções
| Exceção |
Description |
| Falha ao obter o intervalo da tabela |
Indica um problema ao obter o intervalo de uma tabela no Excel |
Preencher automaticamente células na planilha do Excel
Preenche automaticamente um intervalo com dados, com base nos dados de outro intervalo, na planilha ativa de uma instância do Excel.
| Argumento |
Opcional |
Aceita |
Valor padrão |
Descrição |
| Excel instance |
Não |
Excel instance |
|
A instância do Excel com que se trabalhará. Essa variável deve ser especificada em uma ação Iniciar o Excel. |
| Formato de intervalos |
N/A |
Células nomeadas, intervalos específicos |
Células nomeadas |
Especifique como os intervalos são referenciados, usando células nomeadas ou índices absolutos de coluna/linha |
| Nome das células de origem |
No |
Valor do texto |
|
Nome que representa o intervalo de origem para o preenchimento automático |
| Nome das células de destino |
No |
Valor do texto |
|
Nome que representa o intervalo de destino a ser preenchido automaticamente. O intervalo de origem deve começar na mesma célula e deve ser incluído no intervalo de destino |
| Start column |
No |
Valor do texto |
|
O índice ou a letra da primeira coluna de ambos os intervalos |
| Start row |
No |
Valor numérico |
|
O número da primeira linha de ambos os intervalos. A numeração começa em 1 |
| Coluna de término de origem |
No |
Valor do texto |
|
O índice ou a letra da última coluna do intervalo de origem |
| Linha de término de origem |
No |
Valor numérico |
|
O último número da linha do intervalo de origem. A numeração começa em 1 |
| Coluna de término de destino |
No |
Valor do texto |
|
O índice ou a letra da última coluna do intervalo de destino |
| Linha de término de destino |
No |
Valor numérico |
|
O último número da linha do intervalo de destino. A numeração começa em 1 |
Variáveis produzidas
Essa ação não produz variáveis.
Exceções
| Exceção |
Description |
| Falha ao preencher as células automaticamente |
Indica um problema ao preencher automaticamente as células no Excel |
Acrescentar células à planilha do Excel
Acrescenta um intervalo de células à planilha ativa de uma instância do Excel.
| Argumento |
Opcional |
Aceita |
Valor padrão |
Descrição |
| Excel instance |
Não |
Excel instance |
|
A instância do Excel com que se trabalhará. Essa variável deve ser especificada em uma ação Iniciar o Excel. |
| Modo de acréscimo |
N/A |
Para a planilha ativa, para células nomeadas |
Para planilha ativa |
Especificar se você deve acrescentar a uma planilha ou a um intervalo de células nomeadas |
| Name |
No |
Valor do texto |
|
O nome do intervalo de células |
| A primeira linha tem cabeçalhos |
N/A |
Valor booliano |
False |
Indica que a primeira linha do destino contém cabeçalhos de coluna |
| Coluna inicial |
Sim |
Valor do texto |
|
O número ou a letra da coluna inicial, em que os dados são acrescentados a partir da primeira linha vazia do destino. Se o campo for deixado vazio, a primeira coluna do destino especificado será usada em seu lugar. |
| Cabeçalho da coluna inicial |
Sim |
Valor do texto |
|
O cabeçalho da coluna inicial, em que os dados são acrescentados a partir da primeira linha vazia do destino. Se o campo for deixado vazio, a primeira coluna do destino especificado será usada em seu lugar. |
Variáveis produzidas
Essa ação não produz variáveis.
Exceções
| Exceção |
Description |
| Falha ao acrescentar células |
Indica um problema ao acrescentar células no Excel |
Intervalo de pesquisa na planilha do Excel
Localiza e retorna o resultado da função PROC do Excel.
| Argumento |
Opcional |
Aceita |
Valor padrão |
Descrição |
| Excel instance |
Não |
Excel instance |
|
A instância do Excel com que se trabalhará. Essa variável deve ser especificada em uma ação Iniciar o Excel. |
| Pesquisar valor |
No |
Valor do texto |
|
O valor a pesquisar no intervalo de células especificado. |
| Formato de intervalos |
N/A |
Células nomeadas, intervalos específicos |
Células nomeadas |
Especifique como os intervalos são referenciados, usando células nomeadas ou índices absolutos de coluna/linha. |
| Nome das células |
No |
Valor do texto |
|
O nome do intervalo de células para pesquisar o valor de pesquisa. |
| Start column |
No |
Valor do texto |
|
O índice ou a letra da primeira coluna do intervalo para pesquisar o valor de pesquisa. |
| Start row |
No |
Valor numérico |
|
O número da primeira linha do intervalo para procurar o valor de pesquisa. A numeração começa em 1. |
| End column |
No |
Valor do texto |
|
O índice ou a letra da última coluna do intervalo para pesquisar o valor de pesquisa. |
| End row |
No |
Valor numérico |
|
O número da última linha do intervalo para procurar o valor de pesquisa. A numeração começa em 1. |
| Formulário de matriz |
N/A |
Valor booliano |
False |
O formulário de matriz de Pesquisa procura na primeira linha ou coluna de uma matriz o valor especificado e retorna um valor da mesma posição na última linha ou coluna da matriz. Use este formulário de PESQUISA quando os valores que você deseja corresponder estiverem na primeira linha ou coluna da matriz. Se essa opção permanecer desabilitada, será usada a forma vetorial de PESQUISA, que procura um valor em um intervalo de uma linha ou uma coluna (conhecido como vetor) e retorna um valor da mesma posição em um segundo intervalo de uma linha ou coluna. |
| Nome das células da fonte de resultados |
Sim |
Valor do texto |
|
O nome do intervalo de células de onde o valor correspondente é retornado. |
| Coluna inicial da fonte de resultados |
No |
Valor do texto |
|
O índice ou a letra da primeira coluna do intervalo na qual o valor correspondente é retornado. |
| Linha inicial da fonte de resultados |
No |
Valor numérico |
|
O número da primeira linha do intervalo de onde o valor correspondente é retornado. A numeração começa em 1. |
| Coluna final da fonte de resultados |
No |
Valor do texto |
|
O índice ou a letra da última coluna do intervalo na qual o valor correspondente é retornado. |
| Linha final da fonte de resultados |
No |
Valor numérico |
|
O número da última linha do intervalo de onde o valor correspondente é retornado. A numeração começa em 1. |
Variáveis produzidas
| Argumento |
Type |
Description |
| LookupResult |
Valor do texto |
O valor retornado pela função LOOKUP |
Exceções
| Exceção |
Description |
| Falha ao pesquisar |
Indica um problema ao procurar um valor no Excel |
Definir cor das células na planilha do Excel
Preenche o segundo plano das células selecionadas com a cor especificada, na planilha ativa de uma instância do Excel.
Você pode determinar a cor inserindo um código hexadecimal ou pode escolher entre uma seleção de nomes de cores predefinidos fornecidos na lista. Selecionar a opção 'Transparente' deixa as células sem qualquer preenchimento de cor.
| Argumento |
Opcional |
Aceita |
Valor padrão |
Descrição |
| Excel instance |
Não |
Excel instance |
|
A instância do Excel com que se trabalhará. Essa variável deve ser especificada em uma ação Iniciar o Excel. |
| Definir cor de |
N/A |
Célula única, Intervalo de células, Células nomeadas |
Célula única |
Especifica se a cor em segundo plano de uma única célula, um intervalo de células ou células nomeadas. |
| Start column |
No |
Valor do texto |
|
O índice ou a letra da coluna da célula ou da primeira coluna do intervalo. |
| Start row |
No |
Valor numérico |
|
A linha da célula ou número da primeira linha. A numeração começa em 1. |
| End column |
No |
Valor do texto |
|
O índice ou a letra da última coluna do intervalo. |
| End row |
No |
Valor numérico |
|
O número da última linha do intervalo. A numeração começa em 1. |
| Nome das células |
No |
Valor do texto |
|
Nome que representa o intervalo que será preenchido com a cor especificada. |
| Formato de cor |
N/A |
Nome, Valor hexadecimal |
Name |
Selecionar se uma cor deve ser especificada pelo nome ou pelo valor hexadecimal. |
| Nome da cor |
No |
Valor do texto |
|
Seleciona uma das cores definidas pelo sistema. |
| Valor hexadecimal de cor |
No |
Valor do texto |
|
Especifica o valor hexadecimal (RGB) da cor. |
Variáveis produzidas
Essa ação não produz variáveis.
Exceções
| Exceção |
Description |
| Falha ao definir a cor |
Indica um problema ao configurar a cor das células no Excel |
Iniciar o Excel
Inicia uma nova instância do Excel ou abre um documento do Excel.
| Argumento |
Opcional |
Aceita |
Valor padrão |
Descrição |
| Launch Excel |
N/A |
Com um documento em branco e abra o documento a seguir |
Com um documento em branco |
Especificar se deve abrir um novo documento do Excel ou um já existente |
| Caminho do documento |
No |
Arquivo |
|
O caminho completo do documento do Excel existente a ser aberto |
| Make instance visible |
N/D |
Valor booliano |
Verdadeiro |
Especificar se deve tornar a janela do Excel visível ou oculta |
| Aninhar em um novo processo do Excel |
N/A |
Valor booliano |
False |
Especifique se a planilha do Excel deve estar em um processo exclusivo do Excel. Macros e suplementos de outras planilhas não estarão acessíveis. |
| Password |
Sim |
Entrada direta criptografada ou Valor do texto |
|
A senha no documento do Excel, se ele for protegido por senha |
| Open as ReadOnly |
N/A |
Valor booliano |
False |
Especificar se o documento armazenado deve ser aberto no modo somente leitura ou não |
| Load add-ins and macros |
N/D |
Valor booliano |
False |
Especificar se os suplementos e as macros devem ser carregados na nova instância do Excel |
Variáveis produzidas
| Argumento |
Type |
Descrição |
| ExcelInstance |
Excel instance |
A instância específica do Excel para uso com ações posteriores do Excel. Isso permite que o usuário especifique qual das várias planilhas do Excel deseja acessar |
Exceções
| Exceção |
Descrição |
| Failed to launch Excel |
Indica um problema ao inicializar uma instância do Excel |
| Failed to open Excel document |
Indica um problema ao abrir o documento especificado do Excel |
Anexar ao Excel em execução
Anexa a um documento do Excel que já esteja aberto.
| Argumento |
Opcional |
Aceita |
Valor padrão |
Descrição |
| Document name |
Não |
Arquivo |
|
O nome ou o caminho do documento do Excel ao qual anexar |
Variáveis produzidas
| Argumento |
Type |
Descrição |
| ExcelInstance |
Excel instance |
A instância do Excel à qual esta ação foi anexada para uso com ações posteriores do Excel |
Exceções
| Exceção |
Descrição |
| Specified Excel document not found |
Indica que não foi possível encontrar o documento especificado do Excel |
| Failed to attach to Excel document |
Indica um problema ao anexar ao documento do Excel |
Ler da planilha do Excel
Lê o valor de uma célula ou um intervalo de células da planilha ativa de uma instância do Excel.
| Argumento |
Opcional |
Aceita |
Valor padrão |
Descrição |
| Excel instance |
Não |
Instância do Excel |
|
A instância do Excel com que se trabalhará. Essa variável deverá ter sido especificada anteriormente em uma ação Iniciar o Excel. |
| Retrieve |
N/A |
O valor de uma única célula, Valores de um intervalo de células, Valores da seleção, Todos os valores disponíveis da planilha |
O valor de uma única célula |
Se é para recuperar o valor de uma célula única, de uma tabela de um intervalo de células ou da planilha inteira |
| Start column |
Não |
Valor do texto |
|
A coluna da célula (valor da célula única) ou a primeira coluna como um valor numérico ou uma letra |
| Start row |
Não |
Valor numérico |
|
A linha da célula (valor da célula única) ou número da primeira linha |
| End column |
Não |
Valor do texto |
|
A última coluna como um valor numérico ou uma letra |
| End row |
Não |
Valor numérico |
|
O número da última linha |
| Get cell contents as text |
N/D |
Valor booliano |
False |
Especifique se o conteúdo das células deve ser recuperado puramente como texto ou como o tipo de correspondência mais próximo, como Data e Hora para datas, Numérico para números e assim por diante |
| First line of range contains column names |
N/A |
Valor booliano |
False |
Especifique se deve considerar a primeira linha como nomes de coluna. Nesse caso, os nomes não serão lidos como dados na tabela e as ações posteriores poderão pesquisar os dados por nomes de colunas. |
Variáveis produzidas
| Argumento |
Type |
Descrição |
| ExcelData |
Valor geral |
O valor da célula única |
| ExcelData |
Tabela de dados |
O valor do intervalo de células como uma Tabela de Dados |
Exceções
| Exceção |
Description |
| Falha ao ler os valores das células |
Indica um problema ao ler os valores das células especificadas do Excel |
Obter célula ativa na planilha do Excel
Obter a célula ativa na planilha ativa do documento do Excel.
| Argumento |
Opcional |
Aceita |
Valor padrão |
Descrição |
| Excel instance |
Não |
Instância do Excel |
|
A instância do Excel com que se trabalhará. Essa variável deverá ter sido especificada anteriormente em uma ação Iniciar o Excel. |
Variáveis produzidas
| Argumento |
Type |
Descrição |
| ActiveCellColumnIndex |
Valor numérico |
O valor numérico da coluna da célula ativa |
| ActiveCellRowIndex |
Valor numérico |
O valor numérico da linha da célula ativa |
Exceções
| Exceção |
Descrição |
| Failed to get active cell |
Indica um problema para obter a célula ativa |
Salvar Excel
Salva uma instância do Excel iniciada anteriormente.
| Argumento |
Opcional |
Aceita |
Valor padrão |
Descrição |
| Excel instance |
Não |
Instância do Excel |
|
A instância do Excel a ser salva. Essa variável deverá ter sido especificada anteriormente em uma ação Iniciar o Excel. |
| Modo de salvamento |
N/A |
Salvar documento, Salvar documento como |
Salvar documento |
Como salvar o documento desta instância |
| Document format |
N/D |
Padrão (da Extensão), Pasta de trabalho do Excel (.xlsx), Pasta de trabalho do Excel com Macro Habilitada (.xlsm), Pasta de trabalho do Excel 97-2003 (.xls), Página da Web (.htm, .html), Modelo do Excel (.xltx), Modelo do Excel com Macro Habilitada (.xltm), Modelo do Excel 97-2003 (.xlt), Texto (.txt), Texto Unicode (.txt), Texto em Macintosh (.txt), Texto em DOS (.txt), Planilha XML (.xml), Excel 95 (.xls), CSV (.csv), DIF (.dif), SYLK (.slk), Suplemento do Excel (.xlam), Suplemento do Excel 97-2003 (.xla), Pasta de trabalho do Open XML estrita (.xlsx), Planilha do OpenDocument (.ods), Dados XML (.xml), Pasta de Trabalho Binária do Excel (.xlsb) |
Padrão (da extensão) |
O formato para salvar o documento |
| Caminho do documento |
Não |
Arquivo |
|
O caminho completo para salvar o documento |
Variáveis produzidas
Essa ação não produz variáveis.
Exceções
| Exceção |
Descrição |
| Failed to save Excel document |
Indica um problema ao salvar o documento do Excel |
Gravar na planilha do Excel
Grava um valor em uma célula ou em um intervalo de células de uma instância do Excel.
| Argumento |
Opcional |
Aceita |
Valor padrão |
Descrição |
| Excel instance |
Não |
Instância do Excel |
|
A instância do Excel com que se trabalhará. Essa variável deverá ter sido especificada anteriormente em uma ação Iniciar o Excel. |
| Value to write |
Não |
Valor geral |
|
Especifique o texto, número ou variável a ser inserido. Se a variável contiver uma tabela, ela será preenchida nas células à direita e abaixo da gravação sobre outros dados da célula, se necessário, e uma lista preencherá as células abaixo. |
| Write mode |
N/A |
Na célula especificada, Na célula ativa no momento |
Na célula especificada |
Definir se deve gravar em uma célula especificada ou na célula ativa no momento |
| Column |
Não |
Valor do texto |
|
O número ou a letra da coluna da célula para gravação |
| Row |
Não |
Valor numérico |
|
A linha da célula onde será inserida a gravação. A numeração começa em 1. Isso significa que o índice da primeira planilha é 1, da segunda é 2 etc. |
Variáveis produzidas
Essa ação não produz variáveis.
Exceções
| Exceção |
Descrição |
| Failed to write value to Excel |
Indica um problema ao gravar o valor especificado na instância do Excel |
Fechar Excel
Fecha uma instância do Excel.
| Argumento |
Opcional |
Aceita |
Valor padrão |
Descrição |
| Excel instance |
Não |
Excel instance |
|
A instância do Excel a ser fechada. Essa variável deverá ter sido especificada anteriormente em uma ação Iniciar o Excel. |
| Before closing Excel |
N/A |
Não salvar documento, Salvar documento, Salve documento como |
Não salvar documento |
Se e como salvar o documento desta instância antes de fechar aquela instância |
| Document format |
N/D |
Padrão (da Extensão), Pasta de trabalho do Excel (.xlsx), Pasta de trabalho do Excel com Macro Habilitada (.xlsm), Pasta de trabalho do Excel 97-2003 (.xls), Página da Web (.htm, .html), Modelo do Excel (.xltx), Modelo do Excel com Macro Habilitada (.xltm), Modelo do Excel 97-2003 (.xlt), Texto (.txt), Texto Unicode (.txt), Texto em Macintosh (.txt), Texto em DOS (.txt), Planilha XML (.xml), Excel 95 (.xls), CSV (.csv), DIF (.dif), SYLK (.slk), Suplemento do Excel (.xlam), Suplemento do Excel 97-2003 (.xla), Pasta de trabalho do Open XML estrita (.xlsx), Planilha do OpenDocument (.ods), Dados XML (.xml), Pasta de Trabalho Binária do Excel (.xlsb) |
Padrão (da extensão) |
O formato do documento |
| Caminho do documento |
Não |
Arquivo |
|
O caminho completo do documento |
Variáveis produzidas
Essa ação não produz variáveis.
Exceções
| Exceção |
Descrição |
| Failed to save Excel document |
Indica um problema ao salvar o documento do Excel |
| Failed to close Excel instance |
Indica um problema ao fechar a instância do Excel |
Definir planilha ativa do Excel
Ativa uma planilha específica de uma instância do Excel.
| Argumento |
Opcional |
Aceita |
Valor padrão |
Descrição |
| Excel instance |
Não |
Instância do Excel |
|
Especifique a instância do Excel. Essa variável deverá ter sido especificada anteriormente em uma ação Iniciar o Excel. |
| Activate worksheet with |
N/A |
Índice, Nome |
Name |
Especificar se a planilha deve ser localizada por nome ou por índice |
| Worksheet index |
Não |
Valor numérico |
|
O número do índice da planilha a ser ativada. A numeração começa em 1. Isso significa que o índice da primeira planilha é 1, da segunda é 2 etc. |
| Worksheet name |
Não |
Valor do texto |
|
O nome da planilha a ser ativada |
Variáveis produzidas
Essa ação não produz variáveis.
Exceções
| Exceção |
Descrição |
| Can't find worksheet |
Indica que não foi possível encontrar uma planilha com o nome especificado |
| Failed to activate worksheet |
Indica um problema ao ativar a planilha especificada |
Adicionar nova planilha
Adiciona uma nova planilha ao documento de uma instância do Excel.
| Argumento |
Opcional |
Aceita |
Valor padrão |
Descrição |
| Excel instance |
Não |
Instância do Excel |
|
Especifique a instância do Excel. Essa variável deverá ter sido especificada anteriormente em uma ação Iniciar o Excel. |
| New worksheet name |
Não |
Valor do texto |
|
Especificar o nome da nova planilha |
| Add worksheet as |
N/D |
Primeira planilha, Última planilha |
Primeira planilha |
Especificar se a nova planilha do Excel será adicionada antes ou depois das planilhas existentes |
Variáveis produzidas
Essa ação não produz variáveis.
Exceções
| Exceção |
Descrição |
| A worksheet with the same name already exists |
Indica que não foi possível adicionar a planilha porque já existe uma planilha com o mesmo nome |
| Failed to add worksheet |
Indica um problema ao adicionar a planilha |
Obter primeira coluna/linha livre da planilha do Excel
Recupera a primeira coluna e/ou linha livre da planilha ativa. Isso é útil para adicionar novos dados a uma planilha que já contenha dados.
| Argumento |
Opcional |
Aceita |
Valor padrão |
Descrição |
| Excel instance |
Não |
Instância do Excel |
|
Especifique a instância do Excel. Essa variável deverá ter sido especificada anteriormente em uma ação Iniciar o Excel. |
Variáveis produzidas
| Argumento |
Type |
Descrição |
| FirstFreeColumn |
Valor numérico |
O valor numérico da primeira coluna totalmente vazia. Por exemplo, se a coluna F for a primeira coluna vazia, ela será armazenada como "6". |
| FirstFreeRow |
Valor numérico |
O valor numérico da primeira linha totalmente vazia. Por exemplo, se a linha 7 for a primeira linha vazia, ela será armazenada como "7". |
Exceções
| Exceção |
Descrição |
| Failed to retrieve first free column/row |
Indica um problema ao recuperar a primeira coluna/linha livre de uma instância do Excel |
Obter nome da coluna na planilha do Excel
Obtém o nome da coluna.
| Argumento |
Opcional |
Aceita |
Valor padrão |
Descrição |
| Column number |
Não |
Valor numérico |
|
O número da coluna |
Variáveis produzidas
Exceções
Essa ação não inclui exceções.
Limpar células na planilha do Excel
Limpa um intervalo de células ou uma célula nomeada na planilha ativa de uma instância do Excel.
| Argumento |
Opcional |
Aceita |
Valor padrão |
Descrição |
| Excel instance |
Não |
Instância do Excel |
|
A instância do Excel com que se trabalhará. Essa variável deverá ter sido especificada anteriormente em uma ação Iniciar o Excel. |
| Clear |
N/A |
Intervalo de células, Intervalo de células em relação à célula ativa, Células nomeadas, Célula única |
Intervalo de células |
Especificar se deve selecionar um intervalo de células explicitamente especificado ou um intervalo de células relativo à célula ativa no momento, células nomeadas ou célula única. |
| X Axis Direction |
N/A |
Para a esquerda, Para a direita |
Left |
A direção do deslocamento do eixo X. Onde procurar no eixo horizontal, com base na posição da célula ativada no momento. |
| Start column |
Não |
Valor do texto |
|
O índice ou a letra da primeira coluna. |
| X Offset |
Não |
Valor numérico |
|
O deslocamento no eixo X. |
| Start row |
Não |
Valor numérico |
|
O número da primeira linha. A numeração começa em 1. |
| End column |
Não |
Valor do texto |
|
O índice ou a letra da última coluna. |
| Y Axis Direction |
N/A |
Acima, Abaixo |
Acima |
A direção do deslocamento do eixo Y. Onde procurar no eixo vertical, com base na posição da célula ativa no momento. |
| End row |
Não |
Valor numérico |
|
O número da última linha. A numeração começa em 1. |
| Y Offset |
Não |
Valor numérico |
|
O deslocamento no eixo Y. |
| Name |
Não |
Valor do texto |
|
O nome das células. |
| Column |
Não |
Valor do texto |
|
O índice ou a letra da coluna. |
| Linha |
Não |
Valor numérico |
|
O número da linha. Enumeração começa em 1. |
Variáveis produzidas
Essa ação não produz variáveis.
Exceções
| Exceção |
Description |
| Falha ao limpar células |
Indica que ocorreu um problema ao tentar limpar as células especificadas na instância do Excel. |
Classificar células na planilha do Excel
| Argumento |
Opcional |
Aceita |
Valor padrão |
Descrição |
| Excel instance |
Não |
Instância do Excel |
|
A instância do Excel com que se trabalhará. Essa variável deverá ter sido especificada anteriormente em uma ação Iniciar o Excel. |
| Classificar coluna em |
N/A |
Planilha ativa, Tabela, Intervalo |
Planilha ativa |
Especifique se a coluna a ser classificada faz parte de uma tabela, de um intervalo especificado, por nome ou coordenadas absolutas ou se faz parte da planilha ativa geral. |
| Nome da tabela |
No |
Valor do texto |
|
O nome da tabela. |
| Intervalo |
N/A |
Células com nome, intervalo específico |
Células nomeadas |
Especifique o intervalo a ser classificado, usando célula nomeada ou coluna absoluta e índice de linha. |
| Nome das células |
No |
Valor do texto |
|
Nome que representa o intervalo. |
| Start column |
No |
Valor do texto |
|
O índice ou a letra da primeira coluna. |
| Start row |
No |
Valor numérico |
|
O número da primeira linha. A numeração começa em 1. |
| End column |
No |
Valor do texto |
|
O índice ou a letra da última coluna. |
| End row |
No |
Valor numérico |
|
O número da última linha. A numeração começa em 1. |
| Classificar por |
Sim |
Regras de classificação, conforme definido pelo usuário |
N/A |
Regras de classificação a serem aplicadas. |
| Primeira linha é cabeçalho |
Sim |
Valor booliano |
|
Indica que a primeira linha da planilha é um cabeçalho. |
Variáveis produzidas
Essa ação não produz variáveis.
Exceções
| Exceção |
Description |
| Falha ao classificar células na planilha |
Indica um problema ao classificar as células na planilha. |
Filtrar células na planilha do Excel
Células do filtro na planilha do Excel permite que os criadores criem e apliquem um filtro na planilha, tabela ou intervalo ativo nos valores de uma coluna especificada. Para filtrar várias colunas em uma planilha ativa/tabela/intervalo, várias ações das Células do filtro na planilha do Excel devem ser usadas, cada uma aplicando o respectivo filtro.
Importante
Para aplicar vários filtros em uma planilha/tabela/intervalo específico, certifique-se de que todas as ações das Células do filtro na planilha do Excel usadas tenham como alvo a mesma origem (planilha/tabela/intervalo ativo).
Ao usar as Células do filtro na planilha do Excel em uma planilha ativa/intervalo com filtros já existentes/aplicados:
- Se o intervalo de destino for igual àquele em que os filtros anteriores foram aplicados, todos os filtros serão aplicados.
- Se o intervalo de destino não for igual ao intervalo ao qual os filtros anteriores foram aplicados, os filtros anteriores serão apagados e somente o filtro mais recente será aplicado.
- Se o intervalo de destino for uma tabela, todos os filtros serão aplicados.
| Argumento |
Opcional |
Aceita |
Valor padrão |
Descrição |
| Excel instance |
Não |
Instância do Excel |
|
A instância do Excel com que se trabalhará. Essa variável deverá ter sido especificada anteriormente em uma ação Iniciar o Excel. |
| Filtrar coluna em |
N/A |
Planilha ativa, Tabela, Intervalo |
Planilha ativa |
Especifique se a coluna a ser filtrada faz parte de uma tabela, de um intervalo especificado, por nome ou coordenadas absolutas ou se faz parte da planilha ativa geral |
| Nome da tabela |
No |
Valor do texto |
|
O nome da tabela. |
| Intervalo |
N/A |
Células com nome, intervalo específico |
Células nomeadas |
Especifique o intervalo a ser filtrado, usando célula nomeada ou coluna absoluta/índice de linha |
| Nome das células |
No |
Valor do texto |
|
Nome que representa o intervalo |
| Start column |
No |
Valor do texto |
|
O índice ou a letra da primeira coluna. |
| Start row |
No |
Valor numérico |
|
O número da primeira linha. A numeração começa em 1. |
| End column |
No |
Valor do texto |
|
O índice ou a letra da última coluna. |
| End row |
No |
Valor numérico |
|
O número da última linha. A numeração começa em 1. |
| Coluna para filtrar |
No |
Valor do texto |
|
Nome ou índice da coluna a ser filtrada. Se a coluna fizer parte de uma tabela, use o nome do cabeçalho. |
| Filtros a aplicar |
Sim |
Regras de filtragem, conforme definido pelo usuário |
N/A |
Regras de filtragem aplicadas à coluna definida |
Variáveis produzidas
Essa ação não produz variáveis.
Exceções
| Exceção |
Description |
| Falha ao aplicar filtro nas células da planilha |
Indica um problema ao aplicar o filtro especificado nas células da planilha |
Limpar filtros na planilha do Excel
| Argumento |
Opcional |
Aceita |
Valor padrão |
Descrição |
| Excel instance |
Não |
Instância do Excel |
|
A instância do Excel com que se trabalhará. Essa variável deverá ter sido especificada anteriormente em uma ação Iniciar o Excel. |
| Limpar filtros em |
N/A |
Planilha ativa, Tabela |
Planilha ativa |
Especifique se os filtros devem ser limpos em toda a planilha ativa ou em uma tabela específica. |
| Nome da tabela |
No |
Valor do texto |
|
O nome da tabela. |
| Limpar filtros de coluna específica |
Sim |
Valor booliano |
|
Limpar filtros de coluna específica. |
| Limpar filtro na coluna |
No |
Valor do texto |
|
O nome da coluna para limpar o filtro aplicado. |
Variáveis produzidas
Essa ação não produz variáveis.
Exceções
| Exceção |
Description |
| Falha ao limpar filtro nas células da planilha |
Indica um problema ao aplicar o filtro especificado nas células da planilha |
Obter célula vazia
| Argumento |
Opcional |
Aceita |
Valor padrão |
Descrição |
| Excel instance |
Não |
Instância do Excel |
|
A instância do Excel com que se trabalhará. Essa variável deverá ter sido especificada anteriormente em uma ação Iniciar o Excel. |
| Operation |
N/A |
Primeira célula vazia, Primeira célula vazia na coluna, Primeira célula vazia na linha, Todas as células vazias |
Primeira célula vazia |
Especifique se deseja pesquisar a primeira célula vazia, a primeira célula vazia na coluna, a primeira célula vazia na linha ou todas as células vazias dentro de um intervalo específico. |
| Direção de pesquisa |
N/A |
Por linha, por coluna |
Por linha |
Especifique se você deve pesquisar por linhas ou colunas para encontrar a primeira célula vazia dentro de um intervalo específico. |
| Pesquisar em |
N/A |
Células com nome, intervalo específico |
Células nomeadas |
Pesquise uma célula vazia em uma célula nomeada ou em um intervalo definido por coluna/linha inicial e coluna/linha final. |
| Nome das células |
No |
Valor do texto |
|
Nome que representa o intervalo. |
| Column |
No |
Valor do texto |
|
Coluna. |
| Linha |
No |
Valor numérico |
|
Linha. |
| Start column |
No |
Valor do texto |
|
O índice ou a letra da primeira coluna. |
| Start row |
No |
Valor numérico |
|
O número da primeira linha. A numeração começa em 1. |
| End column |
No |
Valor do texto |
|
O índice ou a letra da última coluna. |
| End row |
No |
Valor numérico |
|
O número da última linha. A numeração começa em 1. |
Variáveis produzidas
| Argumento |
Type |
Description |
| EmptyCellColumnIndex |
Valor numérico |
O índice da coluna da primeira célula vazia foi encontrado. |
| EmptyCellRowIndex |
Valor numérico |
O índice da linha da primeira célula vazia foi encontrado. |
| EmptyCells |
Tabela de dados |
A lista de células vazias encontrada. |
Exceções
| Exceção |
Description |
| Falha ao obter células vazias |
Indica um problema ao recuperar as células vazias da planilha. |
Limitações conhecidas
Usando arquivos Excel sincronizados por meio do OneDrive ou do SharePoint
A interação com os arquivos do Microsoft Excel contidos em pastas sincronizadas no OneDrive ou no SharePoint pode resultar em um fluxo incorreto. O Power Automate para desktop utiliza objetos COM para interações do Excel. O OneDrive e o SharePoint não são totalmente compatíveis com instâncias do Excel iniciadas por meio do COM.
Por esse motivo, ao tentar abrir um arquivo Excel armazenado em um diretório do OneDrive ou do SharePoint, você poderá encontrar um erro de arquivo não encontrado. Para resolver o problema, use uma das seguintes soluções alternativas:
Solução alternativa 1
- Faça uma cópia local do respectivo arquivo do Excel.
- Modifique a cópia local do arquivo do Excel usando as ações de automação do Power Automate para desktop.
- Substitua a cópia do arquivo Excel sincronizada por meio do OneDrive/Sharepoint pela cópia local que inclui as alterações mais recentes.
Solução alternativa 2
Observação
Essa solução alternativa pode ser usada em geral quando a ação Iniciar Excel falha na execução.
- Abra uma nova instância do Excel usando a ação Executar aplicativo . Certifique-se de fornecer tempo de espera suficiente entre as ações, permitindo que o processo do Excel carregue completamente, incluindo quaisquer suplementos.
- Use a ação Anexar ao Excel para anexar ao novo processo.
Caso com a ação Ler da planilha do Excel
Quando a opção Obter conteúdo da célula como texto está habilitada na ação Ler da planilha do Excel, os dados são recuperados exatamente como aparecem na planilha do Excel. Isso significa que, se a largura da coluna for muito estreita e os dados forem exibidos como ### no Excel, esses símbolos também aparecerão no resultado.
Solução alternativa:
Para evitar isso, use a ação Redimensionar colunas/linhas. Se a opção Obter conteúdo da célula como texto não for usada, os dados obtidos serão os valores brutos da célula, independentemente de como eles são exibidos ou formatados na planilha. Isso significa que não há necessidade de usar a ação Redimensionar colunas/linhas. Para valores de data, a hora será acrescentada porque o tipo de dados de data inclui hora.