ادغام با Azure DevOps

TestRail با Azure DevOps ادغام می شود، بنابراین تیم شما می تواند مشکلات را بین TestRail و Azure DevOps پیوند دهد، مشاهده کند، اضافه کند، و به آنها فشار دهد. اشکال / نقص، الزامات / مراجع، یا هر دو. ادغام TestRail با Azure DevOps از موارد استفاده زیر پشتیبانی می کند:

• موارد آزمون را به الزامات پیوند دهید
• شروع به ایجاد الزامات از TestRail کنید
• مشاهده الزامات در TestRail
• عیوب را به نتایج تست پیوند دهید
• نقص های جدید را در Azure DevOps ارسال کنید
• عیوب جدید را از TestRail ارسال کنید
• مشاهده عیوب در TestRail

لازم نیست از همه گزینه های ادغام فهرست شده استفاده کنید. می توانید ادغام را با ابزارهای دیگر ترکیب و مطابقت دهید. پیکربندی ادغام معمولاً فقط چند دقیقه طول می کشد. این راهنما نحوه پیکربندی ادغام و نحوه عملکرد آن را توضیح می دهد.

موارد آزمون را به الزامات پیوند دهید #

برای تنظیم پوشش آزمایشی، زمانی که در حال ایجاد یا ویرایش تست‌کیس‌ها هستید، به سادگی یک یا چند شناسه مورد کاری (که با کاما از هم جدا شده اند) به آن اضافه کنید. مراجع زمینه 

را مراجع در تست‌کیس‌ها خود تنظیم کرده‌اید به یک پیوند مستقیم به موارد کاری Azure DevOps تبدیل می‌شود.

پیکربندی نشانی وب نمای مرجع #

برای پیوند تست‌کیس‌ها به الزامات، باید Azure DevOps را پیکربندی کنید نشانی وب مشاهده مرجع در TestRail با دنبال کردن مراحل زیر.

1. برو به مدیر صفحه، انتخاب کنید یکپارچه سازی برای پیکربندی جهانی یا پروژه ها برای یک پروژه واحد، و باز کنید مراجع برگه
2. خود را وارد کنید نشانی وب مشاهده مرجع با استفاده از الگوی زیر
   • https://<Azure_DevOps_URL>/<Project>/_workitems/edit/%id%/
3. کلیک کنید تنظیمات را ذخیره کنید 

 

شروع به ایجاد الزامات از TestRail کنید #

TestRail ارائه می دهد اضافه کنید پیوند در نمای ویرایشگر تست‌کیس برای رفتن سریع به صفحه ایجاد آیتم کاری Azure DevOps. این به شما امکان می دهد تا به سرعت نیازهای جدیدی را ایجاد کنید که می خواهید در تست‌کیس‌ها خود ردیابی کنید. توجه داشته باشید که پس از ایجاد آیتم کاری جدید، باید شناسه آن را کپی و در آن پیست کنید مراجع زمینه

پیکربندی آدرس افزودن مرجع #

برای شروع ایجاد الزامات جدید از TestRail، باید Azure DevOps را پیکربندی کنید مرجع اضافه کردن آدرس در TestRail با دنبال کردن مراحل زیر.

1. برو به مدیر صفحه، انتخاب کنید یکپارچه سازی برای پیکربندی جهانی یا پروژه ها برای یک پروژه واحد، و باز کنید مراجع برگه
2. خود را وارد کنید مرجع اضافه کردن آدرس با استفاده از الگوی زیر
   • https://<Azure_DevOps_URL>/<Project>/_workitems/create/issue
3. کلیک کنید تنظیمات را ذخیره کنید 

مشاهده الزامات در TestRail #

TestRail می تواند اطلاعات اضافی را از شناسه های وارد شده در آن بازیابی کند مراجع زمینه موجودیت های TestRail، مانند تست‌کیس‌ها، اجرای تست، و نقاط عطف. به سادگی روی پیوندها بروید و یک گفتگو تمام آخرین اطلاعات را بدون نیاز به حرکت به Azure DevOps به شما نشان می دهد.

پیکربندی پلاگین مرجع #

برای مشاهده مستقیم نیازمندی ها در TestRail، باید Azure DevOps را پیکربندی کنید پلاگین مرجع در TestRail با دنبال کردن مراحل زیر.

