Ações de Excel

Depois de definir uma instância Excel, quer com a ação Lançar Excel ou a Anexar ao Excel em execução, pode processar ainda mais as suas folhas de cálculo do Excel.

Para ler e extrair dados de um documento do Excel, utilize a ação Ler a partir da folha de cálculo do Excel. Pode obter o valor de uma única célula ou de uma tabela de dados. O exemplo seguinte lê as células de A1 até E5:

Quando o fluxo é executado, a ação armazena os dados numa variável de tabela de dados:

Para escrever dados para uma folha de cálculo do Excel, utilize a ação Escrever para folha de cálculo do Excel. Esta ação pode escrever quaisquer dados estáticos ou variáveis para uma célula especificada ou múltiplas células numa folha de cálculo do Excel.

O exemplo seguinte escreve a tabela de dados mencionada anteriormente para a célula A51:

Cada célula na tabela de dados preenche a célula correspondente no livro. O resultado é que o intervalo de células A51-E55 está preenchido com o conteúdo da tabela de dados.

Redimensionar colunas/linhas numa folha de cálculo do Excel

Redimensiona uma seleção de colunas ou linhas na folha de cálculo ativa de uma instância do Excel.

Parâmetros de entrada

Argumento	Opcional	Aceita	Valor Predefinido	Descrição
Excel instance	Não	Instância do Excel		Especifique a instância do Excel. Esta variável tem de ter sido previamente especificada numa ação Iniciar Excel.
Destino do redimensionamento	N/A	Coluna, Linha	Coluna	Especifique se pretende redimensionar colunas ou linhas
Intervalo de seleção	N/A	Único, Intervalo, Todos os disponíveis	Única	Especifique se pretende selecionar uma coluna/linha, um intervalo de colunas/linhas ou todas as colunas/linhas disponíveis na folha de cálculo ativa
Coluna	Não	Valor de texto		O número ou letra do índice da coluna. A numeração da coluna começa a partir do índice 1.
Start column	Não	Valor de texto		O índice ou a letra da primeira coluna. A numeração da coluna começa a partir do índice 1.
End column	Não	Valor de texto		O índice ou a letra da última coluna. A numeração da coluna começa a partir do índice 1.
Linha	Não	Valor numérico		O número de índice da linha. A numeração começa a partir de 1.
Start row	Não	Valor numérico		O índice ou a primeira linha. A numeração começa a partir de 1.
End row	Não	Valor numérico		O índice ou a última linha. A numeração começa a partir de 1.
Tipo de redimensionamento	N/A	Ajuste Automático, Tamanho personalizado	Ajustar Automaticamente	Especifique se pretende ajustar automaticamente as colunas/linhas selecionadas ou definir um tamanho personalizado
Width	Não	Valor numérico		A largura das colunas selecionadas
Height	Não	Valor numérico		A altura das linhas selecionadas

Variáveis produzidas

Esta ação não produz quaisquer 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 Predefinido	Descrição
Excel instance	Não	Instância do Excel		A instância do Excel com a qual pretende trabalhar. Esta variável tem de ter sido previamente especificada numa ação Iniciar Excel.
Macro	Não	Valor de texto		A macro a executar. O texto deve ser composto pelo nome da macro, seguido de quaisquer argumentos (opcional) separados por ponto e vírgula.

Variáveis produzidas

Esta ação não produz quaisquer variáveis.

Exceções

Exceção	Descrição
Falha ao executar macro	Indica um problema ao executar a macro especificada

Obter folha de cálculo ativa do Excel

Obtém a folha de cálculo ativa de um documento do Excel.

Parâmetros de entrada

Argumento	Opcional	Aceita	Valor Predefinido	Descrição
Excel instance	Não	Instância do Excel		A instância do Excel com a qual pretende trabalhar. Esta variável tem de ter sido previamente especificada numa ação Iniciar Excel.

Variáveis produzidas

Argumento	Tipo	Descrição
SheetName	Valor de texto	O nome da folha de cálculo ativa
SheetIndex	Valor numérico	O índice da folha de cálculo ativa

Exceções

Exceção	Descrição
Falha ao obter folha de cálculo ativa	Indica um problema ao obter a folha de cálculo ativa

Obter todas as folhas de cálculo do Excel

Obtém os nomes de todas as folhas de cálculo existentes num documento do Excel.

Parâmetros de entrada

Argumento	Opcional	Aceita	Valor Predefinido	Descrição
Excel instance	Não	Instância do Excel		Especifique a instância do Excel. Esta variável tem de ter sido previamente especificada numa ação Iniciar Excel.

Variáveis produzidas

Argumento	Tipo	Descrição
SheetNames	Lista de valores de Texto	Os nomes de todas as folhas de cálculo

Exceções

Exceção	Descrição
Falha ao obter os nomes de todas as folhas de cálculo	Indica um problema ao obter os nomes das folhas de cálculo do Excel

Eliminar folha de cálculo do Excel

Elimina uma folha de cálculo específica de uma instância do Excel.

Parâmetros de entrada

Argumento	Opcional	Aceita	Valor Predefinido	Descrição
Excel instance	Não	Instância do Excel		A instância do Excel com a qual pretende trabalhar. Esta variável tem de ter sido previamente especificada numa ação Iniciar Excel.
Delete worksheet with	N/A	Índice, Nome	Name	Indica se a folha de cálculo deve ser identificada por nome ou índice
Worksheet index	Não	Valor numérico		O número de índice da folha de cálculo a eliminar. A numeração começa a partir de 1, o que significa que o índice da primeira folha de cálculo é 1, o da segunda é o 2, e por aí adiante.
Worksheet name	Não	Valor de texto		O nome da folha de cálculo a eliminar

Variáveis produzidas

Esta ação não produz quaisquer variáveis.

Exceções

Exceção	Descrição
Não é possível encontrar a folha de cálculo	Indica que não foi possível encontrar uma folha de cálculo com o nome especificado
Falha ao eliminar folha de cálculo	Indica um problema ao eliminar a folha de cálculo especificada

Mudar nome de uma folha de cálculo do Excel

Muda o nome de uma folha de cálculo específica de uma instância do Excel.

Parâmetros de entrada

Argumento	Opcional	Aceita	Valor Predefinido	Descrição
Excel instance	Não	Instância do Excel		Especifique a instância do Excel. Esta variável tem de ter sido previamente especificada numa ação Iniciar Excel.
Rename worksheet with	N/A	Índice, Nome	Name	Especifique se a folha de cálculo deve ser identificada por nome ou índice
Worksheet index	Não	Valor numérico		O índice da folha de cálculo cujo nome deve ser mudado. A numeração começa a partir de 1, o que significa que o índice da primeira folha de cálculo é 1, o da segunda é o 2, e por aí adiante.
Worksheet name	Não	Valor de texto		O nome da folha de cálculo cujo nome deve ser mudado
Worksheet new name	Não	Valor de texto		O novo nome da folha de cálculo

