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 lo siguiente:

• VS Code 1.110.0 o posterior.
• Una cuenta de UiPath.
• Node.js y npm disponibles en tu PATH. En el primer inicio de sesión, la extensión instala UiPath CLI (uip) con npm (npm install -g @uipath/cli).
• Acceso de red a su entorno de UiPath.

Nota:

Crear y editar entidades de Data Fabric en VS Code es una capacidad de vista previa. Solo está disponible en VS Code: Studio Web puede abrir una solución que contenga un proyecto de entidad, pero no puede editar la propia entidad.

El lugar donde se ejecuta la extensión también afecta a cómo se configura. La siguiente nota se aplica cuando trabajas en un entorno remoto en lugar de en tu máquina local.

Nota:

En espacios de trabajo remotos (Subsistema de Windows para Linux (WSL), SSH, Codespaces o contenedores de desarrollo), la extensión se ejecuta en el host remoto. UiPath CLI debe instalarse allí, no en tu máquina local.

Instalar la extensión

1. Instala UiPath Maestro 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

• 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. Consulta Entidades en VS Code.

Validate a flow

Flow validation errors and warnings appear in VS Code's Problems panel alongside your project's other diagnostics as you edit.

Select any entry to navigate directly to the offending node on the canvas, including nodes inside subflows. To validate on demand instead of waiting for the panel to update, run Flow: Validate Flow (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