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 sa publication et de son utilisation dans d'autres projets d'automatisation.

Creating a library is similar to Creating a Basic Process. The difference is packages are for creating reusable components to be used in the context of other projects.

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. Lancez Studio. En mode HOME Backstage, cliquez sur Bibliothèque (Library) pour créer un projet de bibliothèque. La fenêtre Nouvelle bibliothèque vierge (New Blank Library) s'affiche.

   

2. Tapez le nom du projet, utilisez QuickLibrary pour cet exemple. Ajoutez une brève description et choisissez un emplacement.

   Remarque :

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

3. Cliquez sur Créer (Create). La nouvelle bibliothèque est ouverte dans Studio.

Ajout d'activités Excel

1. In the Activities panel, search for the Read Range activity under System > File > Workbook, and drop it to the Designer panel.

   • Dans le champ Chemin du classeur (Workbook path), ajoutez le chemin d'accès au fichier Excel dans lequel vous voulez récupérer les données.
   • Dans le champ Nom de la feuille (Sheet name), ajoutez le nom du tableur. Pour cet exemple, le nom reste la valeur Sheet1 par défaut.
   • Dans le champ Plage (Range), ajoutez la plage des cellules à lire. Pour cet exemple, laissez le champ vide afin de lire toutes les cellules.

2. Dans le panneau Propriétés (Properties) de l'activité Read Range, cliquez sur le champ en regard de DataTable, puis utilisez le raccourci clavier Ctrl + K pour ouvrir le champ de variable, et ajoutez le nom GetRange. La variable de type DataTable stocke les données à partir des cellules de lecture.

   

   

3. In the Activities panel, search for the Append Range activity under System > File > Workbook. Add it below the Read Range activity.

   • Dans le champ Chemin du classeur (Workbook path), ajoutez le chemin d'accès au fichier dans lequel vous voulez ajouter les données copiées.

   • Dans le champ Nom de la feuille (Sheet name), ajoutez le nom de la feuille. Pour cet exemple, laissez la valeur Sheet par défaut.

   • Dans le champ Table de données (Data table), ajoutez la variable créée auparavant GetRange qui stocke les informations. Votre projet doit ressembler à ceci sur l'image ci-dessous.

     

4. Dans le ruban, cliquez sur Exécuter le fichier (Run File) ou utilisez Ctrl + F6 (Ctrl + F6) pour exécuter le workflow. Les données recueillies à partir du premier tableur Excel sont ajoutées à un autre. Elles ne remplacent pas celles qui existent déjà dans le second tableur.

Empaquetage d'une bibliothèque

To add this library as a reusable component to other automation projects, you need to package it as a .nupkg file by publishing the project.

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

2. Dans le ruban, cliquez sur le bouton Publier (Publish). La fenêtre Publier la bibliothèque (Publish Library) s'ouvre.

   • 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. Cliquez sur Publier. Le package est désormais disponible dans le dossier local en tant que fichier .nupkg.

Installation des composants réutilisables

To use the package in another project, you first need to add it as a project dependency. To get started, create a new Process in Studio, as explained in the Creating a Basic Process page.

Read more about project dependencies in the About Dependencies page.

Ajout d'un flux personnalisé

1. Dans le ruban de Studio, cliquez sur Gérer les paquets (Manage Packages) > Paramètres (Settings). Les flux par défaut et définis par l'utilisateur sont affichés.

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. Cliquez sur Ajouter (Add). Votre nouveau flux est ajoutée à la section.

   

You need to follow the above steps whenever you want to add or remove a user-defined feed in Studio. Check out the About Activities Packages to read more information about activities feeds.

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. Cliquez sur Installer (Install), puis sur Enregistrer (Save). Le paquet est à présent installé dans votre projet et est visible dans le panneau Projet (Project), sous Dépendances (Dependencies).

   

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. Dans le ruban Studio, cliquez sur Exécuter le fichier ou utilisez Ctrl + F6 (Ctrl + F6) pour exécuter l'activité.

   

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