Sobre projetos de automação

O Studio permite que você crie os seguintes tipos de projetos:

• Processo - Crie um processo de automação e publique-o para que possa ser executado por robôs.
• Biblioteca — crie fluxos de trabalho como componentes reutilizáveis e publique o projeto como uma biblioteca que pode ser adicionada como uma dependência a vários processos. Para obter mais informações, consulte Sobre bibliotecas.
• Automação de teste - Crie um projeto de automação de teste. Para obter mais informações sobre a automação de teste, consulte a seção Test Suite .
• Modelo - Crie um processo e publique-o como um modelo no qual outros processos que compartilham características comuns podem se basear. Para mais informações, acesse Modelos de Projeto.

Para criar um novo projeto em branco, acesse Início (Exibição de Backstage do Studio) > Iniciar e selecione o tipo de projeto a ser criado em Novo Projeto. Alternativamente, você pode iniciar a partir de um dos modelos padrão disponíveis em Novo do Modelo, ou acessar a guia Modelos para procurar mais modelos de diversas fontes.

Na janela do novo projeto, configure o seguinte para cada projeto:

• Insira um nome para o novo projeto (até 128 caracteres) e uma descrição que resuma o que você está planejando fazer com esse projeto de automação (até 500 caracteres).
• Selecione o local em que deseja criar o projeto. O local padrão em que os projetos são criados é %USERPROFILE%\Documents\UiPath.

• Selecione a compatibilidade e o idioma.

  Observação: a compatibilidade e a linguagem não podem ser alteradas após a criação de um projeto. No entanto, você pode converter seus projetos Windows - Legado para a compatibilidade com o Windows.

Por padrão, a pasta do projeto inclui os seguintes arquivos e subpastas:

• Arquivos

  • Main.xaml — criado por padrão para reter seu fluxo de trabalho principal. Além disso, todos os outros arquivos XAML de automação que você adicionar ao projeto serão armazenados na pasta do projeto. Opcionalmente, você pode definir um arquivo diferente como o principal. Todos os arquivos devem ser vinculados, por meio da atividade Invoke Workflow File, ao arquivo definido como principal ou a um arquivo marcado como um ponto de entrada para o projeto. Para projetos de automação de teste, um arquivo TestCase.xaml é criado por padrão, em vez de Main.xaml.
    Observação:

    • Você não pode executar projetos do Windows que contenham um arquivo XAML chamado Init.xaml.
    • Um arquivo XAML colocado na pasta raiz de um projeto não pode ter o mesmo nome de uma subpasta que contém outros arquivos XAML.
  • project.json — Contém informações sobre seu projeto de automação.

• Subpastas

  • .entities — Contém dados sobre entidades importadas do Data Service, caso alguma seja usada no projeto.
  • .local — Contém dados em cache local para o projeto.
    Observação:

    • A pasta .local está oculta. Você pode habilitar a visualização de itens ocultos a partir das configurações do Explorador de Arquivos do Windows.
    • A pasta .local não deve ser compartilhada entre projetos.
  • .objects — Contém dados relacionados a itens adicionados ao Repositório de Objetos, caso algum seja usado no projeto.
  • .project - Contém tags adicionadas ao projeto.
  • .screenshots — Contém capturas de tela informativas geradas nas atividades de automação de interface gráfica, caso alguma seja usada no projeto.
  • .settings — Contém configurações de atividades do projeto usadas no tempo de execução.
  • .templates - Contém modelos de arquivos adicionados ao projeto.
  • .tmh — Contém dados relacionados a casos de teste, caso algum seja usado no projeto.
    Observação: projetos criados com versões mais recentes do Studio podem não funcionar com versões mais antigas do Studio.Leia mais sobre compatibilidade com versões anteriores e futuras.
    Você não pode usar os seguintes caracteres em nomes de arquivo:", <, >, |, :, *, ?, \, /,; Esses caracteres vêm de restrições do Microsoft Windows e de outras restrições de caracteres especiais.

Importante: a execução de processos do Studio no Automation Cloud™ Robots – VM e Automation Cloud™ Robots – Serverless não se destina a fins de desenvolvimento.

Definindo a compatibilidade do projeto

Quando você cria um novo projeto, selecione a compatibilidade com base no ambiente no qual o projeto será executado:

• Windows - Usa o .NET 8 com compatibilidade com o Windows.Esse é o valor padrão.
• Multiplataforma - Usa o .NET 8 com compatibilidade multiplataforma.

• Windows -Legado -usa o .NET Framework 4.6.1. a compatibilidade usada em versões anteriores à 2021.10.

  Importante:

  • Os processos do Windows e multiplataforma exigem o Orchestrator 2021.10 e mais novos para serem executados.
  • A opção Windows - Legado não está mais disponível para novos projetos. Recomendamos selecionar Windows ou Multiplataforma ao criar um novo projeto. Você pode converter seus projetos do Windows - Legado na compatibilidade com o Windows ou usar políticas de governança para restaurar a opção de criar projetos do Windows - Legado.

