Allgemein
syslog.ERP lässt sich in vielen Bereichen mithilfe der Skriptsprache Lua anpassen und um eigene Funktionalität erweitern.
Beispiele:
Eine Liste an Lua-Funktionen, die im syslog.ERP zur Verfügung stehen befindet sich hier:
Eingebunden werden Lua-Skripte an den oben erwähnten Stellen oder durch fixe Dateinamen, die das syslog.ERP aufruft.
Lua-Skripte schreiben
Zum Schreiben oder Bearbeiten von Lua-Skripten empfiehlt sich ein Quelltext-Editor (optional mit Plugins für Linting und co.).
Beispiele hierfür sind:
Momentan findet für das syslog.ERP keine Kompilierung von Lua-Skripten nach Bytecode statt - die Skripte bleiben also im Klartext.
In VS Code gibt es jetzt die Möglichkeit Linting und co. für die Lua-Funktionen die im syslog.ERP zur Verfügung stehen zu haben, siehe hier.
Zusätzliche Bibliotheken
Um die volle Funktionalität zu erhalten, die für manche Skripte oder Schnittstellen benötigt wird, sollten zusätzliche Lua-Bibliotheken installiert werden.
Liste an Zusatzbibliotheken
- LuaSQL
- Ermöglicht Verbindung mit externen Datenbanken (z.B. MySQL, SQLite3 oder SQL-Server allgemein über ODBC)
- LuaSec mit LuaSocket
- Beinhaltet LuaSocket mit Anbindung an OpenSSL
- Ermöglicht die Kommunikation über http(s), FTP, TCP und UDP.
- Beispiel: Kommunikation über (REST) APIs oder Dateitransfer auf FTP-Server
- LuaXML
- Ermöglicht das Lesen und Schreiben von XML-Dateien.
- LuaCOM
- Im Programmumfang automatisch vorinstalliert
- Ermöglicht die Kommunikation über das Component Object Model (COM) von Microsoft
- Beispiel: Auf lokalem Rechner installierte Programme wie Word, Excel und Outlook ansprechen
- ZipWriter
- Ermöglicht das Schreiben von ZIP-Archiven
- xlsxwriter
- Ermöglicht das Schreiben von Excel-Mappen inkl. Formatierungen und Formeln
Siehe Installation zum Download der Zusatzmodule inkl. Installationsanleitung.
Installation
Falls Lua noch nicht in der syslog.ERP Installation vorhanden ist, kann dies (inkl. Zusatzbibliotheken) von folgenden Links heruntergeladen werden:
Die jeweiligen Dateien müssen im Stammverzeichnis des syslog.ERP 5 ("syslogrt") entpackt werden, sodass diese nahtlos in die Verzeichnisstruktur übergehen.
Für das syslog.ERP 5 und 6 wird momentan der 32-bit Download benötigt.
Weitere Informationen inkl. Installationsanleitung lassen sich der README-Datei im jeweiligen Ordner entnehmen.
Wichtig:
Für diverse Dienste (z.B. fromDatafox.exe und Druckdienste) muss sichergestellt werden, dass "%PRIMUSDIR%\stam1.0\bin" korrekt im Pfad (Umgebungsvariable) der Maschine gepflegt ist.
Ist dies nicht der Fall, dann kann syslog.ERP die Lua DLL nicht finden.
Zusatzbibliotheken im syslog.ERP 6
Die Zusatzbibliotheken für das syslog.ERP 6 müssen in einer anderen Ordnerstruktur installiert werden, als beim syslog.ERP 5.
Die Struktur ist bereits im Download richtig vorgegeben.
Versionen
Lua 5.1- syslog.ERP 5.01.035 bis 5.01.429
- syslog.ERP 5.02.001 bis 5.02.102
Lua 5.3- syslog.ERP 5.02.103 bis 5.02.144
- syslog.ERP 5.03.001 bis 5.03.021
- Lua 5.4
- syslog.ERP 5.03.022 bis aktuell
- syslog.ERP 6.00.001 bis aktuell