Soluções

Crie e gerencie Soluções no Studio para agrupar projetos de automação com suas dependências e implante-os nos tenants como uma automação completa de ponta a ponta.

Soluções agrupam tudo o que é necessário para automatizar um processo de negócios de ponta a ponta, oferecendo a você os recursos para desenvolver projetos de automação junto com suas dependências e implementá-los em todos os tenants como um todo.

As soluções são contêineres no nível do cloud para modelar uma automação de ponta a ponta como uma unidade única e versionada. Em uma solução, você pode criar e orquestrar:

• Fluxos de trabalho de RPA
• Fluxos de trabalho da API
• Agents
• Processos com agentes
• Apps (com validações com intervenção humana)

Todos esses componentes compartilham recursos no escopo da solução (ativos, conexões, filas, armazenamento etc.) que você gerencia centralmente no nível da solução. As soluções também são portáteis — empacote uma vez e implante em tenants e organizações com configuração específica do ambiente.

Para saber mais, consulte o guia do usuário do Studio WebPara obter uma visualização de ponta a ponta de como criar, empacotar e implantar uma solução, consulte o ciclo de vida de desenvolvimento da solução.

Criação de soluções no Studio

Você pode criar uma solução diretamente no Studio, vazia na página Iniciar ou junto com seu primeiro projeto.

Começando da página Iniciar

1. Na página Início do Studio, em Novo Projeto, selecione Solução.
2. Na janela Nova Solução , insira um nome e um local para a solução ou mantenha os valores pré-preenchidos e selecione Criar.
   Observação:

   Um nome que colide com uma pasta existente é rejeitado na caixa de diálogo.

O Studio cria uma solução vazia e a abre no painel Explorador . Para adicionar um projeto, selecione o botão Adicionar à solução ou abra o menu de contexto do nó raiz da solução — ambos oferecem as mesmas opções.

Começando de um novo projeto

1. No Studio, inicie um novo projeto de Processo ou Modelo.
2. Na nova configuração do projeto, habilite Criar nova solução. O Studio cria a solução e abre seu projeto como seu primeiro membro no painel Explorer.
3. Para adicionar mais projetos à solução, selecione o botão Adicionar à Solução no painel Explorer. Você pode criar um novo projeto de automação ou importar um existente.
   Observação:

   Você também pode abrir o menu de contexto para o painel Explorer para acessar as mesmas opções.

Para continuar trabalhando em uma solução que foi originalmente criada no Studio Web, abra-a na página WorkSpace no Studio Web e selecione Abrir no Studio Desktop. Para obter mais opções, consulte Gerenciamento de soluções no Studio e no Studio Web.

O painel Explorador

O painel Explorer permite que você gerencie os projetos em sua solução, bem como os arquivos de projeto em cada projeto.

Dentro do painel Explorador, você pode:

• Use o Botão Adicionar à Solução para abrir um menu com duas seções:
  • Adicionar à solução — Adicione um projeto à sua solução:
    • Crie um novo projeto de automação.
    • Use Automação a partir de Modelo para criar um projeto de automação a partir de um modelo.
    • Crie um novo projeto do Maestro Flow ou do Maestro Automate.
    • Importar um projeto de automação existente.
  • Adicionar ao Projeto - Adicione um novo item ao projeto atual:
    • Uma pasta ou um arquivo.
    • Um arquivo de fluxo de trabalho: sequência, fluxograma, fluxo de trabalho de longa duração ou máquina de estado.
    • Um formulário, um fluxo de trabalho codificado, um caso de teste codificado ou um arquivo de código-fonte.
    • Um caso de teste ou um manipulador global.
    Observação:

    You can also access the Add to Solution window from the context menu of the Solution panel.