Para entender melhor as diferenças entre compatibilidades, consulte a tabela a seguir. Para saber mais sobre a experiência de projetar em cada compatibilidade, consulte Projetando automações.

	Windows - Legacy	Windows	Multiplataforma
Execução de processos	32 bits	64 bits	64 bits
Plataformas suportadas para execução	Windows (64 bits)	Windows (64 bits)	Windows, Linux e macOS (64 bits)
Os processos são compilados quando publicados	No. Pacotes publicados contêm os arquivos de origem do projeto.	Sim. Os pacotes publicados contêm arquivos de DLL compilados.	Sim. Os pacotes publicados contêm arquivos de DLL compilados.

Apenas os pacotes de atividades que suportam a compatibilidade selecionada podem ser instalados a partir do gerenciador de pacotes.

A compatibilidade de cada projeto é exibida no lado direito da barra de status do Studio e no painel Projeto > nó de Dependências. A compatibilidade também é exibida na entrada de cada projeto na lista Abrir Recente em Início (Exibição Backstage do Studio) > aba Iniciar.

Observação:

• Não há suporte para copiar e colar atividades entre projetos com diferentes compatibilidades.
• Se o Studio encontrar erros de validação ao reabrir ou recarregar um projeto do Windows ou multiplataforma, você será solicitado a importar automaticamente referências ausentes.

Criando projetos multiplataforma

Os projetos multiplataforma permitem que você crie automações que não exigem interação do usuário e automações de navegadores web usando o Chrome. As automações multiplataforma podem ser executadas em sistemas operacionais Windows e similares ao Unix, como Linux e macOS.

Para criar projetos não assistidos com suporte multiplataforma:

1. No Studio, crie um novo projeto e selecione a opção de compatibilidade Multiplataforma. Essa opção está disponível para todos os tipos de projeto. Para processos que utilizam a linguagem VB para expressões, você tem a opção de trabalhar tanto no Studio quanto no Studio Web.

2. Crie a automação. Observe que nem todos os pacotes de atividades são compatíveis com projetos multiplataforma e, portanto, apenas uma seleção de pacotes está disponível no gerenciador de pacotes. Saiba mais sobre a experiência de design em projetos multiplataforma.

   As dependências padrão para um projeto multiplataforma são:

   • No perfil do Studio: UiPath.System.Activities, UiPath.Testing.Activities, UiPath.WebApi.Activities e UiPath.UIAutomation.Activities.
   • No perfil do StudioX: UiPath.System.Activities, Microsoft Office 365, Google Workspace e UiPath.UIAutomation.Activities.
3. Teste a automação. Recomendamos testar automações nas máquinas onde elas serão executadas usando a depuração remota , que funciona com Windows, robôs Linuxe robôs macOS.

4. Após testar a automação, publique o projeto no Orchestrator. O procedimento para executar trabalhos unattended é o mesmo para o Windows, macOS e Linux.

   Importante: esta versão do Studio não é compatível com versões de pacote de pacote de atividades multiplataforma mais antigas que estavam disponíveis no Studio 2022.4 ou anteriores.Se você criou projetos multiplataforma em versões do Studio anteriores à 2022.10, antes de editá-los no Studio 2022.10 ou posterior, atualize os pacotes instalados para as versões mais recentes. Algumas propriedades podem não estar mais disponíveis para edição.

Abrindo um projeto no Studio Web

Observação: a abertura de projetos no Studio Web é compatível apenas com as versões mais recentes das edições Enterprise e Community do Studio.

Se você quiser projetar seus projetos multiplataforma em qualquer dispositivo, diretamente do seu navegador, você pode adicionar projetos à nuvem e editá-los no Studio Web, o designer de automação no Automation Cloud™. Quando você adiciona um projeto à nuvem, as alterações são sempre sincronizadas, permitindo que você mude perfeitamente entre a área de trabalho e a web e continue de onde você saiu.

Observação:

• Projetos multiplataforma que usam a linguagem C# para expressões, bem como projetos do Windows, independentemente da linguagem (VB ou C#) não são compatíveis com o Studio Web. Você pode salvar projetos multiplataforma no C# ou projetos do Windows na nuvem, mas você não poderá editá-los no Studio Web.
• Os projetos que contêm fluxos de trabalho do fluxograma não podem ser abertos no Studio Web.

Gerenciando um projeto no Studio

Para ser compatível com o Studio Web, um projeto multiplataforma deve atender aos seguintes requisitos:

• O tipo de projeto é processo.
• A linguagem para expressões é VB.

Para salvar um projeto local na nuvem, selecione Salvar na faixa de opções do Studio e, em seguida, Salvar na nuvem. Depois que um projeto ser salvo no Studio Web, o rótulo na barra de status muda para Cloud Project. Clique no rótulo para abrir um menu suspenso com opções que permitem que você gerencie o projeto:

