Utiliser le connecteur d’application universel

  • Rversion finale: Yokohama
  • Mis à jour 30 janv. 2025
  • 6 minutes de lecture

    • Créez des automatisations pour vos Windowsapplications , Java Google Chromeet Edge basées sur un navigateur à l’aide de 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

    Vérifiez que vous avez des applications , Java Google Chromeou 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. Facultatif : Pour renommer UniversalApplication, cliquez avec le bouton droit de la souris et sélectionnez Renommer.
    3. Pour utiliser les méthodes au niveau du connecteur Universal App Connector , double-cliquez sur l’objet UniversalApplication .
      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. Pour plus d’informations sur l’utilisation de la méthode Start, consultez Utiliser la méthode Start.
      Les méthodes apparaissent dans le volet Explorateur d’objets.
    4. 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 ( Choisissez dans une liste déroulante de fenêtre ouverte.) et sélectionnez un écran d’application.
        Demandes ouvertes.
        Remarque :
        • Si aucune application prise en charge n’est ouverte, le message Fenêtre d’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 Cliquer pour actualiser Windows).
      3. Facultatif : Pour filtrer les applications ouvertes par leur type, sélectionnez l’icône de type d’application de filtre ( icône de type d’application de filtre.) 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 .
      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.

        Le nom de l’écran de l’application apparaît sous Écrans et éléments.

      5. Facultatif : Pour modifier le nom de l’écran, sélectionnez le nom de l’écran d’application dans le volet Écrans et éléments.
        Les informations de l’écran de l’application sélectionnée apparaissent sous le volet Propriétés.
      6. Facultatif : 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.
      7. 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.
        Option 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.

        Écran capturé mis au point et la boîte de dialogue de capture s’affiche.

      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 l’élément, voir Utiliser la boîte de dialogue Capturer l’élément.

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

        Contrôles d’écran capturés.

    5. Facultatif : Utilisez les règles de correspondance d’écran pour modifier les valeurs dans les règles de correspondance fournies afin d’identifier l’écran de manière unique.
      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 éléments et les écrans . Le contrôle de compte d’utilisateur utilise ces attributs pour identifier l’écran en premier et effectuer des actions sur les éléments tels que Cliquer ou Obtenir du texte.

      Règles de correspondance d’écran.

      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.

      Plusieurs instances de l’élément capturé.

    6. Facultatif : Utilisez les règles de correspondance d’éléments pour modifier les valeurs dans les sections Localisateur et Attributs de correspondance fournis afin d’identifier un élément de manière unique.
      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 éléments et les écrans . Le contrôle de compte d’utilisateur utilise ces attributs pour identifier l’écran en premier et effectuer des actions sur les éléments tels que Cliquer ou Obtenir du texte.

      L’image montre les règles de correspondance d’un élément capturé.

      Élément et ses règles de correspondance.

    7. Facultatif : Utilisez les localisateurs des éléments capturés pour trouver les éléments sur l’écran de l’application.
      L’UAC fournit plusieurs types de localisateurs. Par exemple, le localisateur XPath fournit le XPath à l’élément.

      Localisateurs d’éléments.

      1. Dans le volet Écrans et éléments, sélectionnez un élément sous un écran.
      2. Dans la liste Localisateur , sélectionnez l’un des localisateurs d’éléments.
        Tableau 1. Localisateurs des éléments d’écran
        Type de localisateur Type de demande Description
        ID Web, Java et Windows Identificateur unique de l’élément, s’il est défini dans l’application cible.
        Nom Web, Java et Windows Nom unique de l’élément s’il est défini dans l’application cible.
        Sélecteur CSS Web Sélecteur CSS qui localise l’élément Web capturé. Par exemple, div#navbarNav > ul > li > a. Si une application Web prend en charge le Shadow DOM, le sélecteur CSS affiche le chemin avec les éléments du Shadow DOM. Par exemple, html > body > shop-app > /ShadowDom/ > app-header[id="header"] > app-toolbar > div :nth-of-type(3) > un > paper-icon-button > /ShadowDom/ > iron-icon[id="icon"]
        Nom de balise Web Nom de balise unique de l’élément Web.
        JavaScript Web Permet à l’utilisateur de définir un code JavaScript personnalisé pour localiser un élément.
        XPath Web XPath pour localiser l’élément Web. Si une application Web prend en charge le Shadow DOM, ce localisateur affiche l’XPath complet avec les éléments Shadow DOM. Par exemple, html > body > shop-app > /ShadowDom/ > iron-pages > shop-home > /ShadowDom/ > div > h2.
        Type Java et Windows Permet de localiser un élément d’écran par son type. Par exemple, bouton ou zone de texte.

        Lorsque vous sélectionnez le localisateur de type , le connecteur UAC renseigne le champ Valeur avec le type de l’élément.
        Chemin d'accès Java et Windows Permet de localiser un élément d’écran en spécifiant sa position dans la hiérarchie des éléments d’écran.

        Lorsque vous sélectionnez le localisateur de chemin , le connecteur UAC remplit le champ Valeur avec le chemin d’accès de l’élément.
        Chemin d’accès personnalisé Windows Permet d’affiner ou d’ajuster le chemin d’accès à un élément.
    8. Facultatif : Pour afficher le chemin d’accès à un iframe, le cas échéant, dans un élément capturé, procédez comme suit.
      1. Dans le volet Écrans et éléments , sélectionnez l’élément.
      2. Sélectionnez l'onglet Avancé.
        L’iframe apparaît.

        iframe apparaît.

      3. Dans la liste Localisateur , sélectionnez un localisateur pour trouver le chemin d’accès à l’iframe.
        Localisateur iFrame.
    9. Facultatif : Cliquez avec le bouton droit sur l’écran ou l’élément de l’application pour effectuer des opérations supplémentaires.
      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.
    10. Sélectionnez Terminé une fois que vous avez terminé la configuration des écrans ou des éléments de votre application.
      Les écrans de l’application et leurs éléments apparaissent sous l’objet UAC dans Global Objects.
    11. Double-cliquez sur l’écran ou l’élément de l’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 du 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, voir 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.

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