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 the Add to Solution button to open a menu with two sections:
  • Add to Solution - Add a project to your solution:
    • Crie um novo projeto de automação.
    • Use Automation from Template to create an automation project from a template.
    • Create a new Maestro Flow or Maestro Automate project.
    • Importar um projeto de automação existente.
  • Add to Project - Add a new item to the current project:
    • A folder or a file.
    • A workflow file: sequence, flowchart, long running workflow, or state machine.
    • A form, a coded workflow, a coded test case, or a code source file.
    • A test case or a global handler.
    Observação:

    Você também pode acessar a Janela Adicionar à solução clicando com o botão direito do mouse dentro do painel Solução.

• Usar a barra Pesquisar para localizar projetos, arquivos, páginas, ações, variáveis ou argumentos específicos em sua solução.
• Clique com o botão direito do mouse na solução para renomeá-la, abra-a no Studio Web ou, para uma solução vazia, adicione um projeto — as mesmas opções oferecidas pelo botão Adicionar à solução .
• Open the context menu of the solution and select Automation from Template to add a project based on a template. For more information, refer to Creating a project from a template.
• Clicar com o botão direito do mouse em um projeto para:
  • 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.
  • Add files and folders to the project, or open its folder with Open Project Folder. These options are available for every project type in the solution. Projects that aren't active offer only Add > Folder... and File..., while the active project offers the full project menu.
  • Remover o projeto da solução.

When you open a solution in Studio, you can only make changes to the following project types:

• RPA projects
• Maestro Flow and Maestro Automate projects
• Data Fabric entity projects, which you edit with the UiPath Maestro extension

Other project types included in a solution cannot be modified from Studio and require you to continue editing the solution in Studio Web (this includes app projects, agentic processes, API projects, and agents).

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.

The project list refreshes when another tool, such as the UiPath Maestro extension or uip solution projects add, changes the solution.

Criação de projeto a partir de um modelo

You can add a new project based on a template to a solution, without creating the project outside the solution first.

1. In the Explorer panel, open the context menu of the solution and select Automation from Template.
2. Select a template, and then configure the new project.

Studio creates the project inside the solution folder and adds it to the solution in the Explorer panel.

Creating a Maestro project

You can add two kinds of Maestro projects to a solution:

• Maestro Flow - Orchestrates a business process across agents, humans, and systems.
• Maestro Automate - Brings AI agents and APIs together in a single workflow.

To add one:

1. No painel Explorer , selecione o botão Adicionar à solução .
2. Select Maestro Flow or 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

Both products use the same flow canvas, so you can move an existing project from one to the other.

1. In the Explorer panel, open the context menu of a Maestro project.
2. Select Convert to Maestro Automate or Convert to Maestro Flow, depending on the current project type.
3. Confirm the conversion.

After the conversion, every flow in the project publishes and runs on the runtime of the new project type. The flows themselves are not changed.

Gerenciamento de projetos não RPA

Clique com o botão direito do mouse em qualquer projeto incompatível para abri-lo no Studio Web ou removê-lo da solução. As alterações feitas no Studio Web são salvas no cloud e o projeto será aberto em uma nova guia do navegador.

The experience of designing and debugging RPA projects within a solution is the same as with standalone RPA projects, except when a project calls other projects of the solution through a Run Job activity. For more information, refer to Debugging projects that call other projects.

Observação:

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

The active project

RPA projects and Maestro Flow projects can be the active project of a solution. If the last active project can't be restored when you open a solution, Studio activates the first project in the solution that it can open, preferring RPA projects.

You can remove any project from the solution, including the active project, as long as at least one project remains in the solution. Removing a project deletes its files, so Studio asks you to confirm the removal first. When you remove the active project:

• The open files of the project are closed without prompting you to save them.
• Unsaved files from other projects still prompt you to save them. Canceling the prompt cancels the removal.
• No other project is activated automatically. Select the project you want to work on next.

Running and debugging in a solution

Debugging projects that call other projects

When you debug a file in a solution with more than one project, and the file calls another project of the solution through a Run Job activity, Studio prepares the solution automatically before debugging starts. Studio packs the solution, publishes it to your Personal Workspace, and deploys the called projects, so that they run as Orchestrator jobs when they are invoked. You don't need to publish the called projects or sync the solution to the cloud first.

Keep in mind the following:

• If Studio can determine that the file you debug never reaches a Run Job call, it skips this preparation, and debugging starts right away.
• If Studio cannot determine this, for example for coded workflows or dynamic invoke targets, it prepares the solution anyway.
• The file you debug runs locally. Breakpoints and stepping apply only to the project you debug. The called projects run remotely, and you cannot step into them.

Running and debugging Maestro flows

You can run and debug Maestro .flow files from the Studio ribbon, the same way as other files in the solution. The Run, Debug, Stop, Continue, Step Into, Step Over, and Step Out buttons control the flow session, and the output of the flow is displayed in the Output panel.

• Sessions that you start from the flow canvas are also controlled from the ribbon.
• Break is not available for flows.
• Breakpoints, stack frames, and variables are managed in the flow canvas.
• Running and debugging flows requires the UiPath Maestro extension.

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.

Os recursos podem ser criados, definidos ou excluídos do Studio e do Studio Web. Para excluir um recurso, clique com o botão direito do mouse nele no Explorador de soluções e selecione Remover. Para saber mais, consulte Recursos da solução no guia do Studio Web.

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.

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.

Após criar uma solução no Studio Web, você tem a opção de continuar trabalhando no Studio. Na página Workspace no Studio Web, abra o menu no lado direito de uma solução e selecione Abrir no Studio Desktop. Ou abra a solução no Studio Web, clique com o botão direito no nome da solução no Explorador de soluções e selecione Abrir no 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, or only the active project or its test cases. 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.
• Support for solutions will be added to CI/CD integrations with UiPath CLI in the future.
• 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.