• Abrir no Studio Web - Abra o projeto no Studio Web. Se o projeto for bloqueado pelo Studio Web, um erro será exibido e o projeto será aberto em uma nova guia no modo somente leitura.

• Sincronizar com a nuvem - Obtenha as alterações mais recentes que você fez no Studio Web. Se houver diferenças entre o projeto remoto e o projeto local, você deve primeiro confirmar se deseja substituir a versão local.

Outras opções podem ser encontradas em Salvar na faixa de opções do Studio:

• Salvar como - Salvar o arquivo de fluxo de trabalho atual.
• Salvar todas - Salvar todas as alterações feitas no projeto.
• Sincronizar com a nuvem - Salve as alterações mais recentes feitas no Studio Desktop no projeto do Studio Web. Se o projeto remoto tiver alterações, você deve primeiro confirmar se deseja substituí-las. Você não pode sincronizar com a nuvem se o projeto estiver bloqueado pelo Studio Web.
  Observação: um erro Salvar na nuvem falhou aparece ao tentar usar a opção Abrir no Studio Web em um projeto que já está aberto no Studio Web.
• Salvar uma cópia - Salve o projeto atual localmente como um novo projeto. Você pode editar o nome, selecionar onde salvar e inserir uma descrição do projeto.

Você pode visualizar todos os arquivos e pastas de projeto no Explorador de projetos no Studio Web, mas você pode editar apenas fluxos de trabalho da sequência de tipos.

De forma similar, quando você cria um projeto no Studio Web, você tem a opção de continuar a trabalhar no Studio. Na página Projetos no Studio Web, abra o menu no lado direito de um projeto e, então, selecione Abrir no Studio Desktop.

Como as alterações são sincronizadas entre o Studio e o Studio Web

Quando você salva e fecha um projeto na nuvem no Studio, as alterações também são salvas no projeto remoto se o projeto não estiver bloqueado pelo Studio Web. Quando você abrir o projeto no Studio Web, o projeto será atualizado com todas as alterações que você salvou na nuvem no Studio.

Quando você abre um projeto na nuvem no Studio, o projeto é atualizado com todas as alterações que você fez no Studio Web. Para atualizar um projeto que já esteja aberto no Studio com as últimas alterações do Studio Web, selecione Projeto na nuvem > Obter versão mais recente na barra de status do Studio.

Em ambos os casos, se houver diferenças entre o projeto local e o projeto remoto, será solicitado que você confirme antes de prosseguir.

Observação: fazer alterações significativas em um projeto no Studio Web pode torná-lo incompatível com o Studio e vice-versa.

Conversão de um projeto multiplataforma para Windows

A conversão de um projeto multiplataforma para a compatibilidade com o Windows permite se beneficiar das atividades disponíveis apenas em projetos do Windows (por exemplo, atividades de Automação de Interface Gráfica de área de trabalho, Excel ou Form), facilitando o aprimoramento de um projeto do Studio Web com automação de área de trabalho no Studio. Para converter um projeto multiplataforma para Windows, há as seguintes opções:

• No Studio, clique com o botão direito no projeto no painel Projeto e selecione Converter para Windows no menu. No StudioX, selecione Projeto > Converter para Windows na faixa de opções na parte superior da janela do StudioX.
• Adicione uma atividade disponível apenas em projetos do Windows ao seu projeto. A categoria do painel de atividades do Windows lista atividades instaláveis que estão disponíveis apenas em projetos do Windows. Ao adicionar uma atividade desse tipo ao seu projeto no painel de atividades ou na barra de pesquisa Adicionar atividade, você será solicitado a converter o projeto para Windows.

Em ambos os casos, uma nova janela é exibida, na qual é possível:

• Selecione Criar um novo projeto para criar uma cópia do projeto atual usando a compatibilidade do Windows e manter o projeto multiplataforma original.
• Desmarque a caixa de seleção Criar um novo projeto para atualizar o projeto existente e converta-o para a compatibilidade do Windows (esta ação não pode ser desfeita).

Definição do Idioma do Projeto

Ao criar um novo projeto no perfil do Studio, você pode selecionar qual linguagem será usada para expressões, VB ou C#. VB é a linguagem selecionada por padrão, mas você pode definir C# como a linguagem padrão para novos projetos acessando Início (Exibição Backstage do Studio) > Configurações > Design. Os projetos criados no perfil do StudioX usam a linguagem VB.NET para expressões.

O uso de expressões em VB e C# no mesmo projeto não é suportado. Também não é suportado o uso de expressões VB nos fluxos de trabalho C# e vice-versa. Quando você copiar e colar atividades de outros projetos, invocar ou importar fluxos de trabalho, certifique-se de que elas usam a mesma linguagem que o seu projeto.

Você pode instalar bibliotecas C# como dependências nos projetos VB e vice-versa. No entanto, os valores padrão definidos para argumentos no projeto da biblioteca usando expressões específicas de linguagem não podem ser acessados a partir do projeto em que a biblioteca está instalada.

Limitações da Linguagem C#

