ادغام با Bugzilla

این بخش توضیح می‌دهد که چطور TestRail را با Bugzilla ادغام کنید. در حال حاضر سه روش برای این ادغام وجود دارد:

• استفاده از Defect URLs برای لینک کردن نتایج تست به Bugzilla
• استفاده از defect plugin برای Bugzilla، برای ارسال و جستجوی issueهای Bugzilla
• استفاده از Reference URLs برای لینک کردن test caseها به Bugzilla
• استفاده از reference plugin برای Bugzilla، برای جستجوی issueهای Bugzilla در فیلد References موجودیت‌های TestRail مانند test caseها، test runها و milestoneها

لازم نیست از همه گزینه‌های ادغامِ فهرست‌شده استفاده کنید؛ می‌توانید این ادغام را همراه با ابزارهای دیگر هم به کار ببرید. پیکربندی ادغام معمولاً فقط چند دقیقه زمان می‌برد. این راهنما توضیح می‌دهد که ادغام را چطور پیکربندی کنید و این ادغام چگونه کار می‌کند.

Defect URLs #

Defect URLs به TestRail می‌گویند که چطور یک Defect ID را به URL مربوط به نمونه Bugzilla شما تبدیل کند. دو نوع URL وجود دارد: View URLs و Add URLs.

گزینه Defect View URL  برای ساختن لینک به Bugzilla بر اساس Defect ID استفاده می‌شود؛ بنابراین می‌توانید فقط روی یک ID کلیک کنید تا issue مستقیماً در Bugzilla باز شود.

گزینه Defect Add URL  برای ساختن لینک به صفحه ایجاد issue در Bugzilla استفاده می‌شود. بعد از پیکربندی URL، یک لینک جدید با عنوان Add کنار فیلد Defects در پنجره Add Test Result و همچنین در منوی Defects در قابلیت Push Defect From Anywhere در TestRail ظاهر می‌شود. این لینک به شما امکان می‌دهد برای گزارش یک bug جدید، مستقیم به فرم New Issue در Bugzilla بروید.

اگر لینک Add  را می‌بینید، می‌توانید ID مربوط به issue جدید Bugzilla را کپی کنید و آن را در هر فیلد Defects یا References داخل TestRail وارد کنید.

می‌توانید URLهای Bugzilla را در TestRail به‌صورت سراسری از مسیر Administration > Integration  یا برای هر project به‌صورت جداگانه، از داخل تنظیمات همان project پیکربندی کنید. برای پیکربندی آدرس‌ها، از URLهای نمونه زیر استفاده کنید:

Bugzilla installation
Defect View Url: http://<your-server>bugzilla/show_bug.cgi?id=%id%
Defect Add Url:  http://<your-server>/bugzilla/enter_bug.cgi

حتماً مقدار <your-server> را با آدرس واقعی Bugzilla که می‌خواهید با آن ادغام کنید جایگزین کنید.

اگر defect plugin را پیکربندی کرده باشید، می‌توانید نشانگر ماوس را روی Defect ID نگه دارید تا جزئیات issue را مستقیماً از داخل TestRail ببینید.

Reference URLs #

Reference URLs تقریباً مشابه Defect URLs که در بالا توضیح داده شد پیاده‌سازی می‌شوند. تفاوت اصلی این است که Reference URLs برای فیلد References در موجودیت‌های مختلف TestRail استفاده می‌شوند، نه برای فیلد Defects.

گزینه Reference View URL به همان روشی که در بالا توضیح داده شد پیکربندی می‌شود و به TestRail اجازه می‌دهد بر اساس ID واردشده در فیلد References، یک لینک مستقیم به Bugzilla بسازد.

گزینه Reference  Add URL  نیز به همان روش Defect Add URL پیکربندی می‌شود. بعد از پیکربندی، یک لینک Add کنار هر فیلد References در instance یا project شما ظاهر می‌شود. اگر از لینک Add استفاده کنید، می‌توانید ID مربوط به issue جدید Bugzilla را کپی کنید و آن را در هر فیلد Defects یا References داخل TestRail وارد کنید.

اگر Reference plugin را پیکربندی کرده باشید، می‌توانید نشانگر ماوس را روی Reference ID نگه دارید تا جزئیات issue را مستقیماً از داخل TestRail ببینید. برای یادگیری نحوه استفاده و پیکربندی Defect و Reference Plugins، ادامه مطلب را بخوانید.

پلاگین Defect #

برای پیاده‌سازی یکپارچه‌سازی عمیق‌تر با bug tracker می‌توانید از پلاگین‌های defect استفاده کنید. TestRail یک پلاگین defect آماده برای Bugzilla دارد. برای پیکربندی این پلاگین، گزینه Administration > Integration  را انتخاب کنید و در بخش Defect Plugin از فهرست کشویی، Bugzilla را انتخاب کنید. در گام بعدی، همه تنظیمات لازم برای اتصال را در دسته‌بندی [connection] پیکربندی کنید. همچنین می‌توانید با ویرایش تنظیمات یک project، این یکپارچه‌سازی را فقط برای همان project تنظیم کنید.

