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 – Pesquisa quaisquer processos do Excel abertos quando você executar pela primeira vez a atividade Use Excel File para verificar se um arquivo já está aberto. Se encontrar um arquivo aberto, ele associará esse processo ao Excel Process Scope. Caso ele encontre outro arquivo aberto, a configuração de Resolução de conflito de arquivos será aplicada.
  • Apenas se existir – Pesquisa quaisquer processos do Excel abertos quando você executa pela primeira vez a atividade Use Excel File para verificar se um arquivo já está aberto. Se encontrar um arquivo aberto, ele associará esse processo ao Excel Process Scope. Se não encontrar nenhum arquivo aberto, será gerada uma exceção.

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

Observação: 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.