Observação: essas limitações se aplicam apenas a projetos Windows - Legado, que não estão disponíveis por padrão nesta versão.

• A implementação C# atual é baseada no compilador C# que usa a versão 5 do C#, portanto, o acesso a recursos mais recentes, como atribuição de coalescência, operador condicional nulo, operador de coalescência nula, interpolação de string e outros, é limitado.
• Projetos que contenham expressões com incrementos são inválidos.
• Expressões que contenham o operador nameof() são marcadas como inválidas e não são permitidas com a implementação atual do C#.
• Expressões que contenham chamadas a métodos com argumentos opcionais devem incluir valores para os argumentos opcionais.
• O desempenho do tempo de design e do tempo de execução dos projetos em C# é menor quando comparado à VB.NET. Quando o desempenho do tempo de execução é essencial, recomendamos usar VB.NET em vez de C#.
• Cada execução de um projeto do Windows - Legado com C# cria um arquivo DLL compilado na pasta %appdata%\Temp que não é excluído automaticamente após a execução do projeto. Se o armazenamento for uma preocupações, você pode:
  • Use projetos do Windows ou multiplataforma com C#.
  • Use projetos do Windows - Legado com VB.
  • Exclua manualmente os arquivos desnecessários após a execução.

Configurando a Versão do Projeto

Controle de versão semântico

O esquema de versionamento semântico tem o formato Major.Minor.Patch[-Suffix], onde:

• Major é a versão principal.
• Minor é versão secundária.
• Patch é a versão de patch.
• -Suffix (opcional) é um hífen seguido de uma série de identificadores separados por ponto imediatamente após a versão da correção. Isso indica uma versão de pré-lançamento.

Os identificadores devem incluir somente caracteres alfanuméricos e hífens do ASCII e não devem estar vazios. Os identificadores numéricos não devem incluir os zeros à esquerda. Além disso, os metadados da compilação podem ser indicados anexando-se um sinal de mais e uma série identificadores separados por pontos, logo após o patch ou a versão de pré-lançamento como, por exemplo, 1.0.0-alfa+1.

Ao criar um processo ou biblioteca, o esquema da versão padrão será semântico. Ele pode ser alterado na janela Publicar, bastando adicionar um dígito extra ao número da versão. Também é possível modificar a versão semântica do projeto a partir do arquivo project.json. O patch de número 0 é automaticamente adicionado aos projetos com número de versão major.minor.

Controle de Versão Legada

O número da versão legada, gerado para o projeto tem o formato M.m.bbbb.rrrrr, onde:

• M é a versão principal.
• m é a versão secundária.
• bbbb é a versão da compilação.
• rrrrr é a versão de revisão.

As versões principais e secundárias também podem ser editadas no arquivo project.json, enquanto as versões de compilação e revisão são geradas de acordo com um algoritmo. O valor de compilação é o número de dias decorridos desde 01.01.2000. O valor da revisão é o número de segundos decorridos do dia atual até o momento do lançamento. O resultado é dividido por 2, para que o número máximo de revisão não exceda 653555.

O número da versão, sugerido na janela Publicar é gerado com base no esquema anterior de controle de versões, ao passo que a data atual e o carimbo de data/hora são considerados para projetos que utilizam o esquema de controle de versão de quatro dígitos.

Gerenciando projetos

O painel Projeto permite que você visualize e filtre o conteúdo do projeto atual, adicione pastas, abra o local do arquivo, gerencie dependências e ajuste as configurações do projeto.

Copie e cole os arquivos do Explorador de Arquivos diretamente no painel Projeto. O mesmo pode ser feito com o recurso arrastar e soltar em um ou vários arquivos, incluindo os fluxos de trabalho .xaml. Você também pode usar os atalhos Ctrl + C e Ctrl + V ou as opções Copiar e Colar no menu de contexto para copiar e duplicar arquivos ou pastas dentro do painel.

Você pode clicar duas vezes em TXT, CS, VB, JSON (excluindo o arquivo project.json) e arquivos XML menores que 10 MB para editá-los dentro do Studio em um editor de texto com destaque para a sintaxe.

Opção	Description
Expandir Tudo	Expande todos os nós no projeto de automação.
Recolher Tudo	Fecha todos os nós no projeto de automação.
Atualizar	Atualiza o projeto.
Sincronizar com documento ativo	Foca em um elemento do projeto que esteja ativo no painel do Designer.
Mostrar Todos os Arquivos	Mostra todos os arquivos que pertencem ao projeto de automação, incluindo o project.json.
Explorador de Arquivos	Abre o local do projeto na máquina.
Configurações do projeto	Abre a janela Configurações do Projeto para processos ou bibliotecas.
Filtrar por tipo de arquivo	Filtra os arquivos do projeto atual que podem ser editados no Studio por tipo de arquivo: fluxos de trabalho, casos de teste, formulários, código, texto, objetos (desabilitado por padrão), Mostrar pastas ocultas (desabilitado por padrão). Para visualizar todos os arquivos na pasta do projeto, selecione Outro (desabilitado por padrão).

