آموزش کار با پارامترها در HTML5 Viewer در Stimulsoft

آموزش کار با پارامترها در HTML5 Viewer در Stimulsoft

برای کار با پارامترهای گزارش در HTML5 Viewer، پنل تنظیمات خاصی وجود دارد.

برای افزودن یک پارامتر به پنل لازم است یک متغیر در یک گزارش تعریف کنید. هنگام مشاهده ی گزارش در viewer آن متغیر به طور خودکار به پنل تنظیمات اضافه می شود.

پنل تنظیمات همه نوع متغیری (متغیرهای معمولی، تاریخ و زمان، border ها و list ها و ..) را پشتیبانی می کند.

برای کار با گزارش های دارای پارامتر، هیچ تنظیمات اضافه ای برای viewer لازم نیست. اگر می خواهید قبل از اعمال پارامترهای عملی انجام شود، باید یک Interaction action تعریف کنید.

Index.cshtml
...
@Html.StiNetCoreViewer(new StiNetCoreViewerOptions() {
Actions =
{
Interaction = "ViewerInteraction"
}
})
...

HomeController.cs
...
public IActionResult ViewerInteraction()
{
// Some code before any interaction
// ...
 
return StiNetCoreViewer.InteractionResult(this);
}
...

این action حین اجرای هرنوع interactive action فراخوانی می شود. اگر می خواهید action فقط هنگام اعمال پارامترهای گزارش اجرا شود، می توانید از پارامترهای viewer استفاده کنید. پارامترهای viewer از طریق یک شی از کلاس StiRequestParams class قابل دسترس است. این شی در هر request به سرور ارسال می شود و حاوی اطلاعات ضروری و وضعیت بخش سمت کلاینت viewer است. برای تعیین نوع action از viewer، کافی است Action property از پارامترهای viewer را چک کنیم.

...
public IActionResult ViewerInteraction()
{
StiRequestParams requestParams = StiNetCoreViewer.GetRequestParams(this);
if (requestParams.Action == StiAction.Variables)
{
// Some code before apply parameters
}
 
return StiNetCoreViewer.InteractionResult(this);
}
...

اگر نمی خواهید با پارامترهای viewer کار کنید، می توانید این قابلیت را به کلی غیر فعال کنید. برای این منظور از ShowParametersButton property در Toolbar استفاده کنید و آن را به false مقداردهی کنید.

Index.cshtml
...
@Html.StiNetCoreViewer(new StiNetCoreViewerOptions() {
Toolbar =
{
ShowParametersButton = false
}
})
...

توجه: اگر viewer را به این صورت config کنید، پنل option ها (options panel) ، حتی اگر پارامترها در گزارش نمایش داده شده وجود داشته باشند، نمایش داده نخواهد شد.