Variáveis produzidas

Esta ação não produz quaisquer variáveis.

Exceções

Exceção	Descrição
Não é possível encontrar a folha de cálculo	Indica que não foi possível encontrar uma folha de cálculo com o nome especificado
Falha ao mudar nome de folha de cálculo	Indica um problema ao mudar o nome da folha de cálculo especificada

Copiar folha de cálculo do Excel

Copia uma folha de cálculo a partir de um documento do Excel e cola-a no documento do Excel na mesma instância do Excel ou noutra instância.

Parâmetros de entrada

Argumento	Opcional	Aceita	Valor Predefinido	Descrição
Excel instance	Não	Instância do Excel		A instância do Excel com a qual pretende trabalhar. Esta variável tem de ser especificada numa ação Iniciar Excel.
Copiar folha de cálculo com	N/A	Índice, Nome	Name	Especifique se a folha de cálculo deve ser identificada por nome ou índice
Worksheet index	Não	Valor numérico		O índice da folha de cálculo a copiar. A numeração começa a partir de 1, o que significa que o índice da primeira folha de cálculo é 1, o da segunda é o 2, e por aí adiante.
Worksheet name	Não	Valor de texto		O nome da folha de cálculo a copiar.
Instância do Excel de destino	Νο	Instância do Excel		A instância Excel do ficheiro de destino. Esta variável tem de ser especificada numa ação Iniciar Excel.
Worksheet new name	Não	Valor de texto		O novo nome da folha de cálculo
Colar folha de cálculo como	N/A	Primeira folha de cálculo, Última folha de cálculo	Primeira folha de cálculo	Especifique se a folha de cálculo do Excel copiada será adicionada antes ou depois das folhas de cálculo existentes

Variáveis produzidas

Esta ação não produz quaisquer variáveis.

Exceções

Exceção	Descrição
Falha ao copiar folha de cálculo	Indica um problema ao copiar uma folha de cálculo no Excel
Não é possível copiar uma folha de cálculo com este nome	Indica um problema ao tentar atribuir o nome da folha após a cópia

Ativar uma célula numa folha de cálculo do Excel

Ativar uma célula na folha de cálculo ativa de uma instância do Excel, fornecendo a coluna, a linha e o desvio.

Parâmetros de entrada

Argumento	Opcional	Aceita	Valor Predefinido	Descrição
Excel instance	Não	Instância do Excel		Especifique a instância do Excel com a qual pretende trabalhar. Esta variável tem de ter sido previamente especificada numa ação Iniciar Excel.
Activate	N/A	Célula absolutamente especificada, célula relativamente especificada	Célula com especificação absoluta	Selecione se pretende especificar a célula a ativar de forma absoluta ou relativa, usando uma distância de desvio como o número de células entre a célula de referência atualmente ativa e a célula a ativar.
Coluna	Não	Valor de texto		O valor numérico ou a letra da coluna da célula.
Direction	N/A	Esquerda, Direita, Acima, Abaixo	Left	Selecionar a direção de desvio. Selecione onde procurar a célula a ativar com base na posição da célula atualmente ativa.
Offset from active cell	Não	Valor numérico		A distância em células entre a célula atualmente ativa e a célula pretendida. A numeração começa a partir de 0.
Linha	Não	Valor numérico		O valor numérico da fila de células. A numeração começa a partir de 1.

Variáveis produzidas

Esta ação não produz quaisquer variáveis.

Exceções

Exceção	Descrição
Falha ao ativar célula	Indica um problema ao ativar uma célula do Excel

Selecionar células numa folha de cálculo do Excel

Seleciona um intervalo de células na folha de cálculo ativa de uma instância do Excel.

Tem três opções quando se trata de recuperar um intervalo de células através do Excel com a ação Selecionar células na folha de cálculo do Excel. Para começar, precisa de uma instância do Excel válida, que pode ser criada ao utilizar a ação Iniciar Excel e fornecendo as respetivas 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 a letra das células, definindo o seu início e fim nas seguintes propriedades: Coluna de início, Linha de início, Coluna de fim, Linha de fim.

• Para selecionar um intervalo de células, relativo à célula ativa no momento, selecione primeiro a opção Intervalo de células relativo à 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 desvio da célula ativa nos dois eixos, modificando as propriedades direção do eixo X, desvio do eixo X, direção do eixo Y e desvio do eixo Y.

• Para selecionar um intervalo de células utilizando o nome do intervalo, selecione a opção Nomes de células na propriedade Selecionar.

Parâmetros de entrada

Argumento	Opcional	Aceita	Valor Predefinido	Descrição
Excel instance	Não	Instância do Excel		A instância do Excel com a qual pretende trabalhar. Esta variável tem de ter sido previamente especificada numa ação Iniciar Excel.
Selecione	N/A	Célula absolutamente especificada, célula relativamente especificada	Célula com especificação absoluta	Especifique se pretende selecionar um intervalo de células explicitamente especificado ou um intervalo de células relativo à célula atualmente ativa.
X Axis Direction	N/A	Esquerda, Direita	Left	A direção de desvio do eixo X. Onde procurar no eixo horizontal, com base na posição da célula atualmente ativa.
Start column	Não	Valor de texto		O índice ou a letra da primeira coluna.
X Offset	Não	Valor numérico		O desvio do eixo X.
Start row	Não	Valor numérico		O número da primeira linha. A numeração começa a partir de 1.
End column	Não	Valor de texto		O índice ou a letra da última coluna.
Y Axis Direction	N/A	Acima, Abaixo	Superior	A direção de desvio do eixo Y. Onde procurar no eixo vertical, com base na posição da célula atualmente ativa.
End row	Não	Valor numérico		O número da última linha. A numeração começa a partir de 1.
Y Offset	Não	Valor numérico		O desvio do eixo Y.

Variáveis produzidas

Esta ação não produz quaisquer variáveis.

Exceções

Exceção	Descrição
Falha ao selecionar células	Indica um problema ao selecionar as células especificadas

Obter o intervalo de células selecionado a partir de uma folha de cálculo do Excel

Obter o intervalo de células selecionado numa estrutura composta por primeira coluna, primeira linha, última coluna e última linha.

Parâmetros de entrada

Argumento	Opcional	Aceita	Valor Predefinido	Descrição
Excel instance	Não	Instância do Excel		A instância do Excel com a qual pretende trabalhar. Esta variável tem de ter sido previamente especificada numa ação Iniciar Excel.

Variáveis produzidas

Argumento	Tipo	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
Falha ao obter intervalo de células selecionado	Indica um problema ao obter o intervalo de células selecionado