Menu de contexto para Projetos

Para abrir o menu de contexto com as opções descritas na tabela a seguir, clique com o botão direito do mouse em qualquer lugar do painel Projeto. Dependendo do lugar onde você clicar no painel, um outro subconjunto de opções é disponibilizado: o tipo de projeto e se ele foi adicionado ao controle de origem.

Opção	Description
Abrir Pasta do Projeto	Abre a pasta local que contém o projeto.
Configurações do projeto	Abre a janela Configurações do Projeto para ajustar preferências do projeto.
Adicionar	Abre uma lista de itens que podem ser adicionados ao projeto: pasta, arquivo, sequência, fluxograma, máquina de estado, formulário, fluxo de trabalho, gerenciador global ou, em projetos de automação de teste, caso de teste. Use o fluxo de trabalho para criar um arquivo de fluxo de trabalho baseado em modelos integrados (sequência, fluxograma, máquina de estado) ou modelos de arquivos locais.
Importar Arquivos	Abre a janela do File Explorer para importar arquivos para seu projeto. Por padrão, o filtro *.xaml é aplicado para listar apenas arquivos de fluxo de trabalho, mas você pode alterá-lo para todos os arquivos para importar outros tipos de arquivos. Importado é adicionado ao nome de arquivo importado se coincidir com o nome de um fluxo de trabalho do projeto atual. Você só pode importar arquivos de fluxo de trabalho que usem a mesmo linguagem para expressões que o projeto atual. Quando você importa um arquivo de fluxo de trabalho, as dependências do projeto atual são comparadas às do arquivo do projeto de origem, se houver algum disponível. Se houver alguma discrepância, a janela Importar fluxo de trabalho é exibida com informações sobre as alterações necessárias para evitar atividades não resolvidas. As atualizações de dependência disponíveis são selecionadas por padrão e são instaladas quando você seleciona Importar. O ícone indica uma dependência ausente que deve ser instalada. O ícone indica uma versão mais recente usada no projeto de origem para a qual você deve atualizar. O ícone é exibido se uma dependência ausente não estiver disponível para o projeto atual ou se a versão disponível for diferente da do projeto de origem. Ou então, você pode indicar um arquivo project.json para usar como referência e selecionar se será pesquisado ou não em versões de pacotes de pré-lançamento.
Converter para Windows	No Windows - projetos legados e multiplataforma, abre a janela Converter para Windows, onde você pode converter o projeto para a compatibilidade com Windows.
Adicionar ao Controle de Origem	Adiciona o projeto atual para fins de controle de origem, usando as opções Git Init, Copiar para o Git, Adicionar ao TFS ou Adicionar ao SVN. Observe que essa opção somente fica visível ao se clicar com o botão direito no nó do projeto. Quando um projeto é adicionado ao controle de origem, opções adicionais ficam disponíveis no menu de contexto. Consulte as opções para o GIT e as opções para SVN e TFS.
Abrir	Abre os arquivos selecionados com o programa padrão.
Abrir Local do Arquivo	Abre a pasta local que contém o arquivo.
Renomear	Permite renomear o arquivo ou pasta selecionado, abrindo a janela Renomear Item. O item é renomeado em todas as ocorrências. Observação: o caminho completo do novo arquivo não deve exceder 258 caracteres.
Copiar	Copia os arquivos ou pastas selecionados para a área de transferência. Você pode colá-los no painel do projeto ou no explorador de arquivos do Windows.
Colar	Cola arquivos ou pastas que foram copiados para a área de transferência.
Excluir	Exclui o item selecionado somente da máquina local.
Selecionar para Comparar	Seleciona o arquivo atual para fins de comparação.
Comparar com Selecionado	Compara o arquivo atual com aquele selecionado anteriormente com o recurso Comparar Arquivos.
Encontrar Referências	Encontra todas as referências ao arquivo no projeto. Os resultados serão exibidos no painel Encontrar Referências .
Abrir no editor de texto	Abre o arquivo de texto selecionado em um editor de texto dentro do Studio no modo somente leitura. Para abrir um arquivo de texto no modo de edição, clique duas vezes nele. Você pode clicar duas vezes em arquivos TXT, CS, VB, JSON (exceto o arquivo project.json) e XML menores que 10 MB para editá-los dentro do Studio em um editor de texto com destaque para a sintaxe.
Depurar Arquivo	Depura o arquivo .xaml selecionado.
Definir como Principal	Define o arquivo .xaml selecionado como Principal na definição do projeto, o que significa que a execução do projeto é iniciada por esse arquivo. Somente pode haver um único arquivo de projeto Principal. O nome do arquivo definido como principal aparece em negrito no painel Projeto.
Layout da atividade	Abra a janela Propriedades para arquivos em projetos de biblioteca, onde você pode personalizar o design da atividade gerada.
Definir como Manipulador Global	Define o arquivo .xaml como o Gerenciador de Exceção Global do projeto. Isto se aplica a um fluxo de trabalho por projeto/processo.
Remover Manipulador	Remove a tag de Gerenciador de Exceção Global do arquivo .xaml.
Ativar Ponto de Entrada	Marca o arquivo de fluxo de trabalho selecionado como um entry point do processo, tornando possível selecioná-lo como o fluxo de trabalho a ser executado primeiro usando as atividades Invoke Process e Run Parallel Process ou ao iniciar um trabalho no Orchestrator. Observação: Quando um arquivo é marcado como entry point, uma seta é exibida no ícone ao lado do nome do arquivo . Habilitar um arquivo que foi ignorado da publicação como ponto de entrada define o arquivo como publicável. Esta opção não está disponível para arquivos de caso de teste. Esta opção não está disponível em projetos de biblioteca.
Desativar Ponto de Entrada	Deixa de marcar o arquivo do fluxo de trabalho selecionado como ponto de entrada para o processo. Esta opção não está disponível para o arquivo de fluxo de trabalho definido como Principal.
Propriedades do argumento	Abre a janela Propriedades de argumento para configurar as configurações de exibição de argumentos. Observação: esta opção está disponível apenas para arquivos XAML definidos como principais ou marcados como um ponto de entrada para o projeto.
Extrair como modelo	Salva o fluxo de trabalho selecionado ou o caso de teste como um modelo no qual é possível basear outros arquivos no projeto. Usar um modelo de arquivo permite economizar tempo quando você precisa criar vários arquivos com a mesma estrutura. Ao adicionar um fluxo de trabalho ou caso de teste, você tem a opção de baseá-lo em qualquer modelo do mesmo tipo que existe na pasta de projeto Modelos.
Ignorar da Publicação / Definir como Publicável	Marca um ou mais arquivos selecionados como excluídos da publicação ou publicáveis. Observação: Quando um arquivo é ignorado da publicação, o ícone ao lado do nome do arquivo fica cinza . Ignorar um arquivo marcado como ponto de entrada da publicação desabilita o ponto de entrada. Essas opções não estão disponíveis para arquivos de fluxo de trabalho em arquivos de biblioteca. Em projetos em que os arquivos XAML são compilados quando publicados, os arquivos de fluxo de trabalho e caso de teste que são excluídos da publicação não são compilados.
Tornar Privado / Tornar Público	Marca um ou mais arquivos selecionados em um projeto de biblioteca como privados ou publicados. Um arquivo de fluxo de trabalho privado é incluído no pacote publicado, mas nenhum componente reutilizável é criado e disponibilizado no painel Atividades em projetos em que a biblioteca esteja instalada como uma dependência. Observação: Quando um arquivo for marcado como privado, o ícone ao lado de seu nome ficará cinza . Essas opções não estão disponíveis para arquivos de caso de teste.
Criar Caso de teste	Cria um caso de teste que invoca o arquivo de fluxo de trabalho selecionado.
Converter para Caso de Teste / Converter para Fluxo de Trabalho	Converte os fluxos de trabalho selecionados em casos de teste ou os casos de teste selecionados em fluxos de trabalho.
Importar Casos de Teste	Importa casos de teste para dentro do projeto como casos de teste de rascunho.
Adicionar Dados de Teste	Abre a janela Importar fonte de variação de dados, que habilita você a adicionar dados de teste ao projeto. Essa opção está disponível apenas para casos de teste.
Vincular ao Test Manager	Abre a janela Vincular ao Test Manager, que permite que você vincule os casos de teste selecionados ao Test Manager.
Executar Casos de Teste / Depurar Casos de Teste	Executa ou depura múltiplos casos de teste selecionados.

