--- sourceDocument: Xanadu : créer des intégrations avec des applications sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/fr-FR/xanadu/integrate-applications Release : - xanadu ft:locale : - fr-FR ft:publication_title : - Xanadu : créer des intégrations avec des applications ft:clusterId : - crint bundleId : - crint workflow : - Creator --- # Méthodes du connecteur Java # Méthodes du connecteur Java {#ariaid-title1} * Rversion finale: Xanadu * * Mis à jour 1 août 2024 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 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 {#java-connector-methods__section_qbh_klh_ntb} ## Début {#java-connector-methods__section_sk4_cxh_ntb} 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](https://servicenow-prod.fluidtopics.net/tcJNdTp_WSjjATOJg4Bxjg "Configurez la façon dont les données sont transmises aux champs d’entrée d’un composant ou d’une méthode dans Studio de conception de bureau de RPA."). {#java-connector-methods__table_vbt_5zy_mtb__entry__6} | 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 | [Tableau 1. Paramètres de méthode de démarrage] {#java-connector-methods__table_vbt_5zy_mtb} ## Obtenir MainWindowHandle {#java-connector-methods__section_xwq_jyh_ntb} Renvoie le descripteur de la fenêtre de l'application Java lancée par la méthode Start. {#java-connector-methods__table_rqj_tyh_ntb__entry__6} | 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 | [Tableau 2. Paramètres de méthode GetMainWindowHandle] {#java-connector-methods__table_rqj_tyh_ntb} ## Obtenir le titre de la fenêtre principale {#java-connector-methods__section_idb_rc3_ntb} Renvoie le titre de la fenêtre de l'application Java. {#java-connector-methods__table_hcn_vc3_ntb__entry__6} | 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 | [Tableau 3. Paramètres de méthode GetMainWindowTitle] {#java-connector-methods__table_hcn_vc3_ntb} ## FermerMainWindow {#java-connector-methods__section_imk_qlh_ntb} Ferme la fenêtre principale de l'application Java. ## Interrompre {#java-connector-methods__section_s1s_dd3_ntb} Ferme la fenêtre principale de l'application Java. ## Méthodes au niveau de l'écran {#java-connector-methods__section_crj_pq3_ntb} ## Fermer {#java-connector-methods__section_cl5_5q3_ntb} Ferme la fenêtre de l'application Java active. ## Focus {#java-connector-methods__section_vvv_vq3_ntb} 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 {#java-connector-methods__section_b2r_dr3_ntb} 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](https://servicenow-prod.fluidtopics.net/h_fAS6mTBPIcZkt4etDVFQ "Configurez le connecteur Java pour configurer les écrans de l’application Java et les éléments sur lesquels l’automatisation sera effectuée. Après la configuration, vous pouvez exposer les méthodes aux niveaux du connecteur, de l’écran et de l’élément.") 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](https://servicenow-prod.fluidtopics.net/zTiS8pPWaJDnRYYreDgaPg "Exposez, puis utilisez les méthodes au sein d’un connecteur pour effectuer toutes les actions que le connecteur peut effectuer."). 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. {#java-connector-methods__ol_p5d_2jn_ntb} La méthode GetFields peut désormais renvoyer les données contenues dans les champs de texte. ## Obtenir un nombre d'instances {#java-connector-methods__section_awc_xmn_ntb} Renvoie le nombre total d'instances de l'application Java ouvertes. {#java-connector-methods__table_wmd_knn_ntb__entry__6} | 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 | [Tableau 4. Paramètres de méthode GetInstanceCount] {#java-connector-methods__table_wmd_knn_ntb} ## Obtenir une capture d'écran {#java-connector-methods__section_yqf_snn_ntb} Capture et renvoie la capture d'écran de l'écran de l'application Java. {#java-connector-methods__table_ex3_14n_ntb__entry__6} | 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 | [Tableau 5. Paramètres de méthode GetInstanceCount] {#java-connector-methods__table_ex3_14n_ntb} ## GetWindowHandle {#java-connector-methods__section_vbl_24n_ntb} Renvoie le Windows numéro de handle de la fenêtre de l'écran de l'application Java. {#java-connector-methods__table_lqh_k4n_ntb__entry__6} | 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 | [Tableau 6. Paramètres de méthode GetInstanceCount] {#java-connector-methods__table_lqh_k4n_ntb} ## IsCreated (Créé le ) {#java-connector-methods__section_r2p_n4n_ntb} 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](https://servicenow-prod.fluidtopics.net/tcJNdTp_WSjjATOJg4Bxjg "Configurez la façon dont les données sont transmises aux champs d’entrée d’un composant ou d’une méthode dans Studio de conception de bureau de RPA."). {#java-connector-methods__table_fyl_4rn_ntb__entry__7} | 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 | | [Tableau 7. Paramètres de la méthode IsCreated] {#java-connector-methods__table_fyl_4rn_ntb} ## Agrandir {#java-connector-methods__section_m22_hsn_ntb} Agrandit la fenêtre de l'application Java. ## Réduire {#java-connector-methods__section_utg_3sn_ntb} Réduit la fenêtre de l'application Java. ## Action de la souris {#java-connector-methods__section_tyh_zsn_ntb} 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](https://servicenow-prod.fluidtopics.net/tcJNdTp_WSjjATOJg4Bxjg "Configurez la façon dont les données sont transmises aux champs d’entrée d’un composant ou d’une méthode dans Studio de conception de bureau de RPA."). {#java-connector-methods__table_o2h_pbj_4tb__entry__6} | 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 | [Tableau 8. Paramètres de la méthode MouseAction] {#java-connector-methods__table_o2h_pbj_4tb} ## Redimensionner {#java-connector-methods__section_wkg_xtn_ntb} 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](https://servicenow-prod.fluidtopics.net/tcJNdTp_WSjjATOJg4Bxjg "Configurez la façon dont les données sont transmises aux champs d’entrée d’un composant ou d’une méthode dans Studio de conception de bureau de RPA."). {#java-connector-methods__table_c1j_g5n_ntb__entry__6} | 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 | [Tableau 9. Paramètres de la méthode de redimensionnement] {#java-connector-methods__table_c1j_g5n_ntb} ## Restaurer {#java-connector-methods__section_gxy_czn_ntb} 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) {#java-connector-methods__section_ggj_qzn_ntb} 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](https://servicenow-prod.fluidtopics.net/tcJNdTp_WSjjATOJg4Bxjg "Configurez la façon dont les données sont transmises aux champs d’entrée d’un composant ou d’une méthode dans Studio de conception de bureau de RPA."). {#java-connector-methods__table_jsm_rdj_4tb__entry__6} | 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 | [Tableau 10. Paramètres de la méthode WaitForCreate] {#java-connector-methods__table_jsm_rdj_4tb} ## Champs définis {#java-connector-methods__section_pbn_t14_ntb} 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](https://servicenow-prod.fluidtopics.net/tcJNdTp_WSjjATOJg4Bxjg "Configurez la façon dont les données sont transmises aux champs d’entrée d’un composant ou d’une méthode dans Studio de conception de bureau de RPA."). {#java-connector-methods__ol_fhp_db4_ntb} ## AttendreCréer {#java-connector-methods__section_wjj_xb4_ntb} 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](https://servicenow-prod.fluidtopics.net/tcJNdTp_WSjjATOJg4Bxjg "Configurez la façon dont les données sont transmises aux champs d’entrée d’un composant ou d’une méthode dans Studio de conception de bureau de RPA."). {#java-connector-methods__table_tyw_hc4_ntb__entry__6} | 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 | [Tableau 11. Paramètres de la méthode WaitForCreate] {#java-connector-methods__table_tyw_hc4_ntb} ## Méthodes au niveau des éléments {#java-connector-methods__section_rmv_rtp_ntb} ## GetAccessibleActions {#java-connector-methods__section_zpq_t1c_4tb} Renvoie la liste des actions que vous pouvez effectuer sur un élément. Par exemple, pour un bouton, renvoie Clic. {#java-connector-methods__table_t5k_thj_4tb__entry__6} | 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 | [Tableau 12. Paramètres de méthode GetText] {#java-connector-methods__table_t5k_thj_4tb} ## Obtenir un nombre d'instances {#java-connector-methods__section_yzx_mbc_4tb} 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. {#java-connector-methods__table_bxd_v3j_4tb__entry__6} | 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 | [Tableau 13. Paramètres de méthode GetText] {#java-connector-methods__table_bxd_v3j_4tb} ## Obtenir du texte {#java-connector-methods__section_k14_kcc_4tb} 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. {#java-connector-methods__table_akh_pcc_4tb__entry__6} | 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 | [Tableau 14. Paramètres de méthode GetText] {#java-connector-methods__table_akh_pcc_4tb} ## IsCreated (Créé le ) {#java-connector-methods__section_qbp_dlc_4tb} Renvoie la réponse booléenne selon que les règles de l'élément que vous avez configuré correspondent ou non. {#java-connector-methods__table_xzk_lmc_4tb__entry__6} | 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 | [Tableau 15. Paramètres de la méthode IsCreated] {#java-connector-methods__table_xzk_lmc_4tb} ## Clic de souris {#java-connector-methods__section_zf2_yvc_4tb} Effectue un clic gauche de la souris sur l'élément capturé. ## PerformAction (en anglais seulement) {#java-connector-methods__section_c3s_swc_4tb} 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](https://servicenow-prod.fluidtopics.net/tcJNdTp_WSjjATOJg4Bxjg "Configurez la façon dont les données sont transmises aux champs d’entrée d’un composant ou d’une méthode dans Studio de conception de bureau de RPA."). {#java-connector-methods__table_wpx_2wj_4tb__entry__7} | 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 | | [Tableau 16. Paramètres de la méthode IsCreated] {#java-connector-methods__table_wpx_2wj_4tb} ## Définir le mot de passe {#java-connector-methods__section_c2b_zss_vzb} 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](https://servicenow-prod.fluidtopics.net/tcJNdTp_WSjjATOJg4Bxjg "Configurez la façon dont les données sont transmises aux champs d’entrée d’un composant ou d’une méthode dans Studio de conception de bureau de RPA.").{#java-connector-methods__table_jrs_nts_vzb__entry__7} | 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. | [Tableau 17. Paramètres de la méthode SetPassword] {#java-connector-methods__table_jrs_nts_vzb}