Inject Js Script

UiPath.Core.Activities.InjectJsScript

Führt JavaScript-Code im Webseiten-Kontext zu einem UiElement aus.

Eigenschaften

Eingabe

• SkriptCode – Der JavaScript-Code, den Sie ausführen möchten. Sie können ihn hier als Zeichenfolge schreiben oder den vollständigen Pfad einer .js -Datei hinzufügen, die den auszuführenden Code enthält. Sie sollte eine einzelne, anonyme Funktion wie in diesen Beispielen enthalten:

  function (element, input) {
    return "result";
  }
  

  async function (element, input) 
  {
    const asyncResult = await new Promise((resolvePromiseCb) => 
    {
      const timeoutMs = 100;
      setTimeout(() => 
      {
        resolvePromiseCb("async_result");
      }, 
      timeoutMs);
    });
    return asyncResult;
  }
  

  wobei element das HTML-Element darstellt, das dem aufrufenden UI-Knoten entspricht, und input die vom Aufrufer bereitgestellte Eingabezeichenfolge darstellt.

• EingabeParameter (InputParameter) - Eingabedaten für den JavaScript-Code als Zeichenfolge oder Zeichenfolgenvariable.

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

• Ziel.AuszeitMS (Target.TimeoutMS) - Gibt die Wartezeit (in Millisekunden) bis zur Fehlerausgabe SelectorNotFoundException einer laufenden Aktivität an. 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 - The <webctrl> tag is used to check if the Ready state of the HTML document is set to Complete. Additionally, the Busy state has to be set to "False".
  2. Others - The <webctrl> tag is used to check if the Ready state of the HTML document is Complete.
  • 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.

Ausgabe

• SkriptAusgabe (ScriptOutput) - Zurückgegebenes Zeichenfolgen-Ergebnis aus JavaScript-Code.

Allgemein

• AnzeigeName (DisplayName) - Der Anzeigename der Aktivität.

• ContinueOnError - Specifies if the automation should continue even when the activity throws an error. This field only supports Boolean values (True, False). The default value is False. As a result, if the field is blank and an error is thrown, the execution of the project stops. If the value is set to True, the execution of the project continues regardless of any error.

  Hinweis:

  Wenn die Aktivität in Abfangen versuchen (Try Catch) enthalten ist und der Wert der Eigenschaft BeiFehlerFortfahren (ContinueOnError) auf Wahr (True) gesetzt ist, wird kein Fehler bei der Ausführung des Projekts abgefangen.

Sonstiges

• Privat (Private) - Bei Auswahl werden die Werte von Variablen und Argumenten nicht mehr auf der Stufe Verbose protokolliert.

Optionen

• Execution world - The JavaScript environment for the script execution.
  • Isolated - Allows access to the HTML elements, but prevents access to page variables and code. Use this option to ensure that the script execution does not conflict with the page.
  • Seite – Ermöglicht den Zugriff auf die HTML-Elemente, Seitenvariablen und den Code. Verwenden Sie diese Option, wenn Sie auf Seitenvariablen (z. B. jQuery $) zugreifen müssen oder mit Seitencode interagieren müssen (z. B. window.alert). Die Verwendung dieser Option ist erforderlich, um dieses bekannte Problem zu beheben, das bei MV3-Erweiterungen spezifisch ist.

Sie können die Eigenschaft Ausführungswelt für alle Inject Js Script- Aktivitäten über die Projekteinstellungen ändern.

Hinweis:

The Execution world option is available starting with UiPath.UIAutomation.Activities version 22.12.

Verwendungsbeispiel der Aktivität Inject JS Script

Die Aktivität Inject JS Script wird verwendet, um einen Browser zu öffnen und .js-Dateien auf diesen Seiten zu verarbeiten. Sie müssen die Browsererweiterungen installiert und aktiviert haben.

Um die Verwendung dieser Aktivität zu veranschaulichen, haben wir ein Beispiel erstellt, das einen Browser öffnet und eine Warnung mit dem vom Benutzer angegebenen Text anzeigt.

So kann der Automatisierungsprozess erstellt werden:

1. Öffnen Sie Studio und erstellen Sie einen neuen Prozess.
   Hinweis:

   Stellen Sie sicher, dass Sie die .js-Datei im Projektordner ablegen. In diesem Beispiel haben wir die Datei example.js verwendet.

2. Drag a Sequence to the Workflow Designer.

   • Erstellen Sie die folgenden Variablen:

     Variablenname	Variablentyp	Standardwert
     TextToWrite	GenericValue

3. Ziehen Sie eine Input Dialog-Aktivität in den Sequence-Container.
   • In the Properties panel, add the name Ask for message in the DisplayName field.
   • Fügen Sie den Ausdruck "Please insert the text to be written on the web page." in das Feld Beschriftung ein.
   • Fügen Sie die Meldung "Please insert text" in das Feld Titel ein.
   • Fügen Sie die Variable textToWrite in das Feld Ergebnis ein.
4. Platzieren Sie eine Open Browser-Aktivität unter die Input Dialog-Aktivität.
   • Fügen Sie die Adresse "https://www.google.com/" in das Feld URL ein.
5. Ziehen Sie eine Inject JS Script-Aktivität in den Textkörper-Container der Aktivität Open Browser.
   • Fügen Sie im Eigenschaftenbereich den Namen Show Alert in das Feld Anzeigename ein.
   • Fügen Sie die Variable TextToWrite in das Feld Eingabeparameter ein.
   • Fügen Sie den Ausdruck "Inject JS\example.js" in das Feld Skriptcode ein.
6. Führen Sie den Prozess aus. Der Roboter öffnet eine neue Browserseite und gibt die Warnung mit dem von Ihnen hinzugefügten Text aus.

Beispiel herunterladen