Utiliser le connecteur d’application universel

  • Rversion finale: Xanadu
  • Mis à jour 1 août 2024
  • 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 unifié unique et capturez les écrans, 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

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

    Rôle requis : aucun

    Procédure

    1. Dans le volet Boîte à outils, accédez à Connectors, puis faites glisser Universal App Connector to Global Objects ( Connecteur d’application universel ) vers Global Objects (Objets globaux ) dans le volet de l’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 de démarrage, consultez Utiliser la méthode de démarrage.
      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, suivez les étapes ci-dessous.
      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 ( Choisir à partir d’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 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 Type d’application.
        Par exemple, si vous sélectionnez Chrome, seules les pages Web Google Chrome s’affichent 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 terminée, vous pouvez capturer les éléments de 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 de l’application sélectionnée apparaissent sous le volet Propriétés.
      6. Facultatif : Mettez à jour l’écran Nom de l’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 à 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 de l’application que vous avez capturé et la boîte de dialogue des éléments de capture s’affiche.

        La boîte de dialogue de mise au point et de capture de l’écran capturé 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 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 des règles de correspondance fournies afin d’identifier l’écran de manière unique.
      Au cours de 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 des écrans.

      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’occurrences, le cas échéant, apparaît lorsque vous actualisez l’élément capturé, indiqué entre crochets en rouge. Dans ce cas, vous devez modifier les attributs pour sélectionner exactement l’élément à automatiser. 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 des sections Locator (Localisateur ) et Match Attributes (Attributs d’appariement ) afin d’identifier un élément de manière unique.
      Au cours de 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é.

      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.
      Le contrôle de compte d’utilisateur fournit plusieurs types de localisateurs. Par exemple, le localisateur XPath fournit le XPath à l’élément.

      Localisateurs d’éléments.

      1. Sous la fenêtre Screens and elements (É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.
        Ssé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 Shadow DOM, le sélecteur CSS affiche le chemin avec les éléments DOM Shadow. Par exemple, html > corps > 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 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 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 renseigne 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 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é, suivez les étapes ci-dessous.
      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.

        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 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 les é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é de configurer 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 de l’application requise et le volet Explorateur d’objets s’affiche et répertorie 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.
    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.