Guide de l'utilisateur de Studio Web pour Automation Suite

PRODUIT :

Automation Cloud Automation Suite

VERSION : 2024.10

Dernière mise à jour 18 déc. 2024

Configurer les activités

Les activités peuvent recevoir des données d'entrée et peuvent également générer des données de sortie qui peuvent être utilisées comme entrée par d'autres activités. Les options et les propriétés des activités clés sont visibles par défaut dans les fiches d'activité. Si une activité possède des propriétés supplémentaires, vous pouvez les configurer en sélectionnant Afficher les propriétés supplémentaires (Show additional properties).

Le panneau Propriétés vous permet de contrôler l’affichage des propriétés d’activité. Vous pouvez également utiliser ce panneau pour modifier le nom du projet ou le nom du workflow sélectionné dans l' explorateur de projets.

Pour accéder au panneau, sélectionnez l'icône correspondante en haut à droite de la page du projet. Dans le panneau Propriétés (Properties), vous pouvez basculer entre deux vues à tout moment :

Vue de la zone de dessin : toutes les propriétés de l'activité sélectionnée apparaissent dans la fiche d'activités.
Affichage du panneau : toutes les propriétés de l'activité sélectionnée, y compris les propriétés avancées, apparaissent uniquement dans le panneau Propriétés (Properties) et la carte d'activité est réduite.

Sélection Voir plus docs image

à côté d'un champ d'activité affiche les options de ce champ. Les options pour la plupart des champs sont :

Utiliser la variable
Générateur de textes
Créer une variable
Ouvrir l’éditeur d’expression

Remarque : les options disponibles peuvent varier en fonction des types de données associés au champ.

Des contrôles d'entrée, des éditeurs et des générateurs dédiés sont disponibles pour vous aider à configurer vos activités en fonction du type de données, soit directement à partir de l'activité dans le concepteur de projet, soit en ouvrant un éditeur ou un générateur.

Certaines activités déterminent l’étendue ou les conditions à remplir pour exécuter les autres activités ajoutées en leur sein. C'est ce qu'on appelle les « activités conteneur ». En voici quelques exemples :

Activités Pour chaque (For Each) : définissez une collection d’éléments et, pour chaque élément, répétez une fois les activités ajoutées à l’intérieur.
Si (If) : évalue une condition et détermine le flux de l'automatisation en exécutant des activités spécifiques selon que la condition est remplie ou non.
Utiliser le navigateur (Use Browser) : se joint à une page de votre navigateur et exécute dans celle-ci toutes les activités UI Automation qui y sont ajoutées.

Les sections suivantes expliquent comment utiliser certains des éditeurs et générateurs disponibles.

Éditeur d'expressions

Écrivez des expressions complexes pour configurer les propriétés d'activité. L' éditeur d'expressions est disponible pour la plupart des propriétés d'activité et propose une complétion de code intelligent pour les variables, les arguments, les méthodes, les propriétés, les classes ou les mots clés. Vous pouvez écrire des expressions sur plusieurs lignes et utiliser Ctrl + Espace pour voir la liste des options disponibles. Vous pouvez également sélectionner Insérer une variable (Insert variable ) pour ouvrir la fenêtre de sélection de variables et sélectionner une variable, un argument ou une propriété.

Utilisez Ctrl + F dans l'éditeur pour ouvrir les fonctionnalités de recherche et de remplacement. L'icône d'erreur indique s'il existe une incompatibilité entre une expression et le type de propriété d'activité (par exemple, l'utilisation d'une expression de type Chaîne ( String ) dans une propriété de type Booléen ( Boolean).

Vous pouvez tester la valeur d'expressions valides en sélectionnant Tester(Test). Les expressions de test qui utilisent des valeurs complexes ne sont actuellement pas prises en charge.

Générateur de filtres

Créez un filtre complexe avec une ou plusieurs conditions. Les filtres permettent à vos automatisations d'identifier précisément les éléments devant être utilisés. Par exemple, la plupart des déclencheurs d'événement contiennent des filtres qui vous permettent de déterminer précisément les critères auxquels un événement doit répondre pour que l'automatisation puisse démarrer.

Pour créer un filtre :

Sélectionnez l'élément à filtrer dans le champ de gauche. Par exemple, lors du filtrage des e-mails, vous pouvez sélectionner un champ d'e-mail tel que De (From) ou Corps (Body).
Sélectionnez un opérateur dans la liste déroulante du milieu à utiliser pour comparer l'élément. Vous pouvez choisir parmi plusieurs opérateurs en fonction du type de données. Par exemple, lors du filtrage des e-mails par expéditeur, vous pouvez sélectionner l'opérateur contient (contains) ou ne contient pas (does not contain) pour le champ De (From).
Sélectionnez dans le champ de droite la valeur à laquelle comparer l'élément sélectionné.

