استفاده از فیلدهای سفارشی با ادغام Jira

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

فیلدهای نمایش داده شده #

پلاگین های Jira REST به شما امکان می دهند فیلدهای نمایش داده شده در را پیکربندی و تغییر دهید نقص فشار دیالوگ و زمانی که پیوند معلق است. به‌طور پیش‌فرض، افزونه از قبل فهرستی از فیلدها را به‌عنوان بخشی از پیکربندی نقص پیش‌فرض شامل می‌شود (در تب‌های پیکربندی نقص و مرجع در زیر به عنوان مثال. مدیر > یکپارچه سازی یا در تنظیمات یکپارچه سازی پروژه.)

[push.fields]
summary=on
project=on
issuetype=on
# ...
          
[hover.fields]
summary=on
project=on
issuetype=on
# ...

می توانید فعال کنید & فیلدهای جداگانه را غیرفعال کنید و همچنین ترتیب فیلدها را با تنظیم پیکربندی بالا تغییر دهید.

گزینه های فیلد #

علاوه بر فعال یا غیرفعال کردن فیلدها همانطور که در بالا توضیح داده شد، امکان تغییر گزینه های اضافی در هر فیلد نیز وجود دارد. برای انجام این کار، شما باید یک بخش مانند تعریف کنید [field.settings.components] برای تعیین گزینه‌های اضافی برای قسمت جزء. گزینه های زیر پشتیبانی می شوند:

[field.settings.components]
label=Component
size=compact
remember=false
required=false
type=dropdown

لازم نیست همه گزینه ها را مشخص کنید. برای مثال اگر فقط می خواهید گزینه مورد نیاز یک فیلد را تغییر دهید، می توانید از گزینه های دیگر صرف نظر کنید. لطفاً برای توضیح گزینه های مختلف به زیر مراجعه کنید:

گزینه	توضیحات
برچسب	نام نمایش فیلد را در گفتگوی Push Defect مشخص می کند
اندازه	مشخص می کند که آیا فیلد به صورت یک فیلد فشرده نمایش داده می شود (مقدار فشرده) یا از عرض کامل گفتگو (مقدار کامل) استفاده می کند.
به یاد داشته باشید	مشخص می کند که آیا مقادیر انتخاب شده قبلی برای این فیلد باید در دفعه بعد که گفتگوی Push Defect باز می شود به خاطر بسپارند و بازیابی شوند.
مورد نیاز است	اجباری یا اختیاری بودن این فیلد را مشخص می‌کند و آیا کاربران باید مقداری را برای این فیلد در گفتگوی Push Defect وارد کنند.
نوع	نوع این فیلد را مشخص می کند. لطفاً بخش فیلدهای سفارشی زیر را برای لیستی از انواع فیلدهای پشتیبانی شده ببینید

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

همچنین می‌توانید از رویکرد فوق‌الذکر برای اضافه کردن فیلدهای سفارشی تعریف‌شده در Jira به محاوره Push Defect TestRail و در حین شناور بودن پیوند استفاده کنید. برای انجام این کار، به سادگی یک خط مانند این را اضافه کنید [push.fields] یا [hover.fields] بخش برای افزودن یک فیلد:

[push.fields]
summary=on
# ...
customfield_11002=on
# ...

به نام فیلد توجه کنید. یک فیلد سفارشی Jira همیشه باید با استفاده از آن مشخص شود customfield_<id>، که در آن شناسه شناسه فیلد سفارشی است که در Jira تعریف شده است. می توانید با ویرایش فیلد سفارشی در ناحیه مدیریت جیرا، شناسه فیلد سفارشی را در جیرا پیدا کنید. شناسه بخشی از آدرس وب/URL صفحه ویرایش است. علاوه بر فعال کردن فیلد همانطور که در بالا مشخص شده است، همیشه باید یک تعریف فیلد مربوطه مانند این اضافه کنید:

[field.settings.customfield_11002]
label=Customer
size=compact
type=dropdown
required=true

انواع فیلدهای زیر پشتیبانی می‌شوند (به نگاشت‌های احتمالی بین فیلدهای Jira و TestRail نیز توجه کنید):

نوع فیلد	انواع در جیرا	توضیحات
رشته	فیلد متن، برچسب ها	یک فیلد متن آزاد کوچک با حداکثر ۲۵۰ کاراکتر
متن	فیلد متنی، فیلد متنی رایگان	یک فیلد متن آزاد بزرگ بدون محدودیت اندازه عملی
کشویی	دکمه های رادیویی، انتخاب آبشاری، انتخاب فهرست	یک لیست کشویی که به کاربران امکان می دهد یکی از چندین گزینه را انتخاب کنند
چند انتخابی	چند انتخاب، چند چک باکس	به کاربران امکان می دهد چندین گزینه از پیش تعریف شده را انتخاب کنند

وظایف فرعی #

افزونه نقص Jira REST از وظایف فرعی نیز پشتیبانی می کند. می توانید پشتیبانی از وظایف فرعی را با فیلد والد به صورت زیر فعال کنید:

[push.fields]
parent=on

با این کار یک صفحه جدید نمایش داده می شود پدر و مادر در کادر گفتگوی Push برای وارد کردن شناسه مشکل والد برای مسائل جدید. اگر شما هم از مراجع فیلد برای پیوند تست‌کیس‌ها به داستان‌های کاربر یا نیازمندی‌های ذخیره شده در Jira، می‌توانید گزینه زیر را فعال کنید تا فیلد Parent به‌طور خودکار با مقدار فیلد References پر شود:

[push.field.parent]
autofill=on

لینک ها را صادر کنید #

با شروع با TestRail ۴.۰، افزونه نقص از لینک های مشکل نیز پشتیبانی می کند. این می تواند برای ایجاد مسائل جدید که به سایر مسائل موجود در Jira مرتبط است استفاده شود. لینک های مشکل را می توان به صورت زیر فعال کرد:

[push.fields]
# ...
linktype=on
links=on

این دو فیلد جدید به محاوره فشار اضافه می کند (نوع پیوند و پیوندهای مشکل). نوع پیوند نوع پیوندی را که می‌خواهید ایجاد کنید کنترل می‌کند (مثلاً «مربوط به» یا «تکراری از»). فیلد Issue Links به شما امکان می‌دهد فهرستی از شناسه‌های مسئله Jira جدا شده با کاما را وارد کنید که می‌خواهید به شماره جدید پیوند دهید (با استفاده از نوع پیوند پیکربندی شده).

اگر شما هم از مراجع فیلد برای پیوند تست‌کیس‌ها به داستان‌های کاربر یا نیازمندی‌های ذخیره شده در Jira، می‌توانید گزینه زیر را فعال کنید تا فیلد Issue Links با مقدار فیلد References به طور خودکار پر شود:

[push.field.links]
autofill=on

لطفا توجه داشته باشید:  اگر هنگام تلاش برای ایجاد مشکلات جدید Jira با پیوندها با خطا (مثلاً ۴۰۴) مواجه شدید، لطفاً مطمئن شوید که شناسه‌های مشکلی که به قسمت پیوندهای مشکل اضافه کرده‌اید در Jira وجود دارد.

پیوست ها #

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

پلاگین مرجع #

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

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

اگر افزونه Defect را قبلاً برای Jira پیکربندی کرده‌اید، می‌توانید به سادگی آن را کپی کنید [connection] و [hover.fields] بخش هایی از افزونه نقص به پیکربندی پلاگین مرجع. همچنین، می‌توانید فیلدهای مختلفی را برای نمایش References و Defects انتخاب کنید.