Méthodes du connecteur Java

  • Rversion finale: Zurich
  • Mis à jour 31 juil. 2025
  • 9 minutes de lecture

    • Le connecteur Java expose les méthodes au niveau du connecteur, de l’écran et de l’élément. Bien que tous les types d’éléments aient des méthodes communes, ils ont également des méthodes différentes.

    Méthodes au niveau du connecteur

    Début

    Démarre l’application Java à partir de son emplacement et la ramène au focus.
    Remarque :
    Vous devez d’abord exécuter cette méthode.

    Pour fournir des entrées aux paramètres, reportez-vous à la section Configurer les propriétés des ports.

    Tableau 1. Paramètres de la méthode de démarrage
    Paramètre Description Type de port de données Type de données Valeur par défaut Obligatoire ?
    Chemin d'accès Chemin d’accès à l’application Java dans le lecteur local. Données dans Chaîne Aucun Oui
    Args Arguments en faveur du chemin d’accès. Données dans Chaîne Aucun Non

    GetMainWindowHandle

    Renvoie le descripteur de fenêtre de l’application Java lancé par la méthode Start.

    Tableau 2. Paramètres de méthode GetMainWindowHandle
    Paramètre Description Type de port de données Type de données Valeur par défaut Obligatoire ?
    Retour Renvoie le handle de fenêtre de l’application. Sortie de données Entier Aucun Non applicable

    GetMainWindowTitle

    Renvoie le titre de la fenêtre de l’application Java.

    Tableau 3. Paramètres de méthode GetMainWindowTitle
    Paramètre Description Type de port de données Type de données Valeur par défaut Obligatoire ?
    Retour Renvoie le titre de la fenêtre de l’application. Sortie de données Chaîne Aucun Non applicable

    Fermer la fenêtre principale

    Ferme la fenêtre principale de l’application Java.

    Terminer

    Met fin à la fenêtre principale de l’application Java.

    Méthodes au niveau de l’écran

    Fermer

    Ferme la fenêtre de l’application Java active.

    Foyer

    Si la fenêtre de l’application Java est réduite ou s’exécute en arrière-plan, la méthode restaure le focus.

    GetFields

    Obtient les données des champs de texte dans une application Java. Vous devez d’abord configurer les champs de texte. Pour configurer, procédez comme suit.
    1. Configurer le connecteur Java et capturez un ou plusieurs champs de texte.
    2. Exposez les méthodes au niveau de l’écran. Consultez Utiliser la méthode du connecteur.
    3. Dans la fenêtre Explorateur d’objets, faites glisser la méthode GetFields vers l’aire de conception.
    4. Cliquez sur l’icône Paramètres de méthode ( Icône Paramètres de méthode.).
    5. Sélectionnez un ou plusieurs champs de texte.
    6. Mettez à jour le type de données du champ de texte.
    7. Pour fermer la fenêtre CHOISIR DES ÉLÉMENTS DE FORMULAIRE, cliquez sur OK.

      Un port de sortie de données est créé pour chaque champ de texte que vous sélectionnez.

    La méthode GetFields peut maintenant retourner les données contenues dans les champs de texte.

    GetInstanceCount

    Renvoie le nombre total d’instances ouvertes de l’application Java.

    Tableau 4. Paramètres de la méthode GetInstanceCount
    Paramètre Description Type de port de données Type de données Valeur par défaut Obligatoire ?
    Retour Renvoie le nombre total d’instances ouvertes de l’application Java. Sortie de données Entier Aucun Non applicable

    GetScreenShot

    Capture et renvoie la capture d’écran de l’application Java.

    Tableau 5. Paramètres de la méthode GetInstanceCount
    Paramètre Description Type de port de données Type de données Valeur par défaut Obligatoire ?
    Retour Renvoie la capture d’écran de l’écran de l’application Java. Sortie de données Image matricielle Aucun Non applicable

    GetWindowHandle

    Renvoie le Windows numéro de traitement de la fenêtre de l’écran de l’application Java.

    Tableau 6. Paramètres de la méthode GetInstanceCount
    Paramètre Description Type de port de données Type de données Valeur par défaut Obligatoire ?
    Retour Renvoie le Windows numéro de traitement de la fenêtre de l’écran de l’application Java. Sortie de données Entier Aucun Non applicable

    IsCreated

    Renvoie la réponse booléenne selon que les règles d’une fenêtre configurée correspondent ou non. Lorsque vous configurez un écran d’application Java, la section RÈGLES DE CORRESPONDANCE de la fenêtre du connecteur Java affiche certaines règles qui correspondent à l’écran configuré. La méthode correspond aux mêmes règles.

    Pour fournir des entrées aux paramètres, reportez-vous à la section Configurer les propriétés des ports.

    Tableau 7. Paramètres de la méthode IsCreated
    Paramètre Description Type de port de données Type de données Valeur par défaut Obligatoire ? Notes
    MatchAllChildren Renvoie la réponse booléenne après avoir mis en correspondance les règles des éléments de l’écran. Données dans Booléen Aucun Non Ce paramètre est pertinent si vous capturez un ou plusieurs éléments.
    Retour Renvoie la réponse booléenne indiquant si les règles de l’écran de l’application Java que vous avez configuré correspondent. Sortie de données Booléen Zéro Non applicable

    Agrandir

    Agrandit la fenêtre de l’application Java.

    Réduire

    Réduit la fenêtre de l’application Java.

    Action de la souris

    Effectue différentes actions de l’appareil de la souris sur l’application Java, telles que le clic gauche, le clic droit et le clic central.

    Pour fournir des entrées aux paramètres, reportez-vous à la section Configurer les propriétés des ports.

    Tableau 8. Paramètres de méthode MouseAction
    Paramètre Description Type de port de données Type de données Valeur par défaut Obligatoire ?
    Action Spécifie l’action de la souris de l’appareil. Données dans Entrée de l’appareil de la souris Aucun Oui
    Cliquer au milieu Si un clic central sera effectué. Données dans Booléen Aucun Non

    Redimensionner

    Modifie la largeur, la hauteur et la position de la fenêtre de l’application Java le long des axes X et Y.

    Pour fournir des entrées aux paramètres, reportez-vous à la section Configurer les propriétés des ports.

    Tableau 9. Paramètres de méthode de redimensionnement
    Paramètre Description Type de port de données Type de données Valeur par défaut Obligatoire ?
    xPos Position de la fenêtre sur l’écran le long de l’axe X. Données dans Entier Aucun Non
    yPos Position de la fenêtre sur l’écran le long de l’axe Y. Données dans Entier Aucun Non
    Largeur Largeur de la fenêtre. Données dans Entier Aucun Non
    Hauteur Hauteur de la fenêtre. Données dans Entier Aucun Non

    Restaurer

    Restaure les dimensions d’origine de la fenêtre de l’application Java. Vous pouvez utiliser la méthode après avoir exécuté des méthodes telles que Agrandir et Minimiser.

    Clés d’envoi

    Envoyer n’importe quelle entrée de données ou clavier au champ actif de l’application Java. Par exemple, vous pouvez envoyer une chaîne de données « RPA » ou une saisie clavier [Espace] pour décocher une case.

    Pour fournir des entrées aux paramètres, reportez-vous à la section Configurer les propriétés des ports.

    Tableau 10. Paramètres de la méthode WaitForCreate
    Paramètre Description Type de port de données Type de données Valeur par défaut Obligatoire ?
    Clés Envoie les données ou l’entrée du clavier au champ actif. Données dans Chaîne Aucun Oui
    Valeur ClearExistingValue Avant d’envoyer des données ou des entrées au clavier, efface toute valeur existante dans le champ actif. Données dans Booléen Aucun Non
    TypeDelay Définit un délai avant l’envoi de toute entrée de données ou clavier au champ actif. Données dans Entier Aucun Non

    SetFields

    Définir un texte personnalisé dans les éléments du champ de texte capturés à partir de l’écran de l’application Java.

    Pour utiliser la méthode, procédez comme suit.
    1. Dans l’Explorateur d’objets, faites glisser la méthode SetFields vers l’aire de conception.
    2. Cliquez sur l’icône Paramètres de méthode ( Icône Paramètres de méthode.).
    3. Sélectionnez un ou plusieurs champs de texte.
    4. Mettez à jour le type de données du champ de texte.
    5. Cliquez sur OK.

      Un port d’entrée de données est créé pour chaque champ de texte sélectionné. Vous pouvez transmettre la chaîne à définir dans les champs de l’application Java.

      Pour fournir des entrées aux paramètres, reportez-vous à la section Configurer les propriétés des ports.

    Attendre pour créer

    Chaque écran que vous configurez dans le connecteur Java est identifié par certaines règles, affichées dans la section RÈGLES DE CORRESPONDANCE de la fenêtre du connecteur Java. La méthode renvoie une réponse booléenne selon que les règles de l’écran que vous avez configurées correspondent.

    Pour fournir des entrées aux paramètres, reportez-vous à la section Configurer les propriétés des ports.

    Tableau 11. Paramètres de la méthode WaitForCreate
    Paramètre Description Type de port de données Type de données Valeur par défaut Obligatoire ?
    timeoutinSeconds Délai après lequel l’opération de la méthode expire. Données dans Entier Aucun Non
    MatchAllChildren Renvoie la réponse booléenne après avoir mis en correspondance les règles des éléments de l’écran. Données dans Booléen Aucun Non
    Retour Renvoie la réponse booléenne indiquant si les règles de l’écran de l’application Java que vous avez configuré correspondent. Sortie de données Booléen Aucun Non

    Méthodes au niveau de l’élément

    GetAccessibleActions

    Renvoie la liste des actions que vous pouvez effectuer sur un élément. Par exemple, pour un bouton, il renvoie Clic.
    Tableau 12. Paramètres de méthode GetText
    Paramètre Description Type de port de données Type de données Valeur par défaut Obligatoire ?
    Retour Renvoie la liste des actions que vous pouvez effectuer sur un élément. Sortie de données Liste Aucun Non applicable

    GetInstanceCount

    Renvoie le nombre total d’un type d’élément dans l’application Java. Par exemple, si une application comporte trois zones de texte, le nombre d’instances est de 3.

    Tableau 13. Paramètres de méthode GetText
    Paramètre Description Type de port de données Type de données Valeur par défaut Obligatoire ?
    Retour Renvoie le nombre d’instances d’un type d’élément dans l’application. Sortie de données Entier Aucun Non applicable

    GetText

    Renvoie le texte de l’élément de zone de texte capturé dans l’application Java. Pour capturer plusieurs textes à partir de plusieurs zones de texte, vous devez configurer plusieurs éléments de zone de texte.

    Tableau 14. Paramètres de méthode GetText
    Paramètre Description Type de port de données Type de données Valeur par défaut Obligatoire ?
    Texte Renvoie le texte contenu dans la zone de texte de l’application Java. Sortie de données Chaîne Aucun Non applicable

    IsCreated

    Renvoie la réponse booléenne selon que les règles de l’élément que vous avez configuré correspondent ou non.

    Tableau 15. Paramètres de la méthode IsCreated
    Paramètre Description Type de port de données Type de données Valeur par défaut Obligatoire ?
    Retour Renvoie la réponse booléenne selon que les règles de l’élément que vous avez configuré correspondent ou non. Sortie de données Booléen null Non applicable

    Clic sur la souris

    Effectue un clic gauche de la souris sur l’élément capturé.

    Action d’exécution

    Effectue l’action spécifiée sur un élément. Par exemple, cliquez sur un bouton. Chaque élément permet un ensemble d’actions que vous pouvez obtenir en exécutant la méthode GetAccessibleActions.

    Pour fournir des entrées aux paramètres, reportez-vous à la section Configurer les propriétés des ports.

    Tableau 16. Paramètres de la méthode IsCreated
    Paramètre Description Type de port de données Type de données Valeur par défaut Obligatoire ? Notes
    Action Accepte l’action à effectuer sur l’élément. Données dans Chaîne Aucun Oui

    Vous devez spécifier l’action exactement au format donné par la méthode GetAccessibleActions.
    Retour Renvoie la valeur Vrai si l’action a été effectuée, sinon la valeur est Faux. Sortie de données Booléen Aucun Non applicable

    Définir le mot de passe

    Automatisez la saisie sécurisée du mot de passe dans le champ mot de passe d’une application Java.

    Pour fournir des entrées aux champs, reportez-vous à la section Configurer les propriétés des ports.
    Tableau 17. Paramètres de la méthode SetPassword
    Paramètre Description Type de port de données Type de données Valeur par défaut Obligatoire ? Notes
    Mot de passe Accepte le mot de passe comme une chaîne sécurisée. Données dans Chaîne sécurisée Aucun Oui Comme il accepte le mot de passe comme une chaîne sécurisée, il n’affiche la longueur de la chaîne que lorsque vous cliquez avec le bouton droit sur le paramètre, puis cliquez sur Prévisualiser les données.
    UseSendKeys SendKeys est une méthode utilisée pour envoyer des entrées clavier telles que des caractères, des chiffres et des symboles à des zones de texte à l’intérieur d’une application. Données dans Booléen Faux Oui
    Conseil :
    Si la méthode SetPassword ne parvient pas à saisir le mot de passe dans le champ mot de passe, définissez la valeur sur Vrai et exécutez à nouveau la méthode.