Verwendung der Funktion „Aktion erfassen“

Verwenden Sie die Aktion Erfassen, um eine einzelne Interaktion (Klicken, Tastendruck oder Mausbewegung) mit einem Objektsteuerelement zu erfassen, z. B. ein Textfeld, eine Schaltfläche, eine Tabelle, ein Menü, ein Optionsfeld, ein Kombinationsfeld, ein Kontrollkästchen, eine Listenansicht, eine Verknüpfung, eine Struktur oder eine Seitenregisterkarte.

Vorbereitungen

Um den Recorder zu verwenden, müssen Sie bereits folgende Schritte abgeschlossen haben:
- Install Bot-Agent and register device
- Festlegen von Geräteanmeldedaten für Nutzer
Konfigurieren Sie die Geräteanzeige und den Schriftgrad auf 100 %.
Wenn Sie Version 2.0.6-20200626-193519 oder höher des Recorder-Pakets verwenden, können Sie Aufgaben in Google Chrome, Internet Explorer, Java, Microsoft Active Accessibility und Microsoft UI-Automatisierungsanwendungen auf einem Computer aufzeichnen, dessen Anzeigeskalierung auf 100 %, 125 % oder 150 % eingestellt ist.
Wenn Sie eine Aufgabe mithilfe eines Browsers automatisieren, konfigurieren Sie die Zoomstufe auf 100 %.
Wenn Sie Version 2.0.6-20200626-193519 oder höher des Recorder-Pakets verwenden, können Sie Aufgaben in einem Google Chrome-Browser aufzeichnen, in dem die Zoomstufe nicht auf 100 % eingestellt ist.
Wenn Sie eine Aufgabe mit einem Google Chrome-Browser automatisieren, stellen Sie sicher, dass das Automation Anywhere-Plug-in, das der Automation 360-Build-Version entspricht, aktiviert ist.
Browser requirements for Automation Workspace
Um Webanwendungen zu automatisieren, die auf Microsoft Edge Chromium-Browsern im Internet Explorer-Modus unter Nutzung des Universal Recorders laufen, müssen Sie sicherstellen, dass der Internet Explorer-Kompatibilitätsmodus aktiviert ist. Die Objekte in den Webanwendungen werden mit der HTML-Technologie erfasst. Um diesen Modus zu aktivieren, führen Sie die folgenden Schritte aus:

Überlegungen bei der Aufzeichnung einer Aufgabe:

Verwenden Sie, wenn möglich, Klicks anstelle von Tastenkombinationen.
Wenn Sie mit dem Recorder auf ein Objekt klicken, werden die Eigenschaften des Objekts abgerufen, die es dem Bot ermöglichen, das Objekt zur Laufzeit zu identifizieren. Tastenkombinationen sind weniger zuverlässig. Verwenden Sie sie daher, wenn es nicht möglich ist, die Aufgabe durch Anklicken eines Objekts zu automatisieren.
Wenn Sie eine Aufgabe mithilfe eines Browsers automatisieren, verwenden Sie keine automatische Ausfüllfunktion, um Werte in Felder einzugeben.
Zeichnen Sie die Aufgabe mit niedriger Geschwindigkeit auf.
Ziehen Sie die Fenster nicht während der Aufzeichnung.
Klicken Sie nicht auf Anwendungen, die nicht Teil des aufzuzeichnenden und zu automatisierenden Prozesses sind.
Wenn Internet Explorer verwendet wird, wartet die Aktion, bis der Browser vollständig gerendert ist und sich in einem Bereitschaftszustand befindet, bevor die Aktion ausgeführt wird.

Prozedur

Um eine einzelne Interaktion mit einem Objektsteuerelement aufzuzeichnen, gehen Sie folgendermaßen vor:

Doppelklicken oder ziehen Sie Recorder > Erfassen.

Geben Sie das Fenster an, in dem ein Objekt erfasst werden soll.

Wählen Sie aus den Registerkarten Anwendung, Browser oder Variable.

Option	Beschreibung
Anwendung	Auswahl aus einer Liste der derzeit aktiven Fenster. Diese Option zeigt eine Liste aller Anwendungs- und Browserfenster an, die auf dem Bot Creator-Gerät geöffnet sind.
Browser	Auswahl aus einer Liste der unterstützten Browser-Registerkarten. Anmerkung: Diese Option unterstützt die Browser Google Chrome, Microsoft Edge (auf Chromium basiert) und Internet Explorer. Verwenden Sie bei allen anderen Browsern die Option Anwendung.
Variable	Auswahl einer vorhandenen Fenstervariable zur Titelangabe des Anwendungsfensters.

