معرفی پلاگین Fullcalendar فارسی برای اوراکل اپکس(ای پکس)

پلاگین APEXRAD Persian Fullcalendar یک Region Plugin حرفه‌ای برای نمایش و مدیریت رویدادها با تقویم جلالی (و حالت نمایش شاهنشاهی) در Oracle APEX است.

• نحوه نصب پلاگین

• ویژگی‌ها و مزیت‌ها

• آموزش کامل Attributeها با مثال

نحوه نصب پلاگین

1. در Oracle APEX وارد مسیر Shared Components > Plugins شوید.
2. روی Import کلیک کنید.
3. فایل region_plugin_info_apexrad_persianfullcalendar.sql را ایمپورت کنید.
4. در اسکیمای دیتابیس، فایل apexrad_persian_fullcalendar_pkg.sql را اجرا کنید.
5. در صفحه موردنظر یک Region جدید با نوع APEXRAD Persian Fullcalendar بسازید.
6. Region SQL و Attributeها را تنظیم کنید.

نمونه SQL برای Region Source:

select
   id,
   project,
   task_name,
   status,
   assigned_to,
   cost,
   start_date,
   end_date,
   case
      when status = 'Pending' then 'apex-cal-blue'
      when status = 'Open' then 'apex-cal-green'
      when status = 'Closed' then 'apex-cal-gray'
      when status = 'On-Hold' then 'apex-cal-orange'
   end as css_class
from apexrad_sample_fullcalendar
order by end_date

ویژگی‌ها و مزیت‌ها

ویژگی‌ها

• نمایش کامل ماه/هفته/روز/لیست با تقویم جلالی
• نمایش سالانه در سه حالت Grid / Stack / Continues
• پشتیبانی از Tooltip، اطلاعات تکمیلی و CSS کلاس رویداد
• پشتیبانی از Drag & Drop همراه PL/SQL سفارشی
• پشتیبانی از Create Link و View/Edit Link (صفحه معمولی و Modal)
• پشتیبانی از تعطیلات، استثناها و غیرفعال‌سازی انتخاب روزهای خاص
• Export با فرمت‌های CSV / iCal / XML / JSON
• پشتیبانی از Page Items to Submit و Refresh Region

مزیت‌ها

• تجربه کاربری بهتر برای کاربران فارسی‌زبان
• کاهش خطای انسانی در ورود و مشاهده تاریخ
• مناسب برای پروژه‌های سازمانی، PM، CRM و تقویم‌های عملیاتی
• پیاده‌سازی سریع بدون توسعه سنگین Frontend

آموزش کامل Attributeها با مثال

1) Display Column

نام ستون عنوان رویداد.

TASK_NAME

2) Start Date Column

نام ستون تاریخ شروع.

START_DATE

3) End Date Column

نام ستون تاریخ پایان (برای رویدادهای بازه‌ای).

END_DATE

4) Primary Key Column

ستون کلید اصلی برای شناسایی رویداد.

ID

5) CSS Class Column

ستون کلاس رنگ/ظاهر رویداد.

CSS_CLASS

6) Show Time

نمایش یا عدم نمایش زمان رویداد.

Y / N

7) Time Format

فرمت نمایش زمان (۱۲ ساعته یا ۲۴ ساعته).

DEFAULT | 24H | 12H

8) Show Tooltip

نمایش Tooltip برای رویداد.

Y / N

9) Supplemental Information

HTML اضافی برای Tooltip و List View.

<b>Assigned:</b> &ASSIGNED_TO.<br>
<b>Cost:</b> &COST.

10) Show Weekend

نمایش/عدم نمایش ستون جمعه.

Y / N

11) Show Week Numbers

نمایش شماره هفته‌های جلالی.

Y / N

12) Show Navigation

نمایش دکمه‌های قبلی/بعدی/امروز.

Y / N

13) Calendar Year

نوع نمایش سال: جلالی یا شاهنشاهی.

jalali | imperial

14) Calendar View

مود کلی تقویم: ماه یا سال.

MONTH | YEAR

15) Month Views

انتخاب نماهای حالت ماه.

MONTH:WEEK:DAY:LIST

16) Year Views

انتخاب نماهای حالت سال.

GRID:STACK:CONTINUES

17) Drag and Drop

فعال/غیرفعال کردن جابجایی رویداد با Drag & Drop.

Y / N

18) Create Link

لینک ساخت رکورد جدید با کلیک روی خانه خالی.

f?p=&APP_ID.:3:&SESSION.::NO:RP,3:P3_START_DATE,P3_END_DATE:&APEX$NEW_START_DATE.,&APEX$NEW_END_DATE.

19) View / Edit Link

لینک باز کردن رکورد موجود.

f?p=&APP_ID.:3:&SESSION.::NO:RP,3:P3_ID:&ID.

20) Maximum Events / Day

حداکثر تعداد رویداد قابل نمایش در هر روز (Month View).

3

21) Export

فرمت‌های خروجی فعال.

CSV:ICAL:XML:JSON

22) Drag and Drop PL/SQL Code

کد به‌روزرسانی دیتابیس هنگام جابجایی رویداد.

begin
  update projects
     set start_date = to_date(:APEX$NEW_START_DATE, 'YYYYMMDDHH24MISS'),
         end_date   = to_date(:APEX$NEW_END_DATE,   'YYYYMMDDHH24MISS')
   where id = :APEX$PK_VALUE;
end;

23) Exception Dates

تاریخ‌های استثنا (Comma Separated) با رنگ تعطیل.

1405-01-13,1405-01-14

24) Holiday Dates

آرایه JSON تعطیلات.

[
  {"date":"1405-01-01","name":"نوروز"},
  {"date":"1405-01-13","name":"روز طبیعت"}
]

25) Holiday Specific

دو گزینه همزمان:

• DISABLE_HOLIDAY (غیرفعال‌سازی انتخاب تعطیلات/جمعه/استثنا)
• SHOW_HOLIDAY_COLOR (نمایش رنگ تعطیل)