Opções do Menu de Contexto para o GIT

Em projetos adicionados aos repositórios do GIT, um ícone é exibido ao lado de cada arquivo no painel Projeto para indicar seu status:

O arquivo é sincronizado com o repositório.

O arquivo foi modificado.

O arquivo foi adicionado.

O arquivo foi removido.

Clique com o botão direito do mouse em um arquivo ou nó do projeto no painel Projeto para abrir o menu de contexto específico do GIT para Gerenciamento de projetos com o GIT.

Opção	Description
Confirmar	Confirma as alterações atuais no repositório local do GIT.
Enviar por Push	Envia por push a versão atual para o repositório remoto.
Efetuar Pull (troca de base)	Efetua pull dos arquivos remotos e troca a base da ramificação atual.
Gerenciar Ramificações	Abre a janela do GIT com opções de gerenciamento das ramificações adicionadas no momento.
Mostrar Alterações	Abre a janela File Diff para comparar as alterações entre a versão local e a versão remota do arquivo.
Mostrar histórico	Abre a janela Mostrar Histórico para comparação de duas versões do mesmo arquivo.
Desfazer	Abre a janela Desfazer Alterações Pendentes se o arquivo não tiver sido confirmado ou enviado por push para o repositório remoto.
Copiar URL do Repositório	Copia a URL do repositório do projeto para a área de transferência.

