Eingeben in (Type Into)

UiPath.Core.Activities.TypeInto

Sendet Tastatureingaben an ein UI-Element.

Sondertasten werden unterstützt und können aus der Dropdownliste ausgewählt werden.

Sticky Keys werden ebenfalls unterstützt. Wenn Sie z. B. Shift+End eingeben möchten, um nur einen Teil des Textes eines Steuerelements auszuwählen, müssen Sie Shift und End aus der Liste der Sondertasten auswählen. Der vorgeschlagene Text ist [k(Shift)][k(End)]. Dadurch werden die Tastendrücke Shift und End nacheinander emuliert. Der korrekte Text ist [d(Shift)][k(End)][u(Shift)], wobei d für Taste nach unten, k für Tastendruck und u für Taste nach oben steht.

Eigenschaften

Eingabe

• Text (Text) - Der Text, der in ein angegebenes UI-Element geschrieben werden soll. Sondertasten werden unterstützt und können über die Drop-Down-Liste der Aktivität ausgewählt werden.

  Es ist auch möglich, Tastendrücke nach unten oder nach oben zu senden, indem Sie diese Syntax verwenden:

  %[d(ctrl)] - um eine bestimmte Schaltfläche nach unten zu drücken;
  %[u(ctrl)] - um eine bestimmte Schaltfläche nach oben zu heben.

Um beispielsweise eine STRG + V-Tastenkombination zu senden, können Sie %[d(ctrl)]v[u(ctrl)]verwenden.

Hinweis: Dies funktioniert nur für die Optionen Standard und SendWindowMessages (siehe unten).

Optionen

• TypSimulieren (SimulateType) – Wenn sie ausgewählt ist, simuliert sie die Eingabe mithilfe der Technologie der Zielanwendung. Diese Eingabemethode ist die schnellste der drei und erfolgt im Hintergrund. Standardmäßig ist dieses Kontrollkästchen deaktiviert. Wenn weder dieses noch die FenstermeldungenSenden-Kontrollkästchen aktiviert sind, führt die Standardmethode den Klick mithilfe des Hardwaretreibers aus. Die Standardmethode ist die langsamste und kann nicht im Hintergrund ausgeführt werden, ist aber mit allen Desktop-Apps kompatibel. Wenn Sie diese Eigenschaft auswählen, wird empfohlen, den Status des Ziel-UI-Elements vor der Ausführung zu überprüfen. Weitere Details finden Sie auf dieser Seite.
• SendenFensterNachrichten (SendWindowMessages) - Bei Auswahl wird die Texteingabe durch das Senden einer bestimmten Nachricht an die Ziel-Anwendung ausgeführt. Diese Eingabemethode kann im Hintergrund arbeiten, ist mit den meisten Desktop-Apps kompatibel, aber nicht die schnellste Methode. Standardmäßig ist diese Methode nicht ausgewählt. Wenn weder diese Eigenschaft noch die Auswahlfelder für TypSimulieren ausgewählt sind, simuliert die Standardmethode die Tastenanschläge über den Hardware-Treiber. Die Standardmethode ist die langsamste, kann nicht im Hintergrund arbeiten, ist aber mit allen Desktop-Apps kompatibel.
• VerzögernZwischenTasten (DelayBetweenKeys) - Verzögerungszeit (in Millisekunden) zwischen zwei Tastenanschlägen. Die Standardzeit sind 10 Millisekunden. Der Höchstwert sind 1000 Millisekunden.
• VorSchreibenKlicken (ClickBeforeTyping) - Wenn dieses Auswahlfeld ausgewählt ist, wird das angegebene UI-Element angeklickt, bevor der Text geschrieben wird.

• FeldLeeren (EmptyField) - Wenn dieses Auswahlfeld ausgewählt ist, wird der bestehende Inhalt im UI-Element vor dem Schreiben des Texts gelöscht.

  Hinweis: In Web-Umgebungen sind die Felder standardmäßig leer.

• Aktivieren (Activate) - Wenn dieses Auswahlfeld ausgewählt ist, wird das angegebene UI-Element in den Vordergrund gebracht und aktiviert, bevor der Text geschrieben wird.

  Hinweis: Wenn das Auswahlfeld Aktivieren (Activate) nicht ausgewählt ist, erfolgt die Texteingabe der Aktivität im aktiven Fenster.
• ÄndernWennDeaktiviert - Wenn diese Option aktiviert ist, wird die Aktion auch dann ausgeführt, wenn das angegebene UI-Element deaktiviert ist.

Allgemein

