تقویم شمسی Jira

قابلیت‌های افزونه تقویم شمسی Jira؛ بررسی بر اساس کد واقعی

تصویر مقاله قابلیت‌های افزونه تقویم شمسی Jira؛ بررسی بر اساس کد واقعی

برای ارزیابی یک افزونه سازمانی، فهرست تبلیغاتی کافی نیست. باید دید کد در کدام contextها بارگذاری می‌شود، چه نوع ورودی‌هایی را تشخیص می‌دهد و هنگام ذخیره چه داده‌ای به Jira برمی‌گرداند. این مقاله قابلیت‌های ثبت‌شده در مخزن عمومی افزونه Desktopcenter را با زبان کاربردی توضیح می‌دهد.

تقویم Date و DateTime

هسته افزونه شامل تبدیل میلادی و جلالی، تقویم انتخاب تاریخ و تشخیص فیلدهای تاریخ است. برای DateTime نیز انتخاب ساعت و دقیقه و نمایش ۲۴ ساعته در مسیرهای مشخص پیاده‌سازی شده است. این تفاوت مهم است، چون تبدیل یک Due Date با زمان شروع کار یا timestamp فعالیت یکسان نیست.

افزونه تنظیمات فرمت Jira را از endpoint داخلی خود می‌خواند و برای فرمت‌های متداول مانند d/MMM/yy، yyyy-MM-dd و MM/dd/yyyy parser دارد. بنابراین قبل از rollout باید فرمت تنظیم‌شده instance بررسی شود.

  • تبدیل نمایش میلادی به شمسی
  • تبدیل مقدار انتخاب‌شده به فرمت قابل ذخیره در Jira
  • پشتیبانی از تاریخ و تاریخ‌وزمان
  • اعداد فارسی و قالب ۲۴ ساعته در نمایش‌های هدف

Inline Edit و صفحه‌های پویا

Jira بخش‌هایی دارد که بعد از بارگذاری اولیه صفحه به‌صورت پویا ساخته می‌شوند. adapter مربوط به inline edit با event capture تلاش می‌کند کلیک روی trigger تقویم را پیش از date picker بومی Jira دریافت کند و popup فارسی را باز کند. Mutation Observerها نیز برای محتوای اضافه‌شده در طول کار استفاده شده‌اند.

این روش برای سازگاری با UIهای مختلف مفید است، اما به selector و تغییرات نسخه Jira حساس است؛ به همین دلیل آزمون روی workflow و UI واقعی مشتری ضروری است.

Activity Stream، جست‌وجو و مدت‌زمان

ماژول‌های مربوط به متن، timestampهای نسبی مانند «15 minutes ago»، تاریخ‌های Issue Navigator، مدت‌زمان‌هایی مانند 1h 30m و برخی نمایش‌های تاریخچه را به قالب فارسی نزدیک می‌کنند. این تبدیل بیشتر در لایه متن و نمایش رخ می‌دهد و نباید با تغییر داده اصلی Jira اشتباه گرفته شود.

در گزارش‌های حساس، نمونه قبل و بعد از تبدیل را بررسی کنید تا عبارت‌های غیرتاریخی یا متن issue به‌اشتباه تحت تأثیر قرار نگیرند.

JSM، Audit Log، Roadmaps و JXL

descriptor افزونه contextهایی برای Jira عمومی، issue، navigator، admin و Customer Portal دارد. در کد نیز adapterهایی برای JSM، Audit Log، Roadmaps و JXL دیده می‌شود. JXL به iframe و محتوای پویا وابسته است و Audit Log نیز UI متفاوتی نسبت به فرم‌های کلاسیک Jira دارد.

وجود adapter به معنی تأیید همه ترکیب‌های نسخه‌ای نیست. matrix آزمون باید شامل نسخه Jira، نسخه محصول مکمل، مرورگر، context صفحه و نوع field باشد.

  • JSM Customer Portal
  • Audit Log و فیلترهای تاریخ
  • Advanced Roadmaps در gridهای هدف
  • JXL و iframeهای هم‌مبدأ
  • سناریوهای مرتبط با ScriptRunner در کد

لایسنس و endpointهای داخلی

افزونه صفحه مدیریت لایسنس و REST endpointهایی برای وضعیت، شناسه سرور، فعال‌سازی و تنظیمات فرمت دارد. مسیرهای REST با filter سمت سرور بررسی می‌شوند و وضعیت نامعتبر نباید به‌عنوان قابلیت فعال تلقی شود. جزئیات کلید و سازوکار امضا برای استفاده داخلی محصول است و در مستند عمومی مشتری فقط فرایند فعال‌سازی و پشتیبانی توضیح داده می‌شود.

پرسش‌های متداول

آیا افزونه فقط Due Date را شمسی می‌کند؟+

خیر. علاوه بر فیلدهای Date و DateTime، برای جست‌وجو، Activity Stream، مدت‌زمان و چند context مکمل adapter در کد وجود دارد؛ دامنه نهایی باید روی نسخه هدف آزمون شود.

آیا JXL و JSM به‌صورت قطعی روی همه نسخه‌ها کار می‌کنند؟+

کد برای این contextها adapter دارد، اما UI و selector محصولات مکمل تغییر می‌کند؛ قبل از خرید یا rollout، آزمون سازگاری روی محیط واقعی پیشنهاد می‌شود.

ادامه مطالعه

گفتگو درباره مسئله شما