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

• DisplayName - 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.
• Launch method - Determines whether an Excel process is launched via COM APIs or as full process. The default value is Same as project. The drop-down contains three options, as follows:
  • 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.
• Launch timeout - The time to wait for Excel to start in seconds, if launched as a full process. The default value is 20 seconds.
• 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.
  • HabilitarTodos - Todas as macros estão habilitadas e podem ser executadas.
  • DesabilitarTodos - Todas as macros estão desabilitadas no arquivo do Excel especificado. Não é possível executar nenhuma macro.
  • 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 em vez da criação de um novo. Pesquisa quaisquer processos do Excel abertos quando a primeira atividade Use Excel File for executada para verificar se o arquivo de entrada já está aberto e toma uma das seguintes decisões, nesta ordem:
    • Se 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 de Resolução de conflito de arquivos será usada para determinar o comportamento.
    • Caso contrário, um novo processo do Excel será criado.
  • Apenas se existir - Impõe a reutilização de uma instância específica do processo do Excel. Pesquisa quaisquer processos do Excel abertos, quando a primeira atividade Use Excel File é executada, para verificar se o arquivo de entrada já está aberto:
    • Se 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.