Criação e implantação de Apps de ação codificados

Crie e implante um aplicativo de ação codificada no UiPath: o que você precisa antes de começar, como o aplicativo troca dados com o Action Center, como testá-lo localmente e como implantá-lo como uma interface de tarefa.

Um aplicativo de ação codificado passa pelo mesmo ciclo de vida que qualquer aplicativo codificado: ele é definido no código, conectado à UiPath, implantado no Orchestrator e usado como interface para uma tarefa do Action Center.

O processo inclui as seguintes etapas:

1. Definir a lógica do aplicativo de ação em um Ambiente de Desenvolvimento Integrado (IDE).
2. Estabelecendo uma conexão segura com a UiPath.
3. Implantando o aplicativo de ação no Orchestrator.
4. Usando o aplicativo de ação como a interface do usuário para tarefas do Action Center. Um aplicativo de ação codificado pode servir como interface para tarefas criadas em todas as superfícies, incluindo agentes, processos de RPA e processos do Maestro.

Antes de começar

Importante:

No Automation Cloud Dedicado e Test Cloud Dedicado, use a versão 1.202.0 da UiPath CLI para as etapas pack, publish --type Action, deploy e push até que seu ambiente de produção Dedicado seja atualizado para a versão Apps datada de 24 de setembro de 2026. Versões posteriores da CLI contêm alterações importantes que são incompatíveis com a versão do Apps atualmente executada em ambientes dedicados. Depois que seu Ambiente de produção dedicado for atualizado para a versão do Apps de 24 de setembro de 2026, você poderá usar versões mais recentes do UiPath CLI.

Certifique-se de que o seguinte esteja implementado:

• Um ambiente de desenvolvimento local com Node.js 20.x ou mais recente e npm, usado para criar o aplicativo e instalar as ferramentas da UiPath. Baixe o instalador do nodejs.org, que inclui o npm. Para verificar o que já está instalado, execute node -v e npm -v.
• O UiPath CLI, com a ferramenta codedapp instalada. Para obter instruções de instalação, consulte o guia do UiPath CLI .
• Permissão para publicar pacotes e implantar aplicativos na pasta do Orchestrator que você está segmentando.

Dependendo do que ele faz, um aplicativo de ação também pode precisar de um ID de aplicativo externo:

Se seu aplicativo de ação	ID do aplicativo externo obrigatório
Apenas lê e conclui a tarefa	Não
Também chama outros serviços da UiPath, como Orchestrator ou Data Fabric	Sim

Quando um ID de aplicativo externo for necessário, ele deve vir de um aplicativo externo registrado em sua organização. Um aplicativo de ação é executado no navegador e não pode armazenar um segredo do aplicativo; portanto, registre-o como um aplicativo não confidencial com escopos de usuário. Para registrar um, consulte Adicionando um aplicativo externo na guia de administrador do Automation Cloud.

Crie o aplicativo de ação

Um aplicativo de ação codificado é executado dentro de um quadro de sandbox renderizado pelo Action Center, portanto, não pode ler ou gravar dados da tarefa diretamente. O SDK de aplicativos de ação codificada da UiPath preenche essa lacuna, dando ao aplicativo quatro coisas que ele pode fazer:

• Receba a tarefa e seus dados quando o aplicativo carregar.
• Notificar o Action Center quando o usuário editar o formulário, para que possa habilitar o botão Salvar .
• Conclua a tarefa com a ação que o usuário escolheu e os dados finais.
• Exibir mensagens para o usuário dentro do Action Center.

Além desses quatro, a UiPath adiciona duas partes de configuração única a um projeto da Web comum:

• Uma conexão com sua organização. Um pequeno arquivo de configuração na raiz do projeto identifica sua organização, tenant e ID do aplicativo externo, onde é necessário um.
• Uma configuração de desenvolvimento local. Um plug-in da UiPath para a ferramenta de compilação do projeto fornece a mesma configuração enquanto o aplicativo é executado na máquina do desenvolvedor, para que o aplicativo possa ser testado em um tenant real antes de ser implantado.

Para obter a configuração completa do desenvolvedor, incluindo os métodos do SDK, o arquivo de configuração, o plug-in da ferramenta de compilação e os ajustes de que o aplicativo necessita antes de ser empacotado, consulte a documentação do SDK do App de ação codificada .

