آموزش متدهای دیگر Viewer Stimulsoft

آموزش متدهای دیگر Viewer Stimulsoft

متدهای دیگری در HTML5 Viewer تعریف شده اند که برای گرفتن object گزارش جاری، پارامترهای وضعیت جاری viewer و دیگر اطلاعات کاربردی استفده می شود. این متدها در هر action از viewer قابل استفاده است.

متد GetReportObject

شی report را که viewer با آن کار می کند برمی گرداند. می توان عملیات های ضروری چون register کردن dataset جدید، تغییر property های گزارش، مقداردهی به پارامترها و یا laod گزارش دیگر انجام داد. سپس report را می توان به viewer برگرداند و آن را به عنوان پارامتری در متد Action تعیین کرد.

HomeController.cs
...
public IActionResult ViewerInteraction()
{
StiReport report = StiNetCoreViewer.GetReportObject(this);
report.ReportName = "MyReportName";
 
return StiNetCoreViewer.InteractionResult(this, report);
}
...

آموزش متد GetRouteValues در Stimulsoft

مقادیر Url هایی که صفحه ی viewer با آن باز شده برمی گرداند. می توان مجموعه اولیه از پارامترهای اجرای صفحه را در هر action از viewer گرفت و از این مقادیر برای اعمال شروط و بررسی های لازم استفاده کرد.

HomeController.cs
...
public IActionResult ViewerInteraction()
{
RouteValueDictionary routeValues = StiNetCoreViewer.GetRouteValues(this);
 
return StiNetCoreViewer.InteractionResult(this);
}
...

همچنین می توانید مقادیر پارامترهای Url را براساس نام پارامتر بگیرید و آن را به عنوان پارامتر action فراخوانی شده از viewer تعیین کنید.

HomeController.cs
...
public IActionResult ViewerInteraction(string id)
{
return StiNetCoreViewer.InteractionResult(this);
}
...

آموزش متد GetFormValues در Stimulsoft

مقادیر فرمی که صفحه ای از viewer را باز کرده (توسط یک POST request) را برمی گرداند. می توان یک collection از پارامترهای فرم در هر Action از viewer گرفت.

HomeController.cs
...
public IActionResult ViewerInteraction()
{
NameValueCollection formValues = StiNetCoreViewer.GetFormValues(this);
 
return StiNetCoreViewer.InteractionResult(this);
}
...

به طور پیش فرض، این قابلیت به منظور بهینه سازی درخواست های سمت کلاینت به سرور غیرفعال شده است. برای فعال کردن آن مقدار PassFormValues property را به True مقداردهی کنید.

Index.cshtml
...
@Html.StiNetCoreViewer(new StiNetCoreViewerOptions() {
Server =
{
PassFormValues = true
}
})
...

آموزش GetRequestParams در Stimulsoft

تمام پارامترهای وضعیت جاری viewer که به سرور ارسال شده برمی گرداند. از این اطلاعات می توان برای تعیین نوع action که viewer درحال اجرای آن است (برای مثال، برای تعیین نوع export) استفاده کرد.

HomeController.cs
...
public IActionResult ExportReport()
{
StiRequestParams requestParams = StiNetCoreViewer.GetRequestParams(this);
if (requestParams.ExportFormat == StiExportFormat.Pdf)
{
StiReport report = StiNetCoreViewer.GetReportObject(this);
 
// Some action with report for the PDF export
// ...
 
return StiNetCoreViewer.ExportReportResult(this, report);
}
 
return StiNetCoreViewer.ExportReportResult(this);
}
...

می توانید مقادیر بعضی پارامترها را تغییر دهید. پس از اعمال تغییرات، برای عملیات جاری viewer باید شی پارامترهای تغییر کرده را به ورودی متدهای نهایی ارسال کنید.

HomeController.cs
...
public IActionResult ViewerInteraction()
{
StiRequestParams requestParams = StiNetCoreViewer.GetRequestParams(this);
if (requestParams.Action == StiAction.Variables)
{
requestParams.Interaction.Variables["Variable1"] = "MyValue";
return StiNetCoreViewer.InteractionResult(this, requestParams);
}
 
return StiNetCoreViewer.InteractionResult(this);
}
...

آموزش متد GetExportSettings در Stimulsoft

همه ی پارامترهای Export گزارش جاری را برمی گرداند. نوع parameter object مطابق با نوع export انتخاب شده در منوی viewer خواهد بود. همه ی پارامترهای export را می توان تغییر داد و به ورودی متد نهایی ارسال کرد.

HomeController.cs
...
public IActionResult ExportReport()
{
StiExportSettings settings = StiNetCoreViewer.GetExportSettings(this);
if (settings.GetExportFormat() == StiExportFormat.Pdf)
{
StiPdfExportSettings pdfSettings = (StiPdfExportSettings)settings;
pdfSettings.EmbeddedFonts = true;
pdfSettings.AllowEditable = StiPdfAllowEditable.No;
return StiNetCoreViewer.ExportReportResult(this, settings);
}
 
return StiNetCoreViewer.ExportReportResult(this);
}
...

آموزش متدهای MapPath و MapWebRootPath در Stimulsoft

MapPath() مسیر مطلق application و MapWebRootPath() مسیر مطلق دایرکتوری wwwroot را برمیگرداند. می توانید از این متدها برای upload فایل های قالب گزارش، فایل های حاوی دیتا و .. استفاده کنید. این متدها روی کلاس استاتیک StiNetCoreHelper قابل دسترسی هستند.

HomeController.cs
...
public IActionResult GetReport()
{
StiReport report = new StiReport();
report.Load(StiNetCoreHelper.MapPath(this, "Reports/SimpleList.mrt"));
 
return StiNetCoreViewer.GetReportResult(this, report);
}
...