À propos de la publication de projets d'automatisation

La publication (Publishing) d'un projet d'automatisation implique l'archivage du dossier du fichier pour qu'il puisse être envoyé aux robots, puis exécuté.

By default, all the files in the project folder are published except for test cases. If you want to prevent a specific file from being included in the published package, right-click it in the Explorer panel, and then select Ignore from Publish (not available for workflow files in library projects). In the case of libraries, to prevent a workflow file from appearing as a reusable component in the Activities panel when the published library is installed in a project, right-click it in the Explorer panel, and then select Make Private.

Vous pouvez publier des projets d'automatisation dans Orchestrator, dans un flux NuGet personnalisé ou localement. Après la publication sur Orchestrator, le projet archivé s'affiche sur la page Packages et vous pouvez créer un processus à distribuer aux Robots. Lorsque vous publiez un processus d'automatisation dans l'espace de travail personnel d'Orchestrator ou que vous publiez des cas de test, un processus est automatiquement créé s'il n'en existe pas déjà, et les processus existants sont automatiquement mis à jour vers la dernière version publiée.

En outre, il est possible de publier des projets d'automatisation dans un flux NuGet personnalisé, avec la possibilité d'ajouter également une clé API si le flux requiert l'authentification.

La publication des projets localement requiert que vous indiquiez un chemin d'accès sur la machine locale, différente de l'emplacement de publication des paquets de processus. De là, vous pouvez manuellement envoyer les paquets aux Robots, afin qu'ils puissent être exécutés. L'emplacement de publication local par défaut est %ProgramData%\UiPath\Packages.

Pour publier un projet, les fichiers project.json et design.json du dossier du projet ne doivent pas se trouver dans un emplacement en lecture seule (par exemple, si le projet est sous contrôle de code source, les fichiers doivent être extraits pour être modifiés).

Vous pouvez publier des projets depuis Studio ou depuis la ligne de commande. Pour mettre à jour les dépendances de plusieurs projets et les publier toutes en même temps, utilisez l'Outil de mise à jour groupée des dépendances de projets.

Remarque : d’autres applications logicielles peuvent interférer avec le processus de publication si les dossiers commençant par un point (.) sont masqués et donc ignorés lors de la publication.

Publication de projets depuis Studio

Pour publier un projet, sélectionnez Publier dans le menu de l'onglet Design de Studio.

Instructions pour publier un projet d'automatisation :

1. Dans Studio, créez un projet.
2. Dans l’onglet Conception, cliquez sur Publier. La fenêtre Publier s’ouvre. Notez que la barre de titre de la fenêtre change en fonction du contexte :
   • Publier le processus lors de la publication d’un processus;
   • Publier la bibliothèque lors de la publication d’un projet de bibliothèque;
   • Publier la bibliothèque d'IU lors de la publication d’un projet de bibliothèque d'IU;
   • Publier les cas de test lors de la publication de cas de test.
   • Modèles de publication lors de la publication de modèles.