Copiar células de uma folha de cálculo do Excel

Copia um intervalo de células da folha de cálculo ativa numa instância do Excel.

Parâmetros de entrada

Argumento	Opcional	Aceita	Valor Predefinido	Descrição
Excel instance	Não	Instância do Excel		A instância do Excel com a qual pretende trabalhar. Esta variável tem de ter sido previamente especificada numa ação Iniciar Excel.
Copy mode	N/A	Valores de célula única, valores de um intervalo de células, valores da seleção	Valores de célula única	Especifique se pretende copiar uma única célula, um intervalo de células ou as células atualmente selecionadas
Start column	Não	Valor de 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 de texto		O índice ou a letra da última coluna
End row	Não	Valor numérico		O índice da última linha

Variáveis produzidas

Esta ação não produz quaisquer variáveis.

Exceções

Exceção	Descrição
Falha ao copiar células	Indica um problema ao copiar as células do documento do Excel

Colar células numa folha de cálculo do Excel

Cola um intervalo de células na folha de cálculo ativa de uma instância do Excel.

Parâmetros de entrada

Argumento	Opcional	Aceita	Valor Predefinido	Descrição
Excel instance	Não	Instância do Excel		Especifique a instância do Excel. Esta variável tem de ter sido previamente especificada numa ação Iniciar Excel.
Paste mode	N/A	Na célula especificada, na célula atualmente ativa	Na célula especificada	Especifique se pretende colar numa célula especificada ou na célula atualmente ativa
Coluna	Não	Valor de 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

Esta ação não produz quaisquer variáveis.

Exceções

Exceção	Descrição
Falha ao colar células	Indica um problema ao colar as células especificadas

Eliminar da folha de cálculo do Excel

Elimina um intervalo de células da folha de cálculo ativa numa instância do Excel.

Parâmetros de entrada

Argumento	Opcional	Aceita	Valor Predefinido	Descrição
Excel instance	Não	Instância do Excel		A instância do Excel com a qual pretende trabalhar. Esta variável tem de ter sido previamente especificada numa ação Iniciar Excel.
Obter	N/A	O valor de uma única célula, Valores de um intervalo de células	O valor de uma única célula	Indica se deve ser eliminada uma única célula ou uma tabela a partir de um intervalo de células
Start column	Não	Valor de texto		A coluna da célula (valor de uma única célula) ou primeira coluna como um valor numérico ou uma letra
Start row	Não	Valor numérico		A linha da célula (valor de uma única célula) ou o número da primeira linha
End column	Não	Valor de 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	Esquerda, Cima	Left	A direção da deslocação

Variáveis produzidas

Esta ação não produz quaisquer variáveis.

Exceções

Exceção	Descrição
Falha ao eliminar células	Indica um problema ao eliminar as células especificadas

Inserir linha numa folha de cálculo do Excel

Insere uma linha acima de uma linha selecionada de uma instância do Excel.

Parâmetros de entrada

Argumento	Opcional	Aceita	Valor Predefinido	Descrição
Excel instance	Não	Instância do Excel		A instância do Excel com a qual pretende trabalhar. Esta variável tem de ter sido previamente especificada numa ação Iniciar Excel.
Índice de linha	Não	Valor numérico		O índice da linha acima da qual deve ser adicionada uma nova linha. A numeração começa a partir de 1.

Variáveis produzidas

Esta ação não produz quaisquer variáveis.

Exceções

Exceção	Descrição
Não é possível encontrar a linha	Indica que não foi possível encontrar uma linha com o índice especificado
Falha ao inserir linha	Indica um problema ao inserir uma linha na instância do Excel especificada

Eliminar uma linha de uma folha de cálculo do Excel

Elimina uma linha selecionada de uma instância do Excel.

Parâmetros de entrada

Argumento	Opcional	Aceita	Valor Predefinido	Descrição
Excel instance	Não	Instância do Excel		A instância do Excel. Esta variável tem de ter sido previamente especificada numa ação Iniciar Excel.
Delete row	Não	Valor numérico		O número de índice da linha a eliminar. A numeração começa a partir de 1.

Variáveis produzidas

Esta ação não produz quaisquer variáveis.

Exceções

Exceção	Descrição
Não é possível encontrar a linha	Indica que não foi possível encontrar uma linha com o índice especificado
Falha ao eliminar linha	Indica um problema ao eliminar a linha especificada

Inserir coluna numa folha de cálculo do Excel

Insere uma coluna à esquerda de uma coluna selecionada de uma instância do Excel.

Parâmetros de entrada

Argumento	Opcional	Aceita	Valor Predefinido	Descrição
Excel instance	Não	Instância do Excel		A instância do Excel com a qual pretende trabalhar. Esta variável tem de ter sido previamente especificada numa ação Iniciar Excel.
Coluna	Não	Valor de texto		O número ou letra do índice da coluna. Irá aparecer uma nova coluna à esquerda da coluna indicada.

Variáveis produzidas

Esta ação não produz quaisquer variáveis.

Exceções

Exceção	Descrição
Não é possível encontrar a coluna	Indica que não foi possível encontrar uma coluna com o nome especificado
Falha ao inserir coluna	Indica um problema ao inserir uma coluna na instância do Excel especificada

Eliminar uma coluna de uma folha de cálculo do Excel

Elimina uma coluna selecionada de uma instância do Excel.

Parâmetros de entrada

Argumento	Opcional	Aceita	Valor Predefinido	Descrição
Excel instance	Não	Instância do Excel		A instância do Excel com a qual pretende trabalhar. Esta variável tem de ter sido previamente especificada numa ação Iniciar Excel.
Delete column	Não	Valor de texto		O número do índice ou a letra da coluna a eliminar.

Variáveis produzidas

Esta ação não produz quaisquer variáveis.

Exceções

Exceção	Descrição
Não é possível encontrar a coluna	Indica que não foi possível encontrar uma coluna com o nome especificado
Falha ao eliminar coluna	Indica um problema ao eliminar a coluna especificada

Localizar e substituir células numa folha de cálculo do Excel

Localiza texto e substitui-o por outro texto na folha de cálculo ativa de uma instância do Excel.

Parâmetros de entrada

Argumento	Opcional	Aceita	Valor Predefinido	Descrição
Excel instance	Não	Instância do Excel		A instância do Excel com a qual pretende trabalhar. Esta variável tem de ter sido previamente especificada numa ação Iniciar Excel.
Search mode	N/A	Localizar, Localizar e substituir	Find	O modo de pesquisa a utilizar
All matches	N/D	Valor booleano	Falso	Indica se o texto deve ser localizado/substituído em todas as células correspondentes encontradas ou apenas na primeira célula correspondente
Text to find	Não	Valor de texto		O texto a localizar na folha de cálculo
Text to replace with	Não	Valor de texto		O texto utilizado para substituir as células correspondentes
Match case	N/D	Valor booleano	Falso	Indica se pretende procurar dados sensíveis às maiúsculas e minúsculas
Match entire cell contents	N/D	Valor booleano	Falso	Indica se pretende procurar células que contenham apenas o texto especificado
Search by	N/D	Linhas, Colunas	Linhas	A ordem pela qual o texto deve ser procurado

