Réutiliser les Objets et les Bibliothèques d’IU

Commencer depuis une bibliothèque d'interface utilisateur

Si vous savez que vos applications internes seront automatisées plusieurs fois, nous vous recommandons alors de créer vos éléments d'IU partageables directement dans les bibliothèques. Si vous en décidez autrement, vous pouvez les extraire de vos processus existants.

Lorsque vous créez une bibliothèque d'interface utilisateur, créez d'abord un processus de bibliothèque simple. Pour capturer les éléments de votre application, suivez les étapes décrites dans Création d'un référentiel d'objets.

Extraire en tant que projet de bibliothèque d'IU

Le référentiel local du projet peut être extrait dans un projet de bibliothèque d'interface utilisateur. Cela permet de publier la bibliothèque et de réutiliser ses éléments en l'ajoutant en tant que dépendance à votre processus. Cliquez sur l'icône Extraire en tant que projet de bibliothèque d'interface utilisateur dans l'onglet Descripteurs et nommez votre bibliothèque dans la fenêtre Nouvelle bibliothèque d'IU.

Cliquez sur Créer et les descripteurs sont extraits.

Cliquez Oui pour fermer le projet en cours et ouvrir les descripteurs extraits dans un projet de bibliothèque, ou sur Non pour revenir au workflow actuel.

Après avoir ouvert la bibliothèque d’IU extraite, vous pouvez la publier et l’utiliser dans d’autres workflows.

Publier une bibliothèque d'IU

Lorsque vous publiez une bibliothèque d’IU, un package .nupkg est créé et peut être installé dans un autre projet en tant que dépendance et ses descripteurs peuvent être utilisés en tant que sélecteurs dans d’autres activités. Ces packages peuvent être publiés dans Orchestrator et partagés au sein de votre organisation.

Vous pouvez publier l’ensemble du flux de travail avec sa bibliothèque d’IU ou la bibliothèque d’IU extraite.

La publication de l’ensemble du workflow ou de la bibliothèque d’IU extraite se fait de la même manière que pour tout autre processus. En savoir plus sur la publication de projets.

Charger les bibliothèques d’IU dans les projets

Créez un processus dans Studio. À partir de la fenêtre Gérer les packages (Manage Packages), accédez au flux où vous avez publié votre bibliothèque d’IU et installez-la dans votre projet actuel, comme vous le feriez pour un package d’activités. La bibliothèque d’IU est ajoutée à votre projet en tant que dépendance et ses descripteurs sont visibles dans le panneau Référentiel d’objets (Object Repository), sous Bibliothèques d’IU (UI Librairies). Notez qu’une bibliothèque d’IU peut contenir une seule version d’un descripteur d’IU et une seule version d’une application.

Les descripteurs dans la section Bibliothèques d'IU peuvent également être ajoutés au projet local. Pour ce faire, faites un clic droit sur le nom de l’application et choisissez Ajouter aux objets d’IU.

Lorsque vous devez utiliser un Écran ou un Élément d'IU depuis le panneau Descripteurs (Descriptors) du projet ou de la section Bibliothèques d'IU (UI Librairies), il vous suffit de procéder à un glisser-déposer sur une activité qui prend en charge le Référentiel d'objets (Object Repository). L'activité choisit automatiquement le descripteur.

Remarque : la version de la bibliothèque d'IU n'est pas incrémentée dans la fenêtre Publier (Publish). Lors de la publication d'une nouvelle version de la même bibliothèque d'interface utilisateur, assurez-vous d'ajouter correctement le nouveau numéro de version.

Mettre à niveau les Sélecteurs d’application et de processus

À l’aide des bibliothèques d’IU, vous pouvez mettre à jour les sélecteurs d'un processus en une seule fois chaque fois que l’application que vous automatisez reçoit une nouvelle IU, comme cela se produit parfois avec les applications de bureau ou les sites Web.

À l’intérieur d’un projet de bibliothèque, créez la première version du référentiel d’objets, une bibliothèque contenant les éléments d’une application. Une fois terminé, publiez la bibliothèque.
Utilisez les objets à l’intérieur des activités comme éléments d'un processus en installant la bibliothèque en tant que dépendance.
Dans la bibliothèque initiale, mettez à jour le descripteur de chaque écran ou élément avec la nouvelle IU de l’application. Il est important de ne pas supprimer les éléments, mais plutôt de mettre à jour leurs sélecteurs afin de préserver le lien entre l’élément et la sélection.
Publiez la bibliothèque sous une version supérieure et installez-la dans le processus initial.
Les descripteurs sont automatiquement mis à jour à l’intérieur des activités.

Enregistrer dans le référentiel d’objets