3. Dans l'onglet Propriétés du package :
   • Entrez le nom du package. La liste déroulante contient jusqu’à 5 des noms les plus récents de packages que vous avez précédemment publiés.
   • Dans la section Version, passez en revue la version actuelle de votre projet et tapez une nouvelle version si nécessaire. Cochez la case Est une version préliminaire pour marquer la version comme alpha. Veuillez noter que cela modifie automatiquement le schéma de version du projet en schéma sémantique. Quand vous publiez une nouvelle version du fichier localement, assurez-vous que l’emplacement personnalisé n’inclut pas déjà un fichier avec le même numéro de version proposé. Pour plus de détails sur les versions de projet, consultez la page À propos des projets d’automatisation.
   • En option, utilisez l'option Icône de projet (Project Icon) pour définir une icône personnalisée pour le projet. Vous pouvez parcourir et sélectionner un fichier, ou entrer un chemin d'accès ou une URL publique vers un fichier jpeg, jpg ou png d'une taille pouvant aller jusqu’à 1 Mo.

     Après la publication du projet, l’icône s’affiche comme suit :

     • Pour les processus, dans l’Assistant à côté du nom du processus, ce qui facilite son identification dans la liste des processus.
     • Pour les modèles, à côté du modèle dans Accueil (Home) (mode Backstage de Studio) > Modèles (Templates).

     • Pour les bibliothèques, à côté du paquet dans la fenêtre Gérer les paquets (Manage Packages) dans Studio.

       Remarque : l'icône n'est pas visible dans Gérer les packages si une bibliothèque publiée dans Orchestrator ou un flux qui ne prend pas en charge les icônes intégrées utilise un fichier local. Dans ce cas, spécifiez l'icône à l'aide d'une URL.
   • Dans la section Balises du projet (Project tags), vous pouvez ajouter une ou plusieurs balises au projet, soit en créant de nouvelles balises, soit en réutilisant des balises déjà définies dans Orchestrator. Il existe deux types de balises : libellés et propriétés (paires clé-valeur). Les balises sont incluses dans le package publié et aident à décrire et catégoriser les projets. Par exemple, elles peuvent faire référence à l'application automatisée (libellé Excel) ou au service (propriété clé-valeur department:accounting).
     Lorsque vous commencez à taper, des correspondances possibles sont suggérées à partir de balises déjà définies, et vous pouvez en réutiliser une en la sélectionnant dans la liste des correspondances. Pour une correspondance de propriété, la clé suivie du caractère : (deux points) s'affiche en premier, et les valeurs associées s'affichent une fois que vous avez sélectionné la clé. Pour ajouter une nouvelle balise, après avoir saisi le nom, cliquez sur l'entrée avec le signe plus à côté du nom. La séparation des chaînes par le caractère : (deux points) vous permet d'ajouter des propriétés, tandis que les entrées qui ne contiennent pas de : ajoutent des libellés.
     Les étiquettes et les propriétés clé-valeur sont limitées à 256 caractères. Les noms de balise ne peuvent pas contenir ces caractères : <, >, %, &, \, ?, /, :.

     Les balises de projet peuvent être automatiquement appliquées aux processus dans Orchestrator. Pour plus d'informations sur l'utilisation des balises, consultez la section Organisation des ressources avec des balises (Organizing resources with tags) dans le Guide Orchestrator.

   • Dans la catégorie Notes de publication (Release Notes), entrez les détails sur la version et autres informations pertinentes. Les notes de publication des projets publiés s'affichent dans la section Paquets (Packages) d'Orchestrator. Notez que le champ Notes de publication (Release Notes) accepte un maximum de 10 000 caractères.

     
     

     

     
     
4. Cliquez sur Suivant (Next).

   Si vous publiez un modèle, l’onglet Informations sur le modèle s’ouvre ensuite (étape 5). Sinon, passez à l’étape 6.

5. (Pour les modèles uniquement) Dans l'onglet Informations sur le modèle, fournissez les informations suivantes, puis cliquez sur Suivant :
   • Nom : le nom du modèle.
   • Description - La description du modèle dans l’onglet Modèles.

   • Nom du projet par défaut - Nom du projet par défaut lors de la création d’un nouveau projet à l’aide de ce modèle.

     Remarque : évitez d'utiliser des signes de ponctuation, des caractères de séparation et des caractères non autorisés dans les noms de fichiers. Ces caractères peuvent être supprimés du nom par défaut lorsque le modèle est utilisé.

   • Description de projet par défaut - Description par défaut lors de la création d’un nouveau projet à l'aide de ce modèle.

     
     

     

     
     
