Créer dans VS Code

Comment créer, déboguer et déployer des workflows dans Visual Studio Code avec l'extension UiPath, de l'installation et de la connexion aux commandes et aux paramètres.

L'extension UiPath pour Visual Studio Code ajoute la zone de dessin Flux à Visual Studio Code, un éditeur de code libre. Elle ouvre les fichiers de workflow, qui ont l'extension .flow , dans un éditeur visuel, vous connecte à UiPath et déploie votre travail sur UiPath Automation Cloud.

Le canevas Flux, les nœuds, les variables et le débogage sont les mêmes dans chaque environnement. Cette page couvre ce qui est spécifique à VS Code: l'installation de l'extension, la connexion et le déploiement à partir d'un espace de travail local. Votre premier workflow crée un workflow du début à la fin.

Avant de commencer

Vous avez besoin:

• Code VS 1.110.0 ou versions ultérieures.
• Un compte UiPath. S’inscrire décrit comment en créer une.
• Accès Internet à UiPath Automation Cloud.
• Node.js et npm, les outils pour l’exécution et l’installation des programmes de ligne de commande, installés pour qu’un terminal puisse les trouver. Lors de la première connexion, l'extension utilise npm pour installer l'outil de ligne de commande UiPath, uip (npm install -g @uipath/cli).

Si vous travaillez dans un espace de travail distant, tel que le sous-système Windows pour Linux, SSH, l'espace de code ou un conteneur de développement, l'extension s'exécute sur l'hôte distant. Installez Node.js et npm ici, et non sur votre machine locale, de sorte que la UiPath CLI soit également installée sur l'hôte distant.

Installer l’extension

1. Installez UiPath Maestro à partir de la VS Code Marketplace ou du registre Open VSX.
2. Recharger VS Code lorsque vous y êtes invité.
3. Sélectionnez l'icône UiPath dans la barre d'activité pour ouvrir la vue UiPath Maestro.

La vue UiPath Maestro comprend les sections suivantes:

• L'option Connecter affiche les utilisateurs connectés, le statut de la connexion, ainsi que l'organisation et le locataire dans lesquels vous travaillez.
• Créer un nouveau avec les solutions, les projets et les workflows dans votre espace de travail en dessous.
• Les ressources répertorient ce que le locataire possède déjà, tels que les processus déployés, avec un champ de recherche.
• Problèmes répertorie les problèmes dans vos workflows.
• Construire et déployer affiche l'état du package, le bouton Déployer et l'historique du déploiement.

Se connecter

L’extension vous connecte via votre navigateur Web. Elle ne stocke jamais vos jetons.

1. Dans la section Se connecter , sélectionnez Se connecter.
2. Si la CLI n’est pas encore installée, acceptez l’invite pour l’installer. L'extension exécute npm install -g @uipath/cli.
3. Votre navigateur s’ouvre pour terminer la connexion. L’extension reçoit le résultat sur le port 8104 de votre propre ordinateur.
4. Après votre autorisation, revenez à VS Code. Votre session s’actualise automatiquement à partir de ce moment.

Pour vous déconnecter, sélectionnez Sign Out (Déconnexion) dans la section Connecter . Cela vous déconnecte du processus et efface la session mise en cache.

Remarque :

La connexion utilise le port 8104 sur localhost pour le rappel OAuth. Si la connexion échoue, un processus obsolète peut contenir le port. Libérez-le et réessayez. Sur macOS ou Linux, exécutez lsof -ti :8104 | xargs kill -9. Sur Windows, exécutez netstat -ano | findstr :8104 pour trouver l'ID du processus, puis taskkill /F /PID <id>.

Sélectionnez votre environnement et votre locataire

Une fois connecté, choisissez où vous travaillez. Les commandes s'exécutent à partir de la Palette de commandes: appuyez sur Ctrl/Cmd+Shift+P, saisissez le nom de la commande et sélectionnez-la.

1. Exécuter UiPath: sélectionnez Environnement pour confirmer votre environnement. La valeur par défaut est Cloud.
2. Exécuter UiPath: sélectionnez Locataire pour choisir votre locataire. La section Connecter affiche l’organisation à laquelle appartient le locataire.

Pour changer de locataire ultérieurement, sélectionnez les flèches situées à côté de l'organisation et du locataire dans la section Connecter .

La section Ressources vous permet ensuite de parcourir les dossiers et les ressources pour le locataire sélectionné.

Résultat: la section Ressources répertorie les dossiers et les ressources de votre locataire sélectionné.

Créer ou ouvrir un workflow

Pour créer un projet

1. Dans la vue UiPath Maestro , sélectionnez Créer nouveau.

2. Dans la liste Nouveau projet , sélectionnez Maestro Automate. La liste propose également Maestro Orchestrate et Data Fabric (aperçu).

   

