DLL-Paket
- Zuletzt aktualisiert2024/10/16
DLL-Paket
Eine DLL-Datei (Dynamic Link Library) enthält eine gemeinsam genutzte Bibliothek von Funktionen, die von Windows-Programmen verwendet werden können. Das DLL-Paket verwendet eine .dll-Datei als Referenz und ruft Funktionen aus dem Bot ab.
Bevor Sie beginnen
- 32-Bit-DLL-Funktionen werden unterstützt, da AutomationAnywhere.ManagedDLLWrapper.exe 32-Bit-Bibliotheken verwendet.
- Wenn Sie Bots mit einer benutzerdefinierten DLL erstellen und die benutzerdefinierte DLL eine Abhängigkeit von der Apache log4net-Bibliothek hat, dann empfehlen wir die Verwendung von:
- log4net Version 2.0.11 oder höher in der benutzerdefinierten DLL.
- Aktualisieren Sie den Bot-Agenten (Version 21.210 oder höher), auch wenn das Bot-Agent-Update optional ist.
- Es werden nur DLLs unterstützt, die unter Verwendung von Microsoft .NET Framework erstellt wurden.
- Das DLL ausführen-Paket ist mit den folgenden Versionen von Microsoft .NET kompatibel: 4.6, 4.7, und 4.8.
- Wenn Sie einen Bot erstellen und die lokale Sitzung mit Schleife verwenden, stellen Sie sicher, dass Sie die Aktion „Sitzung schließen“ im Bot verwenden. Wenn Sie den Befehl „Sitzung schließen“ nicht verwenden, wird die lokale Sitzung AutomationAnywhere.ManagedDLLWrapper.exe bei jeder Iteration der Schleife geöffnet. Infolgedessen geht Ihnen der Arbeitsspeicher aus, und der Bot wird fehlschlagen.
- Verwenden Sie die Öffnen-Aktion, um den Speicherort der .dll-Datei, die Sie verwenden möchten, und den Sitzungsnamen anzugeben. Verwenden Sie denselben Sitzungsnamen für die anderen Aktionen. Die
.dll, auf die verwiesen wird, wird automatisch als eine Bot-Abhängigkeit hinzugefügt. - Verwenden Sie die Funktion ausführen-Aktion, um eine Funktion aus der .dll auszuführen und ihren Ausgabewert als Variable zu speichern.
- Nachdem Sie die erforderlichen Funktionen ausgeführt haben, schließen Sie die .dll-Referenz. Es ist wichtig, die .dll-Referenz zu schließen, um den Arbeitsspeicher des Betriebssystems freizugeben.
Windows und die entsprechenden Versionen von Microsoft .NET Framework sind auf den Geräten verfügbar, auf denen die DLLs ausgeführt werden.
Navigieren Sie zu C:\ProgramData\AutomationAnywhere\BotRunner\Logs\<aktueller Monat>\Bot_Launcher-<heutiges Datum>.log.zip, um die Bot-Startprotokolle zu überprüfen. Jeder komprimierte Ordner enthält eine Datei mit Daten zur Codeausführung, die für die Fehlersuche nützlich sind.
Wenn Sie mehrere DLLs importieren, die eine Haupt-DLL haben und von der andere DLLs referenziert werden, stellen Sie sicher, dass sich alle DLLs in einem Ordner befinden. Außerdem müssen die referenzierten DLLs mit einem Sitzungsnamen aufgerufen werden, der sich von dem in der Haupt-DLL verwendeten Namen unterscheidet. Ihre Bot-Ausführung wird fehlschlagen, wenn derselbe Sitzungsname sowohl in der Haupt- als auch in der referenzierten DLL verwendet wird.
Aktionen Im DLL-Paket
Das DLL-Paket umfasst folgende Aktionen:
| Aktion | Beschreibung |
|---|---|
| Schließen |
Einzelheiten finden Sie unter Aktion „Schließen“. |
| Öffnen |
Einzelheiten finden Sie unter Aktion „Öffnen“. |
| Funktion ausführen | Einzelheiten finden Sie unter Verwenden der Aktion „Funktion ausführen“. |
Unterstützte Datentypen in DLL-Funktionen
| Variablentyp als Eingabe- oder Ausgabeparameter | Unterstützte Datentypen in .NET |
|---|---|
| Zeichenfolge |
|
| Nummer |
|
| Boolescher Wert |
|
| Datum/Zeit |
|
| Liste |
Anmerkung: Der C# IList-Datentyp wird nicht unterstützt und funktioniert nicht mit dem List-Datentyp von Automation 360.
|
| Tabelle |
Anmerkung: Die Variable vom Typ Tabellenvariable entspricht einer zweidimensionalen Variable vom Typ Array in .NET.
|
| Wörterbuch |
Anmerkung: Verwenden Sie bei der Erstellung der .Net DLL-Funktion den Datentyp IDictionary anstelle des Datentyps Dictionary.
|