Partilhar via

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:

Captura de ecrã da ação Ler a partir de uma folha de cálculo do Excel.

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

Captura de ecrã de uma tabela de dados apresentada no visualizador de valores.

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:

Captura de ecrã da ação Escrever numa folha de cálculo do Excel.

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.

Captura de ecrã de dados do Excel escritos.

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.

Caso com Ler a partir da folha de cálculo do Excel

Quando a opção Obter conteúdos das células como texto estiver ativada na ação Ler a partir da folha de cálculo do Excel, os dados são obtidos exatamente como aparecem na folha de cálculo do Excel. Isto significa que, se a largura da coluna for muito estreita e os dados forem apresentados como ### no Excel, estes símbolos também aparecerão no resultado.

Solução:

Para evitar isto, use a ação Redimensionar colunas/linhas. Se a opção Obter conteúdos das células como texto não for usada, os dados obtidos serão os valores de célula sem processamento, independentemente de como são apresentados ou formatados na folha de cálculo. Isto significa que não há necessidade de usar a ação Redimensionar colunas/linhas. Para valores de data, a hora será anexada porque o tipo de dados de data inclui a hora.

  • Last updated on