Einführung

Das Erstellen von Berichten und Dashboards ist nicht nur die Datenvisualisierung, sondern auch die Verarbeitung und Analyse komplizierter Ausdrücke mit der Verwendung von Datenspalten und Funktionen. Zum Beispiel, die Ausdrücke erscheinen an verschiedenen Stellen des Dokumentes und, wenn Sie einige Änderungen vornehmen möchten, muss man diese Ausdrücke an verschiedenen Stellen bearbeiten. Es erhöht das Fehlerrisiko und die Zeit der Arbeit mit dem Dokument.

Die benutzerdefinierten Funktionen helfen das Fehlerrisiko durch das Bewegen vom Ausdruck in ein separates wiederverwendbares Modul zu reduzieren. Es erlaubt die Funktion aufzurufen, anstatt die komplizierten Ausdrücke zu kopieren.

Wie es funktioniert?

Die Funktionen werden im Datenwörterbuch erstellt. Sie können die Funktionen einstellen: die Beschreibung und Kategorie hinzufügen, Rückgabewerte und Argumente angeben. Die Funktionen können entweder mit dem visuellen Programmiertool Blockly oder mit einem solcher Programmiersprachen wie JS, C#, VB.NET:

• Blockly – visuelles Programmiertool, das keinen Code zu schreiben fordert.


• Skript-Sprachen – die Programmiersprachen wie JS, C#, VB.NET, die im Bericht verwendet werden.

Die Vorteile der benutzerdefinierten Funktionen

1. Bequemes Erstellen von Skripts ohne Code

• Die visuelle Blockly-Schnittstelle erlaubt die Skripts ohne Code zu erstellen.


• Die Vielseitigkeit der Blockly-Skripts gewährleistet die Kompatibilität der Funktionen mit jeder Stimulsoft-Plattform.

2. Wiederverwendbarkeit

• Die Funktion, die einmal erstellt wurde, kann an verschiedenen Stellen des Berichtes verwendet werden, was die Zeit spart und das Fehlerrisiko reduziert.

3. Einfache Änderung vom Ausdruck

• Jede Änderung wird nur in die Funktion-Beschreibung vorgenommen, was automatisch die Berechnungsergebnisse an allen Orten des Funktion-Aufrufs erneuert.

Beim Erstellen von benutzerdefinierten Funktionen muss man einige Besonderheiten beachten:

• Berechnungsmodus: In .NET und .NET Framework ist das Erfüllen von der Funktion nur im Kompilation-Modus verfügbar. Mehr darüber können Sie hier lesen. Für .NET und .NET Framework kann man die Skriptsprache C# oder VB.NET, auf der die Funktion-Beschreibung erfüllt wird, auswählen. Für andere Plattformen – JS, PHP, PYTHON – ist der Zugang zu den Ereignissen, die die Beschreibung der Funktion erfüllen, wichtig.


• Zugriffseinstellungen: sichern Sie, dass die Einstellungen zur Kompilation oder Interpretation aktiviert sind, andernfalls werden die Funktionen nicht funktionieren.


• Die Auswahl der Skriptsprache: die Funktionen funktionieren auf der Sprache, die in den Berichtseigenschaften (zum Beispiel, JS, C#, VB.NET) angegeben wird.

Die Einstellung der Funktion

Die Funktionen werden im Editor eingestellt, und unten erforschen wir seine Optionen. Zuerst muss man den Editor öffnen – dafür wählen Sie im Menü Neu (New) den Befehl Neue Funktion (New Function) und die Parameter definieren.

• Name: Alle Aufrufe zu den Funktionen werden nach ihren Namen, die man in diesem Feld angeben kann, verwirklicht.


• Beschreibung (Description): erlaubt zusätzliche Information über die Funktion, die auf der Beschreibung-Leiste im Datenwörterbuchangezeigt wird, hinzuzufügen.


• Kategorie: ermöglicht festzulegen, in welche Kategorie des Datenwörterbuches die Funktion hinzugefügt wird. Sie können eine der vordefinierten Kategorien auswählen oder den Wert Benutzerdefiniert (Custom) stellen. Beim Auswählen vom Benutzerdefinier-Parameter erscheint ein Feld für Erstellen von benutzerdefinierter Kategorie.


• Benutzerdefinierte Kategorie (Custom Category): Wenn der Paramater Benutzerdefiniert (Custom) ausgewählt ist, können Sie den Namen neuer Kategorie angeben. Wenn das Feld leer bleibt, wird die Funktion in die Oberkategorie Funktionen platziert.


• Rückgabetyp (Return Type): gibt den Datentypen, die die Funktion zurückgibt, an.


• Hinzufügen der Argumente: mit der Schaltfläche Hinzufügen (Add) kann man bis 10 Argumente hinzufügen:
  
  
  1. Argument-Typ: legt den Datentypen des Argumentes fest.
  
  
  2. Argument-Name: dieser Name wird für Aufruf im Code verwendet.


• Skript-Modus: bietet die Auswahl zwischen zwei Implementation-Optionen:
  
  
  1. Blocks: Die Verwendung vom visuellen Blockly-Konstruktor, der für alle Plattformen Stimulsoft universell ist.
  
  
  2. Code: Das Schreiben der Funktion mit der Verwendung vom Code einer der Skriptsprachen des Berichtes (JS, C#, VB.NET).

Abschluss

Die benutzerdefinierten Funktionen ist die Option, die die Wiederverwendung von komplizierten Ausdrücken zu vereinfachen, die Zeit für Entwickeln zu reduzieren und das Fehlerrisiko zu minimieren hilft. Das Erstellen von Szenarien der Funktion mithilfe von Blockly macht das Prozess einfacher, und auch versichert die Möglichkeit der Integration auf allen Stimulsoft-Plattformen. Wir empfehlen die benutzerdefinierten Funktionen zu verwenden, um das Erstellen von Berichten und Dashboards zu beschleunigen, Rechengenauigkeit zu erhöhen, und die Dokumente einfacher für die Veränderung zu machen.