Ações do Excel

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.

Parâmetros de entrada

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.

Parâmetros de entrada

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.

Parâmetros de entrada

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
SheetName	Valor do texto	O nome da planilha ativa
SheetIndex	Valor numérico	O índice da planilha ativa

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.

Parâmetros de entrada

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
SheetNames	Lista de Valores do texto	Os nomes de todas as planilhas

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.

Parâmetros de entrada

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.

Parâmetros de entrada

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.

Parâmetros de entrada

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 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	Instância do Excel		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.

Parâmetros de entrada

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.

Parâmetros de entrada

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.

Parâmetros de entrada

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.

Parâmetros de entrada

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.

Parâmetros de entrada

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.

Parâmetros de entrada

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.

Parâmetros de entrada

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.

Parâmetros de entrada

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.

Parâmetros de entrada

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.

Parâmetros de entrada

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.

Parâmetros de entrada

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.

Parâmetros de entrada

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

Ler fórmula do Excel

Lê a fórmula dentro de uma célula no Excel.

Parâmetros de entrada

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 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ções

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.

Parâmetros de entrada

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 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.

Parâmetros de entrada

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 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.

Parâmetros de entrada

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 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.

Parâmetros de entrada

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 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

Iniciar o Excel

Inicia uma nova instância do Excel ou abre um documento do Excel.

Parâmetros de entrada

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.

Parâmetros de entrada

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.

Parâmetros de entrada

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.

Parâmetros de entrada

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.

Parâmetros de entrada

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.

Parâmetros de entrada

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.

Parâmetros de entrada

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.

Parâmetros de entrada

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.

Parâmetros de entrada

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.

Parâmetros de entrada

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.

Parâmetros de entrada

Argumento	Opcional	Aceita	Valor padrão	Descrição
Column number	Não	Valor numérico		O número da coluna

Variáveis produzidas

Argumento	Type	Descrição
ColumnName	Valor do texto	O nome da coluna

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.

Parâmetros de entrada

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

Parâmetros de entrada

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.

Parâmetros de entrada

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

Parâmetros de entrada

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

Parâmetros de entrada

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.