این بخش توضیح میدهد که چطور TestRail را با FogBugz یکپارچه کنید. در حال حاضر چهار روش برای این یکپارچهسازی وجود دارد:
-
استفاده از defect URL برای لینک کردن test resultها به FogBugz
-
استفاده از defect plugin مخصوص FogBugz برای ارسال و جستوجوی caseهای FogBugz
-
استفاده از reference URL برای لینک کردن test caseها به FogBugz
- استفاده از reference plugin مخصوص FogBugz برای جستوجوی issueهای FogBugz در فیلد References موجودیتهای TestRail، مثل test caseها، test runها و milestoneها
لازم نیست از همه گزینههای یکپارچهسازی فهرستشده استفاده کنید؛ میتوانید این یکپارچهسازی را همراه با ابزارهای دیگر هم بهکار ببرید. پیکربندی یکپارچهسازی معمولا فقط چند دقیقه زمان میبرد و این راهنما توضیح میدهد که چطور آن را تنظیم کنید و این قابلیت چطور کار میکند.
Defect URLها #
Defect URLها به TestRail میگویند چطور یک Defect ID را به URL مربوط به FogBugz instance شما تبدیل کند. دو نوع URL وجود دارد: View URL و Add URL.
گزینه Defect View URL برای ساختن لینکی به FogBugz بر اساس Defect ID استفاده میشود؛ بنابراین کافی است روی یک ID کلیک کنید تا issue مستقیما در FogBugz باز شود.
گزینه Defect Add URL برای ساختن لینک به صفحه ایجاد issue در FogBugz استفاده میشود. پس از پیکربندی URL، یک لینک Add کنار فیلد Defect در پنجره Add Test Result و در منوی Defects مربوط به قابلیت Push Defect From Anywhere در TestRail ظاهر میشود. این لینک به شما امکان میدهد برای گزارش یک bug جدید، مستقیم به فرم New Issue در FogBugz بروید.
اگر لینک Add را میبینید، میتوانید ID issue جدید خود در FogBugz را کپی کنید و آن را در هر فیلد Defects یا References داخل TestRail وارد کنید.
میتوانید URLهای FogBugz را در TestRail بهصورت سراسری از مسیر Administration > Integration یا بهصورت جداگانه در تنظیمات هر project پیکربندی کنید. برای تنظیم آدرسها، از URLهای نمونه زیر استفاده کنید:
FogBugz installation
Defect View Url: https://<your-server>/f/cases/%id%
Defect Add Url: http://<your-server>/f/cases/new
حتما مقدار <your-server> را با آدرس FogBugz instance مورد نظر برای یکپارچهسازی جایگزین کنید.
اگر defect plugin را پیکربندی کرده باشید، میتوانید نشانگر ماوس را روی defect ID نگه دارید و جزئیات issue را مستقیما از داخل TestRail ببینید.
Reference URLها #
Reference URLها تقریبا به همان روشی پیادهسازی میشوند که در بخش Defect URLها توضیح داده شد. تفاوت اصلی این است که Reference URLها برای فیلد References در موجودیتهای مختلف TestRail استفاده میشوند، نه برای فیلد Defects.
گزینه Reference View URL به همان روشی که بالاتر توضیح داده شد پیکربندی میشود و به TestRail امکان میدهد بر اساس ID واردشده در فیلد References، یک لینک مستقیم به FogBugz بسازد.
گزینه Reference Add URL هم مانند Defect Add URL پیکربندی میشود. پس از پیکربندی، یک لینک Add کنار هر فیلد References در instance یا project شما نمایش داده میشود. اگر از لینک Add استفاده کنید، میتوانید ID issue جدید خود در FogBugz را کپی کنید و آن را در هر فیلد Defects یا References داخل TestRail وارد کنید.
اگر Reference plugin را پیکربندی کرده باشید، میتوانید نشانگر ماوس را روی Reference ID نگه دارید و جزئیات issue را مستقیما از داخل TestRail ببینید. برای یادگیری نحوه استفاده و پیکربندی Defect Plugin و Reference Plugin، ادامه مطلب را بخوانید.
پلاگین Defect #
از پلاگینهای Defect میتوان برای پیادهسازی یکپارچهسازی عمیقتر با bug tracker استفاده کرد. TestRail همراه با یک پلاگین Defect آماده برای FogBugz ارائه میشود. برای پیکربندی این پلاگین، مسیر Administration > Integration را باز کنید و FogBugz را در فهرست کشویی Defect Plugin انتخاب کنید. مرحله بعد این است که همه تنظیمات لازم اتصال را در بخش [connection] پیکربندی کنید. همچنین میتوانید با ویرایش تنظیمات یک project، این یکپارچهسازی را فقط برای همان project تنظیم کنید.
پلاگین Defect از API FogBugz استفاده میکند، بنابراین برای اتصال به API به اطلاعات ورود معتبر نیاز دارید. میتوانید اینجا یک مجموعه اطلاعات ورود را برای همه کاربران FogBugz وارد کنید، یا از User Variables استفاده کنید تا هر کاربر TestRail بتواند اطلاعات ورود خودش را پیکربندی کند. این اطلاعات ورود میتواند ترکیبی از آدرس ایمیل یا نام کاربری، همراه با رمز عبور یا API key باشد.
#
اکیداً توصیه میکنیم User Variables را پیکربندی کنید. برای آشنایی بیشتر با نحوه پیکربندی آنها، به مستندات User Variables مراجعه کنید.
بعد از پیکربندی پلاگین Defect، گزینه ارسال یک defect جدید در منوی Defect from Anywhere و همچنین در دیالوگ Add Result داخل یک test run نمایش داده میشود. این دیالوگ به شما اجازه میدهد بدون خروج از TestRail یک issue جدید در FogBugz ایجاد کنید.
سفارشیسازیها #
پلاگین Defect مربوط به FogBugz برای کار با پیکربندی استاندارد FogBugz ساخته شده است. TestRail به شما اجازه میدهد فیلدهایی را که در دیالوگ Push نمایش داده میشوند، و همچنین فیلدهایی را که هنگام hover روی Defect IDها دیده میشوند، سفارشی کنید. برای فیلدهای از پیش تعریفشده push و hover، میتوانید در بخشهای مربوطه یعنی [push.fields] و [hover.fields] مقدار آنها را روی «on» یا «off» بگذارید، یا با جابهجا کردن فیلدها در هر بخش، ترتیب نمایش آنها را تغییر دهید.
در نظر داشته باشید که برخی فیلدها، مثل فیلد title، همیشه فعال هستند و ممکن است در این بخشها نمایش داده نشوند، چون TestRail یا FogBugz همیشه به آنها نیاز دارد.
پلاگین Defect مربوط به FogBugz همچنین از تغییر ویژگیهای فیلدها و custom fieldها پشتیبانی میکند.
علاوه بر فعالکردن، غیرفعالکردن یا مرتبسازی دوباره فیلدها طبق توضیح بالا، میتوانید گزینههای بیشتری را برای هر فیلد تغییر دهید. برای این کار، باید برای فیلد موردنظر یک بخش تعریف کنید، مثل [push.field.description]، و گزینههای اضافی را داخل همان بخش مشخص کنید.
[push.field.description]
label=Detailed Description
required=trueدر ادامه، فهرست کامل گزینههای فیلد و توضیح هرکدام آمده است:
| گزینه | توضیح |
|---|---|
| label | نامی را مشخص میکند که این فیلد با آن در دیالوگ Push Defect نمایش داده میشود (برای custom fieldها الزامی است) |
| size | مشخص میکند این فیلد بهصورت یک فیلد فشرده نمایش داده شود (compact) یا تمام عرض دیالوگ را بگیرد (full) |
| remember | مشخص میکند مقادیری که قبلاً برای این فیلد انتخاب شدهاند، هنگام باز شدن بعدی دیالوگ Push Defect به خاطر سپرده و دوباره بازیابی شوند یا نه |
| required | مشخص میکند این فیلد اجباری است یا اختیاری، و آیا کاربران باید در دیالوگ Push Defect برای آن مقدار وارد کنند یا نه |
پلاگین Reference #
از پلاگینهای Reference میتوان برای دریافت اطلاعات بیشتر از IDهایی استفاده کرد که در فیلد References موجودیتهای TestRail، مثل test caseها، test runها و milestoneها وارد شدهاند. پلاگین Reference در تب References از تنظیمات integration پیکربندی میشود؛ روش پیکربندی آن همان روش پیکربندی پلاگین Defect است.
این plugin از نمایش اطلاعات با بردن نشانگر ماوس روی Reference ID پشتیبانی میکند، اما برای فیلد References از Push dialog پشتیبانی نمیکند. همچنین، همانطور که بالاتر توضیح داده شد، میتوانید فیلدهایی را که هنگام hover روی لینک نمایش داده میشوند سفارشی کنید و فیلدهای سفارشی اضافه کنید.
اگر Defect Plugin را از قبل برای FogBugz تنظیم کردهاید، میتوانید بخشهای [connection] و [hover.fields] را از تنظیمات Defect Plugin کپی کرده و در تنظیمات Reference plugin قرار دهید. همچنین میتوانید فیلدهای متفاوتی را برای نمایش در References و Defects انتخاب کنید.
پیوستها #
FogBugz Defect Plugin از ارسال پیوست به FogBugz هم پشتیبانی میکند. این فیلد را میتوان فعال یا غیرفعال کرد، اما قابل سفارشیسازی نیست. برای ارسال یک یا چند پیوست به FogBugz، کافی است فایل پیوست را روی بخش attachments یا description در push dialog بکشید، یا روی همان بخش کلیک کنید و فایل را از سیستم خود انتخاب کنید.
سفارشیسازیهای بیشتر #
TestRail از defect pluginهای سفارشی هم پشتیبانی میکند. اگر تیم شما از TestRail Server استفاده میکند، میتوانید defect plugin را بیشتر سفارشی کنید، یا plugin خودتان را بسازید، تا از نوعهای فیلد بیشتر یا دادههای دیگر پشتیبانی کند. برای اطلاعات بیشتر، مستندات ما دربارهٔ پلاگینهای سفارشی را ببینید.
