Die Stimulsoft-Softwares erlauben sowohl die Miniaturansichten automatisch zu generieren, als auch dieses Verfahren durch eine spezielle Klasse StiThumbnailHelper zu steuern. Auch kann man die Benutzer-Bilder anstatt der automatisch generierten Miniaturansicht verwenden.

Automatische Generation der Miniaturansichten

Die Miniaturansichten werden automatisch beim Hinzufügen vom Bericht in erstellt:

• Stimulsoft Server und Stimulsoft Cloud – beim ersten Hinzufügen in den Arbeitsbereich.


• Stimulsoft Demo – beim ersten Hinzufügen zur Ressourcen-Liste.

Der Benutzer braucht keine zusätzlichen Aktionen erfüllen. In diesem Fall wird die Miniaturansicht generiert und gespeichert. Diese Miniaturansicht wird bis sein Entfernen oder bis Entfernen vom Bericht verwendet. Der wichtigste Nachteil besteht darin, dass die Miniaturansicht bei der Veränderung des Berichtes nicht aktualisiert wird. Sie können die Miniaturansicht nur manuell neu erstellen, und dafür muss man die alte Datei der Miniaturansicht löschen.

Steuern von Miniaturansichten mit StiThumbnailHelper

Bei der Integration von Stimulsoft in Benutzer-Projekt oder Anwendung kann man die Klasse StiThumbnailHelper verwenden. Mit dieser Klasse kann man den Prozess des Erstellens von Miniaturansichten steuern.

• GetThumbnailPath(string path) generiert den Pfad zur Miniaturansicht-Datei .thumb für den angegebenen Bericht. Man muss dabei die Anzeigeskalierung im Betriebssystem beachten.


• SaveThumbnail(StiReport report, string path) gibt das Bytearray eines Bildes zurück, d.h. die Miniaturansicht der ersten erstellten Berichtsseite in .thumb-Datei. Sie können diese Methode nur für den erstellten Bericht verwenden oder die Methode des Erstellens vom Bericht report.Render() aufrufen.


• GetThumbnail(string path) gibt das Bytearray angegebener Miniaturansicht der Berichtes aus der .thumb-Datei zurück. Wenn die Datei nicht existiert, wird null zurückgegeben.


• GetThumbnailFromTemplateAsync(string path) ruft asynchron die Miniaturansicht des Berichtes aus der .mrt-Datei ab.


• GetThumbnailFromTemplate(string path, bool skipImage = false) erstellt synchron das Objekt StiThumbnailReport das enthält: Pfad, Berichtsname, Dashboard-Flagge (`IsDbs`), Bild. Diese Methode lädt die Miniaturansicht, wenn sie schon früher gespeichert wurde. Aber wenn die Miniaturansicht nicht gespeichert wurde, lädt die Methode den Bericht, generiert das Bild und speichert .thumb. Auch beachtet die Methode das, ist es das Dashboard oder der Bericht.

So kann man jederzeit die Miniaturansichten des Berichtes generieren.

Die Verwendung von der Eigenschaft Report Image

Jede Vorlage des Berichtes, Dashboards oder PDF-Formulars kann sein eigenes Bild in der Eigenschaft Berichtsbild (Report Image) enthalten. Dieses Bild wird als Miniaturansicht statt automatisch generierter Vorschau verwendet. Dies gilt für solche Produkte wie Stimulsoft Demo, Stimulsoft Server, Stimulsoft Cloud. So kann man ein fixiertes Bild, das in der Schnittstelle unabhängig des Berichtsinhaltes angezeigt wird, festlegen. ACHTUNG!

Das Bild wird innerhalb der Berichtsdatei gespeichert. Wenn Sie eine große Datei hinzufügen/angeben, wächst wesentlich die Größe der Berichtsdatei. Wir haben oben geschrieben, dass man die Miniaturansicht nur nach dem Löschen von vorheriger Miniatur neu erstellen. Wenn Sie Stimulsoft in eigene Anwendung integrieren, kann man die Miniaturansicht generieren und sie in die Eigenschaft ReportImage zuweisen:

...
//Load report
var report = new StiReport;
var templatePath = "Reports\\MyReport.mrt";
report.Load(templatePath);

// Generate a new thumbnail from the report template
var thumbnail = await Stimulsoft.Wizard.Wpf.Info.Helper.StiThumbnailHelper.GetThumbnailFromTemplateAsync(templatePath);

// Convert byte array to System.Drawing.Image
using (var ms = new MemoryStream(thumbnail.Image))
{
// Assign generated thumbnail to the ReportImage property
report.ReportImage = System.Drawing.Image.FromStream(ms);
}

// Call report in designer where ReportImage will be used as the report thumbnail
report.Design();
...

Das bedeutet, dass die neue Miniaturansicht sofort generiert und in der Eigenschaft Berichtsbild gespeichert wird. So kann man die Miniatur aktualisieren, ohne existierte Berichtsdatei oder vorherige Miniaturansicht zu löschen.

Ein wichtiger Punkt - Animation

Es gibt ein Punkt beim Erstellen von Miniaturansichten – die Animation, was besonders zu den Dashboards gehört. Die Sache ist, dass die erste gerenderte Seite für den Bericht generiert wird, und sie zur Miniaturansicht dient. Allerdings, die Dashboards haben keine Zustände wie „gerendert“ oder „nicht gerendert“, weil das Dashboard in der Echtzeit funktioniert. Darum, wenn die Animation der Elemente nicht bis zum Ende erfüllt wird, spiegelt die Miniaturansicht den Inhalt nicht genau wider. Zum Beispiel, ein Diagramm kann nur teilweise gerendert werden. Wenn man eine exakte Übereinstimmung braucht, muss man die Zeit der Erfüllens von der Animation beachten.

Die Verwendung von Miniaturansichten in Stimulsoft-Softwares ist eine einfache und effiziente Weise für visuelle Darstellung von Berichten, Dashboards und Formularen. Sie können die Miniaturansichten sowohl manuell oder automatisch erstellen, als auch Ihre eigenen Bilder statt der standardmäßigen Miniaturansichten verwenden. Dank der Klasse StiThumbnailHelper bekommt der Entwickler ein flexibles Tool für Steuern von Miniaturansichten in jedem Integrationsszenarium. Richtige Verwendung dieser Fähigkeit verbessert die Navigation, Benutzeroberfläche und gesamte Erfahrung der Arbeit mit den Berichten in den Anwendungen und Dienstleistungen.