Excel Process Scope

UiPath.Excel.Activities.ExcelProcessScopeX

Abre ou reutiliza processos do Excel, carrega as configurações do projeto do Excel e as aplica ao arquivo do Excel associado. Esta atividade simplifica o gerenciamento de processos do Excel permitindo que você configure como um processo do Excel é iniciado e como os processos existentes são gerenciados.

Alguns dos casos de uso são:

• Habilita ou desabilita macros.
• Lida com resoluções de conflito entre arquivos do Excel.
• Permite o encerramento de processos Excel existentes para evitar conflitos.
• Gerencia modos de processo (seja para abrir um novo processo, reutilizar um existente ou solicitar ao usuário).

Recomendamos colocar uma atividade Use Excel File dentro de uma atividade Excel Process Scope para abrir documentos do Excel com determinadas configurações já aplicadas.

Propriedades

Comum

• NomeDeExibição - o nome de exibição da atividade.

Diversos

• Privado - Se selecionado, os valores de variáveis e argumentos não são mais registrados no nível Verbose.

Opções

• Exibir alertas – Se selecionado, o Excel pode exibir alertas e mensagens. O valor padrão é Igual ao do projeto. O menu suspenso contém as seguintes opções: Igual ao projeto, Falso e Verdadeiro.

• Ação de processos existentes – A ação a ser executada se outros processos do Excel estiverem em execução. O valor padrão é Igual ao do projeto. O menu suspenso contém as seguintes opções:

  • Igual ao projeto – Aplica as mesmas configurações que nas Configurações do projeto.
  • Nenhum - Nenhuma ação é tomada em relação aos processos existentes na máquina.
  • Forçar encerramento – Encerra todos os processos do Excel abertos sem qualquer tentativa de salvar o arquivo.

• Resolução de conflito de arquivos – A ação a ser executada se conflitos de arquivos do Excel forem detectados entre processos do Excel. Por exemplo, um arquivo do Excel já está aberto em outro processo do Excel. O valor padrão é Igual ao do projeto. O menu suspenso contém as seguintes opções:

  • Igual ao projeto – Aplica as mesmas configurações que nas Configurações do projeto.
  • Nenhum – Nenhuma ação é realizada.
  • Fechar sem salvar – Fecha todos os arquivos do Excel que estão em conflito e não salva as alterações pendentes.
  • Solicitar ao usuário – Mostra ao usuário um prompt que solicita que os arquivos sejam fechados.
  • Gerar exceção – Gera uma exceção que pode ser processada em uma atividade Try Catch ou fazer com que o fluxo de trabalho seja encerrado.

• Método de inicialização - determina se um processo do Excel é iniciado por meio de APIs COM ou como processo completo. O valor padrão é Igual ao projeto. A lista suspensa contém três opções, como a seguir:

  • Igual ao projeto – Aplica as mesmas configurações que nas Configurações do projeto.
  • Automação – O Excel é iniciado pelas APIs de automação. Isso é mais rápido, mas nem todos os complementos são carregados, então pode causar problemas se a pasta de trabalho depender de um suplemento para funcionar corretamente.
  • Aplicativo – O Excel é iniciado como se fosse aberto manualmente por um usuário, o que garante que todos os aspectos do Excel, como suplementos, sejam carregados.
• Tempo limite de inicialização - O tempo de espera para iniciar o Excel em segundos, se iniciado como um processo completo. O valor padrão é 20 segundos.

• Configurações de macro – Especifica o nível de macro do arquivo do Excel atual. O valor padrão é Igual ao do projeto. O menu suspenso contém as seguintes opções:

  • Igual ao projeto – Aplica as mesmas configurações que nas Configurações do projeto.
  • EnableAll - Todas as macros estão habilitadas e podem ser executadas.
  • DisableAll - Todas as macros são desativadas no arquivo Excel especificado. Nenhuma macro pode ser executada.
  • Usar configurações do Excel – Lê as configurações de macro atuais do Excel.

• Modo de processo – Determina como a atividade Excel Process Scope gerencia processos do Excel:

  • Igual ao projeto – Aplica as mesmas configurações das Configurações do projeto. Esse é o valor padrão.
  • Sempre criar novo – Sempre cria um novo processo do Excel para carregar todos os arquivos associados.
  • Attended user – Impõe que haja apenas um processo do Excel na máquina. Se encontrar mais de um processo do Excel, o usuário recebe um prompt.
  • Reutilizar se existir - Prioriza a reutilização de um processo existente do Excel sobre a criação de um novo. Pesquisa todos os processos do Excel abertos, quando a primeira atividade Use Excel File é executada, para verificar se o arquivo de entrada já está aberto e toma uma das seguintes decisões, nesta ordem:

    • Se ele encontrar um processo com o arquivo de entrada aberto, esse processo será associado à atividade Excel Process Scope .
    • Se ele encontrar um processo com outro arquivo aberto, a configuração Resolução de Conflito de Arquivos será usada para determinar o comportamento.
    • Caso contrário, um novo processo do Excel será criado.
  • Somente se existir - Impõe o reuso de uma instância específica de processo do Excel. Procura por qualquer processo do Excel aberto, quando a primeira atividade Use Excel File é executada, para verificar se o arquivo de entrada já está aberto:

    • Se ele encontrar um processo com o arquivo de entrada aberto, ele associará esse processo à atividade Excel Process Scope .
    • Caso contrário, uma exceção é gerada.

• Mostrar janela do Excel – Se selecionada, as janelas do Excel aparecerão durante a automação. O valor padrão é Igual ao do projeto. O menu suspenso contém as seguintes opções:

  • Igual ao projeto – Aplica as mesmas configurações que nas Configurações do projeto.
  • False – O projeto em segundo plano abre arquivos do Excel com as janelas ocultas.
  • True – O projeto abre arquivos do Excel com as janelas visíveis para o usuário.

Importante: para evitar erros, não use simultaneamente as seguintes propriedades com as opções especificadas: Ação de processos existentes com Forçar encerramento e Modo de processo com Somente se existir.