¶ Beschreibung
Der Maskito FormServer bietet jetzt die Möglichkeit, eigene PlugIns für den Maskito FormServer zu schreiben. Somit lassen sich einfach neue Serverfunktionen hinzufügen und direkt im FormServer verwalten. Ebenso können diese Funktionen leicht in Formulare integriert werden. Dadurch kann die Funktionsvielfalt der Formulare beliebig erweitert werden.
Mit dem Maskito Standard-PlugIn kommen automatisch schon neue Funktionen mit dazu. Dazu zählt z.B. ein BarCode-/QR-Code-Generator sowie AI-Funktionen, um Formulare auch mit KI-Unterstützung bereitzustellen.
¶ Eigene Server-PlugIn-Funktion schreiben
Verwenden Sie dazu das Maskito Interface, um eigene Funktionen für den Server und das Formular bereitzustellen.
¶ PlugIn-Produktion vorbereiten
PlugIns können in C# oder VB.net mit .NET Framework entwickelt werden. Eine .NET Core Variante ist in Planung.
Sie benötigen das Maskito Interface, welches die Erstellung von Server-/Formularfunktionen ermöglicht. Das Interface befindet sich im Maskito-Downloadordner.
¶ Das Maskito Interface verwenden
Laden Sie sich das Maskito Interface von unserem Download-Center herunter und integrieren dies als Verweis in Ihr Projekt.
¶ Attribute definieren
[Maskito.PlugIn.Attributes.ServerFunction("SystemPlugIn", "Systemfunktionen des FormServers")]
Mit diesem Attribut wird die Klasse als ServerPlugIn gekennzeichnet. Beschreiben Sie an der Stelle die Funktion der Klasse, um den Anwender des FormDesigners Informationen über die Funktion anzuzeigen.
[Maskito.PlugIn.Attributes.FormFunction("EMail-Versand über FormServer")]
Dieses Attribut kennzeichnet eine Methode als Formularfunktion. Nur Methoden mit diesem Attribut werden später im FormDesigner angezeigt.
[Maskito.PlugIn.Attributes.OnlyAuthUser()]
Mit diesem Attribut wird eine Methode gekennzeichnet, welche nur von angemeldeten Nutzern aufgerufen werden darf.
Achtung: Bereitgestellte Serverfunktionen sind immer mit Vorsicht zu betrachten. Es ist theoretisch möglich, diese Funktionen seitens der Clients zu missbrauchen. (CodeInjection) Stellen Sie daher keine Methoden bereit, welche sicherheitsrelevante Informationen besitzen oder auf dem Server Funktionen ausführen, welche von "bösen" Anwendern Schaden anrichten könnten.
¶ Projekt und Code erstellen
- In Visual Studio neuen
Class Library (.NET Framework)Projekt erstellen - Maskito Interface per Add/Reference zum Projekt integrieren
- Projekt Bauen und die Dateien aus dem
< Projekt > / bin / Releasekopieren - Auf Server unter
.. / Custom / Serverplugins / [OrdnerName]die Dateien hinzufügen
¶ Verwendbare Parameter im PlugIn
Folgende Parametertypen können für die Erstellung eigener Methoden verwendet werden:
- void
- string
- string[]
- bool
- bool[]
- long
- long[]
- int
- int[]
- decimal
- decimal[]
- double
- double[]
- byte
- byte[]
- Dictionary<string, string>
¶ Beispiel
namespace
{
[ServerFunctionAttribute("SystemPlugIn", "Test Systemfunktionen des FormServers")]
public class Sys : Maskito.PlugIn.MaskitoPlugIn
{
private Maskito.PlugIn.ILogger _logger { get; set; }
private Maskito.PlugIn.IFormServer _server { get; set; }
/// <summary>
/// Initialisierung des PlugIns
/// </summary>
/// <param name="logger"></param>
/// <param name="formserver"></param>
public override void Init(Maskito.PlugIn.ILogger logger, Maskito.PlugIn.IFormServer formserver)
{
this._logger = logger;
this._server = formserver;
}
/// <summary>
/// E-Mail versenden
/// </summary>
/// <param name="xml"></param>
[Maskito.PlugIn.Attributes.OnlyAuthUser()]
[Maskito.PlugIn.Attributes.FormFunction("Test EMail-Versand über FormServer")]
public bool SendEMail(string to, string subject, string body)
{
return _server.System.SendEMail(to, subject, body);
}
}
}
¶ PlugIns im FormServer verwalten
Der Serveradministrator kann im linken Menü des Servermanagers unter PlugIns die neue Erweiterung sehen.
¶ PlugIn-Funktionen im FormDesigner nutzen
- Neue Funktion für beliebige Elemente im FormDesigner erstellen
- Gewünschtes Plugin und dessen Funktion aus der Liste auswählen und übernehmen
Die ausgewählte Funktion kann nun wie jede andere Funktion verwendet werden.