آموزش چاپ گزارش ها با استفاده از Viewer در Stimul Soft

آموزش چاپ گزارش ها با استفاده از Viewer در Stimul Soft

HTML5 Viewer component گزینه های مختلفی برای چاپ گزارش در اختیار می گذارد که هر یک مزایا و معایب خود را دارد.

چاپ به صورت PDF

در این روش چاپ گزارش از روی فرمت PDF آن انجام می شود. از مزایای این روش جایگیری درست المان ها در چاپ به نسبت روش های دیگر است. از معایب این روش الزام وجود یک افزونه روی مرورگر هدف برای مشاهده ی فایل PDF است. (مرورگرهای مدرن درخود PDF viewer/printer دارند).

چاپ با پیش نمایش

گزارش در یک پنجره pop-up جداگانه بصورت HTML چاپ می شود. می توان پیش نمایش گزارش را دید و سپس آن را برای پرینت فرستاد. می توان آن را در قالب text یا html در مکان دیگری copy کرد. از مزایای این روش سازگاری آن با انواع مرورگر است و نیازمند نصب هیچ افزونه خارجی روی مرورگر نیست. مشکل این روش دقت کم در جایگیری المان های گزارش است. چرا که ساخت فرمت HTML دقت بالایی ندارد.

چاپ بدون پیش نمایش

گزارش بدون پیش نمایش مستقیم چاپ می شود. بعد از انتخاب این گزینه، پنجره print باز می شود. از آنجا که چاپ در این روش با فرمت HTML format انجام می شود، کیفیت چاپ شبیه کیفیت آن هنگام چاپ با پیش نمایش است.

توجه: هنگام چاپ HTML format، تنظیمات صفحه گزارش را با پارامترهای printer (paper size, orientation, margins, indents) تطبیق دهید. تنظیمات چاپ در مرورگر (مثل margins، headers، footers، watermarks printing و color printing) را نیز چک کنید.

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

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

HomeController.cs
...
public IActionResult PrintReport()
{
// Some code before print
// ...
 
return StiNetCoreViewer.PrintReportResult(this);
}
...

مراحل چاپ

اگر print گزارش را در viewer panel انتخاب کنید، گزینه های چاپ را خواهید داد. HTML5 Viewer component این امکان را می دهد که حالت چاپ موردنظر را الزام کنیم. برای این کار، PrintDestination property را به یکی از مقادیر StiPrintDestination enumeration مقداردهی کنید.

• Default – منو نمایش داده می شود (مقدار پیش فرض)
• Pdf – با فرمت PDF format چاپ می شود.
• Direct – با فرمت HTML format مستقیم چاپ می شود و پنجره ی print سیستمی نمایش داده می شود.
• WithPreview – با فرمت HTML format ، و با پیش نمایش گزارش در یک پنجره ی pop-up، چاپ انجام می شود.

Index.cshtml
...
@Html.StiNetCoreViewer(new StiNetCoreViewerOptions() {
Toolbar =
{
PrintDestination = StiPrintDestination.Default
}
})
...

می توان قابلیت چاپ را به کل غیرفعال کرد. برای این کار مقدار ShowPrintButton property را به false مقداردهی کنید.

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