- Vue d'ensemble (Overview)
- Automatisation de l'interface utilisateur
- Applications et technologies automatisées avec UI Automation
- Compatibilité du projet
- UI-ANA-016 - Extraire l'URL ouverte du navigateur
- UI-ANA-017 - ContinuerSurErreur (ContinueOnError) True
- UI-ANA-018 - Répertorier les activités d'OCR/d'image
- UI-DBP-006 - Utilisation du conteneur
- UI-DBP-013 - Utilisation abusive de l’automatisation Excel
- UI-DBP-030 - Utilisation de variables interdites dans les sélecteurs
- UI-PRR-001 - Simuler un clic
- UI-PRR-002 - Type de simulation
- UI-PRR-003 - Ouverture d'une utilisation abusive de l'application
- UI-PRR-004 - Délais codés en dur
- UI-REL-001 - Idx volumineux dans les sélecteurs
- UI-SEC-004 - Données d’e-mail du sélecteur
- UI-SEC-010 - Restrictions d'applications/d'URL
- UI-USG-011 - Attributs non autorisés
- UX-SEC-010 - Restrictions d'applications/d'URL
- UX-DBP-029 - Utilisation d'un mot de passe non sécurisé
- UI-PST-001 - Niveau du journal d'audit dans les paramètres du projet
- Outil de migration de navigateur UiPath
- Zone de détourage
- Enregistreur de Computer Vision
- Activities index
- Activer (Activate)
- Base d'ancrage (Anchor Base)
- Lier à un navigateur (Attach Browser)
- Lier à une fenêtre (Attach Window)
- Block User Input
- Légende (Callout)
- Vérifier (Check)
- Cliquer (Click)
- Cliquer sur l'image (Click Image)
- Déclencheur de clic image (Click Image Trigger)
- Cliquer sur le texte OCR (Click OCR Text)
- Cliquer sur le texte (Click Text)
- Déclencheur de clic (Click Trigger)
- Fermer l'application (Close Application)
- Fermer l'onglet (Close Tab)
- Fermer la fenêtre (Close Window)
- Context Aware Anchor
- Copier le texte sélectionné (Copy Selected Text)
- Element Attribute Change Trigger
- Élément existant (Element Exists)
- Étendue de l'élément (Element Scope)
- Element State Change Trigger
- Export UI Tree
- Extraire les données structurées (Extract Structured Data)
- Rechercher les enfants (Find Children)
- Rechercher l'élément (Find Element)
- Rechercher l'image (Find Image)
- Rechercher les correspondances de l'image (Find Image Matches)
- Rechercher une position de texte OCR (Find OCR Text Position)
- Rechercher l'élément relatif (Find Relative Element)
- Rechercher la position du texte (Find Text Position)
- Obtenir la fenêtre active (Get Active Window)
- Obtenir l'ancêtre (Get Ancestor)
- Obtenir l'attribut (Get Attribute)
- Obtenir les infos de l'événement (Get Event Info)
- Récupérer du presse-papiers (Get From Clipboard)
- Obtenir le texte complet (Get Full Text)
- Obtenir le texte OCR (Get OCR Text)
- Récupérer le mot de passe (Get Password)
- Obtenir la position (Get Position)
- Obtenir l'élément source (Get Source Element)
- Obtenir le texte (Get Text)
- Obtenir le texte visible (Get Visible Text)
- Revenir en arrière (Go Back)
- Avancer (Go Forward)
- Accéder à l'accueil (Go Home)
- Google Cloud Vision OCR
- Masquer la fenêtre (Hide Window)
- Mettre en surbrillance (Highlight)
- Déclencheur de raccourci (Hotkey Trigger)
- Pointer (Hover)
- Pointer sur l'image (Hover Image)
- Pointer sur le texte OCR (Hover OCR Text)
- Pointer sur le texte (Hover Text)
- Image existante (Image Exists)
- Indiquer sur l'écran (Indicate On Screen)
- Injecter du code .NET
- Inject Js Script
- Invoquer la méthode ActiveX
- Déclencheur de pression de touche (Key Press Trigger)
- Charger l'image (Load Image)
- Agrandir la fenêtre (Maximize Window)
- Microsoft Azure ComputerVision OCR
- Reconnaissance optique des caractères Microsoft (Microsoft OCR)
- Microsoft Project Oxford Online OCR
- Réduire la fenêtre (Minimize Window)
- Surveiller les événements (Monitor Events)
- Déclencheur de souris (Mouse Trigger)
- Déplacer la fenêtre (Move Window)
- Accéder à (Navigate To)
- Texte OCR existant (OCR Text Exists)
- Sur affichage de l'élément (On Element Appear)
- Sur disparition de l'élément (On Element Vanish)
- Sur apparition de l'image (On Image Appear)
- Sur disparition de l'image (On Image Vanish)
- Ouvrir l'application (Open Application)
- Ouvrir le navigateur (Open Browser)
- Actualiser le navigateur (Refresh Browser)
- Relire l'événement utilisateur (Replay User Event)
- Restaurer la fenêtre (Restore Window)
- Enregistrer l'image (Save Image)
- Sélectionner l'élément (Select Item)
- Sélectionner plusieurs éléments (Select Multiple Items)
- Envoyer le raccourci (Send Hotkey)
- Définir la zone de détourage (Set Clipping Region)
- Définir le focus (Set Focus)
- Définir le texte (Set Text)
- Placer dans le presse-papiers (Set To Clipboard)
- Définir l'attribut Web (Set Web Attribute)
- Afficher la fenêtre (Show Window)
- Déclencher le processus (Start Process)
- Déclencheur système (System Trigger)
- Prendre une capture d'écran (Take Screenshot)
- Tesseract OCR
- Texte existant (Text Exists)
- Info-bulle
- Saisir dans (Type Into)
- Saisir un texte sécurisé (Type Secure Text)
- Utiliser le premier plan
- Attendre un attribut (Wait Attribute)
- Attendre que l'élément disparaisse (Wait Element Vanish)
- Attendre que l'image disparaisse (Wait Image Vanish)
- Application event trigger
- Check/Uncheck
- Check App State
- Check Element
- Cliquer (Click)
- Click Event Trigger
- Glisser et déposer
- Extract Table Data
- For Each UiElement
- Obtenir l'attribut (Get Attribute)
- Get Browser Data
- Obtenir le texte (Get Text)
- Get URL
- Go To URL
- Mettre en surbrillance (Highlight)
- Pointer (Hover)
- Inject Js Script
- Raccourcis clavier
- Keypress Event Trigger
- Mouse scroll
- Navigate Browser
- Sélectionner l'élément (Select Item)
- Set Browser Data
- Définir le navigateur du runtime (Set Runtime Browser)
- Définir le texte (Set Text)
- Prendre une capture d'écran (Take Screenshot)
- Saisir dans (Type Into)
- Use Application/Browser
- Joindre
- Vérifier (Check)
- Cliquer (Click)
- Glisser et déposer
- Extraire des données
- Obtenir l'attribut (Get Attribute)
- ObtenirEnfants
- ObtenirCibleRuntime
- GetText
- Get URL
- GoToUrl
- Mettre en surbrillance (Highlight)
- Pointer (Hover)
- IsEnabled
- Raccourci clavier
- Mouse scroll
- Ouvrir
- Sélectionner l'élément (Select Item)
- Prendre une capture d'écran (Take Screenshot)
- Saisir dans (Type Into)
- ÉtatAttente
- Effectuez une recherche par navigateur et récupérez les résultats à l'aide des API UI Automation
- Navigation sur le Web
- Rechercher des images
- Cliquer sur des images
- Déclencher et surveiller des événements
- Créer et remplacer des fichiers
- Pages HTML : extraire et manipuler des informations
- Manipulation des fenêtres
- Sélection de liste automatisée
- Rechercher et manipuler des éléments de fenêtre
- Gérer l'automatisation du texte
- Charger et traiter des images
- Gérer les actions activées par la souris
- Automatiser l'exécution des applications
- Exécution automatisée d'une application locale
- Navigation avec le navigateur
- Automatisation Web
- Exemple de fonctionnalités du déclencheur
- Activer la prise en charge d’UI Automation dans DevExpress
- Computer Vision Local Server
- Automatisation mobile
- Notes de publication
- Compatibilité du projet
- Get Log Types
- Get Logs
- Get Page Source
- Get Device Orientation
- Get Session Identifier
- Installer l'application
- Gérer l'application actuelle
- Gérer une autre application
- Ouvrir DeepLink
- Ouvrir l'URL
- Mobile Device Connection
- Balayer directionnel
- Dessiner un modèle
- Positional Swipe
- Press Hardware Button
- Set Device Orientation
- Prendre une capture d'écran (Take Screenshot)
- Prendre une partie de capture d'écran
- Élément existant (Element Exists)
- Execute Command
- Obtenir l'attribut (Get Attribute)
- Get Selected Item
- Obtenir le texte (Get Text)
- Set Selected Item
- Définir le texte (Set Text)
- Balayer
- Tap
- Saisir texte
- Terminal
- Notes de publication
- À propos du package d'activités Terminal
- Compatibilité du projet
- Meilleures pratiques
- Rechercher un texte (Find Text)
- Get Color At Position
- Obtenir la position du curseur (Get Cursor Position)
- Obtenir le champ (Get Field)
- Obtenir le champ en position (Get Field at Position)
- Accéder à la zone d'écran (Get Screen Area)
- Obtenir le texte (Get Text)
- Obtenir le texte en position (Get Text at Position)
- Déplacer le curseur (Move Cursor)
- Move Cursor to Text
- Envoyer la touche Contrôle (Send Control Key)
- Envoyer les touches (Send Keys)
- Envoyer les touches en toute sécurité (Send Keys Secure)
- Définir le champ (Set Field)
- Définir le champ en position (Set Field at Position)
- Session de terminal (Terminal Session)
- Attendre le texte de champ (Wait Field Text)
- Attendre le texte d'écran (Wait Screen Text)
- Attendre le texte en position (Wait Text at Position)
Activités UIAutomation
Ouvrir
Ouvre une application de bureau ou une page de navigateur Web à utiliser dans UI Automation.
uiAutomation.API()
. Par exemple, uiAutomation.Open()
.
Espace de noms : UiPath.UIAutomationNext.API.Contracts
Assembly : UiPath.UIAutomationNext.API.Contracts (dans UiPath.UIAutomationNext.API.Contracts dll)
Surcharge | Description |
---|---|
Open(String, TargetAppOptions, String,
String) | Ouvre une application de bureau ou une page Web spécifique à utiliser dans UI Automation, identifiée par le nom d'écran du référentiel d'objets. |
Open(TargetAppModel, TargetAppOptions) | Ouvre une application de bureau ou une page Web spécifique à utiliser dans UI Automation, identifiée par l'objet TargetAppModel .
|
Open(String, String, String, NAppOpenMode, NWindowResize,
NInteractionMode) | Ouvre une application de bureau ou une page Web spécifique à utiliser dans UI Automation, identifiée par le nom d'écran du référentiel d'objets, ainsi que d'autres personnalisations de l'application ou de la page Web. |
Ouvre une application de bureau ou une page Web spécifique à utiliser dans UI Automation, identifiée par le nom d'écran du référentiel d'objets.
Open(
string screenName,
TargetAppOptions targetAppOptions,
[string appName],
[string appVersion])
Open(
string screenName,
TargetAppOptions targetAppOptions,
[string appName],
[string appVersion])
screeName
Chaîne de caractères (string)- Le nom de l’écran sur lequel vous souhaitez vous concentrer, sous la forme d’une chaîne enregistrée dans le référentiel d’objets.
targetAppOptions
- Options et paramètres supplémentaires pour la connexion à l'application ou à la page Web :
Timeout Double
- Spécifiez le nombre de secondes pendant lesquelles attendre l'exécution de l'activité avant de générer une erreur. La valeur par défaut est 30 secondes. Lorsque vous indiquez une fenêtre dans un environnement Bureau à distance, le paramètre par défaut Délai d'attente est défini sur 60 secondes.InteractionMode NInteractionMode
:HardwareEvents
: utilise le pilote matériel pour effectuer les Actions. Il s'agit de l'API la plus lente : elle ne peut pas fonctionner en arrière-plan, mais est compatible avec toutes les applications de bureau.Simulate
: simule les Actions à l'aide des API d'accessibilité. Recommandé dans l'automatisation du navigateur, les applications Java ou SAP. Plus fiable que les événements matériels. Envoie tout le texte dans une seule Actions. Fonctionne même si l’application cible n’est pas au point. Veuillez tester si l’élément d’IU de votre application cible prend cela en charge.DebuggerApi
- Effectue des Actions à l'aide des API Debugger. Fonctionne uniquement pour les éléments Chromium. Envoie tout le texte en une seule fois. Fonctionne même si l’application cible n’est pas au point. Pour en savoir plus, consultez cette page.WindowMessages
- Envoie l'entrée de la souris et du clavier via des messages Win32. Recommandé pour les applications de bureau. Généralement plus fiable que les événements matériels. Envoie tout le texte dans une seule Actions. Fonctionne même si l’application cible n’est pas au point. Veuillez tester si l’élément d’IU de votre application cible prend cela en charge.Background
: exécute des Actions en arrière-plan. Essaie d'utiliser l'API Simulate ou Chromium dans la mesure du possible, tandis que les API complexes (image, texte natif) s'exécutent comme d'habitude, au premier plan. Il est fortement recommandé d'utiliser cette API avec la fonctionnalité Vérifier l'exécution .
OpenMode NAppOpenMode
- choisissez quand ouvrir l'application :Never
(n'ouvrez jamais l'application)IfNotOpen
(ne s'ouvre que si l'application est fermée, il s'agit de la sélection par défaut, ne fonctionne que siFilePath
ouURL
sont fournis)Always
(ouvrir une autre instance de l'application même si une est déjà ouverte, ne fonctionne que siFilePath
ouURL
sont fournis)
WindowResize NWindowResize
- choisissez la taille de la fenêtre :Aucun (None)
Agrandir
Restaurer
Minimize
UserDataFolderMode BrowserUserDataFolderMode
: leUserDataFolderMode
que vous souhaitez définir. Il est utilisé pour démarrer le navigateur avec un dossier de données utilisateur spécifique.Automatic
: le mode incrustation d'image utilise un dossier différent de celui du mode par défaut, généré automatiquement siUserDataFolderPath
n'est pas défini.DefaultFolder
- Utilise le dossier du navigateur par défaut, peu importe qu'il soit exécuté dans la session principale ou dans la session PIP.CustomFolder
: utilise le dossier spécifié dansUserDataFolderPath
ou un chemin d'accès généré automatiquement siUserDataFolderPath
n'est pas défini.
UserDataFolderPath String
: le dossier de données utilisateur utilisé par le navigateur. La valeur par défaut est%LocalAppData%\UiPath\PIP Browser Profiles\BrowserType
si elle n'est pas définie.IsIncognito Boolean
: saisissezTrue
si vous souhaitez ouvrir le navigateur en mode navigation privée. Par défaut, il est défini surFalse
.WebDriverMode NWebDriverMode
: indique comment WebDriver est utilisé lors de l'ouverture d'une nouvelle session de navigateur. Les options suivantes sont disponibles :Disabled
: désactive l'utilisation de WebDriver.WithGUI
: l'interface graphique du navigateur s'affiche.Headless
: le navigateur est lancé en mode silencieux, sans interface graphique.
appName
Chaîne de caractères (string)- Le nom de l’application à laquelle se connecter. Ce paramètre s'applique aux applications de bureau.
appVersion
Chaîne de caractères (string)- La version de l’application à laquelle se connecter. Ce paramètre s'applique aux applications de bureau.
TargetAppModel
.
Open(
TargetAppModel targetApp,
[TargetAppOptions targetAppOptions])
Open(
TargetAppModel targetApp,
[TargetAppOptions targetAppOptions])
targetApp
ModèleApplicationCible
- L’application cible ou la page Web à laquelle se connecter. Il s'agit d'un objet de type
TargetAppModel
qui fournit des informations sur l'application :Selector
- Fragment XML qui stocke les attributs d'un élément d'interface utilisateur.FilePath
: si l'application n'est pas un navigateur Web, indique le chemin complet du fichier exécutable à ouvrir.Arguments
- Si l'application n'est pas un navigateur Web, vous pouvez spécifier les paramètres à transmettre à l'application cible au démarrage.Url
: si l'application est un navigateur Web, cette option spécifie l'URL de la page Web à ouvrir.Title
: le titre de l'application ou du navigateur.
targetAppOptions
- Options et paramètres supplémentaires pour la connexion à l'application ou à la page Web :
Timeout Double
- Spécifiez le nombre de secondes pendant lesquelles attendre l'exécution de l'activité avant de générer une erreur. La valeur par défaut est 30 secondes. Lorsque vous indiquez une fenêtre dans un environnement Bureau à distance, le paramètre par défaut Délai d'attente est défini sur 60 secondes.InteractionMode NInteractionMode
:HardwareEvents
: utilise le pilote matériel pour effectuer les Actions. Il s'agit de l'API la plus lente : elle ne peut pas fonctionner en arrière-plan, mais est compatible avec toutes les applications de bureau.Simulate
: simule les Actions à l'aide des API d'accessibilité. Recommandé dans l'automatisation du navigateur, les applications Java ou SAP. Plus fiable que les événements matériels. Envoie tout le texte dans une seule Actions. Fonctionne même si l’application cible n’est pas au point. Veuillez tester si l’élément d’IU de votre application cible prend cela en charge.DebuggerApi
- Effectue des Actions à l'aide des API Debugger. Fonctionne uniquement pour les éléments Chromium. Envoie tout le texte en une seule fois. Fonctionne même si l’application cible n’est pas au point. Pour en savoir plus, consultez cette page.WindowMessages
- Envoie l'entrée de la souris et du clavier via des messages Win32. Recommandé pour les applications de bureau. Généralement plus fiable que les événements matériels. Envoie tout le texte dans une seule Actions. Fonctionne même si l’application cible n’est pas au point. Veuillez tester si l’élément d’IU de votre application cible prend cela en charge.Background
: exécute des Actions en arrière-plan. Essaie d'utiliser l'API Simulate ou Chromium dans la mesure du possible, tandis que les API complexes (image, texte natif) s'exécutent comme d'habitude, au premier plan. Il est fortement recommandé d'utiliser cette API avec la fonctionnalité Vérifier l'exécution .
OpenMode NAppOpenMode
- choisissez quand ouvrir l'application :Never
(n'ouvrez jamais l'application)IfNotOpen
(ne s'ouvre que si l'application est fermée, il s'agit de la sélection par défaut, ne fonctionne que siFilePath
ouURL
sont fournis)Always
(ouvrir une autre instance de l'application même si une est déjà ouverte, ne fonctionne que siFilePath
ouURL
sont fournis)
WindowResize NWindowResize
- choisissez la taille de la fenêtre :Aucun (None)
Agrandir
Restaurer
Minimize
UserDataFolderMode BrowserUserDataFolderMode
: leUserDataFolderMode
que vous souhaitez définir. Il est utilisé pour démarrer le navigateur avec un dossier de données utilisateur spécifique.Automatic
: le mode incrustation d'image utilise un dossier différent de celui du mode par défaut, généré automatiquement siUserDataFolderPath
n'est pas défini.DefaultFolder
- Utilise le dossier du navigateur par défaut, peu importe qu'il soit exécuté dans la session principale ou dans la session PIP.CustomFolder
: utilise le dossier spécifié dansUserDataFolderPath
ou un chemin d'accès généré automatiquement siUserDataFolderPath
n'est pas défini.
UserDataFolderPath String
: le dossier de données utilisateur utilisé par le navigateur. La valeur par défaut est%LocalAppData%\UiPath\PIP Browser Profiles\BrowserType
si elle n'est pas définie.IsIncognito Boolean
: saisissezTrue
si vous souhaitez ouvrir le navigateur en mode navigation privée. Par défaut, il est défini surFalse
.WebDriverMode NWebDriverMode
: indique comment WebDriver est utilisé lors de l'ouverture d'une nouvelle session de navigateur. Les options suivantes sont disponibles :Disabled
: désactive l'utilisation de WebDriver.WithGUI
: l'interface graphique du navigateur s'affiche.Headless
: le navigateur est lancé en mode silencieux, sans interface graphique.
Ouvre une application de bureau ou une page Web spécifique à utiliser dans UI Automation, identifiée par le nom d'écran du référentiel d'objets, ainsi que d'autres personnalisations de l'application ou de la page Web.
Open(
string screenName,
[string appName],
[string appVersion],
[NAppOpenMode openMode],
[NWindowResize windowResize],
[NInteractionMode interactionMode])
Open(
string screenName,
[string appName],
[string appVersion],
[NAppOpenMode openMode],
[NWindowResize windowResize],
[NInteractionMode interactionMode])
screeName
Chaîne de caractères (string)- Le nom de l’écran sur lequel vous souhaitez vous concentrer, sous la forme d’une chaîne enregistrée dans le référentiel d’objets.
appName
Chaîne de caractères (string)- Le nom de l’application à laquelle se connecter. Ce paramètre s'applique aux applications de bureau.
appVersion
Chaîne de caractères (string)- La version de l’application à laquelle se connecter. Ce paramètre s'applique aux applications de bureau.
openMode
NAppOpenMode
- Sélectionnez quand ouvrir l’application cible pour l’exécution de l’automatisation :
Never
(n'ouvrez jamais l'application)IfNotOpen
(ne s'ouvre que si l'application est fermée, il s'agit de la sélection par défaut, ne fonctionne que si le paramètreUrl
est configuré)Always
: (ouvrir une autre instance de l'application même si une est déjà ouverte, ne fonctionne que si le paramètreUrl
est configuré).
NWindowResize
- Choisissez la taille de la fenêtre :
Aucun (None)
Agrandir
Restaurer
Minimize
NInteractionMode
- Choisissez l'API que le Robot doit utiliser pour interagir avec l'application cible :
HardwareEvents
: utilise le pilote matériel pour effectuer les Actions. Il s'agit de l'API la plus lente : elle ne peut pas fonctionner en arrière-plan, mais est compatible avec toutes les applications de bureau.Simulate
: simule les Actions à l'aide des API d'accessibilité. Recommandé dans l'automatisation du navigateur, les applications Java ou SAP. Plus fiable que les événements matériels. Envoie tout le texte dans une seule Actions. Fonctionne même si l’application cible n’est pas au point. Veuillez tester si l’élément d’IU de votre application cible prend cela en charge.DebuggerApi
- Effectue des Actions à l'aide des API Debugger. Fonctionne uniquement pour les éléments Chromium. Envoie tout le texte en une seule fois. Fonctionne même si l’application cible n’est pas au point. Pour en savoir plus, consultez cette page.WindowMessages
- Envoie l'entrée de la souris et du clavier via des messages Win32. Recommandé pour les applications de bureau. Généralement plus fiable que les événements matériels. Envoie tout le texte dans une seule Actions. Fonctionne même si l’application cible n’est pas au point. Veuillez tester si l’élément d’IU de votre application cible prend cela en charge.Background
: exécute des Actions en arrière-plan. Essaie d'utiliser l'API Simulate ou Chromium dans la mesure du possible, tandis que les API complexes (image, texte natif) s'exécutent comme d'habitude, au premier plan. Il est fortement recommandé d'utiliser cette API avec la fonctionnalité Vérifier l'exécution .
Pour utiliser WebDriverMode dans une configuration sans affichage, ces étapes peuvent servir de guide.
uiAutomation.Open
pour ouvrir une nouvelle application dans le navigateur de votre choix (Edge dans cette instance). Puis, utilisez la classe Options
dans la surcharge pour spécifier certaines options de navigateur. Parmi ces options, définissez webDriverMode
sur NWebDriverMode.Headless
.
Le code correspondant ressemble à ce qui suit :
var screen = uiAutomation.Open(Descriptors.NewApplication.Edge, Options.AppOpen().WithBrowserOptions(webDriverMode: NWebDriverMode.Headless));
var screen = uiAutomation.Open(Descriptors.NewApplication.Edge, Options.AppOpen().WithBrowserOptions(webDriverMode: NWebDriverMode.Headless));
Ce code définit WebDriver en mode sans affichage, permettant l’automatisation du navigateur sans que le navigateur soit visiblement ouvert.