Configurações do projeto

As configurações do projeto Excel Modern permitem configurar várias propriedades que são comuns às atividades do Excel projetadas para o StudioX globalmente para o seu projeto atual.

Observação: nas versões anteriores à v2.11.0 do pacote de atividades do Excel, a categoria de configurações era denominada Excel Business.

Para definir as configurações do projeto Excel Modern:

1. Selecione Projeto > Configurações do projeto.
2. Em Configurações de atividades, selecione a guia Excel moderno .

3. As configurações são divididas em diferentes categorias. Todas as configurações, exceto Excel Design Experience, têm um valor Run e um valor Debug. Expanda as categorias para atualizar as configurações desejadas.

   Você pode redefinir todas as configurações para seus valores padrão ou copiar todos os valores entre os campos de depuração e produção utilizando o menu suspenso Ação em Massa na parte superior da janela.

Excel Moderno

Experiência de Criação do Excel

Introduzido na v2.11.0 do pacote de atividades do Excel, essa configuração determina a experiência de design do Excel no perfil do Studio em versões do UiPath Studio a partir da 2021.10. A experiência de design moderna é sempre usada no perfil do StudioX.

Nome da Propriedade	Descrição da Propriedade	Configuração padrão
Experiência de Criação do Excel	UseGlobalSetting - Deixe a configuração do projeto Modern Design Experience determinar se a experiência Clássica ou Moderna está habilitada. UseClassic - Use as atividades clássicas da categoria que não suportam a interação com o Excel do menu Plus oculte as atividades modernas por padrão. UseModern - Use as atividades modernas que suportam a interação com o Excel do Plus menu, oculte as atividades clássicas por padrão.	UseGlobalSetting

Iniciar o Excel

Essas configurações determinam como o Excel é iniciado em tempo de execução.

Nome da Propriedade	Descrição da Propriedade	Configuração padrão
Método de inicialização	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.	Aplicativo
Tempo de espera para iniciar o Excel (em segundos)	Quantos segundos esperar que o Excel abra o arquivo antes de gerar um erro.	20

Visibilidade do Excel

Essas configurações determinam se as janelas do Excel são visíveis durante a automação.

Nome da Propriedade	Descrição da Propriedade	Configuração padrão
Mostrar janela do Excel	Verdadeiro - Os arquivos do Excel são abertos pelo projeto com suas janelas visíveis para o usuário. Falso - Os arquivos do Excel são abertos pelo projeto em segundo plano, com suas janelas ocultas. Observação: se um arquivo do Excel já estiver aberto, essa propriedade será ignorada e a configuração de visibilidade da instância do Excel já aberta será usada (geralmente visível).	True
Mostrar alertas do Excel	Verdadeiro - os alertas do Excel são exibidos para o usuário durante a automação. Falso - os alertas do Excel ficam ocultos durante a automação. Observação: essa opção não pode ser definida como True quando a opção Mostrar janela do Excel estiver definida como False.	Falso

Excel Process Scope

Essas configurações determinam como os processos e conflitos do Excel são tratados em diferentes cenários e se as macros são habilitadas ou desabilitadas para o arquivo do Excel especificado.

Nome da Propriedade	Descrição da Propriedade	Configuração padrão
Modo de processo	AlwaysCreateNew - Um novo processo do Excel sempre é criado para carregar todos os arquivos associados. AttendedUser - Impõe que haja apenas um processo do Excel na máquina. Se mais de um processo do Excel for encontrado, o usuário será solicitado. ReuseIfExists - 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. ApenasSeExistir - Procura por qualquer processo do Excel aberto quando a primeira atividade Use Excel File é executada para verificar se já existe um arquivo 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.	Reutilizar se existir
Ação de processos existentes	Nenhum - Nenhuma ação é tomada em relação aos processos existentes na máquina. ForceKill - Fecha todos os processos abertos do Excel sem fazer nenhuma tentativa de salvar o arquivo.	Nenhum
Resolução de conflito de arquivos	Nenhum - Nenhuma ação é executada quando arquivos conflitantes são encontrados. CloseWithoutSaving - Fecha todos os arquivos do Excel que estão em conflito, sem salvar as alterações pendentes. PromptUser - Mostra ao usuário um prompt informando que os arquivos precisam ser fechados. ThrowException — gera uma exceção que pode ser tratada em uma atividade Try Catch ou fazer com que o fluxo de trabalho seja encerrado.	ThrowException
Configurações de macro	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.	EnableAll

Use Excel File

Essas configurações determinam qual formatação deve ser aplicada aos valores lidos do Excel ao usar a atividade Use Excel File.

Nome da Propriedade	Descrição da Propriedade	Configuração padrão
Ler Formatação	Padrão - Use a formatação padrão retornada pelo Excel. RawValue - Use os valores brutos e ignore toda a formatação. ValorDeExibição - Recupere os valores conforme exibidos no Excel.	Padrão

Observação: Essas definições podem ser configuradas individualmente para cada atividade Use Excel File alterando a propriedade Ler formatação no Painel de propriedades.

Visualização do Excel

Essas configurações determinam como o Excel é acessado em tempo de design, ao usar o Plus cardápio.

Nome da propriedade	Descrição da Propriedade	Configuração padrão
Tipo de visualização do Excel	Padrão - Deixe o StudioX decidir o tipo de visualização a ser usado. UseXmlFile - Analisa o conteúdo do arquivo Excel. Isso é limitado a apenas .xlsx arquivos que não dependem de suplementos para carregar. UseExcelInstance - Usa o Excel para ler o conteúdo do arquivo. Isso permite visualizar qualquer arquivo que possa ser aberto pelo Excel. As visualizações são mais rápidas se o arquivo já estiver aberto no Excel.	Padrão

Observação: para usar o tipo de visualização UseExcelInstance com o método de inicialização do aplicativo , o arquivo já deve estar aberto no Excel.