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.

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 s’affichent dans la fiche d’activité.

• Vue 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 et la fiche d'activité est réduite.

  

Sélectionner Voir plus à côté d'un champ d'activité, vous pouvez afficher les options de ce champ. Les options pour la plupart des champs sont les suivantes :

• 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 :

• Pour chaque activité
  • 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 de l'activité. L' éditeur d'expressions est disponible pour la plupart des propriétés des activités et offre l'autocomplétion intelligente du code des variables, arguments, méthodes, propriétés, classes ou mots-clés. Vous pouvez écrire des expressions sur plusieurs lignes et utiliser Ctrl + Espace pour afficher la liste des options disponibles. Vous pouvez également sélectionner Insérer une 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, en utilisant une expression de type String dans une propriété de type Booléen).

Vous pouvez tester la valeur des expressions valides en sélectionnant Tester. Le test des expressions qui utilisent des valeurs complexes n'est actuellement pas pris en charge.

Générer des expressions à l'aide d' Autopilot™

Vous pouvez également utiliser le langage naturel pour décrire votre expression à l'aide des capacités d'IA génératives Autopilot™ . Au lieu d'écrire manuellement une expression dans l' éditeur d'expressions, vous pouvez utiliser le champ Générer une expression pour décrire l'action souhaitée (par exemple, « Extraire le chiffre d'affaires total du rapport de vente »).

Le modèle d'IA générera une expression basée sur la description fournie, qui s'affichera ensuite dans l'éditeur. Vous pouvez alors modifier l'expression générée ou l'accepter telle quelle. Le modèle d'IA apprend en permanence à partir des descriptions que vous soumettez, ce qui lui permet d'affiner et d'améliorer ses performances au fil du temps. Le modèle est également capable d'utiliser des variables et des arguments définis par l'utilisateur et prend en compte toute expression déjà utilisée.

Sélectionnez le bouton Corriger à côté d’une icône d’erreur et Autopilot tentera de corriger la non-correspondance et fournira une expression valide. Un message d'erreur vous informe si l'expression ne peut pas être corrigée automatiquement.

Exemple d'utilisation de l'éditeur d'expressions avec des fonctionnalités de Autopilot

Une façon simple de tester les capacités du Autopilot consiste à transformer une variable de minuscules en majuscules. Pour ce faire :

1. Créez un projet avec un déclencheur manuel et créez une nouvelle variable (par exemple, MyVariable).

2. Définissez le type de variable sur Texte et la valeur par défaut sur « exemple ».

3. Ajoutez une activité Définir la valeur de la variable .

4. Dans le champ Définir la valeur , sélectionnez Voir plus > Ouvrir l’éditeur d’expression.

5. Dans le champ Générer l'expression, saisissez vos instructions en langage naturel (par exemple, "Convertir MyVariable en majuscules").

6. Sélectionnez pour générer votre expression. Vous pouvez également sélectionner Test dans l'éditeur d'expressions pour tester la nouvelle valeur de la variable.

7. Sélectionnez Enregistrer pour utiliser l’expression générée par Autopilot.

8. Dans le champ Vers la sortie de la variable , sélectionnez MyVariable.

   

9. Ajoutez une activité Message du journal .

10. Dans le champ Message , saisissez le message que vous souhaitez consigner (par exemple, « Ma variable, MyVariable, est maintenant en majuscules »), et sélectionnez un niveau de journalisation.

11. Sélectionnez Déboguer sur le cloud en haut du concepteur pour tester l'automatisation et vérifiez le panneau de sortie d'exécution pour voir la variable passée de minuscules "example" à des majuscules (EXEMPLE).

    

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 :

1. 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).
2. 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).
3. 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'il n'y en a plus 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.

1. Dans l'activité de déclencheur, sélectionnez Filtres supplémentaires pour ouvrir le générateur de filtres.

2. 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.

3. 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 :

1. Sélectionnez une première valeur à comparer dans le champ de gauche, par exemple une variable de votre projet.
2. 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.
3. 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.

To create a statement with multiple conditions, click Add in the Condition Builder and provide the same information for each additional statement. When you add multiple statements, a dropdown menu appears at the top of the window where you must select when the statement is true: select All (AND) if the statement is true when all the conditions are met, or Any (OR) if the statements is true when any of the conditions are met.

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.

1. Configurez le déclencheur Fichier créé.

2. Dans l’activité Si (If), cliquez sur le champ Condition afin d'ouvrir le Générateur de conditions.

