Utiliser le connecteur d’application universel

  • Rversion finale: Washingtondc
  • Mis à jour 1 févr. 2024
  • 6 minutes de lecture

    • Créez des automatisations pour vos Windowsapplications , Java Google Chromeet Edge basées sur un navigateur à l’aide du connecteur d’application universel (UAC). Configurez les applications à partir d’un connecteur unifié unique 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 construire votre automatisation.

    Avant de commencer

    Assurez-vous que vous disposez d’applications Java Google Chromeou d’applications ouvertes ou Edge activesWindows.

    Rôle requis : aucun

    Procédure

    1. Dans le volet Boîte à outils, accédez à Connecteurs et faites glisser Universal App Connector 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 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 des écrans ou des éléments d’application. Pour plus d’informations sur l’utilisation de la méthode Start, consultez Utiliser la méthode Start.
      Les méthodes s’affichent 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 dans une fenêtre ouverte ( Choisir dans une fenêtre déroulante ouverte.) et sélectionnez un écran d’application.
        Ouvrez les applications.
        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 récemment 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 selon 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.
        Une fois cette étape effectuée, vous pouvez capturer les éléments à l’écran pour effectuer des actions.
        L’écran de l’application s’affiche 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 sous le volet Écrans et éléments.
        Les informations de l’écran d’application sélectionnée s’affichent sous le volet Propriétés.
      6. Facultatif : Mettez à jour le nom de l’écran de l’application dans le champ Nom et 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 à partir de l’écran, sous le volet Écran et éléments, cliquez avec le bouton droit de la souris sur l’écran ajouté et sélectionnez Capturer l’élément.
        Option Capturer l’élément.
        Le focus est défini sur l’écran d’application que vous avez capturé et la boîte de dialogue Capturer les éléments apparaît.

        La boîte de dialogue Écran capturé est mise au point et 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, reportez-vous à la section Utiliser la boîte de dialogue Capturer l’élément.

        Les éléments de l’écran capturé apparaissent sous l’écran de l’application capturée sous forme d’éléments.

        Contrôles de l’écran capturé.

    5. Facultatif : Utilisez les règles de correspondance d’écran pour modifier les valeurs des règles de correspondance fournies afin d’identifier l’écran de façon unique.
      Pendant l’exécution, le module d’extension doit identifier l’écran cible de manière unique pour automatiser les actions sur l’écran. Le titre ou l’URL de l’écran d’application sont des exemples d’attributs. Les attributs apparaissent sous 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 d’abord l’écran et effectuer des actions sur des é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, apparaît lorsque vous actualisez l’élément capturé, est indiqué entre parenthèses 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ément pour modifier les valeurs des sections Locator (Localisateur ) et Match Attributes (Attributs d’appariement ) fournies 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 d’abord l’écran et 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é.

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

    7. Facultatif : Utilisez les localisateurs des éléments capturés pour rechercher 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. Sous le volet Écrans et éléments, sélectionnez un élément sous un écran.
      2. Dans la liste Locator (Localisateur ), sélectionnez l’un des localisateurs d’éléments.
        Tableau 1. Localisateurs d’éléments d’écran
        Type de localisateur Type d'application 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.
        CssSelector 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 d’accès avec les éléments DOM shadow. Par exemple, html > body > shop-app > /ShadowDom/ > app-header[id="header"] > app-toolbar > div :nth-of-type(3) > un > papier-icon-button > /ShadowDom/ > iron-icon[id="icon"]
        Tagname 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 le 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 Type , le connecteur UAC remplit le champ Value (Valeur) avec le type de l’élément.
        Chemin d'accès Java et Windows Vous 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 renseigne le champ Value avec le chemin d’accès de l’élément.
        Chemin d’accès personnalisé Windows Permet d’affiner ou de découper le tracé d’un élément.
    8. Facultatif : Pour afficher le chemin d’accès à un iframe, le cas échéant, dans un élément capturé, effectuez les étapes suivantes.
      1. Dans la fenêtre Screens and elements (Écrans et éléments ), sélectionnez l’élément.
      2. Sélectionnez l'onglet Avancé.
        L’iframe s’affiche.

        L’iframe s’affiche.

      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 de la souris sur l’écran ou l’élément d’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 éléments d’application, reportez-vous à la section Options supplémentaires pour les écrans et les éléments d’application dans Universal App Connector.
    10. Sélectionnez Terminé une fois que vous avez terminé la configuration de vos écrans ou éléments d’application.
      Les écrans d’application et leurs éléments apparaissent sous l’objet UAC dans les objets globaux.
    11. Double-cliquez sur l’écran ou l’élément d’application requis et le volet Explorateur d’objets s’affiche, répertoriant les 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 du connecteur Java, consultez Méthodes du connecteur Java.

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

      • Pour plus d’informations sur les méthodes du connecteur Windows, voir Méthodes du 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 d’application, puis enregistrez l’automatisation.