Edit a task recorded with the Universal Recorder

After recording a task, edit the Capture Aktionen to change the window, capture a different object, select a new action, enable background processing, enter a different wait time, or save the output to a variable.

Vorbereitungen

Select the List view to see the full details of each Aktion.

Edit a recorded task to do the following:
  • Change the application window in which you want to perform the operation, or add a wildcard to the window title.
  • Change the properties of the captured objects.
  • Specify the Aktion you want to perform on the captured objects.
  • Introduce a delay before the next Aktion is performed.
  • Specify the variable you want to use to store the output.

To add a Capture Aktion to the task, see Verwendung der Funktion „Aktion erfassen“.

Prozedur

To edit a recorded task, perform the following steps:

  1. Open the Bot that contains the recorded Aktionen you want to edit.
  2. Click the Capture Aktion that you want to edit.

Make the following changes, as necessary:

  1. Change the window selection to the Currently active window option.
  2. 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.
  3. 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.
  4. Ü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.
  5. Select the Action from the drop-down list.
    For a full list of possible Aktionen by object, see Aktionen für mit dem Universal Recorder erfasste Objekte.
    • If you record a click and keystrokes in a text box with a Control Type of Password text, the Recorder does not capture the keystrokes entered into the field. Instead, the Aktion selects the Set text option and offers options to securely input the password. We recommend that you store the password in the Credential Vault and insert it into the Aktion as a credential. Anmeldedaten und Anmeldedaten-Variablen im Bot Editor

      If you navigate to the text box using the TAB keystroke instead of a click in an MSAA or SAP application, the Recorder is able to identify fields with a Control Type of Password text.

      We recommend that you use the Set text Aktion without setting a delay time to enter keystrokes into a text field. However, if the text that you want to enter consists of a control key value or a text field requires any key press event, then you must set a delay time between the keystrokes when using the Set text Aktion.

    • If the selected Action supports background processing, a Run in the background option appears. Universal Recorder für objektbasierte Automatisierung
  6. Optional: Enter a value in the Wait for control field to specify the number of seconds the Bot must wait for the object control to appear on the application window.
  7. 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.
  8. Perform the Steps 3 through 9 for the other Aktionen that you want to edit in the Bot.
  9. Click Save.
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.