Allgemein

syslog.ERP lässt sich in vielen Bereichen mithilfe der Skriptsprache Lua anpassen und um eigene Funktionalität erweitern.

Beispiele:

• Skriptaufrufe an bestimmten Buttons in Dialogen
• Benutzerdefinierte Menüeinträge an allen Dialogen
• Skriptaufrufe im Tagesabschluss
• Regeln im EXPOS-Modul
• Ereignisse im Ticketsystem

Eine Liste an Lua-Funktionen, die im syslog.ERP zur Verfügung stehen befindet sich hier:

• Lua-Funktionen Übersicht
• Lua-Variablen 

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:

• VS Code
• Notepad++

Momentan findet für das syslog.ERP keine Kompilierung von Lua-Skripten nach Bytecode statt - die Skripte bleiben also im Klartext.

Für die Konfiguration von VS Code für Lua mit integrierter Dokumentation der Syslog-Funktionen, siehe folgende Anleitung:

• Konfiguration von VS Code für Lua (Linting, Funktionshilfe)

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:

• Lua 5.4.4 (32-bit für syslog.ERP 5.03): https://storage.syslog-pps.de/index.php/s/aenHm3e6MFz2BiZ
• Lua 5.4.4 (64-bit für syslog.ERP 5.04): https://storage.syslog-pps.de/index.php/s/7TyCfQiHWeLN5gn

Die jeweiligen Dateien müssen im Stammverzeichnis des syslog.ERP 5 ("syslogrt") entpackt werden, sodass diese nahtlos in die Verzeichnisstruktur übergehen.
Nur wenn syslog.ERP in der 64-bit Variante installiert ist, werden auch die 64-bit Lua Binaries 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