با گسترش نیاز به گزارش‌گیری‌های دقیق و پیشرفته در برنامه‌های وب، انتخاب ابزار مناسب برای این کار اهمیت بیشتری پیدا کرده است. یکی از ابزارهای قدرتمند در این زمینه، نرم‌افزار Stimulsoft است که به ویژه برای فریمورک‌های مختلف توسعه یافته است. این نرم‌افزار به توسعه‌دهندگان این امکان را می‌دهد تا با استفاده از قابلیت‌های منحصر به فرد خود، گزارش‌های جذاب و قابل سفارشی‌سازی ایجاد کنند. در این مقاله، به بررسی نحوه استفاده از گزارش‌گیر Stimulsoft در لاراول خواهیم پرداخت و مراحل لازم برای پیاده‌سازی آن را به‌تفصیل توضیح خواهیم داد.

گزارش گیری با Stimulsoft در لاراول

Stimulsoft یک نرم افزار گزارش‌گیری پیشرفته است که در ابتدا برای فریمورک Asp.net core طراحی شده بود. با گذشت زمان، نسخه های مختلفی از این نرم افزار برای زبان های مختلف تحت وب ارائه شد. اکنون می‌توان از این نرم افزار با زبان‌هایی مثل php ،javaScript ،java و … استفاده کرد. حال در این مقاله نحوه استفاده از نرم افزار Stimulsoft در فریمورک لاراول را بررسی می‌کنیم.

با استفاده از این نرم افزار می‌توان گزارش های پیشرفته‌ای همانند شکل زیر را تولید کرد:

فریمورک لاراول یک فریمورک طراحی وب است که با زبان PHP ساخته شده و برای طراحی انواع وب‌سایت‌ها به کار می‌رود. علاوه بر PHP، می‌توان از زبان JavaScript نیز در طراحی وب‌سایت خود استفاده کرد تا صفحات با کارایی بالا و مطابق با نیازهای خود را ایجاد کنیم. بنابراین برای استفاده از Stimulsoft، می‌توانیم از دو نسخه PHP و JavaScript آن بهره ببریم. طبق تجربه، بهتر است از نسخه جاوااسکریپتی این نرم‌افزار استفاده شود؛ زیرا کار با نسخه PHP آن ممکن است کمی دشوار باشد، به‌خصوص اگر از Data Source‌ها برای ایجاد گزارش استفاده کنید و بخواهید این منابع را به صفحه گزارش خود متصل کنید. بنابراین، استفاده از نسخه جاوااسکریپتی توصیه می‌شود.

• گیت‌هاب مربوط به نسخه جاوااسکریپت نرم افزار Stimulsoft:

https://github.com/stimulsoft/Samples-JS/tree/master/JavaScript

در این لینک می‌توانید به مطالعه مثال های آورده‌شده با زبان جاوااسکریپت بپردازید.

حال می‌خواهیم مثالی را برای استفاده از این نرم‌افزار در فریمورک لاراول ارائه دهیم. فرض می‌کنیم که فایل با پسوند .mrt را ابتدا در نرم‌افزار تحت ویندوز آن طراحی کرده‌ایم و اکنون می‌خواهیم با تولید اطلاعات در وب‌سایت خود و متصل کردن این اطلاعات به این فایل، گزارش خود را تولید کنیم. مراحل زیر را دنبال می‌کنیم:

1- ایجاد کنترلر :

ابتدا کنترلر مربوط به تولید گزارش را ایجاد می‌کنیم. برای این کار از دستور زیر در خط فرمان استفاده می‌کنیم :

php artisan make:controller ReportController

سپس می‌خواهیم با ورود به متد index در این کنترلر، صفحه مربوط به نمایش گزارش را به نمایش بگذاریم. بنابراین متد index را در داخل کنترلر ایجاد کرده و دستورات زیر را در آن می‌نویسیم:

public function index() {

return view(‘report’);

}

2- ایجاد صفحه blade :

در داخل پوشه resources و سپس views یک فایل با نام زیر ایجاد میکنیم :

report.blade.php

3- ایجاد مسیر :

به داخل پوشه routes رفته و در فایل web.php مسیر زیر را برای مشاهده گزارش خود تعریف می‌کنیم:

use App\\Http\\Controllers\\ReportController;

Route::get(‘/report’,[ReportController::class,’index’]);

4- دانلود فایل های گزارش گیر stimulsoft :

این سه فایل زیر را دانلود کنید (لینک دانلود) :

stimulsoft.reports.export.js

stimulsoft.reports.engine.js

stimulsoft.viewer.js

