Crear e implementar Apps de acción codificada

Cree e implemente una aplicación de acción codificada en UiPath: lo que necesita antes de comenzar, cómo la aplicación intercambia datos con Action Center, cómo probarla localmente y cómo implementarla como una interfaz de tarea.

Una aplicación de acción codificada pasa por el mismo ciclo de vida que cualquier aplicación codificada: se define en el código, se conecta a UiPath, se implementa en Orchestrator y luego se utiliza como interfaz para una tarea de Action Center.

El proceso incluye las siguientes etapas:

1. Definir la lógica de la aplicación de acción en un entorno de desarrollo integrado (IDE).
2. Establecer una conexión segura a UiPath.
3. Implementar la aplicación de acción en Orchestrator.
4. Utilizar la aplicación de acción como interfaz de usuario para las tareas de Action Center. Una aplicación de acción codificada puede servir como interfaz para las tareas creadas a partir de todas las superficies, incluidos los agentes, los procesos de RPA y los procesos de Maestro.

Antes de empezar

Importante:

In Automation Cloud Dedicated and Test Cloud Dedicated, use UiPath CLI version 1.202.0 for the pack, publish --type Action, deploy, and push steps until your Dedicated production environment is upgraded to the Apps release dated September 24, 2026. Later CLI versions contain breaking changes that are incompatible with the Apps version currently running in Dedicated environments. After your Dedicated production environment is upgraded to the September 24, 2026 Apps release, you can use later versions of the UiPath CLI.

Asegúrate de que se cumple lo siguiente:

• Un entorno de desarrollo local con Node.js 20.x o posterior, y npm, utilizado para crear la aplicación e instalar las herramientas de UiPath. Descarga el instalador de nodejs.org, que incluye npm. Para comprobar lo que ya está instalado, ejecuta node -v y npm -v.
• La UiPath CLI, con la herramienta codedapp instalada. Para obtener instrucciones de instalación, consulta la guía de UiPath CLI .
• Permiso para publicar paquetes e implementar aplicaciones en la carpeta de Orchestrator de destino.

Dependiendo de lo que haga, una aplicación de acción también puede necesitar un ID de aplicación externo:

Si tu aplicación de acción	Se requiere un ID de aplicación externo
Lee y completa solo la tarea	No
También llama a otros servicios de UiPath, como Orchestrator o Data Fabric	Sí

Cuando se requiera un ID de aplicación externo, debe proceder de una aplicación externa registrada en tu organización. Una aplicación de acción se ejecuta en el navegador y no puede almacenar un secreto de aplicación, así que regístrala como aplicación no confidencial con ámbitos de usuario. Para registrar una, consulta Añadir una aplicación externa en la guía de administración de Automation Cloud.

Crear la aplicación de acción

Una aplicación de acción codificada se ejecuta dentro de un marco aislado renderizado por Action Center, por lo que no puede leer o escribir datos de tareas directamente. El SDK de la aplicación UiPath Coded Action cierra esa brecha, dando a la aplicación cuatro cosas que puede hacer:

• Recibe la tarea y sus datos cuando se carga la aplicación.
• Notificar a Action Center cuando el usuario edita el formulario, para que pueda habilitar el botón Guardar .
• Completa la tarea con la acción que el usuario eligió y los datos finales.
• Muestra mensajes al usuario dentro de Action Center.

Más allá de esos cuatro, UiPath añade dos piezas de configuración única a un proyecto web ordinario:

• Una conexión con su organización. Un pequeño archivo de configuración en la raíz del proyecto identifica tu organización, tenant e ID de aplicación externa, donde se necesita uno.
• Una configuración de desarrollo local. Un complemento de UiPath para la herramienta de compilación del proyecto proporciona esa misma configuración mientras la aplicación se ejecuta en la máquina del desarrollador, por lo que la aplicación puede probarse en un tenant real antes de implementarse.

Para obtener la configuración completa del desarrollador, incluidos los métodos del SDK, el archivo de configuración, el complemento de la herramienta de compilación y los ajustes que necesita la aplicación antes de empaquetarse, consulta la documentación del SDK de la aplicación Coded Action .