• Usar a barra Pesquisar para localizar projetos, arquivos, páginas, ações, variáveis ou argumentos específicos em sua solução.
• Open the context menu of the solution to rename it, open it in Studio Web, or, for an empty solution, add a project — the same options offered by the Add to Solution button.
• Abra o menu de contexto da solução e selecione Automação a partir do modelo para adicionar um projeto com base em um modelo. Para obter mais informações, consulte Criação de um projeto a partir de um modelo.
• Open the context menu of the solution or a folder and select Add > Folder... to group projects into folders. For more information, refer to Organizing projects into folders.
• Open the context menu of a project to:
  • Abrir o projeto no Studio e acessar o menu de contexto para projetos com opções específicas do projeto.
  • Abrir o projeto no Studio Web em uma nova guia do navegador.
  • Adicione arquivos e pastas ao projeto ou abra sua pasta com Abrir pasta do projeto. Essas opções estão disponíveis para cada tipo de projeto na solução. Os projetos que não são ativos oferecem apenas Adicionar > Pasta... e Arquivo..., enquanto o projeto ativo oferece o menu completo do projeto.
  • Remover o projeto da solução.

Quando você abre uma solução no Studio, você pode fazer alterações apenas nos seguintes tipos de projeto:

• Projetos de RPA
• Projetos Maestro Flow e Maestro Automate
• Projetos de entidade do Data Fabric, que você edita com a extensão UiPath Maestro

Outros tipos de projeto incluídos em uma solução não podem ser modificados a partir do Studio e exigem que você continue editando a solução no Studio Web (isso inclui projetos de aplicativos, processos por agentes, projetos de API e agentes).

Você pode pesquisar esses outros tipos de projetos não compatíveis no Explorador de soluções ao lado de projetos de RPA e Fluxo. Quando você abre um arquivo de uma delas, um banner contextual explica a experiência de edição limitada e fornece um link para editá-lo no Studio Web.

A lista de projetos é atualizada quando outra ferramenta, como a extensão UiPath Maestro ou uip solution projects add, altera a solução.

Criação de projeto a partir de um modelo

Você pode adicionar um novo projeto a uma solução com base em um modelo, sem criar primeiro o projeto fora da solução.

1. No painel Explorer , abra o menu de contexto da solução e selecione Automação de Modelo.
2. Selecione um modelo e, em seguida, configure o novo projeto.

O Studio cria o projeto dentro da pasta da solução e o adiciona à solução no painel Explorador .

Criação de um projeto do Maestro

Você pode adicionar dois tipos de projetos Maestro a uma solução:

• Maestro Flow - Orquestra um processo de negócios entre agentes, humanos e sistemas.
• Maestro Automate - Reúna agentes de IA e APIs em um único fluxo de trabalho.

Para adicionar um:

1. No painel Explorer , selecione o botão Adicionar à solução .
2. Selecione Maestro Flow ou Maestro Automate.
3. Insira um nome para o projeto e selecione Criar novo.

O Studio estrutura o projeto na solução (da mesma forma que o uip maestro flow init faz na linha de comando) e abre o arquivo de fluxo.

A primeira vez que você abrir um arquivo .flow , o Studio solicitará que você instale a extensão UiPath Maestro . Instale-o para obter a tela de fluxo visual completa; sem ele, o arquivo é aberto como texto simples.

Para saber como criar o próprio fluxo, consulte o guia do usuário do Maestro.

Convertendo entre o Maestro Flow e o Maestro Automate

Ambos os produtos usam a mesma tela de fluxo, permitindo mover um projeto existente de um para o outro.

1. No painel Explorador , abra o menu de contexto de um projeto do Maestro.
2. Selecione Converter para Maestro Automate ou Converter para Maestro Flow, dependendo do tipo de projeto atual.
3. Confirme a conversão.

Após a conversão, cada fluxo no projeto publica e é executado no runtime do novo tipo de projeto. Os fluxos em si não são alterados.

Organização de projetos em pastas

You can group the projects of a solution into folders in the Explorer panel. Folders can be nested.

To add a folder:

1. In the Explorer panel, open the context menu of the solution or an existing folder.
2. Select Add > Folder....
3. Enter a name for the folder.

The context menu of a folder also offers the Add to Solution options:

• Automation - Create a new automation project in the folder.
• Automation from Template - Create an automation project from a template in the folder.
• Import Existing Project - Import an existing automation project into the folder.

You can rename and delete a folder from its context menu, with the following restrictions:

• A folder that contains projects of the solution can't be deleted. Remove the projects from the solution first.
• A folder that contains the open project can't be renamed or deleted. Close the project first.
• The folder that stores the solution's resource definitions can't be renamed or deleted from Studio.

Gerenciamento de projetos não RPA