6. Dans l’onglet Options de publication, sélectionnez où publier le projet. Les options disponibles dépendent du type de projet que vous publiez :

   • Pour Processus :

     • Flux de processus de locataire Orchestrator, Flux d’espace de travail personnel Orchestrator et, s’il s’agit d’un dossier de premier niveau avec un flux de packages distinct ou si l’un de ses sous-dossiers se trouve dans la barre d’état de Studio, le flux de cette hiérarchie de dossiers. Ces options ne sont pas disponibles si Studio est connecté à Orchestrator. Le flux d’espace de travail personnel Orchestrator est disponible uniquement si votre utilisateur a activé la fonction Espace de travail personnel dans Orchestrator.

       Si l’espace de travail personnel ou un dossier d’une hiérarchie avec un flux de paquet distinct est sélectionné dans Studio, le flux de ce dossier sera l’option par défaut. Dans le cas contraire, le flux locataire sera l’option par défaut. Si vous avez déjà publié un projet dans la session en cours, le dernier emplacement de publication que vous avez utilisé sera la sélection par défaut jusqu'à ce que vous fermiez Studio ou modifiiez le dossier Orchestrator à partir de la barre d'état de Studio.

     • Assistant (Valeurs par défaut du Robot) : l’emplacement du package par défaut du Robot et l’Assistant, C:\ProgramData\UiPath\Packages. Les projets publiés ici apparaissent automatiquement dans l’Assistant. L’option n’est pas disponible si Studio est connecté à Orchestrator.
     • Personnaliser (Custom) - soit une URL de flux NuGet personnalisée, soit un dossier local. L’ajout d’une Clé API (API Key) est facultatif.

   • Pour les cas de test :

     • Les mêmes options sont disponibles pour les processus, à l’exception du flux d’espace de travail personnel Orchestrator.

   • Pour les bibliothèques et les bibliothèques d'UI :

     • Le flux de bibliothèques de locataires Orchestrator ou le flux de bibliothèques partagées Orchestrator : Disponibles si Studio est connecté à Orchestrator. L’option disponible dépend de l'activation dans Orchestrator du flux de bibliothèques de locataires.
     • Personnaliser (Custom) - soit une URL de flux NuGet personnalisée, soit un dossier local. L’ajout d’une Clé API (API Key) est facultatif.

   • Pour les modèles :

     • Le flux de bibliothèques de locataires Orchestrator ou le flux de bibliothèques partagées Orchestrator : Disponibles si Studio est connecté à Orchestrator. L’option disponible dépend de l'activation dans Orchestrator du flux de bibliothèques de locataires.
     • Local (Local) : l’emplacement par défaut de publication locale de modèles : C:\Users\User\Documents\UiPath\.templates.

     • Personnaliser (Custom) - soit une URL de flux NuGet personnalisée, soit un dossier local. L’ajout d’une Clé API (API Key) est facultatif.

   Lorsque vous publiez une bibliothèque ou tout projet avec la compatibilité Windows ou multiplateforme à l'exception des modèles, des paramètres supplémentaires sont disponibles dans l'onglet Options de publication (Publish options) sous Paramètres de compilation (Compilation Settings) :

   • (Pour les bibliothèques uniquement) Catégorie racine des activités : saisissez un nom pour la catégorie sous laquelle le composant réutilisable sera répertorié dans le panneau Activités.
   • (Pour les bibliothèques héritées depuis Windows uniquement) Compiler les expressions des activités (Compile activities expressions - sélectionnez cette option pour compiler et empaqueter toutes les expressions d'activités. Vous réduisez ainsi le temps d'exécution.

   • (Pour les bibliothèques héritées depuis Windows uniquement) Prêt à être exécuté (Ready to Run) - sélectionnez cette option pour optimiser les assemblys générés afin de bénéficier d'une compilation JIT plus rapide au moment de l'exécution.

     Remarque : pour découvrir les facteurs susceptibles d'empêcher la publication d'une bibliothèque, lisez les limitations lors de la publication de bibliothèques.
     
     

     

     
     
7. Cliquez sur Suivant pour accéder à l'onglet signature du certificat , ou Publier pour publier votre projet.
8. (Facultatif) Dans l'onglet Signature du certificat, ajoutez un chemin d'accès local au certificat à côté de la case Certificat. De plus, ajoutez le mot de passe du certificat et un horodateur de certificat facultatif si nécessaire. Pour en savoir plus, consultez la page Signature de packages.
   
   

   

   
   

   Remarque : actuellement, les extensions de certificat .pfx et .p12 sont acceptées pour la signature des projets.
9. Cliquez sur Publier (Publish). Un fichier NUPKG est créé et téléchargé vers Orchestrator, vers le flux NuGet personnalisé ou enregistré dans le répertoire local. Pour les bibliothèques, si l'option Séparer les dépendances du runtime (Separate Runtime Dependencies) de Paramètres du projet (Project Settings) est activée, deux fichiers NUPKG sont créés : un fichier est le package de phase de conception utilisé dans Studio et l'autre est le package de runtime utilisé par le Robot lors de l'exécution de l'automatisation. Selon le projet, le package contient :
   • Pour les projets et processus modèles avec la compatibilité Windows - Héritage (Windows - Legacy), les fichiers source du projet.
   • Pour les bibliothèques et les projets avec la compatibilité Windows ou multiplateforme, les fichiers DLL compilés.
10. Si le projet est publié correctement, la boîte de dialogue Info s'affiche, et le projet est copié dans l'emplacement NuGet défini dans le paramètre NuGetServerUrl, dans le fichier UiPath.settings.

La boîte de dialogue Info affiche les éléments suivants :

• Le nom sous lequel le paquet a été publié.
• Le numéro de version sous lequel le paquet a été publié ;
• L’emplacement où le projet a été publié si le projet a été publié localement ou dans l'emplacement par défaut du robot. Cliquez sur le chemin pour accéder au package, sauf si l’emplacement de publication était Orchestrator.
• Option Détails (Details) qui développe une liste contenant le nom des fichiers projet publiés.

• L'option Copier dans le Presse-papiers (Copy to Clipboard).

  
  

  

  
  

Les informations ajoutées lors de la publication, comme l’emplacement de publication, restent dans la fenêtre, de sorte qu’elles peuvent être utilisées pour des actions de publication ultérieures effectuées pour le même type de projet. Chaque fois que vous cliquez sur Publier, une nouvelle version du projet est créée et envoyée au flux de packages. La publication d’un flux sécurisé peut être authentifiée soit via la clé de Robot, les informations d’identification Orchestrator, l’authentification Windows ou la clé d'API.

Attention : les projets publiés ne doivent pas être décompressés. Pour apporter des modifications, veuillez ouvrir le fichier .xaml initial dans Studio, effectuer les modifications, puis publier à nouveau le projet.

Publication de projets depuis la ligne de commande

Publiez des projets à l'aide de la commande de publication UiPath.Studio.CommandLine.exe.

UiPath.Studio.CommandLine.exe est disponible dans le dossier d'installation :

• Pour les installations par machine, le chemin d'accès par défaut est C:\Program Files\UiPath\Studio\.
• Pour les installations par utilisateur, le chemin d'accès par défaut est %localappdata%\Programs\UiPath\Studio\.

Les arguments suivants sont disponibles pour la commande de publication :

Argument	Description
-p, --project-path	Chemin d'accès au fichier project.json à publier. L'argument est obligatoire.
-g, --target	Où publier le projet : Personnalisé (Custom) : URL personnalisée ou dossier local. Définissez l'emplacement à l'aide de l'argument -f, --feed. Robot : emplacement de publication par défaut du Robot, s’il n’est pas connecté à Orchestrator. Non disponible pour la publication de bibliothèques ou de modèles. Locataire Orchestrator : Flux de processus de locataire Orchestrator (pour les processus et les cas de test) ou flux de bibliothèques Orchestrator (pour les bibliothèques et les modèles). OrchestratorPersonalFolder : Flux personnel WorkSpace Orchestrator. Non disponible pour la publication de bibliothèques, de modèles ou de cas de test. OrchestratorFolderHierarchy : si un dossier de premier niveau avec un flux de packages distinct ou si l’un de ses sous-dossiers se trouve dans la barre d’état de Studio, le flux de cette hiérarchie de dossiers. Non disponible pour la publication de bibliothèques ou de modèles.
-f, --feed	L'URL personnalisée pour la publication du projet. Cela peut également être un répertoire local distant, semblable au chemin d'accès de l'onglet Options de publication (Publish options) dans Studio.
-a, --api-key	La clé API pour la publication du projet. Cet argument peut être utilisé pour une cible personnalisée.
-i, --icon	Chemin d'accès à l'icône personnalisée à utiliser pour le package.
-n, --notes	Notes de publication qui contiennent des modifications apportées au projet.
-v, --new-version	La nouvelle version du projet. Si elle n'est pas fournie, la version est automatiquement incrémentée.
-t, --timeout	Spécifie la valeur du délai d'expiration pour la publication des projets. Le délai d'expiration par défaut est de 30 secondes. Ce paramètre s'applique uniquement au transfert de paquets vers une durée d'Orchestrator.
--cer-path	Chemin d'accès local au certificat pour la signature de paquets.
--cer-password	Mot de passe du certificat.
--timestamper-url	URL de l'horodateur.
--incl-all-feeds	Non requis.
--help	Affiche les arguments disponibles pour chaque commande.
--version	Vérifiez la version de UiPath.Studio.CommandLine.exe.

Par exemple :

• La commande suivante publie l'exemple de processus dans le flux de processus des locataires Orchestrator :

  UiPath.Studio.CommandLine.exe publish --project-path "C:\Users\username\Documents\UiPath\Sample\project.json" --target OrchestratorTenant --notes "Fixed a couple of bugs."

• La commande suivante publie le même processus dans un dossier local :

  UiPath.Studio.CommandLine.exe publish --project-path "C:\Users\username\Documents\UiPath\Sample\project.json" --target Custom --feed "C:\Users\username\Desktop\myfeed" --notes "Fixed a couple of bugs."

Pour plus d'informations sur l'utilitaire CommandLine.exe, consultez Paramètres de la ligne de commande de la mise à jour groupée.