Excel Process Scope

UiPath.Excel.Activities.ExcelProcessScopeX

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

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 que você coloque uma atividade Use Excel File em 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 projeto. A lista suspensa contém três opções, a saber: Igual ao projeto, Falso, 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 projeto. A lista suspensa contém três opções, como a seguir:

  • Igual ao projeto — aplica as mesmas configurações das Configurações do projeto.
  • Nenhum - Nenhuma ação é tomada em relação aos processos existentes na máquina.
  • Force kill - Fecha todos os processos abertos do Excel sem fazer nenhuma tentativa de salvar o arquivo.

• Resolução de conflitos de arquivos - A ação a ser executada se forem detectados conflitos de arquivos do Excel entre os processos do Excel. Por exemplo, um arquivo do Excel já está aberto em outro processo do Excel. O valor padrão é Igual ao projeto. A lista suspensa contém cinco opções, como segue:

  • Igual ao projeto — aplica as mesmas configurações das Configurações do projeto.
  • Nenhum - nenhuma ação é executada.
  • Fechar sem salvar - Fecha todos os arquivos do Excel que estão em conflito, sem salvar as alterações pendentes.
  • Prompt user - Mostra ao usuário um prompt dizendo que os arquivos precisam ser fechados.
  • Throw Exception — gera uma exceção que pode ser tratada 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 das Configurações do projeto.
  • Automação - o Excel é iniciado pelas APIs de automação. Isso é mais rápido, mas nem todos os suplementos são carregados, portanto, pode causar problemas se a pasta de trabalho depender de um suplemento para funcionar corretamente.
  • Aplicativo - o Excel é iniciado como um usuário o abriu manualmente, garantindo que todos os aspectos do Excel sejam carregados, como suplementos.
• 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 para o arquivo atual do Excel. O valor padrão é Igual ao projeto. A lista suspensa contém quatro opções, como segue:

  • Igual ao projeto — aplica as mesmas configurações das 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 as configurações do Excel - Lê as configurações atuais da Macro do Excel.

• Modo de processo - determina como a atividade Escopo do processo do Excel gerencia os processos do Excel:

  • Igual ao projeto — aplica as mesmas configurações das Configurações do projeto. Esse é o valor padrão.
  • Sempre criar novo - Um novo processo do Excel é sempre criado para carregar todos os arquivos associados.
  • Usuário assistido - Impõe que haja apenas um processo Excel na máquina. Se mais de um processo do Excel for encontrado, o usuário será solicitado.
  • Reutilizar se existir — procura por qualquer processo do Excel aberto quando a primeira atividade Use Excel File é executada para verificar se um arquivo já está aberto. Se um arquivo aberto for encontrado, esse processo será associado ao Excel Process Scope. Caso outro arquivo aberto seja encontrado, a configuração Resolução de conflito de arquivos será aplicada.
  • Somente se existir - Procura por qualquer processo do Excel aberto quando a primeira atividade Use Excel File é executada para verificar se um arquivo já está aberto. Se um arquivo aberto for encontrado, esse processo será associado ao Excel Process Scope. Se nenhum arquivo aberto for encontrado, uma exceção é gerada.

• Mostrar janela do Excel - Se selecionado, as janelas do Excel aparecem durante a automação. 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 das Configurações do projeto.
  • Falso - Os arquivos do Excel são abertos pelo projeto em segundo plano, com suas janelas ocultas.
  • Verdadeiro - Os arquivos do Excel são abertos pelo projeto com suas janelas visíveis para o usuário.