activities

latest

false

Important :

Veuillez noter que ce contenu a été localisé en partie à l’aide de la traduction automatique. La localisation du contenu nouvellement publié peut prendre 1 à 2 semaines avant d’être disponible.

Activités UIAutomation

Dernière mise à jour 18 juin 2025

Browser Dialog Scope (Portée des boîtes de dialogue de navigateur)

UiPath.UIAutomationNext.Activities.NBrowserDialogScope

Description

Capture et gère les boîtes de dialogue JavaScript telles que : Alerte (Alert), Confirmer (Confirm), Invite (Prompt). Cette activité doit être utilisée comme étendue pour les activités qui peuvent générer une boîte de dialogue de navigateur. De cette façon, les activités qui pourraient déclencher la boîte de dialogue doivent être placées dans le corps de l'activité Étendue de la boîte de dialogue du navigateur (Browser Dialog Scope) .

Cette activité doit être ajoutée dans une activité Use Application/Browser.

Compatibilité du projet

Windows | Multiplateforme

Configuration

Module Designer

À partir du menu déroulant Type de boîte de dialogue (Dialog type) , sélectionnez le type de boîte de dialogue du navigateur JavaScript géré par l'activité Étendue de la boîte de dialogue du navigateur (Browser Dialog Scope) :
- Alerte
- Confirmer
- Prompt
Réponse de la boîte de dialogue : Réponse aux boîtes de dialogue de confirmation JavaScript : Annuler ou OK. Elle n'est disponible que pour les types de boîte de dialogue Confirmer (Confirm) ou Invite (Prompt) .
Texte de réponse d'invite : Réponse textuelle pour les boîtes de dialogue d'invite JavaScript. Elle n'est disponible que pour le type de boîte de dialogue Invite (Prompt Dialog).
Message de boîte de dialogue (Dialog message ) : variable de sortie de chaîne pour stocker le message de la boîte de dialogue traitée par l'étendue de la boîte de dialogue.

Panneau propriétés

Horaires

Attendre que la boîte de dialogue s'affiche : spécifiez le délai d'attente (en secondes) pour que la boîte de dialogue s'affiche avant de générer une erreur. La valeur par défaut est 30 secondes.

Options

Continuer en cas d'erreur (Continue on error ) : spécifie si l'automatisation doit se poursuivre même lorsque l'activité génère une erreur. Ce champ prend uniquement en charge les valeurs Boolean (True, False). La valeur par défaut est False. Par conséquent, si le champ est vide et qu'une erreur est générée, l'exécution du projet s'arrête. Si le champ indique au contraire True, l'exécution du projet se poursuit même en cas d'erreur.

Guide pratique

Dans le cadre de l'automatisation métier des processus, les utilisateurs rencontrent des cas où les boîtes de dialogue du navigateur bloquent l'exécution de la page de navigateur actuelle. En règle générale, l'utilisateur souhaite ignorer la boîte de dialogue du navigateur et également récupérer le message de la boîte de dialogue pour une utilisation ultérieure dans le scénario métier.

Pour les projets Windows, ce type de scénario peut être géré en définissant le mode d'attachement de fenêtre sur Instance d'application pour l'activité de conteneur Utiliser l'application/le navigateur (Use Application/Browser) et en générant le sélecteur de boîte de dialogue du navigateur avec l'infrastructure d'IU Active Accessibility (AA).

Mais pour les projets multiplateformes (y compris Studio Web), nous n'avions aucune solution pour gérer ce type de scénario.

JavaScript a trois types de zones de fenêtre contextuelles : Alerte (Alert), Confirmer (Confirm) et Inviter (Prompt). L'activité Étendue de la boîte de dialogue du navigateur (Browser Dialog Scope) peut gérer ce type de boîtes de dialogue et doit être utilisée comme étendue pour les activités susceptibles de générer une boîte de dialogue de navigateur.

L'activité Étendue de la boîte de dialogue du navigateur (Browser Dialog Scope) doit être ajoutée à l'intérieur d'une activité Use Application/Browser et les activités qui pourraient déclencher la boîte de dialogue doivent être placées dans le corps de l'activité Étendue de la boîte de dialogue du navigateur (Browser Dialog Scope) .

Configuration de l'alerte

Une boîte de dialogue d'alerte est utilisée pour s'assurer que les informations sont transmises à l'utilisateur. Lorsqu’il apparaît, l’utilisateur doit cliquer sur le bouton OK pour continuer, sinon l’exécution est bloquée.

C'est ainsi que l'activité Étendue de la boîte de dialogue du navigateur (Browser Dialog Scope) peut être configurée pour gérer une boîte de dialogue d' alerte qui se déclenche lorsque vous cliquez sur un bouton Soumettre (Submit) .

Configuration pour Confirmer

Une boîte de dialogue Confirmer (Confirm) est utilisée lorsque l'utilisateur doit vérifier ou accepter quelque chose. Lorsqu'il apparaît, l'utilisateur doit cliquer sur le bouton OK ou sur le bouton Annuler pour continuer.

C'est ainsi que l'activité Étendue de la boîte de dialogue du navigateur (Browser Dialog Scope) peut être configurée pour gérer une boîte de dialogue Confirmer (Confirm) qui est déclenchée lorsque vous cliquez sur un bouton Soumettre (Submit) .

Configuration pour l'invite

Une boîte de dialogue d'invite est utilisée lorsque l'utilisateur doit fournir une entrée de texte pour une opération. Lorsqu’il apparaît, l’utilisateur devra cliquer sur OK ou sur Annuler pour continuer après avoir saisi une valeur d’entrée.

