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