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

پلاگین APEXRAD IRAN Map یک Region Plugin حرفه‌ای برای نمایش تعاملی استان‌های ایران در Oracle APEX است.

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

• ویژگی‌ها، کاربرد و مزیت‌های پلاگین

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

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

1. در Oracle APEX وارد مسیر Shared Components > Plugins شوید.
2. روی Import کلیک کنید.
3. فایل region_plugin_info_apexrad_iranmap.sql را ایمپورت کنید.
4. در صفحه موردنظر، یک Region جدید بسازید و Type را روی APEXRAD IRAN Map قرار دهید.
5. Region SQL و Attributeها را تنظیم کنید.

نمونه Region SQL:

select id,
       state_id,
       status,
       description,
       name
from   apexrad_iranmap_test

ویژگی‌ها، کاربرد و مزیت‌ها

• نمایش تعاملی 31 استان ایران
• Tooltip چندخطی بر اساس داده‌های SQL
• لینک‌دهی هر استان (صفحه عادی، مودال، JavaScript)
• Province Mapping برای نگاشت شناسه‌های دیتابیس شما
• پشتیبانی از Count SQLCode
• پشتیبانی کامل از موبایل و Long Press
• رویدادهای Dynamic Action: apexradiranmapselect و apexradiranmaplinkopen

مزیت‌ها

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

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

SQL مرجع:

select id,
       state_id,
       status,
       description,
       name
from   apexrad_iranmap_test

Background Color

رنگ پس‌زمینه Region نقشه. نمونه: transparent یا #f5f7fa

Show Tooltip

نمایش/عدم نمایش Tooltip. نمونه: Yes یا No

Supplemental Information

تعداد برابر است با #APEXRAD_PROVINCE_COUNT#

Province ID Column (Mandatory)

نمونه: state_id

TOOLTIP1 Column

نمونه: status

TOOLTIP2 Column

نمونه: name

TOOLTIP3 Column

نمونه: description

Primary Key Column

نمونه: ID

Show Count

نمونه: Yes / No

Count SQLCode

select count(state) as province_count,
       state as province_id
from   iranmap_test
where  :APP_USER = upper('SAEED')
group by province_id

Province Mapping (Mandatory)

[
  {
    "apexrad_province_id": "3",
    "your_province_id": "13"
  }
]

Ratio

AUTO, 1:1, 16:9, 4:3, 2:1

Scale

Contain, Cover, Fill, Scale Down

Map Size (%)

بازه 20 تا 200. نمونه: 80, 100, 140

Link

javascript:window.open("https://service.apexrad.info/&ID.",'_blank')
javascript:void(0);

Exception Province

لیست استان‌های استثنا (Comma Separated)

12,13

APEXRAD Province IDs:

1 – تهران 2 – مازندران 3 – آذربایجان شرقی 4 – آذربایجان غربی 5 – کرمانشاه 6 – خوزستان 7 – فارس 8 – کرمان 9 – خراسان رضوی 10 – اصفهان 11 – خراسان شمالی 12 – کردستان 13 – هرمزگان 14 – همدان 15 – چهارمحال و بختیاری 16 – لرستان 17 – ایلام 18 – کهکیلویه و بویراحمد 19 – زنجان 20 – خراسان جنوبی 21 – مرکزی 22 – البرز 23 – گیلان 24 – اردبیل 25 – قم 26 – قزوین 27 – گلستان 28 – سیستان و بلوچستان 29 – یزد 30 – بوشهر 31 – سمنان

Disable Exception

در صورت فعال بودن، استان‌های استثنا قابل انتخاب نیستند.

Touch Long Press Opens Link

• Yes: Tap = Tooltip ، Long Press = Link
• No: Tap مستقیم Link را باز می‌کند

Touch Long Press Duration (ms)

بازه: 250..2000 | نمونه: 450, 550, 800

نحوه استفاده از رویدادهای Dynamic Action: apexradiranmapselect و apexradiranmaplinkopen