Exemple pour plusieurs boîtes de dialogue

Il existe de rares situations où une page ouvre plusieurs boîtes de dialogue, l’une après l’autre, lorsque l’utilisateur clique sur un bouton. Prenons le scénario suivant :

Lorsque le bouton Soumettre les données (Submit Data) est cliqué, une boîte de dialogue d'invite s'ouvre afin que l'utilisateur puisse renseigner son nom.
Après avoir fermé la boîte de dialogue Invite (Prompt) avec le bouton OK, lorsque l'opération de soumission est terminée, une boîte de dialogue Alerte (Alert ) s'affiche.

L'activité Étendue de la boîte de dialogue du navigateur (Browser Dialog Scope) peut être utilisée pour gérer cette situation en imbriquant plusieurs étendues de boîte de dialogue. Elles doivent être organisées dans le même ordre que les boîtes de dialogue qu'elles gèrent apparaissent dans la page. Le workflow se poursuivra une fois que toutes les boîtes de dialogue seront traitées. Pour le scénario ci-dessus :

Tout d'abord, créez une étendue de boîte de dialogue de navigateur (Browser Dialog Scope) pour gérer la première boîte de dialogue, dans ce cas une boîte de dialogue d'invite .
Dans la première étendue, créez une deuxième étendue de boîte de dialogue de navigateur pour gérer la deuxième boîte de dialogue, dans ce cas une boîte de dialogue d'alerte .
À l'intérieur de la deuxième étendue, placez l'activité qui déclenche les boîtes de dialogue, dans ce cas un clic sur le bouton Soumettre les données (Submit Data) .

Options de la carte d'application de gestion de la boîte de dialogue

Outre l’activité Étendue de la boîte de dialogue du navigateur , nous avons ajouté des options de gestion de boîte de dialogue de navigateur à l’activité Utiliser l’application/le navigateur (Use Application/Browser ).

Les nouveaux paramètres de gestion des boîtes de dialogue dans la carte d’application permettent à l’utilisateur de décrire comment ignorer automatiquement les boîtes de dialogue du navigateur (les types de boîtes de dialogue à ignorer et la réponse à donner pour confirmer et les boîtes de dialogue d’invite).

Ignorer les alertes
Ignorer les confirmations + la réponse de la boîte de dialogue de confirmation
Ignorer les invites + Texte de réponse à l'invite + Réponse à la boîte de dialogue d'invite

Boîte de dialogue de gestion des paramètres de projet de carte d'application

Des paramètres de projet similaires ont été ajoutés pour la gestion de la boîte de dialogue (Dialog Handling), qui fonctionnent par défaut pour les options Utiliser l'application/le navigateur (Use Application/Browser Dialog Handling).

Projets Windows : UI Automation Modern > Application/Navigateur
Projets multiplate-forme : UI Automation > Application/Navigateur (Application/Browser)

Étendue de la boîte de dialogue du navigateur et priorité de gestion de la boîte de dialogue de la carte d'application

Lorsque plusieurs activités Étendue de la boîte de dialogue du navigateur (Browser Dialog Scope) et Cartes d'application (App Cards) avec Gestion des boîtes de dialogue (Dialog Handling) sont imbriquées, il est important de garder quelques éléments à l'esprit afin de déterminer comment les boîtes de dialogue seront gérées :

Les activités Étendue de la boîte de dialogue du navigateur (Browser Dialog Scope) ont la priorité sur les options de Gestion de la boîte de dialogue de la carte d'application.
Les activités Étendue de boîte de dialogue du navigateur imbriquée gèrent plusieurs boîtes de dialogue, dans l'ordre dans lequel elles apparaissent : la première étendue de boîte de dialogue gère la première boîte de dialogue, la deuxième étendue de boîte de dialogue gère la deuxième boîte de dialogue, etc.
Les cartes d'application imbriquées avec gestion de la boîte de dialogue se remplacent : la carte d'application interne remplacera les paramètres de la carte d'application externe. Par exemple, une carte d'application de niveau supérieur peut être configurée pour ignorer toutes les boîtes de dialogue avec Annuler (Cancel) tout au long du workflow, mais pour une petite partie du workflow, une carte d'application de courte durée peut être utilisée dans celle de niveau supérieur pour accepter les boîtes de dialogue de confirmation avec OK, ne modifiant la gestion des boîtes de dialogue que pour cette partie du workflow. Les alertes et les invites seront toujours rejetées en fonction de la carte d'application de niveau supérieur.

Lorsqu'une boîte de dialogue de navigateur apparaît et qu'il existe plusieurs étendues de boîte de dialogue de navigateur et des cartes d'application avec gestion de la boîte de dialogue qui peuvent gérer la boîte de dialogue, l' étendue de boîte de dialogue du navigateur ou une carte d'application qui gère la boîte de dialogue est sélectionnée de la manière suivante :

La première activité (la plus externe) Étendue de la boîte de dialogue du navigateur (Browser Dialog Scope) qui : a un type de boîte de dialogue correspondant et n'a capturé aucune boîte de dialogue pour le moment.
Si aucune étendue de boîte de dialogue de navigateur n'est trouvée, la dernière carte d'application (la plus interne) configurée pour gérer le type de boîte de dialogue est utilisée.
Si aucune étendue de boîte de dialogue de navigateur ou carte d’application viable n’est trouvée, la boîte de dialogue n’est pas gérée et s’affichera à l’utilisateur.