پلاگین Defect از API مربوط به Bugzilla استفاده می‌کند؛ بنابراین برای اتصال به API به اطلاعات ورود معتبر نیاز دارید. می‌توانید یک مجموعه اطلاعات ورود را برای همه کاربران Bugzilla وارد کنید، یا با استفاده از User Variables به هر کاربر TestRail اجازه دهید اطلاعات ورود خودش را تنظیم کند. این اطلاعات می‌تواند ترکیبی از آدرس ایمیل یا نام کاربری همراه با password یا API key باشد.

بعد از پیکربندی پلاگین Defect، گزینه ارسال یک defect جدید در منوی Defect from Anywhere و همچنین در پنجره Add Result داخل یک test run نمایش داده می‌شود. این پنجره به شما امکان می‌دهد بدون خروج از TestRail، یک issue جدید در Bugzilla ایجاد کنید.

پس از اضافه شدن test result، با نگه داشتن نشانگر ماوس روی case ID، پنجره‌ای باز می‌شود که اطلاعات مفید و جزئیات وضعیت مربوط به آن مورد در Bugzilla را نشان می‌دهد.

سفارشی‌سازی‌ها #

پلاگین defect مربوط به Bugzilla برای کار با پیکربندی استاندارد Bugzilla ساخته شده است. TestRail به شما اجازه می‌دهد فیلدهایی را که هنگام نگه داشتن نشانگر ماوس روی Defect ID نمایش داده می‌شوند، سفارشی کنید. فیلدهای hover از پیش پیکربندی‌شده را می‌توان در بخش [hover.fields] مربوط به خودشان روی «on» یا «off» تنظیم کرد. همچنین می‌توانید با جابه‌جا کردن فیلدها در هر بخش، ترتیب نمایش آن‌ها را تغییر دهید.

توجه داشته باشید بعضی فیلدها، مانند فیلد title، همیشه فعال هستند و ممکن است در این بخش‌ها نمایش داده نشوند، چون TestRail یا Bugzilla همیشه به آن‌ها نیاز دارد.

پلاگین Bugzilla Defect علاوه بر custom fields، از تغییر ویژگی‌های فیلدها نیز پشتیبانی می‌کند.

علاوه بر فعال‌سازی، غیرفعال‌سازی یا مرتب‌سازی دوباره فیلدها طبق توضیحات بالا، می‌توانید گزینه‌های بیشتری را برای هر فیلد تغییر دهید. برای این کار، باید بخشی برای آن فیلد تعریف کنید، مانند [hover.field.description]، و گزینه‌های اضافی را داخل همان بخش مشخص کنید.

[hover.field.description]
label=Detailed Description
required=true

فهرست کامل گزینه‌های موجود برای فیلدها و توضیح هرکدام در ادامه آمده است:

[hover.fields]
# ...
description=on
cf_customer=on

سپس بخش [field.settings.<custom_field_name>] را اضافه کنید. این بخش لازم است تا plugin بتواند داده‌ها را به ابزار شما push کند و/یا از آن بازیابی کند. نمونه زیر را ببینید:

[field.settings.cf_customer]
label=Customer
size=compact
type=dropdown
required=true

انواع field زیر پشتیبانی می‌شوند:

Reference Plugin #

از reference plugins می‌توان برای بازیابی اطلاعات بیشتر از IDهایی استفاده کرد که در فیلد References موجودیت‌های TestRail، مانند test case، test run و milestone وارد شده‌اند. Reference Plugin در تب References از تنظیمات integration پیکربندی می‌شود؛ درست مشابه پیکربندی Defect Plugin.

این plugin از hover کردن روی Reference IDها پشتیبانی می‌کند، اما برای فیلد References پنجره Push ندارد. همچنین می‌توانید فیلدهایی را که هنگام hover روی لینک نمایش داده می‌شوند سفارشی کنید و همان‌طور که بالاتر توضیح داده شد، custom fields اضافه کنید.

اگر Defect Plugin را قبلاً برای Bugzilla پیکربندی کرده‌اید، می‌توانید بخش‌های [connection] و [hover.fields] را از Defect Plugin کپی کرده و در پیکربندی Reference Plugin قرار دهید. همچنین می‌توانید برای References و Defects فیلدهای متفاوتی را نمایش دهید.

سفارشی‌سازی‌های بیشتر #

TestRail از custom defect plugins هم پشتیبانی می‌کند. اگر تیم شما از TestRail Server استفاده می‌کند، می‌توانید defect plugin را بیشتر سفارشی کنید یا plugin خودتان را بسازید تا از field typeهای بیشتر یا داده‌های دیگر پشتیبانی کند. برای اطلاعات بیشتر، مستندات ما درباره Custom plugins.