Optional: Fügen Sie ein Platzhalterzeichen (*) in das Feld Fenstertitel ein, um nach Fenstertiteln zu suchen, die sich ändern können. Sie können am Anfang, in der Mitte oder am Ende des Werts einen oder mehrere Platzhalter (*) angeben.
Um zum Beispiel eine Operation in einem Fenster auszuführen, das Microsoft im Titel aufweist, verwenden Sie einen Platzhalter, um eine beliebige Zeichenfolge anzugeben, indem Sie ihn vor oder nach dem Wert hinzufügen: *Microsoft*. Der Bot sucht zunächst nach dem genauen Fenstertitel (Microsoft), und wenn er keine Übereinstimmung findet, sucht er nach Fenstern mit dem Begriff Microsoft im Titel.
Sie können einen regulären Ausdruck (Regex) verwenden, um einen Fenstertitel zu kennzeichnen. Wählen Sie die Bedingung für den regulären Ausdruck entweder als Zeichenfolge oder als Muster aus und geben Sie dann den Wert ein. Standardmäßig muss bei dem Feld Fenstertitel die Groß-/Kleinschreibung beachtet werden.

Um einen Browsertitel zu identifizieren, können Sie die Option Groß-/Kleinschreibung muss beachtet werden aktivieren, um die Groß- und Kleinschreibung abzugleichen. Sie können die Option auch deaktivieren, um einen Fenstertitel anzugeben, bei dem die Groß- und Kleinschreibung nicht übereinstimmen muss.
Anmerkung: Vergewissern Sie sich, dass die auf Ihrem System installierte Bot-Agent-Version zumindest in der Version vorliegt, die mit Automation 360 v.26 veröffentlicht wurde. Wenn Sie eine Bot-Agent-Version nutzen, die mit Automation 360 v.25 oder früher veröffentlicht wurde, wird beim Fenstertitel standardmäßig die Groß- und Kleinschreibung beachtet.
Sie können zum Beispiel den Zeichenfolge-Wert als ((\w*)-Notepad für alle Fenstertitelnamen eingeben, die mit ((\w*)-Notepad beginnen, oder den Muster-Wert als ((\w)\s)*document-Notepad nur für die Fenstertitel verwenden, die diesem Muster entsprechen.
Anmerkung:
- Wenn Sie als Eingabewert für einen Fenstertitel in einer beliebigen Aktion einen regulären Ausdruck vom Typ Zeichenfolge mit -title verwenden, kann beim Bot ein Laufzeitfehler auftreten. Um den Laufzeitfehler zu vermeiden, achten Sie beim Hinzufügen der Zeichenfolge als *-title darauf, dass die Anwendung mit dem entsprechenden Titel geöffnet ist. Das Sternchen (*) ist nur ein Zeichen, kein Platzhalterzeichen.
- Wenn Sie als Eingabewert für einen Fenstertitel in einer beliebigen Aktion einen regulären Ausdruck vom Typ Zeichenfolge mit -title verwenden, kann beim Bot ein Laufzeitfehler auftreten, da der Eingabewert *-title falsch ist.
  Achten Sie darauf, dass Sie gültige Regex-Muster verwenden.
Anmerkung: Überprüfen Sie während der Laufzeit, ob der TaskBot das richtige Fenster identifiziert. Wenn dies nicht der Fall ist, gehen Sie wie folgt vor:
1. Öffnen Sie das Anwendungs- oder Browserfenster.
2. Ziehen Sie die Aktion Fenster > Titel für aktives Fenster abrufen über die Aktion Recorder > Erfassen.
3. Fügen Sie eine Zeichenfolgenvariable in das Feld Titel für aktives Fenster einer Variable zuweisen ein.
4. Ziehen Sie die Aktion Fenster > Titel festlegen unter die Aktion Fenster > Titel für aktives Fenster abrufen.
5. Fügen Sie im Feld Fenster die Fenstervariable ein, die von der Aktion Recorder > Erfassen generiert wurde.
6. Fügen Sie im Fenster Titel des neuen Fensters die Zeichenfolgenvariable aus der Aktion Aktiven Titel für aktives Fenster abrufen ein.
7. Klicken Sie auf Speichern.
Optional: Wählen Sie die Option Fenstergröße ändern, um die Abmessungen des Fensters festzulegen.
Diese Option bietet einen zuverlässigeren Bot. Dadurch passen Sie die Größe des Fensters an die Dimensionen an, in denen die Aufgabe aufgezeichnet wurde, was die Fähigkeit des Bots, das Zielobjekt zu identifizieren, verbessert.
- Wenn das Fenster während der Aufzeichnung der Aufgabe maximiert ist, ist diese Option nicht ausgewählt.
- Wenn das Fenster bei der Aufzeichnung der Aufgabe nicht die maximale Größe hat, ist diese Option standardmäßig aktiviert, und die Felder für Breite und Höhe werden automatisch mit den Abmessungen des Fensters gefüllt.
Anmerkung: Diese Option ist nur für Fenster verfügbar, deren Größe verändert werden kann. Sie ist nicht verfügbar für die Optionen Desktop und Taskleiste.
Klicken Sie auf Objekt erfassen.
Das ausgewählte Fenster wird angezeigt.
Bewegen Sie die Maus über das Objekt, das Sie automatisieren möchten, z. B. eine Schaltfläche, ein Formularfeld oder eine Tabelle.
Um das Objekt wird ein rotes, rechteckiges Feld angezeigt.
Anmerkung: Wenn das Feld nicht angezeigt wird und Sie die Erfassung in Google Chrome-, Microsoft Edge- oder Mozilla Firefox-Browsern durchführen, überprüfen Sie, ob Sie die Automation Anywhere-Erweiterung aktiviert haben. Siehe Anforderungen an die Google Chrome-Browsererweiterungen für Google Chrome-Browser.
Klicken Sie auf das Objekt.

Überprüfen Sie die Tabelle Objekteigenschaften.

Nachfolgend finden Sie eine Liste der Objekteigenschaften, die je nach Technologietyp standardmäßig ausgewählt sind:

Important: Die folgende Liste enthält nicht alle Eigenschaften und beschränkt sich auf die am häufigsten verwendeten und wichtigsten Eigenschaften je nach Technologietyp.


Technologietyp	Objekteigenschaften	Beschreibung
HTML-Technologie	Steuerelementtyp	Dies ist eine schreibgeschützte Eigenschaft, die den Typ des erfassten Objekts anzeigt, z. B. Textfeld oder Schaltfläche.
	DOMXPath	Dies ist der Pfad, der verwendet wird, um das zu erfassende Steuerelement oder Objekt zu finden. Für DOMXPath gibt es zwei Typen: Relativer XPath und absoluter XPath. Absoluter XPath: Dieser enthält den vollständigen Pfad vom Stammelement zum gewünschten Element. Ein absoluter XPath für dieses Thema wäre zum Beispiel `/html/body/div/div[1]/main/div[2]/div/div/div[2]/div/div/div[1]/div/article/main/article/div/p[1]` Relativer XPath: Dies ist ein kürzerer Pfad, der auf ein Element verweist, das Sie identifizieren möchten. Ein relativer XPath beginnt mit dem Symbol `//`. Der relative XPath für dieses Thema wäre zum Beispiel `//*[@id="cloud-using-recorder-action"]/div/p[1]` Wenn Sie zum Beispiel nach dem DOMXPath eines bestimmten Elements im Google Chrome-Browser suchen, führen Sie diese Schritte aus: Wählen Sie das Element aus, für das Sie den XPath extrahieren möchten. Klicken Sie mit der rechten Maustaste auf die Aufgabe und wählen Sie Prüfen aus. Klicken Sie mit der rechten Maustaste auf das markierte Element unter der Registerkarte Element. Gehen Sie zu Kopieren > XPath kopieren, um den relativen Pfad zu kopieren, und wählen Sie Kopieren > Vollständigen XPath kopieren, um den absoluten Pfad zu kopieren.
	Pfad	Es handelt sich um eine numerische Darstellung der Position eines bestimmten Steuerelements in einer Anwendung. Für Webanwendungen ist es am besten, DOMXPath als Suchkriterium zu verwenden, verglichen mit Path.
	HTML-Name und -ID	Diese Eigenschaften werden verwendet, um ein HTML-Objekt zu identifizieren.
	Innerer HTML-Text	Die Eigenschaft „DOM innerText“ wird verwendet, um den Textinhalt eines bestimmten Knotens und seiner Nachkommen festzulegen oder zurückzugeben.
	HTML-Tag	HTML-Tags sind wie Schlüsselwörter, die festlegen, wie der Webbrowser den Inhalt formatiert und anzeigt. Wenn der erfasste Text beispielsweise folgenden HTML-Code enthält: `<h3 class="search_results-title">Search results for ״string package״</h3>`, dann geben Sie `h3` in das HTML-Tag-Feld ein.
Microsoft Active Accessibility	Steuerelementtyp	Diese Eigenschaft wird nur als Referenz verwendet, um sicherzustellen, dass das richtige Objekt erfasst wird
	Pfad	Es handelt sich um eine numerische Darstellung der Position eines bestimmten Steuerelements in einer Anwendung
	Name	Dies gibt den Namen eines Elements an und dient als Bezeichner
	ID	Dies gibt die ID eines Elements an und dient als Bezeichner
JAVA-Technologie	Steuerelementtyp	Diese Eigenschaft wird nur als Referenz verwendet, um sicherzustellen, dass das richtige Objekt erfasst wird
JAVA-Technologie	Pfad	Es handelt sich um eine numerische Darstellung der Position eines bestimmten Steuerelements in einer Anwendung
Microsoft UI-Automatisierung	Steuerelementtyp	Diese Eigenschaft wird nur als Referenz verwendet, um sicherzustellen, dass das richtige Objekt erfasst wird
	Pfad	Es handelt sich um eine numerische Darstellung der Position eines bestimmten Steuerelements in einer Anwendung
	Name	Dies gibt den Namen eines Elements an und dient als Bezeichner
	ID	Dies gibt die ID eines Elements an und dient als Bezeichner
	IstZuerst	Diese Eigenschaft ermöglicht es dem Bot, das erste Objekt zu finden, das Ihren Suchkriterien entspricht, anstatt die gesamte Struktur zu durchsuchen. Sie können diese Eigenschaft verwenden, wenn ein Objekt nicht über eine eindeutige Automation-ID verfügt und sich die Objekthierarchie in der Anwendung ändert.
Microsoft UI-Automatisierung (COM)	Steuerelementtyp	Diese Eigenschaft wird nur als Referenz verwendet, um sicherzustellen, dass das richtige Objekt erfasst wird.
	Pfad	Es handelt sich um eine numerische Darstellung der Position eines bestimmten Steuerelements in einer Anwendung.
	Name	Dies gibt den Namen eines Elements an und dient als Bezeichner.
	ID	Dies gibt die ID eines Elements an und dient als Bezeichner.

Der Bot verwendet die ausgewählten Eigenschaften, um das Objektsteuerelement zur Laufzeit zu identifizieren.

Prüfen Sie, ob der Steuerelementtyp mit dem gewünschten Objekt übereinstimmt.
Wenn Sie zum Beispiel eine Tabelle von einer Website erfassen, stellen Sie sicher, dass die Werte Steuerelementtyp und HTML-Tag eine Tabelle sind.

Wenn der Steuerelementtyp nicht mit dem von Ihnen beabsichtigten Objekt übereinstimmt, erfassen Sie das Objektsteuerelement erneut.
Wählen Sie die Objekteigenschaften aus, die Sie in die Objektsuche einbeziehen möchten, und weisen Sie ihnen Werte zu.
Für einen zuverlässigeren Bot empfehlen wir Ihnen, nur die Eigenschaften auszuwählen, die statische Werte haben (z. B. Name, Klasse, Typ, HTML-ID und DOMXPATH), und die Eigenschaften zu deaktivieren, die dynamische Werte haben (z. B HTML Href, Pfad oder Wert), da diese sich ändern und Bot-Fehler verursachen können.
Es hat sich bewährt, das Platzhalterzeichen (*) oder Variable in den Werten von Objekteigenschaften zu verwenden, um nach Objekten zu suchen, deren Eigenschaften dynamisch sind und sich häufig ändern.

Wählen Sie die Aktion aus der Dropdown-Liste aus.
Eine vollständige Liste der möglichen Aktionen nach Objekt finden Sie unter Aktionen für mit dem Universal Recorder erfasste Objekte.
- Wenn Sie in einem Textfeld mit dem Steuerelementtyp Password text einen Klick und Tastaturanschläge aufzeichnen, erfasst der Recorder die in das Feld eingegebenen Tastaturanschläge nicht. Stattdessen wählt die Aktion die Option Text festlegen und bietet Optionen zur sicheren Eingabe des Passworts. Wir empfehlen, das Passwort im Credential Vault zu speichern und es in die Aktion als Anmeldedaten einzufügen.
  Einzelheiten finden Sie unter Anmeldedaten und Anmeldedaten-Variablen im Bot Editor.
  
  Wenn Sie in einer MSAA- oder SAP-Anwendung mit der TAB-Taste statt mit einem Klick in das Textfeld navigieren, kann der Recorder Felder mit dem Steuerelementtyp Password text identifizieren.
- Wenn die ausgewählte Aktion die Hintergrundverarbeitung unterstützt, wird die Option Im Hintergrund ausführen angezeigt
  Einzelheiten finden Sie unter Universal Recorder für objektbasierte Automatisierung.
Optional: Geben Sie einen Wert in das Feld Weiterversuchen für (Sekunden) ein, um die Anzahl der Sekunden anzugeben, die der Bot warten muss, bis das Objektsteuerelement im Anwendungsfenster erscheint.
Wir empfehlen, eine Verzögerungszeit einzustellen, wenn Sie die Aktion „Text festlegen“ verwenden, um Tastaturanschläge in ein Textfeld einzugeben.

Anmerkung: Die für den Bot angegebene Wartezeit, bis das Steuerelement im Anwendungsfenster erscheint, gilt nur, wenn das Fenster, in dem das Steuerelement vorhanden ist, existiert. Der Recorder sucht zuerst nach dem Anwendungsfenster und erst dann nach dem Objekt innerhalb dieses Fensters. Die Standardzeit für die Suche nach dem Fenster beträgt 30 Sekunden. Selbst wenn Sie also eine Wartezeit von 5 Sekunden angeben, wird standardmäßig 30 Sekunden gewartet, wenn das Fenster nicht vorhanden ist.
Wir empfehlen Ihnen, zunächst die Bedingung Wenn > Fenster existiert zu verwenden, eine Wartezeit von null Sekunden anzugeben und sicherzustellen, dass das Anwendungsfenster existiert. Wenn das Fenster vorhanden ist, verwenden Sie den Recorder, geben Sie eine Wartezeit von 5 Sekunden an und führen Sie den Bot aus, um das Objekt zu erkennen.
Optional: Weisen Sie die Ausgabe einer Variable zu
Der Control Room schlägt einen beschreibenden Standardvariablennamen vor, der auf der in Schritt 8 ausgewählten Aktion basiert. Wenn Sie zum Beispiel die Option Eigenschaft abrufen ausgewählt haben, lautet die vorgeschlagene Ausgabevariable PropertyValue. Wenn Sie mehrere Ausgabevariablen erstellen, wird nachfolgenden Variablennamen -1 angehängt, um doppelte Namen zu vermeiden.
Klicken Sie auf Speichern.
Die erfassten Bilder werden nicht als Abhängigkeiten hinzugefügt und werden nicht in der Liste der Abhängigkeiten angezeigt, wenn Sie Ihren Bot einchecken.

Ein Objekt mit einem tragenden Anker verknüpfen

Anmerkung: Sie können die Objektverankerung in Microsoft Active Accessibility, Microsoft UI Automation oder Java-Anwendungen verwenden.

Wenn der Bot zur Laufzeit ein Objekt nicht zuverlässig identifizieren kann, verknüpfen Sie es mit einem nahegelegenen Objekt (z. B. einem Link oder einer Schaltfläche), das für den Bot leichter zu finden ist:

Öffnen Sie die Aktion Erfassen.
Klicken Sie auf die Registerkarte Anker
Klicken Sie auf Anker erfassen.
Das Browser- oder Anwendungsfenster wird aktiviert, wobei das Hauptobjekt hervorgehoben ist (das Objekt, das Sie zuvor erfasst haben). Es erscheint ein Dialogfeld, in dem überprüft wird, ob die Aktion das Hauptobjekt korrekt identifiziert hat.
Wenn das richtige Objekt hervorgehoben ist, klicken Sie auf Ja, Anker auswählen.
Andernfalls, klicken Sie auf Nein, Korrektur notwendig, um das richtige Objekt auszuwählen.
Wählen Sie ein Objekt in der Nähe des Zielobjekts aus, das für den Bot leichter zu finden ist.
Das Objekt wird durch ein Ankersymbol rechts neben dem Objekt hervorgehoben.
Klicken Sie auf Speichern.

Automation 360

Verwendung der Funktion „Aktion erfassen“