Variáveis produzidas

Argumento	Tipo	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
Falha ao localizar e/ou substituir texto	Indica um problema ao localizar e/ou substituir o texto especificado

Obter a primeira linha livre numa coluna a partir de uma folha de cálculo do Excel

Obter a primeira linha livre da coluna indicada na folha de cálculo ativa.

Parâmetros de entrada

Argumento	Opcional	Aceita	Valor Predefinido	Descrição
Excel instance	Não	Instância do Excel		Especifique a instância do Excel. Esta variável tem de ter sido previamente especificada numa ação Iniciar Excel.
Coluna	Não	Valor de texto		O índice ou a letra que identifica a coluna. A numeração da coluna começa a partir do índice 1.

Variáveis produzidas

Argumento	Tipo	Descrição
FirstFreeRowOnColumn	Valor numérico	O valor numérico da primeira linha totalmente vazia da coluna

Exceções

Exceção	Descrição
Falha ao obter a primeira linha livre	Indica um problema ao obter a primeira linha livre de uma instância do Excel

Ler fórmula a partir do Excel

Lê a fórmula existente numa célula no Excel.

Parâmetros de entrada

Argumento	Opcional	Aceita	Valor Predefinido	Descrição
Excel instance	Não	Instância do Excel		A instância do Excel com a qual pretende trabalhar. Esta variável tem de ser especificada numa ação Iniciar 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 obtida a partir de uma célula especificada ou de uma célula nomeada
Start column	Não	Valor de texto		A coluna da célula (valor de uma única célula) ou primeira coluna como um valor numérico ou uma letra
Start row	Não	Valor numérico		A linha da célula (valor de uma única célula) ou o número da primeira linha
Name	Não	Valor de texto		O nome das células

Variáveis produzidas

Argumento	Tipo	Descrição
CellFormula	Valor de texto	A fórmula de uma única célula

Exceções

Exceção	Descrição
Falha ao ler a fórmula a partir da célula	Indica um problema ao ler a fórmula a partir de uma célula no Excel

Obter o intervalo da tabela a partir de uma folha de cálculo do Excel

Obtém o intervalo de uma tabela na folha de cálculo ativa de uma instância do Excel.

Parâmetros de entrada

Argumento	Opcional	Aceita	Valor Predefinido	Descrição
Excel instance	Não	Instância do Excel		A instância do Excel com a qual pretende trabalhar. Esta variável tem de ser especificada numa ação Iniciar Excel.
Nome da tabela	Não	Valor de texto		Especificar o nome da tabela no Excel.
É dinâmica	N/A	Valor booleano	False	Determine se a tabela especificada é uma tabela dinâmica.

Variáveis produzidas

Argumento	Tipo	Descrição
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	Descrição
Falha ao obter o intervalo da tabela	Indica um problema ao obter o intervalo a partir de uma tabela no Excel

Preencher células automaticamente numa folha de cálculo do Excel

Preenche automaticamente um intervalo com dados, com base nos dados de outro intervalo existente na folha de cálculo ativa de uma instância do Excel.

Parâmetros de entrada

Argumento	Opcional	Aceita	Valor Predefinido	Descrição
Excel instance	Não	Instância do Excel		A instância do Excel com a qual pretende trabalhar. Esta variável tem de ser especificada numa ação Iniciar Excel.
Formato dos intervalos	N/A	Células nomeadas, Intervalos específicos	Células nomeadas	Especifique como os intervalos são referenciados, utilizando células nomeadas ou índices absolutos de coluna/linha
Nome das células de origem	Não	Valor de texto		Nome que representa o intervalo de origem para preenchimento automático
Nome das células de destino	Não	Valor de texto		Nome que representa o intervalo de destino a preencher automaticamente. O intervalo de origem deve começar a partir da mesma célula e deve ser incluído no intervalo de destino
Start column	Não	Valor de texto		O índice ou a letra da primeira coluna de ambos os intervalos
Start row	Não	Valor numérico		O número da primeira linha de ambos os intervalos. A numeração começa a partir de 1
Coluna de fim de origem	Não	Valor de texto		O índice ou a letra da última coluna do intervalo de origem
Linha de fim de origem	Não	Valor numérico		O número da última linha do intervalo de origem. A numeração começa a partir de 1
Coluna de fim de destino	Não	Valor de texto		O índice ou a letra da última coluna do intervalo de destino
Linha de fim de destino	Não	Valor numérico		O número da última linha do intervalo de destino. A numeração começa a partir de 1

Variáveis produzidas

Esta ação não produz quaisquer variáveis.

Exceções

Exceção	Descrição
Falha ao preencher células automaticamente	Indica um problema ao preencher automaticamente células no Excel

Acrescentar células numa folha de cálculo do Excel

Acrescenta um intervalo de células à folha de cálculo ativa de uma instância do Excel.

Parâmetros de entrada

Argumento	Opcional	Aceita	Valor Predefinido	Descrição
Excel instance	Não	Instância do Excel		A instância do Excel com a qual pretende trabalhar. Esta variável tem de ser especificada numa ação Iniciar Excel.
Modo de acrescentar	N/A	Para a folha ativa, Para as células nomeadas	Para a folha ativa	Especificar se pretende acrescentar a uma folha de cálculo ou a um intervalo de células nomeadas
Name	Não	Valor de texto		O nome do intervalo de células
A primeira linha tem cabeçalhos	N/A	Valor booleano	False	Indica que a primeira linha do destino contém cabeçalhos de coluna
Coluna inicial	Sim	Valor de texto		O número ou letra da coluna inicial, onde os dados são acrescentados a partir da primeira linha vazia do destino. Se o campo ficar vazio, é utilizada a primeira coluna do destino especificado.
Cabeçalho da coluna inicial	Sim	Valor de texto		O cabeçalho da coluna inicial, onde os dados são acrescentados a partir da primeira linha vazia do destino. Se o campo ficar vazio, é utilizada a primeira coluna do destino especificado.

Variáveis produzidas

Esta ação não produz quaisquer variáveis.

Exceções

Exceção	Descrição
Falha ao anexar células	Indica um problema ao acrescentar células no Excel

Intervalo de pesquisa na folha de cálculo do Excel

Localiza e devolve o resultado da função LOOKUP do Excel.

Parâmetros de entrada

