Heute besprechen wir ausführlich den Export vom Dashboard und ihren Elementen aus dem Code, und erzählen über verfügbare Exportformate.

Verfügbare Exportformate

In unseren Softwares sind zahlreiche Exportformate für die Anwendungen, die auf verschiedene Plattformen geschrieben sind, verfügbar. Zum Beispiel, für JavaScript- und PHP-Anwendungen ist Export vom Dashboard und ihren Elementen in HTML, MS Excel und PDF verfügbar. Für andere Plattformen ist auch Export in verschiedene Bildformate wie PNG, JPEG, SVG, BMP und andere verfügbar. Außerdem, in allen Softwares gibt es die Möglichkeit, das Dashboard in Datendateien: JSON, XML, CSV u.a. zu exportieren.

Export vom Dashboard in den WIN/WPF-Anwendungen

Für Export vom erstellten Dashboard aus Windows-Applikation muss man folgenden Code verwenden:

private void Button1_Click(object sender, EventArgs e)
{
	var report = StiReport.CreateNewDashboard();
	report.Load("Reports\\Vehicle_Production.mrt");

	report.ExportDocument(StiExportFormat.Pdf, "Vehicle_Production.pdf");
}

In diesem Beispiel wird der Export in PDF-Format verwirklicht und in angegebene Datei gespeichert. Die Methode ExportDocument exportiert das ganze Dashboard ins angegebene Format, und das Ergebnis kann eine Datei, einen Strom oder ein Byte-Array sein.

Um die Einstellungen des Exportes zu ändern, muss man die Klasse der Einstellungen als Argumente angegebener Methode weitergeben:

private void Button1_Click(object sender, EventArgs e)
{
	var report = StiReport.CreateNewDashboard();
	report.Load("Reports\\Vehicle_Production.mrt");

	var settings = new StiPdfDashboardExportSettings();
	report.ExportDocument(StiExportFormat.Pdf, "Vehicle_Production.pdf", settings);
}

Export vom Dashboard in den Web-Anwendungen

Für Export vom Dashboard aus dem Code in Web-Anwendung kann man dieselbe Methode, die oben für Windows-Anwendung angegeben ist, verwenden. Aber in diesem Fall wird das exportierte Dashboard auf der Server-Seite gespeichert werden.

Wenn es erforderlich ist, das exportierte Dashboard auf die Seite des Client-Computers mit Hilfe vom Web-Browser zu laden, kann man den folgenden Code verwenden (das Beispiel für ASP.NET-Anwendung):

protected void ButtonExport_Click(object sender, EventArgs e)
{
	var report = StiReport.CreateNewDashboard();
	var path = Server.MapPath("Reports/Vehicle_Production.mrt");
	report.Load(path);

	StiReportResponse.ResponseAsPdf(report);
}

Die Klasse StiReportResponse enthält alle erforderlichen Methoden für den Export vom Dashboard in verschiedene Formate. Als Argumente können die Export-Einstellungen weitergegeben werden.

Für Web-Anwendungen, die mit der Verwendung von ASP.NET MVC erstellt sind, wird die Klasse StiMvcReportResponse; für .NET Core-based-Web-Apps – die Klasse StiNetCoreReportResponse verwendet. Diese Klassen enthalten dieselben Methoden.

Export vom Element des Dashboards

Manchmal muss man nur ein Teil, ein separates Element des Dashboards exportieren. Hier ist das Beispiel des Codes für Export der Tabelle des Dashboards:

private void Button1_Click(object sender, EventArgs e)
{
	var report = StiReport.CreateNewDashboard();
	report.Load("Reports\\Vehicle_Production.mrt");

	var element = report.GetComponentByName("TableList") as IStiElement;
	var settings = new StiPdfDashboardExportSettings();
	//var stream = StiDashboardExportTools.ExportToStream(element, settings);
	StiDashboardExportTools.ExportToFile(element, "d:\TableList.pdf", settings);
}

In diesem Beispiel wird ein Element nach seinem Namen ausgewählt und ins PDF-Format exportiert. In diesem Fall hängt das Export-Format von in die Methode weitergeleiteten Einstellungen des Exports vom Dashboard-Element ab. Die Klasse StiDashboardExportTools enthält zusätzlich die Methoden für Export in Strom oder Byte-Array. Bemerken Sie!

Beim Export vom separaten Dashboard-Element, das viele Zeilen mit Information enthält, zum Beispiel, Liste oder Tabelle, werden alle Zeilen dieses Elementes völlig auf erforderliche Anzahl von Seiten erweitert. Beim Export vom ganzen Dashboard werden so viele Zielen, wie viele kann die Dashboard-Vorlage, die sich auf einer Seite angegebener Größe befindet, anzeigen.