Création d'une bibliothèque de base

Le didacticiel suivant vous guide à travers les étapes de création d'une bibliothèque dans Studio, de publication et d'utilisation de cette bibliothèque dans d'autres projets d'automatisation.

La création d'une bibliothèque est similaire à la création d'un processus de base. La différence est qu'une bibliothèque est un package contenant des composants réutilisables qui peuvent être utilisés dans le contexte d'autres projets.

Cet exemple extrait des données d'un tableur Excel et les ajoute à un autre fichier Excel. Ensuite, il vous guide à travers les étapes d'empaquetage et de publication du projet dans un flux personnalisé, en installant le paquet dans un autre projet et en utilisant l'activité qu'il contient.

Cet exemple utilise des activités Excel qui ne nécessitent pas l'installation de Microsoft Excel sur votre machine.

Commençons.

Création d'une bibliothèque

1. Launch Studio. In the HOME Backstage view, select Library to create a new library project. The New Blank Library window is displayed.

   

2. Dans la fenêtre « Nouvelle bibliothèque vierge » (New Blank Library) :

   • Entrez le nom du nouveau projet ainsi qu'une description qui résume ce que vous souhaitez faire avec cette automatisation. Pour cet exemple, vous pouvez utiliser le nom QuickLibrary.
     Remarque :

     Le nom du projet ne peut pas dépasser 128 caractères et la description ne peut pas dépasser 500 caractères.

   • Sélectionnez Afficher les options avancées et choisissez l'emplacement où créer le projet.
   • Sélectionnez Windows pour l'option Compatibilité (Compatibility) et VB pour l'option Langage (Language).

3. Select Create. The new library is opened in Studio.

Résultat

The library project is created and opens in Studio, ready for activities to be added.

Ajout d'activités Excel

1. Dans le panneau Activités, recherchez l'activité Étendue du processus Excel et déposez-la dans le panneau Concepteur.

2. Ajoutez une activité Utiliser le fichier Excel à la séquence.Cette activité est requise pour la plupart des activités liées à Excel.

3. Dans le champ Fichier Excel, accédez au fichier Excel à partir duquel vous souhaitez obtenir les données. Vous pouvez en option utiliser le champ Référence comme pour modifier la façon dont ce fichier est référencé tout au long du workflow (Excel1dans cet incident).

4. Ajoutez une deuxième activité Utiliser le fichier Excel à l'intérieur de la première activité Utiliser le fichier Excel et accédez au fichier Excel dans lequel vous souhaitez copier les données. Ajoutez une référence facultative à ce deuxième fichier (Excel2 dans ce cas).

5. Ajoutez une activité Copier/Coller la plage.

6. Dans le champ Source, sélectionnez le bouton Plus pour indiquer le nom de la feuille dans le premier classeur.Dans cet exemple, le champ doit indiquer Excel1.Sheet("Sheet1").

7. Dans le champ « Destination », sélectionnez Plus pour indiquer le nom de la feuille dans le deuxième classeur (Excel2.Sheet("Sheet1")dans notre incident).Votre projet devrait ressembler à l’image ci-dessous.

   

8. In the ribbon, select Run File or use Ctrl + F6 to execute the workflow. The data gathered from the first Excel spreadsheet is copied to another.

Résultat

The data from the first Excel spreadsheet is copied to the second. The workflow runs successfully.

Empaquetage d'une bibliothèque

Pour ajouter cette bibliothèque en tant que composant réutilisable à d'autres projets d'automatisation, vous devez la packager sous forme de fichier .nupkg en publiant le projet.

1. Ouvrez le projet de bibliothèque dans Studio.

2. From the ribbon, select the Publish button. The Publish Library window opens.

   • Dans l'onglet Propriétés du package, saisissez un nom de package. Dans le champ Notes de publication, ajoutez quelques détails sur la bibliothèque. Cela permet de suivre les modifications apportées à la bibliothèque dans chaque nouvelle version publiée.
   • Dans l'onglet Options de publication, sélectionnez Publier vers > Personnalisé, puis, dans le champ URL personnalisée, ajoutez le chemin d'accès à un dossier local. Par exemple, vous pouvez créer un dossier myfeed sur votre bureau.

3. Select Publish. The package is now available in the local folder as a .nupkg file.

   

Résultat

The library is published as a .nupkg file to your custom feed folder and is ready to be installed in other projects.

Installation des composants réutilisables

Pour utiliser le package dans un autre projet, vous devez d'abord l'ajouter en tant que dépendance de projet.Pour commencer, créez un nouveau processus dans Studio, comme expliqué dans la page Création d'un processus de base.

Pour en savoir plus sur les dépendances du projet, consultez la page À propos des dépendances.

Ajout d'un flux personnalisé

1. In the Studio ribbon, select Manage Packages > Settings. The default and user-defined feeds are displayed.

2. Dans le conteneur Sources de paquets définies par l'utilisateur (User defined packages sources), ajoutez un nom pour votre flux dans le champ Nom (Name). Dans le champ Source (Source), ajoutez le chemin d'accès au dossier de publication de votre bibliothèque.

3. Select Add. Your new feed is added to the section.

   

Résultat

The custom feed is added to Studio. It is now available under All Packages when managing package dependencies.

Vous devez suivre les étapes ci-dessus chaque fois que vous souhaitez ajouter ou supprimer un flux défini par l'utilisateur dans Studio. Consultez À propos des packages d'activités pour en savoir plus sur les flux d'activités.

Installation du paquet

1. Dans la fenêtre Gérer les paquets (Manage Packages), accédez au flux ajouté auparavant sous l'onglet Tous les paquets (All Packages) de gauche. La liste des paquets disponibles dans le flux est affichée.

2. Recherchez le paquet et sélectionnez-le. Dans notre exemple, le nom du paquet est QuickLibrary.

3. Select Install, then Save. The package is now installed in your project, and visible in the Explorer panel, under Dependencies.

   

Résultat

The package is installed as a dependency in your project. Its activities are available in the Activities panel.

Ajout d'activités à partir de la bibliothèque

1. Dans le panneau Activités (Activities), recherchez le nom du paquet, dans notre cas Quick Library.

2. Déposez l'activité dans le panneau Concepteur (Designer).

3. In the Studio ribbon, select Run File or use Ctrl + F6 to execute the activity.

   

Résultat

The library activity runs successfully in the project. The reusable component is ready to use in any project where the package is installed.

Vous pouvez ajouter d'autres activités telles que Copier une feuille ou Plage de remplissage automatique, mais celles-ci nécessitent l'installation de Microsoft Excel sur votre machine.

L'avantage des composants réutilisables est qu'ils réduisent la répétition. Vous les créez une fois et les réutilisez dans d'autres projets.

Pour télécharger la bibliothèque que nous avons créée ci-dessus, cliquez sur le bouton ci-dessous :

Téléchargez l'exemple