Aktion „JavaScript-Funktion aufrufen“

Mit der Aktion „JavaScript-Funktion aufrufen“ des Browser-Pakets können Sie eine vorhandene JavaScript-Funktion direkt in einer Webseite oder in einem iFrame innerhalb einer Webseite aufrufen.

Konfigurieren Sie die Einstellungen

Anmerkung: Diese Aktion unterstützt die Browser Google Chrome und Microsoft Edge (auf Chromium basiert).
  1. Wählen Sie die Browser-Registerkarte in der Liste der aktiven unterstützten Browser-Registerkarten aus, oder fügen Sie eine Fenstervariable ein.

    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.

  2. Optional: Verwenden Sie die Option Objekt erfassen, um die iFrames zu erfassen.
    Anmerkung: Sie können die Funktion Objekt erfassen verwenden, um eine vorhandene JavaScript-Funktion innerhalb eines iFrames aufzurufen und auszuführen.
  3. Geben Sie im Feld Funktionsname den Namen der vorhandenen JavaScript-Funktion an, die Sie aufrufen möchten.
  4. Optional: Klicken Sie im Abschnitt Argumente auf Argument hinzufügen, um Argumente hinzuzufügen, die zum Aufruf der JavaScript-Funktion übergeben werden müssen.
    1. Wählen Sie im Dialogfeld Argumentdetails den Argumenttyp aus, der für das jeweilige Argument erforderlich ist.
    2. Geben Sie in das Feld Wert den entsprechenden Wert oder die Variable des ausgewählten Typs ein, den Sie übergeben möchten.
      Anmerkung: Alle Zeichenfolgenwerte in den Argumenten werden so übergeben, wie sie sind, ohne dass ein Zeichen konvertiert oder maskiert wird.
  5. Optional: Geben Sie in das Feld Zeitlimit nach die Anzahl der Sekunden ein, die der Bot warten muss, bis die Browseraktion abgeschlossen ist.
    Anmerkung: Geben Sie einen Zeitlimitwert von mindestens 9 Sekunden ein.
  6. Wählen Sie im Feld Rückgabetyp den Typ des von der JavaScript-Funktion zurückgegebenen Wertes.
    Anmerkung: Wenn die Funktion nichts zurückgibt, wählen Sie im Feld Rückgabetyp Keiner.
  7. Für jeden Rückgabetyp außer Keiner wählen Sie im Feld Ergebnis in einer Variablen speichern eine Variable für den ausgewählten Rückgabetyp, um die Ausgabe der JavaScript-Funktion zu speichern.

Variable erstellen…

Um eine Variable für den ausgewählten Rückgabetyp zu erstellen, führen Sie die folgenden Schritte aus:
  1. Klicken Sie auf das Symbol „Variable erstellen...“ neben dem Feld Ergebnis in einer Variable speichern.

    Es öffnet sich ein Dialogfeld Variable erstellen... mit einem Standardvariablennamen für den ausgewählten Variablentyp.

  2. Optional: Geben Sie im Feld Beschreibung die Variableninformationen an.
  3. Optional: Geben Sie einen Wert in das Feld Standardwert ein.
  4. Klicken Sie auf Erstellen & auswählen, um die neu erstellte Variable auszuwählen.

Unterstützte JavaScript-Typen in den Feldern Argument und Rückgabetyp

Die folgenden JavaScript-Typen werden unterstützt:

  • JavaScript-Typen Zeichenfolge, Ziffer und Boolescher Wert, die denselben Variablentypen in Bot-Variablen entsprechen.
  • JavaScript-Typ Array, der dem Variablentyp List in Bot-Variablen entspricht.
  • JavaScript-Typ Objekt, der dem Variablentyp Dictionary in Bot-Variablen entspricht.