3. 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éé > Afficher plus > Fichier > TailleEnOctets.
   2. Dans le champ du milieu, sélectionnez moins de.
   3. Dans le générateur de texte, entrez 1,000,000, puis cliquez sur Enregistrer (Save).

   

4. 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).

1. Dans l’activité Charger les fichiers, sélectionnez Voir plus > Créer une collection de fichiers à côté du champ Fichier(s) .

2. Sélectionnez Cliquer pour ouvrir le générateur de collections.

3. 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 :

• Aujourd’hui
• Hier
• Demain
• Il y a deux jours
• Début de la dernière semaine de travail
• Fin de la dernière semaine de travail
• Début de la semaine prochaine
• Début du mois prochain
• Début de la semaine
• Début du mois
• Début du mois dernier
• Au début de l'année
• Il y a 3 mois
• Il y a 6 mois
• maintenant

Éditeur de mappage de données

L’éditeur de Mappage de données simplifie l’automatisation des processus métier de bout en bout impliquant des structures de données complexes. Le mappage des données vous aide à mapper des objets de données complexes entre des systèmes dans une seule activité Integration Service.

Pour accéder à l’éditeur de mappage de données :

1. Ajoutez une activité Integration Service à votre workflow.

2. Sélectionnez le bouton Basculer vers l’affichage des objets dans le corps de l’activité.

3. Sélectionnez le champ d’activité à modifier. L’éditeur de mappage de données s’ouvre.

   

Vous pouvez également accéder à l’éditeur de mappage des données en sélectionnant Voir plus > Mappage des données à côté du champ d’activité.

L'éditeur dispose de deux modes :

1. Un mode standard qui s'ouvre chaque fois que vous accédez à l'éditeur. Il s'agit du mode par défaut.
2. Un mode avancé que vous pouvez activer depuis le bouton Mode avancé dans le coin supérieur droit de l'éditeur.

En mode standard, vous pouvez :

• Utilisez les boutons Développer tout et Réduire tout pour développer ou réduire toutes les propriétés d’objets imbriqués.
• Sélectionnez l'icône de recherche pour trouver une propriété ou une variable spécifique.
• Visualisez toutes les propriétés de l’objet dans la colonne Propriétés de destination. Certaines propriétés peuvent être développées pour révéler des propriétés imbriquées supplémentaires (par exemple, les propriétés de type liste). Chaque propriété a un nom d’affichage qui facilite sa distinction dans la liste, ainsi que le nom d’API exact défini par l’application tierce.
• Mappez une propriété d’objet à une sortie d’activité dans la colonne Mappage . Sélectionnez le champ à côté de chaque propriété et choisissez une variable dans le sélecteur Use variables . Vous pouvez également sélectionner l'option En savoir plus bouton vers :
  • Ouvrez le sélecteur Utiliser les variables .
  • Ouvrez l’Éditeur d’expressions.
  • Effacez toute valeur dans le champ de sortie de l’activité.
• Sélectionnez une variable disponible dans le workflow dans la colonne Variables disponibles . Les variables peuvent être glissées-déposées à l'intérieur des sorties de l'activité répertoriées sous la colonne Mappage .
• Activez ou désactivez le mode Avancé. En mode avancé, vous pouvez uniquement mapper les propriétés en saisissant une expression ou en utilisant le sélecteur Utiliser les variables . Il n'est pas possible de glisser-déposer des variables à partir de la colonne Variables disponibles .
  Remarque :

  Dans Studio, l’éditeur de mappage des données n’est disponible qu’en mode avancé.

Une icône d’erreur dans le champ de sortie de l’activité indique la présence d’une incompatibilité entre une variable et le type de sortie de l’activité.

Après avoir mappé une propriété d’objet à une sortie d’activité, sélectionnez le bouton Enregistrer pour enregistrer vos modifications.

Remarque :

Si une propriété imbriquée ou une propriété parente est déjà mappée, l'autre ne pourra pas être mappée.

Sélectionnez Basculer vers la vue des champs dans le corps de l’activité pour revenir à la mise à jour des champs d’activité en ligne.

Important :

Pour utiliser les sorties créées dans l’éditeur de mappage des données, veillez à bien utiliser l’activité en mode objet. Si l'activité est utilisée dans la vue des champs, les mappages créés dans l'éditeur de mappage des données ne sont pas pris en compte lors de l'exécution du workflow.