interface utilisateur IA-Connect
IA-Connect est une plateforme Robot Process Automation « RPA » qui ajoute des fonctionnalités RPA du cloud aux machines virtuelles locales ou via des connexions Citrix ou Bureau à distance Microsoft . Il s’agit du module pour l’automatisation de l’interface utilisateur de l’application Windows « UIA ».
Ce connecteur est disponible dans les produits et régions suivants :
| Service | classe | Régions |
|---|---|---|
| Copilot Studio | Premium | Toutes les régions Power Automate , à l’exception des éléments suivants : - Us Government (GCC) - Us Government (GCC High) - China Cloud géré par 21Vianet - Us Department of Defense (DoD) |
| Applications logiques | Norme | Toutes les régions Logic Apps , à l’exception des suivantes : - Régions Azure Government - Régions Azure Chine - Us Department of Defense (DoD) |
| Power Apps | Premium | Toutes les régions Power Apps , à l’exception des suivantes : - Us Government (GCC) - Us Government (GCC High) - China Cloud géré par 21Vianet - Us Department of Defense (DoD) |
| Power Automate | Premium | Toutes les régions Power Automate , à l’exception des éléments suivants : - Us Government (GCC) - Us Government (GCC High) - China Cloud géré par 21Vianet - Us Department of Defense (DoD) |
| Contact | |
|---|---|
| Nom | Ultima Labs |
| URL | https://www.ultima.com/ultima-labs |
| Messagerie électronique | IAConnect@ultima.com |
| Métadonnées du connecteur | |
|---|---|
| Éditeur | Ultima Business |
| Site internet | https://www.ultima.com/ultima-labs |
| Politique de confidentialité | https://www.ultima.com/privacy-policy |
| Catégories | Opérations informatiques ; Productivité |
IA-Connect est une plateforme RPA (Robot Process Automation) qui ajoute des fonctionnalités RPA de Power Automate Cloud Flow à des machines virtuelles locales ou via des connexions Citrix ou Bureau à distance (RDS). Les connecteurs IA-Connect fournissent plus de 800 actions, ce qui vous permet d’automatiser chaque type d’application locale directement à partir d’un flux cloud Power Automate. Toutes les actions de IA-Connect sont disponibles directement à partir de votre flux Cloud Power Automate, ce qui facilite l’intégration entre les applications cloud et locales, la possibilité d’exploiter les conditions Power Automate existantes, les boucles, le contenu dynamique, les expressions et la gestion des exceptions dans vos processus RPA. L’utilisation des connecteurs IA-Connect fournit également un historique d’exécution complet et une auditabilité de l’historique des exécutions de flux, tout en supprimant également la nécessité d’avoir une application/console/studio distincte pour développer vos processus RPA.
Prerequisites
Pour utiliser l’un des connecteurs IA-Connect, vous devez installer le logiciel IA-Connect. Il est gratuit de tester pendant 30 jours, après quoi vous aurez besoin d’une licence IA-Connect.
Le logiciel IA-Connect se compose de deux composants principaux :
Le IA-Connect Orchestrator, qui est une application web Azure que vous hébergeriez dans votre propre locataire Azure. Cela gère le routage et la sécurité des flux RPA vers une ou plusieurs machines virtuelles locales ou cloud.
L’agent et le directeur IA-Connect, installés sur les machines virtuelles où le logiciel que vous souhaitez automatiser est accessible. En outre, l’agent IA-Connect peut s’exécuter à l’intérieur d’une session Citrix ou Microsoft Remote Desktop Services (RDS), où les commandes RPA sont transmises à un canal virtuel dans la session à distance pour l’exécution. L’agent IA-Connect peut être exécuté à partir d’un partage réseau et ne nécessite pas d’installation.
Connecteurs IA-Connect disponibles
Les connecteurs IA-Connect disponibles sont les suivants :
- code dynamique IA-Connect
- IA-Connect Java
- IA-Connect JML
- IA-Connect Mainframe
- IA-Connect Microsoft Office
- IA-Connect GUI SAP
- session IA-Connect
- interface utilisateur IA-Connect
- navigateur web IA-Connect
Comment obtenir des informations d’identification
Pour recevoir votre licence et commencer votre essai gratuit de 30 jours, envoyez une demande sur notre site web (https://www.ultima.com/IA-Connect/Power-Automate).
Une fois qu’une demande d’essai est reçue, nous vous contacterons via l’adresse e-mail fournie pour vous aider à configurer le logiciel IA-Connect et à vous fournir la licence d’évaluation. Il s’agit d’une version d’évaluation complète et vous permet de tester l’une des 800 actions sur les 9 connecteurs IA-Connect au sein de votre propre environnement pendant la période d’évaluation.
Bien démarrer avec votre connecteur
Après avoir envoyé une demande d’essai pour IA-Connect, vous pourrez télécharger un fichier ZIP contenant le logiciel IA-Connect et la documentation couvrant l’installation et la configuration. Nous vous contacterons également pour fournir du support et des conseils au cours du processus d’installation en fonction des besoins.
Support
Pendant la période d’essai, vous pouvez contacter Ultima Labs (IAConnect@ultima.com) pour obtenir du support et de l’aide.
Lors de l’achat de licences IA-Connect, vous recevrez des jetons de support qui peuvent être échangés pour une formation sur mesure ou un support du Centre de services techniques (TSC) basé sur Ultima au Royaume-Uni.
Problèmes connus, erreurs courantes et FAQ
Notre Base de connaissances contient un certain nombre d’articles couvrant les problèmes connus, les erreurs courantes qui peuvent se produire lors de l’utilisation des connecteurs IA-Connect et des questions fréquemment posées. Il est accessible au https://support.ultima.com/ultimalabs niveau du compte et un compte pour accéder à ces ressources est fourni pendant la version d’évaluation IA-Connect et lors de l’achat d’une licence IA-Connect.
Création d’une connexion
Le connecteur prend en charge les types d’authentification suivants :
| Par défaut | Paramètres de création de connexion. | Toutes les régions | Non partageable |
Faire défaut
Applicable : Toutes les régions
Paramètres de création de connexion.
Cette connexion n’est pas partageable. Si l’application power est partagée avec un autre utilisateur, un autre utilisateur est invité à créer une connexion explicitement.
| Nom | Type | Descriptif | Obligatoire |
|---|---|---|---|
| Clé d’API | securestring | Clé API pour cette API | Vrai |
| adresse d’orchestrateur IA-Connect | ficelle | Spécifiez l’adresse IA-Connect Orchestrator sans le composant HTTP(S) | Vrai |
Limitations
| Nom | Appels | Période de renouvellement |
|---|---|---|
| Appels d’API par connexion | 100 | 60 secondes |
Actions
| Activer/désactiver l’élément UIA |
Active un élément (généralement une case à cocher ou une case d’option). Cela donne à l’élément l’état opposé à son état actuel (par exemple, la case à cocher devient décochée et inversement). Si vous souhaitez définir un état spécifique, utilisez plutôt l’action « Vérifier l’élément ». |
| Appuyer sur l’élément UIA |
Appuie sur un élément (généralement un bouton). |
| Attendez que l’image de recherche visible n’existe pas dans l’élément UIA |
Attend qu’une image de recherche, fournie en tant qu’entrée à cette action, ne puisse pas être visiblement située (ou n’a jamais été située) dans un élément UIA à l’écran, ou la durée spécifiée est passée et l’image est toujours présente. L’élément doit d’abord être placé devant, car l’agent prend une capture d’écran sur les coordonnées de l’élément et recherche l’image de recherche fournie dans la capture d’écran. L’élément UIA doit exister à partir du début. L’action se termine immédiatement une fois que l’image n’est plus présente. |
| Attendez que l’élément de bureau UIA n’existe pas |
Attend qu’un élément de bureau (généralement une fenêtre) n’existe plus. |
| Attendre la fenêtre principale du processus UIA |
Action Win32 simple et rapide qui attend une heure spécifiée pour que la fenêtre principale d’un processus (spécifié par nom) existe avant de retourner un handle. La fenêtre « Main » est généralement la fenêtre d’application principale : une boîte de dialogue de connexion ou une sous-fenêtre n’est généralement pas la fenêtre « Main ». Il est recommandé d’utiliser l’action « Wait for Desktop element » qui est plus puissante. |
| Attendre la fenêtre principale id de processus UIA |
Action Win32 simple et rapide qui attend qu’une fenêtre principale d’un processus (spécifié par l’ID de processus) existe et retourne un handle. La fenêtre « Main » est généralement la fenêtre d’application principale : une boîte de dialogue de connexion ou une sous-fenêtre n’est généralement pas la fenêtre « Main ». Il est recommandé d’utiliser l’action « Wait for Desktop element » qui est plus puissante. |
| Attendre la fenêtre Win32 de niveau supérieur UIA |
Action Win32 rapide qui attend une heure spécifiée pour qu’une fenêtre Win32 de niveau supérieur existe avant de retourner un handle UIA. Une fenêtre de niveau supérieur est une fenêtre qui est connectée au bureau. Vous pouvez effectuer une recherche par nom de classe ou par titre de fenêtre, ou vous pouvez spécifier des filtres de recherche plus avancés, y compris des caractères génériques. Bien que cette action utilise des API Win32, elle peut détecter Windows, Java, ModernUI et Windows Web. Il est plus courant d’utiliser l’action UIA « Wait for desktop element » qui est plus puissante, mais cette action Win32 s’exécute généralement plus rapidement. |
| Attendre l’élément de bureau UIA |
Attend qu’un élément de bureau (généralement une fenêtre) existe. |
| Attendre l’élément UIA |
Attend qu’un élément (généralement un élément individuel dans une fenêtre telle qu’un bouton ou une zone d’entrée de texte) existe. |
| Attendre que l’élément UIA n’existe pas |
Attend qu’un élément (généralement un élément individuel dans une fenêtre telle qu’un bouton ou une zone d’entrée de texte) n’existe plus. |
| Attendre une image de recherche visible dans l’élément UIA |
Attend qu’une image de recherche, fournie en tant qu’entrée à cette action, ait été visiblement située dans un élément UIA à l’écran, ou que le temps spécifié soit écoulé. L’élément doit d’abord être placé devant, car l’agent prend une capture d’écran sur les coordonnées de l’élément et recherche l’image de recherche fournie dans la capture d’écran. L’élément UIA doit exister à partir du début. L’action se termine immédiatement une fois l’image située. |
| Capture d’écran de l’emplacement de l’élément UIA |
Prend une capture d’écran de l’emplacement d’un élément et retourne une image. L’élément doit d’abord être mis en avant, car la capture d’écran prend une copie de l’écran à l’emplacement des éléments. |
| Clic de souris double gauche global sur l’élément UIA |
Déplace la souris au centre, ou un bord, un coin ou un décalage choisi, par rapport à un élément UIA, puis double-clique sur le bouton gauche de la souris. |
| Clic droit global sur l’élément UIA |
Déplace la souris au centre, ou un bord choisi, un coin ou un décalage, par rapport à un élément UIA, puis clique sur le bouton droit de la souris. |
| Clic gauche global sur l’élément UIA |
Déplace la souris au centre, ou un bord, un angle ou un décalage choisi, par rapport à un élément UIA, puis clique sur le bouton gauche de la souris. |
| Clic global de la souris centrale sur l’élément UIA |
Déplace la souris au centre, ou un bord, un coin ou un décalage choisi, par rapport à un élément UIA, puis clique sur le bouton de la souris centrale. |
| Cliquez sur la souris globale sur la zone de couleur de recherche d’élément UIA |
Déplace la souris sur une région de pixels au sein d’un élément UIA qui répond aux critères de couleur spécifiés et effectue un clic de souris. L’élément doit d’abord être mis en avant, car la capture d’écran prend une copie de l’écran à l’emplacement des éléments. |
| Cliquez sur élément de liste UIA par index |
Clique sur l’élément de liste qui correspond à l’index spécifié. Il est généralement utilisé pour sélectionner un élément dans une liste déroulante/élément de menu. |
| Cliquez sur élément de liste UIA par nom |
Clique sur l’élément de liste avec le nom spécifié. Il est généralement utilisé pour sélectionner un élément dans une liste déroulante/élément de menu. |
| Dessiner un rectangle autour de l’élément UIA |
Dessine un rectangle autour du périmètre d’un élément pour faciliter l’identification de l’élément trouvé est celui requis. Le rectangle est automatiquement supprimé après 5 secondes. |
| Définir la fenêtre UIA de premier plan |
Apporte une fenêtre au premier plan. |
| Définir la fenêtre UIA sur normale |
Normalise la fenêtre avec le handle UIA spécifié (c’est-à-dire, la définit sur une fenêtre de taille normale au lieu d’être minimisée ou agrandie). |
| Définir le délai d’expiration des transactions UIA |
Contrôle la durée pendant laquelle l’API UIA attend qu’une application retourne les informations relatives à un élément. Ce délai d’expiration des transactions ne serait généralement atteint que si l’application n’était pas réactive. |
| Définir le mode de recherche d’élément UIA |
Choisissez le mode de recherche d’élément UIA qui doit être utilisé par l’agent IA-Connect lors de l’exécution d’actions UIA. En règle générale, cette action n’est utilisée que si vous rencontrez un problème avec le mode par défaut (Rechercher tout). |
| Définir le pourcentage de défilement de l’élément UIA |
Définissez le pourcentage de défilement horizontal et/ou vertical de l’élément spécifié, si le défilement est pris en charge par cet élément. Si l’élément prend en charge le modèle « scroll », vous pouvez appliquer cette action directement à l’élément et spécifier une quantité de défilement horizontale ou verticale (ou les deux). Si l’élément ne prend pas en charge le modèle « scroll », cette action revient aux modèles « valeur de plage » ou « valeur », mais vous devez les appliquer directement aux contrôles de barre de défilement, et non à l’élément lui-même. |
| Définir l’élément UIA sur une valeur de plage numérique |
Définit la valeur de l’élément qui a une plage numérique, par exemple une barre de défilement. |
| Définir l’élément UIA sur une valeur numérique |
Définit la valeur de l’élément qui a une entrée numérique, par exemple un champ de texte ou une barre de défilement. |
| Développer l’élément UIA |
Développe un élément (généralement un menu / élément déroulant). Si l’élément est déjà développé, rien ne se produit. |
| Entrer un mot de passe dans l’élément UIA |
Action UIA qui entre un mot de passe dans un élément (généralement un champ d’entrée de mot de passe), en remplaçant le texte existant. |
| Entrée de texte dans plusieurs éléments UIA |
Action UIA qui insère différents éléments de texte dans plusieurs éléments (généralement des champs d’entrée de texte), remplacez le texte existant ou insérez la nouvelle valeur à une position spécifique. |
| Fermer la fenêtre d’élément UIA |
Ferme la fenêtre d’élément. En règle générale, elle fonctionne uniquement sur les fenêtres ou les dialogues. |
| La fenêtre Win32 de niveau supérieur existe-t-elle |
Action Win32 rapide qui indique si une fenêtre Win32 de niveau supérieur existe. Une fenêtre de niveau supérieur est une fenêtre qui est connectée au bureau. Vous pouvez effectuer une recherche par nom de classe ou par titre de fenêtre, ou vous pouvez spécifier des filtres de recherche plus avancés, y compris des caractères génériques. Bien que cette action utilise des API Win32, elle peut détecter Windows, Java, ModernUI et Windows Web. La fenêtre doit exister, IA-Connect n’attend pas. Il est plus courant d’utiliser l’action UIA « Est-ce que l’élément de bureau UIA existe » qui est plus puissant, mais cette action Win32 s’exécute généralement plus rapidement. |
| Le processus comporte-t-il une fenêtre Win32 |
Action Win32 simple et rapide qui indique si un processus (spécifié par son nom) comporte des fenêtres visibles. La fenêtre doit exister : IA-Connect n’attend pas. Il est recommandé d’utiliser l’action « Wait for Desktop element » qui est plus puissante. |
| L’élément de bureau UIA existe-t-il |
Indique si un élément de bureau existe et fournit des propriétés d’élément de base. |
| L’élément UIA est-il vérifié |
Cette action retourne la valeur true ou false indiquant si un élément (généralement une case à cocher ou une case d’option) est coché. |
| L’élément UIA existe-t-il |
Indique si un élément existe et retourne certaines propriétés d’élément de base. |
| Maximiser la fenêtre UIA |
Optimise la fenêtre avec le handle UIA spécifié. |
| Mot de passe d’entrée global dans l’élément UIA |
Déplace la souris au centre de l’élément, la met au focus, les cliques gauches et appuie sur les touches. Généralement utilisé avec une entrée de mot de passe qui n’accepte pas les méthodes d’entrée UIA natives. |
| Obtenir des modèles d’éléments UIA |
Récupérez les modèles UIA disponibles pour un élément UIA et, par conséquent, quels IA-Connect actions UIA sont susceptibles d’avoir un effet sur l’élément. |
| Obtenir des éléments de bureau UIA |
Retourne une liste de toutes les fenêtres et boîtes de dialogue sur le bureau. |
| Obtenir la valeur de l’élément UIA |
Retourne la valeur d’un élément. Une valeur est généralement associée à une zone d’entrée de texte, mais de nombreux éléments peuvent avoir cette propriété. |
| Obtenir la valeur de l’étiquette d’élément UIA |
Retourne la valeur de l’étiquette sur l’élément. |
| Obtenir la valeur de texte de l’élément UIA |
Retourne la valeur de texte d’un élément. Une valeur de texte est généralement associée à une étiquette, mais de nombreux éléments peuvent avoir cette propriété. |
| Obtenir le contenu de l’élément datagrid UIA |
Retourne le contenu d’un élément datagrid. Il s’agit d’un élément avec des lignes, des colonnes, des en-têtes et des cellules (par exemple, un tableau). Cette action peut également être utilisée pour récupérer les résultats d’une exécution précédente de cette action, exécutée en tant que thread Agent. |
| Obtenir le handle d’élément parent UIA |
Retourne un handle pour l’élément parent de l’élément spécifié. L’élément parent est défini comme l’élément qui se trouve au niveau suivant jusqu’à l’UIA 'tree' et est presque toujours un élément conteneur. |
| Obtenir le handle UIA pour la fenêtre principale de l’ID de processus |
Action Win32 simple et rapide qui retourne le handle pour toute fenêtre principale d’un processus (spécifiée par l’ID de processus). La fenêtre « Main » est généralement la fenêtre d’application principale : une boîte de dialogue de connexion ou une sous-fenêtre n’est généralement pas la fenêtre « Main ». Il est recommandé d’utiliser l’action « Wait for Desktop element » qui est plus puissante. |
| Obtenir le handle UIA pour la fenêtre principale de l’élément focuss |
Retourne un handle pour la fenêtre principale de l’élément UIA actuellement concentré. La fenêtre « Main » est généralement la fenêtre d’application principale : une boîte de dialogue de connexion ou une sous-fenêtre n’est généralement pas la fenêtre « Main ». |
| Obtenir le handle UIA pour la fenêtre principale du processus |
Action Win32 simple et rapide qui retourne le handle pour toute fenêtre principale d’un processus (spécifiée par nom). La fenêtre « Main » est généralement la fenêtre d’application principale : une boîte de dialogue de connexion ou une sous-fenêtre n’est généralement pas la fenêtre « Main ». La fenêtre doit exister : IA-Connect n’attend pas. Il est recommandé d’utiliser l’action « Wait for Desktop element » qui est plus puissante. |
| Obtenir le handle UIA pour la fenêtre Win32 de niveau supérieur |
Action Win32 rapide qui retourne un handle UIA pour toute fenêtre Win32 de niveau supérieur qui a le nom de classe ou le titre de la fenêtre spécifié, ou vous pouvez spécifier des filtres de recherche plus avancés, y compris des caractères génériques. Une fenêtre de niveau supérieur est une fenêtre qui est connectée au bureau. Bien que cette action utilise des API Win32, elle peut détecter Windows, Java, ModernUI et Windows Web. La fenêtre doit exister, IA-Connect n’attend pas. Il est plus courant d’utiliser l’action UIA « Est-ce que l’élément de bureau UIA existe » qui est plus puissant, mais cette action Win32 s’exécute généralement plus rapidement. |
| Obtenir le handle UIA pour le bureau |
Retourne un handle pour le bureau. Il s’agit d’une action obsolète, car le handle « -2 » peut être utilisé pour faire référence à l’élément de bureau, mais aussi parce qu’il existe de nombreuses actions qui peuvent effectuer une recherche par rapport au bureau (par exemple, « attendre l’élément de bureau »). |
| Obtenir le handle UIA pour l’élément focussed |
Retourne un handle pour l’élément UIA actuellement ciblé. |
| Obtenir le mode de recherche d’élément UIA |
Récupère le mode de recherche d’élément UIA utilisé par l’agent IA-Connect pour les actions UIA. |
| Obtenir les fenêtres Win32 |
Action Win32 rapide qui retourne une liste de toutes les fenêtres Win32 qui ont éventuellement le nom de classe ou le titre de la fenêtre spécifié, ou vous pouvez spécifier des filtres de recherche plus avancés, y compris des caractères génériques. Bien que cette action utilise des API Win32, elle peut détecter Windows, Java, ModernUI et Windows Web. Win32 Windows peut inclure des éléments inattendus, notamment la barre des tâches, le bureau, le menu Démarrer, les superpositions transparentes, les fenêtres hors écran ou masquées, de sorte que la liste retournée peut contenir plus de résultats que prévu. |
| Obtenir les propriétés de l’élément datagrid UIA |
Retourne les propriétés de table d’un élément DataGrid. Il s’agit d’un élément avec des lignes, des colonnes, des en-têtes et des cellules (par exemple, un tableau). |
| Obtenir les propriétés d’élément UIA |
Retourne toutes les propriétés d’un élément. Cela peut être utile si vous ne savez pas quel champ contient les valeurs de propriété requises. |
| Obtenir les propriétés d’élément UIA en tant que liste |
Retourne les propriétés d’un élément en tant que liste de lignes unique (collection de lignes unique /table de données) au lieu d’éléments individuels, cela peut être utile en fonction de la façon dont vous envisagez d’utiliser les données. |
| Obtenir les éléments d’élément de liste UIA |
Retourne une liste d’éléments enfants trouvés sous l’élément spécifié (généralement les éléments déroulants/de menu). |
| Obtenir l’élément UIA aux coordonnées de l’écran |
Retourne l’élément UIA situé aux coordonnées de l’écran donnée. |
| Obtenir plusieurs propriétés d’élément parent UIA |
Retourne une arborescence hiérarchique des éléments parents de l’élément spécifié, jusqu’au bureau (niveau racine). L’élément parent est défini comme l’élément qui se trouve au niveau suivant jusqu’à l’UIA 'tree' et est presque toujours un élément conteneur. |
| Obtenir plusieurs propriétés d’élément UIA |
Retourne les propriétés de plusieurs éléments. Cela peut être utile si vous ne savez pas quels champs contiennent les valeurs de propriété requises. |
| Obtenir plusieurs éléments UIA en tant que table |
Énumère les valeurs des éléments enfants d’un élément parent spécifié et retourne dans un format de tableau. Cela peut être utilisé pour renvoyer des lignes et des colonnes de données à partir d’éléments qui ne sont pas techniquesment des tables, mais qui ont été organisées ensemble dans une structure de table. Cette action peut également être utilisée pour récupérer les résultats d’une exécution précédente de cette action, exécutée en tant que thread Agent. |
| Obtenir une zone de couleur de recherche d’élément UIA |
Retourne les détails de la région des pixels au sein d’un élément UIA qui répondent aux critères de couleur spécifiés. L’élément doit d’abord être placé sur le devant, car l’agent localise les couleurs en prenant une capture d’écran aux coordonnées de l’élément. |
| Rechercher le premier élément parent UIA |
Recherche la hiérarchie de l’arborescence UIA pour le premier élément parent qui correspond aux critères de recherche. L’élément parent est défini comme l’élément qui se trouve au niveau suivant jusqu’à l’UIA 'tree' et est presque toujours un élément conteneur. |
| Rechercher une image de recherche visible dans l’élément UIA |
Retourne si une image de recherche, fournie en tant qu’entrée à cette action, a été visiblement située dans un élément UIA à l’écran. L’élément doit d’abord être placé devant, car l’agent prend une capture d’écran sur les coordonnées de l’élément et recherche l’image de recherche fournie dans la capture d’écran. |
| Redimensionner l’élément UIA |
Redimensionne un élément UIA. Cette action fonctionne généralement uniquement avec les éléments Window (qui ont le modèle de transformation). |
| Retour d’entrée dans l’élément UIA |
Insère un retour Windows / nouvelle ligne dans un élément (généralement un champ d’entrée de texte), en remplaçant le texte existant ou en insérant le retour à une position spécifique. |
| Réduire la fenêtre UIA |
Minimise la fenêtre avec le handle UIA spécifié. |
| Réduire l’élément UIA |
Réduit un élément (généralement un menu /élément de liste déroulante). Si l’élément est déjà réduit, rien ne se produit. |
| Réinitialiser tous les handles d’éléments UIA |
Réinitialise tous les handles d’éléments UIA actuellement stockés par IA-Connect qui peuvent être utiles si vous avez identifié un grand nombre d’éléments et que vous avez un grand nombre de handles d’éléments stockés. Dans les scénarios avec un nombre extrêmement élevé de handles d’élément (100 000+), cette action peut également être utilisée pour libérer l’utilisation de la RAM. |
| Sélectionner l’élément UIA |
Sélectionne un élément (généralement un élément dans une liste ou une liste déroulante). |
| Texte d’entrée dans l’élément UIA |
Action UIA qui insère du texte dans un élément (généralement un champ d’entrée de texte), en remplaçant le texte existant ou en insérant la nouvelle valeur à une position spécifique. |
| Texte d’entrée global dans l’élément UIA |
Déplace la souris au centre de l’élément, la met au focus, les cliques gauches et appuie sur les touches. Généralement utilisé avec une entrée de texte qui n’accepte pas les méthodes d’entrée UIA natives. |
| Vérifier l’élément UIA |
Définit l’état d’un élément (généralement une case à cocher ou une case d’option) sur activé ou désactivé. |
| Vérifier plusieurs éléments UIA |
Définit l’état de plusieurs éléments (généralement une case à cocher ou une case d’option) sur activé ou désactivé. |
| Élément Focus UIA |
Concentre un élément qui le rend actif pour le focus clavier et, selon l’application, peut amener la fenêtre d’élément au premier plan. |
| Élément Move UIA |
Déplace un élément UIA vers une position spécifiée sur l’écran. Cette action fonctionne généralement uniquement avec les éléments Window (qui ont le modèle de transformation). |
Activer/désactiver l’élément UIA
Active un élément (généralement une case à cocher ou une case d’option). Cela donne à l’élément l’état opposé à son état actuel (par exemple, la case à cocher devient décochée et inversement). Si vous souhaitez définir un état spécifique, utilisez plutôt l’action « Vérifier l’élément ».
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Handle de fenêtre parent
|
ParentWindowHandle | True | integer |
Handle de fenêtre UIA parent (valeur 1 ou supérieure) pour agir comme point de départ de la recherche. Vous pouvez le découvrir via Inspection à l’aide d’actions telles que « Wait for desktop element » ou « Wait for element ». |
|
Nom de l’élément de recherche
|
SearchElementName | string |
Nom d’élément UIA facultatif à rechercher (à partir du handle de fenêtre parent). Cela peut être découvert par le biais de l’inspection. |
|
|
Nom de la classe d’élément Search
|
SearchElementClassName | string |
Nom de classe d’élément UIA facultatif à rechercher (à partir du handle de fenêtre parent). Cela peut être découvert par le biais de l’inspection. |
|
|
ID d’automatisation de l’élément de recherche
|
SearchElementAutomationId | string |
ID d’automatisation d’élément UIA facultatif à rechercher (à partir du handle de fenêtre parent). Cela peut être découvert par le biais de l’inspection. |
|
|
Type de contrôle localisé de l’élément de recherche
|
SearchLocalizedControlType | string |
Type de contrôle localisé de l’élément UIA facultatif à rechercher (à partir du handle de fenêtre parent). Cela peut être découvert par le biais de l’inspection. |
|
|
Rechercher une sous-arborescence UIA
|
SearchSubTree | boolean |
Si la valeur est true, l’arborescence UIA entière située sous le handle de fenêtre parent est recherchée. Cela est plus approfondi, mais peut prendre plus de temps. Si la valeur est false, seuls les éléments directement sous le handle de fenêtre parent dans l’arborescence UIA sont recherchés. |
|
|
Index de correspondance
|
MatchIndex | integer |
Si plusieurs éléments correspondent à la recherche, quel élément (à partir de 1) doit être mis en correspondance. Peut être utilisé conjointement avec « Trier par colonne » pour choisir l’ordre de tri correspondant. |
|
|
Filtre de recherche
|
SearchFilter | string |
Filtre avancé facultatif pour restreindre davantage la recherche à l’aide d’opérateurs conditionnels et de tout champ d’élément. Exemple 1 : [Width] < 200. Exemple 2 : [Name] like 'Document*' AND [ClassName] like 'Label*'. Pour plus d’exemples, consultez la documentation. |
|
|
Trier par nom de colonne
|
SortByColumn | string |
Si plusieurs éléments correspondent à la recherche, cela vous permet de spécifier la propriété d’élément à trier par. Cela sera utilisé conjointement avec « Match index » pour sélectionner l’élément requis. Par exemple : si « Trier par nom de colonne » est [TopEdge] et « Match index » est 1, l’élément correspondant le plus proche du haut de l’écran est mis en correspondance. |
|
|
L’index de correspondance est croissant
|
MatchIndexAscending | boolean |
Si plusieurs éléments correspondent à la recherche, doit correspondre à « Faire correspondre l’index » en haut de la liste triée (true) ou en bas de la liste triée (false). |
|
|
Nombre maximal d’éléments à rechercher
|
MaxElementsToSearch | integer |
Nombre maximal d’éléments à rechercher lors de la recherche de l’élément cible dans l’arborescence UIA. Cette entrée fonctionne uniquement si le mode de recherche d’élément UIA est « Tree walk » (cela peut être activé dans la page paramètres de l’inspecteur). Par défaut, cette valeur est définie sur 0 (illimité). Cette entrée est généralement utilisée pour optimiser la recherche d’éléments. |
|
|
Profondeur maximale de recherche relative
|
MaxRelativeSearchDepth | integer |
Profondeur maximale de l’arborescence relative à la recherche d’éléments enfants sous l’élément parent. Les éléments enfants directs ont une valeur de profondeur de 1. Cette entrée fonctionne uniquement si le mode de recherche d’élément UIA est « Tree walk » (cela peut être activé dans la page paramètres de l’inspecteur). Défini sur 0 pour une profondeur de recherche illimitée. Cette entrée est généralement utilisée pour optimiser la recherche d’éléments. |
|
|
Nombre maximal d’éléments enfants à rechercher par nœud
|
MaxChildElementsToSearchPerNode | integer |
Nombre maximal d’éléments enfants à rechercher sous chaque élément lors de la recherche de l’arborescence UIA pour l’élément cible. Cette entrée fonctionne uniquement si le mode de recherche d’élément UIA est « Tree walk » (cela peut être activé dans la page paramètres de l’inspecteur). Par défaut, cette valeur est définie sur 0 (illimité). Cette entrée est généralement utilisée pour optimiser la recherche d’éléments. |
|
|
Types de contrôle localisés d’élément à parcourir
|
ElementLocalizedControlTypesNotToTraverse | string |
Liste séparée par des virgules des types de contrôle localisés par des éléments UIA pour ne pas traverser (pas à pas) lors de la recherche de l’arborescence UIA pour l’élément cible. La recherche vérifie toujours si un élément individuel correspond aux critères de recherche, mais il ne recherche aucun élément enfant de cet élément si son type de contrôle localisé figure dans cette liste d’exclusions. Cette entrée fonctionne uniquement si le mode de recherche d’élément UIA est « Tree walk » (cela peut être activé dans la page paramètres de l’inspecteur). Cette entrée est généralement utilisée pour optimiser la recherche d’éléments. |
|
|
Flux de travail
|
Workflow | True | string |
Ajoutez l’expression suivante ici : workflow() |
Appuyer sur l’élément UIA
Appuie sur un élément (généralement un bouton).
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Handle de fenêtre parent
|
ParentWindowHandle | True | integer |
Handle de fenêtre UIA parent (valeur 1 ou supérieure) pour agir comme point de départ de la recherche. Vous pouvez le découvrir via Inspection à l’aide d’actions telles que « Wait for desktop element » ou « Wait for element ». |
|
Nom de l’élément de recherche
|
SearchElementName | string |
Nom d’élément UIA facultatif à rechercher (à partir du handle de fenêtre parent). Cela peut être découvert par le biais de l’inspection. |
|
|
Nom de la classe d’élément Search
|
SearchElementClassName | string |
Nom de classe d’élément UIA facultatif à rechercher (à partir du handle de fenêtre parent). Cela peut être découvert par le biais de l’inspection. |
|
|
ID d’automatisation de l’élément de recherche
|
SearchElementAutomationId | string |
ID d’automatisation d’élément UIA facultatif à rechercher (à partir du handle de fenêtre parent). Cela peut être découvert par le biais de l’inspection. |
|
|
Type de contrôle localisé de l’élément de recherche
|
SearchLocalizedControlType | string |
Type de contrôle localisé de l’élément UIA facultatif à rechercher (à partir du handle de fenêtre parent). Cela peut être découvert par le biais de l’inspection. |
|
|
Rechercher une sous-arborescence UIA
|
SearchSubTree | boolean |
Si la valeur est true, l’arborescence UIA entière située sous le handle de fenêtre parent est recherchée. Cela est plus approfondi, mais peut prendre plus de temps. Si la valeur est false, seuls les éléments directement sous le handle de fenêtre parent dans l’arborescence UIA sont recherchés. |
|
|
Attendez que l’événement de bouton se termine
|
Wait | boolean |
Si l’automatisation attend la fin de l’événement de bouton avant de continuer. Si la valeur est true, cela peut entraîner un délai d’expiration si le bouton ouvre une boîte de dialogue modale. |
|
|
Bouton Cliquer sur Win32
|
Win32ClickButton | boolean |
Si la valeur est true, un événement De clic Win32 est utilisé au lieu d’utiliser UIA. Il s’agit d’un événement de clic « fire and forget », qui peut être utile lorsque vous traitez des dialogues modals présentés après un clic ou des éléments qui n’ont pas de modèle d’appel UIA. |
|
|
Index de correspondance
|
MatchIndex | integer |
Si plusieurs éléments correspondent à la recherche, quel élément (à partir de 1) doit être mis en correspondance. Peut être utilisé conjointement avec « Trier par colonne » pour choisir l’ordre de tri correspondant. |
|
|
Filtre de recherche
|
SearchFilter | string |
Filtre avancé facultatif pour restreindre davantage la recherche à l’aide d’opérateurs conditionnels et de tout champ d’élément. Exemple 1 : [Width] < 200. Exemple 2 : [Name] like 'Document*' AND [ClassName] like 'Label*'. Pour plus d’exemples, consultez la documentation. |
|
|
Trier par nom de colonne
|
SortByColumn | string |
Si plusieurs éléments correspondent à la recherche, cela vous permet de spécifier la propriété d’élément à trier par. Cela sera utilisé conjointement avec « Match index » pour sélectionner l’élément requis. Par exemple : si « Trier par nom de colonne » est [TopEdge] et « Match index » est 1, l’élément correspondant le plus proche du haut de l’écran est mis en correspondance. |
|
|
L’index de correspondance est croissant
|
MatchIndexAscending | boolean |
Si plusieurs éléments correspondent à la recherche, doit correspondre à « Faire correspondre l’index » en haut de la liste triée (true) ou en bas de la liste triée (false). |
|
|
Nombre maximal d’éléments à rechercher
|
MaxElementsToSearch | integer |
Nombre maximal d’éléments à rechercher lors de la recherche de l’élément cible dans l’arborescence UIA. Cette entrée fonctionne uniquement si le mode de recherche d’élément UIA est « Tree walk » (cela peut être activé dans la page paramètres de l’inspecteur). Par défaut, cette valeur est définie sur 0 (illimité). Cette entrée est généralement utilisée pour optimiser la recherche d’éléments. |
|
|
Profondeur maximale de recherche relative
|
MaxRelativeSearchDepth | integer |
Profondeur maximale de l’arborescence relative à la recherche d’éléments enfants sous l’élément parent. Les éléments enfants directs ont une valeur de profondeur de 1. Cette entrée fonctionne uniquement si le mode de recherche d’élément UIA est « Tree walk » (cela peut être activé dans la page paramètres de l’inspecteur). Défini sur 0 pour une profondeur de recherche illimitée. Cette entrée est généralement utilisée pour optimiser la recherche d’éléments. |
|
|
Nombre maximal d’éléments enfants à rechercher par nœud
|
MaxChildElementsToSearchPerNode | integer |
Nombre maximal d’éléments enfants à rechercher sous chaque élément lors de la recherche de l’arborescence UIA pour l’élément cible. Cette entrée fonctionne uniquement si le mode de recherche d’élément UIA est « Tree walk » (cela peut être activé dans la page paramètres de l’inspecteur). Par défaut, cette valeur est définie sur 0 (illimité). Cette entrée est généralement utilisée pour optimiser la recherche d’éléments. |
|
|
Types de contrôle localisés d’élément à parcourir
|
ElementLocalizedControlTypesNotToTraverse | string |
Liste séparée par des virgules des types de contrôle localisés par des éléments UIA pour ne pas traverser (pas à pas) lors de la recherche de l’arborescence UIA pour l’élément cible. La recherche vérifie toujours si un élément individuel correspond aux critères de recherche, mais il ne recherche aucun élément enfant de cet élément si son type de contrôle localisé figure dans cette liste d’exclusions. Cette entrée fonctionne uniquement si le mode de recherche d’élément UIA est « Tree walk » (cela peut être activé dans la page paramètres de l’inspecteur). Cette entrée est généralement utilisée pour optimiser la recherche d’éléments. |
|
|
Essayer le modèle d’appel
|
TryInvokePattern | boolean |
Si la valeur est true (valeur par défaut), l’agent IA-Connect tente d’utiliser un modèle d’appel UIA pour effectuer l’action de presse (sauf si le bouton « Clic Win32 » est défini sur true). Si le modèle d’appel UIA n’est pas disponible dans l’élément choisi, l’agent IA-Connect revient à d’autres modèles (activé ou désactivé via d’autres entrées à cette action). Si la valeur est false, l’agent IA-Connect n’essaie pas d’utiliser un modèle d’appel et revient immédiatement à d’autres modèles choisis. |
|
|
Essayer le modèle hérité
|
TryLegacyPattern | boolean |
Si la valeur est true, l’agent IA-Connect tente d’utiliser un modèle hérité UIA pour effectuer l’action de presse si le modèle d’appel n’est pas disponible (soit parce qu’il n’est pas présent sur l’élément ou parce que son utilisation a été désactivée) et si le bouton « Clic Win32 » a la valeur false. |
|
|
Flux de travail
|
Workflow | True | string |
Ajoutez l’expression suivante ici : workflow() |
Attendez que l’image de recherche visible n’existe pas dans l’élément UIA
Attend qu’une image de recherche, fournie en tant qu’entrée à cette action, ne puisse pas être visiblement située (ou n’a jamais été située) dans un élément UIA à l’écran, ou la durée spécifiée est passée et l’image est toujours présente. L’élément doit d’abord être placé devant, car l’agent prend une capture d’écran sur les coordonnées de l’élément et recherche l’image de recherche fournie dans la capture d’écran. L’élément UIA doit exister à partir du début. L’action se termine immédiatement une fois que l’image n’est plus présente.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Handle de fenêtre parent
|
ParentWindowHandle | integer |
Handle de fenêtre UIA parent (valeur 1 ou supérieure) pour agir comme point de départ de la recherche. Vous pouvez le découvrir via Inspection à l’aide d’actions telles que « Wait for desktop element » ou « Wait for element ». |
|
|
Nom de l’élément de recherche
|
SearchElementName | string |
Nom d’élément UIA facultatif à rechercher (à partir du handle de fenêtre parent). Cela peut être découvert par le biais de l’inspection. |
|
|
Nom de la classe d’élément Search
|
SearchElementClassName | string |
Nom de classe d’élément UIA facultatif à rechercher (à partir du handle de fenêtre parent). Cela peut être découvert par le biais de l’inspection. |
|
|
ID d’automatisation de l’élément de recherche
|
SearchElementAutomationId | string |
ID d’automatisation d’élément UIA facultatif à rechercher (à partir du handle de fenêtre parent). Cela peut être découvert par le biais de l’inspection. |
|
|
Type de contrôle localisé de l’élément de recherche
|
SearchLocalizedControlType | string |
Type de contrôle localisé de l’élément UIA facultatif à rechercher (à partir du handle de fenêtre parent). Cela peut être découvert par le biais de l’inspection. |
|
|
Rechercher une sous-arborescence UIA
|
SearchSubTree | boolean |
Si la valeur est true, l’arborescence UIA entière située sous le handle de fenêtre parent est recherchée. Cela est plus approfondi, mais peut prendre plus de temps. Si la valeur est false, seuls les éléments directement sous le handle de fenêtre parent dans l’arborescence UIA sont recherchés. |
|
|
Index de correspondance
|
MatchIndex | integer |
Si plusieurs éléments correspondent à la recherche, quel élément (à partir de 1) doit être mis en correspondance. Peut être utilisé conjointement avec « Trier par colonne » pour choisir l’ordre de tri correspondant. |
|
|
Filtre de recherche
|
SearchFilter | string |
Filtre avancé facultatif pour restreindre davantage la recherche à l’aide d’opérateurs conditionnels et de tout champ d’élément. Exemple 1 : [Width] < 200. Exemple 2 : [Name] like 'Document*' AND [ClassName] like 'Label*'. Pour plus d’exemples, consultez la documentation. |
|
|
Trier par nom de colonne
|
SortByColumn | string |
Si plusieurs éléments correspondent à la recherche, cela vous permet de spécifier la propriété d’élément à trier par. Cela sera utilisé conjointement avec « Match index » pour sélectionner l’élément requis. Par exemple : si « Trier par nom de colonne » est [TopEdge] et « Match index » est 1, l’élément correspondant le plus proche du haut de l’écran est mis en correspondance. |
|
|
L’index de correspondance est croissant
|
MatchIndexAscending | boolean |
Si plusieurs éléments correspondent à la recherche, doit correspondre à « Faire correspondre l’index » en haut de la liste triée (true) ou en bas de la liste triée (false). |
|
|
Nombre maximal d’éléments à rechercher
|
MaxElementsToSearch | integer |
Nombre maximal d’éléments à rechercher lors de la recherche de l’élément cible dans l’arborescence UIA. Cette entrée fonctionne uniquement si le mode de recherche d’élément UIA est « Tree walk » (cela peut être activé dans la page paramètres de l’inspecteur). Par défaut, cette valeur est définie sur 0 (illimité). Cette entrée est généralement utilisée pour optimiser la recherche d’éléments. |
|
|
Profondeur maximale de recherche relative
|
MaxRelativeSearchDepth | integer |
Profondeur maximale de l’arborescence relative à la recherche d’éléments enfants sous l’élément parent. Les éléments enfants directs ont une valeur de profondeur de 1. Cette entrée fonctionne uniquement si le mode de recherche d’élément UIA est « Tree walk » (cela peut être activé dans la page paramètres de l’inspecteur). Défini sur 0 pour une profondeur de recherche illimitée. Cette entrée est généralement utilisée pour optimiser la recherche d’éléments. |
|
|
Nombre maximal d’éléments enfants à rechercher par nœud
|
MaxChildElementsToSearchPerNode | integer |
Nombre maximal d’éléments enfants à rechercher sous chaque élément lors de la recherche de l’arborescence UIA pour l’élément cible. Cette entrée fonctionne uniquement si le mode de recherche d’élément UIA est « Tree walk » (cela peut être activé dans la page paramètres de l’inspecteur). Par défaut, cette valeur est définie sur 0 (illimité). Cette entrée est généralement utilisée pour optimiser la recherche d’éléments. |
|
|
Types de contrôle localisés d’élément à parcourir
|
ElementLocalizedControlTypesNotToTraverse | string |
Liste séparée par des virgules des types de contrôle localisés par des éléments UIA pour ne pas traverser (pas à pas) lors de la recherche de l’arborescence UIA pour l’élément cible. La recherche vérifie toujours si un élément individuel correspond aux critères de recherche, mais il ne recherche aucun élément enfant de cet élément si son type de contrôle localisé figure dans cette liste d’exclusions. Cette entrée fonctionne uniquement si le mode de recherche d’élément UIA est « Tree walk » (cela peut être activé dans la page paramètres de l’inspecteur). Cette entrée est généralement utilisée pour optimiser la recherche d’éléments. |
|
|
Type d’image de recherche
|
SearchImageType | string |
Définit ce que représente l’entrée « Image de recherche ». Si la valeur est « Fichier image du directeur », l’image de recherche est un chemin d’accès à un fichier accessible au directeur. Si la valeur est « Fichier image de l’agent », l’image de recherche est un chemin d’accès à un fichier accessible à l’agent. Si la valeur est « Base64 », l’image de recherche est une représentation base64 de l’image. |
|
|
Image de recherche
|
SearchImage | string |
Image de recherche à localiser dans l’élément UIA spécifié. Selon le « type d’image de recherche » spécifié, il peut contenir le chemin d’accès à un fichier image (à la fin du directeur ou de l’agent) ou contenir la base64 (représentation textuelle) de l’image à rechercher. |
|
|
Autre type d’image de recherche
|
AltSearchImageType | string |
Définit ce que représente l’entrée « Image de recherche alternative ». Si la valeur est « None » ou vide, il n’existe aucune autre image de recherche. Si la valeur est « Fichier image du directeur », l’image de recherche est un chemin d’accès à un fichier accessible au directeur. Si la valeur est « Fichier image de l’agent », l’image de recherche est un chemin d’accès à un fichier accessible à l’agent. Si la valeur est « Base64 », l’image de recherche est une représentation base64 de l’image. |
|
|
Autre image de recherche
|
AltSearchImage | string |
Une autre image de recherche facultative à localiser dans l’élément UIA spécifié. Selon le « type d’image de recherche alternatif » spécifié, il peut contenir le chemin d’accès à un fichier image (à la fin du directeur ou de l’agent) ou contenir la base64 (représentation textuelle) de l’image à rechercher. Si vous spécifiez une autre image de recherche, l’Agent recherche l’image de recherche ou l’image de recherche alternative et signale celle qui a été située. |
|
|
Écart maximal de couleur
|
MaxColourDeviation | integer |
Le maximum de couleurs de pixels d’un élément peut s’écarter des couleurs de pixels de l’image de recherche avant qu’elle ne soit considérée comme une correspondance. 0 pour aucun écart. L’écart est mesuré dans les valeurs RVB. Par exemple : #FF0000 est différent de 4 #FE0102. Cela permet d’ignorer les différences mineures de coloration. |
|
|
Différences de pixels maximales
|
MaxPixelDifferences | integer |
Nombre maximal de pixels qui peuvent différer (au-dessus de l’écart de couleur maximal), sur l’ensemble de l’image de recherche, avant qu’une image ne corresponde. Cela permet d’ignorer les différences mineures entre les images, mais des valeurs plus élevées peuvent augmenter le temps nécessaire pour localiser une image. Il est recommandé de définir la valeur 0 et d’augmenter de petites quantités si nécessaire. Si vous définissez une valeur supérieure à 0, vous devez également définir « Nombre maximal de différences de pixels consécutives ». |
|
|
Différences de pixels consécutives maximales
|
MaxConsecutivePixelDifferences | integer |
Nombre maximal de pixels qui peuvent différer (au-dessus de l’écart de couleur maximal), dans n’importe quelle ligne, avant qu’une image ne corresponde. Cela permet d’ignorer les différences mineures entre les images, mais des valeurs plus élevées peuvent augmenter le temps nécessaire pour localiser une image. Il est recommandé de définir la valeur 0 et d’augmenter de petites quantités si nécessaire. Si vous définissez une valeur supérieure à 0, vous devez également définir « Nombre maximal de différences de pixels ». |
|
|
Décalage X de pixel gauche
|
LeftPixelXOffset | integer |
Décalage X facultatif pour le bord gauche de la zone de recherche. Cela vous permet d’augmenter (avec des valeurs négatives) ou de diminuer (avec des valeurs positives) la zone de recherche. |
|
|
Décalage X pixel droit
|
RightPixelXOffset | integer |
Décalage X facultatif pour le bord droit de la zone de recherche. Cela vous permet d’augmenter (avec des valeurs positives) ou de diminuer (avec des valeurs négatives) la zone de recherche. |
|
|
Décalage Y du pixel supérieur
|
TopPixelYOffset | integer |
Décalage Y facultatif pour le bord supérieur de la zone de recherche. Cela vous permet d’augmenter (avec des valeurs négatives) ou de diminuer (avec des valeurs positives) la zone de recherche. |
|
|
Décalage Y en pixels inférieurs
|
BottomPixelYOffset | integer |
Décalage Y facultatif pour le bord inférieur de la zone de recherche. Cela vous permet d’augmenter (avec des valeurs positives) ou de diminuer (avec des valeurs négatives) la zone de recherche. |
|
|
Unité de décalages X pixels
|
PixelXOffsetsUnit | string |
Défini sur « Pixel » (valeur par défaut) si les décalages X de pixel gauche et droit sont mesurés en pixels. Défini sur « Pourcentage » si les décalages X de pixel gauche et droit sont mesurés sous la forme d’un pourcentage de la largeur de l’élément. |
|
|
Unité de décalages Y pixels
|
PixelYOffsetsUnit | string |
Défini sur « Pixel » (valeur par défaut) si les décalages Y de pixels supérieur et inférieur sont mesurés en pixels. Défini sur « Pourcentage » si les décalages Y en pixels supérieurs et inférieurs sont mesurés sous la forme d’un pourcentage de la hauteur de l’élément. |
|
|
Index d’image de recherche
|
SearchImageIndex | integer |
Définissez la valeur 1 pour localiser la première instance de l’image de recherche (dans la direction de la recherche) dans l’élément UIA. Défini sur 2 pour la deuxième instance, .... , N pour l’instance Nth. Si vous recherchez également une autre image, l’élément UIA est analysé en premier pour l’image de recherche et deuxièmement pour l’autre image, en recherchant l’instance demandée de cette image particulière (c’est-à-dire que l’agent attend l’une ou l’autre, pas une combinaison des deux images). |
|
|
Direction de la recherche d’images
|
ImageSearchDirection | string |
Direction de la recherche. « De haut » effectue des recherches par ligne en haut, analyse de gauche à droite dans chaque ligne. « De bas » effectue des recherches par ligne en bas, en analysant la gauche vers la droite dans chaque ligne. « De gauche » effectue des recherches par colonne de gauche, analyse en haut en bas dans chaque colonne. « De droite » effectue des recherches par colonne de droite, analyse en haut en bas dans chaque colonne. Cela peut être utilisé conjointement avec l'« index d’image de recherche » pour localiser la Nième image du haut, du bas, de la gauche ou de la droite. Pour améliorer les performances, sélectionnez la direction de recherche que vous pensez localiser plus rapidement votre image. |
|
|
Masquer l’agent
|
HideAgent | boolean |
Définissez la valeur true pour masquer automatiquement l’agent (s’il est visible) pour vous assurer qu’il ne masque pas l’élément analysé. |
|
|
Afficher le rectangle de mise en surbrillance
|
ShowHighlightRectangle | boolean |
Si la valeur est true, l’agent IA-Connect met en surbrillance l’image située à l’écran. Cela peut être utile pendant le développement, pour vous aider à visualiser que l’image correcte est détectée. |
|
|
Secondes pour attendre que l’image de recherche n’existe pas
|
SecondsToWait | integer |
Nombre de secondes à attendre que l’image de recherche ne soit pas visible dans l’élément UIA. Si l’image est toujours présente après cette période, une exception est levée si « Déclencher une exception si l’image est toujours présente » est définie sur true, sinon l’action signale que l’image est toujours présente. |
|
|
Millisecondes entre les recherches
|
MillisecondsBetweenSearches | integer |
Nombre de millisecondes à attendre entre chaque élément UIA à l’écran. Étant donné que la reconnaissance d’image peut être coûteuse du processeur, un délai peut aider à réduire et à répartir l’utilisation du processeur. Par exemple : si vous pensez qu’une image peut prendre jusqu’à 1 minute pour être visible, l’ajout d’une pause de 5 000 millisecondes (5 secondes) entre les analyses réduit considérablement l’utilisation du processeur (en réduisant considérablement le nombre d’analyses), mais n’a qu’un faible impact sur le temps de réponse. La valeur minimale autorisée est de 100 millisecondes (1/10 seconde). |
|
|
Déclencher une exception si l’image est toujours présente
|
RaiseExceptionIfImageStillPresent | boolean |
Défini sur true si IA-Connect doit déclencher une exception si l’image est toujours présente après la période d’attente. |
|
|
Récupérer les données de sortie pour l’ID de thread
|
RetrieveOutputDataFromThreadId | integer |
Si vous définissez précédemment « Attendre le thread » sur false (ce qui entraîne l’exécution de l’attente dans un thread d’arrière-plan), indiquez l’ID de thread de l’agent pour récupérer les résultats. Cet ID de thread agent a été fourni par l’appel précédent à cette action. Sinon, définissez la valeur 0 (valeur par défaut). |
|
|
Attendre le thread
|
WaitForThread | boolean |
Définissez la valeur true pour attendre que le thread agent se termine ; L’agent attendra tant que spécifié par « Secondes pour attendre que l’image de recherche n’existe pas ». Définissez la valeur false pour contourner l’attente ; L’agent continuera d’effectuer l’attente dans un thread d’arrière-plan, mais il sera également disponible pour l’action suivante. Vous pouvez ensuite récupérer les résultats ultérieurement à l’aide de l’action « Attendre que le thread agent se termine correctement » pour attendre que le thread agent se termine, puis réexécuter cette action « Attendre que l’image de recherche visible n’existe pas dans l’élément UIA » avec l’entrée « Récupérer les données de sortie pour l’ID de thread » définie sur l’ID de thread agent. |
|
|
Flux de travail
|
Workflow | True | string |
Ajoutez l’expression suivante ici : workflow() |
Retours
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
Image de recherche présente avant d’attendre
|
SearchImagePresentBeforeWait | boolean |
Cette sortie est définie sur true, si l’image de recherche était présente au début de la période d’attente. Cette sortie est définie sur false, si l’image de recherche n’a pas été présente à partir du début. |
|
Image de recherche toujours présente après attente
|
SearchImageStillPresentAfterWait | boolean |
Cette sortie est définie sur true, si l’image de recherche est toujours présente, après la période d’attente. Cette sortie est définie sur false, si l’image de recherche n’est plus présente, pendant la période d’attente (l’action se termine immédiatement une fois que l’image n’est plus présente). |
|
Quelle image de recherche est toujours présente
|
WhichSearchImageStillPresent | integer |
Cette sortie est définie sur 0, si aucune image de recherche n’est encore présente, après la période d’attente. Défini sur 1, si l’image de recherche était toujours présente, après la période d’attente. Défini sur 2, si l’image de recherche alternative était toujours présente, après la période d’attente. |
|
Thread Id
|
ThreadId | integer |
Si vous avez défini « Attendre le thread » sur false (ce qui entraîne l’exécution de l’attente dans un thread d’arrière-plan), cette sortie contient l’ID du thread Agent qui peut être utilisé pour surveiller le processus de l’action et récupérer les résultats ultérieurement, une fois le thread terminé. |
Attendez que l’élément de bureau UIA n’existe pas
Attend qu’un élément de bureau (généralement une fenêtre) n’existe plus.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Nom de l’élément de recherche
|
SearchElementName | string |
Nom d’élément UIA facultatif à rechercher (à partir du handle de fenêtre parent). Cela peut être découvert par le biais de l’inspection. |
|
|
Nom de la classe d’élément Search
|
SearchElementClassName | string |
Nom de classe d’élément UIA facultatif à rechercher (à partir du handle de fenêtre parent). Cela peut être découvert par le biais de l’inspection. |
|
|
ID d’automatisation de l’élément de recherche
|
SearchElementAutomationId | string |
ID d’automatisation d’élément UIA facultatif à rechercher (à partir du handle de fenêtre parent). Cela peut être découvert par le biais de l’inspection. |
|
|
Type de contrôle localisé de l’élément de recherche
|
SearchLocalizedControlType | string |
Type de contrôle localisé de l’élément UIA facultatif à rechercher (à partir du handle de fenêtre parent). Cela peut être découvert par le biais de l’inspection. |
|
|
ID du processus de recherche
|
SearchProcessId | integer |
Si elle est spécifiée (valeur 1 ou supérieure), la recherche considère uniquement les éléments appartenant à un processus avec cet ID de processus (PID). Si IA-Connect lancé le processus, le PID est fourni par l’action « Exécuter le processus » dans les actions IA-Connect Environnement /Session. Si vous ne connaissez pas le PID, laissez ce champ vide (ou 0). |
|
|
Rechercher une sous-arborescence UIA
|
SearchSubTree | boolean |
Si la valeur est true, l’arborescence UIA entière située sous le handle de fenêtre parent est recherchée. Cela est plus approfondi, mais peut prendre plus de temps. Si la valeur est false, seuls les éléments directement sous le handle de fenêtre parent dans l’arborescence UIA sont recherchés. |
|
|
Secondes à attendre
|
SecondsToWait | True | integer |
Nombre maximal de secondes à attendre que l’élément n’existe pas. |
|
Index de correspondance
|
MatchIndex | integer |
Si plusieurs éléments correspondent à la recherche, quel élément (à partir de 1) doit être mis en correspondance. Peut être utilisé conjointement avec « Trier par colonne » pour choisir l’ordre de tri correspondant. |
|
|
Filtre de recherche
|
SearchFilter | string |
Filtre avancé facultatif pour restreindre davantage la recherche à l’aide d’opérateurs conditionnels et de tout champ d’élément. Exemple 1 : [Width] < 200. Exemple 2 : [Name] like 'Document*' AND [ClassName] like 'Label*'. Pour plus d’exemples, consultez la documentation. |
|
|
Trier par nom de colonne
|
SortByColumn | string |
Si plusieurs éléments correspondent à la recherche, cela vous permet de spécifier la propriété d’élément à trier par. Cela sera utilisé conjointement avec « Match index » pour sélectionner l’élément requis. Par exemple : si « Trier par nom de colonne » est [TopEdge] et « Match index » est 1, l’élément correspondant le plus proche du haut de l’écran est mis en correspondance. |
|
|
L’index de correspondance est croissant
|
MatchIndexAscending | boolean |
Si plusieurs éléments correspondent à la recherche, doit correspondre à « Faire correspondre l’index » en haut de la liste triée (true) ou en bas de la liste triée (false). |
|
|
Inclure des processus enfants
|
IncludeChildProcesses | boolean |
Si la valeur est true et qu’un « ID de processus de recherche » est spécifié, les processus enfants de cet ID de processus sont également inclus dans la recherche. Si la valeur est false, seul un processus correspondant à l’id de processus de recherche exact est retourné. |
|
|
Déclencher une exception si l’élément existe toujours
|
RaiseExceptionIfElementStillExists | boolean |
Doit-il IA-Connect déclencher une exception si l’élément UIA existe toujours après la période d’attente ? |
|
|
Nombre maximal d’éléments à rechercher
|
MaxElementsToSearch | integer |
Nombre maximal d’éléments à rechercher lors de la recherche de l’élément cible dans l’arborescence UIA. Cette entrée fonctionne uniquement si le mode de recherche d’élément UIA est « Tree walk » (cela peut être activé dans la page paramètres de l’inspecteur). Par défaut, cette valeur est définie sur 0 (illimité). Cette entrée est généralement utilisée pour optimiser la recherche d’éléments. |
|
|
Profondeur maximale de recherche relative
|
MaxRelativeSearchDepth | integer |
Profondeur maximale de l’arborescence relative à la recherche d’éléments enfants sous l’élément parent. Les éléments enfants directs ont une valeur de profondeur de 1. Cette entrée fonctionne uniquement si le mode de recherche d’élément UIA est « Tree walk » (cela peut être activé dans la page paramètres de l’inspecteur). Défini sur 0 pour une profondeur de recherche illimitée. Cette entrée est généralement utilisée pour optimiser la recherche d’éléments. |
|
|
Nombre maximal d’éléments enfants à rechercher par nœud
|
MaxChildElementsToSearchPerNode | integer |
Nombre maximal d’éléments enfants à rechercher sous chaque élément lors de la recherche de l’arborescence UIA pour l’élément cible. Cette entrée fonctionne uniquement si le mode de recherche d’élément UIA est « Tree walk » (cela peut être activé dans la page paramètres de l’inspecteur). Par défaut, cette valeur est définie sur 0 (illimité). Cette entrée est généralement utilisée pour optimiser la recherche d’éléments. |
|
|
Types de contrôle localisés d’élément à parcourir
|
ElementLocalizedControlTypesNotToTraverse | string |
Liste séparée par des virgules des types de contrôle localisés par des éléments UIA pour ne pas traverser (pas à pas) lors de la recherche de l’arborescence UIA pour l’élément cible. La recherche vérifie toujours si un élément individuel correspond aux critères de recherche, mais il ne recherche aucun élément enfant de cet élément si son type de contrôle localisé figure dans cette liste d’exclusions. Cette entrée fonctionne uniquement si le mode de recherche d’élément UIA est « Tree walk » (cela peut être activé dans la page paramètres de l’inspecteur). Cette entrée est généralement utilisée pour optimiser la recherche d’éléments. |
|
|
Flux de travail
|
Workflow | True | string |
Ajoutez l’expression suivante ici : workflow() |
Retours
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
L’élément existe avant d’attendre
|
ElementExistsBeforeWait | boolean |
Retourne true si l’élément existait avant d’attendre ou false si ce n’est pas le cas. |
|
L’élément existe après l’attente
|
ElementExistsAfterWait | boolean |
Retourne la valeur true si l’élément existait après l’attente ou la valeur false si ce n’est pas le cas. |
Attendre la fenêtre principale du processus UIA
Action Win32 simple et rapide qui attend une heure spécifiée pour que la fenêtre principale d’un processus (spécifié par nom) existe avant de retourner un handle. La fenêtre « Main » est généralement la fenêtre d’application principale : une boîte de dialogue de connexion ou une sous-fenêtre n’est généralement pas la fenêtre « Main ». Il est recommandé d’utiliser l’action « Wait for Desktop element » qui est plus puissante.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Nom du processus de recherche
|
SearchProcessName | True | string |
Nom du processus à rechercher, par exemple, bloc-notes. |
|
Secondes à attendre
|
SecondsToWait | True | integer |
Nombre maximal de secondes à attendre pour la fenêtre principale du processus. |
|
Flux de travail
|
Workflow | True | string |
Ajoutez l’expression suivante ici : workflow() |
Retours
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
Handle de fenêtre
|
WindowHandle | integer |
Handle UIA pour la fenêtre. Cela peut être utilisé comme entrée pour effectuer d’autres actions UIA dans cette fenêtre. |
|
Nom de l'élément
|
ElementName | string |
Nom UIA de l’élément de fenêtre. |
|
Nom de la classe d’élément
|
ElementClassName | string |
Nom de classe UIA de l’élément window. |
|
ID d’automatisation de l’élément
|
ElementAutomationId | string |
ID d’automatisation UIA de l’élément de fenêtre. |
|
Type de contrôle localisé par l’élément
|
ElementLocalizedControlType | string |
Type de contrôle localisé UIA de l’élément de fenêtre. |
|
L’élément existe
|
ElementExists | boolean |
Retourne true si la fenêtre existe ou false si ce n’est pas le cas. |
Attendre la fenêtre principale id de processus UIA
Action Win32 simple et rapide qui attend qu’une fenêtre principale d’un processus (spécifié par l’ID de processus) existe et retourne un handle. La fenêtre « Main » est généralement la fenêtre d’application principale : une boîte de dialogue de connexion ou une sous-fenêtre n’est généralement pas la fenêtre « Main ». Il est recommandé d’utiliser l’action « Wait for Desktop element » qui est plus puissante.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
ID du processus de recherche
|
ProcessId | True | integer |
ID du processus à attendre (tel que fourni par l’action « Exécuter le processus » dans les actions IA-Connect Environnement /Session). |
|
Secondes à attendre
|
SecondsToWait | True | integer |
Nombre maximal de secondes à attendre pour la fenêtre principale du processus. |
|
Flux de travail
|
Workflow | True | string |
Ajoutez l’expression suivante ici : workflow() |
Retours
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
L’élément existe
|
ElementExists | boolean |
Retourne true si l’élément existe ou false si ce n’est pas le cas. |
|
Handle de fenêtre
|
WindowHandle | integer |
Handle UIA pour la fenêtre. Cela peut être utilisé comme entrée pour effectuer d’autres actions UIA dans cette fenêtre. |
|
Nom de l'élément
|
ElementName | string |
Nom UIA de l’élément de fenêtre. |
|
Nom de la classe d’élément
|
ElementClassName | string |
Nom de classe UIA de l’élément window. |
|
ID d’automatisation de l’élément
|
ElementAutomationId | string |
ID d’automatisation UIA de l’élément de fenêtre. |
|
Type de contrôle localisé par l’élément
|
ElementLocalizedControlType | string |
Type de contrôle localisé UIA de l’élément de fenêtre. |
Attendre la fenêtre Win32 de niveau supérieur UIA
Action Win32 rapide qui attend une heure spécifiée pour qu’une fenêtre Win32 de niveau supérieur existe avant de retourner un handle UIA. Une fenêtre de niveau supérieur est une fenêtre qui est connectée au bureau. Vous pouvez effectuer une recherche par nom de classe ou par titre de fenêtre, ou vous pouvez spécifier des filtres de recherche plus avancés, y compris des caractères génériques. Bien que cette action utilise des API Win32, elle peut détecter Windows, Java, ModernUI et Windows Web. Il est plus courant d’utiliser l’action UIA « Wait for desktop element » qui est plus puissante, mais cette action Win32 s’exécute généralement plus rapidement.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Nom de la classe de recherche
|
SearchClassName | string |
Nom de la classe d’élément de la fenêtre de niveau supérieur à rechercher, par exemple « Bloc-notes ». |
|
|
Titre de la fenêtre de recherche
|
SearchWindowTitle | string |
Titre de la fenêtre de niveau supérieur à rechercher. |
|
|
Secondes à attendre
|
SecondsToWait | True | integer |
Nombre maximal de secondes à attendre que la fenêtre existe. |
|
ID du processus de recherche
|
SearchProcessId | integer |
ID de processus facultatif du processus propriétaire de la fenêtre (par exemple, tel que fourni par la sortie de l’action « Exécuter le processus » dans les actions IA-Connect Environnement /Session). Définissez la valeur 0 pour ne pas effectuer de recherche par ID de processus. |
|
|
Index de correspondance
|
MatchIndex | integer |
Si plusieurs éléments correspondent à la recherche, quel élément (à partir de 1) doit être mis en correspondance. Peut être utilisé conjointement avec « Trier par colonne » pour choisir l’ordre de tri correspondant. |
|
|
Filtre de recherche
|
SearchFilter | string |
Filtre avancé facultatif pour restreindre davantage la recherche à l’aide d’opérateurs conditionnels par rapport aux propriétés de fenêtre disponibles. Exemple 1 : [Width] < 200. Exemple 2 : [Title] like '*Excel' AND [IsMinimised] = False AND [IsResizeable] = True. Pour plus d’exemples, consultez la documentation. |
|
|
Trier par nom de colonne
|
SortByColumn | string |
Si plusieurs fenêtres correspondent à la recherche, cela vous permet de spécifier la propriété de fenêtre à trier par. Cette opération sera utilisée conjointement avec « Match index » pour sélectionner la fenêtre requise. Par exemple : si « Trier par nom de colonne » est [TopEdge] et « Match index » est 1, la fenêtre correspondante la plus proche du haut de l’écran est retournée. |
|
|
L’index de correspondance est croissant
|
MatchIndexAscending | boolean |
Si plusieurs fenêtres correspondent à la recherche, doit correspondre à « Faire correspondre l’index » en haut de la liste triée (true) ou en bas de la liste triée (false). |
|
|
Déclencher une exception si la fenêtre est introuvable
|
RaiseExceptionIfWindowNotFound | boolean |
Doit-il IA-Connect déclencher une exception si la fenêtre Win32 de recherche n’existe pas après la période d’attente ? |
|
|
Flux de travail
|
Workflow | True | string |
Ajoutez l’expression suivante ici : workflow() |
Retours
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
Handle de fenêtre
|
WindowHandle | integer |
Handle UIA pour la fenêtre. Cela peut être utilisé comme entrée pour effectuer d’autres actions UIA dans cette fenêtre. |
|
Nom de l'élément
|
ElementName | string |
Nom UIA de l’élément de fenêtre. |
|
Nom de la classe d’élément
|
ElementClassName | string |
Nom de classe UIA de l’élément window. |
|
ID d’automatisation de l’élément
|
ElementAutomationId | string |
ID d’automatisation UIA de l’élément de fenêtre. |
|
Type de contrôle localisé par l’élément
|
ElementLocalizedControlType | string |
Type de contrôle localisé UIA de l’élément de fenêtre. |
|
L’élément existe
|
ElementExists | boolean |
Retourne true si la fenêtre existe ou false si ce n’est pas le cas. |
Attendre l’élément de bureau UIA
Attend qu’un élément de bureau (généralement une fenêtre) existe.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Nom de l’élément de recherche
|
SearchElementName | string |
Nom d’élément UIA facultatif à rechercher (à partir du handle de fenêtre parent). Cela peut être découvert par le biais de l’inspection. |
|
|
Nom de la classe d’élément Search
|
SearchElementClassName | string |
Nom de classe d’élément UIA facultatif à rechercher (à partir du handle de fenêtre parent). Cela peut être découvert par le biais de l’inspection. |
|
|
ID d’automatisation de l’élément de recherche
|
SearchElementAutomationId | string |
ID d’automatisation d’élément UIA facultatif à rechercher (à partir du handle de fenêtre parent). Cela peut être découvert par le biais de l’inspection. |
|
|
Type de contrôle localisé de l’élément de recherche
|
SearchLocalizedControlType | string |
Type de contrôle localisé de l’élément UIA facultatif à rechercher (à partir du handle de fenêtre parent). Cela peut être découvert par le biais de l’inspection. |
|
|
ID du processus de recherche
|
SearchProcessId | integer |
Si elle est spécifiée (valeur 1 ou supérieure), la recherche considère uniquement les éléments appartenant à un processus avec cet ID de processus (PID). Si IA-Connect lancé le processus, le PID est fourni par l’action « Exécuter le processus » dans les actions IA-Connect Environnement /Session. Si vous ne connaissez pas le PID, laissez ce champ vide (ou 0). |
|
|
Rechercher une sous-arborescence UIA
|
SearchSubTree | boolean |
Si la valeur est true, l’arborescence UIA entière située sous le handle de fenêtre parent est recherchée. Cela est plus approfondi, mais peut prendre plus de temps. Si la valeur est false, seuls les éléments directement sous le handle de fenêtre parent dans l’arborescence UIA sont recherchés. |
|
|
Handle d’élément de retour
|
ReturnElementHandle | boolean |
Si la valeur est true, un handle sur l’élément situé est retourné. Ce handle peut être utilisé dans d’autres actions pour agir en tant que handle « parent ». |
|
|
Secondes à attendre
|
SecondsToWait | True | integer |
Nombre maximal de secondes à attendre que l’élément existe. |
|
Index de correspondance
|
MatchIndex | integer |
Si plusieurs éléments correspondent à la recherche, quel élément (à partir de 1) doit être mis en correspondance. Peut être utilisé conjointement avec « Trier par colonne » pour choisir l’ordre de tri correspondant. |
|
|
Filtre de recherche
|
SearchFilter | string |
Filtre avancé facultatif pour restreindre davantage la recherche à l’aide d’opérateurs conditionnels et de tout champ d’élément. Exemple 1 : [Width] < 200. Exemple 2 : [Name] like 'Document*' AND [ClassName] like 'Label*'. Pour plus d’exemples, consultez la documentation. |
|
|
Trier par nom de colonne
|
SortByColumn | string |
Si plusieurs éléments correspondent à la recherche, cela vous permet de spécifier la propriété d’élément à trier par. Cela sera utilisé conjointement avec « Match index » pour sélectionner l’élément requis. Par exemple : si « Trier par nom de colonne » est [TopEdge] et « Match index » est 1, l’élément correspondant le plus proche du haut de l’écran est mis en correspondance. |
|
|
L’index de correspondance est croissant
|
MatchIndexAscending | boolean |
Si plusieurs éléments correspondent à la recherche, doit correspondre à « Faire correspondre l’index » en haut de la liste triée (true) ou en bas de la liste triée (false). |
|
|
Inclure des processus enfants
|
IncludeChildProcesses | boolean |
Si la valeur est true et qu’un « ID de processus de recherche » est spécifié, les processus enfants de cet ID de processus sont également inclus dans la recherche. Si la valeur est false, seul un processus correspondant à l’id de processus de recherche exact est retourné. |
|
|
Déclencher une exception si l’élément est introuvable
|
RaiseExceptionIfElementNotFound | boolean |
Doit-il IA-Connect déclencher une exception si l’élément UIA n’existe pas après la période d’attente ? |
|
|
Nombre maximal d’éléments à rechercher
|
MaxElementsToSearch | integer |
Nombre maximal d’éléments à rechercher lors de la recherche de l’élément cible dans l’arborescence UIA. Cette entrée fonctionne uniquement si le mode de recherche d’élément UIA est « Tree walk » (cela peut être activé dans la page paramètres de l’inspecteur). Par défaut, cette valeur est définie sur 0 (illimité). Cette entrée est généralement utilisée pour optimiser la recherche d’éléments. |
|
|
Profondeur maximale de recherche relative
|
MaxRelativeSearchDepth | integer |
Profondeur maximale de l’arborescence relative à la recherche d’éléments enfants sous l’élément parent. Les éléments enfants directs ont une valeur de profondeur de 1. Cette entrée fonctionne uniquement si le mode de recherche d’élément UIA est « Tree walk » (cela peut être activé dans la page paramètres de l’inspecteur). Défini sur 0 pour une profondeur de recherche illimitée. Cette entrée est généralement utilisée pour optimiser la recherche d’éléments. |
|
|
Nombre maximal d’éléments enfants à rechercher par nœud
|
MaxChildElementsToSearchPerNode | integer |
Nombre maximal d’éléments enfants à rechercher sous chaque élément lors de la recherche de l’arborescence UIA pour l’élément cible. Cette entrée fonctionne uniquement si le mode de recherche d’élément UIA est « Tree walk » (cela peut être activé dans la page paramètres de l’inspecteur). Par défaut, cette valeur est définie sur 0 (illimité). Cette entrée est généralement utilisée pour optimiser la recherche d’éléments. |
|
|
Types de contrôle localisés d’élément à parcourir
|
ElementLocalizedControlTypesNotToTraverse | string |
Liste séparée par des virgules des types de contrôle localisés par des éléments UIA pour ne pas traverser (pas à pas) lors de la recherche de l’arborescence UIA pour l’élément cible. La recherche vérifie toujours si un élément individuel correspond aux critères de recherche, mais il ne recherche aucun élément enfant de cet élément si son type de contrôle localisé figure dans cette liste d’exclusions. Cette entrée fonctionne uniquement si le mode de recherche d’élément UIA est « Tree walk » (cela peut être activé dans la page paramètres de l’inspecteur). Cette entrée est généralement utilisée pour optimiser la recherche d’éléments. |
|
|
Flux de travail
|
Workflow | True | string |
Ajoutez l’expression suivante ici : workflow() |
Retours
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
L’élément existe
|
ElementExists | boolean |
Retourne true si l’élément existe ou false si ce n’est pas le cas. |
|
Handle d’élément
|
ElementHandle | integer |
Handle UIA pour l’élément. Cela peut être utilisé comme entrée pour d’autres actions UIA agissant sur cet élément. |
|
Nom de l'élément
|
ElementName | string |
Nom UIA de l’élément. |
|
Nom de la classe d’élément
|
ElementClassName | string |
Nom de classe UIA de l’élément. |
|
ID d’automatisation de l’élément
|
ElementAutomationId | string |
ID d’automatisation UIA de l’élément. |
|
Type de contrôle localisé par l’élément
|
ElementLocalizedControlType | string |
Type de contrôle localisé UIA de l’élément. |
Attendre l’élément UIA
Attend qu’un élément (généralement un élément individuel dans une fenêtre telle qu’un bouton ou une zone d’entrée de texte) existe.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Handle de fenêtre parent
|
ParentWindowHandle | True | integer |
Handle de fenêtre UIA parent (valeur 1 ou supérieure) pour agir comme point de départ de la recherche. Vous pouvez le découvrir via Inspection à l’aide d’actions telles que « Wait for desktop element » ou « Wait for element ». |
|
Nom de l’élément de recherche
|
SearchElementName | string |
Nom d’élément UIA facultatif à rechercher (à partir du handle de fenêtre parent). Cela peut être découvert par le biais de l’inspection. |
|
|
Nom de la classe d’élément Search
|
SearchElementClassName | string |
Nom de classe d’élément UIA facultatif à rechercher (à partir du handle de fenêtre parent). Cela peut être découvert par le biais de l’inspection. |
|
|
ID d’automatisation de l’élément de recherche
|
SearchElementAutomationId | string |
ID d’automatisation d’élément UIA facultatif à rechercher (à partir du handle de fenêtre parent). Cela peut être découvert par le biais de l’inspection. |
|
|
Type de contrôle localisé de l’élément de recherche
|
SearchLocalizedControlType | string |
Type de contrôle localisé de l’élément UIA facultatif à rechercher (à partir du handle de fenêtre parent). Cela peut être découvert par le biais de l’inspection. |
|
|
ID du processus de recherche
|
SearchProcessId | integer |
Si elle est spécifiée (valeur 1 ou supérieure), la recherche considère uniquement les éléments appartenant à un processus avec cet ID de processus (PID). Si IA-Connect lancé le processus, le PID est fourni par l’action « Exécuter le processus » dans les actions IA-Connect Environnement /Session. Si vous ne connaissez pas le PID, laissez ce champ vide (ou 0). |
|
|
Rechercher une sous-arborescence UIA
|
SearchSubTree | boolean |
Si la valeur est true, l’arborescence UIA entière située sous le handle de fenêtre parent est recherchée. Cela est plus approfondi, mais peut prendre plus de temps. Si la valeur est false, seuls les éléments directement sous le handle de fenêtre parent dans l’arborescence UIA sont recherchés. |
|
|
Handle d’élément de retour
|
ReturnElementHandle | boolean |
Si la valeur est true, un handle sur l’élément situé est retourné. Ce handle peut être utilisé dans d’autres actions pour agir en tant que handle « parent ». |
|
|
Secondes à attendre
|
SecondsToWait | True | integer |
Nombre maximal de secondes à attendre que l’élément existe. |
|
Index de correspondance
|
MatchIndex | integer |
Si plusieurs éléments correspondent à la recherche, quel élément (à partir de 1) doit être mis en correspondance. Peut être utilisé conjointement avec « Trier par colonne » pour choisir l’ordre de tri correspondant. |
|
|
Filtre de recherche
|
SearchFilter | string |
Filtre avancé facultatif pour restreindre davantage la recherche à l’aide d’opérateurs conditionnels et de tout champ d’élément. Exemple 1 : [Width] < 200. Exemple 2 : [Name] like 'Document*' AND [ClassName] like 'Label*'. Pour plus d’exemples, consultez la documentation. |
|
|
Trier par nom de colonne
|
SortByColumn | string |
Si plusieurs éléments correspondent à la recherche, cela vous permet de spécifier la propriété d’élément à trier par. Cela sera utilisé conjointement avec « Match index » pour sélectionner l’élément requis. Par exemple : si « Trier par nom de colonne » est [TopEdge] et « Match index » est 1, l’élément correspondant le plus proche du haut de l’écran est mis en correspondance. |
|
|
L’index de correspondance est croissant
|
MatchIndexAscending | boolean |
Si plusieurs éléments correspondent à la recherche, doit correspondre à « Faire correspondre l’index » en haut de la liste triée (true) ou en bas de la liste triée (false). |
|
|
Inclure des processus enfants
|
IncludeChildProcesses | boolean |
Si la valeur est true et qu’un « ID de processus de recherche » est spécifié, les processus enfants de cet ID de processus sont également inclus dans la recherche. Si la valeur est false, seul un processus correspondant à l’id de processus de recherche exact est retourné. |
|
|
Déclencher une exception si l’élément est introuvable
|
RaiseExceptionIfElementNotFound | boolean |
Doit-il IA-Connect déclencher une exception si l’élément UIA n’existe pas après la période d’attente ? |
|
|
Nombre maximal d’éléments à rechercher
|
MaxElementsToSearch | integer |
Nombre maximal d’éléments à rechercher lors de la recherche de l’élément cible dans l’arborescence UIA. Cette entrée fonctionne uniquement si le mode de recherche d’élément UIA est « Tree walk » (cela peut être activé dans la page paramètres de l’inspecteur). Par défaut, cette valeur est définie sur 0 (illimité). Cette entrée est généralement utilisée pour optimiser la recherche d’éléments. |
|
|
Profondeur maximale de recherche relative
|
MaxRelativeSearchDepth | integer |
Profondeur maximale de l’arborescence relative à la recherche d’éléments enfants sous l’élément parent. Les éléments enfants directs ont une valeur de profondeur de 1. Cette entrée fonctionne uniquement si le mode de recherche d’élément UIA est « Tree walk » (cela peut être activé dans la page paramètres de l’inspecteur). Défini sur 0 pour une profondeur de recherche illimitée. Cette entrée est généralement utilisée pour optimiser la recherche d’éléments. |
|
|
Nombre maximal d’éléments enfants à rechercher par nœud
|
MaxChildElementsToSearchPerNode | integer |
Nombre maximal d’éléments enfants à rechercher sous chaque élément lors de la recherche de l’arborescence UIA pour l’élément cible. Cette entrée fonctionne uniquement si le mode de recherche d’élément UIA est « Tree walk » (cela peut être activé dans la page paramètres de l’inspecteur). Par défaut, cette valeur est définie sur 0 (illimité). Cette entrée est généralement utilisée pour optimiser la recherche d’éléments. |
|
|
Types de contrôle localisés d’élément à parcourir
|
ElementLocalizedControlTypesNotToTraverse | string |
Liste séparée par des virgules des types de contrôle localisés par des éléments UIA pour ne pas traverser (pas à pas) lors de la recherche de l’arborescence UIA pour l’élément cible. La recherche vérifie toujours si un élément individuel correspond aux critères de recherche, mais il ne recherche aucun élément enfant de cet élément si son type de contrôle localisé figure dans cette liste d’exclusions. Cette entrée fonctionne uniquement si le mode de recherche d’élément UIA est « Tree walk » (cela peut être activé dans la page paramètres de l’inspecteur). Cette entrée est généralement utilisée pour optimiser la recherche d’éléments. |
|
|
Flux de travail
|
Workflow | True | string |
Ajoutez l’expression suivante ici : workflow() |
Retours
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
L’élément existe
|
ElementExists | boolean |
Retourne true si l’élément existe ou false si ce n’est pas le cas. |
|
Handle d’élément
|
ElementHandle | integer |
Handle UIA pour l’élément. Cela peut être utilisé comme entrée pour d’autres actions UIA agissant sur cet élément. |
|
Nom de l'élément
|
ElementName | string |
Nom UIA de l’élément. |
|
Nom de la classe d’élément
|
ElementClassName | string |
Nom de classe UIA de l’élément. |
|
ID d’automatisation de l’élément
|
ElementAutomationId | string |
ID d’automatisation UIA de l’élément. |
|
Type de contrôle localisé par l’élément
|
ElementLocalizedControlType | string |
Type de contrôle localisé UIA de l’élément. |
Attendre que l’élément UIA n’existe pas
Attend qu’un élément (généralement un élément individuel dans une fenêtre telle qu’un bouton ou une zone d’entrée de texte) n’existe plus.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Handle de fenêtre parent
|
ParentWindowHandle | True | integer |
Handle de fenêtre UIA parent (valeur 1 ou supérieure) pour agir comme point de départ de la recherche. Vous pouvez le découvrir via Inspection à l’aide d’actions telles que « Wait for desktop element » ou « Wait for element ». |
|
Nom de l’élément de recherche
|
SearchElementName | string |
Nom d’élément UIA facultatif à rechercher (à partir du handle de fenêtre parent). Cela peut être découvert par le biais de l’inspection. |
|
|
Nom de la classe d’élément Search
|
SearchElementClassName | string |
Nom de classe d’élément UIA facultatif à rechercher (à partir du handle de fenêtre parent). Cela peut être découvert par le biais de l’inspection. |
|
|
ID d’automatisation de l’élément de recherche
|
SearchElementAutomationId | string |
ID d’automatisation d’élément UIA facultatif à rechercher (à partir du handle de fenêtre parent). Cela peut être découvert par le biais de l’inspection. |
|
|
Type de contrôle localisé de l’élément de recherche
|
SearchLocalizedControlType | string |
Type de contrôle localisé de l’élément UIA facultatif à rechercher (à partir du handle de fenêtre parent). Cela peut être découvert par le biais de l’inspection. |
|
|
ID du processus de recherche
|
SearchProcessId | integer |
Si elle est spécifiée (valeur 1 ou supérieure), la recherche considère uniquement les éléments appartenant à un processus avec cet ID de processus (PID). Si IA-Connect lancé le processus, le PID est fourni par l’action « Exécuter le processus » dans les actions IA-Connect Environnement /Session. Si vous ne connaissez pas le PID, laissez ce champ vide (ou 0). |
|
|
Rechercher une sous-arborescence UIA
|
SearchSubTree | boolean |
Si la valeur est true, l’arborescence UIA entière située sous le handle de fenêtre parent est recherchée. Cela est plus approfondi, mais peut prendre plus de temps. Si la valeur est false, seuls les éléments directement sous le handle de fenêtre parent dans l’arborescence UIA sont recherchés. |
|
|
Secondes à attendre
|
SecondsToWait | True | integer |
Nombre maximal de secondes à attendre que l’élément n’existe pas. |
|
Index de correspondance
|
MatchIndex | integer |
Si plusieurs éléments correspondent à la recherche, quel élément (à partir de 1) doit être mis en correspondance. Peut être utilisé conjointement avec « Trier par colonne » pour choisir l’ordre de tri correspondant. |
|
|
Filtre de recherche
|
SearchFilter | string |
Filtre avancé facultatif pour restreindre davantage la recherche à l’aide d’opérateurs conditionnels et de tout champ d’élément. Exemple 1 : [Width] < 200. Exemple 2 : [Name] like 'Document*' AND [ClassName] like 'Label*'. Pour plus d’exemples, consultez la documentation. |
|
|
Trier par nom de colonne
|
SortByColumn | string |
Si plusieurs éléments correspondent à la recherche, cela vous permet de spécifier la propriété d’élément à trier par. Cela sera utilisé conjointement avec « Match index » pour sélectionner l’élément requis. Par exemple : si « Trier par nom de colonne » est [TopEdge] et « Match index » est 1, l’élément correspondant le plus proche du haut de l’écran est mis en correspondance. |
|
|
L’index de correspondance est croissant
|
MatchIndexAscending | boolean |
Si plusieurs éléments correspondent à la recherche, doit correspondre à « Faire correspondre l’index » en haut de la liste triée (true) ou en bas de la liste triée (false). |
|
|
Inclure des processus enfants
|
IncludeChildProcesses | boolean |
Si la valeur est true et qu’un « ID de processus de recherche » est spécifié, les processus enfants de cet ID de processus sont également inclus dans la recherche. Si la valeur est false, seul un processus correspondant à l’id de processus de recherche exact est retourné. |
|
|
Déclencher une exception si l’élément existe toujours
|
RaiseExceptionIfElementStillExists | boolean |
Doit-il IA-Connect déclencher une exception si l’élément UIA existe toujours après la période d’attente ? |
|
|
Nombre maximal d’éléments à rechercher
|
MaxElementsToSearch | integer |
Nombre maximal d’éléments à rechercher lors de la recherche de l’élément cible dans l’arborescence UIA. Cette entrée fonctionne uniquement si le mode de recherche d’élément UIA est « Tree walk » (cela peut être activé dans la page paramètres de l’inspecteur). Par défaut, cette valeur est définie sur 0 (illimité). Cette entrée est généralement utilisée pour optimiser la recherche d’éléments. |
|
|
Profondeur maximale de recherche relative
|
MaxRelativeSearchDepth | integer |
Profondeur maximale de l’arborescence relative à la recherche d’éléments enfants sous l’élément parent. Les éléments enfants directs ont une valeur de profondeur de 1. Cette entrée fonctionne uniquement si le mode de recherche d’élément UIA est « Tree walk » (cela peut être activé dans la page paramètres de l’inspecteur). Défini sur 0 pour une profondeur de recherche illimitée. Cette entrée est généralement utilisée pour optimiser la recherche d’éléments. |
|
|
Nombre maximal d’éléments enfants à rechercher par nœud
|
MaxChildElementsToSearchPerNode | integer |
Nombre maximal d’éléments enfants à rechercher sous chaque élément lors de la recherche de l’arborescence UIA pour l’élément cible. Cette entrée fonctionne uniquement si le mode de recherche d’élément UIA est « Tree walk » (cela peut être activé dans la page paramètres de l’inspecteur). Par défaut, cette valeur est définie sur 0 (illimité). Cette entrée est généralement utilisée pour optimiser la recherche d’éléments. |
|
|
Types de contrôle localisés d’élément à parcourir
|
ElementLocalizedControlTypesNotToTraverse | string |
Liste séparée par des virgules des types de contrôle localisés par des éléments UIA pour ne pas traverser (pas à pas) lors de la recherche de l’arborescence UIA pour l’élément cible. La recherche vérifie toujours si un élément individuel correspond aux critères de recherche, mais il ne recherche aucun élément enfant de cet élément si son type de contrôle localisé figure dans cette liste d’exclusions. Cette entrée fonctionne uniquement si le mode de recherche d’élément UIA est « Tree walk » (cela peut être activé dans la page paramètres de l’inspecteur). Cette entrée est généralement utilisée pour optimiser la recherche d’éléments. |
|
|
Flux de travail
|
Workflow | True | string |
Ajoutez l’expression suivante ici : workflow() |
Retours
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
L’élément existe avant d’attendre
|
ElementExistsBeforeWait | boolean |
Retourne true si l’élément existait avant d’attendre ou false si ce n’est pas le cas. |
|
L’élément existe après l’attente
|
ElementExistsAfterWait | boolean |
Retourne la valeur true si l’élément existait après l’attente ou la valeur false si ce n’est pas le cas. |
Attendre une image de recherche visible dans l’élément UIA
Attend qu’une image de recherche, fournie en tant qu’entrée à cette action, ait été visiblement située dans un élément UIA à l’écran, ou que le temps spécifié soit écoulé. L’élément doit d’abord être placé devant, car l’agent prend une capture d’écran sur les coordonnées de l’élément et recherche l’image de recherche fournie dans la capture d’écran. L’élément UIA doit exister à partir du début. L’action se termine immédiatement une fois l’image située.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Handle de fenêtre parent
|
ParentWindowHandle | integer |
Handle de fenêtre UIA parent (valeur 1 ou supérieure) pour agir comme point de départ de la recherche. Vous pouvez le découvrir via Inspection à l’aide d’actions telles que « Wait for desktop element » ou « Wait for element ». |
|
|
Nom de l’élément de recherche
|
SearchElementName | string |
Nom d’élément UIA facultatif à rechercher (à partir du handle de fenêtre parent). Cela peut être découvert par le biais de l’inspection. |
|
|
Nom de la classe d’élément Search
|
SearchElementClassName | string |
Nom de classe d’élément UIA facultatif à rechercher (à partir du handle de fenêtre parent). Cela peut être découvert par le biais de l’inspection. |
|
|
ID d’automatisation de l’élément de recherche
|
SearchElementAutomationId | string |
ID d’automatisation d’élément UIA facultatif à rechercher (à partir du handle de fenêtre parent). Cela peut être découvert par le biais de l’inspection. |
|
|
Type de contrôle localisé de l’élément de recherche
|
SearchLocalizedControlType | string |
Type de contrôle localisé de l’élément UIA facultatif à rechercher (à partir du handle de fenêtre parent). Cela peut être découvert par le biais de l’inspection. |
|
|
Rechercher une sous-arborescence UIA
|
SearchSubTree | boolean |
Si la valeur est true, l’arborescence UIA entière située sous le handle de fenêtre parent est recherchée. Cela est plus approfondi, mais peut prendre plus de temps. Si la valeur est false, seuls les éléments directement sous le handle de fenêtre parent dans l’arborescence UIA sont recherchés. |
|
|
Index de correspondance
|
MatchIndex | integer |
Si plusieurs éléments correspondent à la recherche, quel élément (à partir de 1) doit être mis en correspondance. Peut être utilisé conjointement avec « Trier par colonne » pour choisir l’ordre de tri correspondant. |
|
|
Filtre de recherche
|
SearchFilter | string |
Filtre avancé facultatif pour restreindre davantage la recherche à l’aide d’opérateurs conditionnels et de tout champ d’élément. Exemple 1 : [Width] < 200. Exemple 2 : [Name] like 'Document*' AND [ClassName] like 'Label*'. Pour plus d’exemples, consultez la documentation. |
|
|
Trier par nom de colonne
|
SortByColumn | string |
Si plusieurs éléments correspondent à la recherche, cela vous permet de spécifier la propriété d’élément à trier par. Cela sera utilisé conjointement avec « Match index » pour sélectionner l’élément requis. Par exemple : si « Trier par nom de colonne » est [TopEdge] et « Match index » est 1, l’élément correspondant le plus proche du haut de l’écran est mis en correspondance. |
|
|
L’index de correspondance est croissant
|
MatchIndexAscending | boolean |
Si plusieurs éléments correspondent à la recherche, doit correspondre à « Faire correspondre l’index » en haut de la liste triée (true) ou en bas de la liste triée (false). |
|
|
Nombre maximal d’éléments à rechercher
|
MaxElementsToSearch | integer |
Nombre maximal d’éléments à rechercher lors de la recherche de l’élément cible dans l’arborescence UIA. Cette entrée fonctionne uniquement si le mode de recherche d’élément UIA est « Tree walk » (cela peut être activé dans la page paramètres de l’inspecteur). Par défaut, cette valeur est définie sur 0 (illimité). Cette entrée est généralement utilisée pour optimiser la recherche d’éléments. |
|
|
Profondeur maximale de recherche relative
|
MaxRelativeSearchDepth | integer |
Profondeur maximale de l’arborescence relative à la recherche d’éléments enfants sous l’élément parent. Les éléments enfants directs ont une valeur de profondeur de 1. Cette entrée fonctionne uniquement si le mode de recherche d’élément UIA est « Tree walk » (cela peut être activé dans la page paramètres de l’inspecteur). Défini sur 0 pour une profondeur de recherche illimitée. Cette entrée est généralement utilisée pour optimiser la recherche d’éléments. |
|
|
Nombre maximal d’éléments enfants à rechercher par nœud
|
MaxChildElementsToSearchPerNode | integer |
Nombre maximal d’éléments enfants à rechercher sous chaque élément lors de la recherche de l’arborescence UIA pour l’élément cible. Cette entrée fonctionne uniquement si le mode de recherche d’élément UIA est « Tree walk » (cela peut être activé dans la page paramètres de l’inspecteur). Par défaut, cette valeur est définie sur 0 (illimité). Cette entrée est généralement utilisée pour optimiser la recherche d’éléments. |
|
|
Types de contrôle localisés d’élément à parcourir
|
ElementLocalizedControlTypesNotToTraverse | string |
Liste séparée par des virgules des types de contrôle localisés par des éléments UIA pour ne pas traverser (pas à pas) lors de la recherche de l’arborescence UIA pour l’élément cible. La recherche vérifie toujours si un élément individuel correspond aux critères de recherche, mais il ne recherche aucun élément enfant de cet élément si son type de contrôle localisé figure dans cette liste d’exclusions. Cette entrée fonctionne uniquement si le mode de recherche d’élément UIA est « Tree walk » (cela peut être activé dans la page paramètres de l’inspecteur). Cette entrée est généralement utilisée pour optimiser la recherche d’éléments. |
|
|
Type d’image de recherche
|
SearchImageType | string |
Définit ce que représente l’entrée « Image de recherche ». Si la valeur est « Fichier image du directeur », l’image de recherche est un chemin d’accès à un fichier accessible au directeur. Si la valeur est « Fichier image de l’agent », l’image de recherche est un chemin d’accès à un fichier accessible à l’agent. Si la valeur est « Base64 », l’image de recherche est une représentation base64 de l’image. |
|
|
Image de recherche
|
SearchImage | string |
Image de recherche à localiser dans l’élément UIA spécifié. Selon le « type d’image de recherche » spécifié, il peut contenir le chemin d’accès à un fichier image (à la fin du directeur ou de l’agent) ou contenir la base64 (représentation textuelle) de l’image à rechercher. |
|
|
Autre type d’image de recherche
|
AltSearchImageType | string |
Définit ce que représente l’entrée « Image de recherche alternative ». Si la valeur est « None » ou vide, il n’existe aucune autre image de recherche. Si la valeur est « Fichier image du directeur », l’image de recherche est un chemin d’accès à un fichier accessible au directeur. Si la valeur est « Fichier image de l’agent », l’image de recherche est un chemin d’accès à un fichier accessible à l’agent. Si la valeur est « Base64 », l’image de recherche est une représentation base64 de l’image. |
|
|
Autre image de recherche
|
AltSearchImage | string |
Une autre image de recherche facultative à localiser dans l’élément UIA spécifié. Selon le « type d’image de recherche alternatif » spécifié, il peut contenir le chemin d’accès à un fichier image (à la fin du directeur ou de l’agent) ou contenir la base64 (représentation textuelle) de l’image à rechercher. Si vous spécifiez une autre image de recherche, l’Agent recherche l’image de recherche ou l’image de recherche alternative et signale celle qui a été située. |
|
|
Écart maximal de couleur
|
MaxColourDeviation | integer |
Le maximum de couleurs de pixels d’un élément peut s’écarter des couleurs de pixels de l’image de recherche avant qu’elle ne soit considérée comme une correspondance. 0 pour aucun écart. L’écart est mesuré dans les valeurs RVB. Par exemple : #FF0000 est différent de 4 #FE0102. Cela permet d’ignorer les différences mineures de coloration. |
|
|
Différences de pixels maximales
|
MaxPixelDifferences | integer |
Nombre maximal de pixels qui peuvent différer (au-dessus de l’écart de couleur maximal), sur l’ensemble de l’image de recherche, avant qu’une image ne corresponde. Cela permet d’ignorer les différences mineures entre les images, mais des valeurs plus élevées peuvent augmenter le temps nécessaire pour localiser une image. Il est recommandé de définir la valeur 0 et d’augmenter de petites quantités si nécessaire. Si vous définissez une valeur supérieure à 0, vous devez également définir « Nombre maximal de différences de pixels consécutives ». |
|
|
Différences de pixels consécutives maximales
|
MaxConsecutivePixelDifferences | integer |
Nombre maximal de pixels qui peuvent différer (au-dessus de l’écart de couleur maximal), dans n’importe quelle ligne, avant qu’une image ne corresponde. Cela permet d’ignorer les différences mineures entre les images, mais des valeurs plus élevées peuvent augmenter le temps nécessaire pour localiser une image. Il est recommandé de définir la valeur 0 et d’augmenter de petites quantités si nécessaire. Si vous définissez une valeur supérieure à 0, vous devez également définir « Nombre maximal de différences de pixels ». |
|
|
Décalage X de pixel gauche
|
LeftPixelXOffset | integer |
Décalage X facultatif pour le bord gauche de la zone de recherche. Cela vous permet d’augmenter (avec des valeurs négatives) ou de diminuer (avec des valeurs positives) la zone de recherche. |
|
|
Décalage X pixel droit
|
RightPixelXOffset | integer |
Décalage X facultatif pour le bord droit de la zone de recherche. Cela vous permet d’augmenter (avec des valeurs positives) ou de diminuer (avec des valeurs négatives) la zone de recherche. |
|
|
Décalage Y du pixel supérieur
|
TopPixelYOffset | integer |
Décalage Y facultatif pour le bord supérieur de la zone de recherche. Cela vous permet d’augmenter (avec des valeurs négatives) ou de diminuer (avec des valeurs positives) la zone de recherche. |
|
|
Décalage Y en pixels inférieurs
|
BottomPixelYOffset | integer |
Décalage Y facultatif pour le bord inférieur de la zone de recherche. Cela vous permet d’augmenter (avec des valeurs positives) ou de diminuer (avec des valeurs négatives) la zone de recherche. |
|
|
Unité de décalages X pixels
|
PixelXOffsetsUnit | string |
Défini sur « Pixel » (valeur par défaut) si les décalages X de pixel gauche et droit sont mesurés en pixels. Défini sur « Pourcentage » si les décalages X de pixel gauche et droit sont mesurés sous la forme d’un pourcentage de la largeur de l’élément. |
|
|
Unité de décalages Y pixels
|
PixelYOffsetsUnit | string |
Défini sur « Pixel » (valeur par défaut) si les décalages Y de pixels supérieur et inférieur sont mesurés en pixels. Défini sur « Pourcentage » si les décalages Y en pixels supérieurs et inférieurs sont mesurés sous la forme d’un pourcentage de la hauteur de l’élément. |
|
|
Index d’image de recherche
|
SearchImageIndex | integer |
Définissez la valeur 1 pour localiser la première instance de l’image de recherche (dans la direction de la recherche) dans l’élément UIA. Défini sur 2 pour la deuxième instance, .... , N pour l’instance Nth. Si vous recherchez également une autre image, l’élément UIA est analysé en premier pour l’image de recherche et deuxièmement pour l’autre image, en recherchant l’instance demandée de cette image particulière (c’est-à-dire que l’agent attend l’une ou l’autre, pas une combinaison des deux images). |
|
|
Direction de la recherche d’images
|
ImageSearchDirection | string |
Direction de la recherche. « De haut » effectue des recherches par ligne en haut, analyse de gauche à droite dans chaque ligne. « De bas » effectue des recherches par ligne en bas, en analysant la gauche vers la droite dans chaque ligne. « De gauche » effectue des recherches par colonne de gauche, analyse en haut en bas dans chaque colonne. « De droite » effectue des recherches par colonne de droite, analyse en haut en bas dans chaque colonne. Cela peut être utilisé conjointement avec l'« index d’image de recherche » pour localiser la Nième image du haut, du bas, de la gauche ou de la droite. Pour améliorer les performances, sélectionnez la direction de recherche que vous pensez localiser plus rapidement votre image. |
|
|
Masquer l’agent
|
HideAgent | boolean |
Définissez la valeur true pour masquer automatiquement l’agent (s’il est visible) pour vous assurer qu’il ne masque pas l’élément analysé. |
|
|
Retourner les coordonnées de l’écran en tant que physiques
|
ReturnPhysicalCoordinates | boolean |
Définissez la valeur true pour que les coordonnées de l’écran soient retournées en tant que coordonnées physiques. Définissez la valeur false pour que les coordonnées de l’écran soient retournées en tant que coordonnées virtuelles. Si la mise à l’échelle d’affichage sous-jacente est de 100%, les coordonnées physiques et virtuelles sont identiques. Les coordonnées d’élément sont toujours retournées en tant que coordonnées virtuelles. |
|
|
Afficher le rectangle de mise en surbrillance
|
ShowHighlightRectangle | boolean |
Si la valeur est true, l’agent IA-Connect met en surbrillance l’image située à l’écran. Cela peut être utile pendant le développement, pour vous aider à visualiser que l’image correcte est détectée. |
|
|
Secondes d’attente de l’image de recherche
|
SecondsToWait | integer |
Nombre de secondes à attendre que l’image de recherche se trouve dans l’élément UIA. Si l’image n’est pas située, une exception est levée si « Déclencher une exception si l’image introuvable » est définie sur true, sinon l’action signale que l’image n’a pas été située. |
|
|
Millisecondes entre les recherches
|
MillisecondsBetweenSearches | integer |
Nombre de millisecondes à attendre entre chaque élément UIA à l’écran. Étant donné que la reconnaissance d’image peut être coûteuse du processeur, un délai peut aider à réduire et à répartir l’utilisation du processeur. Par exemple : si vous pensez qu’une image peut prendre jusqu’à 1 minute pour être visible, l’ajout d’une pause de 5 000 millisecondes (5 secondes) entre les analyses réduit considérablement l’utilisation du processeur (en réduisant considérablement le nombre d’analyses), mais n’a qu’un faible impact sur le temps de réponse. La valeur minimale autorisée est de 100 millisecondes (1/10 seconde). |
|
|
Déclencher une exception si l’image est introuvable
|
RaiseExceptionIfImageNotFound | boolean |
Défini sur true si IA-Connect doit déclencher une exception si l’image n’a pas pu être située après la période d’attente. |
|
|
Récupérer les données de sortie pour l’ID de thread
|
RetrieveOutputDataFromThreadId | integer |
Si vous définissez précédemment « Attendre le thread » sur false (ce qui entraîne l’exécution de l’attente dans un thread d’arrière-plan), indiquez l’ID de thread de l’agent pour récupérer les résultats. Cet ID de thread agent a été fourni par l’appel précédent à cette action. Sinon, définissez la valeur 0 (valeur par défaut). |
|
|
Attendre le thread
|
WaitForThread | boolean |
Définissez la valeur true pour attendre que le thread agent se termine ; L’agent attend tant que spécifié par « Secondes pour attendre l’image de recherche ». Définissez la valeur false pour contourner l’attente ; L’agent continuera d’effectuer l’attente en arrière-plan, mais sera également disponible pour l’action suivante. Vous pouvez ensuite récupérer les résultats ultérieurement à l’aide de l’action « Attendre que le thread agent se termine correctement » pour attendre que le thread de l’agent se termine, puis réexécuter cette action « Attendre l’image de recherche visible dans l’élément UIA » avec l’entrée « Récupérer les données de sortie pour l’ID de thread » définie sur l’ID de thread agent. |
|
|
Flux de travail
|
Workflow | True | string |
Ajoutez l’expression suivante ici : workflow() |
Retours
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
Image de recherche située
|
SearchImageLocated | boolean |
Cette sortie est définie sur true, si l’image de recherche a été localisée. Cette sortie est définie sur false si l’image de recherche n’a pas été localisée. |
|
Image de recherche située
|
WhichSearchImageLocated | integer |
Cette sortie est définie sur 0, si aucune image de recherche n’a été localisée. Défini sur 1, si l’image de recherche a été localisée. Défini sur 2, si l’image de recherche alternative était située. |
|
Image correspond à l’élément de zone englobante pixel gauche
|
SearchImageBoundingBoxElementLeftPixelXCoord | integer |
Coordonnée X virtuelle du pixel le plus à gauche correspondant à l’image spécifiée, par rapport à l’élément virtuel en haut à gauche. |
|
Image correspondance de l’élément cadre englobant pixel droit
|
SearchImageBoundingBoxElementRightPixelXCoord | integer |
Coordonnée X virtuelle du pixel le plus à droite correspondant à l’image spécifiée, par rapport à l’élément virtuel en haut à gauche. |
|
Image correspond à un élément de cadre englobant en pixel supérieur
|
SearchImageBoundingBoxElementTopPixelYCoord | integer |
Coordonnée Y virtuelle du pixel le plus haut correspondant à l’image spécifiée, par rapport à l’élément virtuel en haut à gauche. |
|
Image correspond à l’élément de cadre englobant en pixels inférieurs
|
SearchImageBoundingBoxElementBottomPixelYCoord | integer |
Coordonnée Y virtuelle du pixel le plus bas correspondant à l’image spécifiée, par rapport à l’élément virtuel en haut à gauche. |
|
Correspondance d’image avec un élément englobant du centre X pixel
|
SearchImageBoundingBoxElementCenterPixelXCoord | integer |
Coordonnée X virtuelle du centre du cadre englobant contenant des pixels correspondant à l’image spécifiée, par rapport à l’élément en haut à gauche de l’élément. |
|
Correspondance d’image avec un élément englobant du centre Y
|
SearchImageBoundingBoxElementCenterPixelYCoord | integer |
Coordonnée Y virtuelle du centre du cadre englobant contenant des pixels correspondant à l’image spécifiée, par rapport à l’élément en haut à gauche de l’élément. |
|
Image correspond à l’écran de zone englobante pixel gauche
|
SearchImageBoundingBoxScreenLeftPixelXCoord | integer |
Coordonnée X du pixel d’écran du pixel le plus à gauche correspondant à l’image spécifiée. Il s’agit d’une coordonnée physique ou virtuelle en fonction de l’entrée « Retourner les coordonnées physiques ». |
|
Image correspondant à l’écran de zone englobante pixel droit
|
SearchImageBoundingBoxScreenRightPixelXCoord | integer |
Coordonnée X du pixel d’écran du pixel le plus à droite correspondant à l’image spécifiée. Il s’agit d’une coordonnée physique ou virtuelle en fonction de l’entrée « Retourner les coordonnées physiques ». |
|
Image correspond à la zone englobante en pixel supérieur de l’écran
|
SearchImageBoundingBoxScreenTopPixelYCoord | integer |
Coordonnée Y du pixel d’écran du pixel supérieur correspondant à l’image spécifiée. Il s’agit d’une coordonnée physique ou virtuelle en fonction de l’entrée « Retourner les coordonnées physiques ». |
|
Image correspond à la zone englobante en pixels inférieurs
|
SearchImageBoundingBoxScreenBottomPixelYCoord | integer |
Coordonnée Y du pixel d’écran du pixel le plus bas correspondant à l’image spécifiée. Il s’agit d’une coordonnée physique ou virtuelle en fonction de l’entrée « Retourner les coordonnées physiques ». |
|
Correspondance d’image avec zone englobante centre X pixel
|
SearchImageBoundingBoxScreenCenterPixelXCoord | integer |
Coordonnée X du pixel d’écran du centre du cadre englobant contenant des pixels correspondant à l’image spécifiée. Il s’agit d’une coordonnée physique ou virtuelle en fonction de l’entrée « Retourner les coordonnées physiques ». |
|
Correspondance d’image avec zone englobante en pixelS Y du centre d’écran
|
SearchImageBoundingBoxScreenCenterPixelYCoord | integer |
Coordonnée Y du pixel d’écran du centre du cadre englobant contenant des pixels correspondant à l’image spécifiée. Il s’agit d’une coordonnée physique ou virtuelle en fonction de l’entrée « Retourner les coordonnées physiques ». |
|
Thread Id
|
ThreadId | integer |
Si vous avez défini « Attendre le thread » sur false (ce qui entraîne l’exécution de l’attente dans un thread d’arrière-plan), cette sortie contient l’ID du thread Agent qui peut être utilisé pour surveiller le processus de l’action et récupérer les résultats ultérieurement, une fois le thread terminé. |
Capture d’écran de l’emplacement de l’élément UIA
Prend une capture d’écran de l’emplacement d’un élément et retourne une image. L’élément doit d’abord être mis en avant, car la capture d’écran prend une copie de l’écran à l’emplacement des éléments.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Handle de fenêtre parent
|
ParentWindowHandle | True | integer |
Handle de fenêtre UIA parent (valeur 1 ou supérieure) pour agir comme point de départ de la recherche. Vous pouvez le découvrir via Inspection à l’aide d’actions telles que « Wait for desktop element » ou « Wait for element ». |
|
Nom de l’élément de recherche
|
SearchElementName | string |
Nom d’élément UIA facultatif à rechercher (à partir du handle de fenêtre parent). Cela peut être découvert par le biais de l’inspection. |
|
|
Nom de la classe d’élément Search
|
SearchElementClassName | string |
Nom de classe d’élément UIA facultatif à rechercher (à partir du handle de fenêtre parent). Cela peut être découvert par le biais de l’inspection. |
|
|
ID d’automatisation de l’élément de recherche
|
SearchElementAutomationId | string |
ID d’automatisation d’élément UIA facultatif à rechercher (à partir du handle de fenêtre parent). Cela peut être découvert par le biais de l’inspection. |
|
|
Type de contrôle localisé de l’élément de recherche
|
SearchLocalizedControlType | string |
Type de contrôle localisé de l’élément UIA facultatif à rechercher (à partir du handle de fenêtre parent). Cela peut être découvert par le biais de l’inspection. |
|
|
Rechercher une sous-arborescence UIA
|
SearchSubTree | boolean |
Si la valeur est true, l’arborescence UIA entière située sous le handle de fenêtre parent est recherchée. Cela est plus approfondi, mais peut prendre plus de temps. Si la valeur est false, seuls les éléments directement sous le handle de fenêtre parent dans l’arborescence UIA sont recherchés. |
|
|
Format d’image
|
ImageFormat | string |
Format d’image à utiliser pour la capture d’écran. Cela peut affecter la qualité et la taille des données retournées. Les formats pris en charge sont PNG (par défaut), JPG, BMP et GIF. |
|
|
Index de correspondance
|
MatchIndex | integer |
Si plusieurs éléments correspondent à la recherche, quel élément (à partir de 1) doit être mis en correspondance. Peut être utilisé conjointement avec « Trier par colonne » pour choisir l’ordre de tri correspondant. |
|
|
Filtre de recherche
|
SearchFilter | string |
Filtre avancé facultatif pour restreindre davantage la recherche à l’aide d’opérateurs conditionnels et de tout champ d’élément. Exemple 1 : [Width] < 200. Exemple 2 : [Name] like 'Document*' AND [ClassName] like 'Label*'. Pour plus d’exemples, consultez la documentation. |
|
|
Trier par nom de colonne
|
SortByColumn | string |
Si plusieurs éléments correspondent à la recherche, cela vous permet de spécifier la propriété d’élément à trier par. Cela sera utilisé conjointement avec « Match index » pour sélectionner l’élément requis. Par exemple : si « Trier par nom de colonne » est [TopEdge] et « Match index » est 1, l’élément correspondant le plus proche du haut de l’écran est mis en correspondance. |
|
|
L’index de correspondance est croissant
|
MatchIndexAscending | boolean |
Si plusieurs éléments correspondent à la recherche, doit correspondre à « Faire correspondre l’index » en haut de la liste triée (true) ou en bas de la liste triée (false). |
|
|
Masquer l’agent
|
HideAgent | boolean |
Définissez la valeur true pour masquer automatiquement l’agent (s’il est visible) pour vous assurer qu’il ne masque pas la capture d’écran. |
|
|
Nombre maximal d’éléments à rechercher
|
MaxElementsToSearch | integer |
Nombre maximal d’éléments à rechercher lors de la recherche de l’élément cible dans l’arborescence UIA. Cette entrée fonctionne uniquement si le mode de recherche d’élément UIA est « Tree walk » (cela peut être activé dans la page paramètres de l’inspecteur). Par défaut, cette valeur est définie sur 0 (illimité). Cette entrée est généralement utilisée pour optimiser la recherche d’éléments. |
|
|
Profondeur maximale de recherche relative
|
MaxRelativeSearchDepth | integer |
Profondeur maximale de l’arborescence relative à la recherche d’éléments enfants sous l’élément parent. Les éléments enfants directs ont une valeur de profondeur de 1. Cette entrée fonctionne uniquement si le mode de recherche d’élément UIA est « Tree walk » (cela peut être activé dans la page paramètres de l’inspecteur). Défini sur 0 pour une profondeur de recherche illimitée. Cette entrée est généralement utilisée pour optimiser la recherche d’éléments. |
|
|
Nombre maximal d’éléments enfants à rechercher par nœud
|
MaxChildElementsToSearchPerNode | integer |
Nombre maximal d’éléments enfants à rechercher sous chaque élément lors de la recherche de l’arborescence UIA pour l’élément cible. Cette entrée fonctionne uniquement si le mode de recherche d’élément UIA est « Tree walk » (cela peut être activé dans la page paramètres de l’inspecteur). Par défaut, cette valeur est définie sur 0 (illimité). Cette entrée est généralement utilisée pour optimiser la recherche d’éléments. |
|
|
Types de contrôle localisés d’élément à parcourir
|
ElementLocalizedControlTypesNotToTraverse | string |
Liste séparée par des virgules des types de contrôle localisés par des éléments UIA pour ne pas traverser (pas à pas) lors de la recherche de l’arborescence UIA pour l’élément cible. La recherche vérifie toujours si un élément individuel correspond aux critères de recherche, mais il ne recherche aucun élément enfant de cet élément si son type de contrôle localisé figure dans cette liste d’exclusions. Cette entrée fonctionne uniquement si le mode de recherche d’élément UIA est « Tree walk » (cela peut être activé dans la page paramètres de l’inspecteur). Cette entrée est généralement utilisée pour optimiser la recherche d’éléments. |
|
|
Flux de travail
|
Workflow | True | string |
Ajoutez l’expression suivante ici : workflow() |
Retours
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
Image d’écran en tant que Base64
|
ScreenBitmapBase64 | string |
Image d’écran sous forme de chaîne encodée En Base64. |
Clic de souris double gauche global sur l’élément UIA
Déplace la souris au centre, ou un bord, un coin ou un décalage choisi, par rapport à un élément UIA, puis double-clique sur le bouton gauche de la souris.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Handle de fenêtre parent
|
ParentWindowHandle | True | integer |
Handle de fenêtre UIA parent (valeur 1 ou supérieure) pour agir comme point de départ de la recherche. Vous pouvez le découvrir via Inspection à l’aide d’actions telles que « Wait for desktop element » ou « Wait for element ». |
|
Nom de l’élément de recherche
|
SearchElementName | string |
Nom d’élément UIA facultatif à rechercher (à partir du handle de fenêtre parent). Cela peut être découvert par le biais de l’inspection. |
|
|
Nom de la classe d’élément Search
|
SearchElementClassName | string |
Nom de classe d’élément UIA facultatif à rechercher (à partir du handle de fenêtre parent). Cela peut être découvert par le biais de l’inspection. |
|
|
ID d’automatisation de l’élément de recherche
|
SearchElementAutomationId | string |
ID d’automatisation d’élément UIA facultatif à rechercher (à partir du handle de fenêtre parent). Cela peut être découvert par le biais de l’inspection. |
|
|
Type de contrôle localisé de l’élément de recherche
|
SearchLocalizedControlType | string |
Type de contrôle localisé de l’élément UIA facultatif à rechercher (à partir du handle de fenêtre parent). Cela peut être découvert par le biais de l’inspection. |
|
|
Rechercher une sous-arborescence UIA
|
SearchSubTree | boolean |
Si la valeur est true, l’arborescence UIA entière située sous le handle de fenêtre parent est recherchée. Cela est plus approfondi, mais peut prendre plus de temps. Si la valeur est false, seuls les éléments directement sous le handle de fenêtre parent dans l’arborescence UIA sont recherchés. |
|
|
Retard en millisecondes
|
DelayInMilliseconds | integer |
Délai (en millisecondes) entre chacun des clics. |
|
|
Élément Focus en premier
|
FocusElementFirst | boolean |
Doit-il IA-Connect tenter de concentrer l’élément avant un clic global ? |
|
|
Index de correspondance
|
MatchIndex | integer |
Si plusieurs éléments correspondent à la recherche, quel élément (à partir de 1) doit être mis en correspondance. Peut être utilisé conjointement avec « Trier par colonne » pour choisir l’ordre de tri correspondant. |
|
|
Filtre de recherche
|
SearchFilter | string |
Filtre avancé facultatif pour restreindre davantage la recherche à l’aide d’opérateurs conditionnels et de tout champ d’élément. Exemple 1 : [Width] < 200. Exemple 2 : [Name] like 'Document*' AND [ClassName] like 'Label*'. Pour plus d’exemples, consultez la documentation. |
|
|
Trier par nom de colonne
|
SortByColumn | string |
Si plusieurs éléments correspondent à la recherche, cela vous permet de spécifier la propriété d’élément à trier par. Cela sera utilisé conjointement avec « Match index » pour sélectionner l’élément requis. Par exemple : si « Trier par nom de colonne » est [TopEdge] et « Match index » est 1, l’élément correspondant le plus proche du haut de l’écran est mis en correspondance. |
|
|
L’index de correspondance est croissant
|
MatchIndexAscending | boolean |
Si plusieurs éléments correspondent à la recherche, doit correspondre à « Faire correspondre l’index » en haut de la liste triée (true) ou en bas de la liste triée (false). |
|
|
Cliquer sur offset X
|
ClickOffsetX | integer |
Nombre de pixels X à décaler l’action de clic. Ce paramètre prend en charge les valeurs de décalage positives (à droite) et négatives (gauche). |
|
|
Cliquez sur décalage Y
|
ClickOffsetY | integer |
Nombre de pixels Y à décaler l’action de clic. Ce paramètre prend en charge les valeurs de décalage positives (bas) et négatives (haut). |
|
|
Décalage relatif à
|
OffsetRelativeTo | string |
Position relative de l’élément à décaler de (Centre/ Centre/ Milieu, Gauche, Droite, Haut, Bas, Haut Gauche, Haut à Droite, Bas Gauche, Bas Gauche, Bas Droit). |
|
|
Nombre maximal d’éléments à rechercher
|
MaxElementsToSearch | integer |
Nombre maximal d’éléments à rechercher lors de la recherche de l’élément cible dans l’arborescence UIA. Cette entrée fonctionne uniquement si le mode de recherche d’élément UIA est « Tree walk » (cela peut être activé dans la page paramètres de l’inspecteur). Par défaut, cette valeur est définie sur 0 (illimité). Cette entrée est généralement utilisée pour optimiser la recherche d’éléments. |
|
|
Profondeur maximale de recherche relative
|
MaxRelativeSearchDepth | integer |
Profondeur maximale de l’arborescence relative à la recherche d’éléments enfants sous l’élément parent. Les éléments enfants directs ont une valeur de profondeur de 1. Cette entrée fonctionne uniquement si le mode de recherche d’élément UIA est « Tree walk » (cela peut être activé dans la page paramètres de l’inspecteur). Défini sur 0 pour une profondeur de recherche illimitée. Cette entrée est généralement utilisée pour optimiser la recherche d’éléments. |
|
|
Nombre maximal d’éléments enfants à rechercher par nœud
|
MaxChildElementsToSearchPerNode | integer |
Nombre maximal d’éléments enfants à rechercher sous chaque élément lors de la recherche de l’arborescence UIA pour l’élément cible. Cette entrée fonctionne uniquement si le mode de recherche d’élément UIA est « Tree walk » (cela peut être activé dans la page paramètres de l’inspecteur). Par défaut, cette valeur est définie sur 0 (illimité). Cette entrée est généralement utilisée pour optimiser la recherche d’éléments. |
|
|
Types de contrôle localisés d’élément à parcourir
|
ElementLocalizedControlTypesNotToTraverse | string |
Liste séparée par des virgules des types de contrôle localisés par des éléments UIA pour ne pas traverser (pas à pas) lors de la recherche de l’arborescence UIA pour l’élément cible. La recherche vérifie toujours si un élément individuel correspond aux critères de recherche, mais il ne recherche aucun élément enfant de cet élément si son type de contrôle localisé figure dans cette liste d’exclusions. Cette entrée fonctionne uniquement si le mode de recherche d’élément UIA est « Tree walk » (cela peut être activé dans la page paramètres de l’inspecteur). Cette entrée est généralement utilisée pour optimiser la recherche d’éléments. |
|
|
Valider le point cliquable dans la limite de l’élément
|
ValidateClickablePointWithinElementBoundary | boolean |
Pour certains éléments, UIA n’a pas connaissance d’un point cliquable dans l’élément et retourne une coordonnée non valide (par exemple 0,0) au lieu du centre de l’élément. Si cette entrée est définie sur true, IA-Connect vérifie la validité de la coordonnée fournie par UIA et, si elle n’est pas comprise dans la limite de l’élément, ignore la valeur fournie par UIA et utilise le centre de l’élément à la place. |
|
|
Flux de travail
|
Workflow | True | string |
Ajoutez l’expression suivante ici : workflow() |
Clic droit global sur l’élément UIA
Déplace la souris au centre, ou un bord choisi, un coin ou un décalage, par rapport à un élément UIA, puis clique sur le bouton droit de la souris.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Handle de fenêtre parent
|
ParentWindowHandle | True | integer |
Handle de fenêtre UIA parent (valeur 1 ou supérieure) pour agir comme point de départ de la recherche. Vous pouvez le découvrir via Inspection à l’aide d’actions telles que « Wait for desktop element » ou « Wait for element ». |
|
Nom de l’élément de recherche
|
SearchElementName | string |
Nom d’élément UIA facultatif à rechercher (à partir du handle de fenêtre parent). Cela peut être découvert par le biais de l’inspection. |
|
|
Nom de la classe d’élément Search
|
SearchElementClassName | string |
Nom de classe d’élément UIA facultatif à rechercher (à partir du handle de fenêtre parent). Cela peut être découvert par le biais de l’inspection. |
|
|
ID d’automatisation de l’élément de recherche
|
SearchElementAutomationId | string |
ID d’automatisation d’élément UIA facultatif à rechercher (à partir du handle de fenêtre parent). Cela peut être découvert par le biais de l’inspection. |
|
|
Type de contrôle localisé de l’élément de recherche
|
SearchLocalizedControlType | string |
Type de contrôle localisé de l’élément UIA facultatif à rechercher (à partir du handle de fenêtre parent). Cela peut être découvert par le biais de l’inspection. |
|
|
Rechercher une sous-arborescence UIA
|
SearchSubTree | boolean |
Si la valeur est true, l’arborescence UIA entière située sous le handle de fenêtre parent est recherchée. Cela est plus approfondi, mais peut prendre plus de temps. Si la valeur est false, seuls les éléments directement sous le handle de fenêtre parent dans l’arborescence UIA sont recherchés. |
|
|
Élément Focus en premier
|
FocusElementFirst | boolean |
Doit-il IA-Connect tenter de concentrer l’élément avant un clic global ? |
|
|
Index de correspondance
|
MatchIndex | integer |
Si plusieurs éléments correspondent à la recherche, quel élément (à partir de 1) doit être mis en correspondance. Peut être utilisé conjointement avec « Trier par colonne » pour choisir l’ordre de tri correspondant. |
|
|
Filtre de recherche
|
SearchFilter | string |
Filtre avancé facultatif pour restreindre davantage la recherche à l’aide d’opérateurs conditionnels et de tout champ d’élément. Exemple 1 : [Width] < 200. Exemple 2 : [Name] like 'Document*' AND [ClassName] like 'Label*'. Pour plus d’exemples, consultez la documentation. |
|
|
Trier par nom de colonne
|
SortByColumn | string |
Si plusieurs éléments correspondent à la recherche, cela vous permet de spécifier la propriété d’élément à trier par. Cela sera utilisé conjointement avec « Match index » pour sélectionner l’élément requis. Par exemple : si « Trier par nom de colonne » est [TopEdge] et « Match index » est 1, l’élément correspondant le plus proche du haut de l’écran est mis en correspondance. |
|
|
L’index de correspondance est croissant
|
MatchIndexAscending | boolean |
Si plusieurs éléments correspondent à la recherche, doit correspondre à « Faire correspondre l’index » en haut de la liste triée (true) ou en bas de la liste triée (false). |
|
|
Cliquer sur offset X
|
ClickOffsetX | integer |
Nombre de pixels X à décaler l’action de clic. Ce paramètre prend en charge les valeurs de décalage positives (à droite) et négatives (gauche). |
|
|
Cliquez sur décalage Y
|
ClickOffsetY | integer |
Nombre de pixels Y à décaler l’action de clic. Ce paramètre prend en charge les valeurs de décalage positives (bas) et négatives (haut). |
|
|
Décalage relatif à
|
OffsetRelativeTo | string |
Position relative de l’élément à décaler de (Centre/ Centre/ Milieu, Gauche, Droite, Haut, Bas, Haut Gauche, Haut à Droite, Bas Gauche, Bas Gauche, Bas Droit). |
|
|
Nombre maximal d’éléments à rechercher
|
MaxElementsToSearch | integer |
Nombre maximal d’éléments à rechercher lors de la recherche de l’élément cible dans l’arborescence UIA. Cette entrée fonctionne uniquement si le mode de recherche d’élément UIA est « Tree walk » (cela peut être activé dans la page paramètres de l’inspecteur). Par défaut, cette valeur est définie sur 0 (illimité). Cette entrée est généralement utilisée pour optimiser la recherche d’éléments. |
|
|
Profondeur maximale de recherche relative
|
MaxRelativeSearchDepth | integer |
Profondeur maximale de l’arborescence relative à la recherche d’éléments enfants sous l’élément parent. Les éléments enfants directs ont une valeur de profondeur de 1. Cette entrée fonctionne uniquement si le mode de recherche d’élément UIA est « Tree walk » (cela peut être activé dans la page paramètres de l’inspecteur). Défini sur 0 pour une profondeur de recherche illimitée. Cette entrée est généralement utilisée pour optimiser la recherche d’éléments. |
|
|
Nombre maximal d’éléments enfants à rechercher par nœud
|
MaxChildElementsToSearchPerNode | integer |
Nombre maximal d’éléments enfants à rechercher sous chaque élément lors de la recherche de l’arborescence UIA pour l’élément cible. Cette entrée fonctionne uniquement si le mode de recherche d’élément UIA est « Tree walk » (cela peut être activé dans la page paramètres de l’inspecteur). Par défaut, cette valeur est définie sur 0 (illimité). Cette entrée est généralement utilisée pour optimiser la recherche d’éléments. |
|
|
Types de contrôle localisés d’élément à parcourir
|
ElementLocalizedControlTypesNotToTraverse | string |
Liste séparée par des virgules des types de contrôle localisés par des éléments UIA pour ne pas traverser (pas à pas) lors de la recherche de l’arborescence UIA pour l’élément cible. La recherche vérifie toujours si un élément individuel correspond aux critères de recherche, mais il ne recherche aucun élément enfant de cet élément si son type de contrôle localisé figure dans cette liste d’exclusions. Cette entrée fonctionne uniquement si le mode de recherche d’élément UIA est « Tree walk » (cela peut être activé dans la page paramètres de l’inspecteur). Cette entrée est généralement utilisée pour optimiser la recherche d’éléments. |
|
|
Valider le point cliquable dans la limite de l’élément
|
ValidateClickablePointWithinElementBoundary | boolean |
Pour certains éléments, UIA n’a pas connaissance d’un point cliquable dans l’élément et retourne une coordonnée non valide (par exemple 0,0) au lieu du centre de l’élément. Si cette entrée est définie sur true, IA-Connect vérifie la validité de la coordonnée fournie par UIA et, si elle n’est pas comprise dans la limite de l’élément, ignore la valeur fournie par UIA et utilise le centre de l’élément à la place. |
|
|
Flux de travail
|
Workflow | True | string |
Ajoutez l’expression suivante ici : workflow() |
Clic gauche global sur l’élément UIA
Déplace la souris au centre, ou un bord, un angle ou un décalage choisi, par rapport à un élément UIA, puis clique sur le bouton gauche de la souris.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Handle de fenêtre parent
|
ParentWindowHandle | True | integer |
Handle de fenêtre UIA parent (valeur 1 ou supérieure) pour agir comme point de départ de la recherche. Vous pouvez le découvrir via Inspection à l’aide d’actions telles que « Wait for desktop element » ou « Wait for element ». |
|
Nom de l’élément de recherche
|
SearchElementName | string |
Nom d’élément UIA facultatif à rechercher (à partir du handle de fenêtre parent). Cela peut être découvert par le biais de l’inspection. |
|
|
Nom de la classe d’élément Search
|
SearchElementClassName | string |
Nom de classe d’élément UIA facultatif à rechercher (à partir du handle de fenêtre parent). Cela peut être découvert par le biais de l’inspection. |
|
|
ID d’automatisation de l’élément de recherche
|
SearchElementAutomationId | string |
ID d’automatisation d’élément UIA facultatif à rechercher (à partir du handle de fenêtre parent). Cela peut être découvert par le biais de l’inspection. |
|
|
Type de contrôle localisé de l’élément de recherche
|
SearchLocalizedControlType | string |
Type de contrôle localisé de l’élément UIA facultatif à rechercher (à partir du handle de fenêtre parent). Cela peut être découvert par le biais de l’inspection. |
|
|
Rechercher une sous-arborescence UIA
|
SearchSubTree | boolean |
Si la valeur est true, l’arborescence UIA entière située sous le handle de fenêtre parent est recherchée. Cela est plus approfondi, mais peut prendre plus de temps. Si la valeur est false, seuls les éléments directement sous le handle de fenêtre parent dans l’arborescence UIA sont recherchés. |
|
|
Élément Focus en premier
|
FocusElementFirst | boolean |
Doit-il IA-Connect tenter de concentrer l’élément avant un clic global ? |
|
|
Index de correspondance
|
MatchIndex | integer |
Si plusieurs éléments correspondent à la recherche, quel élément (à partir de 1) doit être mis en correspondance. Peut être utilisé conjointement avec « Trier par colonne » pour choisir l’ordre de tri correspondant. |
|
|
Filtre de recherche
|
SearchFilter | string |
Filtre avancé facultatif pour restreindre davantage la recherche à l’aide d’opérateurs conditionnels et de tout champ d’élément. Exemple 1 : [Width] < 200. Exemple 2 : [Name] like 'Document*' AND [ClassName] like 'Label*'. Pour plus d’exemples, consultez la documentation. |
|
|
Trier par nom de colonne
|
SortByColumn | string |
Si plusieurs éléments correspondent à la recherche, cela vous permet de spécifier la propriété d’élément à trier par. Cela sera utilisé conjointement avec « Match index » pour sélectionner l’élément requis. Par exemple : si « Trier par nom de colonne » est [TopEdge] et « Match index » est 1, l’élément correspondant le plus proche du haut de l’écran est mis en correspondance. |
|
|
L’index de correspondance est croissant
|
MatchIndexAscending | boolean |
Si plusieurs éléments correspondent à la recherche, doit correspondre à « Faire correspondre l’index » en haut de la liste triée (true) ou en bas de la liste triée (false). |
|
|
Cliquer sur offset X
|
ClickOffsetX | integer |
Nombre de pixels X à décaler l’action de clic. Ce paramètre prend en charge les valeurs de décalage positives (à droite) et négatives (gauche). |
|
|
Cliquez sur décalage Y
|
ClickOffsetY | integer |
Nombre de pixels Y à décaler l’action de clic. Ce paramètre prend en charge les valeurs de décalage positives (bas) et négatives (haut). |
|
|
Décalage relatif à
|
OffsetRelativeTo | string |
Position relative de l’élément à décaler de (Centre/ Centre/ Milieu, Gauche, Droite, Haut, Bas, Haut Gauche, Haut à Droite, Bas Gauche, Bas Gauche, Bas Droit). |
|
|
Nombre maximal d’éléments à rechercher
|
MaxElementsToSearch | integer |
Nombre maximal d’éléments à rechercher lors de la recherche de l’élément cible dans l’arborescence UIA. Cette entrée fonctionne uniquement si le mode de recherche d’élément UIA est « Tree walk » (cela peut être activé dans la page paramètres de l’inspecteur). Par défaut, cette valeur est définie sur 0 (illimité). Cette entrée est généralement utilisée pour optimiser la recherche d’éléments. |
|
|
Profondeur maximale de recherche relative
|
MaxRelativeSearchDepth | integer |
Profondeur maximale de l’arborescence relative à la recherche d’éléments enfants sous l’élément parent. Les éléments enfants directs ont une valeur de profondeur de 1. Cette entrée fonctionne uniquement si le mode de recherche d’élément UIA est « Tree walk » (cela peut être activé dans la page paramètres de l’inspecteur). Défini sur 0 pour une profondeur de recherche illimitée. Cette entrée est généralement utilisée pour optimiser la recherche d’éléments. |
|
|
Nombre maximal d’éléments enfants à rechercher par nœud
|
MaxChildElementsToSearchPerNode | integer |
Nombre maximal d’éléments enfants à rechercher sous chaque élément lors de la recherche de l’arborescence UIA pour l’élément cible. Cette entrée fonctionne uniquement si le mode de recherche d’élément UIA est « Tree walk » (cela peut être activé dans la page paramètres de l’inspecteur). Par défaut, cette valeur est définie sur 0 (illimité). Cette entrée est généralement utilisée pour optimiser la recherche d’éléments. |
|
|
Types de contrôle localisés d’élément à parcourir
|
ElementLocalizedControlTypesNotToTraverse | string |
Liste séparée par des virgules des types de contrôle localisés par des éléments UIA pour ne pas traverser (pas à pas) lors de la recherche de l’arborescence UIA pour l’élément cible. La recherche vérifie toujours si un élément individuel correspond aux critères de recherche, mais il ne recherche aucun élément enfant de cet élément si son type de contrôle localisé figure dans cette liste d’exclusions. Cette entrée fonctionne uniquement si le mode de recherche d’élément UIA est « Tree walk » (cela peut être activé dans la page paramètres de l’inspecteur). Cette entrée est généralement utilisée pour optimiser la recherche d’éléments. |
|
|
Valider le point cliquable dans la limite de l’élément
|
ValidateClickablePointWithinElementBoundary | boolean |
Pour certains éléments, UIA n’a pas connaissance d’un point cliquable dans l’élément et retourne une coordonnée non valide (par exemple 0,0) au lieu du centre de l’élément. Si cette entrée est définie sur true, IA-Connect vérifie la validité de la coordonnée fournie par UIA et, si elle n’est pas comprise dans la limite de l’élément, ignore la valeur fournie par UIA et utilise le centre de l’élément à la place. |
|
|
Flux de travail
|
Workflow | True | string |
Ajoutez l’expression suivante ici : workflow() |
Clic global de la souris centrale sur l’élément UIA
Déplace la souris au centre, ou un bord, un coin ou un décalage choisi, par rapport à un élément UIA, puis clique sur le bouton de la souris centrale.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Handle de fenêtre parent
|
ParentWindowHandle | True | integer |
Handle de fenêtre UIA parent (valeur 1 ou supérieure) pour agir comme point de départ de la recherche. Vous pouvez le découvrir via Inspection à l’aide d’actions telles que « Wait for desktop element » ou « Wait for element ». |
|
Nom de l’élément de recherche
|
SearchElementName | string |
Nom d’élément UIA facultatif à rechercher (à partir du handle de fenêtre parent). Cela peut être découvert par le biais de l’inspection. |
|
|
Nom de la classe d’élément Search
|
SearchElementClassName | string |
Nom de classe d’élément UIA facultatif à rechercher (à partir du handle de fenêtre parent). Cela peut être découvert par le biais de l’inspection. |
|
|
ID d’automatisation de l’élément de recherche
|
SearchElementAutomationId | string |
ID d’automatisation d’élément UIA facultatif à rechercher (à partir du handle de fenêtre parent). Cela peut être découvert par le biais de l’inspection. |
|
|
Type de contrôle localisé de l’élément de recherche
|
SearchLocalizedControlType | string |
Type de contrôle localisé de l’élément UIA facultatif à rechercher (à partir du handle de fenêtre parent). Cela peut être découvert par le biais de l’inspection. |
|
|
Rechercher une sous-arborescence UIA
|
SearchSubTree | boolean |
Si la valeur est true, l’arborescence UIA entière située sous le handle de fenêtre parent est recherchée. Cela est plus approfondi, mais peut prendre plus de temps. Si la valeur est false, seuls les éléments directement sous le handle de fenêtre parent dans l’arborescence UIA sont recherchés. |
|
|
Élément Focus en premier
|
FocusElementFirst | boolean |
Doit-il IA-Connect tenter de concentrer l’élément avant un clic global ? |
|
|
Index de correspondance
|
MatchIndex | integer |
Si plusieurs éléments correspondent à la recherche, quel élément (à partir de 1) doit être mis en correspondance. Peut être utilisé conjointement avec « Trier par colonne » pour choisir l’ordre de tri correspondant. |
|
|
Filtre de recherche
|
SearchFilter | string |
Filtre avancé facultatif pour restreindre davantage la recherche à l’aide d’opérateurs conditionnels et de tout champ d’élément. Exemple 1 : [Width] < 200. Exemple 2 : [Name] like 'Document*' AND [ClassName] like 'Label*'. Pour plus d’exemples, consultez la documentation. |
|
|
Trier par nom de colonne
|
SortByColumn | string |
Si plusieurs éléments correspondent à la recherche, cela vous permet de spécifier la propriété d’élément à trier par. Cela sera utilisé conjointement avec « Match index » pour sélectionner l’élément requis. Par exemple : si « Trier par nom de colonne » est [TopEdge] et « Match index » est 1, l’élément correspondant le plus proche du haut de l’écran est mis en correspondance. |
|
|
L’index de correspondance est croissant
|
MatchIndexAscending | boolean |
Si plusieurs éléments correspondent à la recherche, doit correspondre à « Faire correspondre l’index » en haut de la liste triée (true) ou en bas de la liste triée (false). |
|
|
Cliquer sur offset X
|
ClickOffsetX | integer |
Nombre de pixels X à décaler l’action de clic. Ce paramètre prend en charge les valeurs de décalage positives (à droite) et négatives (gauche). |
|
|
Cliquez sur décalage Y
|
ClickOffsetY | integer |
Nombre de pixels Y à décaler l’action de clic. Ce paramètre prend en charge les valeurs de décalage positives (bas) et négatives (haut). |
|
|
Décalage relatif à
|
OffsetRelativeTo | string |
Position relative de l’élément à décaler de (Centre/ Centre/ Milieu, Gauche, Droite, Haut, Bas, Haut Gauche, Haut à Droite, Bas Gauche, Bas Gauche, Bas Droit). |
|
|
Nombre maximal d’éléments à rechercher
|
MaxElementsToSearch | integer |
Nombre maximal d’éléments à rechercher lors de la recherche de l’élément cible dans l’arborescence UIA. Cette entrée fonctionne uniquement si le mode de recherche d’élément UIA est « Tree walk » (cela peut être activé dans la page paramètres de l’inspecteur). Par défaut, cette valeur est définie sur 0 (illimité). Cette entrée est généralement utilisée pour optimiser la recherche d’éléments. |
|
|
Profondeur maximale de recherche relative
|
MaxRelativeSearchDepth | integer |
Profondeur maximale de l’arborescence relative à la recherche d’éléments enfants sous l’élément parent. Les éléments enfants directs ont une valeur de profondeur de 1. Cette entrée fonctionne uniquement si le mode de recherche d’élément UIA est « Tree walk » (cela peut être activé dans la page paramètres de l’inspecteur). Défini sur 0 pour une profondeur de recherche illimitée. Cette entrée est généralement utilisée pour optimiser la recherche d’éléments. |
|
|
Nombre maximal d’éléments enfants à rechercher par nœud
|
MaxChildElementsToSearchPerNode | integer |
Nombre maximal d’éléments enfants à rechercher sous chaque élément lors de la recherche de l’arborescence UIA pour l’élément cible. Cette entrée fonctionne uniquement si le mode de recherche d’élément UIA est « Tree walk » (cela peut être activé dans la page paramètres de l’inspecteur). Par défaut, cette valeur est définie sur 0 (illimité). Cette entrée est généralement utilisée pour optimiser la recherche d’éléments. |
|
|
Types de contrôle localisés d’élément à parcourir
|
ElementLocalizedControlTypesNotToTraverse | string |
Liste séparée par des virgules des types de contrôle localisés par des éléments UIA pour ne pas traverser (pas à pas) lors de la recherche de l’arborescence UIA pour l’élément cible. La recherche vérifie toujours si un élément individuel correspond aux critères de recherche, mais il ne recherche aucun élément enfant de cet élément si son type de contrôle localisé figure dans cette liste d’exclusions. Cette entrée fonctionne uniquement si le mode de recherche d’élément UIA est « Tree walk » (cela peut être activé dans la page paramètres de l’inspecteur). Cette entrée est généralement utilisée pour optimiser la recherche d’éléments. |
|
|
Valider le point cliquable dans la limite de l’élément
|
ValidateClickablePointWithinElementBoundary | boolean |
Pour certains éléments, UIA n’a pas connaissance d’un point cliquable dans l’élément et retourne une coordonnée non valide (par exemple 0,0) au lieu du centre de l’élément. Si cette entrée est définie sur true, IA-Connect vérifie la validité de la coordonnée fournie par UIA et, si elle n’est pas comprise dans la limite de l’élément, ignore la valeur fournie par UIA et utilise le centre de l’élément à la place. |
|
|
Flux de travail
|
Workflow | True | string |
Ajoutez l’expression suivante ici : workflow() |
Cliquez sur la souris globale sur la zone de couleur de recherche d’élément UIA
Déplace la souris sur une région de pixels au sein d’un élément UIA qui répond aux critères de couleur spécifiés et effectue un clic de souris. L’élément doit d’abord être mis en avant, car la capture d’écran prend une copie de l’écran à l’emplacement des éléments.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Handle de fenêtre parent
|
ParentWindowHandle | True | integer |
Handle de fenêtre UIA parent (valeur 1 ou supérieure) pour agir comme point de départ de la recherche. Vous pouvez le découvrir via Inspection à l’aide d’actions telles que « Wait for desktop element » ou « Wait for element ». |
|
Nom de l’élément de recherche
|
SearchElementName | string |
Nom d’élément UIA facultatif à rechercher (à partir du handle de fenêtre parent). Cela peut être découvert par le biais de l’inspection. |
|
|
Nom de la classe d’élément Search
|
SearchElementClassName | string |
Nom de classe d’élément UIA facultatif à rechercher (à partir du handle de fenêtre parent). Cela peut être découvert par le biais de l’inspection. |
|
|
ID d’automatisation de l’élément de recherche
|
SearchElementAutomationId | string |
ID d’automatisation d’élément UIA facultatif à rechercher (à partir du handle de fenêtre parent). Cela peut être découvert par le biais de l’inspection. |
|
|
Type de contrôle localisé de l’élément de recherche
|
SearchLocalizedControlType | string |
Type de contrôle localisé de l’élément UIA facultatif à rechercher (à partir du handle de fenêtre parent). Cela peut être découvert par le biais de l’inspection. |
|
|
Rechercher une sous-arborescence UIA
|
SearchSubTree | boolean |
Si la valeur est true, l’arborescence UIA entière située sous le handle de fenêtre parent est recherchée. Cela est plus approfondi, mais peut prendre plus de temps. Si la valeur est false, seuls les éléments directement sous le handle de fenêtre parent dans l’arborescence UIA sont recherchés. |
|
|
Index de correspondance
|
MatchIndex | integer |
Si plusieurs éléments correspondent à la recherche, quel élément (à partir de 1) doit être mis en correspondance. Peut être utilisé conjointement avec « Trier par colonne » pour choisir l’ordre de tri correspondant. |
|
|
Filtre de recherche
|
SearchFilter | string |
Filtre avancé facultatif pour restreindre davantage la recherche à l’aide d’opérateurs conditionnels et de tout champ d’élément. Exemple 1 : [Width] < 200. Exemple 2 : [Name] like 'Document*' AND [ClassName] like 'Label*'. Pour plus d’exemples, consultez la documentation. |
|
|
Trier par nom de colonne
|
SortByColumn | string |
Si plusieurs éléments correspondent à la recherche, cela vous permet de spécifier la propriété d’élément à trier par. Cela sera utilisé conjointement avec « Match index » pour sélectionner l’élément requis. Par exemple : si « Trier par nom de colonne » est [TopEdge] et « Match index » est 1, l’élément correspondant le plus proche du haut de l’écran est mis en correspondance. |
|
|
L’index de correspondance est croissant
|
MatchIndexAscending | boolean |
Si plusieurs éléments correspondent à la recherche, doit correspondre à « Faire correspondre l’index » en haut de la liste triée (true) ou en bas de la liste triée (false). |
|
|
Couleur de recherche
|
SearchColour | True | string |
Couleur de recherche au format 0xAARRGGBB, #AARRGGBB, 0xRRGGBB ou #RRGGBB où chaque canal de couleur est un octet au format hexadécimal (00 est entièrement désactivé, FF est entièrement activé). Par exemple : #FF0000 pour le rouge, #00FF00 pour le bleu, #0000000 pour le noir, #FFFFFF pour le blanc. |
|
Écart maximal de couleur
|
MaxColourDeviation | True | integer |
La couleur maximale d’un élément peut s’écarter de la couleur de recherche avant qu’elle ne soit considérée comme une correspondance. 0 pour aucun écart. L’écart est mesuré dans les valeurs RVB. Par exemple : #FF0000 est différent de 4 #FE0102. Un écart de 15 serait un bon point de départ. |
|
Décalage X de pixel gauche
|
LeftPixelXOffset | integer |
Décalage X facultatif pour le bord gauche de la zone de recherche. Cela vous permet d’augmenter (avec des valeurs négatives) ou de diminuer (avec des valeurs positives) la zone de recherche. |
|
|
Décalage X pixel droit
|
RightPixelXOffset | integer |
Décalage X facultatif pour le bord droit de la zone de recherche. Cela vous permet d’augmenter (avec des valeurs positives) ou de diminuer (avec des valeurs négatives) la zone de recherche. |
|
|
Décalage Y du pixel supérieur
|
TopPixelYOffset | integer |
Décalage Y facultatif pour le bord supérieur de la zone de recherche. Cela vous permet d’augmenter (avec des valeurs négatives) ou de diminuer (avec des valeurs positives) la zone de recherche. |
|
|
Décalage Y en pixels inférieurs
|
BottomPixelYOffset | integer |
Décalage Y facultatif pour le bord inférieur de la zone de recherche. Cela vous permet d’augmenter (avec des valeurs positives) ou de diminuer (avec des valeurs négatives) la zone de recherche. |
|
|
Bouton souris
|
MouseButton | string |
Bouton de la souris à appuyer sur (gauche, droite, milieu, double gauche). |
|
|
Cliquer sur offset X
|
ClickOffsetX | integer |
Nombre de pixels X à décaler l’action de clic. Ce paramètre prend en charge les valeurs de décalage positives (à droite) et négatives (gauche). |
|
|
Cliquez sur décalage Y
|
ClickOffsetY | integer |
Nombre de pixels Y à décaler l’action de clic. Ce paramètre prend en charge les valeurs de décalage positives (bas) et négatives (haut). |
|
|
Décalage relatif à
|
OffsetRelativeTo | string |
Position relative de la zone de couleur à décaler de (Centre/ Centre/ Milieu, Gauche, Droite, Haut, Bas, Haut, Haut Gauche, Haut Droit, Bas Gauche, Bas Gauche, Bas Droit). |
|
|
Retard en millisecondes
|
DelayInMilliseconds | integer |
Si vous effectuez un double-clic, délai (en millisecondes) entre chacun des clics. |
|
|
Masquer l’agent
|
HideAgent | boolean |
Définissez la valeur true pour masquer automatiquement l’agent (s’il est visible) pour vous assurer qu’il ne masque pas l’élément analysé. |
|
|
Nombre maximal d’éléments à rechercher
|
MaxElementsToSearch | integer |
Nombre maximal d’éléments à rechercher lors de la recherche de l’élément cible dans l’arborescence UIA. Cette entrée fonctionne uniquement si le mode de recherche d’élément UIA est « Tree walk » (cela peut être activé dans la page paramètres de l’inspecteur). Par défaut, cette valeur est définie sur 0 (illimité). Cette entrée est généralement utilisée pour optimiser la recherche d’éléments. |
|
|
Profondeur maximale de recherche relative
|
MaxRelativeSearchDepth | integer |
Profondeur maximale de l’arborescence relative à la recherche d’éléments enfants sous l’élément parent. Les éléments enfants directs ont une valeur de profondeur de 1. Cette entrée fonctionne uniquement si le mode de recherche d’élément UIA est « Tree walk » (cela peut être activé dans la page paramètres de l’inspecteur). Défini sur 0 pour une profondeur de recherche illimitée. Cette entrée est généralement utilisée pour optimiser la recherche d’éléments. |
|
|
Nombre maximal d’éléments enfants à rechercher par nœud
|
MaxChildElementsToSearchPerNode | integer |
Nombre maximal d’éléments enfants à rechercher sous chaque élément lors de la recherche de l’arborescence UIA pour l’élément cible. Cette entrée fonctionne uniquement si le mode de recherche d’élément UIA est « Tree walk » (cela peut être activé dans la page paramètres de l’inspecteur). Par défaut, cette valeur est définie sur 0 (illimité). Cette entrée est généralement utilisée pour optimiser la recherche d’éléments. |
|
|
Types de contrôle localisés d’élément à parcourir
|
ElementLocalizedControlTypesNotToTraverse | string |
Liste séparée par des virgules des types de contrôle localisés par des éléments UIA pour ne pas traverser (pas à pas) lors de la recherche de l’arborescence UIA pour l’élément cible. La recherche vérifie toujours si un élément individuel correspond aux critères de recherche, mais il ne recherche aucun élément enfant de cet élément si son type de contrôle localisé figure dans cette liste d’exclusions. Cette entrée fonctionne uniquement si le mode de recherche d’élément UIA est « Tree walk » (cela peut être activé dans la page paramètres de l’inspecteur). Cette entrée est généralement utilisée pour optimiser la recherche d’éléments. |
|
|
Flux de travail
|
Workflow | True | string |
Ajoutez l’expression suivante ici : workflow() |
Retours
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
Résultat de la commande
|
UIAGlobalMouseClickElementSearchColourRegionResult | boolean |
Résultat de la commande (réussite ou échec). |
|
Message d'erreur
|
ErrorMessage | string |
Si la commande n’a pas réussi, cela contiendra le message d’erreur retourné. |
Cliquez sur élément de liste UIA par index
Clique sur l’élément de liste qui correspond à l’index spécifié. Il est généralement utilisé pour sélectionner un élément dans une liste déroulante/élément de menu.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Handle de fenêtre parent
|
ParentWindowHandle | True | integer |
Handle de fenêtre UIA parent (valeur 1 ou supérieure) pour agir comme point de départ de la recherche. Vous pouvez le découvrir via Inspection à l’aide d’actions telles que « Wait for desktop element » ou « Wait for element ». |
|
Nom de l’élément de recherche
|
SearchElementName | string |
Nom d’élément UIA facultatif à rechercher (à partir du handle de fenêtre parent). Cela peut être découvert par le biais de l’inspection. |
|
|
Nom de la classe d’élément Search
|
SearchElementClassName | string |
Nom de classe d’élément UIA facultatif à rechercher (à partir du handle de fenêtre parent). Cela peut être découvert par le biais de l’inspection. |
|
|
ID d’automatisation de l’élément de recherche
|
SearchElementAutomationId | string |
ID d’automatisation d’élément UIA facultatif à rechercher (à partir du handle de fenêtre parent). Cela peut être découvert par le biais de l’inspection. |
|
|
Type de contrôle localisé de l’élément de recherche
|
SearchLocalizedControlType | string |
Type de contrôle localisé de l’élément UIA facultatif à rechercher (à partir du handle de fenêtre parent). Cela peut être découvert par le biais de l’inspection. |
|
|
Rechercher une sous-arborescence UIA
|
SearchSubTree | boolean |
Si la valeur est true, l’arborescence UIA entière située sous le handle de fenêtre parent est recherchée. Cela est plus approfondi, mais peut prendre plus de temps. Si la valeur est false, seuls les éléments directement sous le handle de fenêtre parent dans l’arborescence UIA sont recherchés. |
|
|
Développer en premier
|
ExpandFirst | boolean |
Si la valeur est true, IA-Connect tente de développer la liste avant de rechercher les éléments d’élément de liste. Cela est utile pour les listes dynamiques, car les éléments d’élément de liste peuvent ne pas être créés tant que la liste n’est pas développée. |
|
|
Réduire après
|
CollapseAfter | boolean |
Si la valeur est true, la liste est réduite après l’exécution de la recherche. |
|
|
Index d’élément
|
ItemIndex | integer |
Index dans la liste de l’élément à cliquer. |
|
|
Secondes entre développer et réduire
|
SecondsBetweenExpandCollapse | double |
Nombre de secondes à attendre entre les actions de développement et de réduction si celles-ci sont définies sur true. |
|
|
Index de correspondance
|
MatchIndex | integer |
Si plusieurs éléments correspondent à la recherche, quel élément (à partir de 1) doit être mis en correspondance. Peut être utilisé conjointement avec « Trier par colonne » pour choisir l’ordre de tri correspondant. |
|
|
Filtre de recherche
|
SearchFilter | string |
Filtre avancé facultatif pour restreindre davantage la recherche à l’aide d’opérateurs conditionnels et de tout champ d’élément. Exemple 1 : [Width] < 200. Exemple 2 : [Name] like 'Document*' AND [ClassName] like 'Label*'. Pour plus d’exemples, consultez la documentation. |
|
|
Trier par nom de colonne
|
SortByColumn | string |
Si plusieurs éléments correspondent à la recherche, cela vous permet de spécifier la propriété d’élément à trier par. Cela sera utilisé conjointement avec « Match index » pour sélectionner l’élément requis. Par exemple : si « Trier par nom de colonne » est [TopEdge] et « Match index » est 1, l’élément correspondant le plus proche du haut de l’écran est mis en correspondance. |
|
|
L’index de correspondance est croissant
|
MatchIndexAscending | boolean |
Si plusieurs éléments correspondent à la recherche, doit correspondre à « Faire correspondre l’index » en haut de la liste triée (true) ou en bas de la liste triée (false). |
|
|
Nombre maximal d’éléments à rechercher
|
MaxElementsToSearch | integer |
Nombre maximal d’éléments à rechercher lors de la recherche de l’élément cible dans l’arborescence UIA. Cette entrée fonctionne uniquement si le mode de recherche d’élément UIA est « Tree walk » (cela peut être activé dans la page paramètres de l’inspecteur). Par défaut, cette valeur est définie sur 0 (illimité). Cette entrée est généralement utilisée pour optimiser la recherche d’éléments. |
|
|
Profondeur maximale de recherche relative
|
MaxRelativeSearchDepth | integer |
Profondeur maximale de l’arborescence relative à la recherche d’éléments enfants sous l’élément parent. Les éléments enfants directs ont une valeur de profondeur de 1. Cette entrée fonctionne uniquement si le mode de recherche d’élément UIA est « Tree walk » (cela peut être activé dans la page paramètres de l’inspecteur). Défini sur 0 pour une profondeur de recherche illimitée. Cette entrée est généralement utilisée pour optimiser la recherche d’éléments. |
|
|
Nombre maximal d’éléments enfants à rechercher par nœud
|
MaxChildElementsToSearchPerNode | integer |
Nombre maximal d’éléments enfants à rechercher sous chaque élément lors de la recherche de l’arborescence UIA pour l’élément cible. Cette entrée fonctionne uniquement si le mode de recherche d’élément UIA est « Tree walk » (cela peut être activé dans la page paramètres de l’inspecteur). Par défaut, cette valeur est définie sur 0 (illimité). Cette entrée est généralement utilisée pour optimiser la recherche d’éléments. |
|
|
Types de contrôle localisés d’élément à parcourir
|
ElementLocalizedControlTypesNotToTraverse | string |
Liste séparée par des virgules des types de contrôle localisés par des éléments UIA pour ne pas traverser (pas à pas) lors de la recherche de l’arborescence UIA pour l’élément cible. La recherche vérifie toujours si un élément individuel correspond aux critères de recherche, mais il ne recherche aucun élément enfant de cet élément si son type de contrôle localisé figure dans cette liste d’exclusions. Cette entrée fonctionne uniquement si le mode de recherche d’élément UIA est « Tree walk » (cela peut être activé dans la page paramètres de l’inspecteur). Cette entrée est généralement utilisée pour optimiser la recherche d’éléments. |
|
|
Flux de travail
|
Workflow | True | string |
Ajoutez l’expression suivante ici : workflow() |
Cliquez sur élément de liste UIA par nom
Clique sur l’élément de liste avec le nom spécifié. Il est généralement utilisé pour sélectionner un élément dans une liste déroulante/élément de menu.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Handle de fenêtre parent
|
ParentWindowHandle | True | integer |
Handle de fenêtre UIA parent (valeur 1 ou supérieure) pour agir comme point de départ de la recherche. Vous pouvez le découvrir via Inspection à l’aide d’actions telles que « Wait for desktop element » ou « Wait for element ». |
|
Nom de l’élément de recherche
|
SearchElementName | string |
Nom d’élément UIA facultatif à rechercher (à partir du handle de fenêtre parent). Cela peut être découvert par le biais de l’inspection. |
|
|
Nom de la classe d’élément Search
|
SearchElementClassName | string |
Nom de classe d’élément UIA facultatif à rechercher (à partir du handle de fenêtre parent). Cela peut être découvert par le biais de l’inspection. |
|
|
ID d’automatisation de l’élément de recherche
|
SearchElementAutomationId | string |
ID d’automatisation d’élément UIA facultatif à rechercher (à partir du handle de fenêtre parent). Cela peut être découvert par le biais de l’inspection. |
|
|
Type de contrôle localisé de l’élément de recherche
|
SearchLocalizedControlType | string |
Type de contrôle localisé de l’élément UIA facultatif à rechercher (à partir du handle de fenêtre parent). Cela peut être découvert par le biais de l’inspection. |
|
|
Rechercher une sous-arborescence UIA
|
SearchSubTree | boolean |
Si la valeur est true, l’arborescence UIA entière située sous le handle de fenêtre parent est recherchée. Cela est plus approfondi, mais peut prendre plus de temps. Si la valeur est false, seuls les éléments directement sous le handle de fenêtre parent dans l’arborescence UIA sont recherchés. |
|
|
Développer en premier
|
ExpandFirst | boolean |
Si la valeur est true, IA-Connect tente de développer la liste avant de rechercher les éléments d’élément de liste. Cela est utile pour les listes dynamiques, car les éléments d’élément de liste peuvent ne pas être créés tant que la liste n’est pas développée. |
|
|
Réduire après
|
CollapseAfter | boolean |
Si la valeur est true, la liste est réduite après l’exécution de la recherche. |
|
|
Nom de l’élément
|
ItemName | string |
Nom de l’élément à cliquer. |
|
|
Secondes entre développer et réduire
|
SecondsBetweenExpandCollapse | double |
Nombre de secondes à attendre entre les actions de développement et de réduction si celles-ci sont définies sur true. |
|
|
Index de correspondance
|
MatchIndex | integer |
Si plusieurs éléments correspondent à la recherche, quel élément (à partir de 1) doit être mis en correspondance. Peut être utilisé conjointement avec « Trier par colonne » pour choisir l’ordre de tri correspondant. |
|
|
Filtre de recherche
|
SearchFilter | string |
Filtre avancé facultatif pour restreindre davantage la recherche à l’aide d’opérateurs conditionnels et de tout champ d’élément. Exemple 1 : [Width] < 200. Exemple 2 : [Name] like 'Document*' AND [ClassName] like 'Label*'. Pour plus d’exemples, consultez la documentation. |
|
|
Trier par nom de colonne
|
SortByColumn | string |
Si plusieurs éléments correspondent à la recherche, cela vous permet de spécifier la propriété d’élément à trier par. Cela sera utilisé conjointement avec « Match index » pour sélectionner l’élément requis. Par exemple : si « Trier par nom de colonne » est [TopEdge] et « Match index » est 1, l’élément correspondant le plus proche du haut de l’écran est mis en correspondance. |
|
|
L’index de correspondance est croissant
|
MatchIndexAscending | boolean |
Si plusieurs éléments correspondent à la recherche, doit correspondre à « Faire correspondre l’index » en haut de la liste triée (true) ou en bas de la liste triée (false). |
|
|
Nombre maximal d’éléments à rechercher
|
MaxElementsToSearch | integer |
Nombre maximal d’éléments à rechercher lors de la recherche de l’élément cible dans l’arborescence UIA. Cette entrée fonctionne uniquement si le mode de recherche d’élément UIA est « Tree walk » (cela peut être activé dans la page paramètres de l’inspecteur). Par défaut, cette valeur est définie sur 0 (illimité). Cette entrée est généralement utilisée pour optimiser la recherche d’éléments. |
|
|
Profondeur maximale de recherche relative
|
MaxRelativeSearchDepth | integer |
Profondeur maximale de l’arborescence relative à la recherche d’éléments enfants sous l’élément parent. Les éléments enfants directs ont une valeur de profondeur de 1. Cette entrée fonctionne uniquement si le mode de recherche d’élément UIA est « Tree walk » (cela peut être activé dans la page paramètres de l’inspecteur). Défini sur 0 pour une profondeur de recherche illimitée. Cette entrée est généralement utilisée pour optimiser la recherche d’éléments. |
|
|
Nombre maximal d’éléments enfants à rechercher par nœud
|
MaxChildElementsToSearchPerNode | integer |
Nombre maximal d’éléments enfants à rechercher sous chaque élément lors de la recherche de l’arborescence UIA pour l’élément cible. Cette entrée fonctionne uniquement si le mode de recherche d’élément UIA est « Tree walk » (cela peut être activé dans la page paramètres de l’inspecteur). Par défaut, cette valeur est définie sur 0 (illimité). Cette entrée est généralement utilisée pour optimiser la recherche d’éléments. |
|
|
Types de contrôle localisés d’élément à parcourir
|
ElementLocalizedControlTypesNotToTraverse | string |
Liste séparée par des virgules des types de contrôle localisés par des éléments UIA pour ne pas traverser (pas à pas) lors de la recherche de l’arborescence UIA pour l’élément cible. La recherche vérifie toujours si un élément individuel correspond aux critères de recherche, mais il ne recherche aucun élément enfant de cet élément si son type de contrôle localisé figure dans cette liste d’exclusions. Cette entrée fonctionne uniquement si le mode de recherche d’élément UIA est « Tree walk » (cela peut être activé dans la page paramètres de l’inspecteur). Cette entrée est généralement utilisée pour optimiser la recherche d’éléments. |
|
|
Flux de travail
|
Workflow | True | string |
Ajoutez l’expression suivante ici : workflow() |
Dessiner un rectangle autour de l’élément UIA
Dessine un rectangle autour du périmètre d’un élément pour faciliter l’identification de l’élément trouvé est celui requis. Le rectangle est automatiquement supprimé après 5 secondes.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Handle de fenêtre parent
|
ParentWindowHandle | True | integer |
Handle de fenêtre UIA parent (valeur 1 ou supérieure) pour agir comme point de départ de la recherche. Vous pouvez le découvrir via Inspection à l’aide d’actions telles que « Wait for desktop element » ou « Wait for element ». |
|
Nom de l’élément de recherche
|
SearchElementName | string |
Nom d’élément UIA facultatif à rechercher (à partir du handle de fenêtre parent). Cela peut être découvert par le biais de l’inspection. |
|
|
Nom de la classe d’élément Search
|
SearchElementClassName | string |
Nom de classe d’élément UIA facultatif à rechercher (à partir du handle de fenêtre parent). Cela peut être découvert par le biais de l’inspection. |
|
|
ID d’automatisation de l’élément de recherche
|
SearchElementAutomationId | string |
ID d’automatisation d’élément UIA facultatif à rechercher (à partir du handle de fenêtre parent). Cela peut être découvert par le biais de l’inspection. |
|
|
Type de contrôle localisé de l’élément de recherche
|
SearchLocalizedControlType | string |
Type de contrôle localisé de l’élément UIA facultatif à rechercher (à partir du handle de fenêtre parent). Cela peut être découvert par le biais de l’inspection. |
|
|
Rechercher une sous-arborescence UIA
|
SearchSubTree | boolean |
Si la valeur est true, l’arborescence UIA entière située sous le handle de fenêtre parent est recherchée. Cela est plus approfondi, mais peut prendre plus de temps. Si la valeur est false, seuls les éléments directement sous le handle de fenêtre parent dans l’arborescence UIA sont recherchés. |
|
|
Couleur du stylet
|
PenColour | string |
Couleur du rectangle à dessiner (par exemple, rouge, vert, bleu, jaune, violet ou orange) ou un code hexadécimal de chaîne, par exemple, #FF0000. |
|
|
Pixels d’épaisseur du stylet
|
PenThicknessPixels | integer |
Épaisseur (en pixels) de la bordure du rectangle en surbrillance. |
|
|
Index de correspondance
|
MatchIndex | integer |
Si plusieurs éléments correspondent à la recherche, quel élément (à partir de 1) doit être mis en correspondance. Peut être utilisé conjointement avec « Trier par colonne » pour choisir l’ordre de tri correspondant. |
|
|
Filtre de recherche
|
SearchFilter | string |
Filtre avancé facultatif pour restreindre davantage la recherche à l’aide d’opérateurs conditionnels et de tout champ d’élément. Exemple 1 : [Width] < 200. Exemple 2 : [Name] like 'Document*' AND [ClassName] like 'Label*'. Pour plus d’exemples, consultez la documentation. |
|
|
Trier par nom de colonne
|
SortByColumn | string |
Si plusieurs éléments correspondent à la recherche, cela vous permet de spécifier la propriété d’élément à trier par. Cela sera utilisé conjointement avec « Match index » pour sélectionner l’élément requis. Par exemple : si « Trier par nom de colonne » est [TopEdge] et « Match index » est 1, l’élément correspondant le plus proche du haut de l’écran est mis en correspondance. |
|
|
L’index de correspondance est croissant
|
MatchIndexAscending | boolean |
Si plusieurs éléments correspondent à la recherche, doit correspondre à « Faire correspondre l’index » en haut de la liste triée (true) ou en bas de la liste triée (false). |
|
|
Nombre maximal d’éléments à rechercher
|
MaxElementsToSearch | integer |
Nombre maximal d’éléments à rechercher lors de la recherche de l’élément cible dans l’arborescence UIA. Cette entrée fonctionne uniquement si le mode de recherche d’élément UIA est « Tree walk » (cela peut être activé dans la page paramètres de l’inspecteur). Par défaut, cette valeur est définie sur 0 (illimité). Cette entrée est généralement utilisée pour optimiser la recherche d’éléments. |
|
|
Profondeur maximale de recherche relative
|
MaxRelativeSearchDepth | integer |
Profondeur maximale de l’arborescence relative à la recherche d’éléments enfants sous l’élément parent. Les éléments enfants directs ont une valeur de profondeur de 1. Cette entrée fonctionne uniquement si le mode de recherche d’élément UIA est « Tree walk » (cela peut être activé dans la page paramètres de l’inspecteur). Défini sur 0 pour une profondeur de recherche illimitée. Cette entrée est généralement utilisée pour optimiser la recherche d’éléments. |
|
|
Nombre maximal d’éléments enfants à rechercher par nœud
|
MaxChildElementsToSearchPerNode | integer |
Nombre maximal d’éléments enfants à rechercher sous chaque élément lors de la recherche de l’arborescence UIA pour l’élément cible. Cette entrée fonctionne uniquement si le mode de recherche d’élément UIA est « Tree walk » (cela peut être activé dans la page paramètres de l’inspecteur). Par défaut, cette valeur est définie sur 0 (illimité). Cette entrée est généralement utilisée pour optimiser la recherche d’éléments. |
|
|
Types de contrôle localisés d’élément à parcourir
|
ElementLocalizedControlTypesNotToTraverse | string |
Liste séparée par des virgules des types de contrôle localisés par des éléments UIA pour ne pas traverser (pas à pas) lors de la recherche de l’arborescence UIA pour l’élément cible. La recherche vérifie toujours si un élément individuel correspond aux critères de recherche, mais il ne recherche aucun élément enfant de cet élément si son type de contrôle localisé figure dans cette liste d’exclusions. Cette entrée fonctionne uniquement si le mode de recherche d’élément UIA est « Tree walk » (cela peut être activé dans la page paramètres de l’inspecteur). Cette entrée est généralement utilisée pour optimiser la recherche d’éléments. |
|
|
Flux de travail
|
Workflow | True | string |
Ajoutez l’expression suivante ici : workflow() |
Définir la fenêtre UIA de premier plan
Apporte une fenêtre au premier plan.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Handle de fenêtre
|
WindowHandle | True | integer |
Handle UIA pour la fenêtre qui doit être définie comme fenêtre de premier plan. |
|
Activer/désactiver la fenêtre
|
ToggleWindow | boolean |
La fenêtre doit-elle être activée en essayant de se concentrer ou de cliquer dessus ? Cela permet de s’assurer que la fenêtre est apportée de manière fiable au premier plan. |
|
|
Activer/désactiver utilise l’agent de clic gauche global de la souris
|
ToggleUsesGlobalLeftMouseClickAgent | boolean |
Si vous choisissez de désactiver la fenêtre, cela spécifie s’il faut utiliser les clics globaux de souris pour concentrer d’abord l’agent IA-Connect. |
|
|
Basculer le délai en secondes
|
ToggleDelay | double |
Si vous choisissez de basculer la fenêtre, cela spécifie la pause après le basculement. |
|
|
Flux de travail
|
Workflow | True | string |
Ajoutez l’expression suivante ici : workflow() |
Définir la fenêtre UIA sur normale
Normalise la fenêtre avec le handle UIA spécifié (c’est-à-dire, la définit sur une fenêtre de taille normale au lieu d’être minimisée ou agrandie).
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Handle de fenêtre
|
WindowHandle | True | integer |
Handle UIA pour la fenêtre à normaliser. |
|
Flux de travail
|
Workflow | True | string |
Ajoutez l’expression suivante ici : workflow() |
Définir le délai d’expiration des transactions UIA
Contrôle la durée pendant laquelle l’API UIA attend qu’une application retourne les informations relatives à un élément. Ce délai d’expiration des transactions ne serait généralement atteint que si l’application n’était pas réactive.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Délai d’expiration en secondes
|
TimeoutInSeconds | True | double |
Durée maximale pendant laquelle l’API UIA attend qu’une application retourne les informations relatives à un élément. |
|
Flux de travail
|
Workflow | True | string |
Ajoutez l’expression suivante ici : workflow() |
Définir le mode de recherche d’élément UIA
Choisissez le mode de recherche d’élément UIA qui doit être utilisé par l’agent IA-Connect lors de l’exécution d’actions UIA. En règle générale, cette action n’est utilisée que si vous rencontrez un problème avec le mode par défaut (Rechercher tout).
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Mode de recherche d’élément UIA
|
UIAElementSearchMode | True | string |
Mode de recherche d’élément UIA à utiliser. |
|
Flux de travail
|
Workflow | True | string |
Ajoutez l’expression suivante ici : workflow() |
Retours
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
Résultat de la commande
|
SetUIAElementSearchModeResult | boolean |
Résultat de la commande (réussite ou échec). |
|
Message d'erreur
|
ErrorMessage | string |
Si la commande n’a pas réussi, cela contiendra le message d’erreur retourné. |
Définir le pourcentage de défilement de l’élément UIA
Définissez le pourcentage de défilement horizontal et/ou vertical de l’élément spécifié, si le défilement est pris en charge par cet élément. Si l’élément prend en charge le modèle « scroll », vous pouvez appliquer cette action directement à l’élément et spécifier une quantité de défilement horizontale ou verticale (ou les deux). Si l’élément ne prend pas en charge le modèle « scroll », cette action revient aux modèles « valeur de plage » ou « valeur », mais vous devez les appliquer directement aux contrôles de barre de défilement, et non à l’élément lui-même.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Handle de fenêtre parent
|
ParentWindowHandle | True | integer |
Handle de fenêtre UIA parent (valeur 1 ou supérieure) pour agir comme point de départ de la recherche. Vous pouvez le découvrir via Inspection à l’aide d’actions telles que « Wait for desktop element » ou « Wait for element ». |
|
Nom de l’élément de recherche
|
SearchElementName | string |
Nom d’élément UIA facultatif à rechercher (à partir du handle de fenêtre parent). Cela peut être découvert par le biais de l’inspection. |
|
|
Nom de la classe d’élément Search
|
SearchElementClassName | string |
Nom de classe d’élément UIA facultatif à rechercher (à partir du handle de fenêtre parent). Cela peut être découvert par le biais de l’inspection. |
|
|
ID d’automatisation de l’élément de recherche
|
SearchElementAutomationId | string |
ID d’automatisation d’élément UIA facultatif à rechercher (à partir du handle de fenêtre parent). Cela peut être découvert par le biais de l’inspection. |
|
|
Type de contrôle localisé de l’élément de recherche
|
SearchLocalizedControlType | string |
Type de contrôle localisé de l’élément UIA facultatif à rechercher (à partir du handle de fenêtre parent). Cela peut être découvert par le biais de l’inspection. |
|
|
Rechercher une sous-arborescence UIA
|
SearchSubTree | boolean |
Si la valeur est true, l’arborescence UIA entière située sous le handle de fenêtre parent est recherchée. Cela est plus approfondi, mais peut prendre plus de temps. Si la valeur est false, seuls les éléments directement sous le handle de fenêtre parent dans l’arborescence UIA sont recherchés. |
|
|
Index de correspondance
|
MatchIndex | integer |
Si plusieurs éléments correspondent à la recherche, quel élément (à partir de 1) doit être mis en correspondance. Peut être utilisé conjointement avec « Trier par colonne » pour choisir l’ordre de tri correspondant. |
|
|
Filtre de recherche
|
SearchFilter | string |
Filtre avancé facultatif pour restreindre davantage la recherche à l’aide d’opérateurs conditionnels et de tout champ d’élément. Exemple 1 : [Width] < 200. Exemple 2 : [Name] like 'Document*' AND [ClassName] like 'Label*'. Pour plus d’exemples, consultez la documentation. |
|
|
Trier par nom de colonne
|
SortByColumn | string |
Si plusieurs éléments correspondent à la recherche, cela vous permet de spécifier la propriété d’élément à trier par. Cela sera utilisé conjointement avec « Match index » pour sélectionner l’élément requis. Par exemple : si « Trier par nom de colonne » est [TopEdge] et « Match index » est 1, l’élément correspondant le plus proche du haut de l’écran est mis en correspondance. |
|
|
L’index de correspondance est croissant
|
MatchIndexAscending | boolean |
Si plusieurs éléments correspondent à la recherche, doit correspondre à « Faire correspondre l’index » en haut de la liste triée (true) ou en bas de la liste triée (false). |
|
|
Pourcentage de défilement horizontal
|
HorizontalScrollPercentage | double |
Position pour faire défiler horizontalement l’élément (0 à 100 décimales prises en charge) ou -1 pour laisser la position de défilement horizontale inchangée. |
|
|
Pourcentage de défilement vertical
|
VerticalScrollPercentage | double |
Position pour faire défiler verticalement l’élément (0 à 100 décimales prises en charge) ou -1 pour laisser la position de défilement verticale inchangée. |
|
|
Essayer le modèle de défilement
|
TryScrollPattern | boolean |
Si la valeur est true, l’agent IA-Connect tente d’utiliser un modèle de défilement UIA pour effectuer l’action de défilement. Si le modèle de défilement UIA n’est pas disponible dans l’élément choisi, l’agent IA-Connect revient à d’autres modèles choisis (activé ou désactivé via d’autres entrées à cette action). Si la valeur est false, l’agent IA-Connect n’essaie pas d’utiliser un modèle de défilement et revient immédiatement à d’autres modèles choisis. L’ordre des modèles tentés (si activé via les entrées de cette action) est le défilement, la valeur de plage et la valeur. |
|
|
Essayer le modèle de valeur de plage
|
TryRangeValuePattern | boolean |
Si la valeur est true, l’agent IA-Connect tente d’utiliser un modèle de valeur de plage UIA pour effectuer l’action de défilement. Si le modèle de valeur de plage UIA n’est pas disponible dans l’élément choisi, l’agent IA-Connect revient à d’autres modèles choisis (activé ou désactivé via d’autres entrées à cette action). Si la valeur est false, l’agent IA-Connect n’essaie pas d’utiliser un modèle de valeur de plage et revient immédiatement à d’autres modèles choisis. L’ordre des modèles tentés (si activé via les entrées de cette action) est le défilement, la valeur de plage et la valeur. |
|
|
Essayer le modèle de valeur
|
TryValuePattern | boolean |
Si la valeur est true, l’agent IA-Connect tente d’utiliser un modèle de valeur UIA pour effectuer l’action de défilement. Si le modèle de valeur UIA n’est pas disponible dans l’élément choisi, l’agent IA-Connect revient à d’autres modèles choisis (activé ou désactivé via d’autres entrées à cette action). Si la valeur est false, l’agent IA-Connect n’essaie pas d’utiliser un modèle de valeur et revient immédiatement à d’autres modèles choisis. L’ordre des modèles tentés (si activé via les entrées de cette action) est le défilement, la valeur de plage et la valeur. Avertissement : L’utilisation d’un modèle de valeur sur un élément de modification entre simplement la valeur dans l’élément de modification. |
|
|
Nombre maximal d’éléments à rechercher
|
MaxElementsToSearch | integer |
Nombre maximal d’éléments à rechercher lors de la recherche de l’élément cible dans l’arborescence UIA. Cette entrée fonctionne uniquement si le mode de recherche d’élément UIA est « Tree walk » (cela peut être activé dans la page paramètres de l’inspecteur). Par défaut, cette valeur est définie sur 0 (illimité). Cette entrée est généralement utilisée pour optimiser la recherche d’éléments. |
|
|
Profondeur maximale de recherche relative
|
MaxRelativeSearchDepth | integer |
Profondeur maximale de l’arborescence relative à la recherche d’éléments enfants sous l’élément parent. Les éléments enfants directs ont une valeur de profondeur de 1. Cette entrée fonctionne uniquement si le mode de recherche d’élément UIA est « Tree walk » (cela peut être activé dans la page paramètres de l’inspecteur). Défini sur 0 pour une profondeur de recherche illimitée. Cette entrée est généralement utilisée pour optimiser la recherche d’éléments. |
|
|
Nombre maximal d’éléments enfants à rechercher par nœud
|
MaxChildElementsToSearchPerNode | integer |
Nombre maximal d’éléments enfants à rechercher sous chaque élément lors de la recherche de l’arborescence UIA pour l’élément cible. Cette entrée fonctionne uniquement si le mode de recherche d’élément UIA est « Tree walk » (cela peut être activé dans la page paramètres de l’inspecteur). Par défaut, cette valeur est définie sur 0 (illimité). Cette entrée est généralement utilisée pour optimiser la recherche d’éléments. |
|
|
Types de contrôle localisés d’élément à parcourir
|
ElementLocalizedControlTypesNotToTraverse | string |
Liste séparée par des virgules des types de contrôle localisés par des éléments UIA pour ne pas traverser (pas à pas) lors de la recherche de l’arborescence UIA pour l’élément cible. La recherche vérifie toujours si un élément individuel correspond aux critères de recherche, mais il ne recherche aucun élément enfant de cet élément si son type de contrôle localisé figure dans cette liste d’exclusions. Cette entrée fonctionne uniquement si le mode de recherche d’élément UIA est « Tree walk » (cela peut être activé dans la page paramètres de l’inspecteur). Cette entrée est généralement utilisée pour optimiser la recherche d’éléments. |
|
|
Flux de travail
|
Workflow | True | string |
Ajoutez l’expression suivante ici : workflow() |
Retours
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
Résultat de la commande
|
UIASetElementScrollPercentageResult | boolean |
Résultat de la commande (réussite ou échec). |
|
Message d'erreur
|
ErrorMessage | string |
Si la commande n’a pas réussi, cela contiendra le message d’erreur retourné. |
Définir l’élément UIA sur une valeur de plage numérique
Définit la valeur de l’élément qui a une plage numérique, par exemple une barre de défilement.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Handle de fenêtre parent
|
ParentWindowHandle | True | integer |
Handle de fenêtre UIA parent (valeur 1 ou supérieure) pour agir comme point de départ de la recherche. Vous pouvez le découvrir via Inspection à l’aide d’actions telles que « Wait for desktop element » ou « Wait for element ». |
|
Nom de l’élément de recherche
|
SearchElementName | string |
Nom d’élément UIA facultatif à rechercher (à partir du handle de fenêtre parent). Cela peut être découvert par le biais de l’inspection. |
|
|
Nom de la classe d’élément Search
|
SearchElementClassName | string |
Nom de classe d’élément UIA facultatif à rechercher (à partir du handle de fenêtre parent). Cela peut être découvert par le biais de l’inspection. |
|
|
ID d’automatisation de l’élément de recherche
|
SearchElementAutomationId | string |
ID d’automatisation d’élément UIA facultatif à rechercher (à partir du handle de fenêtre parent). Cela peut être découvert par le biais de l’inspection. |
|
|
Type de contrôle localisé de l’élément de recherche
|
SearchLocalizedControlType | string |
Type de contrôle localisé de l’élément UIA facultatif à rechercher (à partir du handle de fenêtre parent). Cela peut être découvert par le biais de l’inspection. |
|
|
Rechercher une sous-arborescence UIA
|
SearchSubTree | boolean |
Si la valeur est true, l’arborescence UIA entière située sous le handle de fenêtre parent est recherchée. Cela est plus approfondi, mais peut prendre plus de temps. Si la valeur est false, seuls les éléments directement sous le handle de fenêtre parent dans l’arborescence UIA sont recherchés. |
|
|
Index de correspondance
|
MatchIndex | integer |
Si plusieurs éléments correspondent à la recherche, quel élément (à partir de 1) doit être mis en correspondance. Peut être utilisé conjointement avec « Trier par colonne » pour choisir l’ordre de tri correspondant. |
|
|
Filtre de recherche
|
SearchFilter | string |
Filtre avancé facultatif pour restreindre davantage la recherche à l’aide d’opérateurs conditionnels et de tout champ d’élément. Exemple 1 : [Width] < 200. Exemple 2 : [Name] like 'Document*' AND [ClassName] like 'Label*'. Pour plus d’exemples, consultez la documentation. |
|
|
Trier par nom de colonne
|
SortByColumn | string |
Si plusieurs éléments correspondent à la recherche, cela vous permet de spécifier la propriété d’élément à trier par. Cela sera utilisé conjointement avec « Match index » pour sélectionner l’élément requis. Par exemple : si « Trier par nom de colonne » est [TopEdge] et « Match index » est 1, l’élément correspondant le plus proche du haut de l’écran est mis en correspondance. |
|
|
L’index de correspondance est croissant
|
MatchIndexAscending | boolean |
Si plusieurs éléments correspondent à la recherche, doit correspondre à « Faire correspondre l’index » en haut de la liste triée (true) ou en bas de la liste triée (false). |
|
|
Nouvelle valeur
|
NewValue | True | double |
Valeur de plage numérique à définir pour l’élément. |
|
La nouvelle valeur est le pourcentage
|
NewValueIsPercentage | boolean |
La nouvelle valeur est-elle un pourcentage ? |
|
|
Nombre maximal d’éléments à rechercher
|
MaxElementsToSearch | integer |
Nombre maximal d’éléments à rechercher lors de la recherche de l’élément cible dans l’arborescence UIA. Cette entrée fonctionne uniquement si le mode de recherche d’élément UIA est « Tree walk » (cela peut être activé dans la page paramètres de l’inspecteur). Par défaut, cette valeur est définie sur 0 (illimité). Cette entrée est généralement utilisée pour optimiser la recherche d’éléments. |
|
|
Profondeur maximale de recherche relative
|
MaxRelativeSearchDepth | integer |
Profondeur maximale de l’arborescence relative à la recherche d’éléments enfants sous l’élément parent. Les éléments enfants directs ont une valeur de profondeur de 1. Cette entrée fonctionne uniquement si le mode de recherche d’élément UIA est « Tree walk » (cela peut être activé dans la page paramètres de l’inspecteur). Défini sur 0 pour une profondeur de recherche illimitée. Cette entrée est généralement utilisée pour optimiser la recherche d’éléments. |
|
|
Nombre maximal d’éléments enfants à rechercher par nœud
|
MaxChildElementsToSearchPerNode | integer |
Nombre maximal d’éléments enfants à rechercher sous chaque élément lors de la recherche de l’arborescence UIA pour l’élément cible. Cette entrée fonctionne uniquement si le mode de recherche d’élément UIA est « Tree walk » (cela peut être activé dans la page paramètres de l’inspecteur). Par défaut, cette valeur est définie sur 0 (illimité). Cette entrée est généralement utilisée pour optimiser la recherche d’éléments. |
|
|
Types de contrôle localisés d’élément à parcourir
|
ElementLocalizedControlTypesNotToTraverse | string |
Liste séparée par des virgules des types de contrôle localisés par des éléments UIA pour ne pas traverser (pas à pas) lors de la recherche de l’arborescence UIA pour l’élément cible. La recherche vérifie toujours si un élément individuel correspond aux critères de recherche, mais il ne recherche aucun élément enfant de cet élément si son type de contrôle localisé figure dans cette liste d’exclusions. Cette entrée fonctionne uniquement si le mode de recherche d’élément UIA est « Tree walk » (cela peut être activé dans la page paramètres de l’inspecteur). Cette entrée est généralement utilisée pour optimiser la recherche d’éléments. |
|
|
Flux de travail
|
Workflow | True | string |
Ajoutez l’expression suivante ici : workflow() |
Définir l’élément UIA sur une valeur numérique
Définit la valeur de l’élément qui a une entrée numérique, par exemple un champ de texte ou une barre de défilement.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Handle de fenêtre parent
|
ParentWindowHandle | True | integer |
Handle de fenêtre UIA parent (valeur 1 ou supérieure) pour agir comme point de départ de la recherche. Vous pouvez le découvrir via Inspection à l’aide d’actions telles que « Wait for desktop element » ou « Wait for element ». |
|
Nom de l’élément de recherche
|
SearchElementName | string |
Nom d’élément UIA facultatif à rechercher (à partir du handle de fenêtre parent). Cela peut être découvert par le biais de l’inspection. |
|
|
Nom de la classe d’élément Search
|
SearchElementClassName | string |
Nom de classe d’élément UIA facultatif à rechercher (à partir du handle de fenêtre parent). Cela peut être découvert par le biais de l’inspection. |
|
|
ID d’automatisation de l’élément de recherche
|
SearchElementAutomationId | string |
ID d’automatisation d’élément UIA facultatif à rechercher (à partir du handle de fenêtre parent). Cela peut être découvert par le biais de l’inspection. |
|
|
Type de contrôle localisé de l’élément de recherche
|
SearchLocalizedControlType | string |
Type de contrôle localisé de l’élément UIA facultatif à rechercher (à partir du handle de fenêtre parent). Cela peut être découvert par le biais de l’inspection. |
|
|
Rechercher une sous-arborescence UIA
|
SearchSubTree | boolean |
Si la valeur est true, l’arborescence UIA entière située sous le handle de fenêtre parent est recherchée. Cela est plus approfondi, mais peut prendre plus de temps. Si la valeur est false, seuls les éléments directement sous le handle de fenêtre parent dans l’arborescence UIA sont recherchés. |
|
|
Index de correspondance
|
MatchIndex | integer |
Si plusieurs éléments correspondent à la recherche, quel élément (à partir de 1) doit être mis en correspondance. Peut être utilisé conjointement avec « Trier par colonne » pour choisir l’ordre de tri correspondant. |
|
|
Filtre de recherche
|
SearchFilter | string |
Filtre avancé facultatif pour restreindre davantage la recherche à l’aide d’opérateurs conditionnels et de tout champ d’élément. Exemple 1 : [Width] < 200. Exemple 2 : [Name] like 'Document*' AND [ClassName] like 'Label*'. Pour plus d’exemples, consultez la documentation. |
|
|
Trier par nom de colonne
|
SortByColumn | string |
Si plusieurs éléments correspondent à la recherche, cela vous permet de spécifier la propriété d’élément à trier par. Cela sera utilisé conjointement avec « Match index » pour sélectionner l’élément requis. Par exemple : si « Trier par nom de colonne » est [TopEdge] et « Match index » est 1, l’élément correspondant le plus proche du haut de l’écran est mis en correspondance. |
|
|
L’index de correspondance est croissant
|
MatchIndexAscending | boolean |
Si plusieurs éléments correspondent à la recherche, doit correspondre à « Faire correspondre l’index » en haut de la liste triée (true) ou en bas de la liste triée (false). |
|
|
Nouvelle valeur
|
NewValue | True | integer |
Valeur numérique à définir pour l’élément. |
|
Nombre maximal d’éléments à rechercher
|
MaxElementsToSearch | integer |
Nombre maximal d’éléments à rechercher lors de la recherche de l’élément cible dans l’arborescence UIA. Cette entrée fonctionne uniquement si le mode de recherche d’élément UIA est « Tree walk » (cela peut être activé dans la page paramètres de l’inspecteur). Par défaut, cette valeur est définie sur 0 (illimité). Cette entrée est généralement utilisée pour optimiser la recherche d’éléments. |
|
|
Profondeur maximale de recherche relative
|
MaxRelativeSearchDepth | integer |
Profondeur maximale de l’arborescence relative à la recherche d’éléments enfants sous l’élément parent. Les éléments enfants directs ont une valeur de profondeur de 1. Cette entrée fonctionne uniquement si le mode de recherche d’élément UIA est « Tree walk » (cela peut être activé dans la page paramètres de l’inspecteur). Défini sur 0 pour une profondeur de recherche illimitée. Cette entrée est généralement utilisée pour optimiser la recherche d’éléments. |
|
|
Nombre maximal d’éléments enfants à rechercher par nœud
|
MaxChildElementsToSearchPerNode | integer |
Nombre maximal d’éléments enfants à rechercher sous chaque élément lors de la recherche de l’arborescence UIA pour l’élément cible. Cette entrée fonctionne uniquement si le mode de recherche d’élément UIA est « Tree walk » (cela peut être activé dans la page paramètres de l’inspecteur). Par défaut, cette valeur est définie sur 0 (illimité). Cette entrée est généralement utilisée pour optimiser la recherche d’éléments. |
|
|
Types de contrôle localisés d’élément à parcourir
|
ElementLocalizedControlTypesNotToTraverse | string |
Liste séparée par des virgules des types de contrôle localisés par des éléments UIA pour ne pas traverser (pas à pas) lors de la recherche de l’arborescence UIA pour l’élément cible. La recherche vérifie toujours si un élément individuel correspond aux critères de recherche, mais il ne recherche aucun élément enfant de cet élément si son type de contrôle localisé figure dans cette liste d’exclusions. Cette entrée fonctionne uniquement si le mode de recherche d’élément UIA est « Tree walk » (cela peut être activé dans la page paramètres de l’inspecteur). Cette entrée est généralement utilisée pour optimiser la recherche d’éléments. |
|
|
Déclencher une exception si la validation d’entrée échoue
|
RaiseExceptionIfInputValidationFails | boolean |
Si cette option est activée, l’agent IA-Connect vérifie la nouvelle valeur de l’élément après avoir mis le texte demandé. Si la nouvelle valeur ne correspond pas à la valeur attendue, une exception est levée. Si cette entrée est false (valeur par défaut), un avertissement est entré dans le journal, mais aucune exception n’est levée. |
|
|
Essayer le modèle de valeur
|
TryValuePattern | boolean |
Si la valeur est true (valeur par défaut), l’agent IA-Connect tente d’utiliser un modèle de valeur UIA pour effectuer l’action d’entrée de texte. Si le modèle de valeur UIA n’est pas disponible dans l’élément choisi, l’agent IA-Connect revient à d’autres modèles (activé ou désactivé via d’autres entrées à cette action). Si la valeur est false, l’agent IA-Connect n’essaie pas d’utiliser un modèle de valeur et revient immédiatement à d’autres modèles choisis. |
|
|
Essayer le modèle hérité
|
TryLegacyPattern | boolean |
Si la valeur est true, l’agent IA-Connect tente d’utiliser un modèle hérité UIA pour effectuer l’action d’entrée de texte si le modèle de valeur n’est pas disponible (soit parce qu’il n’est pas présent sur l’élément ou parce que son utilisation a été désactivée). |
|
|
Flux de travail
|
Workflow | True | string |
Ajoutez l’expression suivante ici : workflow() |
Développer l’élément UIA
Développe un élément (généralement un menu / élément déroulant). Si l’élément est déjà développé, rien ne se produit.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Handle de fenêtre parent
|
ParentWindowHandle | True | integer |
Handle de fenêtre UIA parent (valeur 1 ou supérieure) pour agir comme point de départ de la recherche. Vous pouvez le découvrir via Inspection à l’aide d’actions telles que « Wait for desktop element » ou « Wait for element ». |
|
Nom de l’élément de recherche
|
SearchElementName | string |
Nom d’élément UIA facultatif à rechercher (à partir du handle de fenêtre parent). Cela peut être découvert par le biais de l’inspection. |
|
|
Nom de la classe d’élément Search
|
SearchElementClassName | string |
Nom de classe d’élément UIA facultatif à rechercher (à partir du handle de fenêtre parent). Cela peut être découvert par le biais de l’inspection. |
|
|
ID d’automatisation de l’élément de recherche
|
SearchElementAutomationId | string |
ID d’automatisation d’élément UIA facultatif à rechercher (à partir du handle de fenêtre parent). Cela peut être découvert par le biais de l’inspection. |
|
|
Type de contrôle localisé de l’élément de recherche
|
SearchLocalizedControlType | string |
Type de contrôle localisé de l’élément UIA facultatif à rechercher (à partir du handle de fenêtre parent). Cela peut être découvert par le biais de l’inspection. |
|
|
Rechercher une sous-arborescence UIA
|
SearchSubTree | boolean |
Si la valeur est true, l’arborescence UIA entière située sous le handle de fenêtre parent est recherchée. Cela est plus approfondi, mais peut prendre plus de temps. Si la valeur est false, seuls les éléments directement sous le handle de fenêtre parent dans l’arborescence UIA sont recherchés. |
|
|
Index de correspondance
|
MatchIndex | integer |
Si plusieurs éléments correspondent à la recherche, quel élément (à partir de 1) doit être mis en correspondance. Peut être utilisé conjointement avec « Trier par colonne » pour choisir l’ordre de tri correspondant. |
|
|
Filtre de recherche
|
SearchFilter | string |
Filtre avancé facultatif pour restreindre davantage la recherche à l’aide d’opérateurs conditionnels et de tout champ d’élément. Exemple 1 : [Width] < 200. Exemple 2 : [Name] like 'Document*' AND [ClassName] like 'Label*'. Pour plus d’exemples, consultez la documentation. |
|
|
Trier par nom de colonne
|
SortByColumn | string |
Si plusieurs éléments correspondent à la recherche, cela vous permet de spécifier la propriété d’élément à trier par. Cela sera utilisé conjointement avec « Match index » pour sélectionner l’élément requis. Par exemple : si « Trier par nom de colonne » est [TopEdge] et « Match index » est 1, l’élément correspondant le plus proche du haut de l’écran est mis en correspondance. |
|
|
L’index de correspondance est croissant
|
MatchIndexAscending | boolean |
Si plusieurs éléments correspondent à la recherche, doit correspondre à « Faire correspondre l’index » en haut de la liste triée (true) ou en bas de la liste triée (false). |
|
|
Nombre maximal d’éléments à rechercher
|
MaxElementsToSearch | integer |
Nombre maximal d’éléments à rechercher lors de la recherche de l’élément cible dans l’arborescence UIA. Cette entrée fonctionne uniquement si le mode de recherche d’élément UIA est « Tree walk » (cela peut être activé dans la page paramètres de l’inspecteur). Par défaut, cette valeur est définie sur 0 (illimité). Cette entrée est généralement utilisée pour optimiser la recherche d’éléments. |
|
|
Profondeur maximale de recherche relative
|
MaxRelativeSearchDepth | integer |
Profondeur maximale de l’arborescence relative à la recherche d’éléments enfants sous l’élément parent. Les éléments enfants directs ont une valeur de profondeur de 1. Cette entrée fonctionne uniquement si le mode de recherche d’élément UIA est « Tree walk » (cela peut être activé dans la page paramètres de l’inspecteur). Défini sur 0 pour une profondeur de recherche illimitée. Cette entrée est généralement utilisée pour optimiser la recherche d’éléments. |
|
|
Nombre maximal d’éléments enfants à rechercher par nœud
|
MaxChildElementsToSearchPerNode | integer |
Nombre maximal d’éléments enfants à rechercher sous chaque élément lors de la recherche de l’arborescence UIA pour l’élément cible. Cette entrée fonctionne uniquement si le mode de recherche d’élément UIA est « Tree walk » (cela peut être activé dans la page paramètres de l’inspecteur). Par défaut, cette valeur est définie sur 0 (illimité). Cette entrée est généralement utilisée pour optimiser la recherche d’éléments. |
|
|
Types de contrôle localisés d’élément à parcourir
|
ElementLocalizedControlTypesNotToTraverse | string |
Liste séparée par des virgules des types de contrôle localisés par des éléments UIA pour ne pas traverser (pas à pas) lors de la recherche de l’arborescence UIA pour l’élément cible. La recherche vérifie toujours si un élément individuel correspond aux critères de recherche, mais il ne recherche aucun élément enfant de cet élément si son type de contrôle localisé figure dans cette liste d’exclusions. Cette entrée fonctionne uniquement si le mode de recherche d’élément UIA est « Tree walk » (cela peut être activé dans la page paramètres de l’inspecteur). Cette entrée est généralement utilisée pour optimiser la recherche d’éléments. |
|
|
Flux de travail
|
Workflow | True | string |
Ajoutez l’expression suivante ici : workflow() |
Entrer un mot de passe dans l’élément UIA
Action UIA qui entre un mot de passe dans un élément (généralement un champ d’entrée de mot de passe), en remplaçant le texte existant.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Handle de fenêtre parent
|
ParentWindowHandle | True | integer |
Handle de fenêtre UIA parent (valeur 1 ou supérieure) pour agir comme point de départ de la recherche. Vous pouvez le découvrir via Inspection à l’aide d’actions telles que « Wait for desktop element » ou « Wait for element ». |
|
Nom de l’élément de recherche
|
SearchElementName | string |
Nom d’élément UIA facultatif à rechercher (à partir du handle de fenêtre parent). Cela peut être découvert par le biais de l’inspection. |
|
|
Nom de la classe d’élément Search
|
SearchElementClassName | string |
Nom de classe d’élément UIA facultatif à rechercher (à partir du handle de fenêtre parent). Cela peut être découvert par le biais de l’inspection. |
|
|
ID d’automatisation de l’élément de recherche
|
SearchElementAutomationId | string |
ID d’automatisation d’élément UIA facultatif à rechercher (à partir du handle de fenêtre parent). Cela peut être découvert par le biais de l’inspection. |
|
|
Type de contrôle localisé de l’élément de recherche
|
SearchLocalizedControlType | string |
Type de contrôle localisé de l’élément UIA facultatif à rechercher (à partir du handle de fenêtre parent). Cela peut être découvert par le biais de l’inspection. |
|
|
Rechercher une sous-arborescence UIA
|
SearchSubTree | boolean |
Si la valeur est true, l’arborescence UIA entière située sous le handle de fenêtre parent est recherchée. Cela est plus approfondi, mais peut prendre plus de temps. Si la valeur est false, seuls les éléments directement sous le handle de fenêtre parent dans l’arborescence UIA sont recherchés. |
|
|
Mot de passe à entrer
|
PasswordToInput | True | password |
Valeur de mot de passe à entrer. |
|
Index de correspondance
|
MatchIndex | integer |
Si plusieurs éléments correspondent à la recherche, quel élément (à partir de 1) doit être mis en correspondance. Peut être utilisé conjointement avec « Trier par colonne » pour choisir l’ordre de tri correspondant. |
|
|
Filtre de recherche
|
SearchFilter | string |
Filtre avancé facultatif pour restreindre davantage la recherche à l’aide d’opérateurs conditionnels et de tout champ d’élément. Exemple 1 : [Width] < 200. Exemple 2 : [Name] like 'Document*' AND [ClassName] like 'Label*'. Pour plus d’exemples, consultez la documentation. |
|
|
Trier par nom de colonne
|
SortByColumn | string |
Si plusieurs éléments correspondent à la recherche, cela vous permet de spécifier la propriété d’élément à trier par. Cela sera utilisé conjointement avec « Match index » pour sélectionner l’élément requis. Par exemple : si « Trier par nom de colonne » est [TopEdge] et « Match index » est 1, l’élément correspondant le plus proche du haut de l’écran est mis en correspondance. |
|
|
L’index de correspondance est croissant
|
MatchIndexAscending | boolean |
Si plusieurs éléments correspondent à la recherche, doit correspondre à « Faire correspondre l’index » en haut de la liste triée (true) ou en bas de la liste triée (false). |
|
|
Le mot de passe contient le mot de passe stocké
|
PasswordContainsStoredPassword | boolean |
Définissez la valeur true si le mot de passe contient (ou est entièrement) un identificateur de mot de passe stocké IA-Connect, au format {IAConnectPassword :StoredPasswordIdentifier} ou un IA-Connect Informations d’identification génériques Orchestrator, au format {OrchestratorCredential :FriendlyName}. Ce mot de passe stocké peut avoir été généré par l’action « Générer le mot de passe », par exemple, ou être détenu par l’orchestrateur IA-Connect. |
|
|
Nombre maximal d’éléments à rechercher
|
MaxElementsToSearch | integer |
Nombre maximal d’éléments à rechercher lors de la recherche de l’élément cible dans l’arborescence UIA. Cette entrée fonctionne uniquement si le mode de recherche d’élément UIA est « Tree walk » (cela peut être activé dans la page paramètres de l’inspecteur). Par défaut, cette valeur est définie sur 0 (illimité). Cette entrée est généralement utilisée pour optimiser la recherche d’éléments. |
|
|
Profondeur maximale de recherche relative
|
MaxRelativeSearchDepth | integer |
Profondeur maximale de l’arborescence relative à la recherche d’éléments enfants sous l’élément parent. Les éléments enfants directs ont une valeur de profondeur de 1. Cette entrée fonctionne uniquement si le mode de recherche d’élément UIA est « Tree walk » (cela peut être activé dans la page paramètres de l’inspecteur). Défini sur 0 pour une profondeur de recherche illimitée. Cette entrée est généralement utilisée pour optimiser la recherche d’éléments. |
|
|
Nombre maximal d’éléments enfants à rechercher par nœud
|
MaxChildElementsToSearchPerNode | integer |
Nombre maximal d’éléments enfants à rechercher sous chaque élément lors de la recherche de l’arborescence UIA pour l’élément cible. Cette entrée fonctionne uniquement si le mode de recherche d’élément UIA est « Tree walk » (cela peut être activé dans la page paramètres de l’inspecteur). Par défaut, cette valeur est définie sur 0 (illimité). Cette entrée est généralement utilisée pour optimiser la recherche d’éléments. |
|
|
Types de contrôle localisés d’élément à parcourir
|
ElementLocalizedControlTypesNotToTraverse | string |
Liste séparée par des virgules des types de contrôle localisés par des éléments UIA pour ne pas traverser (pas à pas) lors de la recherche de l’arborescence UIA pour l’élément cible. La recherche vérifie toujours si un élément individuel correspond aux critères de recherche, mais il ne recherche aucun élément enfant de cet élément si son type de contrôle localisé figure dans cette liste d’exclusions. Cette entrée fonctionne uniquement si le mode de recherche d’élément UIA est « Tree walk » (cela peut être activé dans la page paramètres de l’inspecteur). Cette entrée est généralement utilisée pour optimiser la recherche d’éléments. |
|
|
Essayer le modèle de valeur
|
TryValuePattern | boolean |
Si la valeur est true (valeur par défaut), l’agent IA-Connect tente d’utiliser un modèle de valeur UIA pour effectuer l’action d’entrée de texte. Si le modèle de valeur UIA n’est pas disponible dans l’élément choisi, l’agent IA-Connect revient à d’autres modèles (activé ou désactivé via d’autres entrées à cette action). Si la valeur est false, l’agent IA-Connect n’essaie pas d’utiliser un modèle de valeur et revient immédiatement à d’autres modèles choisis. |
|
|
Essayer le modèle hérité
|
TryLegacyPattern | boolean |
Si la valeur est true, l’agent IA-Connect tente d’utiliser un modèle hérité UIA pour effectuer l’action d’entrée de texte si le modèle de valeur n’est pas disponible (soit parce qu’il n’est pas présent sur l’élément ou parce que son utilisation a été désactivée). |
|
|
Flux de travail
|
Workflow | True | string |
Ajoutez l’expression suivante ici : workflow() |
Entrée de texte dans plusieurs éléments UIA
Action UIA qui insère différents éléments de texte dans plusieurs éléments (généralement des champs d’entrée de texte), remplacez le texte existant ou insérez la nouvelle valeur à une position spécifique.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Éléments d’entrée
|
InputElementsJSON | True | string |
Tableau d’éléments UIA à entrer du texte au format JSON. |
|
Flux de travail
|
Workflow | True | string |
Ajoutez l’expression suivante ici : workflow() |
Fermer la fenêtre d’élément UIA
Ferme la fenêtre d’élément. En règle générale, elle fonctionne uniquement sur les fenêtres ou les dialogues.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Handle de fenêtre parent
|
ParentWindowHandle | True | integer |
Handle de fenêtre UIA parent (valeur 1 ou supérieure) pour agir comme point de départ de la recherche. Vous pouvez le découvrir via Inspection à l’aide d’actions telles que « Wait for desktop element » ou « Wait for element ». |
|
Nom de l’élément de recherche
|
SearchElementName | string |
Nom d’élément UIA facultatif à rechercher (à partir du handle de fenêtre parent). Cela peut être découvert par le biais de l’inspection. |
|
|
Nom de la classe d’élément Search
|
SearchElementClassName | string |
Nom de classe d’élément UIA facultatif à rechercher (à partir du handle de fenêtre parent). Cela peut être découvert par le biais de l’inspection. |
|
|
ID d’automatisation de l’élément de recherche
|
SearchElementAutomationId | string |
ID d’automatisation d’élément UIA facultatif à rechercher (à partir du handle de fenêtre parent). Cela peut être découvert par le biais de l’inspection. |
|
|
Type de contrôle localisé de l’élément de recherche
|
SearchLocalizedControlType | string |
Type de contrôle localisé de l’élément UIA facultatif à rechercher (à partir du handle de fenêtre parent). Cela peut être découvert par le biais de l’inspection. |
|
|
Rechercher une sous-arborescence UIA
|
SearchSubTree | boolean |
Si la valeur est true, l’arborescence UIA entière située sous le handle de fenêtre parent est recherchée. Cela est plus approfondi, mais peut prendre plus de temps. Si la valeur est false, seuls les éléments directement sous le handle de fenêtre parent dans l’arborescence UIA sont recherchés. |
|
|
Index de correspondance
|
MatchIndex | integer |
Si plusieurs éléments correspondent à la recherche, quel élément (à partir de 1) doit être mis en correspondance. Peut être utilisé conjointement avec « Trier par colonne » pour choisir l’ordre de tri correspondant. |
|
|
Filtre de recherche
|
SearchFilter | string |
Filtre avancé facultatif pour restreindre davantage la recherche à l’aide d’opérateurs conditionnels et de tout champ d’élément. Exemple 1 : [Width] < 200. Exemple 2 : [Name] like 'Document*' AND [ClassName] like 'Label*'. Pour plus d’exemples, consultez la documentation. |
|
|
Trier par nom de colonne
|
SortByColumn | string |
Si plusieurs éléments correspondent à la recherche, cela vous permet de spécifier la propriété d’élément à trier par. Cela sera utilisé conjointement avec « Match index » pour sélectionner l’élément requis. Par exemple : si « Trier par nom de colonne » est [TopEdge] et « Match index » est 1, l’élément correspondant le plus proche du haut de l’écran est mis en correspondance. |
|
|
L’index de correspondance est croissant
|
MatchIndexAscending | boolean |
Si plusieurs éléments correspondent à la recherche, doit correspondre à « Faire correspondre l’index » en haut de la liste triée (true) ou en bas de la liste triée (false). |
|
|
Nombre maximal d’éléments à rechercher
|
MaxElementsToSearch | integer |
Nombre maximal d’éléments à rechercher lors de la recherche de l’élément cible dans l’arborescence UIA. Cette entrée fonctionne uniquement si le mode de recherche d’élément UIA est « Tree walk » (cela peut être activé dans la page paramètres de l’inspecteur). Par défaut, cette valeur est définie sur 0 (illimité). Cette entrée est généralement utilisée pour optimiser la recherche d’éléments. |
|
|
Profondeur maximale de recherche relative
|
MaxRelativeSearchDepth | integer |
Profondeur maximale de l’arborescence relative à la recherche d’éléments enfants sous l’élément parent. Les éléments enfants directs ont une valeur de profondeur de 1. Cette entrée fonctionne uniquement si le mode de recherche d’élément UIA est « Tree walk » (cela peut être activé dans la page paramètres de l’inspecteur). Défini sur 0 pour une profondeur de recherche illimitée. Cette entrée est généralement utilisée pour optimiser la recherche d’éléments. |
|
|
Nombre maximal d’éléments enfants à rechercher par nœud
|
MaxChildElementsToSearchPerNode | integer |
Nombre maximal d’éléments enfants à rechercher sous chaque élément lors de la recherche de l’arborescence UIA pour l’élément cible. Cette entrée fonctionne uniquement si le mode de recherche d’élément UIA est « Tree walk » (cela peut être activé dans la page paramètres de l’inspecteur). Par défaut, cette valeur est définie sur 0 (illimité). Cette entrée est généralement utilisée pour optimiser la recherche d’éléments. |
|
|
Types de contrôle localisés d’élément à parcourir
|
ElementLocalizedControlTypesNotToTraverse | string |
Liste séparée par des virgules des types de contrôle localisés par des éléments UIA pour ne pas traverser (pas à pas) lors de la recherche de l’arborescence UIA pour l’élément cible. La recherche vérifie toujours si un élément individuel correspond aux critères de recherche, mais il ne recherche aucun élément enfant de cet élément si son type de contrôle localisé figure dans cette liste d’exclusions. Cette entrée fonctionne uniquement si le mode de recherche d’élément UIA est « Tree walk » (cela peut être activé dans la page paramètres de l’inspecteur). Cette entrée est généralement utilisée pour optimiser la recherche d’éléments. |
|
|
Flux de travail
|
Workflow | True | string |
Ajoutez l’expression suivante ici : workflow() |
La fenêtre Win32 de niveau supérieur existe-t-elle
Action Win32 rapide qui indique si une fenêtre Win32 de niveau supérieur existe. Une fenêtre de niveau supérieur est une fenêtre qui est connectée au bureau. Vous pouvez effectuer une recherche par nom de classe ou par titre de fenêtre, ou vous pouvez spécifier des filtres de recherche plus avancés, y compris des caractères génériques. Bien que cette action utilise des API Win32, elle peut détecter Windows, Java, ModernUI et Windows Web. La fenêtre doit exister, IA-Connect n’attend pas. Il est plus courant d’utiliser l’action UIA « Est-ce que l’élément de bureau UIA existe » qui est plus puissant, mais cette action Win32 s’exécute généralement plus rapidement.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Nom de la classe de recherche
|
SearchClassName | string |
Nom de la classe d’élément de la fenêtre de niveau supérieur à rechercher, par exemple « Bloc-notes ». |
|
|
Titre de la fenêtre de recherche
|
SearchWindowTitle | string |
Titre de la fenêtre de niveau supérieur à rechercher. |
|
|
ID du processus de recherche
|
SearchProcessId | integer |
ID de processus facultatif du processus propriétaire de la fenêtre (par exemple, tel que fourni par la sortie de l’action « Exécuter le processus » dans les actions IA-Connect Environnement /Session). Définissez la valeur 0 pour ne pas effectuer de recherche par ID de processus. |
|
|
Index de correspondance
|
MatchIndex | integer |
Si plusieurs éléments correspondent à la recherche, quel élément (à partir de 1) doit être mis en correspondance. Peut être utilisé conjointement avec « Trier par colonne » pour choisir l’ordre de tri correspondant. |
|
|
Filtre de recherche
|
SearchFilter | string |
Filtre avancé facultatif pour restreindre davantage la recherche à l’aide d’opérateurs conditionnels par rapport aux propriétés de fenêtre disponibles. Exemple 1 : [Width] < 200. Exemple 2 : [Title] like '*Excel' AND [IsMinimised] = False AND [IsResizeable] = True. Pour plus d’exemples, consultez la documentation. |
|
|
Flux de travail
|
Workflow | True | string |
Ajoutez l’expression suivante ici : workflow() |
Retours
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
La fenêtre existe
|
WindowExists | boolean |
Retourne true si la fenêtre existe ou false si ce n’est pas le cas. |
Le processus comporte-t-il une fenêtre Win32
Action Win32 simple et rapide qui indique si un processus (spécifié par son nom) comporte des fenêtres visibles. La fenêtre doit exister : IA-Connect n’attend pas. Il est recommandé d’utiliser l’action « Wait for Desktop element » qui est plus puissante.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Nom du processus de recherche
|
SearchProcessName | True | string |
Nom du processus à rechercher, par exemple, bloc-notes. |
|
Flux de travail
|
Workflow | True | string |
Ajoutez l’expression suivante ici : workflow() |
Retours
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
La fenêtre Processus comporte des fenêtres
|
ProcessHasWindow | boolean |
Retourne la valeur true si le processus a une fenêtre visible ou false si ce n’est pas le cas. |
L’élément de bureau UIA existe-t-il
Indique si un élément de bureau existe et fournit des propriétés d’élément de base.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Nom de l’élément de recherche
|
SearchElementName | string |
Nom d’élément UIA facultatif à rechercher (à partir du handle de fenêtre parent). Cela peut être découvert par le biais de l’inspection. |
|
|
Nom de la classe d’élément Search
|
SearchElementClassName | string |
Nom de classe d’élément UIA facultatif à rechercher (à partir du handle de fenêtre parent). Cela peut être découvert par le biais de l’inspection. |
|
|
ID d’automatisation de l’élément de recherche
|
SearchElementAutomationId | string |
ID d’automatisation d’élément UIA facultatif à rechercher (à partir du handle de fenêtre parent). Cela peut être découvert par le biais de l’inspection. |
|
|
Type de contrôle localisé de l’élément de recherche
|
SearchLocalizedControlType | string |
Type de contrôle localisé de l’élément UIA facultatif à rechercher (à partir du handle de fenêtre parent). Cela peut être découvert par le biais de l’inspection. |
|
|
ID du processus de recherche
|
SearchProcessId | integer |
Si elle est spécifiée (valeur 1 ou supérieure), la recherche considère uniquement les éléments appartenant à un processus avec cet ID de processus (PID). Si IA-Connect lancé le processus, le PID est fourni par l’action « Exécuter le processus » dans les actions IA-Connect Environnement /Session. Si vous ne connaissez pas le PID, laissez ce champ vide (ou 0). |
|
|
Rechercher une sous-arborescence UIA
|
SearchSubTree | boolean |
Si la valeur est true, l’arborescence UIA entière située sous le handle de fenêtre parent est recherchée. Cela est plus approfondi, mais peut prendre plus de temps. Si la valeur est false, seuls les éléments directement sous le handle de fenêtre parent dans l’arborescence UIA sont recherchés. |
|
|
Handle d’élément de retour
|
ReturnElementHandle | boolean |
Si la valeur est true, un handle sur l’élément situé est retourné. Ce handle peut être utilisé dans d’autres actions pour agir en tant que handle « parent ». |
|
|
Index de correspondance
|
MatchIndex | integer |
Si plusieurs éléments correspondent à la recherche, quel élément (à partir de 1) doit être mis en correspondance. Peut être utilisé conjointement avec « Trier par colonne » pour choisir l’ordre de tri correspondant. |
|
|
Filtre de recherche
|
SearchFilter | string |
Filtre avancé facultatif pour restreindre davantage la recherche à l’aide d’opérateurs conditionnels et de tout champ d’élément. Exemple 1 : [Width] < 200. Exemple 2 : [Name] like 'Document*' AND [ClassName] like 'Label*'. Pour plus d’exemples, consultez la documentation. |
|
|
Trier par nom de colonne
|
SortByColumn | string |
Si plusieurs éléments correspondent à la recherche, cela vous permet de spécifier la propriété d’élément à trier par. Cela sera utilisé conjointement avec « Match index » pour sélectionner l’élément requis. Par exemple : si « Trier par nom de colonne » est [TopEdge] et « Match index » est 1, l’élément correspondant le plus proche du haut de l’écran est mis en correspondance. |
|
|
L’index de correspondance est croissant
|
MatchIndexAscending | boolean |
Si plusieurs éléments correspondent à la recherche, doit correspondre à « Faire correspondre l’index » en haut de la liste triée (true) ou en bas de la liste triée (false). |
|
|
Inclure des processus enfants
|
IncludeChildProcesses | boolean |
Si la valeur est true et qu’un « ID de processus de recherche » est spécifié, les processus enfants de cet ID de processus sont également inclus dans la recherche. Si la valeur est false, seul un processus correspondant à l’id de processus de recherche exact est retourné. |
|
|
Nombre maximal d’éléments à rechercher
|
MaxElementsToSearch | integer |
Nombre maximal d’éléments à rechercher lors de la recherche de l’élément cible dans l’arborescence UIA. Cette entrée fonctionne uniquement si le mode de recherche d’élément UIA est « Tree walk » (cela peut être activé dans la page paramètres de l’inspecteur). Par défaut, cette valeur est définie sur 0 (illimité). Cette entrée est généralement utilisée pour optimiser la recherche d’éléments. |
|
|
Profondeur maximale de recherche relative
|
MaxRelativeSearchDepth | integer |
Profondeur maximale de l’arborescence relative à la recherche d’éléments enfants sous l’élément parent. Les éléments enfants directs ont une valeur de profondeur de 1. Cette entrée fonctionne uniquement si le mode de recherche d’élément UIA est « Tree walk » (cela peut être activé dans la page paramètres de l’inspecteur). Défini sur 0 pour une profondeur de recherche illimitée. Cette entrée est généralement utilisée pour optimiser la recherche d’éléments. |
|
|
Nombre maximal d’éléments enfants à rechercher par nœud
|
MaxChildElementsToSearchPerNode | integer |
Nombre maximal d’éléments enfants à rechercher sous chaque élément lors de la recherche de l’arborescence UIA pour l’élément cible. Cette entrée fonctionne uniquement si le mode de recherche d’élément UIA est « Tree walk » (cela peut être activé dans la page paramètres de l’inspecteur). Par défaut, cette valeur est définie sur 0 (illimité). Cette entrée est généralement utilisée pour optimiser la recherche d’éléments. |
|
|
Types de contrôle localisés d’élément à parcourir
|
ElementLocalizedControlTypesNotToTraverse | string |
Liste séparée par des virgules des types de contrôle localisés par des éléments UIA pour ne pas traverser (pas à pas) lors de la recherche de l’arborescence UIA pour l’élément cible. La recherche vérifie toujours si un élément individuel correspond aux critères de recherche, mais il ne recherche aucun élément enfant de cet élément si son type de contrôle localisé figure dans cette liste d’exclusions. Cette entrée fonctionne uniquement si le mode de recherche d’élément UIA est « Tree walk » (cela peut être activé dans la page paramètres de l’inspecteur). Cette entrée est généralement utilisée pour optimiser la recherche d’éléments. |
|
|
Flux de travail
|
Workflow | True | string |
Ajoutez l’expression suivante ici : workflow() |
Retours
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
L’élément existe
|
ElementExists | boolean |
Retourne true si l’élément existe ou false si ce n’est pas le cas. |
|
Handle d’élément
|
ElementHandle | integer |
Handle UIA pour l’élément. Cela peut être utilisé comme entrée pour d’autres actions UIA agissant sur cet élément. |
|
Nom de l'élément
|
ElementName | string |
Nom UIA de l’élément. |
|
Nom de la classe d’élément
|
ElementClassName | string |
Nom de classe UIA de l’élément. |
|
ID d’automatisation de l’élément
|
ElementAutomationId | string |
ID d’automatisation UIA de l’élément. |
|
Type de contrôle localisé par l’élément
|
ElementLocalizedControlType | string |
Type de contrôle localisé UIA de l’élément. |
L’élément UIA est-il vérifié
Cette action retourne la valeur true ou false indiquant si un élément (généralement une case à cocher ou une case d’option) est coché.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Handle de fenêtre parent
|
ParentWindowHandle | True | integer |
Handle de fenêtre UIA parent (valeur 1 ou supérieure) pour agir comme point de départ de la recherche. Vous pouvez le découvrir via Inspection à l’aide d’actions telles que « Wait for desktop element » ou « Wait for element ». |
|
Nom de l’élément de recherche
|
SearchElementName | string |
Nom d’élément UIA facultatif à rechercher (à partir du handle de fenêtre parent). Cela peut être découvert par le biais de l’inspection. |
|
|
Nom de la classe d’élément Search
|
SearchElementClassName | string |
Nom de classe d’élément UIA facultatif à rechercher (à partir du handle de fenêtre parent). Cela peut être découvert par le biais de l’inspection. |
|
|
ID d’automatisation de l’élément de recherche
|
SearchElementAutomationId | string |
ID d’automatisation d’élément UIA facultatif à rechercher (à partir du handle de fenêtre parent). Cela peut être découvert par le biais de l’inspection. |
|
|
Type de contrôle localisé de l’élément de recherche
|
SearchLocalizedControlType | string |
Type de contrôle localisé de l’élément UIA facultatif à rechercher (à partir du handle de fenêtre parent). Cela peut être découvert par le biais de l’inspection. |
|
|
Rechercher une sous-arborescence UIA
|
SearchSubTree | boolean |
Si la valeur est true, l’arborescence UIA entière située sous le handle de fenêtre parent est recherchée. Cela est plus approfondi, mais peut prendre plus de temps. Si la valeur est false, seuls les éléments directement sous le handle de fenêtre parent dans l’arborescence UIA sont recherchés. |
|
|
Index de correspondance
|
MatchIndex | integer |
Si plusieurs éléments correspondent à la recherche, quel élément (à partir de 1) doit être mis en correspondance. Peut être utilisé conjointement avec « Trier par colonne » pour choisir l’ordre de tri correspondant. |
|
|
Filtre de recherche
|
SearchFilter | string |
Filtre avancé facultatif pour restreindre davantage la recherche à l’aide d’opérateurs conditionnels et de tout champ d’élément. Exemple 1 : [Width] < 200. Exemple 2 : [Name] like 'Document*' AND [ClassName] like 'Label*'. Pour plus d’exemples, consultez la documentation. |
|
|
Trier par nom de colonne
|
SortByColumn | string |
Si plusieurs éléments correspondent à la recherche, cela vous permet de spécifier la propriété d’élément à trier par. Cela sera utilisé conjointement avec « Match index » pour sélectionner l’élément requis. Par exemple : si « Trier par nom de colonne » est [TopEdge] et « Match index » est 1, l’élément correspondant le plus proche du haut de l’écran est mis en correspondance. |
|
|
L’index de correspondance est croissant
|
MatchIndexAscending | boolean |
Si plusieurs éléments correspondent à la recherche, doit correspondre à « Faire correspondre l’index » en haut de la liste triée (true) ou en bas de la liste triée (false). |
|
|
Nombre maximal d’éléments à rechercher
|
MaxElementsToSearch | integer |
Nombre maximal d’éléments à rechercher lors de la recherche de l’élément cible dans l’arborescence UIA. Cette entrée fonctionne uniquement si le mode de recherche d’élément UIA est « Tree walk » (cela peut être activé dans la page paramètres de l’inspecteur). Par défaut, cette valeur est définie sur 0 (illimité). Cette entrée est généralement utilisée pour optimiser la recherche d’éléments. |
|
|
Profondeur maximale de recherche relative
|
MaxRelativeSearchDepth | integer |
Profondeur maximale de l’arborescence relative à la recherche d’éléments enfants sous l’élément parent. Les éléments enfants directs ont une valeur de profondeur de 1. Cette entrée fonctionne uniquement si le mode de recherche d’élément UIA est « Tree walk » (cela peut être activé dans la page paramètres de l’inspecteur). Défini sur 0 pour une profondeur de recherche illimitée. Cette entrée est généralement utilisée pour optimiser la recherche d’éléments. |
|
|
Nombre maximal d’éléments enfants à rechercher par nœud
|
MaxChildElementsToSearchPerNode | integer |
Nombre maximal d’éléments enfants à rechercher sous chaque élément lors de la recherche de l’arborescence UIA pour l’élément cible. Cette entrée fonctionne uniquement si le mode de recherche d’élément UIA est « Tree walk » (cela peut être activé dans la page paramètres de l’inspecteur). Par défaut, cette valeur est définie sur 0 (illimité). Cette entrée est généralement utilisée pour optimiser la recherche d’éléments. |
|
|
Types de contrôle localisés d’élément à parcourir
|
ElementLocalizedControlTypesNotToTraverse | string |
Liste séparée par des virgules des types de contrôle localisés par des éléments UIA pour ne pas traverser (pas à pas) lors de la recherche de l’arborescence UIA pour l’élément cible. La recherche vérifie toujours si un élément individuel correspond aux critères de recherche, mais il ne recherche aucun élément enfant de cet élément si son type de contrôle localisé figure dans cette liste d’exclusions. Cette entrée fonctionne uniquement si le mode de recherche d’élément UIA est « Tree walk » (cela peut être activé dans la page paramètres de l’inspecteur). Cette entrée est généralement utilisée pour optimiser la recherche d’éléments. |
|
|
Flux de travail
|
Workflow | True | string |
Ajoutez l’expression suivante ici : workflow() |
Retours
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
L’élément est vérifié
|
ElementIsChecked | boolean |
Retourne true si l’élément est activé ou false, sinon. |
L’élément UIA existe-t-il
Indique si un élément existe et retourne certaines propriétés d’élément de base.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Handle de fenêtre parent
|
ParentWindowHandle | True | integer |
Handle de fenêtre UIA parent (valeur 1 ou supérieure) pour agir comme point de départ de la recherche. Vous pouvez le découvrir via Inspection à l’aide d’actions telles que « Wait for desktop element » ou « Wait for element ». |
|
Nom de l’élément de recherche
|
SearchElementName | string |
Nom d’élément UIA facultatif à rechercher (à partir du handle de fenêtre parent). Cela peut être découvert par le biais de l’inspection. |
|
|
Nom de la classe d’élément Search
|
SearchElementClassName | string |
Nom de classe d’élément UIA facultatif à rechercher (à partir du handle de fenêtre parent). Cela peut être découvert par le biais de l’inspection. |
|
|
ID d’automatisation de l’élément de recherche
|
SearchElementAutomationId | string |
ID d’automatisation d’élément UIA facultatif à rechercher (à partir du handle de fenêtre parent). Cela peut être découvert par le biais de l’inspection. |
|
|
Type de contrôle localisé de l’élément de recherche
|
SearchLocalizedControlType | string |
Type de contrôle localisé de l’élément UIA facultatif à rechercher (à partir du handle de fenêtre parent). Cela peut être découvert par le biais de l’inspection. |
|
|
ID du processus de recherche
|
SearchProcessId | integer |
Si elle est spécifiée (valeur 1 ou supérieure), la recherche considère uniquement les éléments appartenant à un processus avec cet ID de processus (PID). Si IA-Connect lancé le processus, le PID est fourni par l’action « Exécuter le processus » dans les actions IA-Connect Environnement /Session. Si vous ne connaissez pas le PID, laissez ce champ vide (ou 0). |
|
|
Rechercher une sous-arborescence UIA
|
SearchSubTree | boolean |
Si la valeur est true, l’arborescence UIA entière située sous le handle de fenêtre parent est recherchée. Cela est plus approfondi, mais peut prendre plus de temps. Si la valeur est false, seuls les éléments directement sous le handle de fenêtre parent dans l’arborescence UIA sont recherchés. |
|
|
Handle d’élément de retour
|
ReturnElementHandle | boolean |
Si la valeur est true, un handle sur l’élément situé est retourné. Ce handle peut être utilisé dans d’autres actions pour agir en tant que handle « parent ». |
|
|
Index de correspondance
|
MatchIndex | integer |
Si plusieurs éléments correspondent à la recherche, quel élément (à partir de 1) doit être mis en correspondance. Peut être utilisé conjointement avec « Trier par colonne » pour choisir l’ordre de tri correspondant. |
|
|
Filtre de recherche
|
SearchFilter | string |
Filtre avancé facultatif pour restreindre davantage la recherche à l’aide d’opérateurs conditionnels et de tout champ d’élément. Exemple 1 : [Width] < 200. Exemple 2 : [Name] like 'Document*' AND [ClassName] like 'Label*'. Pour plus d’exemples, consultez la documentation. |
|
|
Trier par nom de colonne
|
SortByColumn | string |
Si plusieurs éléments correspondent à la recherche, cela vous permet de spécifier la propriété d’élément à trier par. Cela sera utilisé conjointement avec « Match index » pour sélectionner l’élément requis. Par exemple : si « Trier par nom de colonne » est [TopEdge] et « Match index » est 1, l’élément correspondant le plus proche du haut de l’écran est mis en correspondance. |
|
|
L’index de correspondance est croissant
|
MatchIndexAscending | boolean |
Si plusieurs éléments correspondent à la recherche, doit correspondre à « Faire correspondre l’index » en haut de la liste triée (true) ou en bas de la liste triée (false). |
|
|
Inclure des processus enfants
|
IncludeChildProcesses | boolean |
Si la valeur est true et qu’un « ID de processus de recherche » est spécifié, les processus enfants de cet ID de processus sont également inclus dans la recherche. Si la valeur est false, seul un processus correspondant à l’id exact du processus de recherche est recherché. |
|
|
Nombre maximal d’éléments à rechercher
|
MaxElementsToSearch | integer |
Nombre maximal d’éléments à rechercher lors de la recherche de l’élément cible dans l’arborescence UIA. Cette entrée fonctionne uniquement si le mode de recherche d’élément UIA est « Tree walk » (cela peut être activé dans la page paramètres de l’inspecteur). Par défaut, cette valeur est définie sur 0 (illimité). Cette entrée est généralement utilisée pour optimiser la recherche d’éléments. |
|
|
Profondeur maximale de recherche relative
|
MaxRelativeSearchDepth | integer |
Profondeur maximale de l’arborescence relative à la recherche d’éléments enfants sous l’élément parent. Les éléments enfants directs ont une valeur de profondeur de 1. Cette entrée fonctionne uniquement si le mode de recherche d’élément UIA est « Tree walk » (cela peut être activé dans la page paramètres de l’inspecteur). Défini sur 0 pour une profondeur de recherche illimitée. Cette entrée est généralement utilisée pour optimiser la recherche d’éléments. |
|
|
Nombre maximal d’éléments enfants à rechercher par nœud
|
MaxChildElementsToSearchPerNode | integer |
Nombre maximal d’éléments enfants à rechercher sous chaque élément lors de la recherche de l’arborescence UIA pour l’élément cible. Cette entrée fonctionne uniquement si le mode de recherche d’élément UIA est « Tree walk » (cela peut être activé dans la page paramètres de l’inspecteur). Par défaut, cette valeur est définie sur 0 (illimité). Cette entrée est généralement utilisée pour optimiser la recherche d’éléments. |
|
|
Types de contrôle localisés d’élément à parcourir
|
ElementLocalizedControlTypesNotToTraverse | string |
Liste séparée par des virgules des types de contrôle localisés par des éléments UIA pour ne pas traverser (pas à pas) lors de la recherche de l’arborescence UIA pour l’élément cible. La recherche vérifie toujours si un élément individuel correspond aux critères de recherche, mais il ne recherche aucun élément enfant de cet élément si son type de contrôle localisé figure dans cette liste d’exclusions. Cette entrée fonctionne uniquement si le mode de recherche d’élément UIA est « Tree walk » (cela peut être activé dans la page paramètres de l’inspecteur). Cette entrée est généralement utilisée pour optimiser la recherche d’éléments. |
|
|
Flux de travail
|
Workflow | True | string |
Ajoutez l’expression suivante ici : workflow() |
Retours
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
L’élément existe
|
ElementExists | boolean |
Retourne true si l’élément existe ou false si ce n’est pas le cas. |
|
Handle d’élément
|
ElementHandle | integer |
Handle UIA pour l’élément. Cela peut être utilisé comme entrée pour d’autres actions UIA agissant sur cet élément. |
|
Nom de l'élément
|
ElementName | string |
Nom UIA de l’élément. |
|
Nom de la classe d’élément
|
ElementClassName | string |
Nom de classe UIA de l’élément. |
|
ID d’automatisation de l’élément
|
ElementAutomationId | string |
ID d’automatisation UIA de l’élément. |
|
Type de contrôle localisé par l’élément
|
ElementLocalizedControlType | string |
Type de contrôle localisé UIA de l’élément. |
Maximiser la fenêtre UIA
Optimise la fenêtre avec le handle UIA spécifié.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Handle de fenêtre
|
WindowHandle | True | integer |
Handle UIA pour la fenêtre à maximiser. |
|
Flux de travail
|
Workflow | True | string |
Ajoutez l’expression suivante ici : workflow() |
Mot de passe d’entrée global dans l’élément UIA
Déplace la souris au centre de l’élément, la met au focus, les cliques gauches et appuie sur les touches. Généralement utilisé avec une entrée de mot de passe qui n’accepte pas les méthodes d’entrée UIA natives.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Handle de fenêtre parent
|
ParentWindowHandle | True | integer |
Handle de fenêtre UIA parent (valeur 1 ou supérieure) pour agir comme point de départ de la recherche. Vous pouvez le découvrir via Inspection à l’aide d’actions telles que « Wait for desktop element » ou « Wait for element ». |
|
Nom de l’élément de recherche
|
SearchElementName | string |
Nom d’élément UIA facultatif à rechercher (à partir du handle de fenêtre parent). Cela peut être découvert par le biais de l’inspection. |
|
|
Nom de la classe d’élément Search
|
SearchElementClassName | string |
Nom de classe d’élément UIA facultatif à rechercher (à partir du handle de fenêtre parent). Cela peut être découvert par le biais de l’inspection. |
|
|
ID d’automatisation de l’élément de recherche
|
SearchElementAutomationId | string |
ID d’automatisation d’élément UIA facultatif à rechercher (à partir du handle de fenêtre parent). Cela peut être découvert par le biais de l’inspection. |
|
|
Type de contrôle localisé de l’élément de recherche
|
SearchLocalizedControlType | string |
Type de contrôle localisé de l’élément UIA facultatif à rechercher (à partir du handle de fenêtre parent). Cela peut être découvert par le biais de l’inspection. |
|
|
Rechercher une sous-arborescence UIA
|
SearchSubTree | boolean |
Si la valeur est true, l’arborescence UIA entière située sous le handle de fenêtre parent est recherchée. Cela est plus approfondi, mais peut prendre plus de temps. Si la valeur est false, seuls les éléments directement sous le handle de fenêtre parent dans l’arborescence UIA sont recherchés. |
|
|
Index de correspondance
|
MatchIndex | integer |
Si plusieurs éléments correspondent à la recherche, quel élément (à partir de 1) doit être mis en correspondance. Peut être utilisé conjointement avec « Trier par colonne » pour choisir l’ordre de tri correspondant. |
|
|
Filtre de recherche
|
SearchFilter | string |
Filtre avancé facultatif pour restreindre davantage la recherche à l’aide d’opérateurs conditionnels et de tout champ d’élément. Exemple 1 : [Width] < 200. Exemple 2 : [Name] like 'Document*' AND [ClassName] like 'Label*'. Pour plus d’exemples, consultez la documentation. |
|
|
Trier par nom de colonne
|
SortByColumn | string |
Si plusieurs éléments correspondent à la recherche, cela vous permet de spécifier la propriété d’élément à trier par. Cela sera utilisé conjointement avec « Match index » pour sélectionner l’élément requis. Par exemple : si « Trier par nom de colonne » est [TopEdge] et « Match index » est 1, l’élément correspondant le plus proche du haut de l’écran est mis en correspondance. |
|
|
L’index de correspondance est croissant
|
MatchIndexAscending | boolean |
Si plusieurs éléments correspondent à la recherche, doit correspondre à « Faire correspondre l’index » en haut de la liste triée (true) ou en bas de la liste triée (false). |
|
|
Élément Focus en premier
|
FocusElement | boolean |
Doit-il IA-Connect tenter de concentrer l’élément avant un clic global ? |
|
|
Clic global gauche sur l’élément
|
GlobalMouseClickOnElement | boolean |
Un clic global de la souris doit-il être effectué sur les coordonnées de l’élément (pour concentrer l’élément) avant d’entrer du texte ? |
|
|
Remplacer la valeur existante à l’aide d’un double clic de souris
|
ReplaceExistingValueUsingDoubleClickDelete | boolean |
Une valeur existante doit-elle être remplacée en double-cliquant sur la souris (pour la mettre en surbrillance), puis en supprimant ? |
|
|
Remplacer la valeur existante à l’aide de CTRL-A supprimer
|
ReplaceExistingValueUsingCTRLADelete | boolean |
Une valeur existante doit-elle être remplacée en appuyant sur Ctrl-A (pour mettre en surbrillance tout), puis en supprimant ? Certains éléments peuvent ne pas prendre en charge la mise en surbrillance avec Ctrl-A auquel cas l’option alternative « Remplacer la valeur existante à l’aide d’une double suppression de la souris » doit être tentée. |
|
|
Mot de passe à entrer
|
PasswordToInput | True | password |
Valeur du mot de passe pour l’entrée globale à l’aide du clavier. |
|
Utiliser les événements d’envoi de clés
|
SendKeyEvents | boolean |
Si la valeur est true, envoyez des événements de clé (une API de niveau inférieur qui envoie des séquences de touches simulées au système d’exploitation) seront utilisés. Si la valeur est false, les clés d’envoi (une API de niveau supérieur qui envoie des séquences de touches à l’élément prioritaire) sont utilisées à la place. |
|
|
Intervalle en millisecondes
|
Interval | integer |
Nombre de millisecondes entre chaque touche de pression. |
|
|
Ne pas interpréter les symboles
|
DontInterpretSymbols | boolean |
Les symboles du mot de passe à entrer ne doivent-ils pas être interprétés comme des touches spéciales (par exemple, + pour Maj, ^ pour Ctrl) ? Cette valeur doit être définie sur true si vous tentez d’entrer les symboles réels. |
|
|
Le mot de passe contient le mot de passe stocké
|
PasswordContainsStoredPassword | boolean |
Définissez la valeur true si le mot de passe contient (ou est entièrement) un identificateur de mot de passe stocké IA-Connect, au format {IAConnectPassword :StoredPasswordIdentifier} ou un IA-Connect Informations d’identification génériques Orchestrator, au format {OrchestratorCredential :FriendlyName}. Ce mot de passe stocké peut avoir été généré par l’action « Générer le mot de passe », par exemple, ou être détenu par l’orchestrateur IA-Connect. |
|
|
Nombre maximal d’éléments à rechercher
|
MaxElementsToSearch | integer |
Nombre maximal d’éléments à rechercher lors de la recherche de l’élément cible dans l’arborescence UIA. Cette entrée fonctionne uniquement si le mode de recherche d’élément UIA est « Tree walk » (cela peut être activé dans la page paramètres de l’inspecteur). Par défaut, cette valeur est définie sur 0 (illimité). Cette entrée est généralement utilisée pour optimiser la recherche d’éléments. |
|
|
Profondeur maximale de recherche relative
|
MaxRelativeSearchDepth | integer |
Profondeur maximale de l’arborescence relative à la recherche d’éléments enfants sous l’élément parent. Les éléments enfants directs ont une valeur de profondeur de 1. Cette entrée fonctionne uniquement si le mode de recherche d’élément UIA est « Tree walk » (cela peut être activé dans la page paramètres de l’inspecteur). Défini sur 0 pour une profondeur de recherche illimitée. Cette entrée est généralement utilisée pour optimiser la recherche d’éléments. |
|
|
Nombre maximal d’éléments enfants à rechercher par nœud
|
MaxChildElementsToSearchPerNode | integer |
Nombre maximal d’éléments enfants à rechercher sous chaque élément lors de la recherche de l’arborescence UIA pour l’élément cible. Cette entrée fonctionne uniquement si le mode de recherche d’élément UIA est « Tree walk » (cela peut être activé dans la page paramètres de l’inspecteur). Par défaut, cette valeur est définie sur 0 (illimité). Cette entrée est généralement utilisée pour optimiser la recherche d’éléments. |
|
|
Types de contrôle localisés d’élément à parcourir
|
ElementLocalizedControlTypesNotToTraverse | string |
Liste séparée par des virgules des types de contrôle localisés par des éléments UIA pour ne pas traverser (pas à pas) lors de la recherche de l’arborescence UIA pour l’élément cible. La recherche vérifie toujours si un élément individuel correspond aux critères de recherche, mais il ne recherche aucun élément enfant de cet élément si son type de contrôle localisé figure dans cette liste d’exclusions. Cette entrée fonctionne uniquement si le mode de recherche d’élément UIA est « Tree walk » (cela peut être activé dans la page paramètres de l’inspecteur). Cette entrée est généralement utilisée pour optimiser la recherche d’éléments. |
|
|
Valider le point cliquable dans la limite de l’élément
|
ValidateClickablePointWithinElementBoundary | boolean |
Pour certains éléments, UIA n’a pas connaissance d’un point cliquable dans l’élément et retourne une coordonnée non valide (par exemple 0,0) au lieu du centre de l’élément. Si cette entrée est définie sur true, IA-Connect vérifie la validité de la coordonnée fournie par UIA et, si elle n’est pas comprise dans la limite de l’élément, ignore la valeur fournie par UIA et utilise le centre de l’élément à la place. |
|
|
Flux de travail
|
Workflow | True | string |
Ajoutez l’expression suivante ici : workflow() |
Obtenir des modèles d’éléments UIA
Récupérez les modèles UIA disponibles pour un élément UIA et, par conséquent, quels IA-Connect actions UIA sont susceptibles d’avoir un effet sur l’élément.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Handle de fenêtre parent
|
ParentWindowHandle | True | integer |
Handle de fenêtre UIA parent (valeur 1 ou supérieure) pour agir comme point de départ de la recherche. Vous pouvez le découvrir via Inspection à l’aide d’actions telles que « Wait for desktop element » ou « Wait for element ». |
|
Nom de l’élément de recherche
|
SearchElementName | string |
Nom d’élément UIA facultatif à rechercher (à partir du handle de fenêtre parent). Cela peut être découvert par le biais de l’inspection. |
|
|
Nom de la classe d’élément Search
|
SearchElementClassName | string |
Nom de classe d’élément UIA facultatif à rechercher (à partir du handle de fenêtre parent). Cela peut être découvert par le biais de l’inspection. |
|
|
ID d’automatisation de l’élément de recherche
|
SearchElementAutomationId | string |
ID d’automatisation d’élément UIA facultatif à rechercher (à partir du handle de fenêtre parent). Cela peut être découvert par le biais de l’inspection. |
|
|
Type de contrôle localisé de l’élément de recherche
|
SearchLocalizedControlType | string |
Type de contrôle localisé de l’élément UIA facultatif à rechercher (à partir du handle de fenêtre parent). Cela peut être découvert par le biais de l’inspection. |
|
|
Rechercher une sous-arborescence UIA
|
SearchSubTree | boolean |
Si la valeur est true, l’arborescence UIA entière située sous le handle de fenêtre parent est recherchée. Cela est plus approfondi, mais peut prendre plus de temps. Si la valeur est false, seuls les éléments directement sous le handle de fenêtre parent dans l’arborescence UIA sont recherchés. |
|
|
Index de correspondance
|
MatchIndex | integer |
Si plusieurs éléments correspondent à la recherche, quel élément (à partir de 1) doit être mis en correspondance. Peut être utilisé conjointement avec « Trier par colonne » pour choisir l’ordre de tri correspondant. |
|
|
Filtre de recherche
|
SearchFilter | string |
Filtre avancé facultatif pour restreindre davantage la recherche à l’aide d’opérateurs conditionnels et de tout champ d’élément. Exemple 1 : [Width] < 200. Exemple 2 : [Name] like 'Document*' AND [ClassName] like 'Label*'. Pour plus d’exemples, consultez la documentation. |
|
|
Trier par nom de colonne
|
SortByColumn | string |
Si plusieurs éléments correspondent à la recherche, cela vous permet de spécifier la propriété d’élément à trier par. Cela sera utilisé conjointement avec « Match index » pour sélectionner l’élément requis. Par exemple : si « Trier par nom de colonne » est [TopEdge] et « Match index » est 1, l’élément correspondant le plus proche du haut de l’écran est mis en correspondance. |
|
|
L’index de correspondance est croissant
|
MatchIndexAscending | boolean |
Si plusieurs éléments correspondent à la recherche, doit correspondre à « Faire correspondre l’index » en haut de la liste triée (true) ou en bas de la liste triée (false). |
|
|
Nombre maximal d’éléments à rechercher
|
MaxElementsToSearch | integer |
Nombre maximal d’éléments à rechercher lors de la recherche de l’élément cible dans l’arborescence UIA. Cette entrée fonctionne uniquement si le mode de recherche d’élément UIA est « Tree walk » (cela peut être activé dans la page paramètres de l’inspecteur). Par défaut, cette valeur est définie sur 0 (illimité). Cette entrée est généralement utilisée pour optimiser la recherche d’éléments. |
|
|
Profondeur maximale de recherche relative
|
MaxRelativeSearchDepth | integer |
Profondeur maximale de l’arborescence relative à la recherche d’éléments enfants sous l’élément parent. Les éléments enfants directs ont une valeur de profondeur de 1. Cette entrée fonctionne uniquement si le mode de recherche d’élément UIA est « Tree walk » (cela peut être activé dans la page paramètres de l’inspecteur). Défini sur 0 pour une profondeur de recherche illimitée. Cette entrée est généralement utilisée pour optimiser la recherche d’éléments. |
|
|
Nombre maximal d’éléments enfants à rechercher par nœud
|
MaxChildElementsToSearchPerNode | integer |
Nombre maximal d’éléments enfants à rechercher sous chaque élément lors de la recherche de l’arborescence UIA pour l’élément cible. Cette entrée fonctionne uniquement si le mode de recherche d’élément UIA est « Tree walk » (cela peut être activé dans la page paramètres de l’inspecteur). Par défaut, cette valeur est définie sur 0 (illimité). Cette entrée est généralement utilisée pour optimiser la recherche d’éléments. |
|
|
Types de contrôle localisés d’élément à parcourir
|
ElementLocalizedControlTypesNotToTraverse | string |
Liste séparée par des virgules des types de contrôle localisés par des éléments UIA pour ne pas traverser (pas à pas) lors de la recherche de l’arborescence UIA pour l’élément cible. La recherche vérifie toujours si un élément individuel correspond aux critères de recherche, mais il ne recherche aucun élément enfant de cet élément si son type de contrôle localisé figure dans cette liste d’exclusions. Cette entrée fonctionne uniquement si le mode de recherche d’élément UIA est « Tree walk » (cela peut être activé dans la page paramètres de l’inspecteur). Cette entrée est généralement utilisée pour optimiser la recherche d’éléments. |
|
|
Flux de travail
|
Workflow | True | string |
Ajoutez l’expression suivante ici : workflow() |
Retours
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
Développer le modèle de réduction disponible
|
ExpandCollapsePatternAvailable | boolean |
Le modèle de réduction de l’extension UIA est disponible et, par conséquent, les actions qui développent ou réduisent un élément (par exemple, un menu déroulant) sont susceptibles de fonctionner. |
|
Modèle d’appel disponible
|
InvokePatternAvailable | boolean |
Le modèle d’appel UIA est disponible et, par conséquent, les actions qui appuient sur un élément ou cliquez sur un élément de liste sont susceptibles de fonctionner. |
|
Modèle de valeur de plage disponible
|
RangeValuePatternAvailable | boolean |
Le modèle de valeur de plage UIA est disponible et, par conséquent, les actions qui font défiler un élément ou un curseur sont susceptibles de fonctionner. |
|
Modèle de défilement disponible
|
ScrollPatternAvailable | boolean |
Le modèle de défilement UIA est disponible et, par conséquent, les actions qui font défiler un élément sont susceptibles de fonctionner. |
|
Modèle d’élément de sélection disponible
|
SelectionItemPatternAvailable | boolean |
Le modèle d’élément de sélection UIA est disponible et, par conséquent, les actions qui sélectionnent un élément sont susceptibles de fonctionner. |
|
Modèle de texte disponible
|
TextPatternAvailable | boolean |
Le modèle de texte UIA est disponible et, par conséquent, les actions qui lisent une valeur de texte d’élément sont susceptibles de fonctionner. |
|
Modèle bascule disponible
|
TogglePatternAvailable | boolean |
Le modèle bascule UIA est disponible et, par conséquent, les actions qui vérifient, décochent ou basculent un élément sont susceptibles de fonctionner. |
|
Modèle de valeur disponible
|
ValuePatternAvailable | boolean |
Le modèle de valeur UIA est disponible et, par conséquent, les actions qui entrent du texte dans un élément ou lisent une valeur d’élément sont susceptibles de fonctionner. Les barres de défilement peuvent également réagir à un modèle de valeur. |
|
Modèle de fenêtre disponible
|
WindowPatternAvailable | boolean |
Le modèle de fenêtre UIA est disponible et, par conséquent, les actions qui ferment, optimisent ou minimisent un élément sont susceptibles de fonctionner. |
|
Modèle de grille disponible
|
GridPatternAvailable | boolean |
Le modèle de grille UIA est disponible. Ce modèle n’est pas utilisé par IA-Connect. |
|
Modèle d’élément de grille disponible
|
GridItemPatternAvailable | boolean |
Le modèle d’élément de grille UIA est disponible. Ce modèle n’est pas utilisé par IA-Connect. |
|
Modèle IAccessible hérité disponible
|
LegacyIAccessiblePatternAvailable | boolean |
Le modèle IAccessible hérité UIA est disponible. Ce modèle n’est pas utilisé par IA-Connect. |
|
Modèle de sélection disponible
|
SelectionPatternAvailable | boolean |
Le modèle de sélection UIA est disponible. Ce modèle n’est pas utilisé par IA-Connect. |
|
Modèle de feuille de calcul disponible
|
SpreadsheetPatternAvailable | boolean |
Le modèle de feuille de calcul UIA est disponible. Ce modèle n’est pas utilisé par IA-Connect. |
|
Modèle d’élément de feuille de calcul disponible
|
SpreadsheetItemPatternAvailable | boolean |
Le modèle d’élément de feuille de calcul UIA est disponible. Ce modèle n’est pas utilisé par IA-Connect. |
|
Modèle de table disponible
|
TablePatternAvailable | boolean |
Le modèle de table UIA est disponible. Ce modèle n’est pas utilisé par IA-Connect. |
|
Modèle d’élément de table disponible
|
TableItemPatternAvailable | boolean |
Le modèle d’élément de table UIA est disponible. Ce modèle n’est pas utilisé par IA-Connect. |
|
Modèle de texte 2 disponible
|
TextPattern2Available | boolean |
Le modèle de texte UIA 2 est disponible. Ce modèle n’est pas utilisé par IA-Connect. |
|
Modèle de modification de texte disponible
|
TextEditPatternAvailable | boolean |
Le modèle d’édition de texte UIA est disponible. Ce modèle n’est pas utilisé par IA-Connect. |
|
Modèle de transformation disponible
|
TransformPatternAvailable | boolean |
Le modèle de transformation UIA est disponible. Ce modèle n’est pas utilisé par IA-Connect. |
Obtenir des éléments de bureau UIA
Retourne une liste de toutes les fenêtres et boîtes de dialogue sur le bureau.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Type de contrôle localisé de l’élément de recherche
|
SearchElementLocalizedControlType | string |
Filtrez les résultats par le type de contrôle localisé de l’élément. |
|
|
ID du processus de recherche
|
SearchProcessID | integer |
Si elle est spécifiée, la recherche prend uniquement en compte les éléments appartenant à un processus avec cet ID de processus (PID). Si IA-Connect lancé le processus, le PID est fourni par l’action « Exécuter le processus » dans les actions IA-Connect Environnement /Session. Si vous ne connaissez pas le PID, laissez ce champ vide. |
|
|
Handle d’élément de retour
|
ReturnElementHandle | boolean |
Si la valeur est true, un handle sur l’élément situé est retourné. Ce handle peut être utilisé dans d’autres actions pour agir en tant que handle « parent ». |
|
|
Premier élément à retourner
|
FirstItemToReturn | integer |
Index d’élément du premier élément à retourner, à partir de 1. Si vous souhaitez renvoyer les éléments dans l’ordre inverse (à partir du bas de l’arborescence UIA), vous pouvez également spécifier un index négatif à partir de -1. |
|
|
Nombre maximal d’éléments à retourner
|
MaxItemsToReturn | integer |
Nombre maximal d’éléments à retourner, ou 0 pour renvoyer tous les éléments. |
|
|
Inclure des processus enfants
|
IncludeChildProcesses | boolean |
Si la valeur est true et qu’un « ID de processus de recherche » est spécifié, les processus enfants de cet ID de processus sont également inclus dans la recherche. Si la valeur est false, seul un processus correspondant à l’id de processus de recherche exact est retourné. |
|
|
Flux de travail
|
Workflow | True | string |
Ajoutez l’expression suivante ici : workflow() |
Retours
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
Nombre d’éléments trouvés
|
NumberOfElementsFound | integer |
Nombre d’éléments de bureau trouvés qui correspondent aux critères de recherche. |
|
Nombre d’éléments retournés
|
NumberOfElementsReturned | integer |
Nombre d’éléments de bureau retournés (cela peut être inférieur au nombre d’éléments trouvés si vous spécifiez un nombre maximal d’éléments à renvoyer). |
|
Propriétés de l’élément
|
ElementProperties | array of object |
Les propriétés d’élément des éléments de bureau ont été trouvées qui correspondent aux critères de recherche. |
|
items
|
ElementProperties | object |
Obtenir la valeur de l’élément UIA
Retourne la valeur d’un élément. Une valeur est généralement associée à une zone d’entrée de texte, mais de nombreux éléments peuvent avoir cette propriété.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Handle de fenêtre parent
|
ParentWindowHandle | True | integer |
Handle de fenêtre UIA parent (valeur 1 ou supérieure) pour agir comme point de départ de la recherche. Vous pouvez le découvrir via Inspection à l’aide d’actions telles que « Wait for desktop element » ou « Wait for element ». |
|
Nom de l’élément de recherche
|
SearchElementName | string |
Nom d’élément UIA facultatif à rechercher (à partir du handle de fenêtre parent). Cela peut être découvert par le biais de l’inspection. |
|
|
Nom de la classe d’élément Search
|
SearchElementClassName | string |
Nom de classe d’élément UIA facultatif à rechercher (à partir du handle de fenêtre parent). Cela peut être découvert par le biais de l’inspection. |
|
|
ID d’automatisation de l’élément de recherche
|
SearchElementAutomationId | string |
ID d’automatisation d’élément UIA facultatif à rechercher (à partir du handle de fenêtre parent). Cela peut être découvert par le biais de l’inspection. |
|
|
Type de contrôle localisé de l’élément de recherche
|
SearchLocalizedControlType | string |
Type de contrôle localisé de l’élément UIA facultatif à rechercher (à partir du handle de fenêtre parent). Cela peut être découvert par le biais de l’inspection. |
|
|
Rechercher une sous-arborescence UIA
|
SearchSubTree | boolean |
Si la valeur est true, l’arborescence UIA entière située sous le handle de fenêtre parent est recherchée. Cela est plus approfondi, mais peut prendre plus de temps. Si la valeur est false, seuls les éléments directement sous le handle de fenêtre parent dans l’arborescence UIA sont recherchés. |
|
|
Index de correspondance
|
MatchIndex | integer |
Si plusieurs éléments correspondent à la recherche, quel élément (à partir de 1) doit être mis en correspondance. Peut être utilisé conjointement avec « Trier par colonne » pour choisir l’ordre de tri correspondant. |
|
|
Filtre de recherche
|
SearchFilter | string |
Filtre avancé facultatif pour restreindre davantage la recherche à l’aide d’opérateurs conditionnels et de tout champ d’élément. Exemple 1 : [Width] < 200. Exemple 2 : [Name] like 'Document*' AND [ClassName] like 'Label*'. Pour plus d’exemples, consultez la documentation. |
|
|
Trier par nom de colonne
|
SortByColumn | string |
Si plusieurs éléments correspondent à la recherche, cela vous permet de spécifier la propriété d’élément à trier par. Cela sera utilisé conjointement avec « Match index » pour sélectionner l’élément requis. Par exemple : si « Trier par nom de colonne » est [TopEdge] et « Match index » est 1, l’élément correspondant le plus proche du haut de l’écran est mis en correspondance. |
|
|
L’index de correspondance est croissant
|
MatchIndexAscending | boolean |
Si plusieurs éléments correspondent à la recherche, doit correspondre à « Faire correspondre l’index » en haut de la liste triée (true) ou en bas de la liste triée (false). |
|
|
Nombre maximal d’éléments à rechercher
|
MaxElementsToSearch | integer |
Nombre maximal d’éléments à rechercher lors de la recherche de l’élément cible dans l’arborescence UIA. Cette entrée fonctionne uniquement si le mode de recherche d’élément UIA est « Tree walk » (cela peut être activé dans la page paramètres de l’inspecteur). Par défaut, cette valeur est définie sur 0 (illimité). Cette entrée est généralement utilisée pour optimiser la recherche d’éléments. |
|
|
Profondeur maximale de recherche relative
|
MaxRelativeSearchDepth | integer |
Profondeur maximale de l’arborescence relative à la recherche d’éléments enfants sous l’élément parent. Les éléments enfants directs ont une valeur de profondeur de 1. Cette entrée fonctionne uniquement si le mode de recherche d’élément UIA est « Tree walk » (cela peut être activé dans la page paramètres de l’inspecteur). Défini sur 0 pour une profondeur de recherche illimitée. Cette entrée est généralement utilisée pour optimiser la recherche d’éléments. |
|
|
Nombre maximal d’éléments enfants à rechercher par nœud
|
MaxChildElementsToSearchPerNode | integer |
Nombre maximal d’éléments enfants à rechercher sous chaque élément lors de la recherche de l’arborescence UIA pour l’élément cible. Cette entrée fonctionne uniquement si le mode de recherche d’élément UIA est « Tree walk » (cela peut être activé dans la page paramètres de l’inspecteur). Par défaut, cette valeur est définie sur 0 (illimité). Cette entrée est généralement utilisée pour optimiser la recherche d’éléments. |
|
|
Types de contrôle localisés d’élément à parcourir
|
ElementLocalizedControlTypesNotToTraverse | string |
Liste séparée par des virgules des types de contrôle localisés par des éléments UIA pour ne pas traverser (pas à pas) lors de la recherche de l’arborescence UIA pour l’élément cible. La recherche vérifie toujours si un élément individuel correspond aux critères de recherche, mais il ne recherche aucun élément enfant de cet élément si son type de contrôle localisé figure dans cette liste d’exclusions. Cette entrée fonctionne uniquement si le mode de recherche d’élément UIA est « Tree walk » (cela peut être activé dans la page paramètres de l’inspecteur). Cette entrée est généralement utilisée pour optimiser la recherche d’éléments. |
|
|
Flux de travail
|
Workflow | True | string |
Ajoutez l’expression suivante ici : workflow() |
Retours
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
Valeur de l’élément
|
ElementValue | string |
Valeur de l’élément. |
Obtenir la valeur de l’étiquette d’élément UIA
Retourne la valeur de l’étiquette sur l’élément.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Handle de fenêtre parent
|
ParentWindowHandle | True | integer |
Handle de fenêtre UIA parent (valeur 1 ou supérieure) pour agir comme point de départ de la recherche. Vous pouvez le découvrir via Inspection à l’aide d’actions telles que « Wait for desktop element » ou « Wait for element ». |
|
Nom de l’élément de recherche
|
SearchElementName | string |
Nom d’élément UIA facultatif à rechercher (à partir du handle de fenêtre parent). Cela peut être découvert par le biais de l’inspection. |
|
|
Nom de la classe d’élément Search
|
SearchElementClassName | string |
Nom de classe d’élément UIA facultatif à rechercher (à partir du handle de fenêtre parent). Cela peut être découvert par le biais de l’inspection. |
|
|
ID d’automatisation de l’élément de recherche
|
SearchElementAutomationId | string |
ID d’automatisation d’élément UIA facultatif à rechercher (à partir du handle de fenêtre parent). Cela peut être découvert par le biais de l’inspection. |
|
|
Type de contrôle localisé de l’élément de recherche
|
SearchLocalizedControlType | string |
Type de contrôle localisé de l’élément UIA facultatif à rechercher (à partir du handle de fenêtre parent). Cela peut être découvert par le biais de l’inspection. |
|
|
Rechercher une sous-arborescence UIA
|
SearchSubTree | boolean |
Si la valeur est true, l’arborescence UIA entière située sous le handle de fenêtre parent est recherchée. Cela est plus approfondi, mais peut prendre plus de temps. Si la valeur est false, seuls les éléments directement sous le handle de fenêtre parent dans l’arborescence UIA sont recherchés. |
|
|
Index de correspondance
|
MatchIndex | integer |
Si plusieurs éléments correspondent à la recherche, quel élément (à partir de 1) doit être mis en correspondance. Peut être utilisé conjointement avec « Trier par colonne » pour choisir l’ordre de tri correspondant. |
|
|
Filtre de recherche
|
SearchFilter | string |
Filtre avancé facultatif pour restreindre davantage la recherche à l’aide d’opérateurs conditionnels et de tout champ d’élément. Exemple 1 : [Width] < 200. Exemple 2 : [Name] like 'Document*' AND [ClassName] like 'Label*'. Pour plus d’exemples, consultez la documentation. |
|
|
Trier par nom de colonne
|
SortByColumn | string |
Si plusieurs éléments correspondent à la recherche, cela vous permet de spécifier la propriété d’élément à trier par. Cela sera utilisé conjointement avec « Match index » pour sélectionner l’élément requis. Par exemple : si « Trier par nom de colonne » est [TopEdge] et « Match index » est 1, l’élément correspondant le plus proche du haut de l’écran est mis en correspondance. |
|
|
L’index de correspondance est croissant
|
MatchIndexAscending | boolean |
Si plusieurs éléments correspondent à la recherche, doit correspondre à « Faire correspondre l’index » en haut de la liste triée (true) ou en bas de la liste triée (false). |
|
|
Nombre maximal d’éléments à rechercher
|
MaxElementsToSearch | integer |
Nombre maximal d’éléments à rechercher lors de la recherche de l’élément cible dans l’arborescence UIA. Cette entrée fonctionne uniquement si le mode de recherche d’élément UIA est « Tree walk » (cela peut être activé dans la page paramètres de l’inspecteur). Par défaut, cette valeur est définie sur 0 (illimité). Cette entrée est généralement utilisée pour optimiser la recherche d’éléments. |
|
|
Profondeur maximale de recherche relative
|
MaxRelativeSearchDepth | integer |
Profondeur maximale de l’arborescence relative à la recherche d’éléments enfants sous l’élément parent. Les éléments enfants directs ont une valeur de profondeur de 1. Cette entrée fonctionne uniquement si le mode de recherche d’élément UIA est « Tree walk » (cela peut être activé dans la page paramètres de l’inspecteur). Défini sur 0 pour une profondeur de recherche illimitée. Cette entrée est généralement utilisée pour optimiser la recherche d’éléments. |
|
|
Nombre maximal d’éléments enfants à rechercher par nœud
|
MaxChildElementsToSearchPerNode | integer |
Nombre maximal d’éléments enfants à rechercher sous chaque élément lors de la recherche de l’arborescence UIA pour l’élément cible. Cette entrée fonctionne uniquement si le mode de recherche d’élément UIA est « Tree walk » (cela peut être activé dans la page paramètres de l’inspecteur). Par défaut, cette valeur est définie sur 0 (illimité). Cette entrée est généralement utilisée pour optimiser la recherche d’éléments. |
|
|
Types de contrôle localisés d’élément à parcourir
|
ElementLocalizedControlTypesNotToTraverse | string |
Liste séparée par des virgules des types de contrôle localisés par des éléments UIA pour ne pas traverser (pas à pas) lors de la recherche de l’arborescence UIA pour l’élément cible. La recherche vérifie toujours si un élément individuel correspond aux critères de recherche, mais il ne recherche aucun élément enfant de cet élément si son type de contrôle localisé figure dans cette liste d’exclusions. Cette entrée fonctionne uniquement si le mode de recherche d’élément UIA est « Tree walk » (cela peut être activé dans la page paramètres de l’inspecteur). Cette entrée est généralement utilisée pour optimiser la recherche d’éléments. |
|
|
Flux de travail
|
Workflow | True | string |
Ajoutez l’expression suivante ici : workflow() |
Retours
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
Valeur de l’étiquette d’élément
|
ElementLabelValue | string |
Valeur de l’étiquette sur l’élément. |
Obtenir la valeur de texte de l’élément UIA
Retourne la valeur de texte d’un élément. Une valeur de texte est généralement associée à une étiquette, mais de nombreux éléments peuvent avoir cette propriété.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Handle de fenêtre parent
|
ParentWindowHandle | True | integer |
Handle de fenêtre UIA parent (valeur 1 ou supérieure) pour agir comme point de départ de la recherche. Vous pouvez le découvrir via Inspection à l’aide d’actions telles que « Wait for desktop element » ou « Wait for element ». |
|
Nom de l’élément de recherche
|
SearchElementName | string |
Nom d’élément UIA facultatif à rechercher (à partir du handle de fenêtre parent). Cela peut être découvert par le biais de l’inspection. |
|
|
Nom de la classe d’élément Search
|
SearchElementClassName | string |
Nom de classe d’élément UIA facultatif à rechercher (à partir du handle de fenêtre parent). Cela peut être découvert par le biais de l’inspection. |
|
|
ID d’automatisation de l’élément de recherche
|
SearchElementAutomationId | string |
ID d’automatisation d’élément UIA facultatif à rechercher (à partir du handle de fenêtre parent). Cela peut être découvert par le biais de l’inspection. |
|
|
Type de contrôle localisé de l’élément de recherche
|
SearchLocalizedControlType | string |
Type de contrôle localisé de l’élément UIA facultatif à rechercher (à partir du handle de fenêtre parent). Cela peut être découvert par le biais de l’inspection. |
|
|
Rechercher une sous-arborescence UIA
|
SearchSubTree | boolean |
Si la valeur est true, l’arborescence UIA entière située sous le handle de fenêtre parent est recherchée. Cela est plus approfondi, mais peut prendre plus de temps. Si la valeur est false, seuls les éléments directement sous le handle de fenêtre parent dans l’arborescence UIA sont recherchés. |
|
|
Index de correspondance
|
MatchIndex | integer |
Si plusieurs éléments correspondent à la recherche, quel élément (à partir de 1) doit être mis en correspondance. Peut être utilisé conjointement avec « Trier par colonne » pour choisir l’ordre de tri correspondant. |
|
|
Filtre de recherche
|
SearchFilter | string |
Filtre avancé facultatif pour restreindre davantage la recherche à l’aide d’opérateurs conditionnels et de tout champ d’élément. Exemple 1 : [Width] < 200. Exemple 2 : [Name] like 'Document*' AND [ClassName] like 'Label*'. Pour plus d’exemples, consultez la documentation. |
|
|
Trier par nom de colonne
|
SortByColumn | string |
Si plusieurs éléments correspondent à la recherche, cela vous permet de spécifier la propriété d’élément à trier par. Cela sera utilisé conjointement avec « Match index » pour sélectionner l’élément requis. Par exemple : si « Trier par nom de colonne » est [TopEdge] et « Match index » est 1, l’élément correspondant le plus proche du haut de l’écran est mis en correspondance. |
|
|
L’index de correspondance est croissant
|
MatchIndexAscending | boolean |
Si plusieurs éléments correspondent à la recherche, doit correspondre à « Faire correspondre l’index » en haut de la liste triée (true) ou en bas de la liste triée (false). |
|
|
Nombre maximal d’éléments à rechercher
|
MaxElementsToSearch | integer |
Nombre maximal d’éléments à rechercher lors de la recherche de l’élément cible dans l’arborescence UIA. Cette entrée fonctionne uniquement si le mode de recherche d’élément UIA est « Tree walk » (cela peut être activé dans la page paramètres de l’inspecteur). Par défaut, cette valeur est définie sur 0 (illimité). Cette entrée est généralement utilisée pour optimiser la recherche d’éléments. |
|
|
Profondeur maximale de recherche relative
|
MaxRelativeSearchDepth | integer |
Profondeur maximale de l’arborescence relative à la recherche d’éléments enfants sous l’élément parent. Les éléments enfants directs ont une valeur de profondeur de 1. Cette entrée fonctionne uniquement si le mode de recherche d’élément UIA est « Tree walk » (cela peut être activé dans la page paramètres de l’inspecteur). Défini sur 0 pour une profondeur de recherche illimitée. Cette entrée est généralement utilisée pour optimiser la recherche d’éléments. |
|
|
Nombre maximal d’éléments enfants à rechercher par nœud
|
MaxChildElementsToSearchPerNode | integer |
Nombre maximal d’éléments enfants à rechercher sous chaque élément lors de la recherche de l’arborescence UIA pour l’élément cible. Cette entrée fonctionne uniquement si le mode de recherche d’élément UIA est « Tree walk » (cela peut être activé dans la page paramètres de l’inspecteur). Par défaut, cette valeur est définie sur 0 (illimité). Cette entrée est généralement utilisée pour optimiser la recherche d’éléments. |
|
|
Types de contrôle localisés d’élément à parcourir
|
ElementLocalizedControlTypesNotToTraverse | string |
Liste séparée par des virgules des types de contrôle localisés par des éléments UIA pour ne pas traverser (pas à pas) lors de la recherche de l’arborescence UIA pour l’élément cible. La recherche vérifie toujours si un élément individuel correspond aux critères de recherche, mais il ne recherche aucun élément enfant de cet élément si son type de contrôle localisé figure dans cette liste d’exclusions. Cette entrée fonctionne uniquement si le mode de recherche d’élément UIA est « Tree walk » (cela peut être activé dans la page paramètres de l’inspecteur). Cette entrée est généralement utilisée pour optimiser la recherche d’éléments. |
|
|
Flux de travail
|
Workflow | True | string |
Ajoutez l’expression suivante ici : workflow() |
Retours
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
Valeur de texte de l’élément
|
ElementTextValue | string |
Valeur de texte de l’élément. |
Obtenir le contenu de l’élément datagrid UIA
Retourne le contenu d’un élément datagrid. Il s’agit d’un élément avec des lignes, des colonnes, des en-têtes et des cellules (par exemple, un tableau). Cette action peut également être utilisée pour récupérer les résultats d’une exécution précédente de cette action, exécutée en tant que thread Agent.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Handle de fenêtre parent
|
ParentWindowHandle | integer |
Handle de fenêtre UIA parent (valeur 1 ou supérieure) pour agir comme point de départ de la recherche. Vous pouvez le découvrir via Inspection à l’aide d’actions telles que « Wait for desktop element » ou « Wait for element ». |
|
|
Nom de l’élément de recherche
|
SearchElementName | string |
Nom d’élément UIA facultatif à rechercher (à partir du handle de fenêtre parent). Cela peut être découvert par le biais de l’inspection. |
|
|
Nom de la classe d’élément Search
|
SearchElementClassName | string |
Nom de classe d’élément UIA facultatif à rechercher (à partir du handle de fenêtre parent). Cela peut être découvert par le biais de l’inspection. |
|
|
ID d’automatisation de l’élément de recherche
|
SearchElementAutomationId | string |
ID d’automatisation d’élément UIA facultatif à rechercher (à partir du handle de fenêtre parent). Cela peut être découvert par le biais de l’inspection. |
|
|
Type de contrôle localisé de l’élément de recherche
|
SearchLocalizedControlType | string |
Type de contrôle localisé de l’élément UIA facultatif à rechercher (à partir du handle de fenêtre parent). Cela peut être découvert par le biais de l’inspection. |
|
|
Rechercher une sous-arborescence UIA
|
SearchSubTree | boolean |
Si la valeur est true, l’arborescence UIA entière située sous le handle de fenêtre parent est recherchée. Cela est plus approfondi, mais peut prendre plus de temps. Si la valeur est false, seuls les éléments directement sous le handle de fenêtre parent dans l’arborescence UIA sont recherchés. |
|
|
Récupérer les colonnes à l’écran uniquement
|
OnScreenColumnsOnly | boolean |
Si la valeur est true, seules les colonnes à l’écran sont retournées. |
|
|
Récupérer les lignes à l’écran uniquement
|
OnScreenRowsOnly | boolean |
Si la valeur est true, seules les lignes à l’écran sont retournées. |
|
|
Retourner des valeurs null comme vides
|
ReturnNullValuesAsBlank | boolean |
Si la valeur est true, les valeurs Null sont retournées en tant que « » (c’est-à-dire vides). Si la valeur est false, les valeurs Null sont généralement retournées en tant que ' (null)'. |
|
|
Autre nom de ligne d’en-tête
|
AlternativeHeaderRowName | string |
Par défaut, la ligne d’en-tête d’un DataGrid porte le nom d’élément UIA « Top Row ». Si la ligne d’en-tête a un nom différent, spécifiez ce nom ici. |
|
|
Retourner le nom de la ligne UIA
|
ReturnRowUIAName | boolean |
Si cette entrée est définie, le nom de la ligne UIA est stocké dans une colonne de la collection de sorties. Le nom de la colonne est défini par l’entrée « Nom de colonne pour stocker le nom de la ligne UIA ». |
|
|
Nom de la colonne pour stocker le nom de la ligne UIA
|
NameOfColumnToStoreRowUIAName | string |
Si l’entrée « Return row UIA name » est définie sur true, cette entrée spécifie le nom de la colonne dans la collection de sortie pour contenir le nom de la ligne UIA. |
|
|
Index de correspondance
|
MatchIndex | integer |
Si plusieurs éléments correspondent à la recherche, quel élément (à partir de 1) doit être mis en correspondance. Peut être utilisé conjointement avec « Trier par colonne » pour choisir l’ordre de tri correspondant. |
|
|
Filtre de recherche
|
SearchFilter | string |
Filtre avancé facultatif pour restreindre davantage la recherche à l’aide d’opérateurs conditionnels et de tout champ d’élément. Exemple 1 : [Width] < 200. Exemple 2 : [Name] like 'Document*' AND [ClassName] like 'Label*'. Pour plus d’exemples, consultez la documentation. |
|
|
Trier par nom de colonne
|
SortByColumn | string |
Si plusieurs éléments correspondent à la recherche, cela vous permet de spécifier la propriété d’élément à trier par. Cela sera utilisé conjointement avec « Match index » pour sélectionner l’élément requis. Par exemple : si « Trier par nom de colonne » est [TopEdge] et « Match index » est 1, l’élément correspondant le plus proche du haut de l’écran est mis en correspondance. |
|
|
L’index de correspondance est croissant
|
MatchIndexAscending | boolean |
Si plusieurs éléments correspondent à la recherche, doit correspondre à « Faire correspondre l’index » en haut de la liste triée (true) ou en bas de la liste triée (false). |
|
|
Premier élément à retourner
|
FirstItemToReturn | integer |
Index d’élément du premier élément (ligne) à retourner, à partir de 1. |
|
|
Nombre maximal d’éléments à retourner
|
MaxItemsToReturn | integer |
Nombre maximal d’éléments (lignes) à retourner, ou 0 pour renvoyer tous les éléments (lignes). |
|
|
Analyser les premières lignes N pour les lignes vides
|
ScanFirstNRowsForEmptyRows | integer |
Certains datagrids ont quelques éléments de ligne vides/null dans l’arborescence UIA (généralement en haut) et IA-Connect ignore automatiquement ces éléments de ligne, car ils ne représentent rien dans la table qui est visible dans l’interface utilisateur. Si cette entrée est définie sur 0 (valeur par défaut), l’agent IA-Connect analyse toujours les éléments de ligne à partir de la première ligne, même si « Premier élément à retourner » est défini pour récupérer les lignes plus profondes dans la table. Cela garantit la cohérence avec les numéros d’index de ligne, mais affecte les performances, car toutes les lignes de la première ligne vers la ou les lignes demandées doivent être analysées. Si vous êtes certain que les seuls éléments de ligne vides /null de la table se trouvent dans les premières lignes N (par exemple, 10), vous pouvez définir cette valeur sur N (par exemple, 10) pour améliorer potentiellement les performances. Ne définissez pas sur une valeur autre que 0, sauf si vous savez ce que vous faites. |
|
|
Lire la table en tant que thread
|
ReadTableAsThread | boolean |
Si la valeur est false (valeur par défaut), l’agent IA-Connect lit immédiatement la table et retourne le contenu au directeur. Si vous lisez des tables volumineuses, cette action peut expirer. Si la valeur est true, l’agent IA-Connect lit la table en tant que thread d’agent et le directeur IA-Connect (ou Orchestrator, module PowerShell, Blue Prism) peut surveiller l’état de ce thread Agent, en attendant qu’il se termine. Cela permet de lire des tables volumineuses sans délai d’attente. IA-Connect Agents 9.3 et versions antérieures n’ont pu lire que les tables immédiatement, et non en tant que thread Agent. |
|
|
Récupérer les données de sortie pour l’ID de thread
|
RetrieveOutputDataFromThreadId | integer |
Si vous avez précédemment exécuté cette action en tant que thread agent et que vous définissez « Secondes pour attendre le thread » sur 0, indiquez l’ID de thread agent pour récupérer les résultats. Cet ID de thread agent a été fourni par l’appel précédent à cette action. Définissez la valeur 0 (valeur par défaut) si vous lisez un datagrid (et, par conséquent, si vous ne récupérez pas les résultats d’une requête précédente exécutée en tant que thread d’agent). |
|
|
Secondes à attendre pour le thread
|
SecondsToWaitForThread | integer |
Si la valeur « Lire la table en tant que thread » est définie sur true, le nombre de secondes à attendre la fin du thread agent. Si le thread Agent lisant la table n’a pas été terminé pour le moment, une exception est levée. Défini sur 0 pour contourner l’attente : l’agent continue de lire le datagrid, mais il est également disponible pour l’action suivante. Vous pouvez ensuite récupérer les résultats (le contenu du datagrid) ultérieurement en utilisant l’action « Attendre que le thread agent se termine correctement » pour attendre que le thread agent se termine, puis réexécuter cette action « Obtenir le contenu de l’élément datagrid UIA » avec l’entrée « Récupérer les données de sortie pour l’ID de thread » définie sur l’ID de thread Agent. |
|
|
Faire défiler le réseau de données verticalement toutes les N pour cent
|
ScrollDataGridVerticallyEveryNPercent | integer |
Les performances de lecture de quelques grands datagrids (par exemple, avec des milliers de lignes) ont été observées pour s’améliorer si vous faites défiler régulièrement le datagrid vers (ou près) de l’emplacement en cours de défilement. Si la valeur est 0 (valeur par défaut), le datagrid n’est pas défilement lors de la lecture du contenu. Si elle est définie sur une valeur comprise entre 1 et 100, le datagrid est régulièrement fait défiler (tous les N pour cent du nombre total de lignes) lors de la lecture du contenu. Par exemple : si la valeur est définie sur 20, la grille de données est défilement à 0, 20, 40, 60, 80 %. Vous pouvez également utiliser « Scroll datagrid verticalement toutes les lignes N » pour faire défiler chaque ligne N au lieu de chaque N pour cent. |
|
|
Faire défiler le datagrid verticalement toutes les lignes N
|
ScrollDataGridVerticallyEveryNRows | integer |
Les performances de lecture de quelques grands datagrids (par exemple, avec des milliers de lignes) ont été observées pour s’améliorer si vous faites défiler régulièrement le datagrid vers (ou près) de l’emplacement en cours de défilement. Si la valeur est 0 (valeur par défaut), le datagrid n’est pas défilement lors de la lecture du contenu. Si la valeur est définie sur 1 ou une valeur supérieure, le datagrid fait défiler toutes les lignes N lors de la lecture du contenu. Par exemple : si la valeur est 5, le datagrid fait défiler toutes les 5 lignes. Vous pouvez également utiliser « Scroll datagrid vertically every N percent » pour faire défiler chaque N pour cent des lignes au lieu de chaque ligne N. |
|
|
Faire défiler le handle d’élément datagrid verticalement
|
ScrollDataGridVerticallyElementHandle | integer |
Si vous faites défiler le réseau de données verticalement lors de la lecture du contenu, cette entrée définit la façon dont IA-Connect localisera la barre de défilement verticale. Si la valeur est 0, IA-Connect tente de faire défiler directement le datagrid, soit en utilisant le modèle « scroll » (si le datagrid le prend en charge) soit en recherchant la barre de défilement verticale contenue dans le datagrid. Vous pouvez également spécifier la poignée IA-Connect UIA de l’élément de barre de défilement verticale (l’élément de barre de défilement lui-même, et non les boutons dans) qui est une valeur de 1 ou supérieure. |
|
|
Lignes datagrid minimales pour le défilement
|
MinimumDataGridRowsForScrolling | integer |
Si vous faites défiler la grille de données verticalement lors de la lecture du contenu, cette entrée spécifie le nombre minimal de lignes requises dans la table avant que IA-Connect effectue le défilement. Si la valeur est 0, IA-Connect défile quel que soit le nombre de lignes. Si elle est définie sur un nombre positif, IA-Connect effectue uniquement le défilement lorsque le datagrid a ce nombre de lignes ou plus. |
|
|
Déclencher une exception si elle ne peut pas faire défiler
|
RaiseExceptionIfCannotScroll | boolean |
Si vous faites défiler le réseau de données verticalement lors de la lecture du contenu : définissez cette entrée sur true si un échec de défilement doit être considéré comme une exception ou défini sur false (valeur par défaut) si un échec de défilement doit être ignoré. Les échecs courants de défilement incluent l’échec de la localisation des barres de défilement ou les barres de défilement ne disposent pas d’un modèle UIA adapté au défilement ('scroll', 'rangevalue' ou 'value'). |
|
|
Autre nom de barre de défilement verticale
|
AlternativeVerticalScrollbarName | string |
Par défaut, la barre de défilement verticale 'row' dans un datagrid a le nom d’élément UIA 'Vertical Scroll Bar'. Si la barre de défilement verticale a un autre nom, spécifiez ce nom ici. Cela sera utilisé si vous souhaitez IA-Connect faire défiler périodiquement la grille de données lors de la lecture du contenu, le champ d’entrée « Scroll datagrid element handle » est défini sur 0 (en spécifiant que IA-Connect doit faire défiler le datagrid directement), mais le datagrid n’implémente pas le modèle « scroll ». |
|
|
Nombre maximal d’éléments à rechercher
|
MaxElementsToSearch | integer |
Nombre maximal d’éléments à rechercher lors de la recherche de l’élément cible dans l’arborescence UIA. Cette entrée fonctionne uniquement si le mode de recherche d’élément UIA est « Tree walk » (cela peut être activé dans la page paramètres de l’inspecteur). Par défaut, cette valeur est définie sur 0 (illimité). Cette entrée est généralement utilisée pour optimiser la recherche d’éléments. |
|
|
Profondeur maximale de recherche relative
|
MaxRelativeSearchDepth | integer |
Profondeur maximale de l’arborescence relative à la recherche d’éléments enfants sous l’élément parent. Les éléments enfants directs ont une valeur de profondeur de 1. Cette entrée fonctionne uniquement si le mode de recherche d’élément UIA est « Tree walk » (cela peut être activé dans la page paramètres de l’inspecteur). Défini sur 0 pour une profondeur de recherche illimitée. Cette entrée est généralement utilisée pour optimiser la recherche d’éléments. |
|
|
Nombre maximal d’éléments enfants à rechercher par nœud
|
MaxChildElementsToSearchPerNode | integer |
Nombre maximal d’éléments enfants à rechercher sous chaque élément lors de la recherche de l’arborescence UIA pour l’élément cible. Cette entrée fonctionne uniquement si le mode de recherche d’élément UIA est « Tree walk » (cela peut être activé dans la page paramètres de l’inspecteur). Par défaut, cette valeur est définie sur 0 (illimité). Cette entrée est généralement utilisée pour optimiser la recherche d’éléments. |
|
|
Types de contrôle localisés d’élément à parcourir
|
ElementLocalizedControlTypesNotToTraverse | string |
Liste séparée par des virgules des types de contrôle localisés par des éléments UIA pour ne pas traverser (pas à pas) lors de la recherche de l’arborescence UIA pour l’élément cible. La recherche vérifie toujours si un élément individuel correspond aux critères de recherche, mais il ne recherche aucun élément enfant de cet élément si son type de contrôle localisé figure dans cette liste d’exclusions. Cette entrée fonctionne uniquement si le mode de recherche d’élément UIA est « Tree walk » (cela peut être activé dans la page paramètres de l’inspecteur). Cette entrée est généralement utilisée pour optimiser la recherche d’éléments. |
|
|
Flux de travail
|
Workflow | True | string |
Ajoutez l’expression suivante ici : workflow() |
Retours
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
Contenu Datagrid JSON
|
DataGridContentsJSON | string |
Contenu de l’élément datagrid, au format JSON. |
|
Nombre de lignes dans la table
|
NumberOfRowsInTable | integer |
Nombre de lignes dans la table de sortie si la table a été lue immédiatement. |
|
Nombre de colonnes dans la table
|
NumberOfColumnsInTable | integer |
Nombre de colonnes dans la table de sortie si la table a été lue immédiatement. |
|
Thread Id
|
ThreadId | integer |
Si cette action est exécutée en tant que thread d’agent, cette sortie contient l’ID de thread agent qui peut être utilisé pour surveiller le processus de l’action et récupérer le contenu de la grille de données une fois le thread terminé. |
Obtenir le handle d’élément parent UIA
Retourne un handle pour l’élément parent de l’élément spécifié. L’élément parent est défini comme l’élément qui se trouve au niveau suivant jusqu’à l’UIA 'tree' et est presque toujours un élément conteneur.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Handle d’élément
|
ElementHandle | True | integer |
Handle UIA pour l’élément cible. |
|
Flux de travail
|
Workflow | True | string |
Ajoutez l’expression suivante ici : workflow() |
Retours
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
Handle d’élément parent
|
ParentElementHandle | integer |
Handle UIA pour l’élément parent. |
Obtenir le handle UIA pour la fenêtre principale de l’ID de processus
Action Win32 simple et rapide qui retourne le handle pour toute fenêtre principale d’un processus (spécifiée par l’ID de processus). La fenêtre « Main » est généralement la fenêtre d’application principale : une boîte de dialogue de connexion ou une sous-fenêtre n’est généralement pas la fenêtre « Main ». Il est recommandé d’utiliser l’action « Wait for Desktop element » qui est plus puissante.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
ID du processus de recherche
|
ProcessId | True | integer |
ID du processus à attendre (tel que fourni par l’action « Exécuter le processus » dans les actions IA-Connect Environnement /Session). |
|
Flux de travail
|
Workflow | True | string |
Ajoutez l’expression suivante ici : workflow() |
Retours
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
Handle de fenêtre
|
WindowHandle | integer |
Handle UIA pour la fenêtre. Cela peut être utilisé comme entrée pour effectuer d’autres actions UIA dans cette fenêtre. |
|
Nom de l'élément
|
ElementName | string |
Nom UIA de l’élément de fenêtre. |
|
Nom de la classe d’élément
|
ElementClassName | string |
Nom de classe UIA de l’élément window. |
|
ID d’automatisation de l’élément
|
ElementAutomationId | string |
ID d’automatisation UIA de l’élément de fenêtre. |
|
Type de contrôle localisé par l’élément
|
ElementLocalizedControlType | string |
Type de contrôle localisé UIA de l’élément de fenêtre. |
Obtenir le handle UIA pour la fenêtre principale de l’élément focuss
Retourne un handle pour la fenêtre principale de l’élément UIA actuellement concentré. La fenêtre « Main » est généralement la fenêtre d’application principale : une boîte de dialogue de connexion ou une sous-fenêtre n’est généralement pas la fenêtre « Main ».
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Flux de travail
|
Workflow | True | string |
Ajoutez l’expression suivante ici : workflow() |
Retours
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
Handle de fenêtre
|
WindowHandle | integer |
Handle UIA pour la fenêtre. Cela peut être utilisé comme entrée pour effectuer d’autres actions UIA dans cette fenêtre. |
|
Nom de l'élément
|
ElementName | string |
Nom UIA de l’élément de fenêtre. |
|
Nom de la classe d’élément
|
ElementClassName | string |
Nom de classe UIA de l’élément window. |
|
ID d’automatisation de l’élément
|
ElementAutomationId | string |
ID d’automatisation UIA de l’élément de fenêtre. |
|
Type de contrôle localisé par l’élément
|
ElementLocalizedControlType | string |
Type de contrôle localisé UIA de l’élément de fenêtre. |
Obtenir le handle UIA pour la fenêtre principale du processus
Action Win32 simple et rapide qui retourne le handle pour toute fenêtre principale d’un processus (spécifiée par nom). La fenêtre « Main » est généralement la fenêtre d’application principale : une boîte de dialogue de connexion ou une sous-fenêtre n’est généralement pas la fenêtre « Main ». La fenêtre doit exister : IA-Connect n’attend pas. Il est recommandé d’utiliser l’action « Wait for Desktop element » qui est plus puissante.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Nom du processus de recherche
|
SearchProcessName | True | string |
Nom du processus à rechercher, par exemple, bloc-notes. |
|
Flux de travail
|
Workflow | True | string |
Ajoutez l’expression suivante ici : workflow() |
Retours
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
Handle de fenêtre
|
WindowHandle | integer |
Handle UIA pour la fenêtre. Cela peut être utilisé comme entrée pour effectuer d’autres actions UIA dans cette fenêtre. |
|
Nom de l'élément
|
ElementName | string |
Nom UIA de l’élément de fenêtre. |
|
Nom de la classe d’élément
|
ElementClassName | string |
Nom de classe UIA de l’élément window. |
|
ID d’automatisation de l’élément
|
ElementAutomationId | string |
ID d’automatisation UIA de l’élément de fenêtre. |
|
Type de contrôle localisé par l’élément
|
ElementLocalizedControlType | string |
Type de contrôle localisé UIA de l’élément de fenêtre. |
Obtenir le handle UIA pour la fenêtre Win32 de niveau supérieur
Action Win32 rapide qui retourne un handle UIA pour toute fenêtre Win32 de niveau supérieur qui a le nom de classe ou le titre de la fenêtre spécifié, ou vous pouvez spécifier des filtres de recherche plus avancés, y compris des caractères génériques. Une fenêtre de niveau supérieur est une fenêtre qui est connectée au bureau. Bien que cette action utilise des API Win32, elle peut détecter Windows, Java, ModernUI et Windows Web. La fenêtre doit exister, IA-Connect n’attend pas. Il est plus courant d’utiliser l’action UIA « Est-ce que l’élément de bureau UIA existe » qui est plus puissant, mais cette action Win32 s’exécute généralement plus rapidement.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Nom de la classe de recherche
|
SearchClassName | string |
Nom de la classe d’élément de la fenêtre de niveau supérieur à rechercher, par exemple « Bloc-notes ». |
|
|
Titre de la fenêtre de recherche
|
SearchWindowTitle | string |
Titre de la fenêtre de niveau supérieur à rechercher. |
|
|
ID du processus de recherche
|
SearchProcessId | integer |
ID de processus facultatif du processus propriétaire de la fenêtre (par exemple, tel que fourni par la sortie de l’action « Exécuter le processus » dans les actions IA-Connect Environnement /Session). Définissez la valeur 0 pour ne pas effectuer de recherche par ID de processus. |
|
|
Index de correspondance
|
MatchIndex | integer |
Si plusieurs éléments correspondent à la recherche, quel élément (à partir de 1) doit être mis en correspondance. Peut être utilisé conjointement avec « Trier par colonne » pour choisir l’ordre de tri correspondant. |
|
|
Filtre de recherche
|
SearchFilter | string |
Filtre avancé facultatif pour restreindre davantage la recherche à l’aide d’opérateurs conditionnels par rapport aux propriétés de fenêtre disponibles. Exemple 1 : [Width] < 200. Exemple 2 : [Title] like '*Excel' AND [IsMinimised] = False AND [IsResizeable] = True. Pour plus d’exemples, consultez la documentation. |
|
|
Trier par nom de colonne
|
SortByColumn | string |
Si plusieurs fenêtres correspondent à la recherche, cela vous permet de spécifier la propriété de fenêtre à trier par. Cette opération sera utilisée conjointement avec « Match index » pour sélectionner la fenêtre requise. Par exemple : si « Trier par nom de colonne » est [TopEdge] et « Match index » est 1, la fenêtre correspondante la plus proche du haut de l’écran est retournée. |
|
|
L’index de correspondance est croissant
|
MatchIndexAscending | boolean |
Si plusieurs fenêtres correspondent à la recherche, doit correspondre à « Faire correspondre l’index » en haut de la liste triée (true) ou en bas de la liste triée (false). |
|
|
Flux de travail
|
Workflow | True | string |
Ajoutez l’expression suivante ici : workflow() |
Retours
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
Handle de fenêtre
|
WindowHandle | integer |
Handle UIA pour la fenêtre. Cela peut être utilisé comme entrée pour effectuer d’autres actions UIA dans cette fenêtre. |
|
Nom de l'élément
|
ElementName | string |
Nom UIA de l’élément de fenêtre. |
|
Nom de la classe d’élément
|
ElementClassName | string |
Nom de classe UIA de l’élément window. |
|
ID d’automatisation de l’élément
|
ElementAutomationId | string |
ID d’automatisation UIA de l’élément de fenêtre. |
|
Type de contrôle localisé par l’élément
|
ElementLocalizedControlType | string |
Type de contrôle localisé UIA de l’élément de fenêtre. |
Obtenir le handle UIA pour le bureau
Retourne un handle pour le bureau. Il s’agit d’une action obsolète, car le handle « -2 » peut être utilisé pour faire référence à l’élément de bureau, mais aussi parce qu’il existe de nombreuses actions qui peuvent effectuer une recherche par rapport au bureau (par exemple, « attendre l’élément de bureau »).
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Flux de travail
|
Workflow | True | string |
Ajoutez l’expression suivante ici : workflow() |
Retours
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
Handle de fenêtre
|
WindowHandle | integer |
Handle UIA pour le bureau. Cela peut être utilisé comme entrée pour effectuer d’autres actions UIA dans cette fenêtre. |
|
Nom de l'élément
|
ElementName | string |
Nom UIA de l’élément de bureau. |
|
Nom de la classe d’élément
|
ElementClassName | string |
Nom de classe UIA de l’élément de bureau. |
|
ID d’automatisation de l’élément
|
ElementAutomationId | string |
ID d’automatisation UIA de l’élément de bureau. |
|
Type de contrôle localisé par l’élément
|
ElementLocalizedControlType | string |
Type de contrôle localisé UIA de l’élément de bureau. |
Obtenir le handle UIA pour l’élément focussed
Retourne un handle pour l’élément UIA actuellement ciblé.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Flux de travail
|
Workflow | True | string |
Ajoutez l’expression suivante ici : workflow() |
Retours
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
Handle de fenêtre
|
WindowHandle | integer |
Handle UIA pour la fenêtre. Cela peut être utilisé comme entrée pour effectuer d’autres actions UIA dans cette fenêtre. |
|
Nom de l'élément
|
ElementName | string |
Nom UIA de l’élément. |
|
Nom de la classe d’élément
|
ElementClassName | string |
Nom de classe UIA de l’élément. |
|
ID d’automatisation de l’élément
|
ElementAutomationId | string |
ID d’automatisation UIA de l’élément. |
|
Type de contrôle localisé par l’élément
|
ElementLocalizedControlType | string |
Type de contrôle localisé UIA de l’élément. |
Obtenir le mode de recherche d’élément UIA
Récupère le mode de recherche d’élément UIA utilisé par l’agent IA-Connect pour les actions UIA.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Flux de travail
|
Workflow | True | string |
Ajoutez l’expression suivante ici : workflow() |
Retours
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
Mode de recherche d’élément UIA
|
UIAElementSearchMode | string |
Mode de recherche d’élément UIA actuel utilisé par l’agent IA-Connect. |
Obtenir les fenêtres Win32
Action Win32 rapide qui retourne une liste de toutes les fenêtres Win32 qui ont éventuellement le nom de classe ou le titre de la fenêtre spécifié, ou vous pouvez spécifier des filtres de recherche plus avancés, y compris des caractères génériques. Bien que cette action utilise des API Win32, elle peut détecter Windows, Java, ModernUI et Windows Web. Win32 Windows peut inclure des éléments inattendus, notamment la barre des tâches, le bureau, le menu Démarrer, les superpositions transparentes, les fenêtres hors écran ou masquées, de sorte que la liste retournée peut contenir plus de résultats que prévu.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Nom de la classe de recherche
|
SearchClassName | string |
Nom de classe facultatif de la fenêtre de niveau supérieur à rechercher, par exemple « Chrome_WidgetWin_1 ». |
|
|
Titre de la fenêtre de recherche
|
SearchWindowTitle | string |
Titre facultatif de la fenêtre de niveau supérieur à rechercher. |
|
|
Récupérer uniquement les fenêtres de niveau supérieur
|
TopLevelWindowsOnly | boolean |
Définissez la valeur true pour récupérer uniquement les fenêtres Win32 que le système d’exploitation considère comme de niveau supérieur. Définissez la valeur false pour récupérer toutes les fenêtres Win32. Notez que la définition Win32 d’une fenêtre inclut des éléments que vous risquez de ne pas reconnaître en tant que fenêtre et de nombreuses boîtes de dialogue et boîtes de message sont marquées comme de niveau supérieur, même si elles sont un enfant d’une fenêtre parente. |
|
|
Récupérer uniquement les fenêtres visibles
|
VisibleWindowsOnly | boolean |
Définissez la valeur true pour récupérer uniquement les fenêtres Win32 que le système d’exploitation considère comme visibles. Définissez la valeur false pour récupérer les fenêtres Win32 visibles et non visibles. Notez que les fenêtres hors écran ou transparentes peuvent être marquées comme visibles, mais vous ne pouvez pas les voir. |
|
|
Récupérer uniquement des fenêtres avec une barre de titre
|
WindowsWithTitlebarOnly | boolean |
Définissez la valeur true pour récupérer uniquement les fenêtres Win32 avec une barre de titre. Définissez la valeur false pour récupérer les fenêtres Win32, qu’elles aient ou non une barre de titre. Notez que certaines fenêtres transparentes ont des barres de titre, mais vous ne pouvez pas les voir. |
|
|
Récupérer uniquement des fenêtres avec un titre
|
WindowsWithTitleOnly | boolean |
Définissez la valeur true pour récupérer uniquement les fenêtres Win32 avec un titre (c’est-à-dire une barre de titre contenant du texte). Définissez la valeur false pour récupérer les fenêtres Win32, qu’elles aient un titre ou non. Notez que la barre de titre est la bande située en haut de la fenêtre, tandis que le titre est le texte qu’il contient. |
|
|
Ignorer les fenêtres transparentes
|
IgnoreTransparentWindows | boolean |
Définissez la valeur true pour récupérer uniquement les fenêtres Win32 qui n’ont pas de transparence. Définissez la valeur false pour récupérer les fenêtres Win32, qu’elles aient ou non un ensemble de transparence. |
|
|
ID du processus de recherche
|
SearchProcessId | integer |
ID de processus facultatif du processus qui possède les fenêtres (par exemple, comme indiqué par la sortie de l’action « Exécuter le processus » dans les actions IA-Connect Environnement /Session). Définissez la valeur 0 pour ne pas effectuer de recherche par ID de processus. |
|
|
Filtre de recherche
|
SearchFilter | string |
Filtre avancé facultatif pour restreindre davantage la recherche à l’aide d’opérateurs conditionnels et de tout champ d’élément. Exemple 1 : [Width] < 200. Exemple 2 : [Title] like '*Excel' AND [IsMinimised] = False AND [IsResizeable] = True. Pour plus d’exemples, consultez la documentation. |
|
|
Trier par nom de colonne
|
SortByColumn | string |
Si plusieurs fenêtres correspondent à la recherche, cela vous permet de spécifier la propriété de fenêtre à trier par. Par exemple : si « Trier par nom de colonne » est [TopEdge], la liste des fenêtres est retournée par bord supérieur. Si ce champ est vide, les fenêtres sont retournées dans l’ordre dans lequel elles sont détectées. |
|
|
L’index de correspondance est croissant
|
MatchIndexAscending | boolean |
Si plusieurs fenêtres correspondent à la recherche et qu’une colonne de tri est spécifiée, définissez la valeur true (par défaut) pour trier croissant ou définir la valeur false pour trier l’ordre décroissant. |
|
|
Retour du handle d’élément UIA
|
ReturnElementHandle | boolean |
Si la valeur est true, un handle UIA pour chaque fenêtre Win32 située est retourné dans la collection de sorties (dans la colonne « UIAHandle »). Ce handle peut être utilisé dans d’autres actions pour agir en tant que handle « parent » dans IA-Connect actions UIA. |
|
|
Premier élément à retourner
|
FirstItemToReturn | integer |
Index de la première fenêtre (ligne) à retourner, à partir de 1. |
|
|
Nombre maximal d’éléments à retourner
|
MaxItemsToReturn | integer |
Nombre maximal de fenêtres à retourner, ou 0 pour renvoyer tous les éléments. |
|
|
Flux de travail
|
Workflow | True | string |
Ajoutez l’expression suivante ici : workflow() |
Retours
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
Win32 windows JSON
|
Win32WindowsJSON | string |
Liste des fenêtres Win32 correspondant aux critères de recherche, au format JSON. |
|
Nombre de fenêtres Win32
|
NumberOfWin32Windows | integer |
Nombre de fenêtres Win32 retournées. |
Obtenir les propriétés de l’élément datagrid UIA
Retourne les propriétés de table d’un élément DataGrid. Il s’agit d’un élément avec des lignes, des colonnes, des en-têtes et des cellules (par exemple, un tableau).
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Handle de fenêtre parent
|
ParentWindowHandle | True | integer |
Handle de fenêtre UIA parent (valeur 1 ou supérieure) pour agir comme point de départ de la recherche. Vous pouvez le découvrir via Inspection à l’aide d’actions telles que « Wait for desktop element » ou « Wait for element ». |
|
Nom de l’élément de recherche
|
SearchElementName | string |
Nom d’élément UIA facultatif à rechercher (à partir du handle de fenêtre parent). Cela peut être découvert par le biais de l’inspection. |
|
|
Nom de la classe d’élément Search
|
SearchElementClassName | string |
Nom de classe d’élément UIA facultatif à rechercher (à partir du handle de fenêtre parent). Cela peut être découvert par le biais de l’inspection. |
|
|
ID d’automatisation de l’élément de recherche
|
SearchElementAutomationId | string |
ID d’automatisation d’élément UIA facultatif à rechercher (à partir du handle de fenêtre parent). Cela peut être découvert par le biais de l’inspection. |
|
|
Type de contrôle localisé de l’élément de recherche
|
SearchLocalizedControlType | string |
Type de contrôle localisé de l’élément UIA facultatif à rechercher (à partir du handle de fenêtre parent). Cela peut être découvert par le biais de l’inspection. |
|
|
Rechercher une sous-arborescence UIA
|
SearchSubTree | boolean |
Si la valeur est true, l’arborescence UIA entière située sous le handle de fenêtre parent est recherchée. Cela est plus approfondi, mais peut prendre plus de temps. Si la valeur est false, seuls les éléments directement sous le handle de fenêtre parent dans l’arborescence UIA sont recherchés. |
|
|
Autre nom de ligne d’en-tête
|
AlternativeHeaderRowName | string |
Par défaut, la ligne d’en-tête d’un DataGrid porte le nom UIA « Top Row ». Si la ligne d’en-tête a un nom différent, spécifiez ce nom ici. |
|
|
Index de correspondance
|
MatchIndex | integer |
Si plusieurs éléments correspondent à la recherche, quel élément (à partir de 1) doit être mis en correspondance. Peut être utilisé conjointement avec « Trier par colonne » pour choisir l’ordre de tri correspondant. |
|
|
Filtre de recherche
|
SearchFilter | string |
Filtre avancé facultatif pour restreindre davantage la recherche à l’aide d’opérateurs conditionnels et de tout champ d’élément. Exemple 1 : [Width] < 200. Exemple 2 : [Name] like 'Document*' AND [ClassName] like 'Label*'. Pour plus d’exemples, consultez la documentation. |
|
|
Trier par nom de colonne
|
SortByColumn | string |
Si plusieurs éléments correspondent à la recherche, cela vous permet de spécifier la propriété d’élément à trier par. Cela sera utilisé conjointement avec « Match index » pour sélectionner l’élément requis. Par exemple : si « Trier par nom de colonne » est [TopEdge] et « Match index » est 1, l’élément correspondant le plus proche du haut de l’écran est mis en correspondance. |
|
|
L’index de correspondance est croissant
|
MatchIndexAscending | boolean |
Si plusieurs éléments correspondent à la recherche, doit correspondre à « Faire correspondre l’index » en haut de la liste triée (true) ou en bas de la liste triée (false). |
|
|
Nombre maximal d’éléments à rechercher
|
MaxElementsToSearch | integer |
Nombre maximal d’éléments à rechercher lors de la recherche de l’élément cible dans l’arborescence UIA. Cette entrée fonctionne uniquement si le mode de recherche d’élément UIA est « Tree walk » (cela peut être activé dans la page paramètres de l’inspecteur). Par défaut, cette valeur est définie sur 0 (illimité). Cette entrée est généralement utilisée pour optimiser la recherche d’éléments. |
|
|
Profondeur maximale de recherche relative
|
MaxRelativeSearchDepth | integer |
Profondeur maximale de l’arborescence relative à la recherche d’éléments enfants sous l’élément parent. Les éléments enfants directs ont une valeur de profondeur de 1. Cette entrée fonctionne uniquement si le mode de recherche d’élément UIA est « Tree walk » (cela peut être activé dans la page paramètres de l’inspecteur). Défini sur 0 pour une profondeur de recherche illimitée. Cette entrée est généralement utilisée pour optimiser la recherche d’éléments. |
|
|
Nombre maximal d’éléments enfants à rechercher par nœud
|
MaxChildElementsToSearchPerNode | integer |
Nombre maximal d’éléments enfants à rechercher sous chaque élément lors de la recherche de l’arborescence UIA pour l’élément cible. Cette entrée fonctionne uniquement si le mode de recherche d’élément UIA est « Tree walk » (cela peut être activé dans la page paramètres de l’inspecteur). Par défaut, cette valeur est définie sur 0 (illimité). Cette entrée est généralement utilisée pour optimiser la recherche d’éléments. |
|
|
Types de contrôle localisés d’élément à parcourir
|
ElementLocalizedControlTypesNotToTraverse | string |
Liste séparée par des virgules des types de contrôle localisés par des éléments UIA pour ne pas traverser (pas à pas) lors de la recherche de l’arborescence UIA pour l’élément cible. La recherche vérifie toujours si un élément individuel correspond aux critères de recherche, mais il ne recherche aucun élément enfant de cet élément si son type de contrôle localisé figure dans cette liste d’exclusions. Cette entrée fonctionne uniquement si le mode de recherche d’élément UIA est « Tree walk » (cela peut être activé dans la page paramètres de l’inspecteur). Cette entrée est généralement utilisée pour optimiser la recherche d’éléments. |
|
|
Flux de travail
|
Workflow | True | string |
Ajoutez l’expression suivante ici : workflow() |
Retours
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
Nombre de colonnes
|
NumberOfColumns | integer |
Nombre de colonnes dans la grille de données. |
|
Nombre de colonnes visibles
|
NumberOfVisibleColumns | integer |
Nombre de colonnes visibles dans le datagrid. |
|
Nombre de lignes
|
NumberOfRows | integer |
Nombre de lignes dans le datagrid. |
|
Nombre de lignes visibles
|
NumberOfVisibleRows | integer |
Nombre de lignes visibles dans le datagrid. |
|
Première ligne visible
|
FirstVisibleRow | integer |
Index de la première ligne visible dans le datagrid. |
|
Dernière ligne visible
|
LastVisibleRow | integer |
Index de la dernière ligne visible dans le datagrid. |
|
Nombre de barres de défilement
|
NumberOfScrollbars | integer |
Nombre de barres de défilement dont dispose le datagrid. |
|
Noms de barre de défilement
|
ScrollbarNames | string |
Liste séparée par des virgules des noms des barres de défilement (par exemple, Horizontal, Vertical). |
Obtenir les propriétés d’élément UIA
Retourne toutes les propriétés d’un élément. Cela peut être utile si vous ne savez pas quel champ contient les valeurs de propriété requises.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Handle de fenêtre parent
|
ParentWindowHandle | True | integer |
Handle de fenêtre UIA parent (valeur 1 ou supérieure) pour agir comme point de départ de la recherche. Vous pouvez le découvrir via Inspection à l’aide d’actions telles que « Wait for desktop element » ou « Wait for element ». |
|
Nom de l’élément de recherche
|
SearchElementName | string |
Nom d’élément UIA facultatif à rechercher (à partir du handle de fenêtre parent). Cela peut être découvert par le biais de l’inspection. |
|
|
Nom de la classe d’élément Search
|
SearchElementClassName | string |
Nom de classe d’élément UIA facultatif à rechercher (à partir du handle de fenêtre parent). Cela peut être découvert par le biais de l’inspection. |
|
|
ID d’automatisation de l’élément de recherche
|
SearchElementAutomationId | string |
ID d’automatisation d’élément UIA facultatif à rechercher (à partir du handle de fenêtre parent). Cela peut être découvert par le biais de l’inspection. |
|
|
Type de contrôle localisé de l’élément de recherche
|
SearchLocalizedControlType | string |
Type de contrôle localisé de l’élément UIA facultatif à rechercher (à partir du handle de fenêtre parent). Cela peut être découvert par le biais de l’inspection. |
|
|
Rechercher une sous-arborescence UIA
|
SearchSubTree | boolean |
Si la valeur est true, l’arborescence UIA entière située sous le handle de fenêtre parent est recherchée. Cela est plus approfondi, mais peut prendre plus de temps. Si la valeur est false, seuls les éléments directement sous le handle de fenêtre parent dans l’arborescence UIA sont recherchés. |
|
|
Handle d’élément de retour
|
ReturnElementHandle | boolean |
Si la valeur est true, un handle sur l’élément situé est retourné. Ce handle peut être utilisé dans d’autres actions pour agir en tant que handle « parent ». |
|
|
Valeur de l’élément Return
|
ReturnElementValue | boolean |
Si la valeur est true par rapport à la valeur de l’élément situé, elle est retournée. |
|
|
Index de correspondance
|
MatchIndex | integer |
Si plusieurs éléments correspondent à la recherche, quel élément (à partir de 1) doit être mis en correspondance. Peut être utilisé conjointement avec « Trier par colonne » pour choisir l’ordre de tri correspondant. |
|
|
Filtre de recherche
|
SearchFilter | string |
Filtre avancé facultatif pour restreindre davantage la recherche à l’aide d’opérateurs conditionnels et de tout champ d’élément. Exemple 1 : [Width] < 200. Exemple 2 : [Name] like 'Document*' AND [ClassName] like 'Label*'. Pour plus d’exemples, consultez la documentation. |
|
|
Trier par nom de colonne
|
SortByColumn | string |
Si plusieurs éléments correspondent à la recherche, cela vous permet de spécifier la propriété d’élément à trier par. Cela sera utilisé conjointement avec « Match index » pour sélectionner l’élément requis. Par exemple : si « Trier par nom de colonne » est [TopEdge] et « Match index » est 1, l’élément correspondant le plus proche du haut de l’écran est mis en correspondance. |
|
|
L’index de correspondance est croissant
|
MatchIndexAscending | boolean |
Si plusieurs éléments correspondent à la recherche, doit correspondre à « Faire correspondre l’index » en haut de la liste triée (true) ou en bas de la liste triée (false). |
|
|
Nombre maximal d’éléments à rechercher
|
MaxElementsToSearch | integer |
Nombre maximal d’éléments à rechercher lors de la recherche de l’élément cible dans l’arborescence UIA. Cette entrée fonctionne uniquement si le mode de recherche d’élément UIA est « Tree walk » (cela peut être activé dans la page paramètres de l’inspecteur). Par défaut, cette valeur est définie sur 0 (illimité). Cette entrée est généralement utilisée pour optimiser la recherche d’éléments. |
|
|
Profondeur maximale de recherche relative
|
MaxRelativeSearchDepth | integer |
Profondeur maximale de l’arborescence relative à la recherche d’éléments enfants sous l’élément parent. Les éléments enfants directs ont une valeur de profondeur de 1. Cette entrée fonctionne uniquement si le mode de recherche d’élément UIA est « Tree walk » (cela peut être activé dans la page paramètres de l’inspecteur). Défini sur 0 pour une profondeur de recherche illimitée. Cette entrée est généralement utilisée pour optimiser la recherche d’éléments. |
|
|
Nombre maximal d’éléments enfants à rechercher par nœud
|
MaxChildElementsToSearchPerNode | integer |
Nombre maximal d’éléments enfants à rechercher sous chaque élément lors de la recherche de l’arborescence UIA pour l’élément cible. Cette entrée fonctionne uniquement si le mode de recherche d’élément UIA est « Tree walk » (cela peut être activé dans la page paramètres de l’inspecteur). Par défaut, cette valeur est définie sur 0 (illimité). Cette entrée est généralement utilisée pour optimiser la recherche d’éléments. |
|
|
Types de contrôle localisés d’élément à parcourir
|
ElementLocalizedControlTypesNotToTraverse | string |
Liste séparée par des virgules des types de contrôle localisés par des éléments UIA pour ne pas traverser (pas à pas) lors de la recherche de l’arborescence UIA pour l’élément cible. La recherche vérifie toujours si un élément individuel correspond aux critères de recherche, mais il ne recherche aucun élément enfant de cet élément si son type de contrôle localisé figure dans cette liste d’exclusions. Cette entrée fonctionne uniquement si le mode de recherche d’élément UIA est « Tree walk » (cela peut être activé dans la page paramètres de l’inspecteur). Cette entrée est généralement utilisée pour optimiser la recherche d’éléments. |
|
|
Valider le point cliquable dans la limite de l’élément
|
ValidateClickablePointWithinElementBoundary | boolean |
Pour certains éléments, UIA n’a pas connaissance d’un point cliquable dans l’élément et retourne une coordonnée non valide (par exemple 0,0) au lieu du centre de l’élément. Si cette entrée est définie sur true, IA-Connect vérifie la validité de la coordonnée fournie par UIA et, si elle n’est pas comprise dans la limite de l’élément, ignore la valeur fournie par UIA et utilise le centre de l’élément à la place. |
|
|
Flux de travail
|
Workflow | True | string |
Ajoutez l’expression suivante ici : workflow() |
Retours
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
Nom de l'élément
|
ElementName | string |
Nom UIA de l’élément. |
|
Nom de la classe d’élément
|
ElementClassName | string |
Nom de classe UIA de l’élément. |
|
ID d’automatisation de l’élément
|
ElementAutomationId | string |
ID d’automatisation UIA de l’élément. |
|
ID d’infrastructure d’élément
|
ElementFrameworkId | string |
ID de framework UIA de l’élément. |
|
Type de contrôle d’élément
|
ElementControlType | string |
Type de contrôle UIA sous forme de nombre. Ceci est similaire au type de contrôle localisé, mais n’est pas spécifique à la langue. |
|
Type de contrôle localisé par l’élément
|
ElementLocalizedControlType | string |
Type de contrôle localisé UIA de l’élément. |
|
L’élément est activé
|
ElementIsEnabled | boolean |
Retourne si l’élément est activé ou non. |
|
L’élément est hors écran
|
ElementIsOffscreen | boolean |
Retourne si l’élément est hors écran ou non. |
|
L’élément est focusable au clavier
|
ElementIsKeyboardFocusable | boolean |
Retourne si l’élément peut être concentré par le clavier. |
|
L’élément a le focus clavier
|
ElementHasKeyboardFocus | boolean |
Retourne si l’élément possède actuellement le focus clavier. |
|
L’élément est un champ de mot de passe
|
ElementIsPasswordField | boolean |
Retourne si un élément est un champ d’entrée de mot de passe. |
|
Touche d’accélérateur d’élément
|
ElementAcceleratorKey | string |
Retourne la touche d’accès rapide qui peut être enfoncée pour activer l’élément. |
|
Clé d’accès à l’élément
|
ElementAccessKey | string |
Retourne la touche d’accès rapide qui peut être enfoncée pour activer un élément de menu. |
|
Bord gauche de l’élément
|
ElementLeftEdge | integer |
Distance en pixels entre le bord gauche de l’élément ou de la fenêtre et le bord gauche de l’affichage. |
|
Bord droit de l’élément
|
ElementRightEdge | integer |
Distance en pixels entre le bord droit de l’élément ou de la fenêtre et le bord gauche de l’affichage. |
|
Bord supérieur de l’élément
|
ElementTopEdge | integer |
Distance en pixels entre le bord supérieur de l’élément ou de la fenêtre et le bord supérieur de l’affichage. |
|
Bord inférieur de l’élément
|
ElementBottomEdge | integer |
Distance en pixels entre le bord inférieur de l’élément ou de la fenêtre et le bord supérieur de l’affichage. |
|
Point cliquable de l’élément X
|
ElementClickablePointX | integer |
Coordonnée X en pixels d’un point cliquable central dans l’élément par rapport au bord gauche de l’affichage tel qu’il est retourné par l’application sous-jacente. |
|
Point cliquable de l’élément Y
|
ElementClickablePointY | integer |
Coordonnée Y en pixels d’un point cliquable central dans l’élément par rapport au bord supérieur de l’affichage tel qu’il est retourné par l’application sous-jacente. |
|
ID de processus d’élément
|
ElementProcessId | integer |
ID de processus (PID) du processus qui possède cet élément. |
|
Handle d’élément
|
ElementHandle | integer |
Si l’entrée « Return element handle » a été définie sur true, cela contiendra un handle d’élément numérique qui peut être utilisé dans d’autres actions pour agir en tant que handle « parent » pour d’autres actions. |
|
Valeur de l’élément
|
ElementValue | string |
Si l’entrée « Valeur de l’élément Return » a été définie sur true et si l’élément a un modèle de valeur, cela contiendra cette valeur. |
|
Valeur de texte de l’élément
|
ElementTextValue | string |
Si l’entrée « Return element value » a été définie sur true et si l’élément a un modèle de valeur de texte, cela contiendra cette valeur de texte. |
Obtenir les propriétés d’élément UIA en tant que liste
Retourne les propriétés d’un élément en tant que liste de lignes unique (collection de lignes unique /table de données) au lieu d’éléments individuels, cela peut être utile en fonction de la façon dont vous envisagez d’utiliser les données.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Handle d’élément
|
ElementHandle | True | integer |
Handle UIA pour l’élément cible. |
|
Flux de travail
|
Workflow | True | string |
Ajoutez l’expression suivante ici : workflow() |
Retours
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
Nombre d’éléments trouvés
|
NumberOfElementsFound | integer |
Nombre d’éléments trouvés. |
|
Nombre d’éléments retournés
|
NumberOfElementsReturned | integer |
Nombre d’éléments retournés. |
|
Propriétés d’élément UIA JSON
|
UIAElementPropertiesJSON | string |
Propriétés UIA de l’élément, au format JSON. |
Obtenir les éléments d’élément de liste UIA
Retourne une liste d’éléments enfants trouvés sous l’élément spécifié (généralement les éléments déroulants/de menu).
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Handle de fenêtre parent
|
ParentWindowHandle | True | integer |
Handle de fenêtre UIA parent (valeur 1 ou supérieure) pour agir comme point de départ de la recherche. Vous pouvez le découvrir via Inspection à l’aide d’actions telles que « Wait for desktop element » ou « Wait for element ». |
|
Nom de l’élément de recherche
|
SearchElementName | string |
Nom d’élément UIA facultatif à rechercher (à partir du handle de fenêtre parent). Cela peut être découvert par le biais de l’inspection. |
|
|
Nom de la classe d’élément Search
|
SearchElementClassName | string |
Nom de classe d’élément UIA facultatif à rechercher (à partir du handle de fenêtre parent). Cela peut être découvert par le biais de l’inspection. |
|
|
ID d’automatisation de l’élément de recherche
|
SearchElementAutomationId | string |
ID d’automatisation d’élément UIA facultatif à rechercher (à partir du handle de fenêtre parent). Cela peut être découvert par le biais de l’inspection. |
|
|
Type de contrôle localisé de l’élément de recherche
|
SearchLocalizedControlType | string |
Type de contrôle localisé de l’élément UIA facultatif à rechercher (à partir du handle de fenêtre parent). Cela peut être découvert par le biais de l’inspection. |
|
|
Rechercher une sous-arborescence UIA
|
SearchSubTree | boolean |
Si la valeur est true, l’arborescence UIA entière située sous le handle de fenêtre parent est recherchée. Cela est plus approfondi, mais peut prendre plus de temps. Si la valeur est false, seuls les éléments directement sous le handle de fenêtre parent dans l’arborescence UIA sont recherchés. |
|
|
Développer en premier
|
ExpandFirst | boolean |
Si la valeur est true, IA-Connect tente de développer la liste avant de rechercher les éléments d’élément de liste. Cela est utile pour les listes dynamiques, car les éléments d’élément de liste peuvent ne pas être créés tant que la liste n’est pas développée. |
|
|
Réduire après
|
CollapseAfter | boolean |
Si la valeur est true, la liste est réduite après l’exécution de la recherche. |
|
|
Rechercher les éléments sélectionnés
|
CheckForSelectedItems | boolean |
Si la valeur est true, la collection de sorties contient une propriété supplémentaire indiquant si l’élément de liste est actuellement sélectionné. |
|
|
Secondes entre développer et réduire
|
SecondsBetweenExpandCollapse | double |
Nombre de secondes à attendre entre les actions de développement et de réduction si celles-ci sont définies sur true. |
|
|
Index de correspondance
|
MatchIndex | integer |
Si plusieurs éléments correspondent à la recherche, quel élément (à partir de 1) doit être mis en correspondance. Peut être utilisé conjointement avec « Trier par colonne » pour choisir l’ordre de tri correspondant. |
|
|
Filtre de recherche
|
SearchFilter | string |
Filtre avancé facultatif pour restreindre davantage la recherche à l’aide d’opérateurs conditionnels et de tout champ d’élément. Exemple 1 : [Width] < 200. Exemple 2 : [Name] like 'Document*' AND [ClassName] like 'Label*'. Pour plus d’exemples, consultez la documentation. |
|
|
Trier par nom de colonne
|
SortByColumn | string |
Si plusieurs éléments correspondent à la recherche, cela vous permet de spécifier la propriété d’élément à trier par. Cela sera utilisé conjointement avec « Match index » pour sélectionner l’élément requis. Par exemple : si « Trier par nom de colonne » est [TopEdge] et « Match index » est 1, l’élément correspondant le plus proche du haut de l’écran est mis en correspondance. |
|
|
L’index de correspondance est croissant
|
MatchIndexAscending | boolean |
Si plusieurs éléments correspondent à la recherche, doit correspondre à « Faire correspondre l’index » en haut de la liste triée (true) ou en bas de la liste triée (false). |
|
|
Nombre maximal d’éléments à rechercher
|
MaxElementsToSearch | integer |
Nombre maximal d’éléments à rechercher lors de la recherche de l’élément cible dans l’arborescence UIA. Cette entrée fonctionne uniquement si le mode de recherche d’élément UIA est « Tree walk » (cela peut être activé dans la page paramètres de l’inspecteur). Par défaut, cette valeur est définie sur 0 (illimité). Cette entrée est généralement utilisée pour optimiser la recherche d’éléments. |
|
|
Profondeur maximale de recherche relative
|
MaxRelativeSearchDepth | integer |
Profondeur maximale de l’arborescence relative à la recherche d’éléments enfants sous l’élément parent. Les éléments enfants directs ont une valeur de profondeur de 1. Cette entrée fonctionne uniquement si le mode de recherche d’élément UIA est « Tree walk » (cela peut être activé dans la page paramètres de l’inspecteur). Défini sur 0 pour une profondeur de recherche illimitée. Cette entrée est généralement utilisée pour optimiser la recherche d’éléments. |
|
|
Nombre maximal d’éléments enfants à rechercher par nœud
|
MaxChildElementsToSearchPerNode | integer |
Nombre maximal d’éléments enfants à rechercher sous chaque élément lors de la recherche de l’arborescence UIA pour l’élément cible. Cette entrée fonctionne uniquement si le mode de recherche d’élément UIA est « Tree walk » (cela peut être activé dans la page paramètres de l’inspecteur). Par défaut, cette valeur est définie sur 0 (illimité). Cette entrée est généralement utilisée pour optimiser la recherche d’éléments. |
|
|
Types de contrôle localisés d’élément à parcourir
|
ElementLocalizedControlTypesNotToTraverse | string |
Liste séparée par des virgules des types de contrôle localisés par des éléments UIA pour ne pas traverser (pas à pas) lors de la recherche de l’arborescence UIA pour l’élément cible. La recherche vérifie toujours si un élément individuel correspond aux critères de recherche, mais il ne recherche aucun élément enfant de cet élément si son type de contrôle localisé figure dans cette liste d’exclusions. Cette entrée fonctionne uniquement si le mode de recherche d’élément UIA est « Tree walk » (cela peut être activé dans la page paramètres de l’inspecteur). Cette entrée est généralement utilisée pour optimiser la recherche d’éléments. |
|
|
Flux de travail
|
Workflow | True | string |
Ajoutez l’expression suivante ici : workflow() |
Retours
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
Nombre d’éléments de liste
|
NumberOfListItems | integer |
Nombre d’éléments de la liste. |
|
Éléments de liste JSON
|
ListItemsJSON | string |
Propriétés des éléments de la liste, au format JSON. |
|
Nombre d’éléments sélectionnés
|
NumberOfSelectedItems | integer |
Nombre d’éléments sélectionnés dans la liste. |
|
Index du premier élément sélectionné
|
IndexOfFirstSelectedItem | integer |
Index dans la liste du premier élément sélectionné. |
|
Nom de l’élément sélectionné
|
SelectedItemName | string |
Nom de l’élément sélectionné. |
Obtenir l’élément UIA aux coordonnées de l’écran
Retourne l’élément UIA situé aux coordonnées de l’écran donnée.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Coordonnée X
|
XCoord | integer |
Valeur de coordonnée X de l’écran (en pixels) où l’élément UIA doit être recherché. |
|
|
Coordonnée Y
|
YCoord | integer |
Valeur de coordonnée Y de l’écran (en pixels) où l’élément UIA doit être recherché. |
|
|
Déclencher une exception si l’élément est introuvable
|
RaiseExceptionIfElementNotFound | boolean |
Doit-il IA-Connect déclencher une exception si un élément UIA n’était pas situé à l’emplacement spécifié ? |
|
|
Flux de travail
|
Workflow | True | string |
Ajoutez l’expression suivante ici : workflow() |
Retours
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
Élément trouvé
|
ElementFound | boolean |
Retourne true si un élément UIA a été trouvé à l’emplacement spécifié. |
|
Handle d’élément
|
ElementHandle | integer |
Handle UIA pour l’élément. Cela peut être utilisé comme entrée pour d’autres actions UIA agissant sur cet élément. |
|
Nom de l'élément
|
ElementName | string |
Nom UIA de l’élément. |
|
Nom de la classe d’élément
|
ElementClassName | string |
Nom de classe UIA de l’élément. |
|
ID d’automatisation de l’élément
|
ElementAutomationId | string |
ID d’automatisation UIA de l’élément. |
|
Type de contrôle localisé par l’élément
|
ElementLocalizedControlType | string |
Type de contrôle localisé UIA de l’élément. |
Obtenir plusieurs propriétés d’élément parent UIA
Retourne une arborescence hiérarchique des éléments parents de l’élément spécifié, jusqu’au bureau (niveau racine). L’élément parent est défini comme l’élément qui se trouve au niveau suivant jusqu’à l’UIA 'tree' et est presque toujours un élément conteneur.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Handle d’élément
|
ElementHandle | True | integer |
Handle UIA pour l’élément cible. |
|
Nombre maximal de parents à traiter
|
MaxParentsToProcess | integer |
Nombre maximal d’éléments parents à traiter. Par défaut, cette valeur est définie sur 50. |
|
|
Flux de travail
|
Workflow | True | string |
Ajoutez l’expression suivante ici : workflow() |
Retours
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
Éléments parents UIA
|
UIAParentElements | array of object |
Liste de tous les éléments parents situés (et de leurs propriétés). Les propriétés retournées sont identiques à celles retournées par l’action « Obtenir plusieurs propriétés d’élément ». |
|
items
|
UIAParentElements | object | |
|
Nombre d’éléments parents retournés
|
NumberOfParentElementsReturned | integer |
Nombre d’éléments parents retournés par la recherche. |
Obtenir plusieurs propriétés d’élément UIA
Retourne les propriétés de plusieurs éléments. Cela peut être utile si vous ne savez pas quels champs contiennent les valeurs de propriété requises.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Handle de fenêtre parent
|
ParentWindowHandle | True | integer |
Handle de fenêtre UIA parent (valeur 1 ou supérieure) pour agir comme point de départ de la recherche. Vous pouvez le découvrir via Inspection à l’aide d’actions telles que « Wait for desktop element » ou « Wait for element ». |
|
Type de contrôle localisé de l’élément de recherche
|
SearchElementLocalizedControlType | string |
Type de contrôle localisé de l’élément UIA facultatif à rechercher (à partir du handle de fenêtre parent). Cela peut être découvert par le biais de l’inspection. |
|
|
Rechercher des descendants
|
SearchDescendants | boolean |
Si la valeur est true, l’arborescence UIA entière située sous le handle de fenêtre parent est recherchée. Cela est plus approfondi, mais peut prendre plus de temps. Si la valeur est false, seuls les éléments directement sous le handle de fenêtre parent dans l’arborescence UIA sont recherchés. |
|
|
Handle d’élément de retour
|
ReturnElementHandle | boolean |
Si la valeur est true, un handle sur l’élément situé est retourné. Ce handle peut être utilisé dans d’autres actions pour agir en tant que handle « parent ». |
|
|
Valeur de l’élément Return
|
ReturnElementValue | boolean |
Si la valeur est true par rapport à la valeur de l’élément situé, elle est retournée. |
|
|
Premier élément à retourner
|
FirstItemToReturn | integer |
Index d’élément du premier élément à retourner, à partir de 1. Si vous souhaitez renvoyer les éléments dans l’ordre inverse (à partir du bas de l’arborescence UIA), vous pouvez également spécifier un index négatif à partir de -1. |
|
|
Nombre maximal d’éléments à retourner
|
MaxItemsToReturn | integer |
Nombre maximal d’éléments à retourner, ou 0 pour renvoyer tous les éléments. |
|
|
Flux de travail
|
Workflow | True | string |
Ajoutez l’expression suivante ici : workflow() |
Retours
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
Nombre d’éléments trouvés
|
NumberOfElementsFound | integer |
Nombre d’éléments trouvés qui correspondent aux critères de recherche. |
|
Nombre d’éléments retournés
|
NumberOfElementsReturned | integer |
Nombre d’éléments retournés (cela peut être inférieur au nombre d’éléments trouvé si vous spécifiez un nombre maximal d’éléments à retourner). |
|
Propriétés de l’élément
|
ElementProperties | array of object |
Propriétés d’élément des éléments trouvées qui correspondent aux critères de recherche. |
|
items
|
ElementProperties | object |
Obtenir plusieurs éléments UIA en tant que table
Énumère les valeurs des éléments enfants d’un élément parent spécifié et retourne dans un format de tableau. Cela peut être utilisé pour renvoyer des lignes et des colonnes de données à partir d’éléments qui ne sont pas techniquesment des tables, mais qui ont été organisées ensemble dans une structure de table. Cette action peut également être utilisée pour récupérer les résultats d’une exécution précédente de cette action, exécutée en tant que thread Agent.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Handle de fenêtre parent
|
ParentWindowHandle | integer |
Handle de fenêtre UIA parent (valeur 1 ou supérieure) pour agir comme point de départ de la recherche. Vous pouvez le découvrir via Inspection à l’aide d’actions telles que « Wait for desktop element » ou « Wait for element ». |
|
|
Nom de l’élément de recherche
|
SearchElementName | string |
Nom d’élément UIA facultatif à rechercher (à partir du handle de fenêtre parent). Cela peut être découvert par le biais de l’inspection. |
|
|
Nom de la classe d’élément Search
|
SearchElementClassName | string |
Nom de classe d’élément UIA facultatif à rechercher (à partir du handle de fenêtre parent). Cela peut être découvert par le biais de l’inspection. |
|
|
ID d’automatisation de l’élément de recherche
|
SearchElementAutomationId | string |
ID d’automatisation d’élément UIA facultatif à rechercher (à partir du handle de fenêtre parent). Cela peut être découvert par le biais de l’inspection. |
|
|
Type de contrôle localisé de l’élément de recherche
|
SearchLocalizedControlType | string |
Type de contrôle localisé de l’élément UIA facultatif à rechercher (à partir du handle de fenêtre parent). Cela peut être découvert par le biais de l’inspection. |
|
|
Rechercher une sous-arborescence UIA
|
SearchSubTree | boolean |
Si la valeur est true, l’arborescence UIA entière située sous le handle de fenêtre parent est recherchée. Cela est plus approfondi, mais peut prendre plus de temps. Si la valeur est false, seuls les éléments directement sous le handle de fenêtre parent dans l’arborescence UIA sont recherchés. |
|
|
Index de correspondance
|
MatchIndex | integer |
Si plusieurs éléments correspondent à la recherche, quel élément (à partir de 1) doit être mis en correspondance. Peut être utilisé conjointement avec « Trier par colonne » pour choisir l’ordre de tri correspondant. |
|
|
Filtre de recherche
|
SearchFilter | string |
Filtre avancé facultatif pour restreindre davantage la recherche à l’aide d’opérateurs conditionnels et de tout champ d’élément. Exemple 1 : [Width] < 200. Exemple 2 : [Name] like 'Document*' AND [ClassName] like 'Label*'. Pour plus d’exemples, consultez la documentation. |
|
|
Trier par nom de colonne
|
SortByColumn | string |
Si plusieurs éléments correspondent à la recherche, cela vous permet de spécifier la propriété d’élément à trier par. Cela sera utilisé conjointement avec « Match index » pour sélectionner l’élément requis. Par exemple : si « Trier par nom de colonne » est [TopEdge] et « Match index » est 1, l’élément correspondant le plus proche du haut de l’écran est mis en correspondance. |
|
|
L’index de correspondance est croissant
|
MatchIndexAscending | boolean |
Si plusieurs éléments correspondent à la recherche, doit correspondre à « Faire correspondre l’index » en haut de la liste triée (true) ou en bas de la liste triée (false). |
|
|
Type de contrôle localisé d’en-tête de cellule de recherche
|
SearchCellHeaderSubElementLocalizedControlType | string |
Type de contrôle localisé d’en-tête de cellule à rechercher. Laissez vide si vous ne recherchez pas d’en-têtes de cellule. |
|
|
Type de contrôle de sous-élément d’en-tête de cellule de recherche
|
SearchCellHeaderSubElementControlType | integer |
Type de contrôle de sous-élément d’en-tête de cellule (entier non localisé) à rechercher. Il s’agit de la même valeur dans différentes langues. Laissez à 0 si vous ne recherchez pas d’en-têtes de cellule. |
|
|
Type de contrôle localisé de sous-élément de cellule de recherche
|
SearchCellSubElementLocalizedControlType | string |
Type de contrôle localisé de sous-élément de cellule à rechercher. |
|
|
Type de contrôle de sous-élément de cellule de recherche
|
SearchCellSubElementControlType | integer |
Type de contrôle de sous-élément de cellule (entier non localisé) à rechercher. Il s’agit de la même valeur dans différentes langues. |
|
|
Rechercher des sous-éléments de cellule
|
SearchDescendantsForCellSubElements | boolean |
Si la valeur est true, l’arborescence UIA située en dessous de l’élément situé est recherchée pour les sous-éléments de cellule et d’en-tête de cellule (c’est-à-dire les valeurs d’élément qui remplissent les cellules du tableau de sortie). Cela est plus approfondi, mais peut prendre plus de temps. Vous pouvez définir cette valeur sur false si vous n’êtes intéressé que par des éléments directement sous l’élément. |
|
|
Premier sous-élément d’en-tête de cellule à retourner
|
FirstCellHeaderSubElementToReturn | integer |
Index du sous-élément d’en-tête de la première cellule à retourner, à partir de 1. Si vous souhaitez renvoyer les éléments dans l’ordre inverse (à partir du bas de l’arborescence UIA), vous pouvez également spécifier un index négatif à partir de -1. |
|
|
Sous-éléments max. d’en-tête de cellule à retourner
|
MaxCellHeaderSubElementsToReturn | integer |
Nombre maximal de sous-éléments d’en-tête de cellule à retourner, ou 0 pour renvoyer tous les sous-éléments. |
|
|
Premier sous-élément de cellule à retourner
|
FirstCellSubElementToReturn | integer |
Index du premier sous-élément de cellule à retourner, à partir de 1. Si vous souhaitez renvoyer les éléments dans l’ordre inverse (à partir du bas de l’arborescence UIA), vous pouvez également spécifier un index négatif à partir de -1. |
|
|
Nombre maximal de sous-éléments de cellule à retourner
|
MaxCellSubElementsToReturn | integer |
Nombre maximal de sous-éléments de cellule à retourner, ou 0 pour renvoyer tous les sous-éléments. |
|
|
Nombre demandé de colonnes
|
RequestedNumberOfColumns | integer |
Nombre de colonnes souhaitées dans la table de sortie. Cette valeur doit être correcte pour l’élément lu, ou vous recevrez des résultats inattendus. |
|
|
Priorité de valeur de sous-élément de cellule
|
CellSubElementValuePriority | integer |
Priorité d’utilisation de la valeur de sous-élément de cellule comme valeur à utiliser dans la table de sortie. 1 est la priorité la plus élevée. 2 est la deuxième priorité. 3 est la troisième priorité. 0 n’est pas utilisé. |
|
|
Priorité de valeur de texte de sous-élément de cellule
|
CellSubElementTextValuePriority | integer |
Priorité d’utilisation de la valeur de texte de sous-élément de cellule comme valeur à utiliser dans le tableau de sortie. 1 est la priorité la plus élevée. 2 est la deuxième priorité. 3 est la troisième priorité. 0 n’est pas utilisé. |
|
|
Priorité de valeur de nom de sous-élément de cellule
|
CellSubElementNameValuePriority | integer |
Priorité d’utilisation du nom de sous-élément de cellule (commun pour les étiquettes) comme valeur à utiliser dans la table de sortie. 1 est la priorité la plus élevée. 2 est la deuxième priorité. 3 est la troisième priorité. 0 n’est pas utilisé. |
|
|
Largeur minimale des sous-éléments de cellule
|
MinimumCellSubElementWidth | integer |
Largeur minimale en pixels d’un sous-élément de cellule à inclure dans le tableau. |
|
|
Hauteur minimale de sous-élément de cellule
|
MinimumCellSubElementHeight | integer |
Hauteur minimale en pixels d’un sous-élément de cellule à inclure dans le tableau. |
|
|
Zone englobante de la cellule de recherche à gauche
|
SearchCellSubElementBoundingBoxLeft | integer |
Incluez uniquement les sous-éléments de cellule qui sont entièrement contenus dans le cadre englobant. Par défaut, le cadre englobant est énorme pour inclure tous les éléments. |
|
|
Zone englobante de la cellule de recherche à droite
|
SearchCellSubElementBoundingBoxRight | integer |
Incluez uniquement les sous-éléments de cellule qui sont entièrement contenus dans le cadre englobant. Par défaut, le cadre englobant est énorme pour inclure tous les éléments. |
|
|
Zone englobante de la cellule de recherche en haut
|
SearchCellSubElementBoundingBoxTop | integer |
Incluez uniquement les sous-éléments de cellule qui sont entièrement contenus dans le cadre englobant. Par défaut, le cadre englobant est énorme pour inclure tous les éléments. |
|
|
Zone englobante de la cellule de recherche en bas
|
SearchCellSubElementBoundingBoxBottom | integer |
Incluez uniquement les sous-éléments de cellule qui sont entièrement contenus dans le cadre englobant. Par défaut, le cadre englobant est énorme pour inclure tous les éléments. |
|
|
Lire la table en tant que thread
|
ReadTableAsThread | boolean |
Si la valeur est false (valeur par défaut), l’agent IA-Connect lit immédiatement la table et retourne le contenu au directeur. Si vous lisez des tables volumineuses, cette action peut expirer. Si la valeur est true, l’agent IA-Connect lit la table en tant que thread d’agent et le directeur IA-Connect (ou Orchestrator, module PowerShell, Blue Prism) peut surveiller l’état de ce thread Agent, en attendant qu’il se termine. Cela permet de lire des tables volumineuses sans délai d’attente. IA-Connect Agents 9.3 et versions antérieures n’ont pu lire que les tables immédiatement, et non en tant que thread Agent. |
|
|
Récupérer les données de sortie pour l’ID de thread
|
RetrieveOutputDataFromThreadId | integer |
Si vous avez précédemment exécuté cette action en tant que thread agent et que vous définissez « Secondes pour attendre le thread » sur 0, indiquez l’ID de thread agent pour récupérer les résultats. Cet ID de thread agent a été fourni par l’appel précédent à cette action. Définissez la valeur 0 (valeur par défaut) si vous lisez une table (et, par conséquent, si vous ne récupérez pas les résultats d’une requête précédente exécutée en tant que thread d’agent). |
|
|
Secondes à attendre pour le thread
|
SecondsToWaitForThread | integer |
Si la valeur « Lire la table en tant que thread » est définie sur true, le nombre de secondes à attendre la fin du thread agent. Si le thread Agent lisant la table n’a pas été terminé pour le moment, une exception est levée. Défini sur 0 pour contourner l’attente : l’agent continue de lire la table, mais il est également disponible pour l’action suivante. Vous pouvez ensuite récupérer les résultats (le contenu de la table) ultérieurement en utilisant l’action « Attendre que le thread de l’agent se termine correctement » pour attendre que le thread agent se termine, puis réexécuter cette action « Obtenir plusieurs éléments UIA en tant que table » avec l’entrée « Récupérer les données de sortie pour l’ID de thread » définie sur l’ID de thread agent. |
|
|
Nombre maximal d’éléments à rechercher
|
MaxElementsToSearch | integer |
Nombre maximal d’éléments à rechercher lors de la recherche de l’élément cible dans l’arborescence UIA. Cette entrée fonctionne uniquement si le mode de recherche d’élément UIA est « Tree walk » (cela peut être activé dans la page paramètres de l’inspecteur). Par défaut, cette valeur est définie sur 0 (illimité). Cette entrée est généralement utilisée pour optimiser la recherche d’éléments. |
|
|
Profondeur maximale de recherche relative
|
MaxRelativeSearchDepth | integer |
Profondeur maximale de l’arborescence relative à la recherche d’éléments enfants sous l’élément parent. Les éléments enfants directs ont une valeur de profondeur de 1. Cette entrée fonctionne uniquement si le mode de recherche d’élément UIA est « Tree walk » (cela peut être activé dans la page paramètres de l’inspecteur). Défini sur 0 pour une profondeur de recherche illimitée. Cette entrée est généralement utilisée pour optimiser la recherche d’éléments. |
|
|
Nombre maximal d’éléments enfants à rechercher par nœud
|
MaxChildElementsToSearchPerNode | integer |
Nombre maximal d’éléments enfants à rechercher sous chaque élément lors de la recherche de l’arborescence UIA pour l’élément cible. Cette entrée fonctionne uniquement si le mode de recherche d’élément UIA est « Tree walk » (cela peut être activé dans la page paramètres de l’inspecteur). Par défaut, cette valeur est définie sur 0 (illimité). Cette entrée est généralement utilisée pour optimiser la recherche d’éléments. |
|
|
Types de contrôle localisés d’élément à parcourir
|
ElementLocalizedControlTypesNotToTraverse | string |
Liste séparée par des virgules des types de contrôle localisés par des éléments UIA pour ne pas traverser (pas à pas) lors de la recherche de l’arborescence UIA pour l’élément cible. La recherche vérifie toujours si un élément individuel correspond aux critères de recherche, mais il ne recherche aucun élément enfant de cet élément si son type de contrôle localisé figure dans cette liste d’exclusions. Cette entrée fonctionne uniquement si le mode de recherche d’élément UIA est « Tree walk » (cela peut être activé dans la page paramètres de l’inspecteur). Cette entrée est généralement utilisée pour optimiser la recherche d’éléments. |
|
|
Flux de travail
|
Workflow | True | string |
Ajoutez l’expression suivante ici : workflow() |
Retours
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
Nombre de sous-éléments de cellule trouvés
|
NumberOfCellSubElementsFound | integer |
Le nombre de sous-éléments de cellule (et non d’en-têtes) trouvé qui correspondent aux critères de recherche. |
|
Nombre de sous-éléments de cellule retournés
|
NumberOfCellSubElementsReturned | integer |
Nombre de sous-éléments de cellule (et non d’en-têtes) retournés (cela peut être inférieur au nombre d’éléments trouvés si vous spécifiez un premier ou un nombre maximal d’éléments à renvoyer). |
|
Contenu de table JSON
|
TableContentsJSON | string |
Table créée à partir du contenu de plusieurs éléments, au format JSON. |
|
Nombre de lignes dans la table
|
NumberOfRowsInTable | integer |
Nombre de lignes dans la table de sortie. |
|
Nombre de colonnes dans la table
|
NumberOfColumnsInTable | integer |
Nombre de colonnes dans la table de sortie. |
|
Thread Id
|
ThreadId | integer |
Si cette action est exécutée en tant que thread d’agent, cette sortie contient l’ID de thread agent qui peut être utilisé pour surveiller le processus de l’action et récupérer le contenu de la table une fois le thread terminé. |
Obtenir une zone de couleur de recherche d’élément UIA
Retourne les détails de la région des pixels au sein d’un élément UIA qui répondent aux critères de couleur spécifiés. L’élément doit d’abord être placé sur le devant, car l’agent localise les couleurs en prenant une capture d’écran aux coordonnées de l’élément.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Handle de fenêtre parent
|
ParentWindowHandle | True | integer |
Handle de fenêtre UIA parent (valeur 1 ou supérieure) pour agir comme point de départ de la recherche. Vous pouvez le découvrir via Inspection à l’aide d’actions telles que « Wait for desktop element » ou « Wait for element ». |
|
Nom de l’élément de recherche
|
SearchElementName | string |
Nom d’élément UIA facultatif à rechercher (à partir du handle de fenêtre parent). Cela peut être découvert par le biais de l’inspection. |
|
|
Nom de la classe d’élément Search
|
SearchElementClassName | string |
Nom de classe d’élément UIA facultatif à rechercher (à partir du handle de fenêtre parent). Cela peut être découvert par le biais de l’inspection. |
|
|
ID d’automatisation de l’élément de recherche
|
SearchElementAutomationId | string |
ID d’automatisation d’élément UIA facultatif à rechercher (à partir du handle de fenêtre parent). Cela peut être découvert par le biais de l’inspection. |
|
|
Type de contrôle localisé de l’élément de recherche
|
SearchLocalizedControlType | string |
Type de contrôle localisé de l’élément UIA facultatif à rechercher (à partir du handle de fenêtre parent). Cela peut être découvert par le biais de l’inspection. |
|
|
Rechercher une sous-arborescence UIA
|
SearchSubTree | boolean |
Si la valeur est true, l’arborescence UIA entière située sous le handle de fenêtre parent est recherchée. Cela est plus approfondi, mais peut prendre plus de temps. Si la valeur est false, seuls les éléments directement sous le handle de fenêtre parent dans l’arborescence UIA sont recherchés. |
|
|
Index de correspondance
|
MatchIndex | integer |
Si plusieurs éléments correspondent à la recherche, quel élément (à partir de 1) doit être mis en correspondance. Peut être utilisé conjointement avec « Trier par colonne » pour choisir l’ordre de tri correspondant. |
|
|
Filtre de recherche
|
SearchFilter | string |
Filtre avancé facultatif pour restreindre davantage la recherche à l’aide d’opérateurs conditionnels et de tout champ d’élément. Exemple 1 : [Width] < 200. Exemple 2 : [Name] like 'Document*' AND [ClassName] like 'Label*'. Pour plus d’exemples, consultez la documentation. |
|
|
Trier par nom de colonne
|
SortByColumn | string |
Si plusieurs éléments correspondent à la recherche, cela vous permet de spécifier la propriété d’élément à trier par. Cela sera utilisé conjointement avec « Match index » pour sélectionner l’élément requis. Par exemple : si « Trier par nom de colonne » est [TopEdge] et « Match index » est 1, l’élément correspondant le plus proche du haut de l’écran est mis en correspondance. |
|
|
L’index de correspondance est croissant
|
MatchIndexAscending | boolean |
Si plusieurs éléments correspondent à la recherche, doit correspondre à « Faire correspondre l’index » en haut de la liste triée (true) ou en bas de la liste triée (false). |
|
|
Couleur de recherche
|
SearchColour | True | string |
Couleur de recherche au format 0xAARRGGBB, #AARRGGBB, 0xRRGGBB ou #RRGGBB où chaque canal de couleur est un octet au format hexadécimal (00 est entièrement désactivé, FF est entièrement activé). Par exemple : #FF0000 pour le rouge, #00FF00 pour le bleu, #0000000 pour le noir, #FFFFFF pour le blanc. |
|
Écart maximal de couleur
|
MaxColourDeviation | True | integer |
La couleur maximale d’un élément peut s’écarter de la couleur de recherche avant qu’elle ne soit considérée comme une correspondance. 0 pour aucun écart. L’écart est mesuré dans les valeurs RVB. Par exemple : #FF0000 est différent de 4 #FE0102. Un écart de 15 serait un bon point de départ. |
|
Décalage X de pixel gauche
|
LeftPixelXOffset | integer |
Décalage X facultatif pour le bord gauche de la zone de recherche. Cela vous permet d’augmenter (avec des valeurs négatives) ou de diminuer (avec des valeurs positives) la zone de recherche. |
|
|
Décalage X pixel droit
|
RightPixelXOffset | integer |
Décalage X facultatif pour le bord droit de la zone de recherche. Cela vous permet d’augmenter (avec des valeurs positives) ou de diminuer (avec des valeurs négatives) la zone de recherche. |
|
|
Décalage Y du pixel supérieur
|
TopPixelYOffset | integer |
Décalage Y facultatif pour le bord supérieur de la zone de recherche. Cela vous permet d’augmenter (avec des valeurs négatives) ou de diminuer (avec des valeurs positives) la zone de recherche. |
|
|
Décalage Y en pixels inférieurs
|
BottomPixelYOffset | integer |
Décalage Y facultatif pour le bord inférieur de la zone de recherche. Cela vous permet d’augmenter (avec des valeurs positives) ou de diminuer (avec des valeurs négatives) la zone de recherche. |
|
|
Masquer l’agent
|
HideAgent | boolean |
Définissez la valeur true pour masquer automatiquement l’agent (s’il est visible) pour vous assurer qu’il ne masque pas l’élément analysé. |
|
|
Retourner les coordonnées de l’écran en tant que physiques
|
ReturnPhysicalCoordinates | boolean |
Définissez la valeur true pour que les coordonnées de l’écran soient retournées en tant que coordonnées physiques. Définissez la valeur false pour que les coordonnées de l’écran soient retournées en tant que coordonnées virtuelles. Si la mise à l’échelle d’affichage sous-jacente est de 100%, les coordonnées physiques et virtuelles sont identiques. Les coordonnées d’élément sont toujours retournées en tant que coordonnées virtuelles. |
|
|
Nombre maximal d’éléments à rechercher
|
MaxElementsToSearch | integer |
Nombre maximal d’éléments à rechercher lors de la recherche de l’élément cible dans l’arborescence UIA. Cette entrée fonctionne uniquement si le mode de recherche d’élément UIA est « Tree walk » (cela peut être activé dans la page paramètres de l’inspecteur). Par défaut, cette valeur est définie sur 0 (illimité). Cette entrée est généralement utilisée pour optimiser la recherche d’éléments. |
|
|
Profondeur maximale de recherche relative
|
MaxRelativeSearchDepth | integer |
Profondeur maximale de l’arborescence relative à la recherche d’éléments enfants sous l’élément parent. Les éléments enfants directs ont une valeur de profondeur de 1. Cette entrée fonctionne uniquement si le mode de recherche d’élément UIA est « Tree walk » (cela peut être activé dans la page paramètres de l’inspecteur). Défini sur 0 pour une profondeur de recherche illimitée. Cette entrée est généralement utilisée pour optimiser la recherche d’éléments. |
|
|
Nombre maximal d’éléments enfants à rechercher par nœud
|
MaxChildElementsToSearchPerNode | integer |
Nombre maximal d’éléments enfants à rechercher sous chaque élément lors de la recherche de l’arborescence UIA pour l’élément cible. Cette entrée fonctionne uniquement si le mode de recherche d’élément UIA est « Tree walk » (cela peut être activé dans la page paramètres de l’inspecteur). Par défaut, cette valeur est définie sur 0 (illimité). Cette entrée est généralement utilisée pour optimiser la recherche d’éléments. |
|
|
Types de contrôle localisés d’élément à parcourir
|
ElementLocalizedControlTypesNotToTraverse | string |
Liste séparée par des virgules des types de contrôle localisés par des éléments UIA pour ne pas traverser (pas à pas) lors de la recherche de l’arborescence UIA pour l’élément cible. La recherche vérifie toujours si un élément individuel correspond aux critères de recherche, mais il ne recherche aucun élément enfant de cet élément si son type de contrôle localisé figure dans cette liste d’exclusions. Cette entrée fonctionne uniquement si le mode de recherche d’élément UIA est « Tree walk » (cela peut être activé dans la page paramètres de l’inspecteur). Cette entrée est généralement utilisée pour optimiser la recherche d’éléments. |
|
|
Flux de travail
|
Workflow | True | string |
Ajoutez l’expression suivante ici : workflow() |
Retours
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
Nombre de pixels correspondant à la couleur
|
NumberOfPixelsMatchingColour | integer |
Nombre de pixels qui correspondent à la couleur spécifiée. |
|
Pixel gauche de la zone englobante de correspondance couleur
|
ColourMatchBoundingBoxElementLeftPixelXCoord | integer |
Coordonnée X virtuelle du pixel le plus à gauche correspondant à la couleur spécifiée, par rapport à l’élément virtuel en haut à gauche. |
|
Pixel droit de l’élément cadre englobant de correspondance couleur
|
ColourMatchBoundingBoxElementRightPixelXCoord | integer |
Coordonnée X virtuelle du pixel le plus à droite correspondant à la couleur spécifiée, par rapport à l’élément virtuel en haut à gauche. |
|
Pixel supérieur de la zone englobante de correspondance couleur
|
ColourMatchBoundingBoxElementTopPixelYCoord | integer |
Coordonnée Y virtuelle du pixel le plus haut correspondant à la couleur spécifiée, par rapport à l’élément virtuel en haut à gauche. |
|
Couleur de l’élément de cadre englobant en pixels inférieurs
|
ColourMatchBoundingBoxElementBottomPixelYCoord | integer |
Coordonnée Y virtuelle du pixel le plus bas correspondant à la couleur spécifiée, par rapport à l’élément virtuel en haut à gauche. |
|
Couleur de correspondance englobante élément du centre X pixel
|
ColourMatchBoundingBoxElementCenterPixelXCoord | integer |
Coordonnée X virtuelle du centre du cadre englobant contenant des pixels correspondant à la couleur spécifiée, par rapport à l’élément en haut à gauche de l’élément. |
|
Couleur correspond à un élément de cadre englobant au centre Y pixels
|
ColourMatchBoundingBoxElementCenterPixelYCoord | integer |
Coordonnée Y virtuelle du centre du cadre englobant contenant des pixels correspondant à la couleur spécifiée, par rapport à l’élément en haut à gauche de l’élément. |
|
Écran de zone englobante de correspondance couleur en pixel gauche
|
ColourMatchBoundingBoxScreenLeftPixelXCoord | integer |
Coordonnée X du pixel d’écran du pixel le plus à gauche correspondant à la couleur spécifiée. Il s’agit d’une coordonnée physique ou virtuelle en fonction de l’entrée « Retourner les coordonnées physiques ». |
|
Couleur correspond à l’écran de rectangle englobant pixel droit
|
ColourMatchBoundingBoxScreenRightPixelXCoord | integer |
Coordonnée X du pixel d’écran du pixel le plus à droite correspondant à la couleur spécifiée. Il s’agit d’une coordonnée physique ou virtuelle en fonction de l’entrée « Retourner les coordonnées physiques ». |
|
Pixel supérieur de la zone englobante de correspondance couleur
|
ColourMatchBoundingBoxScreenTopPixelYCoord | integer |
Coordonnée Y du pixel d’écran du pixel supérieur correspondant à la couleur spécifiée. Il s’agit d’une coordonnée physique ou virtuelle en fonction de l’entrée « Retourner les coordonnées physiques ». |
|
Couleur de correspondance englobante écran en pixels inférieurs
|
ColourMatchBoundingBoxScreenBottomPixelYCoord | integer |
Coordonnée Y du pixel d’écran du pixel le plus bas correspondant à la couleur spécifiée. Il s’agit d’une coordonnée physique ou virtuelle en fonction de l’entrée « Retourner les coordonnées physiques ». |
|
Correspondance de couleur englobante centre X pixel
|
ColourMatchBoundingBoxScreenCenterPixelXCoord | integer |
Coordonnée X du pixel d’écran du centre du cadre englobant contenant des pixels correspondant à la couleur spécifiée. Il s’agit d’une coordonnée physique ou virtuelle en fonction de l’entrée « Retourner les coordonnées physiques ». |
|
Couleur de correspondance englobante en pixels Y du centre de l’écran
|
ColourMatchBoundingBoxScreenCenterPixelYCoord | integer |
Coordonnée Y du pixel d’écran du centre du cadre englobant contenant des pixels correspondant à la couleur spécifiée. Il s’agit d’une coordonnée physique ou virtuelle en fonction de l’entrée « Retourner les coordonnées physiques ». |
Rechercher le premier élément parent UIA
Recherche la hiérarchie de l’arborescence UIA pour le premier élément parent qui correspond aux critères de recherche. L’élément parent est défini comme l’élément qui se trouve au niveau suivant jusqu’à l’UIA 'tree' et est presque toujours un élément conteneur.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Handle d’élément
|
ElementHandle | True | integer |
Handle UIA pour l’élément cible. |
|
Type de contrôle localisé de l’élément parent de recherche
|
SearchParentLocalizedControlType | string |
Type de contrôle localisé de l’élément UIA parent à rechercher. Cela peut être découvert par le biais de l’inspection. |
|
|
Type de contrôle d’élément parent de recherche
|
SearchParentControlType | integer |
Type de contrôle d’élément UIA parent (entier non localisé) à rechercher. Il s’agit de la même valeur dans différentes langues. |
|
|
Nombre maximal de parents à traiter
|
MaxParentsToProcess | integer |
Nombre maximal d’éléments parents à traiter. Par défaut, cette valeur est définie sur 50. |
|
|
Déclencher une exception si l’élément parent est introuvable
|
RaiseExceptionIfParentElementNotFound | boolean |
Doit-il IA-Connect déclencher une exception si l’élément UIA de recherche n’est pas situé ? |
|
|
Flux de travail
|
Workflow | True | string |
Ajoutez l’expression suivante ici : workflow() |
Retours
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
Élément parent trouvé
|
ParentElementFound | boolean |
Retourne true si l’élément UIA parent de recherche a été trouvé. |
|
Handle d’élément parent
|
ParentElementHandle | integer |
Handle UIA pour l’élément parent situé. Cela peut être utilisé comme entrée pour d’autres actions UIA agissant sur cet élément. |
|
Nom de l’élément parent
|
ParentElementName | string |
Nom UIA de l’élément parent situé. |
|
Nom de la classe d’élément parent
|
ParentElementClassName | string |
Nom de classe UIA de l’élément parent situé. |
|
ID d’automatisation de l’élément parent
|
ParentElementAutomationId | string |
ID d’automatisation UIA de l’élément parent situé. |
|
Type de contrôle localisé par l’élément parent
|
ParentElementLocalizedControlType | string |
Type de contrôle localisé UIA de l’élément parent situé. |
Rechercher une image de recherche visible dans l’élément UIA
Retourne si une image de recherche, fournie en tant qu’entrée à cette action, a été visiblement située dans un élément UIA à l’écran. L’élément doit d’abord être placé devant, car l’agent prend une capture d’écran sur les coordonnées de l’élément et recherche l’image de recherche fournie dans la capture d’écran.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Handle de fenêtre parent
|
ParentWindowHandle | True | integer |
Handle de fenêtre UIA parent (valeur 1 ou supérieure) pour agir comme point de départ de la recherche. Vous pouvez le découvrir via Inspection à l’aide d’actions telles que « Wait for desktop element » ou « Wait for element ». |
|
Nom de l’élément de recherche
|
SearchElementName | string |
Nom d’élément UIA facultatif à rechercher (à partir du handle de fenêtre parent). Cela peut être découvert par le biais de l’inspection. |
|
|
Nom de la classe d’élément Search
|
SearchElementClassName | string |
Nom de classe d’élément UIA facultatif à rechercher (à partir du handle de fenêtre parent). Cela peut être découvert par le biais de l’inspection. |
|
|
ID d’automatisation de l’élément de recherche
|
SearchElementAutomationId | string |
ID d’automatisation d’élément UIA facultatif à rechercher (à partir du handle de fenêtre parent). Cela peut être découvert par le biais de l’inspection. |
|
|
Type de contrôle localisé de l’élément de recherche
|
SearchLocalizedControlType | string |
Type de contrôle localisé de l’élément UIA facultatif à rechercher (à partir du handle de fenêtre parent). Cela peut être découvert par le biais de l’inspection. |
|
|
Rechercher une sous-arborescence UIA
|
SearchSubTree | boolean |
Si la valeur est true, l’arborescence UIA entière située sous le handle de fenêtre parent est recherchée. Cela est plus approfondi, mais peut prendre plus de temps. Si la valeur est false, seuls les éléments directement sous le handle de fenêtre parent dans l’arborescence UIA sont recherchés. |
|
|
Index de correspondance
|
MatchIndex | integer |
Si plusieurs éléments correspondent à la recherche, quel élément (à partir de 1) doit être mis en correspondance. Peut être utilisé conjointement avec « Trier par colonne » pour choisir l’ordre de tri correspondant. |
|
|
Filtre de recherche
|
SearchFilter | string |
Filtre avancé facultatif pour restreindre davantage la recherche à l’aide d’opérateurs conditionnels et de tout champ d’élément. Exemple 1 : [Width] < 200. Exemple 2 : [Name] like 'Document*' AND [ClassName] like 'Label*'. Pour plus d’exemples, consultez la documentation. |
|
|
Trier par nom de colonne
|
SortByColumn | string |
Si plusieurs éléments correspondent à la recherche, cela vous permet de spécifier la propriété d’élément à trier par. Cela sera utilisé conjointement avec « Match index » pour sélectionner l’élément requis. Par exemple : si « Trier par nom de colonne » est [TopEdge] et « Match index » est 1, l’élément correspondant le plus proche du haut de l’écran est mis en correspondance. |
|
|
L’index de correspondance est croissant
|
MatchIndexAscending | boolean |
Si plusieurs éléments correspondent à la recherche, doit correspondre à « Faire correspondre l’index » en haut de la liste triée (true) ou en bas de la liste triée (false). |
|
|
Nombre maximal d’éléments à rechercher
|
MaxElementsToSearch | integer |
Nombre maximal d’éléments à rechercher lors de la recherche de l’élément cible dans l’arborescence UIA. Cette entrée fonctionne uniquement si le mode de recherche d’élément UIA est « Tree walk » (cela peut être activé dans la page paramètres de l’inspecteur). Par défaut, cette valeur est définie sur 0 (illimité). Cette entrée est généralement utilisée pour optimiser la recherche d’éléments. |
|
|
Profondeur maximale de recherche relative
|
MaxRelativeSearchDepth | integer |
Profondeur maximale de l’arborescence relative à la recherche d’éléments enfants sous l’élément parent. Les éléments enfants directs ont une valeur de profondeur de 1. Cette entrée fonctionne uniquement si le mode de recherche d’élément UIA est « Tree walk » (cela peut être activé dans la page paramètres de l’inspecteur). Défini sur 0 pour une profondeur de recherche illimitée. Cette entrée est généralement utilisée pour optimiser la recherche d’éléments. |
|
|
Nombre maximal d’éléments enfants à rechercher par nœud
|
MaxChildElementsToSearchPerNode | integer |
Nombre maximal d’éléments enfants à rechercher sous chaque élément lors de la recherche de l’arborescence UIA pour l’élément cible. Cette entrée fonctionne uniquement si le mode de recherche d’élément UIA est « Tree walk » (cela peut être activé dans la page paramètres de l’inspecteur). Par défaut, cette valeur est définie sur 0 (illimité). Cette entrée est généralement utilisée pour optimiser la recherche d’éléments. |
|
|
Types de contrôle localisés d’élément à parcourir
|
ElementLocalizedControlTypesNotToTraverse | string |
Liste séparée par des virgules des types de contrôle localisés par des éléments UIA pour ne pas traverser (pas à pas) lors de la recherche de l’arborescence UIA pour l’élément cible. La recherche vérifie toujours si un élément individuel correspond aux critères de recherche, mais il ne recherche aucun élément enfant de cet élément si son type de contrôle localisé figure dans cette liste d’exclusions. Cette entrée fonctionne uniquement si le mode de recherche d’élément UIA est « Tree walk » (cela peut être activé dans la page paramètres de l’inspecteur). Cette entrée est généralement utilisée pour optimiser la recherche d’éléments. |
|
|
Type d’image de recherche
|
SearchImageType | string |
Définit ce que représente l’entrée « Image de recherche ». Si la valeur est « Fichier image du directeur », l’image de recherche est un chemin d’accès à un fichier accessible au directeur. Si la valeur est « Fichier image de l’agent », l’image de recherche est un chemin d’accès à un fichier accessible à l’agent. Si la valeur est « Base64 », l’image de recherche est une représentation base64 de l’image. |
|
|
Image de recherche
|
SearchImage | string |
Image de recherche à localiser dans l’élément UIA spécifié. Selon le « type d’image de recherche » spécifié, il peut contenir le chemin d’accès à un fichier image (à la fin du directeur ou de l’agent) ou contenir la base64 (représentation textuelle) de l’image à rechercher. |
|
|
Autre type d’image de recherche
|
AltSearchImageType | string |
Définit ce que représente l’entrée « Image de recherche alternative ». Si la valeur est « None » ou vide, il n’existe aucune autre image de recherche. Si la valeur est « Fichier image du directeur », l’image de recherche est un chemin d’accès à un fichier accessible au directeur. Si la valeur est « Fichier image de l’agent », l’image de recherche est un chemin d’accès à un fichier accessible à l’agent. Si la valeur est « Base64 », l’image de recherche est une représentation base64 de l’image. |
|
|
Autre image de recherche
|
AltSearchImage | string |
Une autre image de recherche facultative à localiser dans l’élément UIA spécifié. Selon le « type d’image de recherche alternatif » spécifié, il peut contenir le chemin d’accès à un fichier image (à la fin du directeur ou de l’agent) ou contenir la base64 (représentation textuelle) de l’image à rechercher. Si vous spécifiez une autre image de recherche, l’Agent recherche l’image de recherche ou l’image de recherche alternative et signale celle qui a été située. |
|
|
Écart maximal de couleur
|
MaxColourDeviation | integer |
Le maximum de couleurs de pixels d’un élément peut s’écarter des couleurs de pixels de l’image de recherche avant qu’elle ne soit considérée comme une correspondance. 0 pour aucun écart. L’écart est mesuré dans les valeurs RVB. Par exemple : #FF0000 est différent de 4 #FE0102. Cela permet d’ignorer les différences mineures de coloration. |
|
|
Différences de pixels maximales
|
MaxPixelDifferences | integer |
Nombre maximal de pixels qui peuvent différer (au-dessus de l’écart de couleur maximal), sur l’ensemble de l’image de recherche, avant qu’une image ne corresponde. Cela permet d’ignorer les différences mineures entre les images, mais des valeurs plus élevées peuvent augmenter le temps nécessaire pour localiser une image. Il est recommandé de définir la valeur 0 et d’augmenter de petites quantités si nécessaire. Si vous définissez une valeur supérieure à 0, vous devez également définir « Nombre maximal de différences de pixels consécutives ». |
|
|
Différences de pixels consécutives maximales
|
MaxConsecutivePixelDifferences | integer |
Nombre maximal de pixels consécutifs qui peuvent différer (au-dessus de l’écart de couleur maximal), dans n’importe quelle ligne, avant qu’une image ne corresponde. Cela permet d’ignorer les différences mineures entre les images, mais des valeurs plus élevées peuvent augmenter le temps nécessaire pour localiser une image. Il est recommandé de définir la valeur 0 et d’augmenter de petites quantités si nécessaire. Si vous définissez une valeur supérieure à 0, vous devez également définir « Nombre maximal de différences de pixels ». |
|
|
Décalage X de pixel gauche
|
LeftPixelXOffset | integer |
Décalage X facultatif pour le bord gauche de la zone de recherche. Cela vous permet d’augmenter (avec des valeurs négatives) ou de diminuer (avec des valeurs positives) la zone de recherche. |
|
|
Décalage X pixel droit
|
RightPixelXOffset | integer |
Décalage X facultatif pour le bord droit de la zone de recherche. Cela vous permet d’augmenter (avec des valeurs positives) ou de diminuer (avec des valeurs négatives) la zone de recherche. |
|
|
Décalage Y du pixel supérieur
|
TopPixelYOffset | integer |
Décalage Y facultatif pour le bord supérieur de la zone de recherche. Cela vous permet d’augmenter (avec des valeurs négatives) ou de diminuer (avec des valeurs positives) la zone de recherche. |
|
|
Décalage Y en pixels inférieurs
|
BottomPixelYOffset | integer |
Décalage Y facultatif pour le bord inférieur de la zone de recherche. Cela vous permet d’augmenter (avec des valeurs positives) ou de diminuer (avec des valeurs négatives) la zone de recherche. |
|
|
Unité de décalages X pixels
|
PixelXOffsetsUnit | string |
Défini sur « Pixel » (valeur par défaut) si les décalages X de pixel gauche et droit sont mesurés en pixels. Défini sur « Pourcentage » si les décalages X de pixel gauche et droit sont mesurés sous la forme d’un pourcentage de la largeur de l’élément. |
|
|
Unité de décalages Y pixels
|
PixelYOffsetsUnit | string |
Défini sur « Pixel » (valeur par défaut) si les décalages Y de pixels supérieur et inférieur sont mesurés en pixels. Défini sur « Pourcentage » si les décalages Y en pixels supérieurs et inférieurs sont mesurés sous la forme d’un pourcentage de la hauteur de l’élément. |
|
|
Index d’image de recherche
|
SearchImageIndex | integer |
Définissez la valeur 1 pour localiser la première instance de l’image de recherche (dans la direction de la recherche) dans l’élément UIA. Défini sur 2 pour la deuxième instance, .... , N pour l’instance Nth. Si vous recherchez également une autre image, l’élément UIA est analysé en premier pour l’image de recherche et deuxièmement pour l’autre image, en recherchant l’instance demandée de cette image particulière (c’est-à-dire que l’agent attend l’une ou l’autre, pas une combinaison des deux images). |
|
|
Direction de la recherche d’images
|
ImageSearchDirection | string |
Direction de la recherche. « De haut » effectue des recherches par ligne en haut, analyse de gauche à droite dans chaque ligne. « De bas » effectue des recherches par ligne en bas, en analysant la gauche vers la droite dans chaque ligne. « De gauche » effectue des recherches par colonne de gauche, analyse en haut en bas dans chaque colonne. « De droite » effectue des recherches par colonne de droite, analyse en haut en bas dans chaque colonne. Cela peut être utilisé conjointement avec l'« index d’image de recherche » pour localiser la Nième image du haut, du bas, de la gauche ou de la droite. Pour améliorer les performances, sélectionnez la direction de recherche que vous pensez localiser plus rapidement votre image. |
|
|
Masquer l’agent
|
HideAgent | boolean |
Définissez la valeur true pour masquer automatiquement l’agent (s’il est visible) pour vous assurer qu’il ne masque pas l’élément analysé. |
|
|
Retourner les coordonnées de l’écran en tant que physiques
|
ReturnPhysicalCoordinates | boolean |
Définissez la valeur true pour que les coordonnées de l’écran soient retournées en tant que coordonnées physiques. Définissez la valeur false pour que les coordonnées de l’écran soient retournées en tant que coordonnées virtuelles. Si la mise à l’échelle d’affichage sous-jacente est de 100%, les coordonnées physiques et virtuelles sont identiques. Les coordonnées d’élément sont toujours retournées en tant que coordonnées virtuelles. |
|
|
Afficher le rectangle de mise en surbrillance
|
ShowHighlightRectangle | boolean |
Si la valeur est true, l’agent IA-Connect met en surbrillance l’image située à l’écran. Cela peut être utile pendant le développement, pour vous aider à visualiser que l’image correcte est détectée. |
|
|
Flux de travail
|
Workflow | True | string |
Ajoutez l’expression suivante ici : workflow() |
Retours
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
Image de recherche située
|
SearchImageLocated | boolean |
Défini sur true, si l’image de recherche a été localisée. Défini sur false, si l’image de recherche n’a pas été localisée. |
|
Image de recherche située
|
WhichSearchImageLocated | integer |
Défini sur 0, si aucune image de recherche n’a été localisée. Défini sur 1 si l’image de recherche était située. Défini sur 2 si l’autre image de recherche était située. |
|
Image correspond à l’élément de zone englobante pixel gauche
|
SearchImageBoundingBoxElementLeftPixelXCoord | integer |
Coordonnée X virtuelle du pixel le plus à gauche correspondant à l’image spécifiée, par rapport à l’élément virtuel en haut à gauche. |
|
Image correspondance de l’élément cadre englobant pixel droit
|
SearchImageBoundingBoxElementRightPixelXCoord | integer |
Coordonnée X virtuelle du pixel le plus à droite correspondant à l’image spécifiée, par rapport à l’élément virtuel en haut à gauche. |
|
Image correspond à un élément de cadre englobant en pixel supérieur
|
SearchImageBoundingBoxElementTopPixelYCoord | integer |
Coordonnée Y virtuelle du pixel le plus haut correspondant à l’image spécifiée, par rapport à l’élément virtuel en haut à gauche. |
|
Image correspond à l’élément de cadre englobant en pixels inférieurs
|
SearchImageBoundingBoxElementBottomPixelYCoord | integer |
Coordonnée Y virtuelle du pixel le plus bas correspondant à l’image spécifiée, par rapport à l’élément virtuel en haut à gauche. |
|
Correspondance d’image avec un élément englobant du centre X pixel
|
SearchImageBoundingBoxElementCenterPixelXCoord | integer |
Coordonnée X virtuelle du centre du cadre englobant contenant des pixels correspondant à l’image spécifiée, par rapport à l’élément en haut à gauche de l’élément. |
|
Correspondance d’image avec un élément englobant du centre Y
|
SearchImageBoundingBoxElementCenterPixelYCoord | integer |
Coordonnée Y virtuelle du centre du cadre englobant contenant des pixels correspondant à l’image spécifiée, par rapport à l’élément en haut à gauche de l’élément. |
|
Image correspond à l’écran de zone englobante pixel gauche
|
SearchImageBoundingBoxScreenLeftPixelXCoord | integer |
Coordonnée X du pixel d’écran du pixel le plus à gauche correspondant à l’image spécifiée. Il s’agit d’une coordonnée physique ou virtuelle en fonction de l’entrée « Retourner les coordonnées physiques ». |
|
Image correspondant à l’écran de zone englobante pixel droit
|
SearchImageBoundingBoxScreenRightPixelXCoord | integer |
Coordonnée X du pixel d’écran du pixel le plus à droite correspondant à l’image spécifiée. Il s’agit d’une coordonnée physique ou virtuelle en fonction de l’entrée « Retourner les coordonnées physiques ». |
|
Image correspond à la zone englobante en pixel supérieur de l’écran
|
SearchImageBoundingBoxScreenTopPixelYCoord | integer |
Coordonnée Y du pixel d’écran du pixel supérieur correspondant à l’image spécifiée. Il s’agit d’une coordonnée physique ou virtuelle en fonction de l’entrée « Retourner les coordonnées physiques ». |
|
Image correspond à la zone englobante en pixels inférieurs
|
SearchImageBoundingBoxScreenBottomPixelYCoord | integer |
Coordonnée Y du pixel d’écran du pixel le plus bas correspondant à l’image spécifiée. Il s’agit d’une coordonnée physique ou virtuelle en fonction de l’entrée « Retourner les coordonnées physiques ». |
|
Correspondance d’image avec zone englobante centre X pixel
|
SearchImageBoundingBoxScreenCenterPixelXCoord | integer |
Coordonnée X du pixel d’écran du centre du cadre englobant contenant des pixels correspondant à l’image spécifiée. Il s’agit d’une coordonnée physique ou virtuelle en fonction de l’entrée « Retourner les coordonnées physiques ». |
|
Correspondance d’image avec zone englobante en pixelS Y du centre d’écran
|
SearchImageBoundingBoxScreenCenterPixelYCoord | integer |
Coordonnée Y du pixel d’écran du centre du cadre englobant contenant des pixels correspondant à l’image spécifiée. Il s’agit d’une coordonnée physique ou virtuelle en fonction de l’entrée « Retourner les coordonnées physiques ». |
Redimensionner l’élément UIA
Redimensionne un élément UIA. Cette action fonctionne généralement uniquement avec les éléments Window (qui ont le modèle de transformation).
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Handle de fenêtre parent
|
ParentWindowHandle | True | integer |
Handle de fenêtre UIA parent (valeur 1 ou supérieure) pour agir comme point de départ de la recherche. Vous pouvez le découvrir via Inspection à l’aide d’actions telles que « Wait for desktop element » ou « Wait for element ». |
|
Nom de l’élément de recherche
|
SearchElementName | string |
Nom d’élément UIA facultatif à rechercher (à partir du handle de fenêtre parent). Cela peut être découvert par le biais de l’inspection. |
|
|
Nom de la classe d’élément Search
|
SearchElementClassName | string |
Nom de classe d’élément UIA facultatif à rechercher (à partir du handle de fenêtre parent). Cela peut être découvert par le biais de l’inspection. |
|
|
ID d’automatisation de l’élément de recherche
|
SearchElementAutomationId | string |
ID d’automatisation d’élément UIA facultatif à rechercher (à partir du handle de fenêtre parent). Cela peut être découvert par le biais de l’inspection. |
|
|
Type de contrôle localisé de l’élément de recherche
|
SearchLocalizedControlType | string |
Type de contrôle localisé de l’élément UIA facultatif à rechercher (à partir du handle de fenêtre parent). Cela peut être découvert par le biais de l’inspection. |
|
|
Rechercher une sous-arborescence UIA
|
SearchSubTree | boolean |
Si la valeur est true, l’arborescence UIA entière située sous le handle de fenêtre parent est recherchée. Cela est plus approfondi, mais peut prendre plus de temps. Si la valeur est false, seuls les éléments directement sous le handle de fenêtre parent dans l’arborescence UIA sont recherchés. |
|
|
Index de correspondance
|
MatchIndex | integer |
Si plusieurs éléments correspondent à la recherche, quel élément (à partir de 1) doit être mis en correspondance. Peut être utilisé conjointement avec « Trier par colonne » pour choisir l’ordre de tri correspondant. |
|
|
Filtre de recherche
|
SearchFilter | string |
Filtre avancé facultatif pour restreindre davantage la recherche à l’aide d’opérateurs conditionnels et de tout champ d’élément. Exemple 1 : [Width] < 200. Exemple 2 : [Name] like 'Document*' AND [ClassName] like 'Label*'. Pour plus d’exemples, consultez la documentation. |
|
|
Trier par nom de colonne
|
SortByColumn | string |
Si plusieurs éléments correspondent à la recherche, cela vous permet de spécifier la propriété d’élément à trier par. Cela sera utilisé conjointement avec « Match index » pour sélectionner l’élément requis. Par exemple : si « Trier par nom de colonne » est [TopEdge] et « Match index » est 1, l’élément correspondant le plus proche du haut de l’écran est mis en correspondance. |
|
|
L’index de correspondance est croissant
|
MatchIndexAscending | boolean |
Si plusieurs éléments correspondent à la recherche, doit correspondre à « Faire correspondre l’index » en haut de la liste triée (true) ou en bas de la liste triée (false). |
|
|
Nombre maximal d’éléments à rechercher
|
MaxElementsToSearch | integer |
Nombre maximal d’éléments à rechercher lors de la recherche de l’élément cible dans l’arborescence UIA. Cette entrée fonctionne uniquement si le mode de recherche d’élément UIA est « Tree walk » (cela peut être activé dans la page paramètres de l’inspecteur). Par défaut, cette valeur est définie sur 0 (illimité). Cette entrée est généralement utilisée pour optimiser la recherche d’éléments. |
|
|
Profondeur maximale de recherche relative
|
MaxRelativeSearchDepth | integer |
Profondeur maximale de l’arborescence relative à la recherche d’éléments enfants sous l’élément parent. Les éléments enfants directs ont une valeur de profondeur de 1. Cette entrée fonctionne uniquement si le mode de recherche d’élément UIA est « Tree walk » (cela peut être activé dans la page paramètres de l’inspecteur). Défini sur 0 pour une profondeur de recherche illimitée. Cette entrée est généralement utilisée pour optimiser la recherche d’éléments. |
|
|
Nombre maximal d’éléments enfants à rechercher par nœud
|
MaxChildElementsToSearchPerNode | integer |
Nombre maximal d’éléments enfants à rechercher sous chaque élément lors de la recherche de l’arborescence UIA pour l’élément cible. Cette entrée fonctionne uniquement si le mode de recherche d’élément UIA est « Tree walk » (cela peut être activé dans la page paramètres de l’inspecteur). Par défaut, cette valeur est définie sur 0 (illimité). Cette entrée est généralement utilisée pour optimiser la recherche d’éléments. |
|
|
Types de contrôle localisés d’élément à parcourir
|
ElementLocalizedControlTypesNotToTraverse | string |
Liste séparée par des virgules des types de contrôle localisés par des éléments UIA pour ne pas traverser (pas à pas) lors de la recherche de l’arborescence UIA pour l’élément cible. La recherche vérifie toujours si un élément individuel correspond aux critères de recherche, mais il ne recherche aucun élément enfant de cet élément si son type de contrôle localisé figure dans cette liste d’exclusions. Cette entrée fonctionne uniquement si le mode de recherche d’élément UIA est « Tree walk » (cela peut être activé dans la page paramètres de l’inspecteur). Cette entrée est généralement utilisée pour optimiser la recherche d’éléments. |
|
|
Redimensionner le type de largeur
|
ResizeWidthType | string |
Type de redimensionnement de largeur : absolu ou relatif. |
|
|
Nouvelle largeur
|
NewWidth | True | integer |
Nouvelle largeur de l’élément. Le type de redimensionnement (par exemple, absolu ou relatif) est défini par l’entrée « Redimensionner le type de largeur ». Pour laisser la largeur inchangée, choisissez la valeur 0 et définissez « Redimensionner le type de largeur » sur « Relative ». |
|
Redimensionner le type de hauteur
|
ResizeHeightType | string |
Type de redimensionnement de hauteur : absolu ou relatif. |
|
|
Nouvelle hauteur
|
NewHeight | True | integer |
Nouvelle hauteur de l’élément. Le type de redimensionnement (par exemple, absolu ou relatif) est défini par l’entrée « Redimensionner le type de hauteur ». Pour laisser la hauteur inchangée, choisissez la valeur 0 et définissez « Redimensionner le type de hauteur » sur « Relative ». |
|
Flux de travail
|
Workflow | True | string |
Ajoutez l’expression suivante ici : workflow() |
Retours
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
Résultat de la commande
|
UIAResizeElementResult | boolean |
Résultat de la commande (réussite ou échec). |
|
Message d'erreur
|
ErrorMessage | string |
Si la commande n’a pas réussi, cela contiendra le message d’erreur retourné. |
Retour d’entrée dans l’élément UIA
Insère un retour Windows / nouvelle ligne dans un élément (généralement un champ d’entrée de texte), en remplaçant le texte existant ou en insérant le retour à une position spécifique.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Handle de fenêtre parent
|
ParentWindowHandle | True | integer |
Handle de fenêtre UIA parent (valeur 1 ou supérieure) pour agir comme point de départ de la recherche. Vous pouvez le découvrir via Inspection à l’aide d’actions telles que « Wait for desktop element » ou « Wait for element ». |
|
Nom de l’élément de recherche
|
SearchElementName | string |
Nom d’élément UIA facultatif à rechercher (à partir du handle de fenêtre parent). Cela peut être découvert par le biais de l’inspection. |
|
|
Nom de la classe d’élément Search
|
SearchElementClassName | string |
Nom de classe d’élément UIA facultatif à rechercher (à partir du handle de fenêtre parent). Cela peut être découvert par le biais de l’inspection. |
|
|
ID d’automatisation de l’élément de recherche
|
SearchElementAutomationId | string |
ID d’automatisation d’élément UIA facultatif à rechercher (à partir du handle de fenêtre parent). Cela peut être découvert par le biais de l’inspection. |
|
|
Type de contrôle localisé de l’élément de recherche
|
SearchLocalizedControlType | string |
Type de contrôle localisé de l’élément UIA facultatif à rechercher (à partir du handle de fenêtre parent). Cela peut être découvert par le biais de l’inspection. |
|
|
Rechercher une sous-arborescence UIA
|
SearchSubTree | boolean |
Si la valeur est true, l’arborescence UIA entière située sous le handle de fenêtre parent est recherchée. Cela est plus approfondi, mais peut prendre plus de temps. Si la valeur est false, seuls les éléments directement sous le handle de fenêtre parent dans l’arborescence UIA sont recherchés. |
|
|
Index de correspondance
|
MatchIndex | integer |
Si plusieurs éléments correspondent à la recherche, quel élément (à partir de 1) doit être mis en correspondance. Peut être utilisé conjointement avec « Trier par colonne » pour choisir l’ordre de tri correspondant. |
|
|
Filtre de recherche
|
SearchFilter | string |
Filtre avancé facultatif pour restreindre davantage la recherche à l’aide d’opérateurs conditionnels et de tout champ d’élément. Exemple 1 : [Width] < 200. Exemple 2 : [Name] like 'Document*' AND [ClassName] like 'Label*'. Pour plus d’exemples, consultez la documentation. |
|
|
Trier par nom de colonne
|
SortByColumn | string |
Si plusieurs éléments correspondent à la recherche, cela vous permet de spécifier la propriété d’élément à trier par. Cela sera utilisé conjointement avec « Match index » pour sélectionner l’élément requis. Par exemple : si « Trier par nom de colonne » est [TopEdge] et « Match index » est 1, l’élément correspondant le plus proche du haut de l’écran est mis en correspondance. |
|
|
L’index de correspondance est croissant
|
MatchIndexAscending | boolean |
Si plusieurs éléments correspondent à la recherche, doit correspondre à « Faire correspondre l’index » en haut de la liste triée (true) ou en bas de la liste triée (false). |
|
|
Remplacer la valeur existante
|
ReplaceExistingValue | boolean |
S’il existe du texte existant dans l’élément, doit-il être remplacé ? |
|
|
Insérer une position
|
InsertPosition | integer |
Position (index) pour commencer à insérer du texte. S’il existe un texte existant, la position d’insertion peut être utilisée pour insérer à une position spécifique dans le texte existant. |
|
|
Nombre maximal d’éléments à rechercher
|
MaxElementsToSearch | integer |
Nombre maximal d’éléments à rechercher lors de la recherche de l’élément cible dans l’arborescence UIA. Cette entrée fonctionne uniquement si le mode de recherche d’élément UIA est « Tree walk » (cela peut être activé dans la page paramètres de l’inspecteur). Par défaut, cette valeur est définie sur 0 (illimité). Cette entrée est généralement utilisée pour optimiser la recherche d’éléments. |
|
|
Profondeur maximale de recherche relative
|
MaxRelativeSearchDepth | integer |
Profondeur maximale de l’arborescence relative à la recherche d’éléments enfants sous l’élément parent. Les éléments enfants directs ont une valeur de profondeur de 1. Cette entrée fonctionne uniquement si le mode de recherche d’élément UIA est « Tree walk » (cela peut être activé dans la page paramètres de l’inspecteur). Défini sur 0 pour une profondeur de recherche illimitée. Cette entrée est généralement utilisée pour optimiser la recherche d’éléments. |
|
|
Nombre maximal d’éléments enfants à rechercher par nœud
|
MaxChildElementsToSearchPerNode | integer |
Nombre maximal d’éléments enfants à rechercher sous chaque élément lors de la recherche de l’arborescence UIA pour l’élément cible. Cette entrée fonctionne uniquement si le mode de recherche d’élément UIA est « Tree walk » (cela peut être activé dans la page paramètres de l’inspecteur). Par défaut, cette valeur est définie sur 0 (illimité). Cette entrée est généralement utilisée pour optimiser la recherche d’éléments. |
|
|
Types de contrôle localisés d’élément à parcourir
|
ElementLocalizedControlTypesNotToTraverse | string |
Liste séparée par des virgules des types de contrôle localisés par des éléments UIA pour ne pas traverser (pas à pas) lors de la recherche de l’arborescence UIA pour l’élément cible. La recherche vérifie toujours si un élément individuel correspond aux critères de recherche, mais il ne recherche aucun élément enfant de cet élément si son type de contrôle localisé figure dans cette liste d’exclusions. Cette entrée fonctionne uniquement si le mode de recherche d’élément UIA est « Tree walk » (cela peut être activé dans la page paramètres de l’inspecteur). Cette entrée est généralement utilisée pour optimiser la recherche d’éléments. |
|
|
Déclencher une exception si la validation d’entrée échoue
|
RaiseExceptionIfInputValidationFails | boolean |
Si cette option est activée, l’agent IA-Connect vérifie la nouvelle valeur de l’élément après avoir mis le texte demandé. Si la nouvelle valeur ne correspond pas à la valeur attendue, une exception est levée. Si cette entrée est false (valeur par défaut), un avertissement est entré dans le journal, mais aucune exception n’est levée. |
|
|
Essayer le modèle de valeur
|
TryValuePattern | boolean |
Si la valeur est true (valeur par défaut), l’agent IA-Connect tente d’utiliser un modèle de valeur UIA pour effectuer l’action d’entrée de texte. Si le modèle de valeur UIA n’est pas disponible dans l’élément choisi, l’agent IA-Connect revient à d’autres modèles (activé ou désactivé via d’autres entrées à cette action). Si la valeur est false, l’agent IA-Connect n’essaie pas d’utiliser un modèle de valeur et revient immédiatement à d’autres modèles choisis. |
|
|
Essayer le modèle hérité
|
TryLegacyPattern | boolean |
Si la valeur est true, l’agent IA-Connect tente d’utiliser un modèle hérité UIA pour effectuer l’action d’entrée de texte si le modèle de valeur n’est pas disponible (soit parce qu’il n’est pas présent sur l’élément ou parce que son utilisation a été désactivée). |
|
|
Flux de travail
|
Workflow | True | string |
Ajoutez l’expression suivante ici : workflow() |
Réduire la fenêtre UIA
Minimise la fenêtre avec le handle UIA spécifié.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Handle de fenêtre
|
WindowHandle | True | integer |
Handle UIA pour la fenêtre à minimiser. |
|
Flux de travail
|
Workflow | True | string |
Ajoutez l’expression suivante ici : workflow() |
Réduire l’élément UIA
Réduit un élément (généralement un menu /élément de liste déroulante). Si l’élément est déjà réduit, rien ne se produit.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Handle de fenêtre parent
|
ParentWindowHandle | True | integer |
Handle de fenêtre UIA parent (valeur 1 ou supérieure) pour agir comme point de départ de la recherche. Vous pouvez le découvrir via Inspection à l’aide d’actions telles que « Wait for desktop element » ou « Wait for element ». |
|
Nom de l’élément de recherche
|
SearchElementName | string |
Nom d’élément UIA facultatif à rechercher (à partir du handle de fenêtre parent). Cela peut être découvert par le biais de l’inspection. |
|
|
Nom de la classe d’élément Search
|
SearchElementClassName | string |
Nom de classe d’élément UIA facultatif à rechercher (à partir du handle de fenêtre parent). Cela peut être découvert par le biais de l’inspection. |
|
|
ID d’automatisation de l’élément de recherche
|
SearchElementAutomationId | string |
ID d’automatisation d’élément UIA facultatif à rechercher (à partir du handle de fenêtre parent). Cela peut être découvert par le biais de l’inspection. |
|
|
Type de contrôle localisé de l’élément de recherche
|
SearchLocalizedControlType | string |
Type de contrôle localisé de l’élément UIA facultatif à rechercher (à partir du handle de fenêtre parent). Cela peut être découvert par le biais de l’inspection. |
|
|
Rechercher une sous-arborescence UIA
|
SearchSubTree | boolean |
Si la valeur est true, l’arborescence UIA entière située sous le handle de fenêtre parent est recherchée. Cela est plus approfondi, mais peut prendre plus de temps. Si la valeur est false, seuls les éléments directement sous le handle de fenêtre parent dans l’arborescence UIA sont recherchés. |
|
|
Index de correspondance
|
MatchIndex | integer |
Si plusieurs éléments correspondent à la recherche, quel élément (à partir de 1) doit être mis en correspondance. Peut être utilisé conjointement avec « Trier par colonne » pour choisir l’ordre de tri correspondant. |
|
|
Filtre de recherche
|
SearchFilter | string |
Filtre avancé facultatif pour restreindre davantage la recherche à l’aide d’opérateurs conditionnels et de tout champ d’élément. Exemple 1 : [Width] < 200. Exemple 2 : [Name] like 'Document*' AND [ClassName] like 'Label*'. Pour plus d’exemples, consultez la documentation. |
|
|
Trier par nom de colonne
|
SortByColumn | string |
Si plusieurs éléments correspondent à la recherche, cela vous permet de spécifier la propriété d’élément à trier par. Cela sera utilisé conjointement avec « Match index » pour sélectionner l’élément requis. Par exemple : si « Trier par nom de colonne » est [TopEdge] et « Match index » est 1, l’élément correspondant le plus proche du haut de l’écran est mis en correspondance. |
|
|
L’index de correspondance est croissant
|
MatchIndexAscending | boolean |
Si plusieurs éléments correspondent à la recherche, doit correspondre à « Faire correspondre l’index » en haut de la liste triée (true) ou en bas de la liste triée (false). |
|
|
Nombre maximal d’éléments à rechercher
|
MaxElementsToSearch | integer |
Nombre maximal d’éléments à rechercher lors de la recherche de l’élément cible dans l’arborescence UIA. Cette entrée fonctionne uniquement si le mode de recherche d’élément UIA est « Tree walk » (cela peut être activé dans la page paramètres de l’inspecteur). Par défaut, cette valeur est définie sur 0 (illimité). Cette entrée est généralement utilisée pour optimiser la recherche d’éléments. |
|
|
Profondeur maximale de recherche relative
|
MaxRelativeSearchDepth | integer |
Profondeur maximale de l’arborescence relative à la recherche d’éléments enfants sous l’élément parent. Les éléments enfants directs ont une valeur de profondeur de 1. Cette entrée fonctionne uniquement si le mode de recherche d’élément UIA est « Tree walk » (cela peut être activé dans la page paramètres de l’inspecteur). Défini sur 0 pour une profondeur de recherche illimitée. Cette entrée est généralement utilisée pour optimiser la recherche d’éléments. |
|
|
Nombre maximal d’éléments enfants à rechercher par nœud
|
MaxChildElementsToSearchPerNode | integer |
Nombre maximal d’éléments enfants à rechercher sous chaque élément lors de la recherche de l’arborescence UIA pour l’élément cible. Cette entrée fonctionne uniquement si le mode de recherche d’élément UIA est « Tree walk » (cela peut être activé dans la page paramètres de l’inspecteur). Par défaut, cette valeur est définie sur 0 (illimité). Cette entrée est généralement utilisée pour optimiser la recherche d’éléments. |
|
|
Types de contrôle localisés d’élément à parcourir
|
ElementLocalizedControlTypesNotToTraverse | string |
Liste séparée par des virgules des types de contrôle localisés par des éléments UIA pour ne pas traverser (pas à pas) lors de la recherche de l’arborescence UIA pour l’élément cible. La recherche vérifie toujours si un élément individuel correspond aux critères de recherche, mais il ne recherche aucun élément enfant de cet élément si son type de contrôle localisé figure dans cette liste d’exclusions. Cette entrée fonctionne uniquement si le mode de recherche d’élément UIA est « Tree walk » (cela peut être activé dans la page paramètres de l’inspecteur). Cette entrée est généralement utilisée pour optimiser la recherche d’éléments. |
|
|
Flux de travail
|
Workflow | True | string |
Ajoutez l’expression suivante ici : workflow() |
Réinitialiser tous les handles d’éléments UIA
Réinitialise tous les handles d’éléments UIA actuellement stockés par IA-Connect qui peuvent être utiles si vous avez identifié un grand nombre d’éléments et que vous avez un grand nombre de handles d’éléments stockés. Dans les scénarios avec un nombre extrêmement élevé de handles d’élément (100 000+), cette action peut également être utilisée pour libérer l’utilisation de la RAM.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Flux de travail
|
Workflow | True | string |
Ajoutez l’expression suivante ici : workflow() |
Sélectionner l’élément UIA
Sélectionne un élément (généralement un élément dans une liste ou une liste déroulante).
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Handle de fenêtre parent
|
ParentWindowHandle | True | integer |
Handle de fenêtre UIA parent (valeur 1 ou supérieure) pour agir comme point de départ de la recherche. Vous pouvez le découvrir via Inspection à l’aide d’actions telles que « Wait for desktop element » ou « Wait for element ». |
|
Nom de l’élément de recherche
|
SearchElementName | string |
Nom d’élément UIA facultatif à rechercher (à partir du handle de fenêtre parent). Cela peut être découvert par le biais de l’inspection. |
|
|
Nom de la classe d’élément Search
|
SearchElementClassName | string |
Nom de classe d’élément UIA facultatif à rechercher (à partir du handle de fenêtre parent). Cela peut être découvert par le biais de l’inspection. |
|
|
ID d’automatisation de l’élément de recherche
|
SearchElementAutomationId | string |
ID d’automatisation d’élément UIA facultatif à rechercher (à partir du handle de fenêtre parent). Cela peut être découvert par le biais de l’inspection. |
|
|
Type de contrôle localisé de l’élément de recherche
|
SearchLocalizedControlType | string |
Type de contrôle localisé de l’élément UIA facultatif à rechercher (à partir du handle de fenêtre parent). Cela peut être découvert par le biais de l’inspection. |
|
|
Rechercher une sous-arborescence UIA
|
SearchSubTree | boolean |
Si la valeur est true, l’arborescence UIA entière située sous le handle de fenêtre parent est recherchée. Cela est plus approfondi, mais peut prendre plus de temps. Si la valeur est false, seuls les éléments directement sous le handle de fenêtre parent dans l’arborescence UIA sont recherchés. |
|
|
Index de correspondance
|
MatchIndex | integer |
Si plusieurs éléments correspondent à la recherche, quel élément (à partir de 1) doit être mis en correspondance. Peut être utilisé conjointement avec « Trier par colonne » pour choisir l’ordre de tri correspondant. |
|
|
Filtre de recherche
|
SearchFilter | string |
Filtre avancé facultatif pour restreindre davantage la recherche à l’aide d’opérateurs conditionnels et de tout champ d’élément. Exemple 1 : [Width] < 200. Exemple 2 : [Name] like 'Document*' AND [ClassName] like 'Label*'. Pour plus d’exemples, consultez la documentation. |
|
|
Trier par nom de colonne
|
SortByColumn | string |
Si plusieurs éléments correspondent à la recherche, cela vous permet de spécifier la propriété d’élément à trier par. Cela sera utilisé conjointement avec « Match index » pour sélectionner l’élément requis. Par exemple : si « Trier par nom de colonne » est [TopEdge] et « Match index » est 1, l’élément correspondant le plus proche du haut de l’écran est mis en correspondance. |
|
|
L’index de correspondance est croissant
|
MatchIndexAscending | boolean |
Si plusieurs éléments correspondent à la recherche, doit correspondre à « Faire correspondre l’index » en haut de la liste triée (true) ou en bas de la liste triée (false). |
|
|
Nombre maximal d’éléments à rechercher
|
MaxElementsToSearch | integer |
Nombre maximal d’éléments à rechercher lors de la recherche de l’élément cible dans l’arborescence UIA. Cette entrée fonctionne uniquement si le mode de recherche d’élément UIA est « Tree walk » (cela peut être activé dans la page paramètres de l’inspecteur). Par défaut, cette valeur est définie sur 0 (illimité). Cette entrée est généralement utilisée pour optimiser la recherche d’éléments. |
|
|
Profondeur maximale de recherche relative
|
MaxRelativeSearchDepth | integer |
Profondeur maximale de l’arborescence relative à la recherche d’éléments enfants sous l’élément parent. Les éléments enfants directs ont une valeur de profondeur de 1. Cette entrée fonctionne uniquement si le mode de recherche d’élément UIA est « Tree walk » (cela peut être activé dans la page paramètres de l’inspecteur). Défini sur 0 pour une profondeur de recherche illimitée. Cette entrée est généralement utilisée pour optimiser la recherche d’éléments. |
|
|
Nombre maximal d’éléments enfants à rechercher par nœud
|
MaxChildElementsToSearchPerNode | integer |
Nombre maximal d’éléments enfants à rechercher sous chaque élément lors de la recherche de l’arborescence UIA pour l’élément cible. Cette entrée fonctionne uniquement si le mode de recherche d’élément UIA est « Tree walk » (cela peut être activé dans la page paramètres de l’inspecteur). Par défaut, cette valeur est définie sur 0 (illimité). Cette entrée est généralement utilisée pour optimiser la recherche d’éléments. |
|
|
Types de contrôle localisés d’élément à parcourir
|
ElementLocalizedControlTypesNotToTraverse | string |
Liste séparée par des virgules des types de contrôle localisés par des éléments UIA pour ne pas traverser (pas à pas) lors de la recherche de l’arborescence UIA pour l’élément cible. La recherche vérifie toujours si un élément individuel correspond aux critères de recherche, mais il ne recherche aucun élément enfant de cet élément si son type de contrôle localisé figure dans cette liste d’exclusions. Cette entrée fonctionne uniquement si le mode de recherche d’élément UIA est « Tree walk » (cela peut être activé dans la page paramètres de l’inspecteur). Cette entrée est généralement utilisée pour optimiser la recherche d’éléments. |
|
|
Flux de travail
|
Workflow | True | string |
Ajoutez l’expression suivante ici : workflow() |
Texte d’entrée dans l’élément UIA
Action UIA qui insère du texte dans un élément (généralement un champ d’entrée de texte), en remplaçant le texte existant ou en insérant la nouvelle valeur à une position spécifique.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Handle de fenêtre parent
|
ParentWindowHandle | True | integer |
Handle de fenêtre UIA parent (valeur 1 ou supérieure) pour agir comme point de départ de la recherche. Vous pouvez le découvrir via Inspection à l’aide d’actions telles que « Wait for desktop element » ou « Wait for element ». |
|
Nom de l’élément de recherche
|
SearchElementName | string |
Nom d’élément UIA facultatif à rechercher (à partir du handle de fenêtre parent). Cela peut être découvert par le biais de l’inspection. |
|
|
Nom de la classe d’élément Search
|
SearchElementClassName | string |
Nom de classe d’élément UIA facultatif à rechercher (à partir du handle de fenêtre parent). Cela peut être découvert par le biais de l’inspection. |
|
|
ID d’automatisation de l’élément de recherche
|
SearchElementAutomationId | string |
ID d’automatisation d’élément UIA facultatif à rechercher (à partir du handle de fenêtre parent). Cela peut être découvert par le biais de l’inspection. |
|
|
Type de contrôle localisé de l’élément de recherche
|
SearchLocalizedControlType | string |
Type de contrôle localisé de l’élément UIA facultatif à rechercher (à partir du handle de fenêtre parent). Cela peut être découvert par le biais de l’inspection. |
|
|
Rechercher une sous-arborescence UIA
|
SearchSubTree | boolean |
Si la valeur est true, l’arborescence UIA entière située sous le handle de fenêtre parent est recherchée. Cela est plus approfondi, mais peut prendre plus de temps. Si la valeur est false, seuls les éléments directement sous le handle de fenêtre parent dans l’arborescence UIA sont recherchés. |
|
|
Texte à entrer
|
TextToInput | string |
Valeur de texte à entrer. |
|
|
Index de correspondance
|
MatchIndex | integer |
Si plusieurs éléments correspondent à la recherche, quel élément (à partir de 1) doit être mis en correspondance. Peut être utilisé conjointement avec « Trier par colonne » pour choisir l’ordre de tri correspondant. |
|
|
Filtre de recherche
|
SearchFilter | string |
Filtre avancé facultatif pour restreindre davantage la recherche à l’aide d’opérateurs conditionnels et de tout champ d’élément. Exemple 1 : [Width] < 200. Exemple 2 : [Name] like 'Document*' AND [ClassName] like 'Label*'. Pour plus d’exemples, consultez la documentation. |
|
|
Trier par nom de colonne
|
SortByColumn | string |
Si plusieurs éléments correspondent à la recherche, cela vous permet de spécifier la propriété d’élément à trier par. Cela sera utilisé conjointement avec « Match index » pour sélectionner l’élément requis. Par exemple : si « Trier par nom de colonne » est [TopEdge] et « Match index » est 1, l’élément correspondant le plus proche du haut de l’écran est mis en correspondance. |
|
|
L’index de correspondance est croissant
|
MatchIndexAscending | boolean |
Si plusieurs éléments correspondent à la recherche, doit correspondre à « Faire correspondre l’index » en haut de la liste triée (true) ou en bas de la liste triée (false). |
|
|
Remplacer la valeur existante
|
ReplaceExistingValue | boolean |
S’il existe du texte existant dans l’élément, doit-il être remplacé ? |
|
|
Insérer une position
|
InsertPosition | integer |
Position (index) pour commencer à insérer du texte. S’il existe un texte existant, la position d’insertion peut être utilisée pour insérer à une position spécifique dans le texte existant. |
|
|
Nombre maximal d’éléments à rechercher
|
MaxElementsToSearch | integer |
Nombre maximal d’éléments à rechercher lors de la recherche de l’élément cible dans l’arborescence UIA. Cette entrée fonctionne uniquement si le mode de recherche d’élément UIA est « Tree walk » (cela peut être activé dans la page paramètres de l’inspecteur). Par défaut, cette valeur est définie sur 0 (illimité). Cette entrée est généralement utilisée pour optimiser la recherche d’éléments. |
|
|
Profondeur maximale de recherche relative
|
MaxRelativeSearchDepth | integer |
Profondeur maximale de l’arborescence relative à la recherche d’éléments enfants sous l’élément parent. Les éléments enfants directs ont une valeur de profondeur de 1. Cette entrée fonctionne uniquement si le mode de recherche d’élément UIA est « Tree walk » (cela peut être activé dans la page paramètres de l’inspecteur). Défini sur 0 pour une profondeur de recherche illimitée. Cette entrée est généralement utilisée pour optimiser la recherche d’éléments. |
|
|
Nombre maximal d’éléments enfants à rechercher par nœud
|
MaxChildElementsToSearchPerNode | integer |
Nombre maximal d’éléments enfants à rechercher sous chaque élément lors de la recherche de l’arborescence UIA pour l’élément cible. Cette entrée fonctionne uniquement si le mode de recherche d’élément UIA est « Tree walk » (cela peut être activé dans la page paramètres de l’inspecteur). Par défaut, cette valeur est définie sur 0 (illimité). Cette entrée est généralement utilisée pour optimiser la recherche d’éléments. |
|
|
Types de contrôle localisés d’élément à parcourir
|
ElementLocalizedControlTypesNotToTraverse | string |
Liste séparée par des virgules des types de contrôle localisés par des éléments UIA pour ne pas traverser (pas à pas) lors de la recherche de l’arborescence UIA pour l’élément cible. La recherche vérifie toujours si un élément individuel correspond aux critères de recherche, mais il ne recherche aucun élément enfant de cet élément si son type de contrôle localisé figure dans cette liste d’exclusions. Cette entrée fonctionne uniquement si le mode de recherche d’élément UIA est « Tree walk » (cela peut être activé dans la page paramètres de l’inspecteur). Cette entrée est généralement utilisée pour optimiser la recherche d’éléments. |
|
|
Déclencher une exception si la validation d’entrée échoue
|
RaiseExceptionIfInputValidationFails | boolean |
Si cette option est activée, l’agent IA-Connect vérifie la nouvelle valeur de l’élément après avoir mis le texte demandé. Si la nouvelle valeur ne correspond pas à la valeur attendue, une exception est levée. Si cette entrée est false (valeur par défaut), un avertissement est entré dans le journal, mais aucune exception n’est levée. |
|
|
Essayer le modèle de valeur
|
TryValuePattern | boolean |
Si la valeur est true (valeur par défaut), l’agent IA-Connect tente d’utiliser un modèle de valeur UIA pour effectuer l’action d’entrée de texte. Si le modèle de valeur UIA n’est pas disponible dans l’élément choisi, l’agent IA-Connect revient à d’autres modèles (activé ou désactivé via d’autres entrées à cette action). Si la valeur est false, l’agent IA-Connect n’essaie pas d’utiliser un modèle de valeur et revient immédiatement à d’autres modèles choisis. |
|
|
Essayer le modèle hérité
|
TryLegacyPattern | boolean |
Si la valeur est true, l’agent IA-Connect tente d’utiliser un modèle hérité UIA pour effectuer l’action d’entrée de texte si le modèle de valeur n’est pas disponible (soit parce qu’il n’est pas présent sur l’élément ou parce que son utilisation a été désactivée). |
|
|
Flux de travail
|
Workflow | True | string |
Ajoutez l’expression suivante ici : workflow() |
Texte d’entrée global dans l’élément UIA
Déplace la souris au centre de l’élément, la met au focus, les cliques gauches et appuie sur les touches. Généralement utilisé avec une entrée de texte qui n’accepte pas les méthodes d’entrée UIA natives.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Handle de fenêtre parent
|
ParentWindowHandle | True | integer |
Handle de fenêtre UIA parent (valeur 1 ou supérieure) pour agir comme point de départ de la recherche. Vous pouvez le découvrir via Inspection à l’aide d’actions telles que « Wait for desktop element » ou « Wait for element ». |
|
Nom de l’élément de recherche
|
SearchElementName | string |
Nom d’élément UIA facultatif à rechercher (à partir du handle de fenêtre parent). Cela peut être découvert par le biais de l’inspection. |
|
|
Nom de la classe d’élément Search
|
SearchElementClassName | string |
Nom de classe d’élément UIA facultatif à rechercher (à partir du handle de fenêtre parent). Cela peut être découvert par le biais de l’inspection. |
|
|
ID d’automatisation de l’élément de recherche
|
SearchElementAutomationId | string |
ID d’automatisation d’élément UIA facultatif à rechercher (à partir du handle de fenêtre parent). Cela peut être découvert par le biais de l’inspection. |
|
|
Type de contrôle localisé de l’élément de recherche
|
SearchLocalizedControlType | string |
Type de contrôle localisé de l’élément UIA facultatif à rechercher (à partir du handle de fenêtre parent). Cela peut être découvert par le biais de l’inspection. |
|
|
Rechercher une sous-arborescence UIA
|
SearchSubTree | boolean |
Si la valeur est true, l’arborescence UIA entière située sous le handle de fenêtre parent est recherchée. Cela est plus approfondi, mais peut prendre plus de temps. Si la valeur est false, seuls les éléments directement sous le handle de fenêtre parent dans l’arborescence UIA sont recherchés. |
|
|
Index de correspondance
|
MatchIndex | integer |
Si plusieurs éléments correspondent à la recherche, quel élément (à partir de 1) doit être mis en correspondance. Peut être utilisé conjointement avec « Trier par colonne » pour choisir l’ordre de tri correspondant. |
|
|
Filtre de recherche
|
SearchFilter | string |
Filtre avancé facultatif pour restreindre davantage la recherche à l’aide d’opérateurs conditionnels et de tout champ d’élément. Exemple 1 : [Width] < 200. Exemple 2 : [Name] like 'Document*' AND [ClassName] like 'Label*'. Pour plus d’exemples, consultez la documentation. |
|
|
Trier par nom de colonne
|
SortByColumn | string |
Si plusieurs éléments correspondent à la recherche, cela vous permet de spécifier la propriété d’élément à trier par. Cela sera utilisé conjointement avec « Match index » pour sélectionner l’élément requis. Par exemple : si « Trier par nom de colonne » est [TopEdge] et « Match index » est 1, l’élément correspondant le plus proche du haut de l’écran est mis en correspondance. |
|
|
L’index de correspondance est croissant
|
MatchIndexAscending | boolean |
Si plusieurs éléments correspondent à la recherche, doit correspondre à « Faire correspondre l’index » en haut de la liste triée (true) ou en bas de la liste triée (false). |
|
|
Élément Focus en premier
|
FocusElement | boolean |
Doit-il IA-Connect tenter de concentrer l’élément avant un clic global ? |
|
|
Clic global gauche sur l’élément
|
GlobalMouseClickOnElement | boolean |
Un clic global de la souris doit-il être effectué sur les coordonnées de l’élément (pour concentrer l’élément) avant d’entrer du texte ? |
|
|
Remplacer la valeur existante à l’aide d’un double clic de souris
|
ReplaceExistingValueUsingDoubleClickDelete | boolean |
Une valeur existante doit-elle être remplacée en double-cliquant sur la souris (pour la mettre en surbrillance), puis en supprimant ? |
|
|
Remplacer la valeur existante à l’aide de CTRL-A supprimer
|
ReplaceExistingValueUsingCTRLADelete | boolean |
Une valeur existante doit-elle être remplacée en appuyant sur Ctrl-A (pour mettre en surbrillance tout), puis en supprimant ? Certains éléments peuvent ne pas prendre en charge la mise en surbrillance avec Ctrl-A auquel cas l’option alternative « Remplacer la valeur existante à l’aide d’une double suppression de la souris » doit être tentée. |
|
|
Texte à entrer
|
TextToInput | string |
Valeur de texte en entrée globale à l’aide du clavier. |
|
|
Utiliser les événements d’envoi de clés
|
SendKeyEvents | boolean |
Si la valeur est true, envoyez des événements de clé (une API de niveau inférieur qui envoie des séquences de touches simulées au système d’exploitation) seront utilisés. Si la valeur est false, les clés d’envoi (une API de niveau supérieur qui envoie des séquences de touches à l’élément prioritaire) sont utilisées à la place. |
|
|
Intervalle en millisecondes
|
Interval | integer |
Nombre de millisecondes entre chaque touche de pression. |
|
|
Ne pas interpréter les symboles
|
DontInterpretSymbols | boolean |
Les symboles du texte à entrer ne doivent-ils pas être interprétés comme des touches spéciales (par exemple, + pour Maj, ^ pour Ctrl) ? Cette valeur doit être définie sur true si vous tentez d’entrer les symboles réels. |
|
|
Nombre maximal d’éléments à rechercher
|
MaxElementsToSearch | integer |
Nombre maximal d’éléments à rechercher lors de la recherche de l’élément cible dans l’arborescence UIA. Cette entrée fonctionne uniquement si le mode de recherche d’élément UIA est « Tree walk » (cela peut être activé dans la page paramètres de l’inspecteur). Par défaut, cette valeur est définie sur 0 (illimité). Cette entrée est généralement utilisée pour optimiser la recherche d’éléments. |
|
|
Profondeur maximale de recherche relative
|
MaxRelativeSearchDepth | integer |
Profondeur maximale de l’arborescence relative à la recherche d’éléments enfants sous l’élément parent. Les éléments enfants directs ont une valeur de profondeur de 1. Cette entrée fonctionne uniquement si le mode de recherche d’élément UIA est « Tree walk » (cela peut être activé dans la page paramètres de l’inspecteur). Défini sur 0 pour une profondeur de recherche illimitée. Cette entrée est généralement utilisée pour optimiser la recherche d’éléments. |
|
|
Nombre maximal d’éléments enfants à rechercher par nœud
|
MaxChildElementsToSearchPerNode | integer |
Nombre maximal d’éléments enfants à rechercher sous chaque élément lors de la recherche de l’arborescence UIA pour l’élément cible. Cette entrée fonctionne uniquement si le mode de recherche d’élément UIA est « Tree walk » (cela peut être activé dans la page paramètres de l’inspecteur). Par défaut, cette valeur est définie sur 0 (illimité). Cette entrée est généralement utilisée pour optimiser la recherche d’éléments. |
|
|
Types de contrôle localisés d’élément à parcourir
|
ElementLocalizedControlTypesNotToTraverse | string |
Liste séparée par des virgules des types de contrôle localisés par des éléments UIA pour ne pas traverser (pas à pas) lors de la recherche de l’arborescence UIA pour l’élément cible. La recherche vérifie toujours si un élément individuel correspond aux critères de recherche, mais il ne recherche aucun élément enfant de cet élément si son type de contrôle localisé figure dans cette liste d’exclusions. Cette entrée fonctionne uniquement si le mode de recherche d’élément UIA est « Tree walk » (cela peut être activé dans la page paramètres de l’inspecteur). Cette entrée est généralement utilisée pour optimiser la recherche d’éléments. |
|
|
Valider le point cliquable dans la limite de l’élément
|
ValidateClickablePointWithinElementBoundary | boolean |
Pour certains éléments, UIA n’a pas connaissance d’un point cliquable dans l’élément et retourne une coordonnée non valide (par exemple 0,0) au lieu du centre de l’élément. Si cette entrée est définie sur true, IA-Connect vérifie la validité de la coordonnée fournie par UIA et, si elle n’est pas comprise dans la limite de l’élément, ignore la valeur fournie par UIA et utilise le centre de l’élément à la place. |
|
|
Flux de travail
|
Workflow | True | string |
Ajoutez l’expression suivante ici : workflow() |
Vérifier l’élément UIA
Définit l’état d’un élément (généralement une case à cocher ou une case d’option) sur activé ou désactivé.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Handle de fenêtre parent
|
ParentWindowHandle | True | integer |
Handle de fenêtre UIA parent (valeur 1 ou supérieure) pour agir comme point de départ de la recherche. Vous pouvez le découvrir via Inspection à l’aide d’actions telles que « Wait for desktop element » ou « Wait for element ». |
|
Nom de l’élément de recherche
|
SearchElementName | string |
Nom d’élément UIA facultatif à rechercher (à partir du handle de fenêtre parent). Cela peut être découvert par le biais de l’inspection. |
|
|
Nom de la classe d’élément Search
|
SearchElementClassName | string |
Nom de classe d’élément UIA facultatif à rechercher (à partir du handle de fenêtre parent). Cela peut être découvert par le biais de l’inspection. |
|
|
ID d’automatisation de l’élément de recherche
|
SearchElementAutomationId | string |
ID d’automatisation d’élément UIA facultatif à rechercher (à partir du handle de fenêtre parent). Cela peut être découvert par le biais de l’inspection. |
|
|
Type de contrôle localisé de l’élément de recherche
|
SearchLocalizedControlType | string |
Type de contrôle localisé de l’élément UIA facultatif à rechercher (à partir du handle de fenêtre parent). Cela peut être découvert par le biais de l’inspection. |
|
|
Rechercher une sous-arborescence UIA
|
SearchSubTree | boolean |
Si la valeur est true, l’arborescence UIA entière située sous le handle de fenêtre parent est recherchée. Cela est plus approfondi, mais peut prendre plus de temps. Si la valeur est false, seuls les éléments directement sous le handle de fenêtre parent dans l’arborescence UIA sont recherchés. |
|
|
Élément Check
|
CheckElement | boolean |
L’élément doit-il être vérifié (true) ou désactivé (false) ? |
|
|
Index de correspondance
|
MatchIndex | integer |
Si plusieurs éléments correspondent à la recherche, quel élément (à partir de 1) doit être mis en correspondance. Peut être utilisé conjointement avec « Trier par colonne » pour choisir l’ordre de tri correspondant. |
|
|
Filtre de recherche
|
SearchFilter | string |
Filtre avancé facultatif pour restreindre davantage la recherche à l’aide d’opérateurs conditionnels et de tout champ d’élément. Exemple 1 : [Width] < 200. Exemple 2 : [Name] like 'Document*' AND [ClassName] like 'Label*'. Pour plus d’exemples, consultez la documentation. |
|
|
Trier par nom de colonne
|
SortByColumn | string |
Si plusieurs éléments correspondent à la recherche, cela vous permet de spécifier la propriété d’élément à trier par. Cela sera utilisé conjointement avec « Match index » pour sélectionner l’élément requis. Par exemple : si « Trier par nom de colonne » est [TopEdge] et « Match index » est 1, l’élément correspondant le plus proche du haut de l’écran est mis en correspondance. |
|
|
L’index de correspondance est croissant
|
MatchIndexAscending | boolean |
Si plusieurs éléments correspondent à la recherche, doit correspondre à « Faire correspondre l’index » en haut de la liste triée (true) ou en bas de la liste triée (false). |
|
|
Nombre maximal d’éléments à rechercher
|
MaxElementsToSearch | integer |
Nombre maximal d’éléments à rechercher lors de la recherche de l’élément cible dans l’arborescence UIA. Cette entrée fonctionne uniquement si le mode de recherche d’élément UIA est « Tree walk » (cela peut être activé dans la page paramètres de l’inspecteur). Par défaut, cette valeur est définie sur 0 (illimité). Cette entrée est généralement utilisée pour optimiser la recherche d’éléments. |
|
|
Profondeur maximale de recherche relative
|
MaxRelativeSearchDepth | integer |
Profondeur maximale de l’arborescence relative à la recherche d’éléments enfants sous l’élément parent. Les éléments enfants directs ont une valeur de profondeur de 1. Cette entrée fonctionne uniquement si le mode de recherche d’élément UIA est « Tree walk » (cela peut être activé dans la page paramètres de l’inspecteur). Défini sur 0 pour une profondeur de recherche illimitée. Cette entrée est généralement utilisée pour optimiser la recherche d’éléments. |
|
|
Nombre maximal d’éléments enfants à rechercher par nœud
|
MaxChildElementsToSearchPerNode | integer |
Nombre maximal d’éléments enfants à rechercher sous chaque élément lors de la recherche de l’arborescence UIA pour l’élément cible. Cette entrée fonctionne uniquement si le mode de recherche d’élément UIA est « Tree walk » (cela peut être activé dans la page paramètres de l’inspecteur). Par défaut, cette valeur est définie sur 0 (illimité). Cette entrée est généralement utilisée pour optimiser la recherche d’éléments. |
|
|
Types de contrôle localisés d’élément à parcourir
|
ElementLocalizedControlTypesNotToTraverse | string |
Liste séparée par des virgules des types de contrôle localisés par des éléments UIA pour ne pas traverser (pas à pas) lors de la recherche de l’arborescence UIA pour l’élément cible. La recherche vérifie toujours si un élément individuel correspond aux critères de recherche, mais il ne recherche aucun élément enfant de cet élément si son type de contrôle localisé figure dans cette liste d’exclusions. Cette entrée fonctionne uniquement si le mode de recherche d’élément UIA est « Tree walk » (cela peut être activé dans la page paramètres de l’inspecteur). Cette entrée est généralement utilisée pour optimiser la recherche d’éléments. |
|
|
Flux de travail
|
Workflow | True | string |
Ajoutez l’expression suivante ici : workflow() |
Vérifier plusieurs éléments UIA
Définit l’état de plusieurs éléments (généralement une case à cocher ou une case d’option) sur activé ou désactivé.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Éléments d’entrée
|
InputElementsJSON | True | string |
Tableau d’éléments UIA à vérifier, au format JSON. |
|
Flux de travail
|
Workflow | True | string |
Ajoutez l’expression suivante ici : workflow() |
Élément Focus UIA
Concentre un élément qui le rend actif pour le focus clavier et, selon l’application, peut amener la fenêtre d’élément au premier plan.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Handle de fenêtre parent
|
ParentWindowHandle | True | integer |
Handle de fenêtre UIA parent (valeur 1 ou supérieure) pour agir comme point de départ de la recherche. Vous pouvez le découvrir via Inspection à l’aide d’actions telles que « Wait for desktop element » ou « Wait for element ». |
|
Nom de l’élément de recherche
|
SearchElementName | string |
Nom d’élément UIA facultatif à rechercher (à partir du handle de fenêtre parent). Cela peut être découvert par le biais de l’inspection. |
|
|
Nom de la classe d’élément Search
|
SearchElementClassName | string |
Nom de classe d’élément UIA facultatif à rechercher (à partir du handle de fenêtre parent). Cela peut être découvert par le biais de l’inspection. |
|
|
ID d’automatisation de l’élément de recherche
|
SearchElementAutomationId | string |
ID d’automatisation d’élément UIA facultatif à rechercher (à partir du handle de fenêtre parent). Cela peut être découvert par le biais de l’inspection. |
|
|
Type de contrôle localisé de l’élément de recherche
|
SearchLocalizedControlType | string |
Type de contrôle localisé de l’élément UIA facultatif à rechercher (à partir du handle de fenêtre parent). Cela peut être découvert par le biais de l’inspection. |
|
|
Rechercher une sous-arborescence UIA
|
SearchSubTree | boolean |
Si la valeur est true, l’arborescence UIA entière située sous le handle de fenêtre parent est recherchée. Cela est plus approfondi, mais peut prendre plus de temps. Si la valeur est false, seuls les éléments directement sous le handle de fenêtre parent dans l’arborescence UIA sont recherchés. |
|
|
Index de correspondance
|
MatchIndex | integer |
Si plusieurs éléments correspondent à la recherche, quel élément (à partir de 1) doit être mis en correspondance. Peut être utilisé conjointement avec « Trier par colonne » pour choisir l’ordre de tri correspondant. |
|
|
Filtre de recherche
|
SearchFilter | string |
Filtre avancé facultatif pour restreindre davantage la recherche à l’aide d’opérateurs conditionnels et de tout champ d’élément. Exemple 1 : [Width] < 200. Exemple 2 : [Name] like 'Document*' AND [ClassName] like 'Label*'. Pour plus d’exemples, consultez la documentation. |
|
|
Trier par nom de colonne
|
SortByColumn | string |
Si plusieurs éléments correspondent à la recherche, cela vous permet de spécifier la propriété d’élément à trier par. Cela sera utilisé conjointement avec « Match index » pour sélectionner l’élément requis. Par exemple : si « Trier par nom de colonne » est [TopEdge] et « Match index » est 1, l’élément correspondant le plus proche du haut de l’écran est mis en correspondance. |
|
|
L’index de correspondance est croissant
|
MatchIndexAscending | boolean |
Si plusieurs éléments correspondent à la recherche, doit correspondre à « Faire correspondre l’index » en haut de la liste triée (true) ou en bas de la liste triée (false). |
|
|
Nombre maximal d’éléments à rechercher
|
MaxElementsToSearch | integer |
Nombre maximal d’éléments à rechercher lors de la recherche de l’élément cible dans l’arborescence UIA. Cette entrée fonctionne uniquement si le mode de recherche d’élément UIA est « Tree walk » (cela peut être activé dans la page paramètres de l’inspecteur). Par défaut, cette valeur est définie sur 0 (illimité). Cette entrée est généralement utilisée pour optimiser la recherche d’éléments. |
|
|
Profondeur maximale de recherche relative
|
MaxRelativeSearchDepth | integer |
Profondeur maximale de l’arborescence relative à la recherche d’éléments enfants sous l’élément parent. Les éléments enfants directs ont une valeur de profondeur de 1. Cette entrée fonctionne uniquement si le mode de recherche d’élément UIA est « Tree walk » (cela peut être activé dans la page paramètres de l’inspecteur). Défini sur 0 pour une profondeur de recherche illimitée. Cette entrée est généralement utilisée pour optimiser la recherche d’éléments. |
|
|
Nombre maximal d’éléments enfants à rechercher par nœud
|
MaxChildElementsToSearchPerNode | integer |
Nombre maximal d’éléments enfants à rechercher sous chaque élément lors de la recherche de l’arborescence UIA pour l’élément cible. Cette entrée fonctionne uniquement si le mode de recherche d’élément UIA est « Tree walk » (cela peut être activé dans la page paramètres de l’inspecteur). Par défaut, cette valeur est définie sur 0 (illimité). Cette entrée est généralement utilisée pour optimiser la recherche d’éléments. |
|
|
Types de contrôle localisés d’élément à parcourir
|
ElementLocalizedControlTypesNotToTraverse | string |
Liste séparée par des virgules des types de contrôle localisés par des éléments UIA pour ne pas traverser (pas à pas) lors de la recherche de l’arborescence UIA pour l’élément cible. La recherche vérifie toujours si un élément individuel correspond aux critères de recherche, mais il ne recherche aucun élément enfant de cet élément si son type de contrôle localisé figure dans cette liste d’exclusions. Cette entrée fonctionne uniquement si le mode de recherche d’élément UIA est « Tree walk » (cela peut être activé dans la page paramètres de l’inspecteur). Cette entrée est généralement utilisée pour optimiser la recherche d’éléments. |
|
|
Flux de travail
|
Workflow | True | string |
Ajoutez l’expression suivante ici : workflow() |
Élément Move UIA
Déplace un élément UIA vers une position spécifiée sur l’écran. Cette action fonctionne généralement uniquement avec les éléments Window (qui ont le modèle de transformation).
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Handle de fenêtre parent
|
ParentWindowHandle | True | integer |
Handle de fenêtre UIA parent (valeur 1 ou supérieure) pour agir comme point de départ de la recherche. Vous pouvez le découvrir via Inspection à l’aide d’actions telles que « Wait for desktop element » ou « Wait for element ». |
|
Nom de l’élément de recherche
|
SearchElementName | string |
Nom d’élément UIA facultatif à rechercher (à partir du handle de fenêtre parent). Cela peut être découvert par le biais de l’inspection. |
|
|
Nom de la classe d’élément Search
|
SearchElementClassName | string |
Nom de classe d’élément UIA facultatif à rechercher (à partir du handle de fenêtre parent). Cela peut être découvert par le biais de l’inspection. |
|
|
ID d’automatisation de l’élément de recherche
|
SearchElementAutomationId | string |
ID d’automatisation d’élément UIA facultatif à rechercher (à partir du handle de fenêtre parent). Cela peut être découvert par le biais de l’inspection. |
|
|
Type de contrôle localisé de l’élément de recherche
|
SearchLocalizedControlType | string |
Type de contrôle localisé de l’élément UIA facultatif à rechercher (à partir du handle de fenêtre parent). Cela peut être découvert par le biais de l’inspection. |
|
|
Rechercher une sous-arborescence UIA
|
SearchSubTree | boolean |
Si la valeur est true, l’arborescence UIA entière située sous le handle de fenêtre parent est recherchée. Cela est plus approfondi, mais peut prendre plus de temps. Si la valeur est false, seuls les éléments directement sous le handle de fenêtre parent dans l’arborescence UIA sont recherchés. |
|
|
Index de correspondance
|
MatchIndex | integer |
Si plusieurs éléments correspondent à la recherche, quel élément (à partir de 1) doit être mis en correspondance. Peut être utilisé conjointement avec « Trier par colonne » pour choisir l’ordre de tri correspondant. |
|
|
Filtre de recherche
|
SearchFilter | string |
Filtre avancé facultatif pour restreindre davantage la recherche à l’aide d’opérateurs conditionnels et de tout champ d’élément. Exemple 1 : [Width] < 200. Exemple 2 : [Name] like 'Document*' AND [ClassName] like 'Label*'. Pour plus d’exemples, consultez la documentation. |
|
|
Trier par nom de colonne
|
SortByColumn | string |
Si plusieurs éléments correspondent à la recherche, cela vous permet de spécifier la propriété d’élément à trier par. Cela sera utilisé conjointement avec « Match index » pour sélectionner l’élément requis. Par exemple : si « Trier par nom de colonne » est [TopEdge] et « Match index » est 1, l’élément correspondant le plus proche du haut de l’écran est mis en correspondance. |
|
|
L’index de correspondance est croissant
|
MatchIndexAscending | boolean |
Si plusieurs éléments correspondent à la recherche, doit correspondre à « Faire correspondre l’index » en haut de la liste triée (true) ou en bas de la liste triée (false). |
|
|
Nombre maximal d’éléments à rechercher
|
MaxElementsToSearch | integer |
Nombre maximal d’éléments à rechercher lors de la recherche de l’élément cible dans l’arborescence UIA. Cette entrée fonctionne uniquement si le mode de recherche d’élément UIA est « Tree walk » (cela peut être activé dans la page paramètres de l’inspecteur). Par défaut, cette valeur est définie sur 0 (illimité). Cette entrée est généralement utilisée pour optimiser la recherche d’éléments. |
|
|
Profondeur maximale de recherche relative
|
MaxRelativeSearchDepth | integer |
Profondeur maximale de l’arborescence relative à la recherche d’éléments enfants sous l’élément parent. Les éléments enfants directs ont une valeur de profondeur de 1. Cette entrée fonctionne uniquement si le mode de recherche d’élément UIA est « Tree walk » (cela peut être activé dans la page paramètres de l’inspecteur). Défini sur 0 pour une profondeur de recherche illimitée. Cette entrée est généralement utilisée pour optimiser la recherche d’éléments. |
|
|
Nombre maximal d’éléments enfants à rechercher par nœud
|
MaxChildElementsToSearchPerNode | integer |
Nombre maximal d’éléments enfants à rechercher sous chaque élément lors de la recherche de l’arborescence UIA pour l’élément cible. Cette entrée fonctionne uniquement si le mode de recherche d’élément UIA est « Tree walk » (cela peut être activé dans la page paramètres de l’inspecteur). Par défaut, cette valeur est définie sur 0 (illimité). Cette entrée est généralement utilisée pour optimiser la recherche d’éléments. |
|
|
Types de contrôle localisés d’élément à parcourir
|
ElementLocalizedControlTypesNotToTraverse | string |
Liste séparée par des virgules des types de contrôle localisés par des éléments UIA pour ne pas traverser (pas à pas) lors de la recherche de l’arborescence UIA pour l’élément cible. La recherche vérifie toujours si un élément individuel correspond aux critères de recherche, mais il ne recherche aucun élément enfant de cet élément si son type de contrôle localisé figure dans cette liste d’exclusions. Cette entrée fonctionne uniquement si le mode de recherche d’élément UIA est « Tree walk » (cela peut être activé dans la page paramètres de l’inspecteur). Cette entrée est généralement utilisée pour optimiser la recherche d’éléments. |
|
|
Type de mouvement horizontal
|
HorizontalMovementType | string |
Type de mouvement : Absolu ou relatif. |
|
|
Position horizontale
|
HorizontalPosition | True | integer |
Nouvelle position horizontale de l’élément. Le type de mouvement (par exemple, absolu ou relatif) est défini par l’entrée « Type de mouvement horizontal ». Pour laisser la position horizontale inchangée, choisissez une valeur de 0 et définissez « Type de mouvement horizontal » sur « Relative ». |
|
Type de mouvement vertical
|
VerticalMovementType | string |
Type de mouvement : Absolu ou relatif. |
|
|
Position verticale
|
VerticalPosition | True | integer |
Nouvelle position verticale de l’élément. Le type de mouvement (par exemple, absolu ou relatif) est défini par l’entrée « Type de mouvement vertical ». Pour laisser la position verticale inchangée, choisissez la valeur 0 et définissez « Type de mouvement vertical » sur « Relative ». |
|
Flux de travail
|
Workflow | True | string |
Ajoutez l’expression suivante ici : workflow() |
Retours
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
Résultat de la commande
|
UIAMoveElementResult | boolean |
Résultat de la commande (réussite ou échec). |
|
Message d'erreur
|
ErrorMessage | string |
Si la commande n’a pas réussi, cela contiendra le message d’erreur retourné. |