Créer et déployer des Apps d'actions codées

Créer et déployer une application d'action codée dans UiPath: ce dont vous avez besoin avant de commencer, comment l'application échange des données avec Action Center, comment la tester localement et comment la déployer en tant qu'interface de tâches.

Une application d'action codée suit le même cycle de vie que toute application codée: elle est définie dans le code, connectée à UiPath, déployée dans Orchestrator, puis utilisée comme interface pour une tâche Action Center.

Le processus comprend les étapes suivantes:

1. Définition de la logique de l'application d'actions dans un environnement de développement intégré.
2. Mise en place d'une connexion sécurisée à UiPath.
3. Déploiement de l'application d'action sur Orchestrator.
4. Utilisation de l'application d'action comme interface utilisateur pour les tâches Action Center. Une application d'action codée peut servir d'interface pour les tâches créées à partir de toutes les fenêtres, y compris les agents, les processus RPA et les processus Maestro.

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 --type Action, 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.

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 .
• Autorisation de publier des packages et de déployer des applications dans le dossier Orchestrator que vous ciblez.

Selon ce qu'elle fait, une application d'action peut également avoir besoin d'un ID d'application externe:

Si votre application Action	ID d’application externe requis
Lit et termine la tâche uniquement	Non (No)
Appelle également d'autres services UiPath, tels que Orchestrator ou Data Fabric	Oui (Yes)

Lorsqu’un ID d’application externe est requis, il doit provenir d’une application externe enregistrée dans votre organisation. Une application d'action s'exécute dans le navigateur et ne peut pas stocker de secret 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.

Créer l’application Action

Une application d'action codée s'exécute dans un cadre en sandbox rendu par Action Center, de sorte qu'elle ne peut pas lire ou écrire directement des données de tâche. Le SDK d'application d'action codée UiPath comble cet écart, en donnant à l'application quatre choses à faire:

• Recevoir la tâche et ses données lorsque l’application se charge.
• Avertissez Action Center lorsque l'utilisateur modifie le formulaire, afin qu'il puisse activer le bouton Enregistrer .
• Terminez la tâche avec l'action choisie par l'utilisateur et les données finales.
• Affichez les messages destinés à l’utilisateur dans Action Center.

Au-delà de ces quatre, UiPath ajoute deux éléments de configuration unique à un projet Web autrement normal:

• Une connexion à votre organisation. Un petit fichier de configuration à la racine du projet identifie votre organisation, votre locataire et l’ID d’application externe, lorsqu’il est nécessaire.
• 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.

Pour la configuration complète du développeur, y compris les méthodes SDK, 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 la documentation du SDK App d'Action codée .

Testez l’application Action localement

Action Center offre une expérience de simulation de tâches pour les Apps d'actions codées qui s'exécutent sur localhost. Deux éléments de configuration sont nécessaires côté UiPath pour qu'il fonctionne.

Ajouter l’URI de redirection d’Action Center à votre application externe

Ajoutez l'URI de redirection https://<host>/<orgId>/<tenantId>/actions_ à l'application externe utilisée par votre application d'action, où <host> est l'environnement auquel vous vous connectez, par exemple cloud.uipath.com

<orgId> et <tenantId> sont les GUID et non les noms d'organisation et de locataire affichés dans la barre d'adresse du navigateur. Une entrée manquante ou qui utilise des noms au lieu de GUID échoue avec invalid_request ou Invalid redirect_uri.

Pour récupérer les deux GUID, connectez-vous avec uip login, puis exécutez:

uip login status --output json

La réponse les renvoie sous la forme OrganizationId et TenantId.

Cette entrée est normalement ajoutée la première fois qu’une application d’action codée qui utilise l’application externe est déployée. Pour lire la valeur exacte envoyée par votre application, ouvrez l'application et copiez redirect_uri à partir de la requête /identity_/connect/authorize dans l'onglet réseau de votre navigateur.

Ouvrir la page de débogage d’Action Center

1. Accédez à https://<host>/<orgName>/<tenantName>/actions_/debug/coded-action-app. Cette page adresse votre organisation et votre locataire par nom, contrairement à l'URI de redirection.
2. Saisissez les détails de votre application, puis chargez-la.

Déployer l'application Action

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

Empaqueter et publier l'application d'action

Une application d'action codée est publiée dans Orchestrator sous forme de package .nupkg , le même format de package utilisé pour les automatisations. Il est publié avec --type Action, qui l'enregistre afin qu'il puisse être sélectionné comme interface utilisateur pour une tâche Action Center.

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 en tant qu'application d'action, dans un flux de locataire ou dans un flux d'espace de travail personnel:

   uip codedapp publish --type Action
   

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 Action à partir d'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 d’action depuis 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 Action depuis Studio Web

Si l'application d'actions 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 d'action 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.

Après le déploiement, l'application d'actions est disponible dans Action Center et peut être affectée comme interface pour une tâche.