Lorsqu’un référentiel d’objets est créé, les métadonnées associées aux descripteurs sont mappées dans le panneau Projet (Project) en tant qu'éléments du projet en cours, qu’il s’agisse d’un processus ou d’une bibliothèque d’IU.

Lors de la gestion des versions du projet, le référentiel d'objets est également ajouté au référentiel TFS, SVN ou GIT avec les autres fichiers du projet. Vous pouvez ajouter de nouveaux descripteurs au référentiel, puis archiver les modifications comme vous le feriez avec d'autres projets. En savoir plus À propos du contrôle de version dans Studio.

Après avoir ajouté un nouveau descripteur, cliquez avec le bouton droit sur le dossier Objects dans le panneau Projet (Project) et sélectionnez Enregistrement (Check In) ; la fenêtre Enregistrer les modifications (Check in Changes) s’ouvre, affichant la même hiérarchie d’éléments que dans le Référentiel d’objets (Object Repository).

Ajouter aux extraits de code

Les extraits peuvent stocker des applications à des fins de test. L'ensemble du référentiel d'objets local d'un projet peut être ajouté au panneau Extraits afin d'être utilisé ultérieurement dans d'autres projets locaux, qu'il s'agisse de processus ou de bibliothèques. Cliquez avec le bouton droit sur l'application et sélectionnez Ajouter aux extraits. Les applications sont ajoutées de pair avec les écrans enfants et les éléments de l'interface utilisateur.

À partir du panneau Extraits, vous pouvez modifier et ajouter des descripteurs à votre projet via l’option de menu contextuel disponible dans le menu version de l’application. L’ajout d’écrans et d’éléments d’IU à votre projet peut se faire via le même menu contextuel disponible pour chacun des éléments.

La fonctionnalité de glisser-déposer d'éléments depuis le panneau Extraits n'est pas prise en charge. Le référencement d'éléments depuis le panneau Extraits n'est pas non plus pris en charge. Ce panneau constitue une fonctionnalité de test qui permet uniquement d'enregistrer des éléments sur votre disque. À partir de là, des éléments peuvent être ajoutés à votre référentiel local et vice-versa. Par conséquent, toute ressource ajoutée, qu'il s'agisse d'un descripteur, d'un écran, d'une version d'une application ou d'une application entière peut être supprimée du panneau Extraits sans affecter l'existence de cette ressource dans d'autres domaines du projet, tels que le panneau Référentiel d'objets.

Le panneau Extraits joue le rôle d'un référentiel d'objets personnels « sur disque » pouvant contenir des éléments de n'importe lequel de vos projets locaux et les rendre disponibles pour d'autres projets. En outre, étant donné qu'Extraits n'est jamais impliqué dans le référencement d'éléments ou l'exécution du runtime, vous pouvez stocker ici plusieurs versions de la même application. Pour créer plusieurs versions d'une application, cliquez avec le bouton droit sur l'application, choisissez Créer une version, puis copiez les éléments de la version précédente pour assurer l'unicité des éléments entre les versions.

Remplissez les détails de la nouvelle version dans la boîte de dialogue Nouvelle version d’application dans les extraits, puis cliquez sur Créer la version.

Remarque : les référentiels d'objets ne peuvent pas être publiés depuis le panneau Extraits (Snippets), car ils ne jouent aucun rôle dans le référencement à l'intérieur des projets ou lors de l'exécution.

Copier-coller des objets

Vous pouvez copier la structure de l’arborescence entière vers et depuis le Référentiel d’objets (Object Repository), le panneau Extraits (Snippets) ou entre les instances Studio, à l’aide de l'option Copier l’arborescence (Copy Tree) disponible en cliquant avec le bouton droit dans le Référentiel d’objets et le panneau Extraits.

De plus, l’option Copier (Copy) ou la combinaison des raccourcis clavier Ctrl + C et Ctrl + V vous permet de copier des éléments individuels depuis le référentiel et de les coller dans les emplacements mentionnés ci-dessus.

Rechercher des références

En utilisant l'option Trouver des références, vous pouvez vérifier si l’élément d’IU ou le descripteur d’IU de votre bibliothèque est utilisé tout au long du projet.

Pour ce faire, faites un clic droit sur un élément d’IU dans l’onglet Descripteurs à partir de l’un des panneaux de l'explorateur d’objets (descripteurs d’IU de projet, bibliothèques d’IU ou extraits - descripteurs d’IU) et sélectionnez Trouver des références. Les résultats sont affichés dans le panneau Trouver des références. Faites un double clic sur un résultat pour vous concentrer sur l’activité qui utilise l’élément d'IU.