Ouvrir le navigateur (Open Browser)

UiPath.Core.Activities.OpenBrowser

Conteneur qui vous permet d'ouvrir un navigateur à une URL spécifiée et d'y exécuter plusieurs activités.

Attention :

Les URL internes ne peuvent pas être ouvertes à l’aide de cette activité lorsque le navigateur ne les accepte pas directement comme arguments de ligne de commande.

Vous ne pouvez pas ouvrir de pages internes Chrome (chrome://) ou Edge (edge://). Cependant, vous pouvez ouvrir des pages internes Firefox (about:).

Dans le corps de l’activité

Dans le panneau du concepteur, l'activité est présentée comme un conteneur, dans lequel vous pouvez ajouter des activités pour interagir avec le navigateur spécifié.

Le champ URL vous permet de fournir le lien vers lequel le navigateur s'ouvre.

En cliquant sur à côté du champ URL ouvre une nouvelle session de navigateur avec les paramètres de configuration actuels. Cela permet d'utiliser un nouvel ensemble de données utilisateur de navigateur tout en conservant la configuration existante. Cela peut être particulièrement utile lorsque vous automatisez les navigateurs dans Picture-in-Picture.

Une séquence est également présente, où les actions effectuées sur le navigateur sont ajoutées.

Propriétés

Commun

• 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.
• NomAffichage (DisplayName) - Nom affiché de l'activité.

Entrée

• TypeNavigateur : Choisissez le type de navigateur que vous souhaitez utiliser en utilisant le bouton déroulant. 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é.

  Remarque : si la propriété BrowserType est définie sur Personnalisé, la propriété CommunicationMethod doit être définie sur WebDriver pour que l'activité fonctionne correctement.
• Url (Url) - URL que vous souhaitez ouvrir dans le navigateur spécifié.

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

Options

• AutomaticallyDownloadWebDriver : si cette option est sélectionnée, elle télécharge automatiquement à partir d'Internet l'exécutable WebDriver requis dans le dossier %localappdata%\UiPath\WebdriverExe . Par défaut, cette case est décochée.
• CommunicationMethod : choisissez la méthode de communication. Les éléments suivants sont disponibles : Natif, WebDriver.
• Masqué (Hidden) - Ouvre un navigateur masqué.
• Nouvelle session (NewSession) - Démarre une nouvelle session du navigateur sélectionné. Cette option est propre à Internet Explorer.
• Privé (Private) - Ouvre une session privée/en mode de navigation privée.

• ModeDossierDonnéesUtilisateur : le ModeDossierDonnéesUtilisateur que vous souhaitez définir. Cette option est utilisée pour démarrer le navigateur avec un dossier de données utilisateur spécifique.

  • UserDataFolderMode.Automatic : le mode incrustation d’image utilise un dossier différent de celui du mode par défaut, généré automatiquement si CheminDossierDonnéesUtilisateur n’est pas défini.
  • UserDataFolderMode.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.
  • UserDataFolderMode.CustomFolder : utilise le dossier spécifié dans CheminDossierDonnéesUtilisateur ou un chemin d’accès généré automatiquement si CheminDossierDonnéesUtilisateur n’est pas défini.
• UserDataFolderPath : le dossier de données utilisateur que le navigateur utilisera. La valeur par défaut est %LocalAppData%\UiPath\PIP Browser Profiles\BrowserType si elle n'est pas définie.

Vous trouverez plus de détails sur UserDataFolderMode et UserDataFolderPath ici.

Sortie

• UiBrowser (UiBrowser) - Résultat de l'activité en tant qu'objet UiBrowser. Stocke toutes les informations concernant votre session de navigateur. Seules les variables Browser sont prises en charge.

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.

Exemple d'utilisation de l'activité Open Browser

Ici, vous pouvez voir comment l'activité Ouvrir le navigateur est utilisée dans un exemple qui intègre plusieurs activités.