Opções do menu Contexto para o SVN e o TFS

Nos projetos adicionados aos repositórios do SVN ou do TFS, um ícone é exibido ao lado de cada arquivo no painel Projeto para indicar o status do arquivo:

Não é feito check-out do arquivo para edição.

Foi feito check-out do arquivo para edição.

O arquivo foi editado.

O arquivo foi adicionado.

Clique com o botão direito do mouse em um arquivo ou nó do projeto no painel Projetopara abrir o menu de contexto com opções específicas para gerenciar os projetos com o TFS ou o SVN.

Opção	Description
Abrir	Abre o arquivo .xaml selecionado no painel Designer em modo somente leitura se não tiver sido verificado para edição a partir do repositório do TFS/SVN.
Renomear	Permite renomear o arquivo ou pasta selecionado, abrindo a janela Renomear Item. Ao fazer registo de entrada no arquivo .xaml renomeado, será necessário fazer registo de entrada na versão modificada anteriormente.
Excluir	Exclui o item selecionado somente da máquina local. A última versão em que se realizou registo de entrada do arquivo ainda estará disponível no repositório de TFS/SVN.
Fazer check-out para editar	Marca o arquivo ou pasta selecionada como bloqueada para edição. Fazer check-out de um arquivo o bloqueia no servidor, de modo que ninguém mais possa editá-lo.
Finalizar Edição	Registra o arquivo project.json no repositório com as alterações e uma mensagem de confirmação.
Adicionar	Carrega o item selecionado no servidor TFS/SVN. Esta opção não estará disponível se o item tiver sido previamente carregado no servidor.
Obter versão mais recente	Faz download da versão mais recente do item selecionado do repositório do TFS/SVN.
Mostrar alterações...	Abre o File Diff para comparar as alterações entre o arquivo com versão e o que tiver sido mapeado localmente.
Fazer Check-In	Exibe a janela Check in de Alterações, permitindo carregar o item selecionado no servidor como a versão mais recente. O arquivo .xaml deve ser salvo antes de ser carregado. Depois que seu check in é feito, o arquivo se torna somente leitura no Studio.
Desfazer	Mostra a janela Desfazer Alterações Pendentes, permitindo reverter as alterações feitas ao projeto, seja a reversão de arquivos modificados para estados anteriores ou sem versão ou recuperar arquivos que foram excluídos da máquina local. As alterações não podem ser revertidas após o arquivo ser verificado.
Executar	Executa o fluxo de trabalho selecionado, mesmo se ele não tiver sido feito o check-out ou adicionado ao repositório.
Definir como Principal	Define o arquivo .xaml selecionado como Principal no projeto. O primeiro .xaml criado, por padrão, é definido como Principal.
Copiar URL do Repositório	Copia a URL do repositório do projeto para a área de transferência.

Ajustando as Configurações do Projeto

Um conjunto de configurações individuais pode ser determinado em relação a cada projeto de automação em que você estiver trabalhando. As configurações ficam disponíveis na janela Configurações do Projeto, que pode ser aberta clicando em no painel Projeto.

Descrição do campo para a Janela de Configurações

A tabela a seguir descreve as configurações do projeto para processo, automação de testes e modelo. Para obter informações sobre as configurações disponíveis para bibliotecas, consulte Sobre bibliotecas.

