Créer et déployer des applications codées

Créez et déployez une application codée dans UiPath: ce dont vous avez besoin avant de commencer, comment l'application est créée dans un IDE et comment la publier et la déployer dans un dossier Orchestrator.

Une application codée commence par une application Web qu'un développeur écrit dans son propre IDE et se termine par une application que vos utilisateurs ouvrent à partir d'une URL UiPath. Cette page décrit le parcours et les étapes de déploiement qui ont lieu dans UiPath.

Le processus comprend quatre étapes:

1. Définir la logique de l'application dans un IDE.
2. Mise en place d'une connexion sécurisée à UiPath.
3. Déploiement de l'application sur Orchestrator.
4. Accéder à l'application dans l'écosystème UiPath.

Avant de commencer

Important :

Dans Automation Cloud (Dédié) et Test Cloud (Dédié), utilisez la version 1.202.0 de UiPath CLI pour les étapes pack, publish, deploy et push , jusqu'à ce que votre environnement de production dédié soit mis à niveau vers la version d'Apps publiée le 24 septembre 2026. Les versions CLI ultérieures contiennent des modifications majeures qui sont incompatibles avec la version d’Apps actuellement exécutée dans des environnements dédiés. Une fois votre environnement de production dédié mis à niveau vers la version d’Apps du 24 septembre 2026, vous pourrez utiliser des versions ultérieures de la CLI UiPath.

À des fins de résolution des problèmes, consultez la section Pourquoi les commandes uip codedapp échouent dans Automation Cloud (Dédié)..

Assurez-vous que les éléments suivants sont en place:

• Un environnement de développement local avec Node.js 20.x ou version ultérieure et npm, utilisé pour créer l'application et installer l'outil UiPath. Téléchargez le programme d’installation à partir de nodejs.org, qui inclut npm. Pour vérifier ce qui est déjà installé, exécutez node -v et npm -v.
• La UiPath CLI, avec l’outil codedapp installé. Pour obtenir des instructions d'installation, consultez le guide UiPath CLI .
• Un ID d’application externe provenant d’une application externe enregistrée dans votre organisation. L'application l'utilise pour connecter les utilisateurs et appeler les services UiPath en leur nom. Une application codée s'exécute dans le navigateur et ne peut pas stocker une clé secrète d'application; enregistrez-la donc en tant qu'application non confidentielle avec des étendues d'utilisateur. Pour en enregistrer une, consultez la section Ajout d'une application externe dans le guide d'administration d'Automation Cloud.
• Autorisation de publier des packages et de déployer des applications dans le dossier Orchestrator que vous ciblez.

Développer l’application

Le développeur crée l'application de la même manière qu'il créerait n'importe quelle application Web, dans le cadre de son choix, comme React, Vue ou Angular. UiPath ajoute deux éléments à ce workflow:

• Une connexion à votre organisation. Un fichier de configuration à la racine du projet identifie votre organisation, votre locataire et l’ID d’application externe. Le SDK TypeScript UiPath lit cette configuration, afin que l'application puisse appeler les services UiPath tels qu'Orchestrator, les ressources, les compartiments de stockage et les processus.
• Une configuration de développement local. Un plug-in UiPath pour l'outil de création du projet fournit la même configuration lorsque l'application s'exécute sur la machine du développeur, afin que l'application puisse être testée avec un locataire réel avant d'être déployée.

Les deux sont une configuration unique par projet. Pour la configuration complète du développeur, y compris le fichier de configuration, le plug-in de l'outil de développement et les ajustements dont l'application a besoin avant d'être empaquetée, consultez Premiers pas avec les Apps codées dans la documentation du SDK.

Déployer l'application

Le déploiement se produit en deux parties: le développeur empaquète et publie l'application, puis vous déployez ce package dans un dossier Orchestrator.

Empaqueter et publier l'application

Une application codée est publiée dans Orchestrator sous forme de package .nupkg , le même format de package utilisé pour les automatisations.

1. Créez l'application:

   npm run build
   

2. Créez un package pour la sortie du build:

   uip codedapp pack dist -n <appName> --version 1.0.0
   

3. Connectez-vous à votre organisation UiPath:

   uip login
   

4. Publiez le package dans un flux de locataire ou un flux d’espace de travail personnel:

   uip codedapp publish
   

5. Déployez l'application:

   uip codedapp deploy
   

Pour obtenir la liste complète des arguments de chaque commande, consultez uip codedapp dans le guide de la UiPath CLI.

Déployer l'application depuis Orchestrator

Si le package a déjà été publié, ou si vous préférez ne pas utiliser la ligne de commande, déployez plutôt l’application à partir d’Orchestrator.

1. Dans Orchestrator, accédez à Locataire > Packages.
2. Sélectionnez Charger et téléchargez le fichier .nupkg créé par uip codedapp pack. Pour la procédure détaillée, consultez Gestion des packages.
3. Accédez au dossier dans lequel vous souhaitez déployer l'application, puis accédez à Automatisations > Apps.
4. Sélectionnez Déployer l'application, puis sélectionnez votre application et sa version. Pour connaître la procédure détaillée, consultez Gestion des applications.

Déployer l'application depuis Studio Web

Si l'application est créée en tant que projet d'application codée dans une solution Studio Web, elle est packagée et déployée avec cette solution plutôt que de manière autonome. La version de l'application codée reste verrouillée avec les workflows, les agents et les ressources dont elle dépend.

1. Créez l'application localement, puis envoyez-la dans le projet Studio Web:

   uip codedapp push --project-id <project-id>
   

2. Dans Studio Web, ouvrez la solution et sélectionnez Déployer.

3. Définissez la version du package, choisissez s'il faut compresser dans votre espace de travail personnel ou partagé, nommez le déploiement, sélectionnez dossier et sélectionnez Déployer.

Pour connaître l'ensemble complet des options du panneau de déploiement, consultez Publier et déployer des solutions dans le guide de l'utilisateur de Studio Web.

Votre application est désormais disponible sur https://<orgName>.uipath.host/<appName>.