Probar la aplicación de acción localmente

Action Center ofrece una experiencia de simulación de tareas para Apps de acción codificada que se ejecutan en localhost. Se necesitan dos piezas de configuración en el lado de UiPath antes de que funcione.

Añada el URI de redirección de Action Center a su aplicación externa

Añade el URI de redirección https://<host>/<orgId>/<tenantId>/actions_ a la aplicación externa que utiliza tu aplicación de acción, donde <host> es el entorno en el que inicias sesión, como cloud.uipath.com.

<orgId> y <tenantId> son los GUID, no los nombres de la organización y el tenant que se muestran en la barra de direcciones del navegador. Una entrada faltante, o una que utiliza nombres en lugar de GUID, falla con invalid_request o Invalid redirect_uri.

Para recuperar ambos GUID, inicia sesión con uip login luego ejecuta:

uip login status --output json

La respuesta los devuelve como OrganizationId y TenantId.

Esta entrada normalmente se añade la primera vez que se implementa una aplicación de acción codificada que utiliza la aplicación externa. Para leer el valor exacto que envía tu aplicación, abre la aplicación y copia redirect_uri de la solicitud /identity_/connect/authorize en la pestaña de red de tu navegador.

Abrir la página de depuración de Action Center

1. Ve a https://<host>/<orgName>/<tenantName>/actions_/debug/coded-action-app. Esta página se dirige a tu organización y tenant por nombre, a diferencia del URI de redirección.
2. Introduce los detalles de tu aplicación y luego cárgala.

Implementar la aplicación de acción

La implementación se produce en dos partes: el desarrollador empaqueta y publica la aplicación de acción, luego implementas ese paquete en una carpeta de Orchestrator.

Empaquetar y publicar la aplicación de acción

Una aplicación de acción codificada se publica en Orchestrator como un paquete .nupkg , el mismo formato de paquete utilizado para las automatizaciones. Se publica con --type Action, que lo registra para que pueda seleccionarse como interfaz de usuario para una tarea de Action Center.

1. Crea la aplicación:

   npm run build
   

2. Empaqueta la salida de la compilación:

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

3. Inicie sesión en su organización de UiPath:

   uip login
   

4. Publica el paquete como una aplicación de acción, en una fuente de tenant o una fuente de espacio de trabajo personal:

   uip codedapp publish --type Action
   

5. Implementar la aplicación:

   uip codedapp deploy
   

Para obtener la lista completa de argumentos de cada comando, consulta uip codedapp en la guía de UiPath CLI.

Implementar la aplicación de acción desde Orchestrator

Si el paquete ya se ha publicado, o si prefieres no utilizar la línea de comandos, implementa la aplicación de acción desde Orchestrator en su lugar.

1. En Orchestrator, ve a Tenant > Paquetes.
2. Selecciona Cargar y carga el archivo .nupkg creado por uip codedapp pack. Para obtener el procedimiento detallado, consulta Gestionar paquetes.
3. Ve a la carpeta donde quieres implementar la aplicación y ve a Automatizaciones > Apps.
4. Selecciona Implementar aplicación y luego selecciona tu aplicación y su versión. Para obtener el procedimiento detallado, consulta Gestionar aplicaciones.

Implementar la aplicación de acción desde Studio Web

Si la aplicación de acción se crea como un proyecto de aplicación codificada dentro de una solución de Studio Web, se empaqueta e implementa junto con esa solución en lugar de por sí sola. La versión de la aplicación de acción se mantiene sincronizada con los flujos de trabajo, agentes y recursos de los que depende.

1. Crea la aplicación localmente y luego insértala en el proyecto de Studio Web:

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

2. En Studio Web, abre la solución y selecciona Implementar.

3. Establece la versión del paquete, elige si deseas empaquetar en tu espacio de trabajo personal o en uno compartido, nombra la implementación, selecciona la carpeta y selecciona Implementar.

Para ver el conjunto completo de opciones en el panel de implementación, consulta Publicar e implementar soluciones en la guía del usuario de Studio Web.

Después de la implementación, la aplicación de acción está disponible en Action Center y puede asignarse como interfaz para una tarea.