این بخش توضیح میدهد چطور TestRail را با Rally یکپارچه کنید. در حال حاضر چهار روش برای یکپارچهسازی TestRail با Rally وجود دارد:
- استفاده از URLهای Defect برای لینک کردن test resultها به Rally
- استفاده از URLهای Reference برای لینک کردن test caseها به Rally
- استفاده از defect plugin مخصوص Rally برای ارسال و جستجوی issueهای Rally در فیلد Defects مربوط به test resultها
- استفاده از reference plugin مخصوص Rally برای جستجوی issueهای Rally در فیلد References موجودیتهای TestRail مثل test case، test run و milestone
لازم نیست از همه گزینههای یکپارچهسازی استفاده کنید؛ میتوانید این روشها را با ابزارهای دیگر هم ترکیب کنید. تنظیم این یکپارچهسازی معمولاً فقط چند دقیقه زمان میبرد. این راهنما توضیح میدهد چطور آن را تنظیم کنید و این قابلیت چگونه کار میکند.
URLهای Defect #
URLهای Defect به TestRail میگویند که چطور یک Defect ID را به URL مربوط به instance شما در Rally تبدیل کند. دو نوع URL وجود دارد: View URL و Add URL.
گزینه Defect View URL برای ساختن لینک به Rally بر اساس Defect ID استفاده میشود؛ بنابراین کافی است روی یک ID کلیک کنید تا issue مستقیماً در Rally باز شود.
گزینه Defect Add URL برای ایجاد لینک به صفحه ساخت issue در Rally استفاده میشود. بعد از تنظیم URL، یک لینک Add جدید کنار فیلد Defects در پنجره Add Test Result و در منوی Defects مربوط به قابلیت Push Defect From Anywhere در TestRail نمایش داده میشود. با این لینک میتوانید برای گزارش یک bug جدید، مستقیم به فرم New Issue در Rally بروید.
اگر از لینک Add استفاده کنید، میتوانید ID issue جدید خود در Rally را کپی کنید و آن را در هر فیلد Defects یا References داخل TestRail وارد کنید.
میتوانید URLهای Rally را در TestRail بهصورت سراسری از مسیر Administration > Integration یا برای هر project بهصورت جداگانه از تنظیمات همان project پیکربندی کنید. برای تنظیم آدرسها از URLهای نمونه زیر استفاده کنید:
Rally Installation
Defect View URL:https://rally1.rallydev.com/#/search?keywords=%id%
Defect Add URL:https://rally1.rallydev.com/#/dashboard?detail=%2Fdefect%2Fnew&fdp=trueلطفاً حتماً rally1.rallydev.com را با URL واقعی instance مربوط به Rally که میخواهید با آن یکپارچه شوید جایگزین کنید.
اگر defect plugin را تنظیم کرده باشید، میتوانید نشانگر ماوس را روی Defect ID نگه دارید و جزئیات issue را مستقیماً از داخل TestRail ببینید.
URLهای Reference #
URLهای Reference تقریباً به همان روشی پیادهسازی میشوند که برای URLهای Defect در بالا توضیح داده شد. تفاوت اصلی این است که URLهای Reference برای فیلد References در موجودیتهای مختلف TestRail استفاده میشوند، نه برای فیلد Defects.
گزینه Reference View URL به همان روشی که در بالا توضیح داده شد پیکربندی میشود و به TestRail اجازه میدهد بر اساس ID واردشده در فیلد References، یک لینک مستقیم به Rally بسازد.
گزینه Reference Add URL هم مانند Defect Add URL پیکربندی میشود. بعد از تنظیم آن، یک لینک Add کنار هر فیلد References در instance یا project شما نمایش داده میشود. اگر از لینک Add استفاده کنید، میتوانید ID issue جدید خود در Rally را کپی کنید و آن را در هر فیلد Defects یا References داخل TestRail وارد کنید.
اگر Reference plugin را تنظیم کرده باشید، میتوانید نشانگر ماوس را روی Reference ID نگه دارید و جزئیات issue را مستقیماً از داخل TestRail ببینید. در ادامه با نحوه استفاده و پیکربندی Defect plugin و Reference plugin آشنا میشوید.
Defect Plugin #
از پلاگینهای defect میتوان برای یکپارچهسازی کامل با سیستم ردیابی باگ استفاده کرد. TestRail یک پلاگین defect آماده برای Rally دارد. برای پیکربندی این پلاگین، به مسیر Administration > Integration بروید و Rally را از فهرست کشویی Defect Plugin انتخاب کنید. در مرحله بعد، همه تنظیمات لازم برای اتصال را پیکربندی کنید. در صورت نیاز، میتوانید پلاگینها و تنظیمات مخصوص هر project را در مسیر Administration > Projects تعریف کنید.
حتماً از workspace ID استفاده کنید، نه نام workspace. Broadcom راهنمای پیدا کردن این ID را در این صفحه ارائه کرده است.
پس از پیکربندی defect plugin، لینک جدید Push کنار فیلد Defects در پنجرهAdd Test Result نمایش داده میشود. با کلیک روی این لینک، یک پنجره popup باز میشود که امکان میدهد بدون خروج از TestRail، گزارش باگ را به Rally بفرستید.
بعد از ثبت نتیجه تست، با نگه داشتن نشانگر ماوس روی یک defect ID، پنجرهای با اطلاعات مفید و جزئیات وضعیت defect در Rally باز میشود.
سفارشیسازیها #
پلاگین defect مربوط به Rally برای کار با پیکربندی استاندارد Rally ساخته شده است. TestRail به شما اجازه میدهد فیلدهایی را که در پنجره Push نمایش داده میشوند و همچنین فیلدهایی را که هنگام hover کردن روی Defect IDها دیده میشوند سفارشی کنید. فیلدهای ازپیشتعریفشده push و hover را میتوان در بخشهای مربوط به [push.fields] و [hover.fields] روی on یا off گذاشت، یا با جابهجا کردن فیلدها در هر بخش، ترتیب نمایش آنها را تغییر داد.
به خاطر داشته باشید بعضی فیلدها، مثل فیلد title، همیشه فعال هستند و ممکن است در این بخشها نمایش داده نشوند، چون TestRail یا Rally همیشه به آنها نیاز دارد.
Rally Defect Plugin از تغییر ویژگیهای فیلدها و همچنین custom fieldها هم پشتیبانی میکند.
علاوه بر فعال کردن، غیرفعال کردن یا مرتبسازی دوباره فیلدها طبق توضیح بالا، میتوانید گزینههای اضافی هر فیلد را هم تغییر دهید. برای این کار، باید برای آن فیلد یک بخش تعریف کنید، مثل [push.field.description]، و گزینههای اضافی را داخل همان بخش مشخص کنید.
[push.field.description]
label=Detailed Description
required=trueفهرست کامل گزینههای قابل استفاده برای فیلدها و توضیح هرکدام در ادامه آمده است:
| گزینه | توضیح |
|---|---|
| label | نام نمایشی فیلد را در پنجره Push Defect مشخص میکند (برای custom fieldها الزامی است) |
| list_type | اگر فیلد از نوع checkbox است، مقدار checkbox را وارد کنید (برای مقادیر True/False). برای پر کردن فهرست کاربران، از user استفاده کنید. اگر فیلد checkbox یا user نیست، آن را خالی بگذارید، مثل list_type=. (اگر نوع custom field برابر dropdown، multiselect یا date باشد، این گزینه الزامی است) |
| size | مشخص میکند فیلد بهصورت compact نمایش داده شود یا نه (خلاصه) یا از تمام عرض پنجره استفاده کند (کامل) |
| بهخاطر بسپار | مشخص میکند آیا مقدارهایی که قبلاً برای این فیلد انتخاب شدهاند، دفعه بعد که پنجره Push Defect باز میشود بهخاطر سپرده و دوباره اعمال شوند یا نه. |
| اجباری | مشخص میکند این فیلد اجباری است یا اختیاری، و آیا کاربران باید در پنجره Push Defect برای این فیلد مقداری وارد کنند یا نه. |
| نوع | نوع این فیلد را مشخص میکند. برای مشاهده فهرست نوعهای پشتیبانیشده، بخش فیلدهای سفارشی را در ادامه ببینید. این گزینه برای فیلدهای سفارشی الزامی است. |
فیلدهای سفارشی #
برای افزودن فیلدهای سفارشی به پنجره Push Defect در TestRail، میتوانید از همین روش استفاده کنید. برای این کار، کافی است برای اضافه کردن فیلد، یک خط شامل فیلد سفارشی خود را به بخش [push.fields] اضافه کنید. فیلدهای سفارشی با این پیشوند مشخص میشوند: c_<field_name>.
[push.fields]
# ...
description=on
c_customer=onسپس یک بخش [field.settings.c_<field_name>] اضافه کنید. این بخش لازم است تا plugin بتواند دادهها را به ابزار شما ارسال کند و/یا از آن دریافت کند.
نمونهای از پیکربندی یک فیلد سفارشی در ادامه آمده است:
[field.settings.c_<field_name>]
label=Customer
size=compact
type=dropdown
required=true
field_name=c_Customerهنگام تنظیم field_name=<…> ، این مقدار باید با ویژگی ElementName فیلد سفارشی که Rally API ارائه میکند مطابقت داشته باشد.
نوعهای فیلد زیر پشتیبانی میشوند:
| نوع فیلد | توضیح |
|---|---|
| date | یک فیلد رشتهای که مقدار تاریخ را با قالب YYYY-MM-DD یا ساختاری مشابه میپذیرد. قالببندی ممکن است به نیازهای ابزار متصلشده بستگی داشته باشد. |
| dropdown | یک فهرست dropdown که به کاربران اجازه میدهد یکی از چند گزینه را انتخاب کنند. |
| multiselect | به کاربران اجازه میدهد چند گزینه از پیش تعریفشده را انتخاب کنند. |
| string | یک فیلد متن آزاد کوچک با حداکثر ۲۵۰ نویسه. |
| text | یک فیلد متن آزاد بزرگ، بدون محدودیت عملی برای اندازه متن. |
پیوستها #
Rally Defect Plugin از ارسال پیوستها به Rally نیز پشتیبانی میکند. این فیلد را میتوان فعال یا غیرفعال کرد، اما قابل سفارشیسازی نیست. برای ارسال یک یا چند پیوست به Rally، کافی است پیوست را به بخش attachments یا description در پنجره Push بکشید، یا روی آن بخش کلیک کنید و پیوست را از سیستم فایل خود انتخاب کنید.
Reference Plugin #
از Reference pluginها میتوان برای دریافت اطلاعات بیشتر بر اساس IDهایی استفاده کرد که در فیلد References موجودیتهای TestRail وارد شدهاند؛ مانند test caseها، test runها و milestoneها. Reference Plugin در تب References از تنظیمات integration پیکربندی میشود، درست مانند پیکربندی Defect Plugin.
این plugin از نمایش اطلاعات هنگام نگه داشتن نشانگر روی Reference IDها پشتیبانی میکند، اما برای فیلد References از Push dialog پشتیبانی نمیکند. همچنین میتوانید فیلدهایی را که با نگه داشتن نشانگر روی link نمایش داده میشوند سفارشی کنید و همانطور که در بالا توضیح داده شد، فیلدهای سفارشی اضافه کنید.
اگر Defect Plugin را قبلاً برای Rally پیکربندی کردهاید، کافی است بخشهای [connection] و [hover.fields] را از Defect Plugin در پیکربندی Reference plugin کپی کنید. همچنین میتوانید فیلدهای متفاوتی را برای نمایش در References و Defects انتخاب کنید.
سفارشیسازیهای بیشتر #
TestRail از defect pluginهای سفارشی هم پشتیبانی میکند. اگر تیم شما از TestRail Server استفاده میکند، میتوانید defect plugin را بیشتر سفارشی کنید یا افزونه خودتان را بسازید تا از نوعهای فیلد بیشتر یا دادههای دیگر پشتیبانی کند. برای جزئیات بیشتر، به مستندات Defect plugin مراجعه کنید.