Argumento	Opcional	Aceita	Valor Predefinido	Descrição
Excel instance	Não	Instância do Excel		A instância do Excel com a qual pretende trabalhar. Esta variável tem de ser especificada numa ação Iniciar Excel.
Valor de pesquisa	Não	Valor de texto		O valor a pesquisar no intervalo de células especificado.
Formato dos intervalos	N/A	Células nomeadas, Intervalos específicos	Células nomeadas	Especifique como os intervalos são referenciados, utilizando células nomeadas ou índices absolutos de coluna/linha.
Nome da célula	Não	Valor de texto		O nome do intervalo de células para procurar o valor de pesquisa.
Start column	Não	Valor de texto		O índice ou a letra da primeira coluna do intervalo para procurar o valor de pesquisa.
Start row	Não	Valor numérico		O número da primeira linha do intervalo a procurar pelo valor de procura. A numeração começa a partir de 1.
End column	Não	Valor de texto		O índice ou a letra da última coluna do intervalo para procurar o valor de pesquisa.
End row	Não	Valor numérico		O número da última linha do intervalo a procurar pelo valor de procura. A numeração começa a partir de 1.
Formato de matriz	N/A	Valor booleano	False	A forma de matriz de PROCURA pesquisa pelo valor especificado na primeira linha ou coluna de uma matriz e devolve um valor da mesma posição na última linha ou coluna da matriz. Utilize esta forma de PROCURA quando os valores que pretende corresponder estiverem na primeira linha ou coluna da matriz. Se esta opção permanecer desativada, é utilizada a forma de vetor de PROCURA, que procura um valor num intervalo de uma linha ou coluna (conhecido como vetor) e devolve um valor da mesma posição num segundo intervalo de uma linha ou de uma coluna.
Nome das células da origem dos resultados	Sim	Valor de texto		O nome do intervalo de células a partir do qual o valor correspondente é devolvido.
Coluna de início da origem dos resultados	Não	Valor de texto		O índice ou a letra da primeira coluna do intervalo a partir do qual o intervalo correspondente é devolvido.
Linha de início da origem dos resultados	Não	Valor numérico		O número da primeira linha do intervalo a partir do qual o valor correspondente é devolvido. A numeração começa a partir de 1.
Coluna de fim da origem dos resultados	Não	Valor de texto		O índice ou a letra da última coluna do intervalo a partir do qual o intervalo correspondente é devolvido.
Linha de fim da origem dos resultados	Não	Valor numérico		O número da última linha do intervalo a partir do qual o valor correspondente é devolvido. A numeração começa a partir de 1.

Variáveis produzidas

Argumento	Tipo	Descrição
LookupResult	Valor de texto	O valor devolvido pela função LOOKUP

Exceções

Exceção	Descrição
Falha ao procurar	Indica um problema ao pesquisar um valor no Excel

Definir a cor das células na folha de cálculo do Excel

Preenche o fundo das células selecionadas com a cor especificada na folha de cálculo ativa de uma instância do Excel.

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

Parâmetros de entrada

Argumento	Opcional	Aceita	Valor Predefinido	Descrição
Excel instance	Não	Instância do Excel		A instância do Excel com a qual pretende trabalhar. Esta variável tem de ser especificada numa ação Iniciar Excel.
Definir cor de	N/A	Célula única, Intervalo de células, Células nomeadas	Célula única	Especifique se pretende definir a cor de fundo de uma única célula, de um intervalo de células ou de células nomeadas.
Start column	No	Valor de 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 o número da primeira linha do intervalo. A numeração começa a partir de 1.
End column	No	Valor de 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 a partir de 1.
Nome da célula	No	Valor de texto		Nome que representa o intervalo que será preenchido com a cor especificada.
Formato da cor	N/A	Nome, Valor hexadecimal	Name	Selecione se pretende especificar uma cor pelo respetivo nome ou pelo respetivo valor hexadecimal.
Nome da cor	No	Valor de texto		Selecione uma das cores definidas pelo sistema.
Valor hexadecimal da cor	No	Valor de texto		Especifique o valor hexadecimal (RGB) da cor.

Variáveis produzidas

Esta ação não produz quaisquer variáveis.

Exceções

Exceção	Description
Falha ao definir cor	Indica um problema ao definir a cor das células 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 Predefinido	Descrição
Launch Excel	N/A	Com um documento em branco e abrir o seguinte documento	Com um documento em branco	Especifique se pretende abrir um Novo documento do Excel ou um documento existente
Caminho do documento	Não	Ficheiro		O caminho completo do documento do Excel existente a abrir
Make instance visible	N/D	Valor booleano	Verdadeiro	Especifique se pretende tornar a janela do Excel visível ou oculta
Aninhar num novo processo do Excel	N/A	Valor booleano	Falso	Especificar se a folha de cálculo do Excel deve estar por baixo de um processo do Excel exclusivo. Macros e suplementos de outras folhas de cálculo não serão acessíveis.
Password	Sim	Entrada direta encriptada ou Valor de texto		A palavra-passe do documento do Excel, se este estiver protegido por palavra-passe
Open as ReadOnly	N/A	Valor booleano	Falso	Especifique se o documento armazenado deve ser aberto no modo só de leitura
Load add-ins and macros	N/D	Valor booleano	Falso	Especifique se pretende carregar suplementos e macros na nova instância do Excel

Variáveis produzidas

Argumento	Tipo	Descrição
ExcelInstance	Instância do Excel	A instância do Excel específica a utilizar com ações posteriores do Excel. Isto permite ao utilizador especificar a que folhas de cálculo do Excel pode aceder

Exceções

Exceção	Descrição
Falha ao iniciar o Excel	Indica um problema ao iniciar uma instância do Excel
Falha ao abrir documento do Excel	Indica um problema ao abrir ao documento do Excel especificado

Anexar a uma instância do Excel em execução

Anexa a um documento do Excel que já está aberto.

Parâmetros de entrada

Argumento	Opcional	Aceita	Valor Predefinido	Descrição
Document name	Não	Ficheiro		O nome ou caminho do documento do Excel de destino

Variáveis produzidas

Argumento	Tipo	Descrição
ExcelInstance	Instância do Excel	A instância do Excel de destino desta ação de anexar, para utilização com ações posteriores do Excel

Exceções

Exceção	Descrição
Documento do Excel especificado não encontrado	Indica que não foi possível encontrar o documento do Excel especificado
Falha ao anexar ao documento do Excel	Indica um problema ao anexar ao documento do Excel

Ler a partir da folha de cálculo do Excel

Lê o valor de uma célula ou um intervalo de células da folha de cálculo ativa de uma instância do Excel.

Parâmetros de entrada

