Actions (Menübefehle) #
\ROOT\OBJECTS\DATAOBJECTS\{objektname}\Actions\{actionname}
Actions definieren Menübefehle innerhalb eines EULANDA-Moduls. Über Actions können externe Programme, Skripte, SQL-Prozeduren oder Exporte direkt aus dem Menü eines Datenobjekts heraus aufgerufen werden.
Aktionstypen #
| Type | Beschreibung |
|---|---|
ActiveScript | VBScript oder JScript über die iScript-Engine ausführen |
Powershell.beta | PowerShell-Skript ausführen (ab 2025.10) |
ShellCall.beta | Externes Programm über die Kommandozeile starten (ab 2025.10) |
ShellExecute | Externes Programm oder Datei über Windows ShellExecute öffnen |
StoredProc | SQL-Stored-Procedure ausführen |
CSVExport | Daten als CSV-Datei exportieren |
Allgemeine Eigenschaften #
Jede Action besitzt folgende Grundeigenschaften:
| Eigenschaft | Typ | Beschreibung |
|---|---|---|
Type | String | Aktionstyp (siehe Tabelle oben) |
Title | String | Anzeigename im Menü |
ActionClass | String | Untermenü-Kategorie (z.B. ExtraData, Print) |
Hint | String | Hinweistext (Tooltip), maximal eine Zeile |
ShortCut | String | Tastenkombination (z.B. CTRL+P) |
IconUrl | String | Icon für den Menüeintrag |
Context | Int | 0 = allgemein, 1 = aktueller Datensatz |
SafeForBatchProcessing | Bool | Aktion ist für Stapelverarbeitung geeignet |
Namenskonvention #
Eigene Actions müssen mit dem Präfix user. beginnen, damit sie bei Programmupdates nicht überschrieben werden:
user.MeineFirma.MeinBefehl
Eigene Actions sollten unter \USER\.ALLUSER\OBJECTS\DATAOBJECTS\ angelegt werden, nicht direkt unter \OBJECTS\DATAOBJECTS\. Details zur Vererbung: USER
ActiveScript #
Führt ein VBScript oder JScript über die in EULANDA integrierte iScript-Engine aus. Das Skript wird als Text in der Eigenschaft Script hinterlegt oder als Verweis auf eine Bibliothek unter \SYSTEM\LIBS\.
| Eigenschaft | Typ | Beschreibung |
|---|---|---|
Script | Text | Skript-Code oder Bibliotheksverweis |
Param | String | Optionale Parameter für das Skript |
Beispiel: Artikelexport per VBScript #
\ROOT\USER\.ALLUSER\OBJECTS\DATAOBJECTS\Eulanda.Artikel\Actions\user.ArtikelExport\
Type = ActiveScript
Title = Artikel exportieren
ActionClass = ExtraData
Context = 1
Script = (VBScript-Code oder libcall:userlib.MeinExport)
Im Skript steht das aktuelle Datenobjekt über die Client-Schnittstelle zur Verfügung. Details zur iScript-Programmierung: iScript
StoredProc #
Führt eine SQL-Stored-Procedure aus. Der aktuelle Datensatz kann über den Parameter @Id übergeben werden.
| Eigenschaft | Typ | Beschreibung |
|---|---|---|
StoredProc | String | Name der Stored Procedure |
Beispiel: Eigene Prozedur aufrufen #
\ROOT\USER\.ALLUSER\OBJECTS\DATAOBJECTS\Eulanda.Adresse\Actions\user.AdressCheck\
Type = StoredProc
Title = Adresse prüfen
ActionClass = ExtraData
Context = 1
StoredProc = cn_user_AdressCheck
ShellExecute #
Öffnet ein externes Programm, eine Datei oder eine URL über die Windows-ShellExecute-Funktion.
| Eigenschaft | Typ | Beschreibung |
|---|---|---|
FileName | String | Programm, Datei oder URL |
Parameters | String | Kommandozeilenparameter |
CSVExport #
Exportiert die aktuelle Datenliste als CSV-Datei.
| Eigenschaft | Typ | Beschreibung |
|---|---|---|
Fields | String | Kommagetrennte Liste der zu exportierenden Felder |
Separator | String | Feldtrenner (Standard: ;) |
Powershell und ShellCall (ab 2025.10) #
Die neueren Aktionstypen Powershell.beta und ShellCall.beta bieten erweiterte Möglichkeiten wie asynchrone Ausführung, Umgebungsvariablen und Datenbankzugriff. Diese werden auf einer eigenen Seite beschrieben: PowershellCall und ShellCall
ActionClass – Untermenüs #
Die ActionClass bestimmt, in welchem Untermenü die Action erscheint:
| ActionClass | Menüposition |
|---|---|
ExtraData | Menü “Extras” / “Daten” |
Print | Druckmenü |
ExtraTools | Menü “Extras” / “Werkzeuge” |
| (leer) | Hauptmenü des Moduls |
Beispiel: Kompletter Menübefehl als CNREG-Datei #
Diese Datei kann über die Zwischenablage in der SQL-Registry eingefügt werden (Rechte Maustaste auf ROOT, “Einfügen”):
CnRegEdit1
[\USER\.ALLUSER\OBJECTS\DATAOBJECTS\Eulanda.Rechnung\Actions\user.RechnungExport]
"Type"="ActiveScript"
"Title"="Rechnung als XML exportieren"
"ActionClass"="ExtraData"
"Hint"="Exportiert die aktuelle Rechnung als XML-Datei"
"Context"=dword:00000001
"Script"="Option Explicit
Dim xmlEul
Set xmlEul = Client.CreateObject(\"XMLLIB\")
xmlEul.LoadFromDB \"SALESORDER\"
xmlEul.SaveToFile Client.Properties(\"FOLDER.DESKTOP\") & \"\\RechnungExport.xml\"
Set xmlEul = Nothing
MsgBox \"Export abgeschlossen.\""
Nach dem Einfügen muss EULANDA neu gestartet werden, damit der neue Menübefehl angezeigt wird.
Siehe auch #
- PowershellCall und ShellCall – Neue Aktionstypen ab 2025.10
- Plugins – Wie Plugins eigene Actions registrieren
- USER – Vererbung und Überschreibung
- iScript – Skriptprogrammierung in EULANDA