Saisir dans (Type Into)

UiPath.Core.Activities.TypeInto

Envoie les frappes à un élément d'IU.

Les touches spéciales sont prises en charge et sélectionnables dans la liste déroulante.

Les touches permanentes sont également prises en charge. Par exemple, si vous souhaitez saisir Shift+End pour sélectionner uniquement une partie du texte d'une commande, vous devez sélectionner Shift et End dans la liste des touches spéciales, et le texte proposé est [k(Shift)][k(End)]. Cela émule les touches Shift et End enfoncées de manière séquentielle. Le texte correct est [d(Shift)][k(End)][u(Shift)], où d représente la touche baissée, k représente la touche enfoncée et u représente la touche levée.

Propriétés

Entrée

• Texte (Text) - Le texte doit être écrit dans l'élément de l'interface utilisateur spécifié. Les touches spéciales sont prises en charge et vous pouvez les sélectionner à partir de la liste déroulante de l'activité.

  Il est également possible d'envoyer des pressions de touche vers le bas ou d'envoyer des pressions de touche vers le haut en utilisant cette syntaxe :

  %[d(ctrl)] - pour appuyer sur un bouton spécifique ;
  %[u(ctrl)] : pour soulever un bouton spécifique.

Par exemple, pour envoyer une combinaison de touches CTRL + V, vous pouvez utiliser %[d(ctrl)]v[u(ctrl)].

Remarque : cela ne fonctionne que pour les options Par défaut et EnvoyerMessagesFenêtre (voir ci-dessous).

Options

• SimulerType : Si cette option est sélectionnée, elle simule le type en utilisant la technologie de l’application cible. Cette méthode d’entrée est la plus rapide des trois et fonctionne en arrière-plan. Par défaut, cette case n’est pas cochée. Si ni cette case ni EnvoyerMessagesFenêtre n’est cochée, la méthode par défaut effectue les frappes en utilisant le pilote matériel. La méthode par défaut est la plus lente. Elle ne peut pas fonctionner en arrière-plan, mais est compatible avec toutes les applis de bureau. Si vous sélectionnez cette propriété, il est recommandé de vérifier l'état de l'élément d'IU cible avant l'exécution. Plus de détails peuvent être trouvés ici.
• Envoyer des messages (SendWindowMessages) - Si cette option est sélectionnée, le type est exécuté en envoyant un message spécifique à l'application cible. Cette méthode d'entrée peut fonctionner en arrière-plan, est compatible avec la plupart des applications de bureau, mais ce n'est pas la plus rapide des méthodes. Par défaut, cette case n'est pas cochée. Si ni cette case ni les cases SimulateType ne sont cochées, la méthode par défaut simule la séquence de touches en utilisant le pilote matériel. La méthode par défaut est la plus lente, elle ne peut pas fonctionner en arrière-plan, mais elle est compatible avec toutes les applications de bureau.
• Retard entre clés (DelayBetweenKeys) - Durée (en millisecondes) entre deux frappes de touche. Le délai par défaut est de 10 millisecondes. La valeur maximale est de 1 000 millisecondes.
• Cliquer avant de saisir (ClickBeforeTyping) - Lorsque cette case est cochée, l'utilisateur doit cliquer sur l'élément de l'interface utilisateur spécifié avant d'écrire le texte.

• Champ vide (EmptyField) - Lorsque cette case est cochée, tout le contenu existant de l'élément de l'interface utilisateur est effacé avant l'écriture du texte.

  Remarque :Dans les environnements Web, les champs sont vidés par défaut.

• Activer (Activate) - Lorsque cette case est cochée, l'élément de l'interface utilisateur spécifié est affiché au premier plan et activé avant l'écriture du texte.

  Remarque : Si la case à cocher Activer (Activate) n'est pas sélectionnée, l'activité est saisie dans la fenêtre active actuelle.
• ModifierSiDésactivé : si cette option est activée, l'action est exécutée même si l'élément d'IU spécifié est désactivé.

Commun

• NomAffichage (DisplayName) - Nom affiché de l'activité.
• Retard après (DelayAfter) - Durée (en millisecondes) s'écoulant après l'exécution de l'activité. Le délai par défaut est de 300 milisecondes.
• Retard avant (DelayBefore) - Délai (en millisecondes) avant que l'activité ne commence à effectuer des opérations. La durée par défaut est de 200 millisecondes.

• 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).
• Sélecteur de cible (Target.Selector) - Propriété de texte utilisée pour trouver un élément donné de l'interface utilisateur lors de l'exécution de l'activité. Il s'agit en fait d'un fragment XML spécifiant les attributs de l'élément d'interface graphique utilisateur que vous recherchez et de certains de ses parents.
• Target.TimeoutMS - Spécifie la durée (en millisecondes) à attendre pour que l'activité s'exécute avant que l'erreur SelectorNotFoundException ne soit renvoyée. La valeur par défaut est de 30 000 millisecondes (30 secondes).

• Attente cible prête (Target.WaitForReady) - Avant d'exécuter les actions, attendez que la cible soit prête. Les options suivantes sont disponibles :

  • None (Aucun) - Attend uniquement la création de l'élément de l'interface utilisateur cible avant d'exécuter l'action. Vous pouvez, par exemple, utiliser cette option si vous souhaitez récupérer uniquement du texte à partir d'une page Web ou cliquer sur un bouton spécifique sans être obligé d'attendre que tous les éléments de l'interface utilisateur soient chargés. Il est à noter que ceci peut avoir des conséquences indésirables si le bouton est basé sur des éléments qui ne sont pas encore chargés, comme par exemple des scripts.

  • Interactif/Terminé - Attend que tous les éléments d'IU de l'application cible soient créés avant d'exécuter l'action.

    Pour évaluer si une application est à l'état Interactif (Interactive) ou Terminé (Complete), les balises suivantes sont vérifiées :

  • Applications de bureau : un message wm_null est envoyé pour vérifier l'existence des balises <wnd>, <ctrl>, <java> ou <uia>. S'ils existent, l'activité est exécutée.
  • Applications Web (Web Applications)
  1. Internet Explorer : la balise <webctrl> est utilisée pour vérifier si l’état Prêt du document HTML est défini sur Terminé. En outre, l'état Occupé doit être défini sur « False ».
  2. Autres : la balise <webctrl> est utilisée pour vérifier si l’état Prêt du document HTML est défini sur Terminé.
  • Applications SAP (SAP applications) : une fois la présence de la balise <wnd> vérifiée, une API SAP spécifique est utilisée pour détecter si la session est occupée ou non.
• Élément cible (Target.Element) - Utiliser la variable UiElement renvoyée par une autre activité. Cette propriété ne peut pas être utilisée avec la propriété Selector. Ce champ prend en charge les variables UiElement uniquement.
• Target.ClippingRegion : définit le rectangle de détourage, en pixels, par rapport à l'objet UiElement, dans les sens suivants : gauche, haut, droite, bas. Elle prend en charge les nombres positifs et négatifs.

Exemple d’utilisation de l’activité Saisir dans

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