اگر با Power BI گزارش فارسی می‌سازید، احتمالاً با یک مشکل آشنا روبه‌رو شده‌اید: اسلایسر تاریخ در Power BI به‌صورت پیش‌فرض بر پایه تاریخ میلادی کار می‌کند، در حالی که کاربران فارسی‌زبان معمولاً انتظار دارند بازه‌های زمانی را با تاریخ شمسی / جلالی انتخاب کنند.

برای حل همین نیاز، ویژوال متن‌باز 123 Persian Calendar Slicer for Power BI توسعه داده شده است؛ یک Power BI Custom Visual برای انتخاب بازه تاریخ شمسی در گزارش‌های فارسی.

این ویژوال به کاربران اجازه می‌دهد تاریخ را به‌صورت شمسی انتخاب کنند، اما در پشت صحنه فیلتر استاندارد Power BI روی داده‌ها اعمال شود.

123 Persian Calendar Slicer چیست؟

123 Persian Calendar Slicer یک ویژوال سفارشی برای Power BI است که به‌جای انتخاب تاریخ میلادی، یک رابط کاربری فارسی برای انتخاب بازه تاریخ شمسی در اختیار کاربر قرار می‌دهد.

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

کاربر تاریخ را شمسی انتخاب می‌کند، Power BI داده‌ها را درست فیلتر می‌کند.

چرا Power BI به اسلایسر تاریخ شمسی نیاز دارد؟

Power BI ابزار بسیار قدرتمندی برای تحلیل داده و ساخت داشبورد است، اما در محیط‌های فارسی‌زبان، موضوع تاریخ همیشه یک چالش جدی است.

در بسیاری از سازمان‌های ایرانی:

• گزارش‌ها با تقویم شمسی بررسی می‌شوند.
• سال مالی بر اساس تاریخ شمسی تعریف می‌شود.
• کاربران نهایی با تاریخ میلادی راحت نیستند.
• داده‌ها ممکن است با کلید تاریخ شمسی مثل 14030101 ذخیره شده باشند.
• گزارش‌ها روی Power BI Report Server در محیط داخلی سازمان منتشر می‌شوند.

در چنین شرایطی، استفاده از Slicer تاریخ میلادی تجربه خوبی برای کاربر نهایی ایجاد نمی‌کند. به همین دلیل، یک Power BI Persian Date Slicer یا Jalali Date Slicer می‌تواند نیاز واقعی بسیاری از گزارش‌های فارسی را پوشش دهد.

قابلیت‌های اصلی 123 Persian Calendar Slicer

• انتخاب بازه تاریخ شمسی در Power BI
• پشتیبانی از تقویم جلالی / شمسی
• DatePicker فارسی به‌صورت Popup / Overlay
• پشتیبانی از تاریخ میلادی استاندارد Power BI
• پشتیبانی از کلید تاریخ شمسی با فرمت yyyymmdd
• پشتیبانی از ورودی دستی تاریخ شمسی
• پشتیبانی از اعداد فارسی و انگلیسی
• رابط کاربری راست‌چین و مناسب زبان فارسی
• تنظیمات قابل تغییر از Format Pane در Power BI
• مناسب برای Power BI Desktop
• طراحی‌شده با توجه به نیازهای Power BI Report Server
• متن‌باز و قابل توسعه

پشتیبانی از دو نوع مدل داده

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

۱. استفاده با ستون تاریخ میلادی

اگر مدل داده شما یک Date Table استاندارد دارد و ستون تاریخ از نوع Date یا DateTime است، می‌توانید آن ستون را به ورودی زیر بدهید:

Gregorian Date

در این حالت، کاربر تاریخ را به‌صورت شمسی انتخاب می‌کند، اما ویژوال تاریخ انتخاب‌شده را به میلادی تبدیل کرده و فیلتر را روی ستون Date اعمال می‌کند.

این روش برای مدل‌های حرفه‌ای Power BI پیشنهاد می‌شود.

۲. استفاده با کلید تاریخ شمسی

در بعضی مدل‌های داده، تاریخ به‌صورت کلید عددی یا متنی شمسی ذخیره می‌شود؛ مثلاً:

14030101

در این حالت می‌توانید از ورودی زیر استفاده کنید:

Persian Date Key

فرمت پیشنهادی برای کلید تاریخ شمسی:

yyyymmdd

مثال:

14030101
14030215
14031229

در این حالت، ویژوال مستقیماً روی همین کلید تاریخ شمسی فیلتر بازه‌ای اعمال می‌کند.

فرمت‌های قابل قبول برای ورود تاریخ شمسی

این ویژوال ورودی‌های مختلف تاریخ شمسی را پشتیبانی می‌کند؛ از جمله:

1403/01/01
14030101
۱۴۰۳/۰۱/۰۱
۱۴۰۳۰۱۰۱

بنابراین کاربر می‌تواند هم با اعداد فارسی و هم با اعداد انگلیسی تاریخ را وارد کند.

تنظیمات قابل تغییر در Power BI

در بخش Format Pane می‌توانید ظاهر و رفتار ویژوال را تغییر دهید. برخی از تنظیمات قابل تغییر عبارت‌اند از:

• حالت نمایش DatePicker
• نمایش یا عدم نمایش دکمه‌های سریع
• اعمال خودکار فیلتر بعد از انتخاب تاریخ
• نمایش اعداد فارسی یا انگلیسی
• انتخاب فونت فارسی
• نمایش یا عدم نمایش خلاصه فیلتر
• نمایش یا عدم نمایش نام ماژول در پایین ویژوال

