در این بخش، نحوه یکپارچه‌سازی TestRail با Lighthouse توضیح داده می‌شود. در حال حاضر برای یکپارچه‌سازی TestRail با Lighthouse دو روش وجود دارد:
- استفاده از defect URLs برای لینک کردن نتایج تست به Lighthouse
- استفاده از reference URLs برای لینک کردن test caseها به Lighthouse
- استفاده از defect plugin برای Lighthouse، برای push کردن و جستجوی issueهای Lighthouse در فیلد Defects مربوط به نتایج تست
- استفاده از reference plugin برای Lighthouse، برای جستجوی issueهای Lighthouse در فیلد References موجودیت‌های TestRail مانند test caseها، test runها و milestoneها
لازم نیست از همه گزینه‌های یکپارچه‌سازی که در اینجا آمده‌اند استفاده کنید؛ می‌توانید این یکپارچه‌سازی را با ابزارهای دیگر هم ترکیب کنید. تنظیم این یکپارچه‌سازی معمولاً فقط چند دقیقه زمان می‌برد و این راهنما توضیح می‌دهد چطور آن را تنظیم کنید و چگونه کار می‌کند.
Defect URLs
از defect URLs استفاده می‌شود تا TestRail بداند چطور یک Defect ID را به URL مربوط به نمونه Lighthouse شما تبدیل کند. دو نوع URL وجود دارد: View URLs و Add URLs.
از Defect View URL برای ساختن لینکی به Lighthouse بر اساس Defect ID استفاده می‌شود؛ بنابراین می‌توانید به‌سادگی روی یک ID کلیک کنید تا issue مستقیماً در Lighthouse باز شود.
از Defect Add URL برای ایجاد لینک به صفحه ساخت issue در Lighthouse استفاده می‌شود. پس از تنظیم URL، یک لینک Add جدید کنار فیلد Defects در پنجره Add Test Result و در منوی Defects قابلیت Push Defect From Anywhere در TestRail نمایش داده می‌شود. این لینک شما را به فرم New Issue در Lighthouse می‌برد تا بتوانید یک bug جدید گزارش کنید.
اگر لینک Add را می‌بینید، می‌توانید ID issue جدید خود در Lighthouse را کپی کنید و آن را در هر فیلد Defects یا References داخل TestRail وارد کنید.
برای تنظیم URLهای Lighthouse در TestRail، به مسیر Admin > Integration بروید. همچنین می‌توانید برای هر project، URLهای جداگانه bug tracker را از مسیر Admin > Projects وارد کنید. برای تنظیم آدرس‌ها از URLهای نمونه زیر استفاده کنید:
Lighthouse Hosted
Defect View Url: http://name.lighthouseapp.com/projects/<projectid>/tickets/%id%
Defect Add Url: http://name.lighthouseapp.com/projects/<projectid>/tickets/newحتماً مقدار <name> و <project ID> را با نام واقعی سایت و Project ID واقعی در Lighthouse که می‌خواهید با آن یکپارچه شوید جایگزین کنید.
اگر defect plugin را تنظیم کرده باشید، می‌توانید نشانگر را روی defect ID ببرید و جزئیات issue را مستقیماً از داخل TestRail ببینید.
Reference URLs
Reference URLs تقریباً به همان روشی پیاده‌سازی می‌شوند که برای Defect URLs در بالا توضیح داده شد. تفاوت اصلی این است که Reference URLs برای فیلد References در موجودیت‌های مختلف TestRail استفاده می‌شوند، نه برای فیلد Defects.
Reference View URL به همان روشی که در بالا توضیح داده شد تنظیم می‌شود و به TestRail اجازه می‌دهد بر اساس ID واردشده در فیلد References، یک لینک مستقیم به Lighthouse ایجاد کند.
Reference Add URL نیز به همان روش Defect Add URL تنظیم می‌شود. پس از تنظیم، یک لینک «Add» کنار هر فیلد References در instance یا project شما نمایش داده می‌شود. اگر از لینک «Add» استفاده کنید، می‌توانید issue ID جدید Lighthouse را کپی کنید و آن را در هر فیلد Defects یا References داخل TestRail وارد کنید.
اگر پلاگین Reference را تنظیم کرده باشید، می‌توانید ماوس را روی یک Reference ID نگه دارید تا جزئیات issue را مستقیم داخل TestRail ببینید. در ادامه، نحوه استفاده و تنظیم Defect Plugin و Reference Plugin را توضیح می‌دهیم.
Defect Plugin
از Defect Pluginها می‌توان برای ایجاد یکپارچه‌سازی عمیق‌تر با bug tracker استفاده کرد و TestRail یک Defect Plugin آماده برای Lighthouse دارد. برای تنظیم Defect Plugin، به مسیر Admin > Integration بروید و Lighthouse را از فهرست کشویی Defect Plugin انتخاب کنید. سپس همه تنظیمات لازم برای اتصال را در فیلد Configuration وارد کنید. در صورت نیاز، pluginها و تنظیمات مخصوص هر project را هم می‌توانید در بخش Admin > Projects مشخص کنید.
بعد از تنظیم Defect Plugin، یک لینک جدید Push کنار فیلد Defects در پنجره Add Test Result نمایش داده می‌شود. با کلیک روی این لینک، یک پنجره popup باز می‌شود تا بتوانید بدون خروج از TestRail، گزارش bug را به Lighthouse ارسال کنید.
بعد از اضافه شدن test result، اگر نشانگر ماوس را روی issue ID نگه دارید، پنجره‌ای باز می‌شود که اطلاعات مفید و جزئیات وضعیت issue را در Lighthouse نشان می‌دهد.
سفارشی‌سازی‌ها
Defect Plugin مربوط به Lighthouse برای کار با تنظیمات استاندارد Lighthouse ساخته شده است. TestRail به شما اجازه می‌دهد فیلدهایی را که در پنجره Push نمایش داده می‌شوند، و همچنین فیلدهایی را که هنگام نگه داشتن ماوس روی Defect IDها دیده می‌شوند، سفارشی کنید. فیلدهای آماده push و hover را می‌توانید در بخش‌های [push.fields] و [hover.fields] روی on یا off بگذارید، یا با جابه‌جا کردن فیلدها در هر بخش، ترتیب نمایش آن‌ها را تغییر دهید.
دقت کنید بعضی فیلدها، مثل title، همیشه فعال هستند و ممکن است در این بخش‌ها نمایش داده نشوند، چون TestRail یا Lighthouse همیشه به آن‌ها نیاز دارد.
Defect Plugin مربوط به Lighthouse از تغییر ویژگی‌های فیلدها هم پشتیبانی می‌کند.
علاوه بر فعال‌کردن، غیرفعال‌کردن یا مرتب‌سازی دوباره فیلدها که بالاتر توضیح داده شد، می‌توانید گزینه‌های بیشتری را برای هر فیلد تغییر دهید. برای این کار، برای آن فیلد یک بخش تعریف کنید، مثل [push.field.description]، و گزینه‌های اضافی را داخل همان بخش مشخص کنید.
[push.field.description]
label=Detailed Description
required=trueفهرست کامل گزینه‌های قابل استفاده برای فیلدها و توضیح هرکدام را در ادامه ببینید:
| Option | Description |
|---|---|
| label | نام نمایشی فیلد را در پنجره Push Defect مشخص می‌کند |
| size | مشخص می‌کند که فیلد به شکل فشرده نمایش داده شود (compact) یا از تمام عرض پنجره استفاده کند (full) |
| remember | مشخص می‌کند مقادیر قبلی انتخاب‌شده برای این فیلد ذخیره شوند و دفعه بعد که پنجره Push Defect باز می‌شود، دوباره بازیابی شوند یا نه |
| الزامی | مشخص می‌کند این فیلد اجباری است یا اختیاری، و آیا کاربران باید در پنجره Push Defect برای آن مقدار وارد کنند یا نه. |
پیوست‌ها
Defect Plugin مربوط به Lighthouse از ارسال پیوست به Lighthouse هم پشتیبانی می‌کند. این فیلد را می‌توانید روشن یا خاموش کنید، اما قابل سفارشی‌سازی نیست. برای ارسال یک یا چند پیوست به Lighthouse، کافی است فایل پیوست را به بخش Attachments یا Description در پنجره push بکشید، یا روی همان بخش کلیک کنید و فایل را از سیستم خود انتخاب کنید.
Reference Plugin
از Reference pluginها می‌توان برای دریافت اطلاعات بیشتر از IDهایی استفاده کرد که در فیلد References آیتم‌های TestRail، مثل test case، test run و milestone وارد می‌شوند. Reference Plugin در تب References از تنظیمات integration، به همان روشی پیکربندی می‌شود که Defect Plugin را پیکربندی می‌کنید.
این plugin از نمایش اطلاعات هنگام hover روی Reference IDها پشتیبانی می‌کند، اما برای فیلد References پنجره Push ندارد. همچنین همان‌طور که بالاتر توضیح داده شد، می‌توانید فیلدهایی را که هنگام hover روی لینک نمایش داده می‌شوند سفارشی کنید.
اگر Defect Plugin را از قبل برای Lighthouse پیکربندی کرده‌اید، کافی است بخش‌های [connection] و [hover.fields] را از Defect Plugin در پیکربندی Reference Plugin کپی کنید. یا می‌توانید برای References و Defects فیلدهای متفاوتی را برای نمایش انتخاب کنید.