Plugins #

Plugins erweitern EULANDA um zusätzliche Funktionen, indem sie sich über die SQL-Registry registrieren. Ein Plugin legt typischerweise eigene Actions in den betroffenen Datenobjekten an und kann eigene Konfigurationsdaten unter \VENDOR\ speichern.

Funktionsweise #

Ein Plugin registriert sich, indem es:

Actions in den relevanten Datenobjekten anlegt (z.B. Export-Menüpunkte in Rechnungen)
Konfiguration unter \VENDOR\{anbieter}\ oder \MODULES\{modul}\ speichert
Skripte oder externe Programme bereitstellt, die über die Actions aufgerufen werden

Die Registrierung erfolgt über die SQL-Registry-Prozeduren (cn_RegCreateKey, cn_RegOpenPath, cn_RegWriteString etc.) oder durch Import einer CNREG-Datei.

Beispiel: Xfacture (Elektronische Rechnungen) #

Xfacture ist ein Plugin für elektronische Rechnungsformate (XRechnung, ZUGFeRD, Peppol). Es registriert sich wie folgt in der SQL-Registry:

Action-Registrierung #

[\OBJECTS\DATAOBJECTS\Eulanda.Rechnung\Actions\Xfacture.Export]
  Type = Powershell.beta
  Title = E-Rechnung erstellen
  ActionClass = ExtraData
  Context = 1
  CommandText = (PowerShell-Skript für den Export)
  Environment = import CURRENT

Dadurch erscheint im Rechnungsmodul unter “Extras” > “Daten” der Menüpunkt “E-Rechnung erstellen”. Beim Aufruf wird die aktuelle Rechnung in das gewählte elektronische Format exportiert.

Konfiguration #

[\VENDOR\Xfacture\]
  Version = 2.0
  DefaultFormat = XRechnung

[\VENDOR\Xfacture\Formats\]
  ├── XRechnung\
  │   ├── Schema = urn:cen.eu:en16931:2017#compliant#...
  │   └── ...
  ├── ZUGFeRD\
  │   └── ...
  └── Peppol\
      └── ...

Eigene Plugins entwickeln #

Schritt 1: Action anlegen #

Legen Sie eine Action im gewünschten Datenobjekt an. Verwenden Sie den Präfix user. oder Ihren Firmennamen:

CnRegEdit1

[\USER\.ALLUSER\OBJECTS\DATAOBJECTS\Eulanda.Rechnung\Actions\user.MeinPlugin.Export]
"Type"="ActiveScript"
"Title"="Mein Export"
"ActionClass"="ExtraData"
"Context"=dword:00000001
"Script"="Option Explicit
' ... Skriptcode ...
"

Schritt 2: Konfiguration unter VENDOR #

CnRegEdit1

[\VENDOR\MeineFirma\MeinPlugin]
"Version"="1.0"
"Lizenz"=""

Schritt 3: Installation #

Die CNREG-Datei kann auf zwei Wegen importiert werden:

Manuell: In der SQL-Registry auf ROOT rechte Maustaste > “Einfügen”
Per SQL: Über die Registry-Prozeduren programmatisch anlegen

Schritt 4: Neustart #

Nach dem Import der Registry-Einträge muss EULANDA neu gestartet werden, damit die neuen Menübefehle geladen werden.

Unterstützte Aktionstypen für Plugins #

Type	Empfehlung	Beschreibung
`ActiveScript`	Für einfache Skripte	VBScript/JScript innerhalb der iScript-Engine
`Powershell.beta`	Für komplexe Logik	PowerShell mit Datenbankzugriff und Umgebungsvariablen
`ShellCall.beta`	Für externe Tools	Kommandozeilen-Programme aufrufen
`StoredProc`	Für Datenbankoperationen	SQL-Prozeduren direkt ausführen

Details zu den einzelnen Aktionstypen: Actions

EulandaXtools als Plugin-Plattform #

EulandaXtools stellt als PowerShell-Modul eine umfangreiche Infrastruktur für Plugins bereit:

84 XSD-Schemas für Validierung
XSLT-Transformationen für Formatkonvertierung
EN16931, XRechnung, ZUGFeRD, Peppol als fertige Exportformate
Queue-basierte Verarbeitung für EDI-Nachrichten

Plugins können EulandaXtools-Cmdlets in ihren PowerShell-Actions aufrufen, um auf diese Funktionen zuzugreifen.

Siehe auch #

Actions – Alle Aktionstypen und Eigenschaften
PowershellCall und ShellCall – Neue Aktionstypen ab 2025.10
VENDOR – Konfigurationsbereich für Drittanbieter
EulandaXtools – PowerShell-Modul mit XSD, EN16931, Peppol