Lier à un navigateur (Attach Browser)

UiPath.Core.Activities.BrowserScope

Conteneur qui vous permet de vous connecter à un navigateur déjà ouvert et d'y effectuer plusieurs actions. Cette activité est également générée automatiquement lors de l'utilisation de l'enregistreur Web.

Propriétés

Entrée

• Sélecteur - Propriété de texte utilisée pour rechercher un élément d'IU particulier lorsque l'activité est exécutée. Il s'agit en fait d'un fragment XML spécifiant les attributs de l'élément GUI que vous recherchez et de certains de ses parents. Si cette propriété et la propriété Navigateur sont toutes deux configurées, la propriété Sélecteur est utilisée au moment de la conception et la propriété Navigateur est utilisée au moment de l'exécution.
• TypeNavigateur : choisissez le type de navigateur que vous souhaitez utiliser. Les options suivantes sont disponibles : IE, Firefox, Chrome, Edge, Personnalisé. Le type Personnalisé convient aux autres navigateurs basés sur Chromium, tels que JxBrowser. La propriété Caché n'est pas prise en charge lors de l'utilisation du type de navigateur Personnalisé. Pour plus d'informations sur la configuration du navigateur personnalisé, consultez la section Navigateur personnalisé.
• Navigateur - La variable de navigateur existante à laquelle vous souhaitez vous attacher. Si cette propriété et la propriété Sélecteur sont configurées, la propriété Sélecteur est utilisée au moment de la conception et la propriété Navigateur est utilisée au moment de l'exécution.
• TimeoutMS - Spécifie la durée (en millisecondes) d'attente d'exécution de l'activité avant la génération d'un message d'erreur. La valeur par défaut est 30 000 millisecondes (30 secondes).

Options

• Étendue de recherche (SearchScope) - Fenêtre de l'application dans laquelle rechercher l'élément de l'interface utilisateur défini par la propriété Selector.

Sortie

• NavigateurIU (UiBrowser) : variable du navigateur renvoyée par l'activité. Pour éviter d'avoir à indiquer à nouveau la même instance d'un navigateur et pour vous assurer que l'instance de navigateur que vous automatisez ne change pas, vous pouvez réutiliser cette variable de sortie comme variable d'entrée dans une autre activité, Lier à un navigateur (Attach Browser) ou Utiliser l'application/le navigateur pour (Use Application/Browser) par exemple, ou vous pouvez même la réutiliser comme argument dans un autre workflow.

Commun

• NomAffichage (DisplayName) - Nom affiché de l'activité.

• Poursuite sur erreur (ContinueOnError) - Spécifie si l'automatisation doit continuer même si l'activité génère un message d'erreur. Ce champ prend uniquement en charge les valeurs booléennes (True, False). La valeur par défaut est False. Par conséquent, si le champ est vide et si une erreur est renvoyée, l'exécution du projet s'interrompt. Si la valeur est configurée sur True, l'exécution du projet continue indépendamment de toute erreur.

  Remarque : si cette activité est incluse dans l'activité Try Catch et que la valeur de la propriété ContinuerSurErreur est « True », aucune erreur ne sera détectée lors de l'exécution du projet.

Divers

• Privé (Private) - Si cette option est sélectionnée, les valeurs des variables et des arguments ne sont plus enregistrées au niveau Détaillé (Verbose).

Navigateur personnalisé

Un navigateur Personnalisé est un navigateur différent des navigateurs largement utilisés (Chrome, Chromium Edge, Firefox, IE, etc.) et qui repose sur le projet Chromium. Nous prenons en charge deux catégories de ce type de navigateurs : les navigateurs conçus avec Chromium Embedded Framework (CEF) et les navigateurs qui utilisent l'infrastructure JxBrowser.

Ces navigateurs personnalisés peuvent être automatisés à l'aide de la méthode de communication WebDriver.

Pour ce faire, ils doivent prendre en charge le paramètre de ligne de commande --remote-debugging-port de la même manière que tous les navigateurs basés sur Chromium le prennent en charge.

Configuration d'un navigateur personnalisé

Le navigateur personnalisé que vous souhaitez utiliser doit avoir un exécutable chromedriver.exe adapté à la version de Chromium sur laquelle le navigateur personnalisé a été intégré PATH.

Dans la clé de registre HKEY_CURRENT_USER ou HKEY_LOCAL_MACHINE, sous Software\UiPath\UiPath Platform\CustomBrowser, la valeur Commande doit contenir le chemin d'accès à l'exécutable du navigateur personnalisé ou à une commande qui démarre ce navigateur personnalisé.

En option, dans les cas où vous n'avez besoin d'exécuter qu'une seule instance du navigateur personnalisé et, pour des raisons de sécurité, souhaitez spécifier le port de débogage distant sur lequel la communication avec le navigateur personnalisé est effectuée, une valeur de registre appelée RemoteDebuggingPort doit être ajouté dans la même clé de registre où Commande a été spécifié.

Les sélecteurs des pages d'un tel navigateur personnalisé possèdent le nom d'application de navigateur custom_browser.