Pour créer un filtre avec plusieurs conditions, cliquez sur Ajouter une condition (Add condition dans le générateur de filtres. Procédez de la même manière pour chaque autre condition. Lorsque vous ajoutez plusieurs conditions, un menu déroulant apparaît en haut de la fenêtre, dans laquelle vous devez sélectionner le moment auquel le filtre s'applique : sélectionnez All (AND) si le filtre s'applique lorsque toutes les conditions sont remplies, ou Any (OR) si le filtre s'applique lorsqu'au moins une des conditions est remplie.

Exemple de création d'un filtre

Vous concevez une automatisation qui est déclenchée par l'événement Fichier créé sur OneDrive ou Google Drive et vous souhaitez que l'automatisation ne s'exécute que lorsque des fichiers sont créés avec les extensions suivantes : pdf, tif, jpg, png, jpeg.

Dans l'activité de déclencheur, sélectionnez Filtres supplémentaires pour ouvrir le générateur de filtres.
Ajoutez une condition pour chaque extension de fichier à inclure dans le filtre, en sélectionnant Extension dans le premier champ, Contient dans le deuxième champ, et en saisissant une extension dans le troisième champ.
Sélectionnez N’importe lequel (OU) dans la liste déroulante située en haut de la fenêtre pour indiquer que toute création de fichiers présentant l’une de ces extensions déclenchera l'automatisation.

Générateur de conditions

Définissez une déclaration vraie ou fausse qu'une activité évalue pour déterminer comment l'automatisation doit se poursuivre.

Pour créer une condition :

Sélectionnez une première valeur à comparer dans le champ de gauche, par exemple une variable de votre projet.
Sélectionnez un opérateur dans la liste déroulante du milieu à utiliser pour comparer la première valeur. Vous pouvez choisir parmi plusieurs opérateurs en fonction du type de données : greater than, greater than or equal, less than, less than or equal, equals, not equals, is empty text, is not empty text, is true, is false, starts with, does not start with, ends with, does not end with, contains, does not contain, has value, has no value, list is empty, list is not empty.
Pour certains opérateurs, vous devez également sélectionner dans le champ de droite une deuxième valeur avec laquelle comparer la première valeur.

Pour créer une instruction avec plusieurs conditions, cliquez sur Ajouter (Add) dans le générateur de conditions et fournissez les mêmes informations pour chaque instruction supplémentaire. Lorsque vous ajoutez plusieurs instructions, un menu déroulant apparaît en haut de la fenêtre où vous devez sélectionner lorsque l'instruction est vraie : sélectionnez All (AND) si l'instruction est vraie lorsque toutes les conditions sont remplies, ou Any (OR) si l'instruction est vraie lorsque l'une des conditions est remplie.

Exemple de création d'une condition

Vous créez une automatisation qui va déplacer chaque fichier créé dans un dossier spécifique de votre Google Drive ou de votre OneDrive vers l'un ou l'autre des dossiers suivants, en fonction de la taille de chaque fichier : les fichiers de 1 Mo ou plus sont dirigés vers le dossier Fichiers volumineux, tandis que les fichiers de moins de 1 Mo iront dans le dossier Fichiers peu volumineux.

Configurez le déclencheur Fichier créé.
Dans l’activité Si (If), cliquez sur le champ Condition afin d'ouvrir le Générateur de conditions.
Dans le générateur de conditions, ajoutez la condition « la taille du fichier est inférieure à 1 Mo ». Nous utiliserons la propriété TailleEnOctets du fichier créé (1 Mo = 1000000 octets).
1. Cliquez sur le premier champ et sélectionnez Fichier créé ( File Created ) > Afficher plus ( Show more) > Fichier (File) > TailleEnOctets.
2. Dans le champ du milieu, sélectionnez inférieur à.
3. Dans le générateur de texte, entrez 1000000, puis cliquez sur Enregistrer (Save).
Nous allons ensuite ajouter deux activités Déplacer le fichier (Move File) afin de déplacer le fichier créé comme suit :
- Une activité de la branche Alors de l’activité « Si » (If). Il s’agit de l’activité exécutée lorsque la condition est remplie (la taille du fichier est inférieure à 1 Mo). Nous allons donc sélectionner Fichiers peu volumineux (Small files) en tant que dossier de destination.
- L'autre activité de la branche Alors de l’activité « Si » (If). Il s’agit de l’activité exécutée lorsque la condition n'est pas remplie (la taille du fichier n'est pas inférieure à 1 Mo). Nous allons donc sélectionner Fichiers volumineux (Big files) en tant que dossier de destination.

Générateur de collections

Créez une collection d'éléments du même type.

Pour créer une collection, sélectionnez l'élément, puis Ajouter une entrée (Add entry) pour chaque entrée que vous souhaitez ajouter.

Exemple de création d'une collection

Vous concevez une automatisation dans laquelle vous avez récupéré des fichiers via deux activités de téléchargement différentes. Vous souhaitez ensuite charger ces fichiers sur OneDrive ou sur Google Drive en utilisant une seule activité Charger les fichiers (Upload Files).

Dans l’activité Charger des fichiers (Upload Files), sélectionnez Voir plus (See more ) > Créez une collection de fichiers à côté du champ Fichier(s) .
Sélectionnez Cliquer pour ouvrir le générateur de collections.
Sélectionnez Ajouter (Add), puis cliquez sur le premier champ et sélectionnez la sortie de la première activité Télécharger le fichier (Download File). Répétez l'opération pour la sortie de la deuxième activité, puis cliquez sur Enregistrer (Save).

Sélecteur de date et d'heure

Sélectionnez une date dans le calendrier et une heure de la journée (heure et minute). Disponible pour les champs nécessitant une valeur de date et d'heure.

Lorsque vous utilisez une variable dans un champ qui accepte des valeurs de date et d'heure, des extraits sont également disponibles, ce qui vous permet d'ajouter rapidement les variables de date et d'heure les plus courantes :