Flujo en VS Code

Instala y configura la extensión UiPath para Visual Studio Code para crear, depurar e implementar flujos desde tu espacio de trabajo local.

Qué es

La extensión UiPath para Visual Studio Code te permite crear, depurar e implementar flujos desde VS Code. Incluye un editor visual para archivos .flow , inicia sesión en UiPath y empaqueta y publica tu trabajo en Orchestrator.

El lienzo, los nodos, las variables y la depuración funcionan de la misma manera que en Studio Web. Esta página cubre lo específico de VS Code: instalar la extensión, iniciar sesión y empaquetar desde tu espacio de trabajo local. Para obtener más información sobre cómo crear flujos, consulta el resto de esta guía, comenzando con Tu primer flujo.

Antes de comenzar

Necesitas:

• Código VS 1.110.0 o posterior.
• Una cuenta de UiPath.
• Acceso de red a su entorno de UiPath.
• Node.js y npm, las herramientas para ejecutar e instalar programas de línea de comandos, disponibles en tu PATH. En el primer inicio de sesión, la extensión utiliza npm para instalar UiPath CLI, uip (npm install -g @uipath/cli).

Si trabajas en un espacio de trabajo remoto, como el Subsistema de Windows para Linux (WSL), SSH, Codespaces o un contenedor de desarrollo, la extensión se ejecuta en el host remoto. Instala Node.js y npm allí, no en tu máquina local, para que UiPath CLI también se instale en el host remoto.

Instalar la extensión

1. Instala UiPath Maestro Orchestrate desde el Marketplace de VS Code o desde Open VSX Registry.

2. Vuelva a cargar VS Code cuando se le solicite.

3. Selecciona el icono de UiPath en la barra de actividad para abrir la vista de UiPath.

   

La vista de UiPath tiene tres secciones:

• Connect muestra tu estado de inicio de sesión, entorno y tenant.
• El Explorador de soluciones enumera las soluciones, los proyectos y los flujos de tu espacio de trabajo.
• Recursos enumera las carpetas y los recursos de Orchestrator para el tenant seleccionado una vez que inicias sesión.

Iniciar sesión

La extensión inicia sesión en el proceso, utilizando la biblioteca de autenticación de UiPath incluida para ejecutar un flujo de navegador OAuth/Clave de prueba para intercambio de código (PKCE). La extensión nunca almacena tus tokens.

1. En la sección Conectar , selecciona Iniciar sesión.
2. Si la CLI aún no está instalada, acepta la solicitud para instalarla. La extensión ejecuta npm install -g @uipath/cli.
3. Su navegador se abre para completar el inicio de sesión. La biblioteca de autenticación recibe la devolución de llamada en el puerto localhost 8104.
4. Después de autorizar, vuelva a VS Code. Tu sesión se actualiza automáticamente a partir de ese momento.

Para cerrar sesión, selecciona Cerrar sesión en la sección Conectar . Esto cierra la sesión en el proceso y borra la sesión en caché.

Nota:

El inicio de sesión utiliza el puerto 8104 en localhost para la devolución de llamada OAuth. Si el inicio de sesión falla, es posible que un proceso obsoleto esté reteniendo el puerto. Libéralo e inténtalo de nuevo. En macOS o Linux, ejecuta lsof -ti :8104 | xargs kill -9. En Windows, ejecuta netstat -ano | findstr :8104 para encontrar el ID del proceso y luego taskkill /F /PID <id>.

Seleccione su entorno y tenant

Después de iniciar sesión, elija dónde trabaja.

1. Ejecuta UiPath: selecciona Entorno para confirmar tu entorno. El valor predeterminado es Cloud.
2. Ejecutar UiPath: selecciona Tenant para elegir tu tenant u organización.

La sección Recursos te permite buscar carpetas y recursos para el tenant seleccionado.

Resultado: la sección Recursos se rellena con carpetas y recursos de Orchestrator para tu tenant seleccionado.

Crear o abrir un flujo

Para crear un proyecto:

1. En la vista de UiPath Maestro , selecciona Crear nuevo.

2. En la lista Nuevo proyecto , selecciona Maestro Orchestrate. La lista también ofrece Maestro Automate y Data Fabric (vista previa).

   

También puedes trabajar desde la Paleta de comandos y el Explorador:

