Crear en VS Code

Cómo crear, depurar e implementar flujos de trabajo en Visual Studio Code con la extensión de UiPath, desde la instalación y el inicio de sesión hasta los comandos y la configuración.

La extensión UiPath para Visual Studio Code añade el lienzo de flujo a Visual Studio Code (VS Code), un editor de código gratuito. Abre archivos de flujo de trabajo, que tienen la extensión .flow , en un editor visual, inicia sesión en UiPath e implementa tu trabajo en UiPath Automation Cloud.

El lienzo de flujo, los nodos, las variables y la depuración son los mismos en todos los entornos. Esta página cubre lo que es específico de VS Code: instalar la extensión, iniciar sesión e implementar desde un espacio de trabajo local. Tu primer flujo de trabajo crea un flujo de trabajo de principio a fin.

Antes de comenzar

Necesitas:

• Código VS 1.110.0 o posterior.
• Una cuenta de UiPath. Registro describe cómo crear uno.
• Acceso a Internet a UiPath Automation Cloud.
• Node.js y npm, las herramientas para ejecutar e instalar programas de línea de comandos, instalados para que un terminal pueda encontrarlos. En el primer inicio de sesión, la extensión utiliza npm para instalar la herramienta de línea de comandos de UiPath, 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 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 Maestro.

La vista de UiPath Maestro tiene estas secciones:

• Connect muestra quién ha iniciado sesión, el estado de la conexión y la organización y el tenant en el que trabajas.
• Crear nuevo, con las soluciones, proyectos y flujos de trabajo de tu espacio de trabajo debajo.
• Recursos enumera lo que el tenant ya tiene, como los procesos implementados, con un cuadro de búsqueda.
• Problemas enumera los problemas en tus flujos de trabajo.
• Crear e implementar muestra el estado del paquete, el botón Implementar y el historial de implementación.

Iniciar sesión

La extensión inicia sesión a través de tu navegador web. 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 extensión recibe el resultado en el puerto 8104 de tu propio ordenador.
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. Los comandos se ejecutan desde la Paleta de comandos: Ctrl/Cmd+Shift+P, escribe el nombre del comando y selecciónalo.

1. Ejecuta UiPath: selecciona Entorno para confirmar tu entorno. El valor predeterminado es Cloud.
2. Ejecutar UiPath: selecciona Tenant para elegir tu tenant. La sección Conectar muestra la organización a la que pertenece el tenant.

Para cambiar de tenant más tarde, selecciona las flechas junto a la organización y el tenant en la sección Conectar .

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

Resultado: la sección Recursos enumera las carpetas y recursos de tu tenant seleccionado.

Crear o abrir un flujo de trabajo

Para crear un proyecto:

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

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

   

El proyecto se abre en el lienzo Flujo y la barra de herramientas inferior muestra Maestro Automate.

Para abrir un flujo de trabajo existente, selecciona su archivo .flow en el Explorador o ejecuta Flujo: abrir flujo (Ctrl/Cmd+Alt+O).

Las entidades de Data Fabric, que modelan los datos que leen y escriben los flujos de trabajo, pueden crearse y editarse en el mismo espacio de trabajo, como capacidad de vista previa. Entidades en VS Code describe cómo. Studio Web abre soluciones que contienen un proyecto de 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 flujo de trabajo y Autopilot lo crea.

Validar un flujo de trabajo

Los errores de validación y las advertencias aparecen a medida que editas, en la sección Incidencias de la vista de UiPath Maestro y en el panel Problemas de VS Code.

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).

Implementar un flujo de trabajo

La implementación desde VS Code empaqueta el espacio de trabajo como una solución de UiPath y lo implementa en UiPath Automation Cloud. Implementar un flujo de trabajo describe lo que hace la implementación.

En la sección Crear e implementar de la vista de UiPath Maestro, selecciona Implementar. Empaqueta la solución y la implementa en un solo paso. La flecha junto a Implementar ofrece cada paso por sí mismo:

• El paquete solo crea el paquete sin implementarlo.
• Implementar solo implementa un paquete que ya has creado.

Después de una implementación, la sección Crear e implementar muestra el estado del último paquete y el historial de tus implementaciones.

También puedes ejecutar estas acciones desde la Paleta de comandos, que se abre con Ctrl+Shift+P, o Cmd+Shift+P en macOS. Por ejemplo, ejecuta UiPath: Empaquetar e implementar. La extensión de VS Code enumera todos los comandos.

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.

Probar un flujo de trabajo

Selecciona Ejecutar depuración (▶) en la barra de herramientas inferior del lienzo. Un cuadro de diálogo solicita los valores de las entradas del desencadenador, como productId y customerId. Introdúcelos e inicia la ejecución. El flujo de trabajo se ejecuta en tu tenant seleccionado, y cada nodo muestra su estado en el lienzo a medida que avanza la ejecución.

La pestaña Ejecuciones debajo del lienzo sigue la ejecución:

• Ejecuciones de depuración enumera tus ejecuciones de prueba, con su estado y duración.
• El seguimiento de ejecución enumera cada nodo que se ejecutó, en orden, con el tiempo que tardó. Expanda un nodo de agente para ver su ejecución de agente y llamadas de modelo.
• Los detalles de la ejecución muestran sus Variables, Incidentes y Metadatos.

Las otras pestañas, Conjuntos de datos, Evaluadores y Ejecuciones de evaluación, contienen tus evaluaciones. Para convertir una ejecución de prueba en un punto de datos de evaluación, selecciona el icono del matraz, Añadir un punto de datos para ejecutar una evaluación, en la barra de herramientas inferior. Evaluaciones describe cómo funcionan.

Conceptos básicos de depuración describe cómo leer una ejecución y resolver fallos.

Próximos pasos

• Tu primer flujo de trabajo: el flujo de trabajo de entrada de pedidos, creado paso a paso en unos 15 minutos.
• Extensión de VS Code: comandos, atajos de teclado, configuración y solución de problemas.
• Implementar un flujo de trabajo: lo que hace la implementación.
• Fundamentos de la depuración: cómo leer una ejecución y resolver fallos.
• Evaluaciones: comprueba un flujo de trabajo con entradas de muestra.
• Comunidad: haz preguntas y comparte flujos de trabajo con otros constructores en UiPath Forum.