A atividade “Inserir linha ou coluna” tem como finalidade adicionar novas linhas e/ou colunas em uma planilha de um arquivo Excel já aberto, permitindo a reorganização da estrutura da planilha durante a execução de processos de automação RPA.
Essa atividade é utilizada, principalmente, quando há necessidade de inserir espaços para novos dados, ajustar layouts de planilhas existentes ou preparar a estrutura antes de etapas de escrita, cálculo ou formatação.
Para utilizar esta atividade, selecione “Inserir linha ou coluna”, arraste-a para dentro do fluxo do processo e clique sobre ela para iniciar a configuração dos parâmetros.
1. Diversos
1.1 DisplayName: Neste campo é possível configurar como será exibido o nome desta atividade dentro do processo de automação. O nome definido é apenas ilustrativo e não interfere na execução da atividade, sendo utilizado para facilitar a leitura, organização e manutenção do fluxo.
2. Entrada
2.1 Célula: Neste campo deve ser informada a célula de referência a partir da qual as linhas ou colunas serão inseridas. A célula deve seguir o padrão de referência do Excel, combinando letra(s) da coluna e número da linha. O campo é do tipo “String”.
Exemplos:
- A1
- B5
A inserção ocorrerá considerando a posição da célula informada, deslocando os dados existentes conforme o comportamento padrão do Excel.
2.2 Instância: Este campo define a instância do Excel que será utilizada pela atividade. Deve ser informada a mesma variável retornada pela atividade Abrir Excel, garantindo que a inserção de linhas ou colunas seja realizada no arquivo correto.
2.3 Número de Colunas: Neste campo deve ser informado o número de colunas que serão inseridas na planilha, a esquerda da célula de referência definida.
Exemplo:
- 1: Insere uma coluna
- 3: Insere três colunas
2.4 Número de Linhas: Neste campo deve ser informado o número de linhas que serão inseridas na planilha, acima da célula de referência definida.
Exemplo:
- 1: Insere uma linha
- 3: Insere três linhas
Observações importantes:
- O valor informado deve ser um número inteiro maior que zero.
- As linhas inseridas deslocarão as linhas existentes para baixo.
- Caso seja informado o valor 0, nenhuma linha será inserida.
2.5 Nome da planilha: Neste campo deve ser informado o nome da planilha onde a inserção de linhas ou colunas será realizada.
O nome informado deve corresponder exatamente ao nome exibido na aba da planilha no Excel, respeitando letras maiúsculas, minúsculas e espaços.
3. Saída
3.1 Resultado: Este campo define a variável de retorno da atividade. A variável recebe o resultado da operação de inserção de linhas e/ou colunas e pode ser utilizada para validações, controles de fluxo ou tratamento de exceções no processo.