Argumento	Opcional	Aceita	Valor Predefinido	Descrição
Excel instance	Não	Instância do Excel		A instância do Excel com a qual pretende trabalhar. Esta variável tem de ter sido previamente especificada numa ação Iniciar Excel.
Obter	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 folha de cálculo	O valor de uma única célula	Indica se deve ser obtido o valor de uma única célula, de um intervalo de células de uma tabela ou da folha de cálculo completa
Start column	Não	Valor de texto		A coluna da célula (valor de uma única célula) ou primeira coluna como um valor numérico ou uma letra
Start row	Não	Valor numérico		A linha da célula (Valor de uma única célula) ou o número da primeira linha
End column	Não	Valor de 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 booleano	Falso	Especifique se pretende obter o conteúdo das células como texto simples ou como o tipo correspondente mais próximo, como Data/Hora para datas, Numérico para números e assim consecutivamente
First line of range contains column names	N/A	Valor booleano	Falso	Especificar se deve considerar a primeira linha como nomes de colunas. Neste caso, os nomes não serão lidos como dados na tabela e as ações posteriores poderão pesquisar os dados pelos nomes das colunas.

Variáveis produzidas

Argumento	Tipo	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	Descrição
Falha ao ler valores das células	Indica um problema ao ler os valores das células do Excel especificadas

Obter célula ativa em folha de cálculo do Excel

Obter a célula ativa na folha de cálculo ativa do documento do Excel.

Parâmetros de entrada

Argumento	Opcional	Aceita	Valor Predefinido	Descrição
Excel instance	Não	Instância do Excel		A instância do Excel com a qual pretende trabalhar. Esta variável tem de ter sido previamente especificada numa ação Iniciar Excel.

Variáveis produzidas

Argumento	Tipo	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
Falha ao obter célula ativa	Indica um problema ao obter a célula ativa

Guardar o Excel

Guarda uma instância do Excel anteriormente iniciada.

Parâmetros de entrada

Argumento	Opcional	Aceita	Valor Predefinido	Descrição
Excel instance	Não	Instância do Excel		A instância do Excel a guardar. Esta variável tem de ter sido previamente especificada numa ação Iniciar Excel.
Modo de guardar	N/A	Guardar documento, Guardar documento como	Guardar documento	Como guardar o documento desta instância
Document format	N/D	Predefinição (a partir da extensão), livro Excel (.xlsx), livro Excel macro ativada (.xlsm), livro Excel 97-2003 (.xls), página Web (.htm, .html), modelo Excel (.xltx), modelo Excel macro ativada (.xltm), modelo Excel 97-2003 (.xlt), texto (.txt), texto Unicode (.txt), texto Macintosh (.txt .xml), texto DOS (.txt), folha de cálculo XML (.xml), Excel 95 (.xls), CSV (.csv), DIF (.dif), SYLK (.slk), suplemento Excel (.xlam), suplemento Excel 97-2003 (.xla), livro Strict Open XML (.xlsx), folha de cálculo OpenDocument (.ods), dados XML (.xml), Livro Binário do Excel (.xlsb)	Predefinição (A partir da Extensão)	O formato no qual o documento deve ser guardado
Caminho do documento	Não	Ficheiro		O caminho completo no qual o documento deve ser guardado

Variáveis produzidas

Esta ação não produz quaisquer variáveis.

Exceções

Exceção	Descrição
Falha ao guardar documento do Excel	Indica um problema ao guardar o documento do Excel

Escrever numa folha de cálculo do Excel

Escreve um valor numa célula ou num intervalo de células de uma instância do Excel.

Parâmetros de entrada

Argumento	Opcional	Aceita	Valor Predefinido	Descrição
Excel instance	Não	Instância do Excel		A instância do Excel com a qual pretende trabalhar. Esta variável tem de ter sido previamente especificada numa ação Iniciar Excel.
Valor a escrever	Não	Valor geral		Introduza o texto, número ou variável a inserir. Se a variável contiver uma tabela, serão preenchidas as células à direita e abaixo, substituindo os dados dessa célula se necessário, e uma lista irá preencher as células abaixo.
Write mode	N/A	Na célula especificada, na célula atualmente ativa	Na célula especificada	Indica se pretende escrever numa célula especificada ou na célula atualmente ativa
Coluna	Não	Valor de texto		O número da coluna ou a letra da célula de destino da escrita
Row	Não	Valor numérico		A fila de células a gravar. A numeração começa a partir de 1, o que significa que o índice da primeira folha de cálculo é 1, o da segunda é o 2, e por aí adiante.

Variáveis produzidas

Esta ação não produz quaisquer variáveis.

Exceções

Exceção	Descrição
Falha ao escrever valor no Excel	Indica um problema ao escrever o valor especificado na instância do Excel

Fechar o Excel

Fecha uma instância do Excel.

Parâmetros de entrada

Argumento	Opcional	Aceita	Valor Predefinido	Descrição
Excel instance	Não	Instância do Excel		A instância do Excel a fechar. Esta variável tem de ter sido previamente especificada numa ação Iniciar Excel.
Before closing Excel	N/A	Não guardar documento, Guardar documento, Guardar documento como	Não guardar documento	Indica se e como deve ser guardado o documento existente nesta instância antes de a fechar
Document format	N/D	Predefinição (a partir da extensão), livro Excel (.xlsx), livro Excel macro ativada (.xlsm), livro Excel 97-2003 (.xls), página Web (.htm, .html), modelo Excel (.xltx), modelo Excel macro ativada (.xltm), modelo Excel 97-2003 (.xlt), texto (.txt), texto Unicode (.txt), texto Macintosh (.txt .xml), texto DOS (.txt), folha de cálculo XML (.xml), Excel 95 (.xls), CSV (.csv), DIF (.dif), SYLK (.slk), suplemento Excel (.xlam), suplemento Excel 97-2003 (.xla), livro Strict Open XML (.xlsx), folha de cálculo OpenDocument (.ods), dados XML (.xml), Livro Binário do Excel (.xlsb)	Predefinição (A partir da Extensão)	O formato do documento
Caminho do documento	Não	Ficheiro		O caminho completo do documento

Variáveis produzidas

Esta ação não produz quaisquer variáveis.

Exceções

Exceção	Descrição
Falha ao guardar documento do Excel	Indica um problema ao guardar o documento do Excel
Falha ao fechar instância do Excel	Indica um problema ao fechar a instância do Excel

Definir folha de cálculo ativa do Excel

Ativa uma folha de cálculo específica de uma instância do Excel.

Parâmetros de entrada

Argumento	Opcional	Aceita	Valor Predefinido	Descrição
Excel instance	Não	Instância do Excel		Especifique a instância do Excel. Esta variável tem de ter sido previamente especificada numa ação Iniciar Excel.
Activate worksheet with	N/A	Índice, Nome	Name	Especifique se a folha de cálculo deve ser identificada por nome ou índice
Worksheet index	Não	Valor numérico		O número de índice da folha de cálculo a ativar. A numeração começa a partir de 1, o que significa que o índice da primeira folha de cálculo é 1, o da segunda é o 2, e por aí adiante.
Worksheet name	Não	Valor de texto		O nome da folha de cálculo a ativar