سپس فایل mrt خروجی نرم افزار و همچنین فایل مربوط به ورودی اطلاعات به گزارش که در اینجا از نوع JSON است (با نام table1.json معرفی شده‌است) را در نظر بگیرید. این پنج فایل را در یک مسیر عمومی قابل دسترس در لاراول، یعنی در پوشه public ذخیره کنید. برای مثال، این سه فایل را در آدرس زیر قرار می‌دهیم:

public/stimulsoft/files

بنابراین، این پنج فایل با دستور ()asset در لاراول در دسترس هستند و می‌توان از آنها در صفحه خود استفاده کرد.

5- کد جاوااسکریپت گزارش:

برای بدست آوردن کد جاوااسکریپت گزارش خود هم می‌توانید از داکیومنت stimulsoft استفاده کنید(برای مشاهده کلیک کنید) و یا اینکه پس از اتمام طراحی خود در نرم افزار تحت ویندوز، از گزینه publish در بالا سمت راست نرم افزار، برای تهیه خروجی جاوااسکریپت گزارش خود اقدام کنید (به صورت شکل زیر):

کد جاوااسکریپت گزارش به صورت زیر است:

در این کد یک Data Source به نام table1 داریم که اطلاعات خود را جهت نمایش گزارش در آن قرار می‌دهیم. این فایل از نوع JSON است.

حال این کد جاوااسکریپت را در فایل index.blade.php ایجاد‌شده در مرحله دوم قرار می‌دهیم.

• کد فایل‌های گزارش‌گیری

جهت دسترسی کد به فایل‌های گزارش‌گیری، باید تغییراتی را در این کد ایجاد کنیم. ابتدا باید یک فایل اصلی جاوااسکریپت برای دسترسی به گزارش‌گیر را به صفحه خود لینک کنیم. برای این کار کافی است در مسیر تگ script در صفحه در قسمت src، از دستورات لاراولی و تابع ()asset استفاده کنیم. چون فایل‌ها را در پوشه public ذخیره کرده‌ایم و امکان دسترسی به فایل‌ها با تابع ()asset را داریم. بنابراین سه خط مربوط به لینک کردن فایل های اسکریپتی به صفحه به صورت زیر تغییر خواهد کرد:

<script type=”text/javascript” src=”{{ asset(‘stimulsoft/files/stimulsoft.reports.engine.js’) }}”></script>

<script type=”text/javascript” src=”{{ asset(‘stimulsoft/files/stimulsoft.reports.export.js’) }}”></script>

<script type=”text/javascript” src=”{{ asset(‘stimulsoft/files/stimulsoft.viewer.js’) }}”></script>

در واقع شما باید برای هر کد گزارش، تگ های script که به یک فایل جاوااسکریپتی مربوط به نرم افزار Stimulsoft اشاره دارد را ابتدا دانلود کرده و در مسیر عمومی خود قرار دهید و آن را به صفحه نمایش گزارش خود متصل کنید.

سپس باید فایل طراحی گزارش یعنی فایل mrt را به صفحه خود معرفی کنیم. بنابراین با استفاده از دستور ()asset محل فایل mrt را به کد جاوااسکریپت گزارش گیر معرفی میکنیم. همچنین باید فایل ورودی اطلاعات برای گزارش‌گیری که همان Data Source ما می‌باشد را نیز به همین روش به کد جاوااسکرپت خود معرفی کنیم.

پس از اعمال این تغییرات، کد جاواسکریپتی صفحه مربوط به نمایش گزارش به صورت زیر خواهد بود:

در نهایت با اجرای پروژه (serve گرفتن از پروژه) و وارد کردن آدرس report/ در مرورگر، گزارش شما در قالب نرم‌افزار Stimulsoft نمایش داده خواهد شد.

این مثال دقیقاً با لاراول 8 در لینک گیت‌هاب زیر قابل دسترس است و می‌توانید محل فایل‌ها و کدها را مشاهده کنید:

https://github.com/Reymoh75/use-stimulsoft-in-laravel

نتیجه‌گیری

استفاده از Stimulsoft در لاراول به شما این امکان را می‌دهد که به راحتی گزارش‌های حرفه‌ای و کارآمد ایجاد کنید. با رعایت مراحل شرح‌داده‌شده در این مقاله و آشنایی با ابزارهای موجود، می‌توانید به بهبود عملکرد گزارش‌گیری در پروژه‌های خود بپردازید. امیدواریم این راهنما به شما کمک کند تا از امکانات Stimulsoft بهره‌برداری کنید و گزارش‌هایی با کیفیت بالا را در برنامه‌های لاراول خود پیاده‌سازی نمایید. اگر به مشاوره یا اطلاعات بیشتری در این زمینه نیاز دارید، خوشحال می‌شویم که به شما کمک کنیم.