1. ایجاد یک متغیر کاربر برای رمز عبور Azure DevOps یا رمز دسترسی شخصی (PAT)
2. برو به مدیر صفحه، انتخاب کنید یکپارچه سازی برای پیکربندی جهانی یا پروژه ها برای یک پروژه واحد، و باز کنید مراجع برگه
3. خود را انتخاب کنید Azure_DevOps_ نوع در پلاگین مرجع لیست کشویی (اگر تیم شما از خدمات Azure DevOps استفاده می کند، CLOUD، اگر تیم شما از سرور Azure DevOps استفاده می کند سرور)
4. تنظیمات اتصال را در [اتصال] بخش
   • آدرس: https://<Azure_DevOps_URL>
   • پروژه: نام پروژه شما
   • کاربر: نام کاربری شما 
   • رمز عبور: شما متغیر کاربر برای رمز عبور Azure DevOps یا رمز دسترسی شخصی (PAT)
5. کلیک کنید تنظیمات را ذخیره کنید 
    

همچنین امکان سفارشی سازی فیلدهایی که از طریق شناور کردن پیوند ظاهر می شوند وجود دارد. اطلاعات بیشتر در مورد نحوه انجام آن را می توانید در قسمت مشاهده کنید سفارشی کردن پلاگین های مورد نیاز/ نقص بخش

افزونه Defect از Azure DevOps API استفاده می کند، بنابراین اعتبارنامه های معتبری برای اتصال به API مورد نیاز است. شما مجبور خواهید بود یک توکن دسترسی شخصی Azure ایجاد کنید با دسترسی کامل یا تعریف شده سفارشی با همه مجوزها برای موارد کار.

عیوب را به نتایج تست پیوند دهید #

را نشانی وب مشاهده نقص برای ایجاد پیوند به Azure DevOps بر اساس Defect ID استفاده می‌شود، بنابراین می‌توانید به سادگی روی یک ID کلیک کنید تا این مشکل مستقیماً در Azure DevOps باز شود.

هنگامی که یکپارچه سازی URL Defect View را با مشکلات Azure DevOps تنظیم می کنید، می توانید شناسه یک مشکل Azure DevOps را در قسمت Defects نتیجه آزمایش جایگذاری کنید و TestRail به طور خودکار آن شناسه را به یک پیوند قابل کلیک تبدیل می کند تا مشکل را در Azure DevOps مشاهده کند. این به تیم شما اجازه می‌دهد تا آزمایش‌ها را با مشکلات Azure DevOps مرتبط کند و گزارش‌های نقص و ردیابی را در TestRail ایجاد کند.

پیکربندی آدرس اینترنتی Defect View #

برای پیوند دادن نقص به نتایج تست در TestRail، باید Azure DevOps را پیکربندی کنید نشانی وب مشاهده نقص در TestRail با دنبال کردن مراحل زیر.

1. برو به مدیر صفحه، انتخاب کنید یکپارچه سازی برای پیکربندی جهانی یا پروژه ها برای یک پروژه واحد، و باز کنید نقص برگه
2. خود را وارد کنید نشانی وب مشاهده نقص با استفاده از الگوی زیر
   • https://<Azure_DevOps_URL>/<Project>/_workitems/edit/%id%/
3. کلیک کنید تنظیمات را ذخیره کنید 

نقص های جدید را در Azure DevOps ارسال کنید #

TestRail با استفاده از رابط Azure DevOps، ناوبری سریع را برای گزارش نقص ها ارائه می دهد. شما می توانید آن را از دو مکان مختلف انجام دهید – منوی نقص و گفتگوی نتیجه آزمایش را اضافه کنید.

را منوی نقص، همچنین به عنوان TestRail’s شناخته می شود نقص از هر کجا ویژگی، برای دسترسی سریع در بالای اکثر صفحات نمایش داده می شود.

را گفتگوی نتیجه آزمایش را اضافه کنید را نشان می دهد لینک اضافه کنید در کنار زمینه نقص برای اینکه به سرعت و به راحتی به DevOps بروید تا در صورت شکست تست، نقصی را ارسال کنید.

توجه داشته باشید که پس از ایجاد نقص در Azure DevOps، باید شناسه مورد کاری را کپی و در آن پیست کنید. نقص فیلد ورودی برای ایجاد قابلیت ردیابی از نتیجه آزمایش شما به Azure DevOps.

پیکربندی Defect Add URL #

