عمل نصب و اضافه کردن امکانات گزارش گیری ابزار JasperReports به برنامه های کاربردی جاوا، بسیار ساده و راحت می باشد. شما می تواند قابلیت های این ابزار را به برنامه های خود چه در سمت سرور و چه در سمت کلاینت به سادگی اضافه نمایید. برای انجام این کار، کافیست مراحل زیر را به ترتیب انجام دهید.
ابتدا به آدرس http://www.sourceforge.net/projects/jasperreports/files مراجعه کرده و روی لینک مربوط به جدیدترین نسخه این ابزار کلیک نمایید. در این مقاله فرض بر آن است که ابزار JasperReports 3.5.3 جدیدترین نسخه می باشد.
از بین لینک های موجود روی لینک jasperreports-3.5.3-project.zip کلیک کنید. بعد از دانلود فایل آن را در یک پوشه به انتخاب خودتان Extract نمایید. اکنون پوشه jasperreports-3.5.3 که شامل فایل ها و دایرکتوریهای زیر است را مشاهده می نمایید.
محتویات پوشه های موجود در این مسیر عبارتند از:
build «« : این دایرکتوری شامل فایل های کامپایل شده کلاس JasperReports است.
demo «« : این دایرکتوری شامل مثال های متنوعی در باره ویژگی های مختلف کارکرد JasperReports می باشد.
dist «« : این دایرکتوری حاوی یک فایل JAR می باشد که این فایل شامل کتابخانه JasperReports است. این فایل JAR باید به CLASSPATH اضافه شود تا بتوان از مزایای JasperReports استفاده کرد.
docs «« : این دایرکتوری شامل یک کپی محلی از وب سایت JasperReports است.
lib «« : این دایرکتوری شامل همه کتابخانه های مورد نیاز برای ایجاد JasperReports و استفاده از آن در برنامه های جاوا می باشد.
src «« : این دایرکتوری حاوی JasperReports Source Code است.
نکته ی بسیار مهم : اطمینان حاصل کنید که مسیر کامپایلر جاوا یا javac در PATH Environment Variable شما قرار گرفته باشد.
پس از انجام مراحل بالا، حال نوبت به تنظیمات محیط NetBeans می رسد. برای انجام این تنظیمات مراحل زیر را انجام دهید:
1- محیط NetBeans را باز کنید.
2- Tools » Libraries را انتخاب کرده تا پنجره Library Manager باز شود.
3- New Library را کلیک کرده و در آن مقدار JasperReports-3.5.3 را در فیلد Library Name تایپ کنید. در قسمت Library Type عبارت
Class Libraries را انتخاب کنید
4- در تب Classpath فایل jasperreports-3.5.3.jar را از دایرکتوری dist و تمام فایل jar را از دایرکتوری lib، اضافه کنید.
5- در تب Sources ، دایرکتوری src را اضافه کنید.
با انجام مراحل فوق محیط NetBeans آماده تولید گزارش به کمک ابزار JasperReports می باشد.