Excel Application Scope

UiPath.Excel.Activities.ExcelApplicationScope

Abre uma pasta de trabalho do Excel e fornece um escopo para atividades do Excel. Quando a execução desta atividade termina, a pasta de trabalho especificada e o aplicativo Excel são fechados. Se uma variável WorkbookApplication for fornecida no campo Saída > Propriedade da pasta de trabalho, a planilha não será fechada após o término da atividade. Se o arquivo especificado não existir, um novo arquivo do Excel será criado. Esta atividade só pode ser utilizada se o aplicativo Microsoft Excel estiver instalado em sua máquina.

Propriedades

Observação:

• Strings devem ser colocadas entre aspas.
• Ao usar o Office 365, a atividade abre arquivos do Excel em uma nova instância se o Escopo do aplicativo do Excel for executado antes de abrir manualmente os arquivos do Excel.

Comum

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

de transações

• Editar senha - A senha necessária para a edição de pastas de trabalho do Excel protegidas por senha, se necessário. Apenas strings e variáveis String são compatíveis.
• Senha - A senha necessária para a abertura de pastas de trabalho do Excel protegidas por senha, se necessário. Apenas strings e variáveis String são compatíveis.
• Caminho da pasta de trabalho - O caminho completo da planilha do Excel que você deseja usar. Se o arquivo do Excel a ser usado estiver localizado na pasta do projeto, seu caminho relativo pode ser usado. Apenas strings e variáveis String são compatíveis.

Diversos

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

Opções

• Criar se não existir - Quando estiver selecionado, se a pasta de trabalho não puder ser encontrada no caminho especificado, uma nova pasta de trabalho do Excel é criada com o nome especificado no campo da propriedade Caminho da pasta de trabalho. Quando estiver desmarcado, se a pasta de trabalho não puder ser encontrada no caminho especificado, uma exceção é lançada, informando ao usuário. Por padrão, essa caixa de seleção está marcada.

• PeríodoNoCacheDaInstância - Por quanto tempo se deseja manter o processo do Excel ativo após todas as atividades filho serem executadas. O valor padrão é de 3.000 ms. Quando a atividade é usada dentro de um loop (por exemplo, em uma atividade For Each ) ou quando várias atividades Excel Application Scope são usadas consecutivamente, isso evita erros que podem ser causados pelo processo do Excel se desligar ao abrir o próximo arquivo. Para desligar o Excel o mais rapidamente possível, defina o valor como 0.

  Observação: ao trabalhar com vários arquivos, deixar o UiPath para gerenciar o tempo de vida do processo do Excel cria a possibilidade dessa condição de corrida causar um erro. Para evitar isso, recomendamos criar uma atividade pai do Escopo do aplicativo do Excel, salvar a pasta de trabalho de saída como uma variável, colocar todas as outras atividades do escopo do aplicativo do Excel dentro desse pai e reutilizar a variável WorkbookApplication como entrada para a propriedade ExistingWorkbook em todas as atividades do escopo filho . Isso garante que o Excel permaneça em execução enquanto a automação estiver usando o Excel.

• MacroSetting - Especifica o nível de macro para o arquivo atual do Excel. Por padrão, EnableAll é selecionado. A lista suspensa contém três opções, como a seguir:

  • 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.
  • ReadFromExcelSettings - Lê as configurações atuais de Macro do Excel.
• SomenteLeitura — abre a pasta de trabalho especificada no modo Somente leitura. Marcar essa caixa de seleção habilita você a executar operações de extração de dados em um arquivo do Excel que está bloqueado para edição ou que tem senha para edição. Por padrão, essa caixa de seleção fica desmarcada.
• Salvar alterações - salva automaticamente a pasta de trabalho em cada alteração causada por uma atividade. Se desabilitado, as alterações não serão salvas quando a execução do Excel Application Scope terminar. Por predefinição, esta caixa de verificação está seleccionada.
• Start as Process - If true, Excel will open as a new process.
• Visível - Quando selecionado, o arquivo do Excel é aberto em primeiro plano durante a execução de ações nele. Quando é desmarcado, todas as operações são feitas em segundo plano.

Saída

• Pasta de trabalho - Todas as informações da planilha do Excel armazenadas em uma variável WorkbookApplication. Essa variável pode ser usada em outra atividade Excel Application Scope. Apenas variáveis WorkbookApplication são compatíveis.

Usar Pasta de Trabalho Existente

• PastaDeTrabalhoExistente - Use os dados de um arquivo do Excel que foi armazenado anteriormente em uma variável WorkbookApplication. Apenas variáveis WorkbookApplication são compatíveis.

Exemplo de como usar a atividade Excel Application Scope

Para exemplificar como usar esta atividade, criamos um projeto de automação que inclui uma atividade Excel Application Scope , entre outras atividades. Faça download do fluxo de trabalho aqui.