Méthodes du connecteur Java

  • Rversion finale: Xanadu
  • Mis à jour 1 août 2024
  • 9 minutes de lecture

    • Le connecteur Java expose les méthodes aux niveaux 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 l’amène au focus.
    Remarque :
    Vous devez d’abord exécuter cette méthode.

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

    Tableau 1. Paramètres de 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. Données dans Chaîne Aucun Non

    Obtenir MainWindowHandle

    Renvoie le descripteur de la fenêtre de l’application Java lancée 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 descripteur Window de l’application. Sortie de données Entier Aucun Non applicable

    Obtenir le titre de la fenêtre principale

    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

    FermerMainWindow

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

    Interrompre

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

    Focus

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

    Obtenir des champs

    Obtient les données des champs de texte dans une application Java. Vous devez d’abord configurer les champs de texte. Pour le configurer, procédez comme suit.
    1. Configurer le connecteur Java et capturez un ou plusieurs champs de texte.
    2. Exposer les méthodes au niveau de l’écran. Consultez Utiliser la méthode du connecteur.
    3. À partir du volet Explorateur d’objets, faites glisser la méthode GetFields vers l’aire de conception.
    4. Cliquez sur l’icône des paramètres de méthode (icône des 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 LES ÉLÉMENTS DU 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 désormais renvoyer les données contenues dans les champs de texte.

    Obtenir un nombre d’instances

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

    Tableau 4. Paramètres de 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 de l’application Java ouvertes. Sortie de données Entier Aucun Non applicable

    Obtenir une capture d’écran

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

    Tableau 5. Paramètres de 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 handle de la fenêtre de l’écran de l’application Java.

    Tableau 6. Paramètres de 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 handle de la fenêtre de l’écran de l’application Java. Sortie de données Entier Aucun Non applicable

    IsCreated (Créé le )

    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 dans les 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 (en anglais seulement) 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 pour indiquer si les règles de l’écran d’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 la souris sur l’application Java, telles que un clic gauche, un clic droit et un clic central.

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

    Tableau 8. Paramètres de la 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 l’appareil de la souris. Données dans Entrée de l’appareil utilisé avec la souris Aucun Oui
    Cliquer sur Milieu Indique 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 dans les paramètres, reportez-vous à la section Configurer les propriétés des ports.

    Tableau 9. Paramètres de la 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 Réduire.

    SendKeys (Envoyer des clés)

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

    Pour fournir des entrées dans les 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 au clavier dans le champ actif. Données dans Chaîne Aucun Oui
    ClearExistingValue (en anglais seulement) Avant d’envoyer des données ou une saisie au clavier, efface toute valeur existante dans le champ actif. Données dans Booléen Aucun Non
    Délai de type Définit un délai avant l’envoi de données ou d’une entrée au clavier au champ actif. Données dans Entier Aucun Non

    Champs définis

    Définissez 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. À partir de l’Explorateur d’objets, faites glisser la méthode SetFields vers l’aire de conception.
    2. Cliquez sur l’icône des paramètres de méthode (icône des 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 que vous sélectionnez. Vous pouvez transmettre la chaîne à définir dans les champs de l’application Java.

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

    AttendreCréer

    Chaque écran que vous configurez dans le connecteur Java est identifié par des règles, affichées dans la section RÈGLES DE CORRESPONDANCE de la fenêtre 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 dans les 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 Heure après laquelle le fonctionnement de la méthode expire. Données dans Entier Aucun Non
    MatchAllChildren (en anglais seulement) 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 pour indiquer si les règles de l’écran d’application Java que vous avez configuré correspondent. Sortie de données Booléen Aucun Non

    Méthodes au niveau des éléments

    GetAccessibleActions

    Renvoie la liste des actions que vous pouvez effectuer sur un élément. Par exemple, pour un bouton, 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

    Obtenir un nombre d’instances

    Renvoie le nombre total d’un type d’élément dans l’application Java. Par exemple, s’il y a trois zones de texte dans une application, 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

    Obtenir du texte

    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 (Créé le )

    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 de souris

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

    PerformAction (en anglais seulement)

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

    Pour fournir des entrées dans les 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 dans les 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 Étant donné qu’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 de la souris sur le paramètre, puis cliquez sur Prévisualiser les données.
    UseSendKeys (en anglais seulement) 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 password, définissez la valeur sur True et exécutez à nouveau la méthode.