Méthodes du connecteur Java

Méthodes au niveau du connecteur

Début

Démarre l’application Java à partir de son emplacement et la met au point.

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 du port.

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?	Notes
Chemin d'accès	Chemin d’accès à l’application Java dans le lecteur local.	Données dans	Chaîne	Aucun	Oui
Args	Arguments pour le chemin d’accès.	Données dans	Chaîne	Aucun	Non

GetMainWindowHandle

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

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

GetMainWindowTitle

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

Tableau 3. Paramètres de la méthode GetMainWindowTitle
Paramètre	Description	Type de port de données	Type de données	Valeur par défaut	Obligatoire?	Notes
Retour	Renvoie le titre de la fenêtre de l’application.	Données sortantes	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 s’exécute en arrière-plan, la méthode restaure le focus.

GetFields (Obtenir des champs)

Obtient les données des champs de texte d’une application Java. Vous devez d’abord configurer les champs de texte. Pour effectuer la configuration, procédez comme suit.

Configurer le connecteur Java et capturez un ou plusieurs champs de texte.
Exposez les méthodes au niveau de l’écran. Consultez Utiliser la méthode du connecteur.
Dans la fenêtre Object Explorer (Explorateur d’objets), faites glisser la méthode GetFields vers l’aire de conception.
Cliquez sur l’icône des paramètres de la méthode ( ).
Sélectionnez un ou plusieurs champs de texte.
Mettez à jour le type de données du champ de texte.
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 renvoyer les données contenues dans les champs de texte.

GetInstanceCount

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

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?	Notes
Retour	Renvoie le nombre total d’instances de l’application Java ouvertes.	Données sortantes	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 la méthode GetInstanceCount
Paramètre	Description	Type de port de données	Type de données	Valeur par défaut	Obligatoire?	Notes
Retour	Renvoie la capture d’écran de l’écran de l’application Java.	Données sortantes	Bitmap	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 la méthode GetInstanceCount
Paramètre	Description	Type de port de données	Type de données	Valeur par défaut	Obligatoire?	Notes
Retour	Renvoie le Windows numéro de handle de la fenêtre de l’écran de l’application Java.	Données sortantes	Entier	Aucun	Non applicable

IsCreated (Créé par le système)

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 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 du port.

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 à la question de savoir si les règles de l’écran d’application Java que vous avez configuré correspondent.	Données sortantes	Booléen	Null	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 clic gauche, clic droit et clic central.

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

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?	Notes
Action	Spécifie l’action de l’appareil de la souris.	Données dans	Entrée de l’appareil de la souris	Aucun	Oui
Cliquez 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 aux paramètres, reportez-vous à la section Configurer les propriétés du port.

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 n’importe quelle entrée de données ou de clavier dans le champ actif de l’application Java. Par exemple, vous pouvez envoyer des données de chaîne « RPA » ou une entrée clavier [Espace] pour désélectionner une case à cocher.

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

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 au champ actif.	Données dans	Chaîne	Aucun	Oui
ClearExistingValue (Effacer la valeur existante)	Avant d’envoyer une entrée de données ou de 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 d’envoyer des données ou une entrée clavier au champ actif.	Données dans	Entier	Aucun	Non

Définir les champs

Définissez le texte personnalisé dans les éléments de champ de texte capturés à partir de l’écran de l’application Java.

Pour utiliser la méthode, procédez comme suit.

Dans l’Explorateur d’objets, faites glisser la méthode SetFields vers la surface de conception.
Cliquez sur l’icône des paramètres de la méthode ( ).
Sélectionnez un ou plusieurs champs de texte.
Mettez à jour le type de données du champ de texte.
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 aux paramètres, reportez-vous à la section Configurer les propriétés du port.

AttendreCré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 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 ou non.

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

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 l’opération 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 à la question de savoir si les règles de l’écran d’application Java que vous avez configuré correspondent.	Données sortantes	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, elle renvoie Clic.

Tableau 12. Paramètres de la méthode GetText
Paramètre	Description	Type de port de données	Type de données	Valeur par défaut	Obligatoire?	Notes
Retour	Renvoie la liste des actions que vous pouvez effectuer sur un élément.	Données sortantes	Liste	Aucun	Non applicable

GetInstanceCount

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

Tableau 13. Paramètres de la méthode GetText
Paramètre	Description	Type de port de données	Type de données	Valeur par défaut	Obligatoire?	Notes
Retour	Renvoie le nombre d’instances d’un type d’élément dans l’application.	Données sortantes	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 la méthode GetText
Paramètre	Description	Type de port de données	Type de données	Valeur par défaut	Obligatoire?	Notes
Texte	Renvoie le texte contenu dans la zone de texte de l’application Java.	Données sortantes	Chaîne	Aucun	Non applicable

IsCreated (Créé par le système)

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?	Notes
Retour	Renvoie la réponse booléenne selon que les règles de l’élément que vous avez configuré correspondent ou non.	Données sortantes	Booléen	null	Non applicable

Clic sur la souris

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

Exécuter une action

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 aux paramètres, reportez-vous à la section Configurer les propriétés du port.

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.	Données sortantes	Booléen	Aucun	Non applicable

SetPassword (Définir un 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 Configurer les propriétés du portà .

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 entrantes	Chaîne sécurisée	Aucun	Oui	Étant donné qu’il accepte le mot de passe en tant que 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.
Utiliser SendKeys	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 au sein d’une application.	Données entrantes	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.