Variáveis produzidas

Esta ação não produz quaisquer variáveis.

Exceções

Exceção	Descrição
Não é possível encontrar a folha de cálculo	Indica que não foi possível encontrar uma folha de cálculo com o nome especificado
Falha ao ativar folha de cálculo	Indica um problema ao ativar a folha de cálculo especificada

Adicionar nova folha de cálculo

Adiciona uma nova folha de cálculo ao documento de uma instância do Excel.

Parâmetros de entrada

Argumento	Opcional	Aceita	Valor Predefinido	Descrição
Excel instance	Não	Instância do Excel		Especifique a instância do Excel. Esta variável tem de ter sido previamente especificada numa ação Iniciar Excel.
New worksheet name	Não	Valor de texto		Especifique o nome da nova folha de cálculo
Add worksheet as	N/D	Primeira folha de cálculo, Última folha de cálculo	Primeira folha de cálculo	Especifique se a nova folha de cálculo do Excel será adicionada antes ou depois das folhas de cálculo existentes

Variáveis produzidas

Esta ação não produz quaisquer variáveis.

Exceções

Exceção	Descrição
Já existe uma folha de cálculo com o mesmo nome	Indica que não foi possível adicionar a folha de cálculo porque já existe uma folha de cálculo com o mesmo nome
Falha ao adicionar folha de cálculo	Indica um problema ao adicionar a folha de cálculo

Obter a primeira coluna/linha livre a partir de uma folha de cálculo do Excel

Obtém a primeira linha livre e/ou coluna da folha de cálculo ativa. Isto é útil para adicionar novos dados numa folha de cálculo que já tem dados.

Parâmetros de entrada

Argumento	Opcional	Aceita	Valor Predefinido	Descrição
Excel instance	Não	Instância do Excel		Especifique a instância do Excel. Esta variável tem de ter sido previamente especificada numa ação Iniciar Excel.

Variáveis produzidas

Argumento	Tipo	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, 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, será armazenada como "7".

Exceções

Exceção	Descrição
Falha ao obter a primeira coluna/linha livre	Indica um problema ao obter a primeira coluna/linha livre de uma instância do Excel

Obter o nome da coluna na folha de cálculo do Excel

Obtém o nome da coluna.

Parâmetros de entrada

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

Variáveis produzidas

Argumento	Tipo	Descrição
ColumnName	Valor de texto	O nome da coluna

Exceções

Esta ação não inclui quaisquer exceções.

Limpar células numa folha de cálculo do Excel

Limpa um intervalo de células ou uma célula nomeada na folha de cálculo ativa de uma instância do Excel.

Parâmetros de entrada

Argumento	Opcional	Aceita	Valor Predefinido	Descrição
Excel instance	Não	Instância do Excel		A instância do Excel com a qual pretende trabalhar. Esta variável tem de ter sido previamente especificada numa ação Iniciar Excel.
Desmarcar	N/A	Intervalo de células, Intervalo de células relativo à célula ativa, Células nomeadas, Célula única	Intervalo de células	Especifique se pretende selecionar um intervalo de células explicitamente especificado, um intervalo de células relativo à célula atualmente ativa, células nomeadas ou uma célula única.
Direção do Eixo X	N/A	Esquerda, Direita	Esquerda	A direção de desvio do eixo X. Onde procurar no eixo horizontal, com base na posição da célula atualmente ativa.
Start column	Não	Valor de texto		O índice ou a letra da primeira coluna.
X Offset	Não	Valor numérico		O desvio do eixo X.
Start row	Não	Valor numérico		O número da primeira linha. A numeração começa a partir de 1.
End column	Não	Valor de texto		O índice ou a letra da última coluna.
Y Axis Direction	N/A	Acima, Abaixo	Superior	A direção de desvio do eixo Y. Onde procurar no eixo vertical, com base na posição da célula atualmente ativa.
End row	Não	Valor numérico		O número da última linha. A numeração começa a partir de 1.
Desvio Y	Não	Valor numérico		O desvio do eixo Y.
Nome	Não	Valor de texto		O nome das células.
Coluna	Não	Valor de texto		O índice ou a letra da coluna.
Linha	Não	Valor numérico		O número da linha. A enumeração começa a partir do 1.

Variáveis produzidas

Esta ação não produz quaisquer variáveis.

Exceções

Exceção	Descrição
Falha ao limpar células	Indica que ocorreu um problema ao tentar limpar as células especificadas na instância do Excel.

Ordenar células numa folha de cálculo do Excel

Parâmetros de entrada

Argumento	Opcional	Aceita	Valor Predefinido	Descrição
Excel instance	Não	Instância do Excel		A instância do Excel com a qual pretende trabalhar. Esta variável tem de ter sido previamente especificada numa ação Iniciar Excel.
Coluna de ordenação em	N/A	Folha ativa, Tabela, Intervalo	Folha ativa	Especifique se a coluna a ordenar faz parte de uma tabela, de um intervalo especificado, quer por nome ou coordenadas absolutas, quer se faz parte da folha de cálculo ativa geral.
Nome da tabela	Não	Valor de texto		Nome da tabela.
Intervalo	N/A	Células nomeadas, Intervalo específico	Células nomeadas	Especifique o intervalo a ordenar, usando a célula nomeada ou o índice absoluto de coluna e linha.
Nome da célula	Não	Valor de texto		Nome que representa o intervalo.
Start column	Não	Valor de texto		O índice ou a letra da primeira coluna.
Start row	Não	Valor numérico		O número da primeira linha. A numeração começa a partir de 1.
End column	Não	Valor de texto		O índice ou a letra da última coluna.
End row	Não	Valor numérico		O número da última linha. A numeração começa a partir de 1.
Sort by	Sim	Regras de ordenação conforme definido pelo utilizador	N/A	Regras de ordenação a aplicar.
A primeira linha é o cabeçalho	Sim	Valor booleano		Indica que a primeira linha da folha de cálculo é um cabeçalho.

Variáveis produzidas

Esta ação não produz quaisquer variáveis.

Exceções

Exceção	Descrição
Falha ao ordenar células na folha de cálculo	Indica um problema ao ordenar células na folha de cálculo.

Filtrar células numa folha de cálculo do Excel

Filtrar células em folhas de cálculo do Excel permite que os criadores criem e apliquem um filtro na folha de cálculo, tabela ou intervalo ativo nos valores de uma coluna especificada. Para filtrar várias colunas numa folha/tabela/intervalo ativo, têm de ser utilizadas várias ações de Filtrar células em folhas de cálculo do Excel, cada uma aplicando o respetivo filtro.

