Utilisation du gestionnaire de données

Le panneau Gestionnaire de données (Data Manager) vous permet de gérer différents types de données dans votre projet d'automatisation. Ces données comprennent :

• Variables : stockez des données de différents types et transmettez-les entre les activités d’un projet.
• Arguments : stockez des données de différents types et transmettez-les entre les workflows.
• Constantes (Constants) : stockez les valeurs immuables globales des types de base.
• Ressources (Resources) : activités qui ajoutent des ressources telles que des fichiers, des comptes de messagerie, des applications ou des navigateurs au projet.
• Connexions (Connections) : liens entre votre automatisation et des applications externes.
• Espaces de noms (Namespaces) : définissez l'étendue de vos expressions, variables et arguments. L'importation d'espaces de noms facilite la référence aux éléments de ces espaces de noms.

Le Gestionnaire de données possède une structure en grille et contient les onglets suivants :

• Variables
• Arguments
• Espaces de noms
• Connexions

Variables

Pour plus d'informations sur les variables, consultez la section Gestion des variables (Managing Variables) .

Pour créer une variable dans le Gestionnaire de données :

1. Accédez à l'onglet Variables.
2. Sélectionnez Create variable (Créer une variable). Votre nouvelle variable s'affiche en haut de la liste des variables.
3. Indiquez le nom, le type de données, l'étendue et la valeur par défaut de la variable.

   L'étendue peut être définie sur la globalité (disponible dans l'ensemble du projet), sur le fichier de workflow actuel ou sur n'importe quelle activité de conteneur dans le fichier de workflow. La valeur par défaut est le fichier de workflow actuel.

Remarque :

• Les variables globales ne peuvent pas être utilisées dans des workflows isolés (fichiers invoqués à l'aide des activités Appeler le fichier de workflow (Invoke Workflow File) configurées avec l'option Isolé (Isolated)).
• Les variables globales ne sont pas prises en charge dans les projets de bibliothèque.
• Dans les projets C#, l’utilisation d’une variable globale ou d’une constante globale dans les activités nécessite d’appliquer le format suivant : GlobalVariablesNamespace.GlobalVariables.YOUR_GLOBAL_VARIABLE_NAME. Dans les projets VB, vous pouvez référencer directement la variable globale ou la constante globale par son nom.

Dans l'onglet Variables, vous pouvez :

• Sélectionner la colonne Name (Nom) pour trier les variables par leur nom.
• Recherchez des variables en sélectionnant l'icône de recherche.
• Sélectionner la colonne Data Type (Type de données) pour trier les variables en fonction de leur type de données.
• Sélectionner la colonne Scope (Étendue) pour trier les variables en fonction de leur étendue.
• Sélectionner le bouton Sync with active scope (Synchroniser avec l'étendue active). Lorsque le focus se trouve sur une étendue active, par exemple, l'activité Use Excel File (Utiliser un fichier Excel) est sélectionnée, elle affiche uniquement les variables dont l'étendue correspondante lui est affectée.
• Voir la valeur par défaut des variables dans la colonne Default Value (Valeur par défaut).
• Modifiez le nom, le type de données, la portée ou la valeur par défaut d'une variable. Dans le cas des variables globales, vous pouvez modifier la valeur, mais pas le nom, le type ou la portée.

Le clic droit sur une variable ouvre le menu contextuel avec les options suivantes :

• New (Nouveau) > Global variable (Variable globale) : crée une variable globale.
• New (Nouveau) > Constant (Constante) : crée une constante.
• Create trigger (Créer un déclencheur) : crée un déclencheur à partir d'une variable globale. Les variables globales sont utilisées dans une automatisation Attended basée sur des déclencheurs pour stocker des données sur les événements utilisateur ou d'application. Ces données peuvent ensuite être utilisées pour déclencher d'autres activités ou workflows (par exemple, lorsque la valeur d'une variable globale change). Pour en savoir plus, consultez la section Automatisation Attended basée sur des déclencheurs.
• Convert to Argument (Convertir en argument) : convertit la variable en argument. L'argument nouvellement converti se trouve dans l'onglet Arguments.
• Copy (Copier) : copie la variable. Vous pouvez également utiliser le raccourci clavier CTRL + C.
• Paste (Coller) : colle la variable copiée. Vous pouvez également utiliser le raccourci clavier CTRL + V. Lorsqu'une variable portant le même nom existe déjà, un numéro est ajouté au nom du doublon. Par exemple, si une variable portant le nom nombre existe déjà, la variable copiée est renommée nombre_1.
• Delete (Supprimer) : supprime la variable.
• Add watch (Ajouter à surveillance) : ajoute la variable au panneau Surveillance. Cette option est disponible uniquement pendant le débogage.
• Annotations : affiche les options permettant de travailler avec les annotations. Utilisez des annotations pour fournir du contexte ou simplement pour mieux suivre l'objectif et le contenu des variables :
  • Add annotation (Ajouter une annotation) : crée une nouvelle annotation.
  • Edit annotation (Modifier l'annotation) : modifie une annotation existante. Vous pouvez également modifier les annotations en sélectionnant l'icône d'annotation en regard d'une variable et en modifiant le texte.
  • Delete annotation (Supprimer l'annotation) : supprime une annotation existante.
• Find References (Trouver des références) : ouvre le panneau Find References (Trouver des références), qui affiche toutes les références à la variable du projet.

Arguments

Pour plus d'informations sur les arguments, consultez la section Gestion des arguments (Managing Arguments).

Remarque : si vous ajoutez ou supprimez un argument du gestionnaire de données alors que le panneau Arguments est ouvert, les modifications ne sont visibles dans le panneau Arguments qu'après la fermeture et la réouverture du fichier de workflow.

Pour créer un argument dans le Gestionnaire de données :

1. Accédez à l'onglet Arguments.
2. Sélectionnez Create argument (Créer un argument). Votre nouvel argument s'affiche en haut de la liste des arguments.
3. Indiquez le nom, la direction, le type de données, le caractère obligatoire ou non obligatoire, et la valeur par défaut. Par défaut, tous les nouveaux arguments créés sont de type Chaîne (String) avec une direction Entrée (In).

Dans l'onglet Arguments, vous pouvez :

• Sélectionnez la colonne Name (Nom) pour trier les arguments par nom.
• Recherchez des arguments en sélectionnant l'icône de recherche.
• Sélectionnez la colonne Direction pour trier les arguments en fonction de leur direction.
• Sélectionner la colonne Data Type (Type de données) pour trier les arguments par type de données.
• Indiquer si un argument est nécessaire dans la colonne Required (Obligatoire).
• Voir la valeur par défaut des arguments dans la colonne Default Value (Valeur par défaut).
• Modifier les éléments suivants : la direction, le type de données, si nécessaire, et la valeur par défaut.
• Sélectionner plusieurs variables en cliquant et en faisant glisser le curseur de la souris sur les variables ou en utilisant le raccourci clavier CTRL + A.

Cliquer avec le bouton droit sur un argument ouvre le menu contextuel qui contient les options suivantes :

• Convert to Variable (Convertir en variable) : convertit l'argument en variable.La variable nouvellement convertie se trouve dans l'onglet Variables.
• Copy (Copier) : copie l'argument. Vous pouvez également utiliser le raccourci clavier CTRL + C.
• Paste (Coller) : colle l'argument copié. Vous pouvez également utiliser le raccourci clavier CTRL + V. Lorsqu'un argument portant le même nom existe déjà, un numéro est ajouté au nom du doublon.
• Delete (Supprimer) : supprime l'argument.
• Annotations : affiche les options permettant de travailler avec les annotations :
  • Add annotation (Ajouter une annotation) : crée une nouvelle annotation.
  • Edit annotation (Modifier l'annotation) : modifie une annotation existante. Vous pouvez également modifier les annotations en sélectionnant l'icône d'annotation en regard d'un argument et en modifiant le texte.
  • Delete annotation (Supprimer l'annotation) : supprime une annotation existante.
• Find References (Trouver des références) : ouvre le panneau Find References (Trouver des références), qui affiche toutes les références à l'argument du projet.
• Sélectionnez plusieurs arguments en cliquant et en faisant glisser le curseur de la souris sur les arguments ou en utilisant le raccourci clavier CTRL + A.

Constantes

Les constantes vous permettent de définir des valeurs fixes qui ne changent pas pendant l'exécution du projet. Les constantes sont disponibles globalement et peuvent être référencées dans les champs d'entrée d'activité tout au long d'un projet. Par exemple, si un nom de société ou un nom de service est une entrée dans plusieurs écrans, vous pouvez stocker le nom dans une constante et le référencer dans les activités qui interagissent avec chaque écran.

Après avoir créé une constante, vous pouvez modifier sa valeur, mais pas son nom, son type ou son étendue.

Remarque :

• Remarque : les constantes ne sont pas disponibles dans les projets hérités depuis Windows et ne sont pas prises en charge dans les projets de bibliothèque.
• Actuellement, vous ne pouvez pas modifier le nom ou le type de données d’une constante créée. Vous pouvez uniquement modifier la valeur par défaut de la constante.
• Les variables qui n’ont pas d’étendue globale peuvent posséder le même nom qu’une constante. Pour faire la distinction entre une constante et une variable portant le même nom, accédez à la constante en utilisant son nom complet (GlobalConstantsNamespace.GlobalConstants.YourConstantName).

Pour créer une constante dans le Gestionnaire de données :

1. Accédez à l'onglet Variables.
2. Cliquez avec le bouton droit sur une variable ou une constante.
3. Sélectionnez New (Nouveau) > Constant (Constante).
4. Fournissez les informations suivantes :
   • Saisissez le nom de la constante.
   • Sélectionnez le type de données de la constante : Texte (Text), Nombre (Number), Vrai ou Faux (True or False), Nombre avec décimales (Number with decimals), Date ou Durée (Duration).
   • Saisissez la valeur de la constante.
5. Sélectionnez OK. Votre nouvelle constante s'affiche en haut de la liste des variables.

Cliquer avec le bouton droit sur une constante ouvre le menu contextuel avec les options suivantes :

• New (Nouveau) > Global variable (Variable globale) : crée une variable globale.
• New (Nouveau) > Constant (Constante) : crée une constante.
• Copy (Copier) : copie la constante. Vous pouvez également utiliser le raccourci clavier CTRL + C.
• Paste (Coller) : colle la constante copiée. Vous pouvez également utiliser le raccourci clavier CTRL + V.
• Delete (Supprimer) : supprime la constante.
• Find References (Trouver des références) : ouvre le panneau Find References (Trouver des références), qui affiche toutes les références à la constante du projet.

Espaces de noms

Pour plus d'informations sur les espaces de noms, consultez À propos des espaces de noms importés (About Imported Namespaces).

Pour ajouter un espace de noms, procédez comme suit :

1. Ouvrez le Gestionnaire de données.
2. Accédez à l'onglet Namespaces (Espaces de noms).
3. Sélectionnez Add namespace (Ajouter un espace de noms).
4. Un menu déroulant répertoriant les espaces de noms disponibles s'affiche. Pour filtrer la liste, utilisez la zone de recherche située en haut du menu.
5. Sélectionnez l'espace de noms pour l'importer.

Pour supprimer un espace de noms, cliquez avec le bouton droit sur l'espace de noms et sélectionnez Delete (Supprimer).

Connexions

Pour afficher les connexions utilisées dans un projet :

1. Ouvrez le Gestionnaire de données.
2. Accédez à l'onglet Connections (Connexions) pour afficher la liste des connecteurs utilisés dans le projet et leurs connexions correspondantes.

Remarque : les connexions sont affichées dans le gestionnaire de données pour certaines activités, et n'apparaissent qu'après l'enregistrement du projet.

Ressources

Dans les projets Windows – Héritage et Windows, vous pouvez accéder à l'onglet Variables du Gestionnaire de données pour afficher et gérer les ressources suivantes dans le fichier de projet en cours :

• Applications et navigateurs ajoutés dans les activités Utiliser l'application/le navigateur (Use Application/Browser).
• Documents Word ajoutés dans les activités Étendue de l'application Word (Word Application Scope).
• Présentations PowerPoint ajoutées dans les activités Utiliser une présentation PowerPoint (Use PowerPoint Presentation).
• Comptes de messagerie ajoutés dans les activités Utiliser l'application de bureau Outlook (Use Desktop Outlook App), Utiliser Outlook 365 (Use Outlook 365) et Utiliser Gmail (Use Gmail).
• Fichiers Excel utilisés dans l'automatisation :
  • Fichiers ajoutés dans les activités Utiliser un fichier Excel (Use Excel File) pour une utilisation avec des activités Excel modernes.
  • Fichiers ajoutés à partir du gestionnaire de données à l'aide de l'option Se connecter à un nouveau fichier de classeur (Connect to new Workbook file) à utiliser avec les activités de classeur.

Gestion des ressources de fichiers Excel (activités Excel modernes)

Après avoir ajouté un fichier Excel dans une activité Utiliser un fichier Excel (Use Excel File), vous pouvez gérer la ressource comme suit :

• Pour configurer la ressource, cliquez dessus avec le bouton droit dans l'onglet Variables et sélectionnez Configure (Configurer). La fenêtre Manage resource (Gérer les ressources) s'affiche.
  • Sélectionner un fichier Excel : recherchez et sélectionnez le fichier Excel.
  • Et donnez-lui un nom pour plus tard : saisissez le nom par lequel faire référence au fichier dans le projet (par défaut, Excel). Il s’agit du nom de l’option qui sera disponible dans le menu Plus des activités enfants de l’activité Utiliser un fichier Excel (Use Excel File), vous permettant de référencer le fichier Excel.
  • Enregistrer les modifications - Sélectionnez cette option si vous souhaitez que le fichier soit enregistré à la fin de l’automatisation. Dans le cas contraire, le fichier revient à l’état initial après l’exécution du projet. Cette option est activée par défaut.
  • Lecture seule - Sélectionnez cette option si vous souhaitez ouvrir le fichier en mode lecture seule. Cette option vous permet d’effectuer des opérations d’extraction de données si le fichier est verrouillé pour empêcher toute modification ou si la modification du fichier est protégée par un mot de passe. Cette option n’est pas sélectionnée par défaut.
• Pour supprimer l'activité Utiliser un fichier Excel (Use Excel File) et toutes ses activités enfants du projet, cliquez avec le bouton droit sur la ressource Excel et sélectionnez Supprimer (Delete).

Connexion à un fichier Excel (activités du classeur)

Dans les projets où vous utilisez plusieurs activités Classeur (Workbook) avec le même fichier Excel volumineux, vous pouvez obtenir les meilleures performances d'exécution en vous connectant au fichier Excel à partir du gestionnaire de données pour l'ajouter en tant que ressource. Cela garantit que le fichier est chargé dans la mémoire une fois pour toutes les activités au moment de l'exécution. Si vous choisissez de fournir le chemin d'accès au fichier Excel dans chaque activité Classeur (Workbook), le fichier est chargé dans la mémoire pour chaque activité.

Pour ajouter un classeur Excel en tant que ressource :

1. Accédez à l'onglet Variables.
2. Cliquez avec le bouton droit sur le panneau et sélectionnez New (Nouveau) > Connect to a new Workbook file (Se connecter à un nouveau fichier de classeur). La fenêtre Manage resource (Gérer les ressources) s'affiche.
3. Configurez la ressource :
   • Sélectionner un fichier Excel : recherchez et sélectionnez le fichier Excel.
   • Et donnez-lui un nom pour plus tard : saisissez le nom par lequel faire référence au fichier dans les activités de classeur (par défaut, le nom du fichier). Il s'agit du nom de l'option qui sera disponible dans le menu Plus de la propriété Classeur (Workbook), vous permettant de référencer le fichier de classeur.
   • Mot de passe (Password) : saisissez le mot de passe du fichier, le cas échéant.
   • Étendue (Scope) : sélectionnez l'étendue de la ressource. Par défaut, l'étendue est définie sur le conteneur principal. Pour optimiser les performances, définissez l'étendue sur le conteneur le plus proche de l'endroit où les activités qui utilisent la ressource sont placées dans le workflow.

Une fois la ressource créée, vous pouvez modifier sa configuration en cliquant dessus avec le bouton droit dans l'onglet Variables et en sélectionnant Configure (Configurer). Vous pouvez référencer la ressource dans plusieurs activités de classeur en sélectionnant la ressource dans le menu Plus.

Gestion des ressources

Pour gérer une ressource à partir du panneau Variables, cliquez avec le bouton droit sur la ressource et sélectionnez une des options du menu contextuel :

• Ouvrir (Open) : ouvre un fichier Excel, PowerPoint ou Word ajouté en tant que ressource.
• Ouvrir l'emplacement du fichier (Open file location) : ouvre le dossier contenant un fichier Excel, PowerPoint ou Word ajouté en tant que ressource.

  Cette option n'est pas disponible lorsque vous travaillez avec des fichiers distants (par exemple,

• Configurer (Configure) : ouvre la fenêtre Gérer la ressource (Manage resource) dans laquelle vous pouvez modifier les propriétés d'une ressource Excel.
• Supprimer - Supprime la ressource du projet.