برای پیادهسازی یکپارچهسازی عمیقتر با bug tracker میتوانید از defect pluginها استفاده کنید. TestRail یک defect plugin آماده استفاده برای Axosoft هم دارد.
#
defect plugin مربوط به Axosoft که در این مقاله توضیح داده شده، از Axosoft REST API استفاده میکند. استفاده از این API را برای Axosoft نسخه ۱۳ یا بالاتر، از جمله OnTime Now، پیشنهاد میکنیم. اگر از Axosoft OnTime نسخه ۱۲ یا پایینتر استفاده میکنید، لطفاً از Axosoft OnTime SOAP defect plugin استفاده کنید.
برای پیکربندی defect plugin، به Administration > Integration بروید؛ سپس Axosoft_v17_REST را از فهرست Defect Plugin انتخاب کنید.
در مرحله بعد، همه تنظیمات لازم برای اتصال را در فیلد Configuration وارد و پیکربندی کنید. در صورت نیاز، میتوانید pluginها و تنظیمات مخصوص هر project را هم در بخش Administration > Projects مشخص کنید.
ممکن است لازم باشد ابتدا API را در Axosoft فعال کنید. برای این کار:
- در Axosoft، به Tools > System Settings > Axosoft API Settings
- در همان صفحه API را فعال کنید
- در همان صفحه API keyها را بسازید
مقدارهای لازم برای client ID و همچنین client secret که برای پیکربندی این یکپارچهسازی نیاز دارید، در همان صفحه نمایش داده میشوند.
بعد از پیکربندی defect plugin، یک لینک جدید با عنوان Push در کنار فیلد Defects در پنجره Add Test Result نمایش داده میشود. با کلیک روی این لینک، یک پنجره popup باز میشود که به شما اجازه میدهد بدون خارج شدن از TestRail، یک گزارش bug را به Axosoft ارسال کنید.
بعد از اضافه شدن test result، اگر نشانگر ماوس را روی defect ID نگه دارید، پنجرهای باز میشود که اطلاعات مفید و جزئیات وضعیت آن defect را در Axosoft نشان میدهد.
#
Axosoft دیگر از ایجاد defect پشتیبانی نمیکند، چون اکنون همه Work Itemها در پلتفرم Axosoft معادل Feature هستند.
اگر همچنان میخواهید از این plugin برای ارسال featureها به Axosoft استفاده کنید، پیشنهاد میکنیم یک workflow step اضافی با نامی مثل “bug”، “defect” یا هر نامگذاری مناسب تیم خودتان ایجاد کنید. در این workflow step، مقدار Work Item Type باید روی “Bug (Issue)” تنظیم شود. همچنین در تنظیمات Allowed Next Steps مربوط به workflow step جدید، همه Next Stepهای مجاز برای bugها/defectها را انتخاب کنید، یا در صورت نیاز stepهای جدید بسازید.
دفعه بعد که میخواهید یک Work Item را به Axosoft ارسال کنید، به یاد داشته باشید فیلد کشویی Workflow Step را روی stepی تنظیم کنید که در بالا ساختهاید. با این workaround، میتوانید همچنان از defect plugin برای ایجاد Work Itemهایی از نوع Bug (Issue) در Axosoft استفاده کنید.
#
برای سفارشیسازی plugin، به Defect and Reference plugin با نام ‘Axosoft_v17_REST’ نیاز دارید که در TestRail ۶.۵ و نسخههای بعد از آن در دسترس است.
سفارشیسازیها #
افزونه Defect مربوط به Axosoft برای کار با تنظیمات استاندارد Axosoft ساخته شده است. TestRail به شما امکان میدهد فیلدهایی را که در دیالوگ Push نمایش داده میشوند، و همچنین فیلدهایی را که هنگام hover روی Defect IDها دیده میشوند، سفارشی کنید. فیلدهای push و hover ازپیشتعریفشده را میتوانید در بخشهای مربوط به خودشان، یعنی [push.fields] و [hover.fields]، روی «on» یا «off» بگذارید، یا با جابهجا کردن فیلدها در هر بخش، ترتیب نمایش آنها را تغییر دهید.
به خاطر داشته باشید بعضی فیلدها، مثل فیلد title، همیشه فعالاند و ممکن است در این بخشها دیده نشوند؛ چون TestRail یا Axosoft همیشه به آنها نیاز دارد.
Axosoft Defect Plugin از تغییر ویژگیهای فیلدها و همچنین custom fieldها پشتیبانی میکند.
علاوه بر فعال کردن، غیرفعال کردن یا مرتبسازی دوباره فیلدها که در بالا توضیح داده شد، میتوانید گزینههای اضافی هر فیلد را هم تغییر دهید. برای این کار، برای آن فیلد یک بخش تعریف کنید، مثل [push.field.description]، و گزینههای اضافی را داخل همان بخش وارد کنید.
[push.field.description]
label=Detailed Description
required=trueدر ادامه فهرست کامل گزینههای فیلد و توضیح هرکدام آمده است:
| گزینه | توضیح |
|---|---|
| label | نام نمایشی فیلد را در دیالوگ Push Defect مشخص میکند (برای custom fieldها الزامی است) |
| size | مشخص میکند فیلد بهصورت compact نمایش داده شود (compact) یا از تمام عرض دیالوگ استفاده کند (full) |
| remember | مشخص میکند مقدارهایی که قبلاً برای این فیلد انتخاب شدهاند، ذخیره شوند و دفعه بعد که دیالوگ Push Defect باز میشود دوباره نمایش داده شوند یا نه |
| required | مشخص میکند این فیلد اجباری است یا اختیاری، و آیا کاربر باید در دیالوگ Push Defect مقداری برای آن وارد کند یا نه |
| type | نوع این فیلد را مشخص میکند. برای دیدن فهرست typeهای پشتیبانیشده، بخش Custom fields را در ادامه ببینید (برای custom fieldها الزامی است) |
فیلدهای سفارشی #
میتوانید با همین روش، custom fieldها را هم به دیالوگ Push Defect در TestRail اضافه کنید. برای این کار کافی است برای افزودن فیلد، یک خط شامل custom field خودتان به بخش [push.fields] اضافه کنید. custom fieldها با این قالب مشخص میشوند: customfield_<id>.
[push.fields]
...
description=on
customfield_11002=onسپس یک بخش با نام [field.settings.custom_<id>] اضافه کنید. این بخش لازم است تا plugin بتواند دادهها را به ابزار شما ارسال کند و/یا از آن دریافت کند.
Custom Field IDها را میتوانید از طریق Axosoft API.
نمونه زیر یک پیکربندی custom field را نشان میدهد:
[field.settings.customfield_11002]
label=Customer
size=compact
type=dropdown
required=trueانواع فیلد زیر پشتیبانی میشوند:
| نوع فیلد | توضیح |
|---|---|
| bool | یک منوی dropdown بله/خیر برای مقدارهای دوتایی مثل True/False، Yes/No یا موارد مشابه |
| تاریخ | یک فیلد متنی که مقدار تاریخ را با قالب YYYY-MM-DD یا ساختاری مشابه میپذیرد. قالببندی ممکن است به نیازهای ابزار یکپارچهشده بستگی داشته باشد. |
| منوی کشویی | یک فهرست کشویی که به کاربر اجازه میدهد یکی از چند گزینه موجود را انتخاب کند. |
| چندانتخابی | به کاربران اجازه میدهد چند گزینه از پیش تعریفشده را انتخاب کنند. |
| رشته | یک فیلد کوتاه برای وارد کردن متن آزاد تا ۲۵۰ کاراکتر. |
| متن | یک فیلد بزرگ برای وارد کردن متن آزاد، بدون محدودیت عملی از نظر اندازه. |
پیوستها #
Defect Plugin مربوط به Axosoft از ارسال پیوستها به Axosoft نیز پشتیبانی میکند. این فیلد را میتوان فعال یا غیرفعال کرد، اما قابل سفارشیسازی نیست. برای ارسال یک یا چند پیوست به Axosoft، کافی است فایل را به بخش attachments یا description در push dialog بکشید، یا روی همان بخش کلیک کنید و پیوست را از فایلهای سیستم خود انتخاب کنید.
Reference plugin #
از Reference plugin میتوان برای دریافت اطلاعات بیشتر بر اساس IDهایی استفاده کرد که در فیلد References موجودیتهای TestRail، مانند test case، test run و milestone وارد شدهاند. Reference Plugin در تب References از تنظیمات integration، به همان روشی پیکربندی میشود که Defect Plugin پیکربندی میشود.
این plugin از نمایش اطلاعات هنگام نگهداشتن نشانگر ماوس روی Reference IDها پشتیبانی میکند، اما برای فیلد References از Push dialog پشتیبانی نمیکند. همچنین میتوانید فیلدهایی را که هنگام hover روی لینک نمایش داده میشوند سفارشی کنید و همانطور که بالاتر توضیح داده شد، custom field اضافه کنید.
اگر Defect Plugin را از قبل برای Axosoft پیکربندی کردهاید، میتوانید بخشهای [connection] و [hover.fields] را از پیکربندی Defect Plugin به پیکربندی Reference plugin کپی کنید. همچنین میتوانید انتخاب کنید که فیلدهای متفاوتی برای References و Defects نمایش داده شوند.
سفارشیسازیهای بیشتر #
TestRail از custom defect plugin نیز پشتیبانی میکند. اگر تیم شما از TestRail Server استفاده میکند، میتوانید Defect Plugin را بیشتر سفارشی کنید، یا plugin خودتان را بسازید، تا از انواع فیلدهای بیشتر یا دادههای دیگر پشتیبانی کند. لطفاً برای اطلاعات بیشتر به مستندات Custom Plugins مراجعه کنید.