From the context menu of any unsupported project, you can open it in Studio Web, publish it on its own, or remove it from the solution. Changes made in Studio Web are saved to the cloud and the project opens in a new browser tab. For publishing, refer to Publishing a Single Project.

A experiência de projetar e depurar projetos de RPA dentro de uma solução é a mesma que com projetos de RPA independentes, exceto quando um projeto chama outros projetos da solução por meio de uma atividade Run Job . Para obter mais informações, consulte Depuração de projetos que chamam outros projetos.

Observação:

Você não pode adicionar ou importar projetos do Windows - Legacy em uma solução.

O projeto ativo

Os projetos de RPA e os projetos de Maestro Flow podem ser o projeto ativo de uma solução. Se o último projeto ativo não puder ser restaurado quando você abrir uma solução, o Studio ativará o primeiro projeto na solução que ele puder abrir, preferindo projetos RPA.

Você pode remover qualquer projeto da solução, incluindo o projeto ativo, desde que pelo menos um projeto permaneça na solução. A remoção de um projeto exclui seus arquivos, então o Studio pede que você confirme a remoção primeiro. Quando você remove o projeto ativo:

• Os arquivos abertos do projeto são fechados sem solicitar que você os salve.
• Os arquivos não salvos de outros projetos ainda solicitam que você os salve. Cancelar a solicitação cancela a remoção.
• Nenhum outro projeto é ativado automaticamente. Selecione o projeto no qual você deseja trabalhar a seguir.

Execução e depuração em uma solução

Depuração de projetos que chamam outros projetos

Quando você depura um arquivo em uma solução com mais de um projeto e o arquivo chama outro projeto da solução por meio de uma atividade Run Job , o Studio prepara a solução automaticamente antes que a depuração comece. O Studio empacota a solução, publica-a em seu Espaço de Trabalho Pessoal e implanta os projetos chamados para que sejam executados como trabalhos do Orchestrator quando forem invocados. Você não precisa publicar os projetos chamados ou sincronizar a solução com a nuvem primeiro.

Tenha em mente o seguinte:

• Se o Studio puder determinar que o arquivo que você depura nunca alcança uma chamada Executar trabalho , ele pula essa preparação, e a depuração começa imediatamente.
• Se o Studio não puder determinar isso, por exemplo, para fluxos de trabalho codificados ou destinos de invocação dinâmica, ele preparará a solução de qualquer maneira.
• O arquivo que você depura será executado localmente. Pontos de interrupção e depuração aplicam-se apenas ao projeto que você depura. Os projetos chamados são executados remotamente e você não pode entrar neles.

Execução e depuração de fluxos do Maestro

Você pode executar e depurar arquivos .flow do Maestro a partir da faixa de opções do Studio, da mesma forma que outros arquivos na solução. Os botões Executar, Depurar, Parar, Continuar, Depuração Completa, Depuração Parcial e Depuração Circular controlam a sessão do fluxo, e a saída do fluxo é exibida no painel Saída .

• As sessões que você inicia na tela de fluxo também são controladas na faixa de opções.
• A interrupção não está disponível para fluxos.
• Pontos de interrupção, quadros de pilha e variáveis são gerenciados na tela de fluxo.
• A execução e depuração de fluxos requer a extensão UiPath Maestro .

O painel Recursos definidos

O painel Recursos definidos exibe os recursos incluídos em sua solução. O painel pode ser recolhido. Os recursos são adicionados automaticamente a uma solução conforme são usados por atividades e são agrupados nestas categorias:

• Apps — interfaces do usuário equipadas com automações que permitem criar aplicativos de negócios personalizados que se conectam a dados.
• Ativos — variáveis ou credenciais compartilhadas que você pode usar em diferentes projetos de automação.
• Regras de negócios - Objetos usados para armazenar e gerenciar arquivos Modelo de Decisão e Notation (DMN).
• Conexões - Conexões do Integration Service que ajudam a estabelecer tarefas entre usuários únicos e aplicativos externos.
• Contexto – Índices de contextualização que dão acesso a bases de conhecimento com acesso controlado.
• Processos - Versões de pacotes vinculadas a uma pasta específica.
• Filas - Contêineres que permitem que você mantenha um número ilimitado de itens.
• Buckets de armazenamento - Soluções de armazenamento por pasta aproveitadas na criação de projetos de automação.
• Catálogos de tarefas — contêineres de ação onde você pode classificar suas ações com base em diversos critérios. O catálogo que armazena uma ação é definido quando uma ação é criada, usando atividades de criação de ações no Studio Web.
• Dependências - Categorias de atividades vinculadas contextualmente a um projeto específico.

