ادغام با مانتیس
مدت زمان مطالعه: : 9 دقیقه
این مبحث نحوه ادغام TestRail با Mantis را توضیح می دهد. در حال حاضر چهار راه برای ادغام TestRail با Mantis وجود دارد که عبارتند از:
- استفاده از آدرسهای اینترنتی معیوب برای پیوند دادن نتایج تست به Mantis
- استفاده از افزونه نقص برای Mantis برای بررسی و جستجوی مشکلات Mantis
- استفاده از URLهای مرجع برای پیوند تستکیسها به Mantis
- استفاده از پلاگین مرجع برای Mantis برای جستجوی مسائل Mantis در قسمت References موجودیت های TestRail مانند تستکیسها، اجرای تست و نقاط عطف
شما مجبور نیستید از همه گزینه های ادغام فهرست شده استفاده کنید، و می توانید ادغام را با ابزارهای دیگر ترکیب و مطابقت دهید. پیکربندی ادغام معمولاً فقط چند دقیقه طول می کشد. این راهنما نحوه پیکربندی ادغام و نحوه عملکرد آن را توضیح می دهد.
شما همچنین می توانید یک راهنمای ادغام را در مورد پیدا کنید وب سایت MantisHub در اینجا.
آدرس های اینترنتی نقص #
نشانیهای وب نقص برای اینکه TestRail بداند چگونه شناسه نقص را به URL برای نمونه Mantis خود تبدیل کند، استفاده میشود. دو نوع URL وجود دارد: مشاهده URL ها و Add URLs.
را نشانی وب مشاهده نقص برای ایجاد پیوند به Mantis بر اساس شناسه نقص استفاده می شود، بنابراین می توانید به سادگی روی یک شناسه کلیک کنید تا موضوع به طور مستقیم در Mantis باز شود.
را نقص اضافه کردن URL برای ایجاد پیوند به صفحه ایجاد مشکل در Mantis استفاده می شود. پس از پیکربندی URL، یک پیوند افزودن جدید در کنار فیلد نقص در گفتگوی افزودن نتیجه آزمایش و منوی «نقص» در TestRail ظاهر میشود. نقص را از هر کجا فشار دهید ویژگی این پیوند به شما امکان می دهد برای گزارش یک باگ جدید به فرم New Issue Mantis بروید.
اگر می بینید “افزودن” پیوند، می توانید شناسه شماره جدید Mantis خود را کپی کنید و آن را در هر قسمت Defects یا References در TestRail وارد کنید.
شما می توانید URL های Mantis را در TestRail به صورت جهانی در زیر پیکربندی کنید اداره > ادغام یا بر اساس هر پروژه در تنظیمات هر پروژه.
برای پیکربندی آدرس ها از URL های مثال زیر استفاده کنید:
Mantis installation
Defect View Url: http://<your-server>/mantis/view.php?id=%id%
Defect Add Url: http://<your-server>/mantis/bug_report_page.phpلطفا حتما تعویض کنید <سرور شما> با URL سرور Mantis که می خواهید با آن یکپارچه شوید.
اگر افزونه نقص را پیکربندی کردهاید، میتوانید روی شناسه نقص نگه دارید تا جزئیات مشکل را مستقیماً از داخل TestRail مشاهده کنید.
URL های مرجع #
URL های مرجع به شیوه ای بسیار شبیه به URL های نقصی که در بالا توضیح داده شد پیاده سازی می شوند. تفاوت اصلی این است که URL های مرجع برای فیلد “مرجع” در موجودیت های مختلف TestRail (به جای قسمت نقص) استفاده می شود.
مرجع مشاهده URL به همان روشی که در بالا توضیح داده شد پیکربندی شده است و به TestRail اجازه می دهد تا یک پیوند مستقیم به Mantis بر اساس شناسه وارد شده در یک فیلد References ایجاد کند.
مرجع URL را اضافه کنید همچنین به همان روش Defect Add URL پیکربندی شده است. پس از پیکربندی، یک “افزودن” پیوند در کنار هر فیلد References در نمونه یا پروژه شما ظاهر می شود. اگر از “افزودن” پیوند، می توانید شناسه شماره جدید Mantis خود را کپی کنید و آن را در هر قسمت Defects یا References در TestRail وارد کنید.
اگر افزونه Reference را پیکربندی کردهاید، میتوانید ماوس را روی شناسه مرجع نگه دارید تا جزئیات مشکل را مستقیماً از داخل TestRail مشاهده کنید. به خواندن ادامه دهید تا نحوه استفاده و پیکربندی افزونه های نقص و مرجع را بیاموزید.
Mantis installation
Reference View Url: http://your-server/mantis/view.php?id=%id%
Reference Add Url: http://your-server/mantis/bug_report_page.phpافزونه نقص #
پلاگین های نقص را می توان برای پیاده سازی ادغام ردیاب اشکال عمیق تر استفاده کرد و TestRail با یک افزونه نقص Mantis آماده استفاده ارائه می شود. برای پیکربندی افزونه نقص، را انتخاب کنید اداره > یکپارچه سازی و انتخاب کنید آخوندک در افزونه نقص لیست کشویی گام بعدی این است که تمام تنظیمات اتصال لازم را در قسمت پیکربندی کنید [اتصال] دسته بندی همچنین می توانید با ویرایش تنظیمات پروژه، ادغام را برای یک پروژه خاص پیکربندی کنید.
افزونه Defect از API Mantis استفاده می کند، بنابراین برای اتصال به API به اعتبارنامه های معتبر نیاز است. در اینجا میتوانید یک مجموعه از اعتبارنامهها را برای همه کاربران Mantis وارد کنید. یا می توانید متغیرهای کاربر را وارد کنید تا به هر کاربر TestRail اجازه دهید اعتبار خود را پیکربندی کند. این اعتبار ممکن است ترکیبی از آدرس ایمیل یا نام کاربری با رمز عبور یا کلید API باشد.
#
ما قویاً توصیه می کنیم که متغیرهای کاربر را پیکربندی کنید. شما می توانید در مورد پیکربندی این موارد در ما بیشتر بیاموزید مستندات متغیرهای کاربر
با پیکربندی افزونه نقص، گزینه فشار دادن یک نقص جدید در آن ظاهر می شود نقص از هر کجا منو، و همچنین در گفتگوی افزودن نتیجه در یک اجرای تست. این گفتگو به شما امکان می دهد بدون خروج از TestRail یک شماره جدید در Mantis ایجاد کنید.
هنگامی که نتیجه آزمایش اضافه شد، با نگه داشتن نشانگر ماوس روی شناسه مورد، پنجره ای با اطلاعات مفید و جزئیات وضعیت در مورد پرونده در Mantis باز می شود.
#
سفارشیسازی پلاگین به افزونه نقص و مرجع «Mantis_REST» نیاز دارد که با TestRail ۶.۵ و نسخههای جدیدتر موجود است.
سفارشی سازی ها #
افزونه نقص Mantis برای کار با پیکربندی استاندارد Mantis ساخته شده است. TestRail به شما امکان میدهد فیلدهایی را که در کادر محاورهای Push ظاهر میشوند و همچنین هنگام نگه داشتن ماوس روی شناسههای نقص سفارشی کنید. فیلدهای فشار از پیش پیکربندی شده و فیلدهای شناور را می توان در بخش های [push.fields] و [hover.fields] مربوطه روی «روشن» یا «خاموش» تنظیم کرد یا ترتیب ظاهر شدن آنها را بر اساس فیلدهای هر بخش تغییر داد.
لطفاً به خاطر داشته باشید که برخی از فیلدها (مانند فیلد عنوان) همیشه فعال هستند و ممکن است به دلیل وجود همیشه مورد نیاز TestRail یا Mantis در این بخش ها ظاهر نشوند.
افزونه Mantis Defect همچنین از اصلاح خصوصیات فیلد و همچنین فیلدهای سفارشی پشتیبانی می کند.
علاوه بر فعال کردن، غیرفعال کردن یا سازماندهی مجدد فیلدها همانطور که در بالا توضیح داده شد، امکان تغییر گزینه های اضافی در هر فیلد نیز وجود دارد. برای انجام این کار، باید یک بخش مانند [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_ را اضافه کنید<شناسه>] بخش. این بخش مورد نیاز است تا افزونه بتواند داده ها را از ابزار شما فشار دهد و/یا بازیابی کند.
اطلاعات فیلد سفارشی را می توان از طریق درخواست پروژه های GET، همانطور که در مستندات MantisHub API توضیح داده شده است، به دست آورد. اینجا. در زیر نمونه ای از پیکربندی فیلد سفارشی آمده است:
[field.settings.customfield_<id>]
label=Customer
size=compact
type=dropdown
required=trueانواع فیلدهای زیر پشتیبانی می شوند:
| نوع فیلد | توضیحات |
|---|---|
| تاریخ | یک فیلد رشته ای که مقدار تاریخ YYYY-MM-DD یا ساختار مشابهی را می پذیرد. قالب بندی ممکن است به نیازهای ابزار یکپارچه بستگی داشته باشد |
| تاریخ | یک فیلد رشتهای که مقدار ساعت و ساعت YYYY-MM-DD HH:MM یا ساختار مشابهی را میپذیرد. قالب بندی ممکن است به نیازهای ابزار یکپارچه بستگی داشته باشد |
| کشویی | یک لیست کشویی که به کاربران امکان می دهد یکی از چندین گزینه را انتخاب کنند |
| رشته | یک فیلد متن آزاد کوچک با حداکثر ۲۵۰ کاراکتر |
| متن | یک فیلد متن آزاد بزرگ بدون محدودیت اندازه عملی |
پیوست ها #
افزونه Mantis Defect از ارسال پیوست ها به Mantis نیز پشتیبانی می کند. این فیلد را می توان روشن و خاموش کرد، اما نمی توان آن را سفارشی کرد. برای ارسال یک یا چند پیوست به Mantis، به سادگی پیوست را به پیوستها یا قسمتهای توضیحات کادر محاوره فشار دهید یا روی ناحیه کلیک کنید تا یک پیوست از سیستم فایل خود انتخاب کنید.
پلاگین مرجع #
پلاگین های مرجع را می توان برای بازیابی اطلاعات اضافی از شناسه های وارد شده در قسمت References موجودیت های TestRail، مانند تستکیسها، اجرای تست و نقاط عطف استفاده کرد. پلاگین مرجع در تب مراجع تنظیمات یکپارچه سازی پیکربندی شده است، به همین ترتیب، افزونه نقص پیکربندی شده است.
این افزونه از شناور شدن روی شناسه های مرجع پشتیبانی می کند اما از یک گفتگوی فشاری برای فیلد مراجع پشتیبانی نمی کند. همچنین میتوان فیلدهایی را که از طریق شناور کردن پیوند ظاهر میشوند سفارشی کرد و فیلدهای سفارشی را همانطور که در بالا توضیح داد اضافه کرد.
اگر افزونه Defect را قبلاً برای Mantis پیکربندی کردهاید، میتوانید به سادگی بخشهای [connection] و [hover.fields] خود را از افزونه Defect در پیکربندی پلاگین Reference کپی کنید. همچنین، میتوانید فیلدهای مختلفی را برای نمایش References و Defects انتخاب کنید.
سفارشی سازی های اضافی #
TestRail همچنین از افزونه های نقص سفارشی پشتیبانی می کند. اگر تیم شما از TestRail Server استفاده میکند، میتوانید افزونه نقص را بیشتر سفارشی کنید (یا خودتان بسازید) تا از انواع فیلدهای اضافی یا دادههای دیگر پشتیبانی کند. لطفا ما را ببینید نقص اسناد پلاگین برای اطلاعات بیشتر
