پیش‌فرض TestRail ۷.۱

تاریخ انتشار نسخه Cloud: ۱۶ آوریل ۲۰۲۱

نسخه TestRail ۷.۱ شامل بهبودهایی در پنجره پیوست‌ها در سراسر TestRail است ؛ بهبودهایی که برای استفاده انعطاف‌پذیرتر و ساده‌تر از پیوست‌ها هنگام ایجاد test case، test run، plan و milestone، و همچنین هنگام افزودن نتیجه یا ارسال defect به ابزارهای یکپارچه‌شده طراحی شده‌اند.

ما می‌دانیم چقدر مهم است که بتوانید طراحی و نتایج تست‌های خود را با screenshot، فایل GIF، سندها و سایر فایل‌های کمکی کامل‌تر کنید. پیوست کردن این اطلاعات به test caseها و قرار دادن آن‌ها در فیلدها، به‌طوری که کنار دستورالعمل‌ها یا نتایج تست قابل مشاهده باشند، برای هر tester قابلیت مهمی است. به همین دلیل، با افتخار TestRail ۷.۱ را معرفی می‌کنیم؛ نسخه‌ای که مجموعه‌ای از بهبودها را برای ساده‌تر کردن کار کاربران حرفه‌ای پیوست‌ها، و البته همه کاربران دیگر، ارائه می‌دهد.

این نسخه به‌صورت مرحله‌ای منتشر می‌شود؛ بنابراین اگر هنوز قابلیت‌های جدید را در نمونه TestRail Cloud خود نمی‌بینید، کمی صبر کنید. TestRail ۷.۱ به‌زودی برای شما فعال می‌شود.

برای ساده‌تر کردن کار مدیران، همچنین یک بخش جدید برای مدیریت پیوست‌ها در کنسول مدیریت اضافه کرده‌ایم و فیلتری در نظر گرفته‌ایم که کمک می‌کند دقیقاً مشخص کنید کدام پیوست‌ها برای پاک‌سازی مناسب هستند.

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

اینجا کلیک کنید تا ویدیوی ضبط‌شده وبینار TestRail ۷.۱ را ببینید.

بهبود UX هنگام افزودن یا حذف پیوست‌ها برای entityهای داخل TestRail #

یکی از تغییرات اصلی که در نسخه ۷.۱ متوجه آن می‌شوید، پنجره جدید پیوست‌ها برای آپلود فایل روی entityهای TestRail است؛ از جمله caseها، runها، planها، milestoneها، نتایج تست و در موارد پشتیبانی‌شده، ارسال defect.

این پنجره مفهوم media library را معرفی می‌کند. به‌جای این‌که فقط فایل‌ها را به‌صورت موردی آپلود و به test caseهای خود پیوست کنید، پیوست‌های شما حالا بخشی از یک library می‌شوند و می‌توانید بعداً دوباره از آن‌ها استفاده کنید.

به همین دلیل، این پنجره چند قابلیت دیگر هم دارد که برای پشتیبانی از استفاده و استفاده مجدد از پیوست‌ها در entityهای مختلف TestRail طراحی شده‌اند؛ حتی در projectهای مختلف، اگر لازم باشد. می‌توانید پیوست‌ها را با انتخاب فایل از سیستم خود یا با drag-and-drop در attachment library آپلود کنید.

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

نمای Attachment Details اطلاعات و گزینه‌های بیشتری برای مدیریت پیوست در اختیار شما می‌گذارد. می‌توانید:

• نام پیوست را تغییر دهید
• نوع فایل، اندازه و زمان آپلود را ببینید
• URL یکتای پیوست را مشاهده و کپی کنید
• projectهایی را که پیوست در آن‌ها قابل مشاهده است تغییر دهید
• پیوست را حذف کنید
• پیوست را با فایل جدیدی جایگزین کنید و همان نام و URL را نگه دارید
• پیوست را با وضوح کامل مشاهده کنید

احتمالاً شما هم موافقید که این قابلیت‌ها بسیار کاربردی هستند.

علاوه بر این، می‌توانید در بخش‌های مختلف TestRail به یک پیوست ارجاع دهید و با استفاده از قابلیت Replace، همان پیوست ارجاع‌شده را در همه جا به‌روزرسانی کنید.

اما این همه ماجرا نیست…

کنسول جدید مدیریت پیوست‌ها برای مدیران #

در TestRail ۷.۱، با معرفی یک کنسول جدید مدیریت پیوست‌ها در بخش Admin، همچنان در حال ساده‌تر کردن کار مدیران هستیم. اگر یک نمونه میزبانی‌شده TestRail Cloud دارید، از نسخه ۷.۱ می‌بینید که قابلیت‌های مربوط به داده را در تب‌های جداگانه‌ای در منوی Data Management قرار داده‌ایم:

• Storage
• Exports
• Attachments

در تب جدید Attachments، مدیران می‌توانند همه کارهایی را که در پنجره بهبودیافته پیوست‌ها وجود دارد انجام دهند، با این مزیت که همه پیوست‌ها را در سراسر همه projectها می‌بینند.

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