برای پیمایش سریع به Azure DevOps برای ایجاد یک نقص جدید، باید Azure DevOps را پیکربندی کنید. آدرس اینترنتی نقص در TestRail با دنبال کردن مراحل زیر.

1. برو به مدیر صفحه، انتخاب کنید یکپارچه سازی برای پیکربندی جهانی یا پروژه ها برای یک پروژه واحد، و باز کنید نقص برگه
2. خود را وارد کنید نقص آدرس URL را اضافه کنید با استفاده از الگوی زیر
   • https://<Azure_DevOps_URL>/<Project>/_workitems/create/issue
3. کلیک کنید تنظیمات را ذخیره کنید 

عیوب جدید را از TestRail ارسال کنید #

برای یکپارچگی عمیق‌تر هنگام گزارش نقص، TestRail با یک افزونه نقص Azure DevOps آماده برای استفاده ارائه می‌شود. این افزونه به شما امکان می دهد بدون خروج از TestRail، مسائل جدید را به Azure DevOps وارد کنید. 

با استفاده از داخلی دیالوگ Push Defect، می توانید به سرعت یک نقص جدید با عنوان، توضیحات و هر فیلد دیگری که توسط Azure DevOps پشتیبانی می شود ایجاد کنید.

می توانید گفتگوی ارسال نقص را از دو مکان باز کنید – منوی نقص و گفتگوی نتیجه آزمایش را اضافه کنید.

را منوی نقص، همچنین به عنوان TestRail’s شناخته می شود نقص از هر کجا ویژگی، برای دسترسی سریع در بالای اکثر صفحات نمایش داده می شود.

را گفتگوی نتیجه آزمایش را اضافه کنید را نشان می دهد پیوند فشاری در کنار زمینه نقص برای گزارش کارآمد نقص در حین ارسال نتایج تست.

پیکربندی افزونه نقص #

برای ارسال عیوب جدید مستقیماً از TestRail، باید Azure DevOps را پیکربندی کنید افزونه نقص در TestRail با دنبال کردن مراحل زیر.

1. ایجاد یک متغیر کاربر برای رمز عبور Azure DevOps یا رمز دسترسی شخصی (PAT)
2. برو به مدیر صفحه، انتخاب کنید یکپارچه سازی برای پیکربندی جهانی یا پروژه ها برای یک پروژه واحد، و باز کنید نقص برگه
3. خود را انتخاب کنید Azure_DevOps_ نوع در افزونه نقص فهرست کشویی (اگر تیم شما از سرویس‌های Azure DevOps استفاده می‌کند، اگر تیم شما از سرور Azure DevOps استفاده می‌کند، SERVER)
4. تنظیمات اتصال را در [اتصال] بخش
   • آدرس: https://<Azure_DevOps_URL>
   • پروژه: نام پروژه شما
   • کاربر: نام کاربری شما 
   • رمز عبور: شما متغیر کاربر برای رمز عبور Azure DevOps یا رمز دسترسی شخصی (PAT)
5. کلیک کنید تنظیمات را ذخیره کنید 

همچنین می توان فیلدهایی را که از طریق شناور کردن پیوند ظاهر می شوند، سفارشی کرد. شما می توانید اطلاعات بیشتر در مورد نحوه انجام آن را در سفارشی کردن پلاگین های مورد نیاز/ نقص بخش

افزونه Defect از Azure DevOps API استفاده می کند، بنابراین اعتبارنامه های معتبری برای اتصال به API مورد نیاز است. شما مجبور خواهید بود یک توکن دسترسی شخصی Azure ایجاد کنید با دسترسی کامل یا تعریف شده سفارشی با همه مجوزها برای موارد کار.

مشاهده عیوب در TestRail #

به سادگی روی پیوندهای نقص حرکت کنید و یک گفتگو تمام آخرین اطلاعات را بدون نیاز به حرکت به Azure DevOps به شما نشان می دهد. این پیوندها مستقیماً در نتایج تست و همچنین بخش نقص در آزمایش‌ها، طرح‌های آزمایشی و نقاط عطف موجود هستند.

پیکربندی افزونه نقص #

برای مشاهده مستقیم اطلاعات نقص در TestRail، باید Azure DevOps را پیکربندی کنید افزونه نقص در TestRail اگر قبلاً تنظیمات را انجام داده اید افزونه نقص برای فشار دادن عیوب به TestRail، باید همه چیز را تنظیم کنید. اگر نه، لطفا مراحل زیر را دنبال کنید.

