Utiliser Universal App Connector

Créez des automatisations pour vos Windows applications , Java Google Chrome et Edge basées sur un navigateur à l’aide du connecteur d’application universel (UAC). Configurez les applications à partir d’un connecteur unique et unifié et capturez les écrans et les éléments ou les contrôles d’écran tels que les cases à cocher et les boutons. Utilisez les méthodes de ces écrans et éléments pour créer votre automatisation.

Avant de commencer

Ajoutez le module d’extension Connecteur d’application universel à partir du gestionnaire de modules d’extension avant d’utiliser le connecteur. Pour plus d’informations sur l’ajout du module d’extension SSH, reportez-vous à la section Gérer les modules d’extension dans Studio de conception de bureau de RPA.

Vérifiez que vous avez des applications , Java Google Chrome ou ouvertes ou Edge activesWindows.

Rôle requis : aucun

Procédure

1. Dans le volet Boîte à outils, accédez à Connecteurs et faites glisser Connecteur d’application universel vers Objets globaux dans le volet Explorateur de projet.
   Le connecteur est ajouté en tant qu’objet UniversalApplication sous Objets globaux.
2. Pour utiliser les méthodes au niveau du connecteur Universal App Connector , double-cliquez sur l’objet UniversalApplication .

   Nom de méthode	Référence
   Cliquer sur	Utiliser la méthode de clic pour Connecteur d’application universelle
   Valeur GetValue	Utiliser la méthode GetValue pour Connecteur d’application universelle
   Valeur d’ensemble	Utiliser la méthode SetValue pour Connecteur d’application universel
   Début	Utiliser la méthode de démarrage pour Connecteur d’application universelle
   WaitForAnyScreen	Utiliser la méthode WaitForAnyScreen pour Universal App Connector

   Par exemple, la méthode Start est utilisée si vous souhaitez que le navigateur ou l’application démarre avant d’interagir avec les écrans ou les éléments de l’application.
   Les méthodes apparaissent dans le volet Explorateur d’objets.
3. Pour configurer les écrans et les éléments dans le contrôle de compte d’utilisateur, procédez comme suit.
   1. Sous Objets globaux, cliquez avec le bouton droit sur UniversalApplication et sélectionnez Configurer.
   2. Dans la fenêtre Configurer les écrans et les éléments, sélectionnez la liste déroulante Choisir à partir d’une fenêtre ouverte ( ) et sélectionnez un écran d’application.
      

      Remarque :

      • Si aucune application prise en charge n’est ouverte, le message Fenêtre de l’application introuvable s’affiche.
      • Pour afficher les écrans d’application nouvellement ouverts dans la liste, sélectionnez l’icône Cliquer pour actualiser Windows (icône
   3. Facultatif : Pour filtrer les applications ouvertes par leur type, sélectionnez l’icône de type d’application de filtre (icône et sélectionnez Tout ou le type d’application.

      Par exemple, si vous sélectionnez Chrome, seules les pages Web Google Chrome apparaissent dans la liste Choisir dans une fenêtre ouverte .

      Par exemple, si vous sélectionnez Windows Application, seuls Windows les écrans apparaissent dans la liste Choisir dans une fenêtre ouverte .

      Figure 1. Filtrer les applications ouvertes

      

   4. Pour ajouter l’écran d’application sélectionné, sélectionnez Ajouter un écran.
      Après avoir effectué cette étape, vous pouvez capturer les éléments d’écran pour effectuer des actions.
      L’écran de l’application apparaît sous le volet Écrans et éléments.

      

   5. Pour capturer les éléments de l’écran, sous le volet Écran et éléments, cliquez avec le bouton droit sur l’écran ajouté et sélectionnez Capturer l’élément.
      
      Le focus est placé sur l’écran de l’application que vous avez capturé et la boîte de dialogue des éléments de capture s’affiche.

      Par exemple, lorsque vous capturez des éléments d’une Windows application telle que le Bloc-notes. Si vous sélectionnez le mode UIA (UI Automation), la barre de défilement du bloc-notes est également capturée.

      Figure 2. Boîte de dialogue de capture pour l’application Windows : Bloc-notes : mode UIA

      

      Si vous sélectionnez le mode AA (Active Accessibility), la barre de défilement du bloc-notes n’est pas capturée.

      Figure 3. Boîte de dialogue de capture pour l’application Windows : Bloc-notes : mode AA

      

   6. Pour utiliser les méthodes au niveau du connecteur Universal App Connector pour les deux modes, Automatisation de l’interface utilisateur et Accessibilité active, double-cliquez sur l’objet UniversalApplication .
      Pour plus d’informations sur les méthodes du mode d’automatisation de l’interface utilisateur et du mode d’accessibilité active, reportez-vous à la section Méthodes du mode d’automatisation de l’interface utilisateur et du mode d’accessibilité active.
      Les méthodes apparaissent dans le volet Explorateur d’objets.
4. Effectuez l’une des options suivantes pour une action souhaitée.

   Option	Action
   Pour renommer UniversalApplication	Accédez aux objets globaux dans le volet Explorateur de projets, cliquez avec le bouton droit de la souris sur UniversalApplication et sélectionnez Renommer. Figure 4. Renommer UniversalApplication
   Pour changer le nom de l’écran lors de la configuration des écrans et des éléments	Sélectionnez le nom de l’écran d’application sous le volet Écrans et éléments. Les informations de l’écran de l’application sélectionnée apparaissent sous le volet Propriétés. Mettez à jour le nom de l’écran d’application dans le champ Nom , puis appuyez sur Entrée. Le nom de l’application est mis à jour dans le volet Écrans et éléments. Figure 5. Mettre à jour le nom d’écran de l’application
   Pour identifier l’écran de façon unique	Utilisez les règles de correspondance d’écran pour identifier et localiser l’écran. Pendant l’exécution, le module d’extension doit identifier l’écran cible de manière unique pour automatiser les actions à l’écran. Le titre ou l’URL de l’écran de l’application sont des exemples d’attributs. Les attributs apparaissent dans le volet Règles de correspondance d’écran de la fenêtre Configurer les écrans et les éléments . L’UAC utilise les règles de correspondance d’écran pour identifier l’écran en premier, et utilise la règle de correspondance d’élément pour identifier l’élément, puis effectuer des actions sur des éléments tels que Cliquer ou Obtenir du texte. L’image ci-dessous montre un exemple de plusieurs éléments qui correspondent aux mêmes critères donnés dans la section Attributs de correspondance. Un nombre multiple d’instances, le cas échéant, s’affiche lorsque vous actualisez l’élément capturé, est indiqué entre crochets en rouge. Dans ce cas, vous devez modifier les attributs pour sélectionner exactement l’élément qui doit être automatisé. L’utilisateur peut actualiser pour vérifier si les critères sélectionnés correspondent exactement à un élément.
   Pour identifier un élément de manière unique	Utilisez les règles de correspondance d’éléments pour modifier les valeurs dans les sections Localisateur et Attributs de correspondance fournis. Pendant l’exécution, le module d’extension doit identifier l’élément cible de manière unique pour automatiser les actions sur l’élément. Les attributs apparaissent sous le volet Attributs de correspondance de la fenêtre Configurer les écrans et les éléments . L’UAC utilise les règles de correspondance d’écran pour identifier l’écran en premier, et utilise la règle de correspondance d’élément pour identifier l’élément, puis effectuer des actions sur des éléments tels que Cliquer ou Obtenir du texte. L’image montre les règles de correspondance d’un élément capturé.
   Pour trouver les éléments sur l’écran de l’application	Utilisez les localisateurs des éléments capturés. Pour plus d'informations, consultez Rechercher les éléments sur l’écran de l’application.
   Pour afficher le chemin d’accès à un iframe, le cas échéant, dans un élément capturé	Dans le volet Écrans et éléments , sélectionnez l’élément. Sélectionnez l'onglet Avancé. L’iframe apparaît. Dans la liste Localisateur , sélectionnez un localisateur pour trouver le chemin d’accès à l’iframe.

5. Facultatif : Cliquez avec le bouton droit sur l’écran ou l’élément de l’application pour effectuer des opérations supplémentaires telles que Actualiser, Actualiser l’écran et les éléments, Focus, Ajouter un élément personnalisé, Afficher les éléments, Supprimer, etc.
   Pour plus d’informations sur les différentes opérations supplémentaires disponibles pour les écrans et les éléments d’application, reportez-vous à la section Options supplémentaires pour les écrans et les éléments d’application dans Connecteur d’application universel.
6. Sélectionnez Terminé une fois que vous avez terminé de configurer les écrans ou les éléments de votre application.
   Les écrans d’application et leurs éléments apparaissent sous l’objet UAC dans Objets globaux.
7. Double-cliquez sur l’écran ou l’élément d’application requis et le volet Explorateur d’objets s’affiche avec la liste des méthodes associées.
   Par exemple, si vous sélectionnez un écran ou un élément d’application Java, les méthodes de connecteur Java s’affichent dans l’Explorateur d’objets.

   • Pour plus d’informations sur les méthodes de connecteur Java, consultez Méthodes de connecteur Java.

   • Pour plus d’informations sur les méthodes de connecteur Google Chrome et Microsoft Edge, consultez Méthodes de connecteur Chromium.

   • Pour plus d’informations sur les méthodes de connecteur Windows, consultez Méthodes de connecteur Windows.

   • Si vous avez capturé un écran d’application Web et que vous souhaitez y exécuter un JavaScript personnalisé, vous pouvez utiliser la méthode ExecuteJavascript.

8. Capturez autant d’éléments d’écran que nécessaire à l’aide de la boîte de dialogue Capturer l’élément.

   Pour apprendre à utiliser la boîte de dialogue Capturer un élément, voir Utiliser la boîte de dialogue Capturer un élément.

   Les éléments d’écran capturés apparaissent sous l’écran de l’application capturée en tant qu’éléments.

   

9. Faites glisser la méthode requise du volet Explorateur d’objets vers l’aire de conception.

   La méthode s’affiche avec l’écran d’application ou le nom de l’élément dans l’aire de conception.

Que faire ensuite

Concevez l’automatisation à l’aide des différentes méthodes pour les écrans et les éléments de l’application, puis enregistrez l’automatisation.