رفتن به محتوای اصلی
فهرست مستندات
یکپارچه‌سازی با ابزارهای نیازمندی و باگ

آشنایی با integrationهای Reference و Defect

به‌روزرسانی ۶ دقیقه مطالعه TestRail

فهرست مطالب
  1. Integrationهای requirements و referenceها
  2. View و Add کردن URLهای Reference
  3. Reference Pluginها
  4. یکپارچه‌سازی‌های defect، bug و سایر issue trackerها
  5. URLهای مشاهده و افزودن Defect
  6. Defect Pluginها

می‌توانید project خود در TestRail را با سیستم‌های مدیریت requirements، defectها و issue trackerها و سایر ابزارهای مدیریت agile project یکپارچه کنید. این integrationها مانند plugin فعال می‌شوند و می‌توانید از آن‌ها برای ارسال، لینک کردن یا اضافه کردن داده‌ها مستقیماً از داخل TestRail استفاده کنید. با راه‌اندازی آن‌ها، TestRail به شما امکان می‌دهد:

  • bugها را مستقیماً از TestRail گزارش کنید
  • در test resultهای خود به bugهای موجود در issue tracker لینک بدهید
  • با نگه داشتن نشانگر ماوس روی لینک، اطلاعات bug را از issue tracker دریافت کنید
  • وضعیت bugهای گزارش‌شده را برای test runها، test planها و milestoneها بررسی کنید
  • با ارجاع دادن requirements یا user storyها در test caseها، test coverage را تنظیم کنید
  • با نگه داشتن نشانگر ماوس روی لینک، اطلاعات requirements یا user storyها را دریافت کنید
  • بر اساس referenceها، گزارش‌های coverage و traceability ایجاد کنید

Integrationهای requirements و referenceها

می‌توانید از فیلد References در test caseها، test runها، test planها و milestoneها برای لینک کردن requirementهایی استفاده کنید که تیم شما باید آن‌ها را تست کند. 

بدون فعال کردن هیچ integration، می‌توانید به‌سادگی یک URL یا specification ID را در این References فیلد کپی و paste کنید. این کار به شما امکان می‌دهد هنگام testing و برای پیگیری coverage، سریعاً به آن منبع به‌عنوان reference دسترسی داشته باشید. 

image5.png

View و Add کردن URLهای Reference

اگر سیستمی که برای پیگیری requirements استفاده می‌کنید، برای مشاهده هر requirement یک ID یکتا در URL دارد؛ مثلاً ID «TR-۴۲» در URL به‌شکل https://example.tracker.com/project-۱/TR-۴۲، می‌توانید TestRail را طوری تنظیم کنید که هر ID یکتایی را که اضافه می‌کنید به‌صورت خودکار به hyperlink تبدیل کند. این تنظیم را می‌توانید با گزینه View Reference URL در بخش Admin > Integrationپیکربندی کنید. 

پس از راه‌اندازی، می‌توانید issue IDها را در فیلد References در test caseها، test runها، test planها یا milestoneها کپی و paste کنید و TestRail به‌صورت خودکار hyperlink می‌سازد. همچنین می‌توانید با وارد کردن چند reference در یک فهرست جداشده با کاما، چند reference را به یک entity در TestRail لینک کنید.

image9.png

از TestRail ۱۰.۰ به بعد، فیلد references یک issue picker داخلی دارد؛ بنابراین می‌توانید هر referenceای را که شروع به وارد کردن می‌کنید سریعاً لینک کنید، و قابلیت auto complete به شما اجازه می‌دهد هنگام تایپ، reference موردنظر را انتخاب کنید. این قابلیت فقط زمانی در دسترس است که یک integration پشتیبانی‌شده Jira Cloud فعال باشد.

references auto fill 13.png

همچنین می‌توانید آدرس وبی را که برای ایجاد issueهای جدید در ابزار خارجی خود استفاده می‌کنید bookmark کنید. این کار با راه‌اندازی گزینه Add Reference URL برای instance یا project شما انجام می‌شود. پس از پیکربندی، TestRail یک لینک Add بالای فیلد references در سراسر project شما نمایش می‌دهد که یک تب جدید برای ایجاد issue در ابزار خارجی باز می‌کند.

image10.png

Reference Pluginها

و اگر TestRail برای ابزار خارجی‌ای که تیم شما برای پیگیری requirements استفاده می‌کند یک Reference Plugin داخلی داشته باشد، می‌توانید از آن برای جست‌وجوی داده‌های همان ابزار در داخل TestRail استفاده کنید. پس از فعال شدن، reference pluginها به شما اجازه می‌دهند نشانگر ماوس را روی یک reference لینک‌شده نگه دارید تا داده‌ها از ابزار خارجی دریافت شوند و در TestRail نمایش داده شوند؛ مثل status، priority، component، version، assignee و موارد مشابه. می‌توانید تعیین کنید چه فیلدهایی در hover pop-upها نمایش داده شوند، و در بعضی integrationها حتی می‌توانید بدون خروج از TestRail، اطلاعات را در ابزار خارجی ویرایش کنید.

image8.png

برای اطلاعات بیشتر درباره پیکربندی و استفاده از integrationهای requirements و reference، این مورد را ببینید: مقاله «Configuring Reference Integrations».