Campo	Description
Name	Altere o nome do projeto. Esses nomes podem conter caracteres de espaço em branco. Ao dar nome aos projetos, lembre-se que os caracteres de espaço em branco são removidos no momento da publicação. Este campo aceita até 128 caracteres.
Description	Altere a descrição do projeto. Este campo aceita até 500 caracteres.
Tags de projeto	Você pode adicionar uma ou mais tags ao projeto, quer criando novas tags ou reutilizando aquelas já definidas no Orchestrator. Existem dois tipos de tags: rótulos e propriedades (pares de chave-valor). As tags são incluídas no pacote publicado e ajudam a descrever e categorizar projetos. Por exemplo, elas podem se referir à aplicação automatizada (um rótulo Excel) ou ao departamento (uma propriedade de chave-valor de department:accounting). Quando você começa a digitar, são sugeridas combinações possíveis a partir de tags já definidas, e você pode reutilizar uma delas selecionando-a na lista de correspondências. Para uma correspondência da propriedade, a chave seguida pelo caractere : (dois pontos) é exibida primeiro, e os valores associados são exibidos depois de você selecionar a chave, Para adicionar uma nova tag, depois de digitar o nome, clique na entrada com o sinal de mais ao lado do nome. Separar strings com o caractere : (dois pontos) habilita você a adicionar propriedades, enquanto as entradas que não contêm um :adicionam rótulos. Os rótulos e propriedades de chave-valor são limitados a 256 caracteres. Nomes de tags não podem conter estes caracteres: <, >, %, &, \, ?, /, :. As tags de projeto podem ser aplicadas automaticamente a processos no Orchestrator. Para obter mais informações sobre o uso de tags, consulte Organização de recursos com tags no Guia do Orchestrator.
URL do Automation Hub	URL de uma ideia do Automation Hub vinculada ao projeto. Para obter mais informações, consulte Vinculação de um projeto a uma ideia no Automation Hub.
Ícone do Pacote	Opcionalmente, defina um ícone personalizado para o projeto. Você pode procurar e selecionar um arquivo ou inserir um caminho ou URL público para um jpeg, jpg ou arquivo png de até 1 MB. Após a publicação do projeto, o ícone é exibido da seguinte maneira: Para processos, no Assistant ao lado do nome do processo, facilitando identificá-lo na lista de processos. Para modelos, ao lado do modelo em Início (modo de exibição Backstage do Studio) > Modelos. Para bibliotecas, ao lado do pacote na janela Gerenciar pacotes no Studio. Observação: o ícone não fica visível em Gerenciar pacotes se um arquivo local estiver sendo usado em uma biblioteca publicada no Orchestrator ou um feed que não suporta ícones incorporados. Nesse caso, especifique o ícone usando uma URL.
Desabilitar Pausa	Permita ou evite que usuários pausem a execução a partir do UiPath Assistant. Defina como Sim se pausar o processo durante a execução provocaria uma pane no mesmo. Por exemplo, se uma atividade no seu fluxo de trabalho usa a propriedade Timeout, pausar a execução faria o tempo limite expirar e interromperia a execução.
Automação Assistida	Defina como Sim para indicar que o projeto só deve ser executado em um contexto assistido. Use essa configuração para projetos que incluam atividades de Automação de Interface Gráfica ou outras atividades que exijam interação do usuário.
Inicia em Segundo Plano	Defina como Sim para transformar o projeto em um Processo em segundo plano e permitir que seja executado em segundo plano simultaneamente com outros processos, desde que não use a interação com a Interface Gráfica.
Oferece Suporte à Persistência	Defina como Sim para transformar o projeto em um Processo do Orchestrator.
Separar dependências do Runtime	Para aumentar o desempenho do Robô e reduzir o tamanho dos pacotes publicados, as bibliotecas são separadas em pacotes de design e Runtime . O pacote de design é usado pelo Studio, e o pacote de execução mais fino é usado pelo Robô.
Incluir Origens	Defina como Sim para empacotar todas as .xaml origens no pacote publicado, incluindo os fluxos de trabalho que foram transformados anteriormente em privados. Para bibliotecas Windows - Legado, os arquivos são salvos no arquivo de assembly gerado e na pasta lib\net45 no arquivo .nupkg . Para Windows e bibliotecas e processos multiplataforma, os arquivos são salvos na pasta content no arquivo .nupkg .
Opções de PiP	Indique se o projeto foi testado usando o Picture in Picture (PiP) e se ele deve ser iniciado no PiP por padrão. Testado para uso do PiP; Começando no PiP - A automação foi aprovada para ser executada no modo PiP. Ao ser executada, ela é iniciada no PiP por padrão. Testado para uso do PiP; Não começando no PiP por padrão - A automação foi aprovada para ser executada no modo PiP. Ao ser executada, ela é iniciada na sessão principal ou na área de trabalho por padrão. Não testada para uso do PiP - A automação não foi aprovada para ser executada no modo PiP. Quando executada, ela começa na sessão principal ou na área de trabalho por padrão. Se for executada em PiP, uma caixa de diálogo informa ao usuário que ela não foi testada usando esse recurso e solicita uma confirmação antes de prosseguir.
Tipo de PiP	Selecione como isolar a automação da sessão do usuário ao executar o projeto em PiP: Nova sessão (sessão filho na máquina) ou Nova área de trabalho (área de trabalho virtual na sessão do usuário).

Clique em OK e as alterações ficarão visíveis no painel Projeto e no arquivo project.json.

Faça o check-out da página Configurar Definições do Projeto da Atividade para ser sobre como ajustar as propriedades da atividade no nível do projeto.

Observação: leve em consideração que, sempre que desejar copiar um grande número de atividades de uma sequência para outra, é recomendável rolar a tela até a parte inferior do painel Designer antes. Isso é devido a uma limitação do Windows Workflow Foundation.

Como remover recursos de projeto não usados

Os recursos desnecessários podem complicar os projetos, de modo que isso afete o desempenho. Para evitar esse problema, remova recursos não usados de seus projetos clicando em Remover não usados na faixa de opções do Studio e remova-os:

• Fluxos de trabalho - Remover arquivos do fluxo de trabalho que não são referenciados no projeto.
• Variáveis - Remover variáveis que não são usadas no arquivo atualmente aberto.
• Argumentos - Remover argumentos que não são usados no arquivo atualmente aberto.
• Dependências - Remover pacotes de atividades instaladas onde nenhuma atividade está em uso no projeto.
• Importações - Remover namespaces importados que não são usados no arquivo atualmente aberto.
• Capturas de tela - Remover capturas de tela informativas que não são usadas em nenhuma atividade no projeto.