فونت‌های قابل انتخاب شامل موارد زیر هستند:

• Default
• Segoe UI
• Tahoma
• Arial
• Calibri
• Vazirmatn
• IRANSans
• Yekan Bakh

نکته: فایل فونت داخل ویژوال قرار داده نشده است. اگر فونت انتخاب‌شده روی سیستم یا محیط اجرای گزارش موجود نباشد، Power BI از فونت جایگزین استفاده می‌کند.

مناسب برای Power BI Report Server

یکی از نکات مهم در طراحی این ویژوال، توجه به سناریوهای سازمانی و استفاده در Power BI Report Server است.

در بسیاری از سازمان‌ها، گزارش‌ها روی Power BI Service منتشر نمی‌شوند و به‌جای آن از Power BI Report Server در محیط داخلی استفاده می‌شود. به همین دلیل، DatePicker این ویژوال به‌صورت داخلی و Overlay طراحی شده و وابستگی به Modal Dialog رسمی Power BI ندارد.

این طراحی باعث می‌شود ویژوال برای سناریوهای on-premises و Report Server مناسب‌تر باشد.

البته پیشنهاد می‌شود قبل از استفاده در محیط production، ویژوال را روی نسخه Power BI Desktop مخصوص Report Server و نسخه Report Server سازمان خود تست کنید.

دانلود 123 Persian Calendar Slicer

برای دانلود آخرین نسخه ویژوال، به صفحه GitHub پروژه مراجعه کنید:

مشاهده پروژه در GitHub

صفحه Release:

دانلود آخرین نسخه 123 Persian Calendar Slicer

فایل قابل استفاده در Power BI معمولاً با پسوند .pbiviz منتشر می‌شود. اگر فایل داخل ZIP قرار دارد، ابتدا آن را Extract کنید و سپس فایل .pbiviz را در Power BI وارد کنید.

روش نصب در Power BI Desktop

1. Power BI Desktop را باز کنید.
2. از بخش Visualizations روی گزینه سه‌نقطه ... کلیک کنید.
3. گزینه Import a visual from a file را انتخاب کنید.
4. فایل .pbiviz را انتخاب کنید.
5. ویژوال به لیست Visualهای شما اضافه می‌شود.
6. یکی از فیلدهای Gregorian Date یا Persian Date Key را به آن بدهید.
7. بازه تاریخ شمسی را انتخاب کنید.

این ویژوال برای چه کسانی مناسب است؟

• تحلیل‌گران داده فارسی‌زبان
• متخصصان Power BI در ایران
• مدرس‌های Power BI
• تیم‌های BI سازمانی
• شرکت‌هایی که از Power BI Report Server استفاده می‌کنند
• توسعه‌دهندگان داشبوردهای مدیریتی
• تیم‌های مالی، فروش، منابع انسانی و عملیات
• سازمان‌هایی که داده‌هایشان بر پایه تاریخ شمسی تحلیل می‌شود

نمونه کاربردها

• فیلتر گزارش فروش بر اساس بازه تاریخ شمسی
• انتخاب ماه جاری شمسی در داشبورد مدیریتی
• تحلیل عملکرد فروش در سال جاری شمسی
• گزارش مالی بر اساس تاریخ جلالی
• فیلتر داده‌های منابع انسانی بر اساس تاریخ استخدام یا پرداخت
• تحلیل بارنامه، حمل‌ونقل و لجستیک بر اساس بازه زمانی شمسی
• گزارش‌های سازمانی فارسی در Power BI Report Server

پروژه متن‌باز برای جامعه Power BI فارسی

این ویژوال به‌صورت متن‌باز منتشر شده است تا کاربران فارسی‌زبان Power BI بتوانند راحت‌تر گزارش‌های حرفه‌ای با تاریخ شمسی بسازند.

اگر پیشنهادی برای بهبود ویژوال دارید، می‌توانید از طریق GitHub Issue یا Pull Request مشارکت کنید.

مخزن پروژه:

123 Persian Calendar Slicer on GitHub

حمایت از توسعه

توسعه ابزارهای متن‌باز فارسی نیازمند زمان و انرژی است.

اگر این ویژوال برای شما یا سازمان شما مفید بود، می‌توانید از توسعه ماژول‌های متن‌باز حمایت کنید:

حمایت از توسعه ماژول‌های متن‌باز

توسعه‌دهنده

این ویژوال توسط محمد قاهری توسعه داده شده است.

LinkedIn:
https://www.linkedin.com/in/mohammadghaheri/

GitHub:
https://github.com/MohammadGhaheri

جمع‌بندی

اگر در Power BI گزارش فارسی می‌سازید و نیاز دارید کاربران شما بازه تاریخ را با تقویم شمسی انتخاب کنند، 123 Persian Calendar Slicer for Power BI می‌تواند یک راهکار ساده، کاربردی و متن‌باز برای شما باشد.

این ویژوال امکان انتخاب تاریخ شمسی را فراهم می‌کند، از تاریخ میلادی و کلید تاریخ شمسی پشتیبانی می‌کند، برای سناریوهای Power BI Report Server طراحی شده و به‌صورت رایگان از GitHub قابل دانلود است.

برای دانلود و مشاهده سورس پروژه:

دانلود 123 Persian Calendar Slicer for Power BI