1. برو به مدیر صفحه، انتخاب کنید یکپارچه سازی برای پیکربندی جهانی یا پروژه ها برای یک پروژه واحد، و باز کنید نقص برگه
2. خود را انتخاب کنید Azure_DevOps_ نوع در افزونه نقص فهرست کشویی (اگر تیم شما از سرویس‌های Azure DevOps استفاده می‌کند، اگر تیم شما از سرور Azure DevOps استفاده می‌کند، SERVER)
3. تنظیمات اتصال را در [اتصال] بخش
   • آدرس: https://<Azure_DevOps_URL>
   • پروژه: نام پروژه شما
   • کاربر: نام کاربری شما 
   • رمز عبور: گذرواژه Azure DevOps یا رمز دسترسی شخصی (PAT) شما
4. کلیک کنید تنظیمات را ذخیره کنید 

همچنین می توان فیلدهایی را که از طریق شناور کردن پیوند ظاهر می شوند، سفارشی کرد. شما می توانید اطلاعات بیشتر در مورد نحوه انجام آن را در سفارشی کردن پلاگین های مورد نیاز/ نقص بخش

افزونه Defect از Azure DevOps API استفاده می کند، بنابراین اعتبارنامه های معتبری برای اتصال به API مورد نیاز است. شما مجبور خواهید بود یک توکن دسترسی شخصی Azure ایجاد کنید با دسترسی کامل یا تعریف شده سفارشی با همه مجوزها برای موارد کار.

سفارشی سازی های پیشرفته #

متغیرهای کاربر #

توصیه می کنیم استفاده کنید متغیرهای کاربر هنگام پیکربندی هر گونه اعتبار یکپارچه سازی. این به شما این امکان را می‌دهد تا اعتبارنامه‌های عمومی را بدون افشای آن‌ها ارائه کنید، و همچنین به کاربران اجازه می‌دهد تا برای کنترل دسترسی بهتر، اعتبارنامه‌های خود را در تنظیمات شخصی‌شان تعریف کنند. در زیر می توانید نمونه ای از نحوه تنظیم متغیرها در پیکربندی خود را مشاهده کنید.

user=%azure_username%
password=%azure_password%

سفارشی کردن پلاگین های مورد نیاز/ نقص #

پلاگین Azure DevOps برای کار با پیکربندی استاندارد Azure DevOps ساخته شده است. TestRail به شما امکان می‌دهد فیلدهایی را که در کادر محاوره‌ای Push ظاهر می‌شوند و همچنین هنگام نگه‌داشتن ماوس روی شناسه‌های مورد کار، هم برای نیازمندی‌ها و هم برای نقص‌ها، سفارشی کنید. فیلدهای فشار از پیش تنظیم شده و فیلدهای شناور را می توان روی آن تنظیم کرد on یا off مربوط به خود [push.fields] و [hover.fields] بخش ها، و همچنین می توانید ترتیب آنها را تغییر دهید، که در UI منعکس می شود.

افزونه نقص Azure DevOps همچنین از اصلاح ویژگی های فیلد و همچنین فیلدهای سفارشی پشتیبانی می کند.

[push.types]
Bug=on
Epic=off
Issue=on
Task=on
UserStory=off

به‌طور پیش‌فرض، این افزونه از انواع موارد تعریف‌شده در بالا پشتیبانی می‌کند و تنها اشکال، مشکل و وظیفه در ابتدا فعال هستند. در Azure DevOps، انواع آیتم‌های مختلف دارای فیلدهای نوع توصیف متفاوتی هستند. به عنوان مثال، یک اشکال در Azure DevOps دارای مراحل بازتولید و فیلدهای اطلاعات سیستم است، در حالی که نوع آیتم Issue از فیلد توضیحات استفاده می کند. این سه نوع فیلد را می توان بر اساس نوع هر مورد با استفاده از این فعال و غیرفعال کرد [type.settings.<item_type>] بخش را default مقدار برای تعیین محل پر شدن توضیحات باگ TestRail استفاده می شود.

[type.settings.Bug]
description=off
repro_steps=default
system_info=on