بهبود عملکرد و مدیریت پیوست‌ها #

هم‌زمان با اضافه کردن این قابلیت‌ها، تغییرات مهمی هم در پشت صحنه TestRail انجام داده‌ایم و یک ساختار database کاملاً جدید برای مدیریت پیوست‌ها پیاده‌سازی کرده‌ایم تا عملکرد بهتر شود و مطمئن شویم پیوست‌ها به‌صورت مؤثر قابل جستجو و فیلتر هستند.

برای مشتریان TestRail Cloud میزبانی‌شده، برای استفاده از این مزیت نیازی به انجام هیچ کاری نیست. همه چیز در پس‌زمینه برای شما انجام می‌شود.

برای مشتریان نسخه Server، برای فعال‌سازی پیکربندی دیتابیس Cassandra باید چند الزام نصب اضافی را هم رعایت کنید.

بهبودهای API #

چند تغییر هم در endpointهای API مربوط به پیوست‌ها اعمال کرده‌ایم.

بنا به درخواست کاربران، run_id، plan_id و plan_entry_id را به endpointهای مرتبط get_attachments_for_run، get_attachments_for_plan و get_attachments_for_plan_entry اضافه کرده‌ایم.

رفتار endpointهای مختلف مربوط به افزودن و دریافت پیوست را بهبود داده‌ایم تا با رفتاری که اکنون به‌عنوان رفتار مورد انتظار می‌شناسیم، هماهنگ‌تر باشد؛ هرچند این رفتار هنوز تا حدی پیچیده است:

• اگر هیچ پیوست مخصوصی برای run اضافه نشده باشد، get_attachments_for_run پیوست‌های plan entry را برمی‌گرداند.
• اگر برای runهای داخل plan entry پیوست‌های اختصاصی اضافه شده باشد، get_attachments_for_run پیوست‌های همان run را برمی‌گرداند.
• پیوست‌هایی که از طریق endpoint مربوط به add_attachment_to_run به runهای داخل plan اضافه می‌شوند، هنگام مشاهده runها در UI قابل مشاهده هستند.
• وقتی endpoint مربوط به get_attachments_for_run فراخوانی می‌شود، ID پیوست‌هایی که از طریق add_attachment_to_run به یک run داخل plan اضافه شده‌اند، برگردانده می‌شود.
• get_attachments_for_plan_entry فقط ID پیوست‌های مربوط به همان plan entry درخواستی را برمی‌گرداند.

نکته دیگری که باید اشاره کنیم این است که ID پیوست‌هایی که از طریق endpointهای get_attachment برگردانده می‌شود، از یک عدد صحیح ساده به یک reference تغییر کرده است:

{
“attachment_id”: “2054f652-fe2f-4542-acb0-422910ed87e3”
}

همچنین در body پاسخ‌های مربوط به پیوست، چند فیلد metadata اضافی برای پیوست‌ها خواهید دید. برای جزئیات بیشتر، صفحه Attachments API را بررسی کنید.

حذف پیوست #

در جریان انجام این بهبودها، رفتار چند بخش دیگر را هم اصلاح یا کمی تنظیم کردیم:

• به‌صورت پیش‌فرض، وقتی entity مرتبط با یک پیوست حذف می‌شود، پیوست‌ها دیگر حذف نمی‌شوند؛ برای مثال هنگام حذف یک test case یا run. این تغییر از بروز مشکل در مواردی جلوگیری می‌کند که همان پیوست در entityهای دیگری در TestRail هم استفاده شده است. از این پس پیوست‌ها باید به‌صورت صریح از داخل پنجره attachment library حذف شوند.
• این قانون برای حذف پیوست‌ها از fieldها و sidebarها هم اعمال می‌شود. پیوست تا زمانی که به‌صورت صریح حذف نشود، در attachment library باقی می‌ماند.
• از مشکلات مشابهی هم آگاه بودیم؛ برای مثال زمانی که پیوست‌ها در یک پنجره، مثل test result، آپلود می‌شدند اما کاربر بعدا آن پنجره را بدون ثبت تغییرات رها می‌کرد. با استفاده از attachment library، همه پیوست‌ها در library آپلود می‌شوند و باید به‌صورت صریح از همان‌جا حذف شوند.
• در بخش administration، فیلتری به کنسول Attachment management اضافه کرده‌ایم تا administratorها بتوانند پیوست‌هایی را که دیگر به یک entity معتبر وصل نیستند، به‌راحتی شناسایی و حذف کنند؛ برای مثال پیوست‌هایی که قبلا به یک test case یا run وصل بوده‌اند اما آن test case یا run اکنون حذف شده است. administratorها باید برای این کار از فیلتر «Orphaned» استفاده کنند.
• انتظار داریم مشکلات بخش‌های دیگر، مثل پیوست‌هایی که به plan entryها اضافه شده‌اند، با مکانیزم library نیز برطرف شوند.