Partager via


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