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:
  • 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-Anforderungen für 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:
    1. Klicken Sie auf der Seite Microsoft Edge Chromium-Browser auf Einstellungen.
    2. Klicken Sie im linken Bereich auf Standardbrowser.
    3. Navigieren Sie zu der Option Neuladen von Websites im Internet Explorer-Modus erlauben und wählen Sie Erlauben.
    4. Klicken Sie auf Hinzufügen, um die URL der Seite hinzuzufügen, die Sie im Internet Explorer-Modus laden möchten.
      Anmerkung: Die von Ihnen hinzugefügten Seiten werden im Internet Explorer-Modus für 30 Tage ab dem Datum des Hinzufügens geöffnet.
Ü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:

  1. Doppelklicken oder ziehen Sie Recorder > Erfassen.
  2. Geben Sie das Fenster an, in dem ein Objekt erfasst werden soll.
    Wählen Sie aus den Registerkarten Anwendung, Browser oder Variable.
    OptionBeschreibung
    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.
  3. 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.
  4. 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.
  5. Klicken Sie auf Objekt erfassen.
    Das ausgewählte Fenster wird angezeigt.
  6. 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.
  7. Klicken Sie auf das Objekt.
  8. Ü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:
    1. Wählen Sie das Element aus, für das Sie den XPath extrahieren möchten.
    2. Klicken Sie mit der rechten Maustaste auf die Aufgabe und wählen Sie Prüfen aus.
    3. Klicken Sie mit der rechten Maustaste auf das markierte Element unter der Registerkarte Element.
    4. 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
    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
    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.
    1. 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.
    2. 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.
  9. 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.

  10. 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.

  11. 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.
  12. 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:
  1. Öffnen Sie die Aktion Erfassen.
  2. Klicken Sie auf die Registerkarte Anker
  3. 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.

  4. 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.

  5. 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.

  6. Klicken Sie auf Speichern.