• Ejecuta Flujo: Nuevo flujo (Ctrl/Cmd+Alt+N) para crear un nuevo archivo .flow .
• Abre un archivo .flow existente desde el Explorador o ejecuta Flujo: abrir flujo (Ctrl/Cmd+Alt+O).
• Con una solución abierta, selecciona Añadir flujo en la barra de título del Explorador de soluciones para añadir un flujo al proyecto activo.

El archivo se abre en el editor de flujo visual. Crea, conecta nodos y configúralos exactamente como lo harías en Studio Web.

También puedes modelar entidades de Data Fabric en el mismo espacio de trabajo, como una capacidad de vista previa. Entidades en VS Code describe cómo. Las entidades solo se pueden crear y editar en VS Code: Studio Web puede abrir una solución que contenga un proyecto de entidad, pero no puede editar la propia entidad.

Crear con Autopilot

Autopilot (vista previa) está disponible en VS Code como una extensión independiente, UiPath Autopilot, publicada por UiPath. Para instalarlo, abre la vista Extensiones (Ctrl+Shift+X o Cmd+Shift+X en macOS), busca UiPath Autopilot y selecciona Instalar. A continuación, inicia sesión con UiPath Autopilot: Iniciar sesión en la Paleta de comandos y, a continuación, abre el chat con UiPath Autopilot: Abrir Autopilot. Describe el proceso y Autopilot lo crea.

Validar un flujo

Los errores de validación de flujo y las advertencias aparecen en el panel Problemas de VS Code junto con otros diagnósticos de tu proyecto a medida que editas.

Selecciona cualquier entrada para navegar directamente al nodo infractor en el lienzo, incluidos los nodos dentro de los subflujos. Para validar bajo demanda en lugar de esperar a que el panel se actualice, ejecuta Flujo: validar flujo (Ctrl/Cmd+Shift+V).

Empaquetar e implementar

Publicas desde VS Code empaquetando tu espacio de trabajo como una solución de UiPath e implementándolo en Orchestrator. Consulta Implementar un flujo para saber qué hace la implementación.

• UiPath: el paquete crea una solución .uipx desde el espacio de trabajo actual.
• UiPath: implementar carga una solución empaquetada en Orchestrator.
• UiPath: Empaquetar e implementar ejecuta ambos pasos juntos.
• UiPath: Cambiar destino de implementación cambia la carpeta de destino.

De forma predeterminada, la extensión activa la implementación después de una implementación correcta. Para implementar sin activar, desactiva la configuración uipath.autoActivateDeployment .

Para ejecutar el mismo paquete desde UiPath CLI, ejecuta UiPath: Generar archivo .env. Esto escribe un archivo .env compatible con uip.

Depurar

La depuración en VS Code redirige a través de tu tenant de Cloud seleccionado. Ejecuta un flujo desde el editor y observa la ejecución en la vista de depuración en vivo, que representa un diagrama de flujo de ejecución de Sirena que se actualiza a medida que avanza la ejecución. Consulta Depurar de forma efectiva para saber cómo leer una ejecución y resolver fallos.

Comandos y atajos de teclado

Ejecuta cualquier comando desde la Paleta de comandos (Ctrl/Cmd+Shift+P). Los atajos del editor de flujo solo se aplican cuando un archivo .flow es el editor activo.

Editor de flujo

Comando	Asignación de teclas predeterminada
Flujo: nuevo flujo	Ctrl/Cmd+Alt+N
Flujo: flujo abierto	Ctrl/Cmd+Alt+O
Flujo: guardar flujo	Ctrl/Cmd+S
Flujo: guardar flujo como	Ctrl/Cmd+Shift+S
Flujo: deshacer	Ctrl/Cmd+Z
Flujo: rehacer	Ctrl+Y / Cmd+Shift+Z
Flujo: Zoom In	Ctrl/Cmd+=
Flujo: Zoom Out	Ctrl/Cmd+-
Flujo: restablecer Zoom	Ctrl/Cmd+0
Flujo: ajustar a la pantalla	Ctrl/Cmd+Shift+F
Flujo: validar flujo	Ctrl/Cmd+Shift+V
Flujo: exportar flujo	Ninguno

UiPath Platform

Comando	Descripción
UiPath: iniciar sesión	Inicia sesión en UiPath.
UiPath: cerrar sesión	Cierra sesión y borra la sesión en caché.
UiPath: seleccionar entorno	Elige el entorno de UiPath.
UiPath: seleccionar tenant	Elige el tenant o la organización.
UiPath: crear nuevo proyecto	Añade un proyecto a la solución. Elija Data Fabric para crear un proyecto de entidad.
UiPath: nuevo archivo	Añade un archivo a un proyecto. Elige Archivo de entidad para añadir una entidad.
UiPath: añadir archivo de entidad	Añadir otra entidad a un proyecto de entidad existente. Disponible una vez que la solución tenga uno.
UiPath: paquete	Crea una solución .uipx desde el espacio de trabajo.
UiPath: implementar	Carga una solución empaquetada en Orchestrator.
UiPath: empaquetar e implementar	Empaqueta e implementa en un solo paso.
UiPath: cambiar destino de implementación	Cambia la carpeta de destino.
UiPath: generar.env Archivo	Escribe un archivo .env compatible con CLI.
UiPath: actualizar	Actualiza el árbol de Connect.
UiPath: mostrar registro de salida	Abre el canal de salida de UiPath.
UiPath: cómo empezar	Abre la guía de introducción.

Para ver el conjunto completo de atajos de lienzo, consulta Atajos de teclado.

Configuración

Configure la extensión en la configuración de VS Code.

uipath.environment

El entorno de UiPath utilizado al iniciar sesión. El valor predeterminado es cloud. Una sesión CLI existente tiene prioridad si apunta a otro lugar.

uipath.autoActivateDeployment

Activa una implementación de solución después de una implementación correcta. El valor predeterminado es true.

uipath.cli.path

Una ruta absoluta al binario UiPath CLI (uip). Déjalo vacío para encontrar uip en tu PATH. Establece esta opción cuando CLI esté instalado en una ubicación que no esté en tu PATH.

uipath.telemetry.enabled

Envía telemetría de uso anonimizada. El valor predeterminado es true. La extensión también respeta telemetry.telemetryLevel global de VS Code. Desactivar cualquiera de los ajustes deshabilita la telemetría.

Solución de problemas

Error al iniciar sesión

El inicio de sesión falla cuando el puerto de devolución de llamada OAuth está ocupado o la CLI pierde su sesión.

• Puerto en uso. La CLI utiliza el puerto 8104 en localhost para la devolución de llamada. Si un proceso obsoleto lo retiene, libera el puerto y vuelve a iniciar sesión. En macOS o Linux, ejecuta lsof -ti :8104 | xargs kill -9. En Windows, ejecuta netstat -ano | findstr :8104 y luego taskkill /F /PID <id>.
• Sesión obsoleta. Ejecuta UiPath: Cerrar sesión y luego UiPath: Iniciar sesión de nuevo para forzar un nuevo inicio de sesión.
• Leer el registro. Ejecuta UiPath: Mostrar registro de salida y comprueba el canal de salida de UiPath para ver si hay errores de inicio de sesión.

No se encuentra el CLI

La extensión cuesta uip. Si no puede encontrar el binario, el inicio de sesión y el empaquetado fallan.

1. Confirma que CLI está instalado ejecutando uip --version en un terminal.
2. Si uip no está en tu PATH, establece uipath.cli.path en la ruta absoluta del binario.
3. Si la CLI no está instalada, ejecuta UiPath: iniciar sesión y acepta la solicitud de instalación, o instálala manualmente con npm install -g @uipath/cli. Esto requiere Node.js y npm en tu PATH.

Los espacios de trabajo remotos no ven la CLI

En los espacios de trabajo WSL, SSH, Codespaces y contenedor de desarrollo, la extensión se ejecuta en el host remoto, no en tu máquina local. El binario uip debe instalarse en ese host. Un CLI instalado en tu máquina local Windows o macOS no es visible para la extensión. Instala la CLI en el espacio de trabajo remoto y, a continuación, inicia sesión de nuevo.

La implementación no se activa

De forma predeterminada, la extensión activa una implementación después de una implementación correcta. Si una implementación se carga pero no se activa, confirma que uipath.autoActivateDeployment esté activado.

Páginas relacionadas

• Tu primer flujo
• Entidades en VS Code
• Implementar un flujo
• Depurar de forma efectiva