با Redmine یکپارچه شوید
مدت زمان مطالعه: : 9 دقیقه
این مبحث نحوه ادغام TestRail با Redmine را توضیح می دهد. در حال حاضر سه راه برای ادغام TestRail با Redmine وجود دارد که عبارتند از:
- استفاده از URLهای معیوب برای پیوند دادن نتایج تست به Redmine
- استفاده از افزونه نقص برای Redmine برای فشار دادن و جستجوی Redmine
- استفاده از URLهای مرجع برای پیوند تستکیسها به Redmine
- استفاده از پلاگین مرجع برای Redmine برای جستجوی مشکلات Redmine در قسمت References موجودیتهای TestRail مانند تستکیسها، اجرای تست و نقاط عطف
شما مجبور نیستید از همه گزینه های ادغام فهرست شده استفاده کنید، و می توانید ادغام را با ابزارهای دیگر ترکیب و مطابقت دهید. پیکربندی ادغام معمولاً فقط چند دقیقه طول می کشد. این راهنما نحوه پیکربندی ادغام و نحوه عملکرد آن را توضیح می دهد.
آدرس های اینترنتی نقص #
نشانیهای وب نقص برای اینکه TestRail بداند چگونه شناسه نقص را به URL برای نمونه Redmine شما تبدیل کند، استفاده میشود. دو نوع URL وجود دارد: مشاهده URL ها و Add URLs.
را نشانی وب مشاهده نقص برای ایجاد پیوند به Redmine بر اساس شناسه نقص استفاده می شود، بنابراین می توانید به سادگی روی یک شناسه کلیک کنید تا مشکل را مستقیماً در Redmine باز کنید.
را نقص اضافه کردن URL برای ایجاد پیوند به صفحه ایجاد مشکل در Redmine استفاده می شود. پس از پیکربندی URL، یک پیوند افزودن جدید در کنار فیلد نقص در گفتگوی افزودن نتیجه آزمایش و منوی «نقص» در TestRail ظاهر میشود. نقص را از هر کجا فشار دهید ویژگی این پیوند به شما امکان می دهد برای گزارش یک باگ جدید به فرم New Issue Rednine بروید.
اگر از “افزودن” پیوند، می توانید شناسه شماره جدید Redmine خود را کپی کنید و آن را در هر قسمت Defects یا References در TestRail وارد کنید.
میتوانید URLهای Rednine را در TestRail به صورت سراسری در زیر پیکربندی کنید اداره > یکپارچه سازی یا بر اساس هر پروژه در تنظیمات هر پروژه. برای پیکربندی آدرس ها از URL های مثال زیر استفاده کنید:
Redmine installation
Defect View Url: http://your-server/issues/%id%
Defect Add Url: http://your-server/projects/<projectid>/issues/newURL های مرجع #
URL های مرجع به شیوه ای بسیار شبیه به URL های نقصی که در بالا توضیح داده شد پیاده سازی می شوند. تفاوت اصلی این است که URL های مرجع برای فیلد “مرجع” در موجودیت های مختلف TestRail (به جای قسمت نقص) استفاده می شود.
مرجع مشاهده URL به همان روشی که در بالا توضیح داده شد پیکربندی شده است و به TestRail اجازه می دهد تا یک پیوند مستقیم به Redmine بر اساس شناسه وارد شده در قسمت References ایجاد کند.
مرجع URL را اضافه کنید همچنین به همان روش Defect Add URL پیکربندی شده است. پس از پیکربندی، یک “افزودن” پیوند در کنار هر فیلد References در نمونه یا پروژه شما ظاهر می شود. اگر از “افزودن” پیوند، می توانید شناسه شماره جدید Redmine خود را کپی کنید و آن را در هر قسمت Defects یا References در TestRail وارد کنید.
اگر افزونه Reference را پیکربندی کردهاید، میتوانید ماوس را روی شناسه مرجع نگه دارید تا جزئیات مشکل را مستقیماً از داخل TestRail مشاهده کنید. به خواندن ادامه دهید تا نحوه استفاده و پیکربندی افزونه های نقص و مرجع را بیاموزید.
افزونه نقص #
پلاگین های نقص را می توان برای پیاده سازی یک ادغام ردیاب اشکال عمیق تر استفاده کرد و TestRail با یک افزونه نقص Redmine آماده برای استفاده ارائه می شود.
برای پیکربندی افزونه نقص، را انتخاب کنید اداره > یکپارچه سازی و انتخاب کنید Redmine در افزونه نقص لیست کشویی گام بعدی این است که تمام تنظیمات اتصال لازم را در قسمت پیکربندی کنید پیکربندی زمینه پلاگین های خاص پروژه و تنظیمات پیکربندی را می توان به صورت اختیاری در زیر مشخص کرد اداره > پروژه ها.
وقتی افزونه نقص پیکربندی شد، یک پلاگین جدید فشار دهید پیوند در کنار فیلد Defects در گفتگوی Add Test Result نشان داده شده است. با کلیک بر روی پیوند، یک پنجره بازشو باز می شود که به شما امکان می دهد بدون خروج از TestRail، گزارش اشکال را به Redmine ارسال کنید. هنگامی که نتیجه آزمایش اضافه شد، با نگه داشتن نشانگر ماوس روی شناسه مشکل، پنجره ای با اطلاعات مفید و جزئیات وضعیت مربوط به مشکل در Redmine باز می شود.
لطفا توجه داشته باشید: ابتدا باید REST را فعال کنید API در Redmine تحت اداره > تنظیمات > احراز هویت > سرویس وب REST را فعال کنید برای استفاده از ادغام پلاگین نقص.
حالت میراث #
اگر از نسخه Redmine استفاده می کنید زیر ۱.۳، سپس باید حالت قدیمی افزونه نقص را فعال کنید و دسته بندی ها و ردیاب های پروژه خود را به صورت دستی پیکربندی کنید. دلیل این امر این است که نسخههای قدیمیتر Redmine هیچ کدام را نداشتند API روش هایی برای بازیابی لیستی از دسته ها و ردیاب ها، بنابراین باید این جزئیات را یک بار در TestRail پیکربندی کنید (یا به سادگی Redmine را ارتقا دهید). برای انجام این کار، با افزودن عبارت، حالت قدیمی را فعال کنید میراث گزینه به اتصال بخش در کادر پیکربندی افزونه نقص (زیر اداره > یکپارچه سازی):
[connection]
# ...
mode=legacyسپس باید ردیابها و دستههای پروژه خود را نیز با افزودن بخشهای زیر به کادر پیکربندی افزونه نقص اضافه کنید:
; tracker_id=tracker_name
[trackers]
1=Defect
2=Requirement
3=Support
# (etc...)
; project_id.category_id=category_name
[categories]
1.1=User Interface
1.2=Backend
1.3=Documentationمطمئن شوید که دقیقاً از همان قالبی که در بالا مشخص شده است استفاده کنید. برای دسته ها، باید آن را مشخص کنید شناسه پروژه و شناسه دسته به عنوان کلید برای هر ورودی.
سفارشی سازی ها #
پلاگین نقص Redmine برای کار با پیکربندی استاندارد Redmine ساخته شده است. TestRail به شما امکان میدهد فیلدهایی را که در کادر محاورهای Push ظاهر میشوند و همچنین هنگام نگه داشتن ماوس روی شناسههای نقص سفارشی کنید. فیلدهای فشار از پیش پیکربندی شده و فیلدهای شناور را می توان در بخش های [push.fields] و [hover.fields] مربوطه روی «روشن» یا «خاموش» تنظیم کرد یا ترتیب ظاهر شدن آنها را بر اساس فیلدهای هر بخش تغییر داد.
لطفاً به خاطر داشته باشید که برخی از فیلدها (مانند فیلد عنوان) همیشه فعال هستند و ممکن است در این بخش ها ظاهر نشوند به دلیل وجود همیشه مورد نیاز TestRail یا Redmine.
پلاگین نقص Redmine همچنین از اصلاح ویژگی های فیلد و همچنین فیلدهای سفارشی پشتیبانی می کند.
علاوه بر فعال کردن، غیرفعال کردن یا سازماندهی مجدد فیلدها همانطور که در بالا توضیح داده شد، امکان تغییر گزینه های اضافی در هر فیلد نیز وجود دارد. برای انجام این کار، باید یک بخش مانند [push.field.description] برای فیلد تعریف کنید و گزینه های اضافی را در این بخش مشخص کنید.
[push.field.description]
label=Detailed Description
required=trueلطفاً برای لیست کامل و توضیح گزینه های فیلد موجود به زیر مراجعه کنید:
| گزینه | توضیحات |
|---|---|
| برچسب | نام نمایش فیلد را در گفتگوی Push Defect مشخص می کند (برای فیلدهای سفارشی لازم است) |
| اندازه | مشخص می کند که آیا فیلد به صورت یک فیلد فشرده نمایش داده می شود یا خیر (فشرده) یا از تمام عرض دیالوگ استفاده می کند (کامل) |
| به یاد داشته باشید | مشخص می کند که آیا مقادیر انتخاب شده قبلی برای این فیلد باید در دفعه بعد که گفتگوی Push Defect باز می شود به خاطر بسپارند و بازیابی شوند. |
| مورد نیاز است | اجباری یا اختیاری بودن این فیلد را مشخص میکند و آیا کاربران باید مقداری را برای این فیلد در گفتگوی Push Defect وارد کنند. |
| نوع | نوع این فیلد را مشخص می کند، لطفاً برای لیستی از انواع فیلدهای پشتیبانی شده، بخش فیلدهای سفارشی را در زیر ببینید (الزامی برای فیلدهای سفارشی) |
فیلدهای سفارشی #
همچنین می توانید از رویکرد فوق برای افزودن فیلدهای سفارشی به گفتگوی Push Defect TestRail استفاده کنید. برای انجام این کار، کافی است یک خط با فیلد سفارشی خود به بخش [push.fields] اضافه کنید تا یک فیلد اضافه شود. فیلدهای سفارشی توسط سفارشی_<شناسه>.
[push.fields]
# ...
description=on
customfield_11002=onفیلدهای سفارشی توسط سفارشی_<شناسه>. سپس، یک [field.settings.customfield_ را اضافه کنید<شناسه>] بخش. این بخش مورد نیاز است تا افزونه بتواند داده ها را از ابزار شما فشار دهد و/یا بازیابی کند. نمونه زیر است:
[field.settings.customfield_<field_name>]
label=Customer
size=compact
type=dropdown
required=trueانواع فیلدهای زیر پشتیبانی می شوند:
| نوع فیلد | توضیحات |
|---|---|
| کشویی | یک لیست کشویی که به کاربران امکان می دهد یکی از چندین گزینه را انتخاب کنند |
| چند انتخابی | به کاربران امکان می دهد چندین گزینه از پیش تعریف شده را انتخاب کنند |
| رشته | یک فیلد متن آزاد کوچک با حداکثر ۲۵۰ کاراکتر |
| متن | یک فیلد متن آزاد بزرگ بدون محدودیت اندازه عملی |
پیوست ها #
افزونه نقص Redmine از ارسال پیوستها به Redmine نیز پشتیبانی میکند. این فیلد را می توان روشن و خاموش کرد، اما نمی توان آن را سفارشی کرد. برای ارسال یک یا چند پیوست به Redmine، به سادگی پیوست را به پیوستها یا قسمتهای توضیحات کادر محاوره فشار دهید یا روی ناحیه کلیک کنید تا یک پیوست از سیستم فایل خود انتخاب کنید.
پلاگین مرجع #
پلاگین های مرجع را می توان برای بازیابی اطلاعات اضافی از شناسه های وارد شده در قسمت References موجودیت های TestRail، مانند تستکیسها، اجرای تست و نقاط عطف استفاده کرد. پلاگین مرجع در تب مراجع تنظیمات یکپارچه سازی پیکربندی شده است، به همین ترتیب، افزونه نقص پیکربندی شده است.
این افزونه از شناور شدن روی شناسه های مرجع پشتیبانی می کند اما از یک گفتگوی فشاری برای فیلد مراجع پشتیبانی نمی کند. همچنین میتوان فیلدهایی را که از طریق شناور کردن پیوند ظاهر میشوند سفارشی کرد و فیلدهای سفارشی را همانطور که در بالا توضیح داد اضافه کرد.
اگر افزونه Defect را قبلاً برای Redmine پیکربندی کردهاید، میتوانید به سادگی بخشهای [connection] و [hover.fields] خود را از افزونه Defect در پیکربندی پلاگین Reference کپی کنید. همچنین، میتوانید فیلدهای مختلفی را برای نمایش References و Defects انتخاب کنید.
سفارشی سازی های اضافی #
TestRail همچنین از افزونه های نقص سفارشی پشتیبانی می کند. اگر تیم شما از TestRail Server استفاده میکند، میتوانید افزونه نقص را بیشتر سفارشی کنید (یا خودتان بسازید) تا از انواع فیلدهای اضافی یا دادههای دیگر پشتیبانی کند. لطفا ما را ببینید نقص اسناد پلاگین برای اطلاعات بیشتر