Teste o aplicativo de ação localmente

O Action Center oferece uma experiência de simulação de tarefas para Apps de ação codificada executados no localhost. São necessárias duas configurações no lado da UiPath antes que funcione.

Adicione o URI de redirecionamento do Action Center ao seu aplicativo externo

Adicione o URI de redirecionamento https://<host>/<orgId>/<tenantId>/actions_ ao aplicativo externo que seu aplicativo de ação usa, onde <host> é o ambiente no qual você se conecta, como cloud.uipath.com.

<orgId> e <tenantId> são os GUIDs, não os nomes da organização e do tenant mostrados na barra de endereços do navegador. Uma entrada ausente ou que usa nomes em vez de GUIDs falha com invalid_request ou Invalid redirect_uri.

Para recuperar ambos os GUIDs, faça login com uip login e, em seguida, execute:

uip login status --output json

A resposta os retorna como OrganizationId e TenantId.

Essa entrada normalmente é adicionada na primeira vez que um aplicativo de ação codificada que usa o aplicativo externo é implantado. Para ler o valor exato que seu aplicativo envia, abra o aplicativo e copie redirect_uri da solicitação /identity_/connect/authorize na guia de rede do seu navegador.

Abra a página de depuração do Action Center

1. Vá para https://<host>/<orgName>/<tenantName>/actions_/debug/coded-action-app Esta página aborda sua organização e o tenant por nome, ao contrário do URI de redirecionamento.
2. Insira os detalhes do aplicativo e, em seguida, carregue-o.

Implantar o aplicativo de ação

A implantação acontece em duas partes: o desenvolvedor empacota e publica o aplicativo de ação e, em seguida, você implanta esse pacote para uma pasta do Orchestrator.

Empacote e publique o aplicativo de ação

Um aplicativo de ação codificada é publicado no Orchestrator como um pacote .nupkg , o mesmo formato de pacote usado para automações. É publicado com --type Action, que o registra para que possa ser selecionado como a interface do usuário para uma tarefa do Action Center.

1. Crie o aplicativo:

   npm run build
   

2. Empacote a saída da compilação:

   uip codedapp pack dist -n <appName> --version 1.0.0
   

3. Faça login em sua organização do UiPath:

   uip login
   

4. Publique o pacote como um aplicativo de ação em um feed de tenant ou um feed de espaço de trabalho pessoal:

   uip codedapp publish --type Action
   

5. Implante o aplicativo:

   uip codedapp deploy
   

Para obter a lista completa de argumentos de cada comando, consulte uip codedapp no guia da UiPath CLI.

Implantar o aplicativo de ação do Orchestrator

Se o pacote já tiver sido publicado ou se você preferir não usar a linha de comando, implante o aplicativo de ação a partir do Orchestrator.

1. No Orchestrator, acesse Tenant > Pacotes.
2. Selecione Carregar e carregue o arquivo .nupkg criado por uip codedapp pack. Para obter o procedimento detalhado, consulte Gerenciamento de pacotes.
3. Acesse a pasta na qual você deseja implantar o aplicativo e acesse Automações > Apps.
4. Selecione Implantar aplicativo e, em seguida, selecione seu aplicativo e sua versão. Para obter o procedimento detalhado, consulte Gerenciamento de aplicativos.

Implante o aplicativo de ação do Studio Web

Se o aplicativo de ação for criado como um projeto de aplicativo codificado dentro de uma solução do Studio Web, ele será empacotado e implantado junto com essa solução, em vez de sozinho. A versão do aplicativo de ação permanece em sincronia com os fluxos de trabalho, agentes e recursos dos quais ela depende.

1. Crie o aplicativo localmente e, em seguida, envie-o para o projeto do Studio Web:

   uip codedapp push --project-id <project-id>
   

2. No Studio Web, abra a solução e selecione Implantar.

3. Defina a versão do pacote, escolha se deseja empacotar em seu espaço de trabalho pessoal ou em um compartilhado, nomeie a implantação, selecione a pasta e selecione Implantar.

Para obter o conjunto completo de opções no painel de implantação, consulte Publicação e implantação de soluções no guia do usuário do Studio Web.

Após a implantação, o aplicativo de ação fica disponível no Action Center e pode ser atribuído como a interface para uma tarefa.