با YouTrack یکپارچه شوید
مدت زمان مطالعه: : 9 دقیقه
TestRail با YouTrack ادغام میشود تا تیم شما بتواند مشکلات بین TestRail و YouTrack را بهعنوان باگ/نقایص، الزامات/مرجع یا هر دو پیوند، مشاهده، اضافه و فشار دهد.
ادغام TestRail با YouTrack از هر چهار روش ادغام TestRail با ردیابهای مشکل، نقص و الزامات پشتیبانی میکند:
- استفاده از نشانیهای وب معیوب برای پیوند دادن نتایج تست به YouTrack
- استفاده از افزونه نقص برای YouTrack برای فشار دادن و نگه داشتن ماوس روی مسائل YouTrack
- استفاده از نشانیهای اینترنتی مرجع برای پیوند تستکیسها به YouTube
- استفاده از پلاگین مرجع برای YouTrack برای جستجوی مشکلات YouTrack در قسمت مراجع موجودیت های TestRail مانند تستکیسها، اجرای تست و نقاط عطف
شما مجبور نیستید از همه گزینه های ادغام فهرست شده استفاده کنید، و می توانید ادغام را با ابزارهای دیگر ترکیب و مطابقت دهید. پیکربندی ادغام معمولاً فقط چند دقیقه طول می کشد.
شما می توانید اطلاعات بیشتری در مورد مرجع و ادغام نقص TestRail در قسمت پیدا کنید مقدمه ای بر مرجع و راهنمای ادغام نقص.
پیکربندی عیوب #
آدرس های اینترنتی نقص #
نشانیهای وب نقص برای اینکه TestRail بداند چگونه شناسه نقص را به یک URL برای نمونه YouTrack شما تبدیل کند، استفاده میشود. دو نوع URL وجود دارد: مشاهده URL ها و Add URLs.
را نشانی وب مشاهده نقص برای ایجاد پیوند به YouTrack بر اساس شناسه نقص استفاده میشود، بنابراین میتوانید به سادگی روی یک شناسه کلیک کنید تا مشکل را مستقیماً در YouTrack باز کنید.
را نقص اضافه کردن URL برای ایجاد پیوند به صفحه ایجاد مشکل در داخل YouTrack استفاده می شود. پس از پیکربندی URL، یک پیوند افزودن جدید در کنار فیلد نقص در گفتگوی افزودن نتیجه آزمایش و منوی «نقص» در TestRail ظاهر میشود. نقص از هر کجا ویژگی این پیوند به شما امکان می دهد برای گزارش یک اشکال جدید به فرم New Issue YouTrack بروید:
نقص را اضافه کنید پیوند در گفتگوی «افزودن نتیجه»
نقص را اضافه کنید پیوند در “نقص” از هر کجا
اگر می بینید اضافه کنید پیوند، می توانید شناسه شماره جدید YouTrack خود را کپی کنید و آن را در هر قسمت نقص یا مرجع در TestRail وارد کنید.
برای پیکربندی URL های نقص YouTrack در TestRail، را انتخاب کنید مدیر > یکپارچه سازی. همچنین میتوانید URLهای ردیاب اشکال جداگانه را برای هر پروژه در زیر وارد کنید مدیر > پروژه ها. برای پیکربندی آدرس ها از URL های مثال زیر استفاده کنید:
YouTrack installation
Defect View Url: https://<your-server>/youtrack/issue/%id%
Defect Add Url: https://<your-server>/youtrack/newIssue?#
لطفا حتما تعویض کنید <your_server> با آدرس واقعی نمونه YouTrack که می خواهید با آن یکپارچه شوید.
مثال:
نام سرور است shabu.myjetbrains.com.
نشانی وب مشاهده نقص: https://shabu.myjetbrains.com/%id%
نقص افزودن آدرس اینترنتی: https://shabu.myjetbrains.com/youtrack/newIssue؟
URL های نقص در TestRail چگونه به نظر می رسند:
علاوه بر این، اگر افزونه نقص را پیکربندی کردهاید، میتوانید روی شناسه نقص نگه دارید تا جزئیات مشکل را مستقیماً از داخل TestRail مشاهده کنید.
پلاگین نقص #
پلاگین های نقص را می توان برای پیاده سازی ادغام ردیاب اشکال عمیق تر استفاده کرد و TestRail با یک پلاگین آماده برای استفاده نقص YouTrack ارائه می شود.
برای پیکربندی افزونه نقص، را انتخاب کنید مدیر > یکپارچه سازی و انتخاب کنید YouTrack در افزونه نقص لیست کشویی گام بعدی این است که تمام تنظیمات اتصال لازم را در قسمت پیکربندی کنید پیکربندی زمینه پلاگین های خاص پروژه و تنظیمات پیکربندی را می توان به صورت اختیاری در زیر مشخص کرد مدیر > پروژه ها.
#
TestRail به استفاده از متغیرهای کاربر برای ذخیره رمز عبور ایمن و رمز نیاز دارد. شما می توانید در مورد پیکربندی این موارد در ما بیشتر بیاموزید مستندات متغیرهای کاربر.
وقتی افزونه نقص پیکربندی شد، یک پلاگین جدید فشار دهید پیوند در کنار فیلد Defects در نشان داده شده است اضافه کردن نتیجه تست گفتگو با کلیک بر روی پیوند، یک گفتگوی بازشو باز می شود که به شما امکان می دهد بدون خروج از TestRail، گزارش اشکال را به YouTrack ارسال کنید.
هنگامی که نتیجه آزمایش اضافه شد، با نگه داشتن نشانگر ماوس روی شناسه مشکل، پنجره ای با اطلاعات مفید و جزئیات وضعیت در مورد مشکل در YouTube باز می شود.
#
سفارشیسازی افزونهها به پلاگینهای مرجع و نقص YouTrack20191 نیاز دارد که با TestRail ۶.۵ و بالاتر در دسترس است.
نقص سفارشی سازی پلاگین #
افزونه نقص YouTrack برای کار با پیکربندی استاندارد YouTrack ساخته شده است. TestRail به شما امکان میدهد فیلدهایی را که در کادر محاورهای Push ظاهر میشوند و همچنین هنگام نگه داشتن ماوس روی شناسههای نقص سفارشی کنید. فیلدهای فشاری از پیش پیکربندی شده و فیلدهای شناور را میتوان روی «روشن» یا «خاموش» تنظیم کرد. [push.fields] و [hover.fields] بخش ها، یا ترتیب ظاهر شدن آنها را بر اساس فیلدهای هر بخش تغییر دهید.
لطفاً به خاطر داشته باشید که برخی از فیلدها (مانند فیلد عنوان) همیشه فعال هستند و ممکن است در این بخش ها ظاهر نشوند به دلیل وجود همیشه مورد نیاز TestRail یا YouTrack.
افزونه نقص YouTrack همچنین از اصلاح خصوصیات فیلد و همچنین فیلدهای سفارشی پشتیبانی می کند.
علاوه بر فعال کردن، غیرفعال کردن یا سازماندهی مجدد فیلدها همانطور که در بالا توضیح داده شد، امکان تغییر گزینه های اضافی در هر فیلد نیز وجود دارد. برای انجام این کار، یک بخش برای فیلد تعریف می کنید، مانند [push.field.description] و گزینه های اضافی را در این قسمت مشخص کنید.
[push.field.description]
label=Detailed Description
required=trueلطفاً برای لیست کامل و توضیح گزینه های فیلد موجود به زیر مراجعه کنید:
| گزینه | توضیحات |
|---|---|
| api_type | نوع داده های فیلد بازگردانده شده توسط YouTrack API را مشخص می کند. می تواند باشد تاریخ، عدد صحیح یا شناور. اگر نوع روی تاریخ، عدد صحیح یا شناور تنظیم شده باشد، مقدار api_type باید روی یکسان تنظیم شود. (برای فیلدهای سفارشی زمانی که نوع «تاریخ»، «عدد صحیح» یا «شناور» است، لازم است) |
| برچسب | نام نمایش فیلد را در گفتگوی Push Defect مشخص می کند (برای فیلدهای سفارشی لازم است) |
| اندازه | مشخص می کند که آیا فیلد به صورت یک فیلد فشرده نمایش داده می شود یا خیر (فشرده) یا از تمام عرض دیالوگ استفاده می کند (کامل) |
| به یاد داشته باشید | مشخص می کند که آیا مقادیر انتخاب شده قبلی برای این فیلد باید در دفعه بعد که گفتگوی Push Defect باز می شود به خاطر بسپارند و بازیابی شوند. |
| مورد نیاز است | اجباری یا اختیاری بودن این فیلد را مشخص میکند و آیا کاربران باید مقداری را برای این فیلد در گفتگوی Push Defect وارد کنند. |
| نوع | نوع این فیلد را مشخص می کند، لطفاً برای لیستی از انواع فیلدهای پشتیبانی شده، بخش فیلدهای سفارشی را در زیر ببینید (الزامی برای فیلدهای سفارشی) |
فیلدهای سفارشی #
همچنین می توانید از رویکرد فوق برای افزودن فیلدهای سفارشی به گفتگوی Push Defect TestRail استفاده کنید. برای انجام این کار، به سادگی یک خط با فیلد دلخواه خود به آن اضافه کنید [push.fields] بخش برای افزودن یک فیلد فیلدهای سفارشی توسط سفارشی_<فیلد_نام>.
[push.fields]
...
description=on
customfield_customer=onسپس، a را اضافه کنید [field.settings.customfield_<field_name>] بخش این بخش مورد نیاز است تا افزونه بتواند داده ها را از ابزار شما فشار دهد و/یا بازیابی کند. در زیر نمونه ای از پیکربندی فیلد سفارشی آمده است:
[field.settings.customfield_customer]
label=Customer
size=compact
type=dropdown
required=trueانواع فیلدهای زیر پشتیبانی می شوند:
| نوع فیلد | توضیحات |
|---|---|
| تاریخ | یک فیلد رشته ای که مقدار تاریخ YYYY-MM-DD یا ساختار مشابهی را می پذیرد. قالب بندی ممکن است به نیازهای ابزار یکپارچه بستگی داشته باشد |
| کشویی | یک لیست کشویی که به کاربران امکان می دهد یکی از چندین گزینه را انتخاب کنند |
| شناور | یک مقدار عددی، با یا بدون اعشار |
| عدد صحیح | یک عدد کامل حداکثر مقدار بر اساس محدودیت های ابزار خارجی شما است |
| چند انتخابی | به کاربران امکان می دهد چندین گزینه از پیش تعریف شده را انتخاب کنند |
| رشته | یک فیلد متن آزاد کوچک با حداکثر ۲۵۰ کاراکتر |
| متن | یک فیلد متن آزاد بزرگ بدون محدودیت اندازه عملی |
پیوست ها #
افزونه نقص YouTrack از ارسال پیوست ها به YouTrack نیز پشتیبانی می کند. این فیلد را می توان روشن و خاموش کرد، اما نمی توان آن را سفارشی کرد. برای ارسال یک یا چند پیوست به YouTrack، به سادگی پیوست را به پیوستها یا قسمتهای توضیحات کادر گفتگوی فشار بکشید یا روی ناحیه کلیک کنید تا یک پیوست از سیستم فایل خود انتخاب کنید.
پیکربندی مراجع #
URL های مرجع #
URL های مرجع به شیوه ای بسیار شبیه به URL های نقصی که در بالا توضیح داده شد پیاده سازی می شوند. تفاوت اصلی این است که از URL های مرجع برای استفاده استفاده می شود مراجع فیلد در موجودیت های مختلف TestRail (به جای قسمت Defects).
را نشانی وب مشاهده مرجع به همان روشی که در بالا توضیح داده شد پیکربندی شده است و به TestRail اجازه می دهد تا یک پیوند مستقیم به یک YouTrack بر اساس شناسه وارد شده در قسمت References ایجاد کند.
را مرجع اضافه کردن URL همچنین به همان روش Defect Add URL پیکربندی شده است. پس از پیکربندی، یک اضافه کنید پیوند در کنار هر فیلد References در نمونه یا پروژه شما ظاهر می شود. اگر از اضافه کنید پیوند، می توانید شناسه شماره جدید YouTrack خود را کپی کنید و آن را در هر قسمت نقص یا مرجع در TestRail وارد کنید:
اضافه کنید پیوند مراجع در یک تستکیس
برای پیکربندی URL های مرجع YouTrack در TestRail، را انتخاب کنید مدیر > یکپارچه سازی. همچنین میتوانید URLهای ردیاب اشکال جداگانه را برای هر پروژه در زیر وارد کنید مدیر > پروژه ها. برای پیکربندی آدرس ها از URL های مثال زیر استفاده کنید:
YouTrack installation
Reference View Url: https://<your-server>/youtrack/issue/%id%
Reference Add Url: https://<your-server>/youtrack/newIssue?#
لطفا حتما تعویض کنید <your_server> با آدرس واقعی نمونه YouTrack که می خواهید با آن یکپارچه شوید.
مثال:
در اینجا، نام سرور است shabu.myjetbrains.com.
URL مشاهده مرجع: https://shabu.myjetbrains.com/%id%
مرجع اضافه کردن URL: https://shabu.myjetbrains.com/youtrack/newIssue؟
در اینجا URL های مرجع در TestRail به نظر می رسد:
اگر افزونه Reference را پیکربندی کردهاید، میتوانید ماوس را روی شناسه مرجع نگه دارید تا جزئیات مشکل را مستقیماً از داخل TestRail مشاهده کنید. به خواندن ادامه دهید تا نحوه استفاده و پیکربندی افزونه های نقص و مرجع را بیاموزید.
پلاگین مرجع #
پلاگین های مرجع را می توان برای بازیابی اطلاعات اضافی از شناسه های وارد شده در قسمت References موجودیت های TestRail، مانند تستکیسها، اجرای تست و نقاط عطف استفاده کرد. پلاگین مرجع در تب مراجع تنظیمات یکپارچه سازی پیکربندی شده است، به همین ترتیب، افزونه نقص پیکربندی شده است.
برای پیکربندی پلاگین مرجع، را انتخاب کنید مدیر > یکپارچه سازی و انتخاب کنید YouTrack در لیست کشویی پلاگین مرجع. مرحله بعدی پیکربندی تمام تنظیمات اتصال لازم در [اتصال] دسته بندی همچنین می توانید با ویرایش تنظیمات پروژه، ادغام را برای یک پروژه خاص پیکربندی کنید.
اگر افزونه Defect را قبلاً برای YouTrack پیکربندی کردهاید، میتوانید به سادگی آن را کپی کنید [connection] و [hover.fields] بخش هایی از افزونه نقص به پیکربندی پلاگین مرجع. همچنین، میتوانید فیلدهای مختلفی را برای نمایش References و Defects انتخاب کنید.
#
پلاگین مرجع از شناور شدن روی شناسه های مرجع پشتیبانی می کند اما از گفتگوی فشاری برای فیلد مراجع پشتیبانی نمی کند.
همچنین میتوانید فیلدهایی را که از طریق شناور کردن پیوند ظاهر میشوند سفارشی کنید و فیلدهای سفارشی را اضافه کنید، همانطور که در بخش سفارشیسازی پلاگین نقص توضیح داده شده است.
هنگامی که تنظیمات اتصال ذخیره شدند، اکنون باید بتوانید روی شناسه مشکل YouTrack در TestRail “مانوس” کنید.
برای اطلاعات بیشتر، لطفا ما را ببینید مستندات پلاگین های مرجع.
سفارشی سازی های ادغام اضافی #
TestRail همچنین از افزونه های نقص سفارشی پشتیبانی می کند. اگر تیم شما از TestRail Server استفاده میکند، میتوانید افزونه نقص را بیشتر سفارشی کنید (یا خودتان بسازید) تا از انواع فیلدهای اضافی یا دادههای دیگر پشتیبانی کند. برای اطلاعات بیشتر، لطفاً به مستندات ما در مورد مراجعه کنید پلاگین های سفارشی.
