Crear e implementar aplicaciones codificadas

Cree e implemente una aplicación codificada en UiPath: qué necesita antes de comenzar, cómo se crea la aplicación en un IDE y cómo publicarla e implementarla en una carpeta de Orchestrator.

Una aplicación codificada comienza como una aplicación web que un desarrollador escribe en su propio IDE y termina como una aplicación que tus usuarios abren desde una URL de UiPath. Esta página describe ese recorrido y los pasos de implementación que tienen lugar en UiPath.

El proceso incluye cuatro etapas:

1. Definir la lógica de la aplicación en un IDE.
2. Establecer una conexión segura a UiPath.
3. Implementar la aplicación en Orchestrator.
4. Acceder a la aplicación dentro del ecosistema UiPath.

Antes de empezar

Importante:

In Automation Cloud Dedicated and Test Cloud Dedicated, use UiPath CLI version 1.202.0 for the pack, publish, 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.

For troubleshooting, see Why do uip codedapp commands fail in Automation Cloud Dedicated?.

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 .
• Un ID de aplicación externo de una aplicación externa registrada en su organización. La aplicación lo utiliza para iniciar la sesión de los usuarios y para llamar a los servicios de UiPath en su nombre. Una aplicación codificada 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.
• Permiso para publicar paquetes e implementar aplicaciones en la carpeta de Orchestrator de destino.

Crear la aplicación

El desarrollador crea la aplicación de la misma manera que crearía cualquier aplicación web, en el marco de su elección, como React, Vue o Angular. UiPath añade dos cosas a ese flujo de trabajo:

• Una conexión con su organización. Un archivo de configuración en la raíz del proyecto identifica tu organización, tenant e ID de aplicación externa. El SDK de TypeScript de UiPath lee esta configuración, por lo que la aplicación puede llamar a los servicios de UiPath como Orchestrator, activos, depósitos de almacenamiento y procesos.
• 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.

Ambas son una configuración única por proyecto. Para obtener la configuración completa del desarrollador, incluido el archivo de configuración, el complemento de la herramienta de compilación y los ajustes que necesita la aplicación antes de empaquetarla, consulta Primeros pasos con Apps codificadas en la documentación del SDK.

Implementar la aplicación

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

Empaquetar y publicar la aplicación

Una aplicación codificada se publica en Orchestrator como un paquete .nupkg , el mismo formato de paquete utilizado para las automatizaciones.

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 en una fuente de tenant o una fuente de espacio de trabajo personal:

   uip codedapp publish
   

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 desde Orchestrator

Si el paquete ya se ha publicado, o si prefieres no utilizar la línea de comandos, implementa la aplicació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 desde Studio Web

Si la aplicació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 codificada 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.

Su aplicación ya está disponible en https://<orgName>.uipath.host/<appName>.