Orchestrator - Gestion des packages

Téléchargement d'une version de paquet

Sur la page Paquets (Packages), cliquez sur Afficher les versions (View Versions). La fenêtre Versions de paquets (Package Versions) s'affiche.
Cliquez sur Autres actions (More Actions) > Télécharger le package (Download package) pour la version de package correspondante à télécharger. Le package est téléchargé vers l'emplacement par défaut configuré dans votre navigateur, au format .nupkg. Depuis cet emplacement, vous pouvez le télécharger vers une autre instance d'Orchestrator.

Remarque : Le bouton Télécharger (Download) n'est activé que si vous utilisez un flux local, et que vous disposez des autorisations de Consultation (View) des paquets.

Téléchargement manuel de paquets dans Orchestrator

Remarque :

Pour télécharger manuellement un package avec des balises, vous devez disposer de l’autorisation Création (Create) par rapport aux balises. Si vous ne disposez pas de l’autorisation Création (Create) par rapport aux balises, le package est téléchargé sans balises.

Sur la page Packages, cliquez sur le bouton Télécharger (Upload) . La fenêtre Ajouter un package (Add Package) s'affiche.
Cliquez sur Parcourir (Browse) et sélectionnez les packages (ayant l'extension .nupkg) à télécharger dans Orchestrator.
Sélectionnez J'aimerais voir quels processus peuvent être mis à niveau (I would like to see which processes can be upgraded) pour afficher tous les processus qui utilisent une version précédente du package en cours de téléchargement.
Cliquez sur Télécharger (Upload). Le paquet est téléchargé sur Orchestrator, et il est affiché sur la page Packages. Si vous avez sélectionné l'option Jʹaimerais voir quels processus peuvent être mis à niveau (I would like to see which processes can be upgraded), la fenêtre Mettre à niveau plusieurs processus (Upgrade multiple processes) apparaît à l'écran, affichant une liste des processus qui peuvent être mis à niveau vers une version de paquet plus récente.
Utilisez les cases à cocher pour sélectionner les processus à mettre à niveau et cliquez sur Mettre à niveau ( Upgrade). Les processus sélectionnés sont mis à jour vers la nouvelle version de package et la fenêtre se ferme. Seule la version du package est mise à jour. Si vous souhaitez personnaliser les paramètres de processus ou les points d'entrée, modifiez le processus.

Suppression des paquets

Un paquet ne peut être supprimé d’Orchestrator que si toutes ses versions ont été supprimées. Les versions de paquet peuvent être supprimées lorsqu'elles sont inactives, c’est-à-dire qu'elles ne sont pas déployées dans un processus.

Sur la page Paquets (Packages), cliquez sur Afficher les versions (View Versions). La fenêtre Versions de paquets (Package Versions) s'affiche.
Sélectionnez une ou plusieurs versions et cliquez sur Supprimer (Remove). Vous pouvez également cliquer sur Plus d'actions (More actions) > Supprimer (Delete) pour la version du package que vous souhaitez supprimer. Les versions de package sélectionnées sont supprimées.
Cliquez sur Supprimer toutes les versions inactives (Remove All Inactive) pour supprimer toutes les versions inactives du processus sélectionné. Si une version de paquet fait partie d'un processus (elle est active), elle ne sera PAS supprimée. Si toutes les versions sont inactives, elles sont toutes supprimées.

Affichage des notes de publication d'une version de paquet

Sur la page Bibliothèques (Libraries), cliquez sur Afficher les versions (View Versions). La fenêtre Versions de paquets (Package Versions) s'affiche.
Dans l'onglet Versions (Versions), vous pouvez voir toutes les versions de paquets de la bibliothèque affichée.
Pour la version souhaitée, cliquez sur Autres actions (More Actions) > Afficher les notes de publication (Show Release Notes). La fenêtre Notes de publication (Release Notes) s'affiche, permettant ainsi de voir la note ajoutée dans Studio pour la version correspondante.

De plus, vous pouvez voir la note ajoutée dans Studio, ainsi que les applications Windows utilisées par la version de package correspondante du package, affichées par ordre alphabétique. Si le package utilise des applications qui ne peuvent pas être identifiées, une entrée Applications inconnues (Unknown apps) s'affiche, suffixée par le nombre d'applications non identifiées entre parenthèses. Si aucune application ne peut être récupérée, un message Aucune application n'a pu être récupérée pour ce package (No app(s) could be retrieved for this package) s'affiche. Cela est très probablement dû à l'une des raisons suivantes :

Votre version de Studio est antérieure à 2023.2.
Votre version Studio est 2023.2, mais une règle de gouvernance est en place, ce qui empêche les informations d'être journalisées.
Votre package a été téléchargé à partir d'un flux externe. Seuls les packages provenant de flux internes peuvent fournir ces informations.
Le package n'utilise aucune application.

Ces détails sont également affichés dans la fenêtre de processus du package sous-jacent.

Notez que vous avez également la possibilité de télécharger manuellement les versions de paquets dans la fenêtre Notes de publication (Release Notes). Ce processus est semblable à leur téléchargement dans l'onglet Versions (Versions).

Affichage des notes de publication de toutes les versions de paquets

Sur la page Paquets (Packages), cliquez sur Afficher les versions (View Versions). La fenêtre Versions de paquets (Package Versions) s'affiche.
Cliquez sur l'onglet Journal des modifications (Change Log). Vous pouvez voir toutes les versions de paquets de la bibliothèque, et pour chacune d'entre elles, la note de publication correspondante contenant des informations liées aux éléments modifiés d'une version à l'autre.

Notez que vous avez la possibilité de télécharger manuellement les versions de paquets dans la fenêtre Journal des modifications (Change Log). Ce processus est semblable à leur téléchargement dans l'onglet Versions (Versions).

Affichage des arguments d'un paquet

Sur la page Paquets (Packages), cliquez sur Afficher les versions (View Versions). La fenêtre Versions de paquets (Package Versions) s'affiche.
Cliquez sur Autres actions (More Actions) > Afficher les arguments (Show Arguments) pour obtenir la version souhaitée du package. Les paramètres d'entrée et de sortie de la version souhaitée du package sont affichés. Gérer les processus Gérer les tâches Gérer les déclencheursNotez que vous ne pouvez pas modifier les valeurs des paramètres à ce niveau, seulement au niveau des processus, des tâches et des déclencheurs.

Ajout de balises aux packages

Vous pouvez appliquer des balises à un package au moment de la conception dans Studio. Pour savoir comment ajouter des balises aux packages, consultez À propos de la publication de projets d'automatisation (About Publishing Automation Projects) dans le guide de Studio.

Vous ne pouvez pas modifier les balises d'un package depuis Orchestrator. Les balises sont spécifiques à chaque version de package. Sur la page Packages d'Orchestrator, vous pouvez voir les balises spécifiques à la dernière version du package, qu'elle soit active ou inactive.

Suppression de balises des packages

Vous pouvez supprimer des balises d'un package au moment de la conception dans Studio. Pour savoir comment supprimer des balises des packages, consultez À propos de la publication de projets d'automatisation (About Publishing Automation Projects) dans le guide de Studio.

Vous ne pouvez pas modifier les balises d'un package depuis Orchestrator. Les balises sont spécifiques à chaque version de package. Sur la page Packages d'Orchestrator, vous pouvez voir les balises spécifiques à la dernière version du package, qu'elle soit active ou inactive.

Exploration de paquets

Vous pouvez afficher et explorer la représentation graphique de tout fichier .xaml qui fait partie d'une version de package similaire à celle du panneau Concepteur (Designer) de Studio. Cette fonctionnalité permet une coopération plus fluide entre les développeurs et les gestionnaires d'Orchestrator.

Remarque :

Vous ne pouvez pas explorer les packages compilés à l'aide de cette fonctionnalité.

En savoir plus sur les projets d'automatisation dans le guide de Studio.

Sur la page Paquets (Packages), cliquez sur Explorer le paquet (Explore Package) en regard d'un paquet. La fenêtre Explorer le paquet (Explore Package) s'affiche, dans laquelle vous avez accès à toutes les versions du paquet sélectionné.
Cliquez sur une version à propos de laquelle vous voulez en savoir plus. Tous les fichiers .xaml disponibles dans le projet s'affichent, avec l'auteur du projet, la description, et sa date de téléchargement dans Orchestrator. Le fichier .xaml qui a été défini comme Principal dans Studio est marqué ici en conséquence, et les dépendances du projet s'affichent sous la section Dépendances (Dependencies).
Cliquez sur un fichier .xaml. Le workflow s'affiche.
Pour afficher toutes les variables, arguments ou importations disponibles dans le fichier sélectionné, cliquez sur le bouton Variables (Variables), Arguments (Arguments) ou Importations (Imports). Le panneau correspondant s'affiche, semblable à celui disponible dans Studio.
Double-cliquez sur toute étendue pour afficher une vue ciblée du workflow.
Cliquez sur Tout développer (Expand All) pour obtenir un meilleur affichage d'une section de workflow.
Cliquez sur toute activité pour afficher ses propriétés. Notez que vous pouvez également copier la valeur de n'importe quelle propriété.

Des détails sont disponibles sur chacun des champs, boutons et panneaux sur la page Description des champs.

Comparaison des packages et des workflows

Vous pouvez afficher les différences entre deux versions sélectionnées d'un package afin de visualiser les modifications : fichiers .xaml ajoutés, modifiés ou supprimés, modifications apportées aux dossiers ou à la liste des dépendances. Vous pouvez également comparer les fichiers .xaml des deux versions de workflow sélectionnées, présentées côte à côte de manière graphique. Cette fonctionnalité permet aux gestionnaires Orchestrator de visualiser les modifications apportées aux packages et workflows sans avoir à accéder à Studio.

Voici comment visualiser les différences au niveau de la version de package, puis au niveau du fichier de workflow :

Lisez la suite pour obtenir des instructions pas à pas :

Sur la page Packages, cliquez sur Explorer le package (Explore Package) en regard d'un package. La fenêtre Explorer le package (Explore Package) s'affiche, dans laquelle vous accédez à toutes les versions du package sélectionné.
Cliquez sur le bouton Comparer (Compare) au-dessus de la liste des versions de package pour activer/désactiver le mode de comparaison. Une case à cocher apparaît devant chaque version de package.
Cochez les cases correspondant aux versions de package que vous souhaitez comparer. Vous ne pouvez comparer que deux versions de package à la fois.

Vous pouvez sinon comparer le même fichier .xaml correspondant à deux versions de package. Pour ce faire, développez un package à la fois et sélectionnez le fichier de workflow.
Cliquez sur le bouton Comparer (Compare) en-dessous de la liste des versions de package. Ce bouton est activé une fois que vous avez coché deux cases. La fenêtre Comparaison (Comparing) s'affiche, contenant une liste de résultats avec les fichiers de workflow de la version la plus récente sélectionnée, l'auteur du projet et sa description. Le fichier de workflow défini comme Principal (Main) dans Studio est signalé ici en conséquence, et les dépendances du projet s'affichent sous la section Dépendances (Dependencies).

Si vous choisissez de comparer des fichiers de workflow à l'étape précédente, les deux workflows s'affichent côte à côte, la version de fichier la plus récente à gauche.
Filtrez les différences affichées en sélectionnant l’une des options dans le coin supérieur droit de la fenêtre :
- Tout (All) : affiche toutes les différences entre les versions de package comparées ou les fichiers de workflow. Cette option est sélectionnée par défaut, affichant un résumé de toutes les différences.
- Ajouté (Added) : surligne en vert les fichiers, dossiers ou dépendances qui ont été ajouté(e)s à la version du paquet, ou les conteneurs, connecteurs, et activités qui ont été ajouté(e)s aux fichiers de workflow répertoriés dans la fenêtre Comparaison (Comparing), ainsi que leur nombre exact.
- Modifié (Modified) : surligne en jaune les fichiers, dossiers ou dépendances qui ont été modifié(e)s dans la version du package, ou les conteneurs, connecteurs, activités et propriétés ou valeurs de propriétés qui ont été modifié(e)s dans les fichiers de workflow répertoriés dans la fenêtre Comparaison (Comparing), ainsi que leur nombre exact.
- Supprimé (Deleted) : surligne en rouge les fichiers, dossiers ou dépendances qui ont été supprimé(e)s dans la version du package, ou les conteneurs, connecteurs et activités qui ont été supprimé(e)s dans les fichiers de workflow répertoriés dans la fenêtre Comparaison (Comparing), ainsi que leur nombre exact.
Cliquez sur le bouton Comparer (Compare) en regard d'un fichier de workflow dans la liste des résultats. Les deux workflows s'affichent côte à côte, la version de fichier la plus récente à gauche, chacun disposant de son propre outil de défilement. Toutes les modifications apportées au fichier entre les deux versions de packages au niveau du conteneur, du connecteur ou des activités sont mises en surbrillance et soumises à un code couleur comme suit :
- Contenu ajouté mis en évidence en vert
- Contenu modifié mis en évidence en jaune
- Contenu supprimé mis en évidence en rouge.
  
  Si seules des modifications mineures ont été effectuées au niveau du workflow, telles que le positionnement des activités ou des connecteurs, vous êtes informé que la logique n’a pas été modifiée.
(Pour les conteneurs seulement) Double-cliquez sur une activité de conteneur. La fenêtre Comparaison (Comparing) affiche uniquement l’activité dans les deux versions de package, permettant une vue ciblée. Si l’activité n’existe que dans un seul des fichiers de workflow, elle s'affiche du côté du workflow correspondant. Retournez du conteneur au workflow en cliquant sur la barre de navigation.
Cliquez sur toute activité pour afficher les modifications apportées à ses propriétés. Tous les changements qui se sont produits au niveau de l’activité entre les deux versions de package sont mis en évidence selon un code couleur, comme mentionné précédemment.

Guide de l'utilisateur d'Orchestrator

Gestion des paquets