یکپارچه‌سازی‌های defect، bug و سایر issue trackerها

وقتی یک test result را در یک test run یا plan اضافه می‌کنید، می‌توانید از فیلد Defects برای لینک کردن یک defect، گزارش bug، یا نوع دیگری از issue که در یک bug tracker، defect tracker یا issue tracker خارجی پیگیری می‌شود استفاده کنید. 

image4.png

URLهای مشاهده و افزودن Defect

در صورت تمایل، می‌توانید IDهای منحصربه‌فرد issueهایی را که قبلاً در ابزار خارجی خود ساخته‌اید کپی و جای‌گذاری کنید. اگر سیستمی که برای پیگیری defectها یا issueها استفاده می‌کنید این ID منحصربه‌فرد را به‌عنوان بخشی از URL مشاهده defect داشته باشد، می‌توانید TestRail را طوری تنظیم کنید که IDهایی را که اضافه می‌کنید به‌صورت خودکار به لینک تبدیل کند. این کار با گزینه Defect View URL در بخش Admin > Integrationانجام می‌شود. 

پس از راه‌اندازی، می‌توانید issue IDها را در فیلد References در test caseها، test runها، planها یا milestoneها کپی و جای‌گذاری کنید تا TestRail به‌صورت خودکار لینک بسازد. همچنین می‌توانید چند reference را با وارد کردن آن‌ها به‌صورت فهرست جداشده با کاما، به یک موجودیت در TestRail لینک کنید.

mceclip0.png

همچنین می‌توانید فیلد Defect Add URL را تکمیل کنید تا URL ابزار خارجی شما در project مربوطه در TestRail ذخیره شود و بتوانید سریع یک تب جدید باز کنید و issueهای جدید اضافه کنید. پس از پیکربندی، هنگام افزودن test result یک لینک Add در سمت راست فیلد Defects نمایش داده می‌شود.

image3.png

از TestRail ۱۰.۰ به بعد، فیلد Defects یک issue picker داخلی دارد؛ بنابراین می‌توانید هر referenceای را که شروع به وارد کردن می‌کنید سریع لینک کنید و قابلیت autocomplete هنگام ادامه تایپ، reference مناسب را برای انتخاب نشان می‌دهد. این قابلیت فقط زمانی در دسترس است که یک یکپارچه‌سازی پشتیبانی‌شده Jira Cloud فعال باشد.

defects auto fill 14.png

همچنین یک منوی کشویی Defects در toolbar مربوط به projectها، milestoneها، planها، test runها و test caseها نمایش داده می‌شود. با این گزینه می‌توانید روی لینک کلیک کنید، به ابزار خارجی خود بروید و تقریباً از هر جایی در TestRail یک defect جدید اضافه کنید.

image2.png

Defect Pluginها

اگر TestRail برای ابزار خارجی شما یک یکپارچه‌سازی داخلی Defect Plugin داشته باشد، می‌توانید این یکپارچه‌سازی را گسترده‌تر کنید. Defect pluginها به شما امکان می‌دهند بدون خروج از TestRail، issueهای جدید بسازید و آن‌ها را به ابزار خارجی خود ارسال کنید. می‌توانید پنجره push defect را سفارشی کنید تا مشخص شود کدام فیلدها در نمای issue جدید نمایش داده شوند و قبل از ارسال قابل ویرایش باشند؛ همچنین می‌توانید تنظیمات layout را تغییر دهید و مقدارهای پیش‌فرض را پیکربندی کنید.

image11.png

همچنین می‌توانید templateای را که TestRail برای تولید خودکار فیلدهای description در issueهای ارسالی استفاده می‌کند سفارشی کنید. مهم‌تر از همه، می‌توانید در description templateها متغیرهایی قرار دهید تا TestRail هنگام push کردن defect، داده‌ها را به‌صورت پویا از test case، test run، plan، milestone و test result فعلی شما دریافت کند. 

image7.png

پس از پیکربندی defect plugin، می‌توانید نشانگر را روی defectهای لینک‌شده نگه دارید تا اطلاعات لحظه‌ای آن‌ها، مانند status، assignee، version و موارد دیگر را ببینید. همچنین می‌توانید فیلدهایی را که در پنجره‌های hover preview مربوط به defect نمایش داده می‌شوند سفارشی کنید. بعضی defect pluginها حتی به شما اجازه می‌دهند بدون خروج از TestRail، داده‌های ابزار خارجی خود را از همان پنجره hover preview ویرایش کنید.

image6.png

برای اطلاعات بیشتر درباره راه‌اندازی defect integrationها، پیکربندی hover fieldها، و سفارشی‌سازی templateهای description برای push defect، به مقاله Configuring Defect Integrationsمراجعه کنید.

 

ایستگاه بعدی شما

TestRail را همین حالا در محیط دمو ببینید.

محیط تست آماده

دسترسی به دمو TestRail

قبل از ورود، مشخصات زیر را در صفحه ورود محیط دمو وارد کنید.

آدرس دمو

https://demo.testrail.ir

ایمیل ورود

demo@testrail.ir

رمز عبور

demo_user