• AnzeigeName (DisplayName) - Der Anzeigename der Aktivität.
• VerzögernNach (DelayAfter) - Verzögerungszeit (in Millisekunden) nach dem Ausführen der Aktivität. Die Standardzeit sind 300 Millisekunden.
• VerzögerungVorher (DelayBefore) - Verzögerungszeit (in Millisekunden), bevor die Aktivität irgendwelche Operationen ausführt. Die Standardzeit sind 200 Millisekunden.

• BeiFehlerFortfahren (ContinueOnError) - Gibt an, ob die Automatisierung auch bei Auftreten eines Fehlers weiterlaufen soll. Das Feld unterstützt nur Boolesche Werte (Wahr, Falsch). Der Standardwert ist Falsch. Dadurch wird die Ausführung des Projekts beim Auftreten eines Fehlers angehalten, wenn das Feld leer. Wenn der Wert auf Wahr gesetzt ist, wird das Projekt weiter ausgeführt, auch wenn Fehler auftreten.

  Hinweis: Wenn diese Aktivität in Try Catch enthalten ist und der Wert der Eigenschaft BeiFehlerFortsetzen auf „True“ gesetzt ist, wird kein Fehler beim Ausführen des Projekts aufgefangen.

Sonstiges

• Privat (Private) - Bei Auswahl werden die Werte von Variablen und Argumenten nicht mehr auf der Stufe Verbose protokolliert.
• Ziel.Selektor (Target.Selector) - Texteigenschaft zum Suchen eines bestimmten UI-Elements, wenn die Aktivität ausgeführt wird. Die Eigenschaft ist genau genommen ein XML-Fragment, das Attribute des gesuchten GUI-Elements und einige übergeordnete Elemente spezifiziert.
• Target.TimeoutMS – Gibt die Zeit (in Millisekunden) an, die auf die Ausführung der Aktivität gewartet werden soll, bevor der Fehler SelectorNotFoundException ausgegeben wird. Der Standardwert ist 30000 Millisekunden (30 Sekunden).

• Ziel.WartenBisBereit (Target.WaitForReady) - Vor Ausführung der Aktionen warten, bis das Ziel bereit ist. Folgende Optionen sind verfügbar:

  • Keine (None) - Wartet ausschließlich auf das UI-Zielelement, bevor die Aktion ausgeführt wird. Sie können diese Option beispielsweise verwenden, wenn Sie nur Text einer Website abrufen oder eine bestimmte Schaltfläche anklicken möchten, ohne auf das Laden aller UI-Elemente warten zu müssen. Beachten Sie, dass dies ungewünschte Folgen haben kann, wenn die Schaltfläche von Elementen wie Skripten abhängt, die noch nicht geladen sind.

  • Interaktiv/Abgeschlossen – Wartet, bis alle UI-Elemente in der Ziel-App vorhanden sind, bevor die Aktion tatsächlich ausgeführt wird.

    Um zu beurteilen, ob sich eine Anwendung im Status „Interaktiv“ oder „Abgeschlossen“ befindet, werden die folgenden Tags überprüft:

  • Desktop-Anwendungen (Desktop applications) - Eine Nachricht wm_null wird versendet, um zu prüfen, ob die Tags <wnd>, <ctrl>, <java> oder <uia> vorhanden sind. Sind die Tags vorhanden, wird die Aktivität ausgeführt.
  • Webanwendung
  1. Internet Explorer – Das <webctrl>-Tag wird verwendet, um zu überprüfen, ob der Status Bereit des HTML-Dokuments Abgeschlossen ist. Darüber hinaus muss der Status Beschäftigt auf „False“ festgelegt werden.
  2. Andere – Das <webctrl>-Tag wird verwendet, um zu überprüfen, ob der Bereitschafts-Status des HTML-Dokuments Abgeschlossen ist.
  • SAP-Anwendungen (SAP applications) - Zuerst wird geprüft, ob der Tag <wnd> vorhanden ist. Anschließend wird eine SAP-spezifische API verwendet, um zu prüfen, ob die Session verfügbar ist.
• Ziel.Element (Target.Element) - Verwendet die Variable UIElement, die von einer anderen Aktivität zurückgegeben wird. Die Eigenschaft kann nicht zusammen mit der Auswahleigenschaft verwendet werden. Dieses Feld unterstützt nur Variablen vom Typ UIElement.
• Target.ClippingRegion - Definiert das Ausschneide-Rechteck in Pixel im Verhältnis zum UIElement in folgenden Richtungen: links, oben, rechts, unten. Es unterstützt sowohl positive als auch negative Zahlen.

Beispiel für die Verwendung der „Type Into“-Aktivität

Hier sehen Sie, wie die Aktivität Type Into in einem Beispiel verwendet wird, das mehrere Aktivitäten enthält.