Viele Projekte verwenden beim Erstellen von Berichten eigene Geschäftslogik, zum Beispiel zum Abrufen von Daten aus internen Diensten, zum Umwandeln von Werten oder zum Durchführen von Berechnungen. Ab Version 2026.3 können Sie in Stimulsoft-Produkten Methoden aus eigenen .NET-Assemblys als Berichtsfunktionen veröffentlichen, ohne jede Funktion manuell registrieren zu müssen. Markieren Sie einfach Ihre Klassen und Methoden mit einigen Attributen. Der Berichtdesigner erkennt diese Funktionen automatisch und fügt sie dem Berichtswörterbuch hinzu.
Funktionen veröffentlichen
Zum Veröffentlichen von Funktionen werden zwei Attribute aus dem Namespace Stimulsoft.Base.Functions verwendet:- StiClassFunctionsAttribute — kennzeichnet eine Klasse, die benutzerdefinierte Berichtsfunktionen enthält.
- StiFunctionAttribute — veröffentlicht eine Methode und ordnet sie einer Kategorie im Berichtswörterbuch zu.
Die Dokumentation der Funktionen erfolgt über das standardmäßige Attribut System.ComponentModel.DescriptionAttribute. Damit können Sie die Funktion selbst, ihre Parameter und den Rückgabewert beschreiben. Diese Informationen werden automatisch im Berichtdesigner angezeigt.
using Stimulsoft.Base.Functions;
using System.ComponentModel;
[StiClassFunctions]
public static class EastwindFunctions
{
[StiFunction(Category = "Eastwind")]
[Description("Returns the display name of a customer by its identifier.")]
[return: Description("The customer display name.")]
public static string GetCustomerName(
[Description("Customer identifier")] int customerId)
{
return "result";
}
}Anzeige im Berichtdesigner
Nachdem die Assembly verbunden wurde, erkennt der Designer automatisch alle veröffentlichten Funktionen und fügt sie dem Berichtswörterbuch hinzu. Für jede Funktion werden angezeigt:- Kategorie;
- Methodensignatur;
- Beschreibung;
- Parameterbeschreibungen;
- Beschreibung des Rückgabewerts.
Dadurch lassen sich benutzerdefinierte Funktionen genauso einfach verwenden wie integrierte Funktionen — ohne zusätzliche Registrierung oder Konfiguration.
Assembly verbinden
Damit benutzerdefinierte Funktionen sowohl im Interpretationsmodus als auch im Kompilierungsmodus verfügbar sind, müssen sich die Assembly und alle ihre Abhängigkeiten im Anwendungsverzeichnis neben Designer.exe befinden.Öffnen Sie anschließend Optionen → Funktionen, klicken Sie auf Hinzufügen und wählen Sie Ihre Assembly aus.
Nach dem Verbinden wird die Assembly bei jedem Start des Designers automatisch geladen, und alle veröffentlichten Funktionen stehen in jedem Bericht zur Verfügung.