Le projet s'ouvre sur le canevas Flux et la barre d'outils inférieure affiche Maestro Automate.

Pour ouvrir un workflow existant, sélectionnez son fichier .flow dans l'explorateur ou exécutez Flux: Ouvrir Flux (Ctrl/Cmd+Alt+O).

Les entités Data Fabric, qui modélisent les données lues et écrites par les workflows, peuvent être créées et modifiées dans le même espace de travail, sous forme de fonctionnalité Aperçu. Les entités dans VS Code décrivent comment. Studio Web ouvre des solutions qui contiennent un projet d'entité.

Créer avec Autopilot

Autopilot (Aperçu) est disponible dans VS Code en tant qu’extension distincte, UiPath Autopilot, publiée par UiPath. Pour l’installer, ouvrez la vue Extensions (Ctrl+Shift+X ou Cmd+Shift+X sur macOS), recherchez UiPath Autopilot et sélectionnez Installer. Connectez-vous ensuite avec UiPath Autopilot: connectez-vous à la Palette de commandes, puis ouvrez le chat avec UiPath Autopilot: Ouvrir Autopilot. Décrivez le workflow et Autopilot le crée.

Valider un workflow

Les erreurs et les avertissements de validation apparaissent au fur et à mesure que vous modifiez, dans la section Problèmes de la vue UiPath Maestro et dans le panneau Problèmes de VS Code.

Sélectionnez n'importe quelle entrée pour accéder directement au nœud incriminé sur la zone de dessin, y compris les nœuds à l'intérieur des sous-flux. Pour valider à la demande au lieu d'attendre la mise à jour du panneau, exécutez Flux: Valider Flux (Ctrl/Cmd+Shift+V).

Déployer un workflow

Le déploiement à partir de VS Code empaquète l’espace de travail en tant que solution UiPath et le déploie sur UiPath Automation Cloud. Déployer un workflow décrit ce que fait le déploiement.

Dans la section Créer et déployer de la vue UiPath Maestro, sélectionnez Déployer. Il empaquète la solution et la déploie en une seule étape. La flèche située à côté de Déployer offre chaque étape de la manière suivante:

• Package crée uniquement le package sans le déployer.
• Le déploiement déploie uniquement un package que vous avez déjà créé.

Après un déploiement, la section Créer et déployer affiche le statut du dernier package et l'historique de vos déploiements.

Vous pouvez également exécuter ces actions à partir de la Palette de commandes, qui s'ouvre avec Ctrl+Shift+P, ou Cmd+Shift+P sur macOS. Par exemple, exécutez UiPath: Package et déploiement. L'extension VS Code répertorie chaque commande.

Par défaut, l'extension active le déploiement après un déploiement réussi. Pour déployer sans activer, désactivez le paramètre uipath.autoActivateDeployment .

Pour exécuter le même package à partir de la UiPath CLI, exécutez UiPath: Generate.env File. Cela va saisir un fichier .env compatible avec uip.

Tester un workflow

Sélectionnez Exécuter le débogage (▶) dans la barre d’outils inférieure du canevas. Une boîte de dialogue vous demande les valeurs des entrées du déclencheur, telles que productId et customerId. Saisissez-les et démarrez l'exécution. Le workflow s'exécute dans votre locataire sélectionné et chaque nœud affiche son statut sur le canevas au fur et à mesure de la progression de l'exécution.

L'onglet Exécutions sous la zone de dessin suit l'exécution:

• Debug des exécutions répertorie vos exécutions de test, avec leur statut et leur durée.
• Le traçage de l'exécution répertorie chaque nœud qui a été exécuté dans l'ordre, avec le temps qu'il a fallu. Développez un nœud d'agent pour voir l'exécution de son agent et les appels de modèle.
• Les détails de l'exécution affichent ses Variables, Incidents et Métadonnées.

Les autres onglets, Ensembles de données, Évaluateurs et Exécutions d'évaluation, contiennent vos évaluations. Pour transformer une exécution de test en point de données d'évaluation, sélectionnez l'icône en forme de flas, Ajouter un point de données pour exécuter une évaluation, dans la barre d'outils inférieure. Les évaluations décrivent leur fonctionnement.

Les bases du débogage décrivent comment lire une exécution et résoudre les défaillances.

Prochaines étapes

• Votre premier workflow: le workflow de prise de commande, créé étape par étape en environ 15 minutes.
• Extension VS Code: commandes, raccourcis clavier, paramètres et dépannage.
• Déployer un workflow: ce que fait le déploiement.
• Bases du débogage: comment lire une exécution et résoudre les échecs.
• Évaluations: vérifiez un workflow par rapport à des exemples d'entrées.
• Community (Communauté): posez des questions et partagez des workflows avec d'autres développeurs sur le forum UiPath.