/
/
/
/
REPORT-01-01
REPORT
مدیریت گزارش‌ها — Notification و اطلاع‌رسانی شرطی
مدیریت گزارش‌ها — Notification و اطلاع‌رسانی شرطی در GraphBPMS
برای جلوگیری از بررسی مداوم و دستی داده‌های گزارش توسط کاربران، قابلیت اعلان‌های شرطی (Notification) طراحی شده است تا به محض تغییر داده‌ها یا وقوع یک رخداد مشخص در پایگاه‌داده، سیستم به‌صورت خودکار پیام هشدار ارسال کند. این سازوکار هوشمند، امکان نظارت لحظه‌ای بر شاخص‌های حیاتی و فرآیندهای کسب‌وکار را بدون نیاز به ورود مکرر به پیشخوان گزارش‌ها فراهم می‌سازد.
۱. دسترسی و مدیریت اولیه اعلان‌ها
با قرار دادن نشانگر موس (Hover) روی ردیف هر گزارش در جدول پیشخوان مدیریت، آیکن زنگوله (اطلاع‌رسانی) در نوار ابزار عملیاتی نمایان می‌شود:
- رنگ خاکستری / سیاه‌وسفید: نشان‌دهنده آن است که هنوز هیچ قانون اعلانی برای این گزارش تعریف نشده یا تمامی قوانین موجود غیرفعال هستند.
- رنگ نارنجی: نشان‌دهنده وجود حداقل یک قانون یا اعلان فعال بر روی این گزارش در چرخه پایش سامانه است.
با کلیک روی آیکن زنگوله، پنجره مودال «لیست اطلاع‌رسانی‌های گزارش» باز می‌شود که شامل فهرست قوانین فعال، وضعیت اجرا، تعداد دفعات اجرای موفق و نوار ابزار مدیریت است.
پیوندیار
ساختار داده‌ها و فیلدهای گزارش پیش از این در آموزش [REPORT-02] استودیوی ساخت گزارش تنظیم شده است و شروط بر اساس همین فیلدها اعمال خواهند شد.
۲. افزودن و پیکربندی اطلاع‌رسانی گزارش
با کلیک روی دکمه سبز رنگ «+ افزودن» در نوار بالای مودال، فرم پیکربندی با عنوان «افزودن اطلاع‌رسانی گزارش» باز می‌شود:
- فیلد «عنوان»: درج یک عنوان توصیفی و شفاف برای قانون اطلاع‌رسانی (مانند «ارسال اعلان تستی» یا «هشدار قبوض بالای ۱ میلیون تومان»).
- چک‌باکس «فعال»: تعیین وضعیت جاری اجرای قانون برای ورود به چرخه‌های ارزیابی خودکار یا توقف موقت پایش.
پیوندیار
در صورتی که نیاز به تغییر عنوان گزارش اصلی باشد، این اقدام در [REPORT-02] استودیوی ساخت گزارش و تب تنظیمات عمومی صورت می‌پذیرد.
۳. تعریف شرایط (Conditions) و کنترل فرکانس
هسته اصلی موتور اعلان، بخش «شرایط» است که تعیین می‌کند بر اساس کدام تغییرات داده‌ای در پایگاه‌داده، پیام هشدار تولید شود:
- افزودن و تعریف شرط: با کلیک روی دکمه «+ افزودن پایان شرط»، فیلد مقایسه (برگرفته از جدول منبع داده مانند جدول
GB_BillInformationو فیلدAmount)، عملگر مقایسه‌ای (مانند «بزرگ‌تر باشد از») و مقدار آستانه (مثلاً مقدار عددی1000000) تعیین می‌گردد. - توقف در بارگذاری شرط (کنترل تکرار): با فعال‌سازی گزینه «توقف در بارگذاری شرط» و مقداردهی عددی (مثلاً
1)، سیستم پس از یک‌بار ارسال موفق اعلان به ازای رکورد واجد شرایط، ارسال مجدد برای آن رکورد را متوقف می‌کند تا از ارسال رگباری و ایجاد اسپم (Throttle) جلوگیری شود.
پیوندیار
برای آشنایی با نوع داده فیلدها و پیکربندی آن‌ها در منبع داده، به [REPORT-02] استودیوی ساخت گزارش رجوع شود.
۴. تعیین نوع و کانال‌های اطلاع‌رسانی (Portal)
مسیرهای ارسال پیام در بخش «نوع اطلاع رسانی» شامل پرتال (Portal)، سیستم‌عامل (OS) و ایمیل می‌باشد. با انتخاب گزینه Portal، فیلدهای اختصاصی زیر در پنل ظاهر می‌شوند:
- موضوع: تیتر اصلی اعلان که در فهرست اعلان‌های هدر پرتال و کارت هشدار به نمایش درمی‌آید.
- ویرایشگر متن پیام: یک ویرایشگر پیشرفته (Rich Text Editor) کامل جهت نگارش شرح هشدار با امکان قالب‌بندی متن، استفاده از استایل‌ها و درج جداول.
پیوندیار
تنظیمات سرور ایمیل و زیرساخت نوتیفیکیشن‌های سیستم‌عامل در آموزش‌های زیرساختی مدیریت اعلان‌های پیشرفته پیگیری می‌شود.
۵. تنظیمات اجرای تایمر و زمان‌بندی (Cron)
برای تعیین فواصل زمانی بررسی خودکار داده‌ها توسط سامانه، از دکمه «تنظیمات اجرای تایمر» در نوار پایین فرم استفاده می‌شود:
- نوع تقویم: پشتیبانی کامل و بومی از هر دو تقویم شمسی و میلادی.
- پریودهای اجرای پایش: امکان تنظیم دوره‌های اجرا بر اساس دقیقه، ساعت، روز، ماه و سال.
- جدول وضعیت نهایی Cron: نگاشت نهایی مقادیر زمان‌بندی روی ستون‌های استاندارد کرون (
سال،ماه،روز ماه،روز هفته،ساعت،دقیقه،ثانیه).
پیوندیار
اجرای فرآیند پایش خودکار مبتنی بر جاب‌های زمان‌بندی‌شده پس‌زمینه (Background Services) سامانه GraphBPMS است.
۶. تنظیم پارامترهای رویه اطلاع‌رسانی و گیرندگان
از طریق دکمه «تنظیم پارامترهای رویه اطلاع‌رسانی»، اشخاص یا سمت‌های سازمانی دریافت‌کننده هشدار مشخص می‌شوند:
- کاربران گیرنده (
RecipientUserId): امکان جستجو و انتخاب چندگانه کاربران مشخص سیستم. - نقش‌های گیرنده (
RecipientRoleId): ارسال اعلان به تمام کاربرانِ دارای نقش‌های سازمانی خاص (نظیر «مدیر درجه ۲»، «مشاور» و...). - آیکن اعلان (
Icon): تعیین کلاس آیکن (مانند FontAwesome) جهت نمایش گرافیکی در پرتال. - شناسه گروه اعلان (
NotificationGroupId): ارسال دسته‌جمعی بر مبنای گروه‌بندی‌های اختصاصی اعلان‌ها.
پیوندیار
برای آشنایی با نحوه تعریف کاربران و نقش‌های سازمانی، به مستندات مدیریت امنیت و سطوح دسترسی کاربران ارجاع داده شود.
۷. تنظیم پارامترهای گزارش (ثابت و سیستمی)
چنانچه گزارشی دارای پارامتر ورودی در بدنه کوئری SQL خود باشد (مانند @PaymentStatus در کوئری گزارش قبوض)، از طریق دکمه «تنظیم پارامترهای گزارش» نحوه تامین دیتای ورودی تعیین می‌شود:
- حالت اول — مقداردهی «ثابت»: درج یک مقدار مشخص و همیشگی در فیلد مقدار (مثلاً عدد
0برای قبوض پرداخت‌نشده). - حالت دوم — مقداردهی «سیستمی»: استفاده از منوی کشویی هوشمند برای متغیرهای پویای زمان اجرا نظیر
JalaliDateTime،GregorianDateTimeوTime.
پیوندیار
نحوه تعریف پارامترهای ورودی در بدنه کوئری SQL و ثبت آن‌ها در استودیو، در [REPORT-02] استودیوی ساخت گزارش آموزش داده می‌شود.
۸. فعال‌سازی، پایش و مشاهده اعلان‌ها در پرتال
- فعال‌سازی و تغییر وضعیت درجا (Inline Update): موتور زمان‌بندی تنها قوانینی را ارزیابی می‌کند که در وضعیت «فعال» باشند. راهبر می‌تواند مستقیماً از داخل جدول وضعیت را به «فعال» تغییر دهد تا پیام تأیید سبز رنگ «عملیات با موفقیت انجام شد» نمایش داده شده و قانون وارد چرخه پایش زنده سامانه گردد.
- تغییر رنگ آیکن زنگوله: پس از فعال‌سازی، آیکن زنگوله در نوار عملیات سطر گزارش از خاکستری به نارنجی مشخص تغییر یافته و به عنوان راهنمای بصری نشان‌دهنده وجود پایش فعال عمل می‌کند.
- مشاهده در پرتال: با تحقق شروط، نشانگر عددی (Badge Counter) روی زنگوله هدر پرتال فعال شده و با کلیک روی آن، پنل کشویی اعلان‌ها همراه با متن پیام، دکمه اقدام «خواندم» و پیوند تاریخچه نمایش داده می‌شود. همچنین مقدار لاگ‌شمار «تعداد دفعات اجرای موفق» در جدول مدیریت افزایش می‌یابد.
پیوندیار
برای پایش عمومی پیام‌ها و تنظیم اعلان‌های سراسری، به آموزش مرکز اعلان‌های پرتال سامانه مراجعه شود.