Resources can be created, defined, or deleted both from Studio and Studio Web. To delete a resource, open its context menu in the Solution Explorer and select Remove. To learn more, refer to Solution Resources in the Studio Web guide.

As atividades estão cientes do contexto da solução. Dentro das atividades que lidam com recursos da solução (por exemplo, Adicionar item da fila), o widget do seletor de recursos exibe todos os recursos disponíveis (ativos, filas, conexões etc.). Você também pode usar o botão Abrir Orchestrator para gerenciar os recursos da plataforma no Orchestrator.

Editing a resource

1. In the Defined Resources panel, open the context menu of a resource and select Open.
2. Edit the resource in the tab that opens.

Changes are saved as you make them. When you rename a resource, the Defined Resources panel and the tab title show the new name.

Gerenciamento de soluções no Studio e Studio Web

As alterações feitas em uma solução são sempre sincronizadas com o cloud, permitindo que você alterne sem problemas entre o Studio e o Studio Web.

After you create a solution in Studio Web, you have the option to continue working in Studio. From the Workspace page in Studio Web, open the menu on the right side of a solution and select Open in Studio Desktop. Alternatively, open the solution in Studio Web, open the context menu of the solution name in the Solution Explorer, and select Open in Studio Desktop.

Após abrir uma solução criada no Studio Web, selecione o rótulo Solução do Cloud na barra de status para abrir um menu suspenso com opções que permitem que você gerencie a solução:

• Abrir no navegador - abra a solução no Studio Web. Se a solução estiver bloqueada pelo Studio Web, um erro será exibido e a solução será aberta em uma nova guia no modo SomenteLeitura.
• Sincronizar com o Cloud - Envie as alterações que você fez no Studio e continue criando sua solução no Studio Web.

Você pode adicionar uma solução no controle de versão do Git selecionando o rótulo Adicionar ao Controle de Origem na barra de status. Isso permite que você gerencie confirmações e ramificações no nível da solução.

Observação:

• O Studio detecta quando um projeto faz parte de uma solução. Abrir um projeto local que faz parte de uma solução abre automaticamente todo o contexto da solução.
• Ao converter um projeto multiplataforma em compatibilidade com o Windows, o projeto é convertido diretamente, sem a opção de criar uma cópia do projeto original.

Trabalho com soluções no Studio e Studio Web

Lembre-se destas diferenças ao trabalhar com soluções no Studio e Studio Web:

• A renomeação de projetos individuais é atualmente compatível apenas com o Studio Web.
• From Studio, you can publish the whole solution, a single project, or the test cases of the active project. For more information, refer to Publishing a solution.
• Alguns tipos de projeto (processos por agentes, aplicativos, fluxos de trabalho de API ou agentes) só podem ser abertos e editados no Studio Web. Você pode usar o Studio para suas potentes experiências de projeto e depuração por RPA e o Studio Web para acessar recursos de automação por agentes.
• O suporte para soluções será adicionado às integrações de CI/CD com o UiPath CLI no futuro.
• Você pode visualizar projetos do Windows no Explorador de soluções no Studio Web, mas poderá editá-los apenas quando abrir a solução no Studio.
• Apenas um usuário pode trabalhar em uma solução de cada vez. Introduzimos um bloqueio no nível da solução para evitar conflitos insolúveis (por exemplo, quando um usuário cria um projeto de fluxo de trabalho de API no Studio Web enquanto outro edita um projeto de RPA no Studio). Sem esse bloqueio, uma sincronização posterior com o cloud pode substituir um conjunto de alterações. Essa limitação será removida quando o Studio Web for compatível com espaços de trabalho locais (salvando toda a solução no disco), permitindo que os fluxos padrão do Git resolvam conflitos com segurança.
  Dica:

  • Use o Git no nível da solução para versionar projetos de automação junto com suas configurações.