پیکربندی دستی ادغام Jira

برای شروع سریع با ادغام TestRail-Jira، پیشنهاد می‌کنیم از integration wizard در بخش Administration در TestRail و در مسیر Admin > Integration استفاده کنید. 

در لینک‌های زیر می‌توانید اطلاعات بیشتری درباره راه‌اندازی integration برای هر نوع پیکربندی Jira پیدا کنید:

• اتصال به Jira Cloud
• اتصال به Jira Data Center
• اتصال به Jira Server

همچنین می‌توانید integration را بدون setup wizard پیکربندی کنید. این مقاله توضیح می‌دهد چطور TestRail را به‌صورت دستی با Jira ادغام کنید (هم Jira Server و هم Jira Cloud).

در حال حاضر، چهار روش برای ادغام TestRail با Jira وجود دارد:

• استفاده از Defect URLs برای لینک کردن نتایج تست به Jira
• استفاده از defect plugin برای ایجاد issueهای جدید Jira و مشاهده جزئیات issue مستقیم در TestRail
• استفاده از reference URLs برای لینک کردن test caseها به Jira
• استفاده از reference plugin برای مشاهده جزئیات issueهای لینک‌شده مستقیم در TestRail

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

Defect URLs (برای Jira Server) #

Defect URLs به TestRail می‌گویند چطور به Jira Server instance شما دسترسی پیدا کند.

برای پیکربندی URLهای Jira برای فیلدهای Defects، مسیر Admin > Integration > Defects را انتخاب کنید.

برای پیکربندی آدرس‌های مربوط به Jira instance خود، می‌توانید از URLهای نمونه زیر استفاده کنید:

Jira Server (یا نسخه‌های Data Center قبل از 8.22)
#

نوع ادغام URL	URL
URL مشاهده Defect	http://<your.server.address>/jira/browse/%id%
URL افزودن Defect	http://<your.server.address>/jira/secure/CreateIssue!default.jspa

پس از پیکربندی URLها، کنار فیلد Defects در پنجره Add Test Result یک لینک Add نمایش داده می‌شود. با این لینک می‌توانید برای گزارش یک bug جدید، مستقیماً به فرم Create Issue در Jira بروید.

همچنین issue IDهایی که وارد می‌کنید به‌صورت خودکار به Jira instance شما لینک می‌شوند تا پیگیری وضعیت issueها ساده‌تر شود.

URLهای مرجع (برای Jira Server) #

Reference URLها برای لینک‌کردن test caseها به issueهایی که در Jira ذخیره شده‌اند، از طریق فیلد References استفاده می‌شوند. پس از پیکربندی URLها، issue IDهایی که در فیلد References وارد می‌شوند به Jira instance شما لینک می‌شوند تا رفتن به issueهای مرتبط، مشخصات feature یا requirements ساده‌تر شود.

برای پیکربندی URLهای Jira برای فیلد References، این مسیر را انتخاب کنید: Admin > Integration > References.

برای پیکربندی آدرس‌های Jira instance خود، می‌توانید از URLهای نمونه زیر استفاده کنید:

Jira Server (یا نسخه‌های Data Center قبل از 8.22)
#

نوع یکپارچه‌سازی URL	URL
URL مشاهده Reference	http://<your.server.address>/jira/browse/%id%
URL افزودن Reference	http://<your.server.address>/jira/secure/CreateIssue!default.jspa

پس از پیکربندی URLها، می‌توانید issue IDهای user story را به test caseهای خود اضافه کنید؛ این IDها به لینک‌هایی تبدیل می‌شوند که شما را مستقیماً به Jira می‌برند.

پلاگین‌های Defect #

می‌توانید از Defect pluginها برای ایجاد یکپارچه‌سازی عمیق‌تر با bug tracker استفاده کنید. TestRail همراه با Jira defect pluginهای آماده استفاده ارائه می‌شود. پلاگین‌های Jira integration به دو پلاگین جدا تقسیم شده‌اند تا integrationهای Jira Cloud و Jira Server را جداگانه مدیریت کنند. از ۲۹ آوریل ۲۰۱۹، Atlassian قابلیت استفاده از password کاربر را در نسخه cloud Jira منسوخ کرد تا با مقررات اروپایی GDPR همسو شود.

برای TestRail، این یعنی integration با Jira Cloud و Jira Server باید کمی متفاوت انجام شود. خلاصه:

• برای integration با Jira Server یا Data Center، باید از Jira REST plugin (Jira Server ۵.x، ۶.x، ۷.x، ۸.x و نسخه‌های بعدی) استفاده کنید و احراز هویت را با username و password حساب Jira خود انجام دهید.
• برای integration با Jira Cloud، باید از Jira Cloud plugin استفاده کنید و احراز هویت را با آدرس ایمیل Jira و Jira API token انجام دهید.

برای پیکربندی defect plugin، به مسیر Admin > Integration بروید و Jira defect plugin مربوطه را از فهرست Defect Plugin انتخاب کنید. سپس همه تنظیمات لازم اتصال را در فیلد Configuration پیکربندی کنید. در صورت نیاز، pluginها و تنظیمات مخصوص هر project را هم می‌توانید در بخش Admin > Projectsمشخص کنید.

بعد از پیکربندی defect plugin، لینک جدید Push کنار فیلد Defects در پنجره Add Test Result نمایش داده می‌شود. با کلیک روی این لینک، یک پنجره popup باز می‌شود که به شما امکان می‌دهد بدون خروج از TestRail، گزارش باگ را به Jira ارسال کنید.

بعد از اضافه شدن test result، اگر نشانگر ماوس را روی issue ID نگه دارید، پنجره‌ای باز می‌شود که اطلاعات کاربردی و جزئیات وضعیت issue در Jira را نشان می‌دهد.

Reference pluginها #

از Reference pluginها می‌توان برای دریافت اطلاعات بیشتر از IDهایی استفاده کرد که در فیلد References آیتم‌های TestRail، مثل test caseها، test runها و milestoneها وارد شده‌اند. Reference Plugin در تب References از تنظیمات integration، به همان روشی پیکربندی می‌شود که Defect Plugin را پیکربندی می‌کنید.

این plugin از نمایش اطلاعات با نگه داشتن نشانگر ماوس روی Reference IDها و ویرایش مستقیم issueهای Jira در TestRail پشتیبانی می‌کند. همچنین می‌توانید فیلدهایی را که هنگام نگه داشتن ماوس روی لینک نمایش داده می‌شوند سفارشی کنید و همان‌طور که بالاتر توضیح داده شد، custom field اضافه کنید.

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

پیوست‌ها #

Jira Defect Plugin هنگام ساخت issue جدید و ارسال آن به Jira، از اضافه کردن attachment پشتیبانی می‌کند. این فیلد را می‌توانید فعال یا غیرفعال کنید، اما امکان سفارشی‌سازی بیشتر آن وجود ندارد. برای ارسال یک یا چند attachment به Jira، بعد از کلیک روی Push در dialog مربوط به test result یا منوی کشویی Defects، attachment را به بخش attachments یا description در push dialog بکشید، یا روی همان بخش کلیک کنید و فایل را از سیستم خود انتخاب کنید.

سفارشی‌سازی‌های بیشتر #

TestRail Server از custom defect pluginها هم پشتیبانی می‌کند. اگر تیم شما از TestRail Server استفاده می‌کند، می‌توانید defect plugin را بیشتر سفارشی کنید (یا plugin خودتان را بسازید) تا از field typeهای بیشتر یا داده‌های دیگر پشتیبانی کند. برای اطلاعات بیشتر، به مستندات custom defect pluginها مراجعه کنید.