علاوه بر فعال کردن، غیرفعال کردن یا سازماندهی مجدد فیلدها همانطور که در بالا توضیح داده شد، امکان تغییر گزینه های اضافی در هر فیلد نیز وجود دارد. برای انجام این کار، یک بخش برای فیلد تعریف می کنید، مانند [push.field.description] و گزینه های اضافی را در این قسمت مشخص کنید.

[push.field.description]
label=Detailed Description
required=true

لطفاً برای لیست کامل و توضیح گزینه های فیلد موجود به زیر مراجعه کنید:

گزینه	توضیحات
api_field	کلید فیلد در پاسخ API. نمونه ها هستند api_field=System.Description و api_field=Microsoft.VSTS.Common.AcceptanceCriteria (برای فیلدهای سفارشی لازم است)
api_list_id	مقدار شناسه یک فیلد لیست، مانند 661eb38e-6f0b-484a-bc53-27a57c2e2d50. مقدار از Azure DevOps API به دست آمده است. (برای فیلدهای سفارشی که دارای type=dropdown)
label	نام نمایش فیلد را در گفتگوی Push Defect مشخص می کند (برای فیلدهای سفارشی لازم است)
size	مشخص می کند که آیا فیلد به صورت یک فیلد فشرده نمایش داده می شود یا خیر (compact) یا از تمام عرض دیالوگ استفاده می کند (full)
remember	مشخص می کند که آیا مقادیر انتخاب شده قبلی برای این فیلد باید در دفعه بعد که گفتگوی Push Defect باز می شود به خاطر بسپارند و بازیابی شوند.
required	اجباری یا اختیاری بودن این فیلد را مشخص می‌کند و آیا کاربران باید مقداری را برای این فیلد در گفتگوی Push Defect وارد کنند.
type	نوع این فیلد را مشخص می کند، لطفاً بخش فیلدهای سفارشی را در زیر برای لیستی از انواع فیلدهای پشتیبانی شده ببینید.  (الزامی برای فیلدهای سفارشی – اگر type=dropdown پس برای یک فیلد سفارشی api_list_id نیز لازم است)

فیلدهای سفارشی #

همچنین می توانید از رویکرد فوق برای افزودن فیلدهای سفارشی به گفتگوی Push Defect TestRail استفاده کنید. برای انجام این کار، به سادگی یک خط با فیلد دلخواه خود به آن اضافه کنید [push.fields] بخش برای افزودن یک فیلد

[push.fields]
# ...
description=on
customfield_customer=on

سپس، a را اضافه کنید [field.settings.customfield_<field_name>] بخش این بخش مورد نیاز است تا افزونه بتواند داده ها را از ابزار شما فشار دهد و/یا بازیابی کند. <field_name> می تواند هر مقدار باشد، زیرا ویژگی های فیلد در قسمت مربوطه تعریف می شود. در زیر یک نمونه است.

[field.settings.customfield_customer]
api_field=System.Customer
label=Customer
size=compact
type=dropdown
required=true

انواع فیلدهای زیر پشتیبانی می شوند:

نوع فیلد	توضیحات
bool	یک منوی کشویی بله/خیر برای مقادیر درست/نادرست، بله/خیر یا مقادیر باینری مشابه
date	یک فیلد رشته ای که مقدار تاریخ YYYY-MM-DD یا ساختار مشابهی را می پذیرد. قالب بندی ممکن است به نیازهای ابزار یکپارچه بستگی داشته باشد.
datetime	یک فیلد رشته‌ای که مقدار تاریخ و زمان YYYY-MM-DD HH:MM یا ساختار مشابهی را می‌پذیرد. قالب بندی ممکن است به نیازهای ابزار یکپارچه بستگی داشته باشد.
dropdown	یک لیست کشویی که به کاربران امکان می دهد یکی از چندین گزینه را انتخاب کنند
string	یک فیلد متن آزاد کوچک با حداکثر ۲۵۰ کاراکتر.
text	یک فیلد متن آزاد بزرگ بدون محدودیت اندازه عملی.

پیوست ها #

افزونه نقص Azure DevOps از ارسال پیوست به Azure DevOps نیز پشتیبانی می کند. این فیلد را می توان روشن و خاموش کرد، اما نمی توان آن را سفارشی کرد. برای ارسال یک یا چند پیوست به Azure DevOps، به سادگی پیوست را به پیوست‌ها یا قسمت‌های توضیحات کادر محاوره فشار دهید یا روی ناحیه کلیک کنید تا یک پیوست از سیستم فایل خود انتخاب کنید.