این بخش توضیح میدهد که چطور TestRail را با Pivotal Tracker یکپارچه کنید. در حال حاضر سه روش برای این یکپارچهسازی وجود دارد:
- استفاده از Defect URLها برای لینک کردن test resultها به Pivotal Tracker
- استفاده از Reference URLها برای لینک کردن test caseها به Pivotal Tracker
- استفاده از Defect plugin مخصوص Pivotal Tracker برای ارسال و جستجوی issueهای Pivotal Tracker در فیلد Defects مربوط به test resultها
- استفاده از Reference plugin مخصوص Pivotal Tracker برای جستجوی issueهای Pivotal Tracker در فیلد References موجودیتهای TestRail، مانند test caseها، test runها و milestoneها
لازم نیست از همه گزینههای یکپارچهسازی استفاده کنید؛ میتوانید این گزینهها را با ابزارهای دیگر هم ترکیب کنید. پیکربندی این یکپارچهسازی معمولا فقط چند دقیقه زمان میبرد. این راهنما توضیح میدهد که چطور آن را پیکربندی کنید و این یکپارچهسازی چطور کار میکند.
Defect URLها #
Defect URLها به TestRail میگویند که چطور یک Defect ID را به URL مربوط به نمونه Pivotal Tracker شما تبدیل کند. دو نوع URL وجود دارد: View URL و Add URL.
گزینه Defect View URL برای ساختن لینک به Pivotal Tracker بر اساس Defect ID استفاده میشود؛ بنابراین میتوانید روی یک ID کلیک کنید و issue را مستقیم در Pivotal Tracker باز کنید.
گزینه Defect Add URL برای ساختن لینک به صفحه ایجاد issue در Pivotal Tracker استفاده میشود. بعد از پیکربندی URL، یک لینک Add جدید کنار فیلد Defects در پنجره Add Test Result و در منوی Defects قابلیت Push Defect From Anywhere در TestRail نمایش داده میشود. این لینک به شما امکان میدهد برای گزارش یک bug جدید، مستقیم به فرم New Issue در Pivotal Tracker بروید.
اگر لینک Add را میبینید، میتوانید ID مربوط به issue جدیدتان در Pivotal Tracker را کپی کنید و آن را در هر فیلد Defects یا References داخل TestRail وارد کنید.
برای پیکربندی URLهای Pivotal Tracker در TestRail، به مسیر Administration > Integration بروید. همچنین میتوانید برای هر project، URLهای جداگانه bug tracker را در مسیر Administration > Projects وارد کنید. برای پیکربندی آدرسها از URLهای نمونه زیر استفاده کنید:
Pivotal Tracker
Defect View Url: https://www.pivotaltracker.com/story/show/%id%
Defect Add Url: Can be any Pivotal Tracker URLReference URLها #
Reference URLها تقریبا به همان روشی پیادهسازی میشوند که در بالا برای Defect URLها توضیح داده شد. تفاوت اصلی این است که Reference URLها برای فیلد References در موجودیتهای مختلف TestRail استفاده میشوند، نه برای فیلد Defects.
گزینه Reference View URL به همان روشی که در بالا توضیح داده شد پیکربندی میشود و به TestRail اجازه میدهد بر اساس ID واردشده در فیلد References، یک لینک مستقیم به Pivotal Tracker بسازد.
گزینه Reference Add URL هم به همان روش Defect Add URL پیکربندی میشود. بعد از پیکربندی، یک لینک Add کنار هر فیلد References در instance یا project شما نمایش داده میشود. اگر از لینک Add استفاده کنید، میتوانید ID مربوط به issue جدیدتان در Pivotal Tracker را کپی کنید و آن را در هر فیلد Defects یا References داخل TestRail وارد کنید.
اگر Reference plugin را پیکربندی کرده باشید، میتوانید نشانگر ماوس را روی یک Reference ID نگه دارید و جزئیات issue را مستقیم از داخل TestRail ببینید. در ادامه با نحوه استفاده و پیکربندی Defect plugin و Reference plugin آشنا میشوید.
Defect plugin #
Defect pluginها برای پیادهسازی یکپارچهسازی عمیقتر با bug tracker استفاده میشوند و TestRail یک Defect Plugin آماده برای Pivotal Tracker دارد. برای پیکربندی Defect Plugin، گزینه Administration > Integration را انتخاب کنید و سپس Pivotal Tracker را در فهرست کشویی Defect Plugin انتخاب کنید. در مرحله بعد، باید همه تنظیمات لازم برای اتصال را در فیلد Configuration وارد کنید. در صورت نیاز، میتوانید pluginها و تنظیمات پیکربندی مخصوص هر project را در بخش Administration > Projects مشخص کنید.
بعد از پیکربندی Defect Plugin، یک لینک جدید به نام Push کنار فیلد Defects در پنجره Add Test Result نمایش داده میشود. با کلیک روی این لینک، یک پنجره popup باز میشود که به شما امکان میدهد بدون خروج از TestRail، یک bug report را به Pivotal Tracker ارسال کنید.
پس از اضافه شدن test result، اگر نشانگر ماوس را روی defect ID نگه دارید، پنجرهای باز میشود که اطلاعات مفید و جزئیات وضعیت story در Pivotal Tracker را نشان میدهد.
سفارشیسازیها #
Defect Plugin مربوط به Pivotal Tracker برای کار با پیکربندی استاندارد Pivotal Tracker ساخته شده است. TestRail به شما امکان میدهد فیلدهایی را که در پنجره Push نمایش داده میشوند، و همچنین فیلدهایی را که هنگام نگه داشتن ماوس روی Defect IDها نشان داده میشوند، سفارشی کنید. فیلدهای از پیش پیکربندیشده برای push و hover را میتوانید در بخشهای [push.fields] و [hover.fields] مربوطه روی ‘on’ یا ‘off’ بگذارید، یا ترتیب نمایش آنها را با جابهجا کردن فیلدها در هر بخش تغییر دهید.
توجه داشته باشید که بعضی فیلدها، مانند فیلد title، همیشه فعال هستند و ممکن است در این بخشها نمایش داده نشوند، چون TestRail یا Pivotal Tracker همیشه به آنها نیاز دارد.
Pivotal Tracker Defect Plugin از تغییر ویژگیهای فیلدها نیز پشتیبانی میکند.
علاوه بر فعال کردن، غیرفعال کردن یا مرتبسازی دوباره فیلدها طبق توضیح بالا، میتوانید گزینههای بیشتری را برای هر فیلد تغییر دهید. برای این کار، باید بخشی برای آن فیلد تعریف کنید، مثل [push.field.description]، و گزینههای اضافی را داخل همان بخش مشخص کنید.
[push.field.description]
label=Detailed Description
required=trueبرای مشاهده فهرست کامل گزینههای فیلد و توضیح هرکدام، بخش زیر را ببینید:
| گزینه | توضیحات |
|---|---|
| label | نام نمایشی فیلد را در پنجره Push Defect مشخص میکند. |
| remember | مشخص میکند که آیا مقادیر انتخابشده قبلی برای این فیلد ذخیره شوند و دفعه بعد که پنجره Push Defect باز میشود دوباره نمایش داده شوند یا نه. |
| required | مشخص میکند این فیلد اجباری است یا اختیاری، و آیا کاربران باید در پنجره Push Defect برای این فیلد مقدار وارد کنند یا نه. |
| size | مشخص میکند فیلد بهصورت فشرده نمایش داده شود (compact) یا از عرض کامل پنجره استفاده کند (full) |
پیوستها #
Pivotal Tracker Defect Plugin از ارسال attachment به Pivotal Tracker نیز پشتیبانی میکند. این فیلد را میتوان فعال یا غیرفعال کرد، اما قابل سفارشیسازی نیست. برای ارسال یک یا چند attachment به Pivotal Tracker، کافی است attachment را به بخش attachments یا description در پنجره push بکشید، یا روی آن بخش کلیک کنید و attachment را از file system خود انتخاب کنید.
پلاگین Reference #
از Reference Plugin میتوانید برای دریافت اطلاعات تکمیلی از IDهایی استفاده کنید که در فیلد References موجودیتهای TestRail، مثل test case، test run و milestone وارد شدهاند. این پلاگین در تب References از تنظیمات integration پیکربندی میشود؛ درست مثل پیکربندی Defect Plugin.
این پلاگین از نمایش اطلاعات هنگام قرار دادن نشانگر ماوس روی Reference IDها پشتیبانی میکند، اما برای فیلد References دیالوگ Push ندارد. همچنین میتوانید فیلدهایی را که با hover روی لینک نمایش داده میشوند، طبق توضیحات بالا سفارشی کنید.
اگر Defect Plugin را از قبل برای Pivotal Tracker پیکربندی کردهاید، میتوانید بخشهای [connection] و [hover.fields] را از تنظیمات Defect Plugin کپی کرده و در پیکربندی Reference Plugin قرار دهید. همچنین میتوانید برای References و Defects فیلدهای متفاوتی را برای نمایش انتخاب کنید.
سفارشیسازیهای بیشتر #
TestRail از defect pluginهای سفارشی هم پشتیبانی میکند. اگر تیم شما از TestRail Server استفاده میکند، میتوانید defect plugin را بیشتر سفارشی کنید، یا پلاگین خودتان را بسازید، تا از نوعهای فیلد بیشتر یا دادههای دیگر پشتیبانی کند. برای اطلاعات بیشتر، به مستندات defect pluginها مراجعه کنید.
