Verwenden der Aktion „Funktion ausführen“

Verwenden Sie die Aktion Funktion ausführen zum Ausführen einer Funktion innerhalb einer .dll-Datei und zum Angeben der Parameter, um eine Funktion zu übergeben und die Ausgabe als Variable zu speichern.

  • Diese Aktion ermöglicht es Ihnen, einen Parameter beliebigen Typs zu übergeben.
  • Die Aktion Funktion ausführen unterstützt nicht die Verwendung von Windows Forms.
  • Wenn die .dll-Datei .NET-Funktionen oder Klassen aus einer anderen .dll-Datei verwendet, müssen Sie die zweite .dll-Datei als eine manuelle Abhängigkeit des Bots hinzufügen.

    Bot-Abhängigkeiten

  • Diese Aktion unterstützt überladene Funktionen ab Enterprise A2019.17. Die Aktion kann .dll-Dateien verarbeiten, die mehrere Funktionen mit demselben Namen enthalten. Sie ruft die Funktion auf der Grundlage der Anzahl der übergebenen Parameter auf.
  • Wenn Sie diese Aktion verwenden, überprüfen Sie, ob Sie die unterstützten Datentypen für DLL-Funktionen verwenden.

    DLL-Paket

Prozedur

Führen Sie die folgenden Schritte aus, um eine Funktion auszuführen:

  1. Doppelklicken Sie in der Palette Aktionen auf die Aktion Funktion ausführen oder ziehen Sie sie aus dem DLL-Paket.
  2. Geben Sie im Feld Sitzungsname den Namen der Sitzung ein.
  3. Geben Sie im Feld Den Namespace eingeben (optional) den Namespace an.
    Sie können jeden der in der DLL-Datei definierten Namespaces angeben.
    Anmerkung: Vergewissern Sie sich, dass der Wert, den Sie in das Feld eingegeben haben, korrekt ist.
    Wichtig: Bei diesem Feld wird zwischen Groß- und Kleinschreibung unterschieden.
  4. Geben Sie im Feld Den Klassennamen eingeben den Namen der Klasse an.
    Sie können den Namen einer beliebigen der im Namensraum verfügbaren Klassen angeben.
    Wichtig: Bei diesem Feld wird zwischen Groß- und Kleinschreibung unterschieden.
  5. Geben Sie im Feld Den Namen der auszuführenden Funktion eingeben den Namen der auszuführenden Funktion an.
    Vergewissern Sie sich, dass der von Ihnen angegebene Name korrekt und in der im vorherigen Schritt angegebenen Klasse verfügbar ist.
    Wichtig: Bei diesem Feld wird zwischen Groß- und Kleinschreibung unterschieden.
  6. Optional: Klicken Sie im Abschnitt Eingabeparameter auf die Schaltfläche Parameter hinzufügen.
    1. Geben Sie im Dialogfeld DLL-Parameter-Details im Feld Parametername den Namen des Parameters ein.
    2. Wählen Sie aus der Liste Parametertyp einen Datentyp aus.
      Für den Datentyp „Integer“ (UInt16, Int16, Int32, Int64, Int, Single, Float, Decimal, Double, UInt32 oder UInt64) können Sie einen Wert aus einem Credential Vault oder eine Berechtigungsvariable als Eingabeparameter verwenden.
    3. Geben Sie im Feld Wert den Wert ein, den Sie übergeben möchten.
      Wenn Sie den Datentyp „Integer“ auswählen, können Sie zwischen folgenden Optionen wählen:
    • Zahl: Geben Sie in das Zahlenfeld den Wert ein, den Sie übergeben möchten.

    • Anmeldedaten: Um einen Wert aus einem Credential Vault zu verwenden, wählen Sie Berechtigungsnachweis. Um eine Anmeldedatenvariable zu verwenden, wählen Sie Variable.
    Weitere Informationen über Credential Vaults und deren Verwendung finden Sie unter Anmeldedaten und Locker im Credential Vault.
    Wiederholen Sie Schritt 6, um mehrere Parameter hinzuzufügen.
    Wichtig: Die Namen der Parameter, die Sie hinzufügen, und ihre Reihenfolge müssen mit der DLL-Funktion übereinstimmen.
  7. Verwenden Sie die Option Funktion im Hintergrund ausführen, wenn unter der C#-DLL keine mit dem Windows-System verbundenen Operationen, wie z. B. Tastaturanschlag, Mausklick oder Fensterwechsel, aufgerufen werden. Sie können das Kontrollkästchen Funktion im Hintergrund ausführen aktivieren, um das Zwischenfenster (AAZeroSizeForm) zu umgehen und die C#-DLL in der Konsolenanwendung ohne das Formular auszuführen. Wir empfehlen, dieses Kontrollkästchen zu aktivieren, wenn die DLL-Funktion nicht mit der Windows-API interagiert, um Operationen wie Tastaturanschlag, Mausklick oder Fensterwechsel durchzuführen. Diese Funktion hilft auch, die Leistung der DLL-Ausführung zu verbessern, wenn das Kontrollkästchen Funktion im Hintergrund ausführen aktiviert ist.
  8. Optional: Wählen Sie aus der Liste Ausgabe einer Variablen zuweisen eine Variable aus, in der die Ausgabe der Funktion gespeichert werden soll.
    Sie können boolesche, Datum/Zeit-, Wörterbuch-, Listen-, Zahlen-, Zeichenfolgen- oder Tabellenvariablen verwenden, um die Ausgabe zu speichern, je nachdem, welche Art von Ausgabe die Funktion zurückgibt.
  9. Klicken Sie auf Speichern.