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

We recommend placing a Use Excel File activity inside an Excel Process Scope activity to open Excel documents with certain settings already applied.

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.