Importante

Para aplicar vários filtros numa folha/tabela/intervalo ativo específico, certifique-se de que todas as ações Filtrar células em folhas de cálculo do Excel utilizadas visam a mesma origem (folha/tabela/intervalo ativo).

Quando utilizar Filtrar células em folhas de cálculo do Excel numa folha/intervalo ativo com filtros já existentes/aplicados:

• Se o intervalo alvo for igual ao aplicado nos filtros anteriores, todos os filtros são aplicados.
• Se o intervalo alvo não for igual ao intervalo aplicado nos filtros anteriores, os filtros anteriores são limpos e apenas o último filtro é aplicado.
• Se o intervalo alvo for uma tabela, todos os filtros são aplicados.

Parâmetros de entrada

Argumento	Opcional	Aceita	Valor Predefinido	Descrição
Excel instance	Não	Instância do Excel		A instância do Excel com a qual pretende trabalhar. Esta variável tem de ter sido previamente especificada numa ação Iniciar Excel.
Coluna de filtro em	N/A	Folha ativa, Tabela, Intervalo	Folha ativa	Especifique se a coluna a filtrar faz parte de uma tabela, de um intervalo especificado, quer por nome ou coordenadas absolutas, quer se faz parte da folha de cálculo ativa geral
Nome da tabela	Não	Valor de texto		Nome da tabela.
Intervalo	N/A	Células nomeadas, Intervalo específico	Células nomeadas	Especifique o intervalo a filtrar, usando a célula nomeada ou o índice absoluto de coluna/linha
Nome da célula	Não	Valor de texto		Nome que representa o intervalo
Start column	Não	Valor de texto		O índice ou a letra da primeira coluna.
Start row	Não	Valor numérico		O número da primeira linha. A numeração começa a partir de 1.
End column	Não	Valor de texto		O índice ou a letra da última coluna.
End row	Não	Valor numérico		O número da última linha. A numeração começa a partir de 1.
Coluna a filtrar	Não	Valor de texto		Nome ou índice da coluna a filtrar. Se a coluna fizer parte de uma tabela, use o nome do cabeçalho.
Filtros a aplicar	Sim	Regras de filtragem conforme definido pelo utilizador	N/A	Regras de filtragem aplicadas à coluna definida

Variáveis produzidas

Esta ação não produz quaisquer variáveis.

Exceções

Exceção	Descrição
Falha ao aplicar filtro nas células na folha de cálculo	Indica um problema ao aplicar o filtro especificado nas células da folha de cálculo

Limpar filtros numa folha de cálculo do Excel

Parâmetros de entrada

Argumento	Opcional	Aceita	Valor Predefinido	Descrição
Excel instance	Não	Instância do Excel		A instância do Excel com a qual pretende trabalhar. Esta variável tem de ter sido previamente especificada numa ação Iniciar Excel.
Limpar filtros em	N/A	Folha ativa, Tabela	Folha ativa	Especifique se pretende limpar os filtros da totalidade da folha de cálculo ativa ou de uma tabela específica.
Nome da tabela	Não	Valor de texto		Nome da tabela.
Limpar filtros da coluna específica	Sim	Valor booleano		Limpe os filtros da coluna específica.
Limpar filtro em coluna	Não	Valor de texto		O nome da coluna cujo filtro aplicado pretende limpar.

Variáveis produzidas

Esta ação não produz quaisquer variáveis.

Exceções

Exceção	Descrição
Falha ao limpar filtro nas células na folha de cálculo	Indica um problema ao aplicar o filtro especificado nas células da folha de cálculo

Obter célula vazia

Parâmetros de entrada

Argumento	Opcional	Aceita	Valor Predefinido	Descrição
Excel instance	Não	Instância do Excel		A instância do Excel com a qual pretende trabalhar. Esta variável tem de ter sido previamente especificada numa ação Iniciar 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 pretende procurar 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 da pesquisa	N/A	Por linha, Por coluna	Por linha	Especifique se pretende procurar por linhas ou colunas para localizar a primeira célula vazia existente num intervalo específico.
Procurar em	N/A	Células nomeadas, Intervalo específico	Células nomeadas	Procure uma célula vazia numa célula nomeada ou num intervalo definido pela coluna/linha de início e coluna/linha de fim.
Nome da célula	Não	Valor de texto		Nome que representa o intervalo.
Coluna	Não	Valor de texto		Coluna.
Linha	Não	Valor numérico		Linha.
Start column	Não	Valor de texto		O índice ou a letra da primeira coluna.
Start row	Não	Valor numérico		O número da primeira linha. A numeração começa a partir de 1.
End column	Não	Valor de texto		O índice ou a letra da última coluna.
End row	Não	Valor numérico		O número da última linha. A numeração começa a partir de 1.

Variáveis produzidas

Argumento	Tipo	Descrição
EmptyCellColumnIndex	Valor numérico	O índice da coluna em que a primeira célula vazia é encontrada.
EmptyCellRowIndex	Valor numérico	O índice da linha em que a primeira célula vazia é encontrada.
EmptyCells	Tabela de dados	A lista de células vazias encontradas.

Exceções

Exceção	Descrição
Falha ao obter células vazias	Indica um problema ao obter as células vazias da folha de cálculo.

Limitações conhecidas

Utilizar ficheiros Excel sincronizados através do OneDrive ou do SharePoint

A interação com ficheiros do Microsoft Excel contidos em pastas sincronizadas no OneDrive ou no SharePoint poderá resultar num fluxo erróneo. O Power Automate para computadores utiliza objetos COM para interações com o Excel. O OneDrive e o SharePoint não são totalmente compatíveis com instâncias do Excel lançadas através de COM.

Por este motivo, quando tenta abrir um ficheiro do Excel armazenado sob um diretório do OneDrive ou do SharePoint, poderá encontrar um erro de ficheiro não encontrado. Para resolver este problema, utilize uma das seguintes alternativas:

Alternativa 1

• Faça uma cópia local do respetivo ficheiro do Excel.
• Modifique a cópia local do ficheiro do Excel utilizando as ações de automatização do Excel do Power Automate para computadores.
• Substitua a cópia do ficheiro do Excel sincronizada através do OneDrive/Sharepoint com a cópia local que inclui as alterações mais recentes.

Alternativa 2

Nota

Esta solução pode ser utilizada em geral quando a ação Iniciar Excel falha a execução.

• Abra uma nova instância do Excel utilizando a ação Executar aplicação. Certifique-se de que fornece tempo de espera suficiente entre as ações, permitindo que o processo do Excel seja carregado por completo, incluindo quaisquer suplementos.
• Utilize a ação Anexar ao Excel para anexar ao novo processo.