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.

Remarque :

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.

Cliquer 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. Il 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

• ContinueOnError - Specifies if the automation should continue even when the activity throws an error. This field only supports Boolean values (True, False). The default value is False. As a result, if the field is blank and an error is thrown, the execution of the project stops. If the value is set to True, the execution of the project continues regardless of any error.

  Remarque :

  Si cette activité est incluse dans Tenter de capturer (Try Catch) et que la valeur de la propriété Poursuite sur erreur (ContinueOnError) est True, aucune erreur n'est 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 :

  If the BrowserType property is set to Custom, the CommunicationMethod property must be set to WebDriver for the activity to work properly.

• 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 - If selected, automatically downloads from the Internet the required WebDriver executable into the %localappdata%\UiPath\WebdriverExe folder. By default, this check box is cleared.
• CommunicationMethod - Choose the communication method. The following are available: Native, WebDriver.
• Masqué (Hidden) - Ouvre un navigateur masqué.
• NewSession - Starts a new session of the selected browser. This option is specific to Internet Explorer.
• Privé (Private) - Ouvre une session privée/en mode de navigation privée.
• UserDataFolderMode - The UserDataFolderMode you want to set. It is used to start the browser with a specific user data folder.
  • UserDataFolderMode.Automatic - Picture In Picture mode uses a different folder than the default mode, automatically generated if UserDataFolderPath is not set.
  • UserDataFolderMode.DefaultFolder - Uses the default browser folder, no matter if it runs in the main or PIP session.
  • UserDataFolderMode.CustomFolder - Uses the folder specified in UserDataFolderPath or an auto generated path if UserDataFolderPath is not set.
• UserDataFolderPath - The user data folder that the browser will use. Defaults to %LocalAppData%\UiPath\PIP Browser Profiles\BrowserType if not set.

Vous trouverez plus de détails sur ModeDossierDonnéesUtilisateur et CheminDossierDonnéesUtilisateur 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.