jql

فیلترها و جستجوی پیشرفته (JQL) در جیرا

اگر از جیرا (Jira) برای مدیریت پروژه استفاده می‌کنید، احتمالاً با جستجوی ساده‌ی Issueها آشنا هستید. اما آیا می‌دانید که JQL (Jira Query Language) چه قدرت فوق‌العاده‌ای در اختیار شما قرار می‌دهد؟

در این مقاله، به بررسی فیلترهای پایه و جستجوی پیشرفته با JQL می‌پردازیم تا بتوانید داده‌های Jira را دقیق‌تر تحلیل کنید و گزارش‌های حرفه‌ای تهیه نمایید.


بخش ۱: فیلترهای ساده در Jira

۱. جستجوی پایه در Jira

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

  • جستجوی متنی (بر اساس عنوان Issue)
  • فیلتر بر اساس وضعیت (Status: To Do, In Progress, Done)
  • فیلتر بر اساس اختصاص‌دهنده (Assignee)

📌 مثال:

Project = "پروژه من" AND Status = "In Progress"  

۲. ذخیره و اشتراک‌گذاری فیلترها

  • با کلیک روی Save As، فیلتر خود را ذخیره کنید.
  • می‌توانید فیلترها را با اعضای تیم به اشتراک بگذارید.

بخش ۲: جستجوی پیشرفته با JQL

JQL زبان پرس‌وجوی جیرا است که به شما امکان می‌دهد فیلترهای بسیار دقیق ایجاد کنید.

۱. دستورات پایه‌ی JQL

عملگرتوضیحمثال
=برابر باProject = "پروژه من"
!=مخالفStatus != Done
INشاملAssignee IN ("علی", "مریم")
NOT INشامل نشودPriority NOT IN ("Low")
~شامل متنSummary ~ "باگ"
IS EMPTYخالی باشدDescription IS EMPTY

📌 مثال:

Project = "توسعه وب" AND Status = "Open" ORDER BY Created DESC

۲. عملگرهای پیشرفته‌تر

  • AND / OR: ترکیب چند شرط
  • ORDER BY: مرتب‌سازی نتایج
  • WAS: بررسی تاریخچه‌ی Issueها

📌 مثال:

Status WAS "In Progress" DURING ("2024-01-01", "2024-03-30")  

۳. توابع کاربردی در JQL

  • currentUser(): فیلتر Issueهای اختصاص‌یافته به خودتان
  • now(): فیلتر بر اساس تاریخ امروز
  • startOfDay() / endOfMonth(): فیلترهای تاریخ پیشرفته

📌 مثال:

dueDate >= startOfDay() AND dueDate <= endOfWeek()  

بخش ۳: کاربردهای حرفه‌ای JQL

۱. ساخت داشبوردهای سفارشی

  • با استفاده از JQL + Dashboard Gadgets، می‌توانید گزارش‌های تحلیلی ایجاد کنید.

۲. خودکارسازی با Automation Rules

  • JQL کمک می‌کند قوانین خودکار برای تغییر وضعیت Issueها ایجاد کنید.

۳. یکپارچه‌سازی با ابزارهای دیگر

  • Excel, Power BI, و Confluence از JQL پشتیبانی می‌کنند.

🔗 منابع پیشنهادی: