ادغام با Assembla

این مبحث نحوه ادغام TestRail با Assembla را توضیح می دهد. در حال حاضر سه راه برای ادغام TestRail با Assembla وجود دارد که عبارتند از:

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

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

ادغام Assembla پیشرفته #

TestRail یک ادغام با Assembla را ارائه می دهد که از OAuth استفاده می کند و به کاربران این امکان را می دهد تا به سرعت نمونه های TestRail و Assembla خود را بدون نیاز به پیکربندی کلیدهای API یا وارد کردن اعتبار اضافی به یکدیگر متصل کنند.

اتصال به Assembla #

به عنوان یک مدیر TestRail، می توانید به یک نمونه Assembla در نمای Integration ناحیه Administration متصل شوید. در این نما، را فشار دهید Assembla را پیکربندی کنید را فشار دهید و با گفتگوی اتصال ادامه دهید:

با وارد کردن URL سازمان Assembla و Space در کادر گفتگو، می‌توانید دکمه Connect Account را فشار دهید و TestRail پیکربندی را برای شما کامل می‌کند. یا می توانید کلید API و مخفی API را وارد کنید.

را ادغام نقص و یکپارچه سازی مرجع گزینه‌ها به شما اجازه می‌دهند تا به طور خودکار ادغام‌های نقص و مرجع را برای نمونه خود پیکربندی کنید.

OAuth برای کاربران #

با اتصال TestRail به Assembla، می توانید حساب TestRail خود را با استفاده از OAuth به Assembla متصل کنید. در تنظیمات من ناحیه حساب کاربری خود را باز کنید برگه OAuth:

فشار دادن اتصال حساب دکمه یک توکن دسترسی را از Assembla بازیابی می کند و آن را در حساب TestRail شما ذخیره می کند. از طرف دیگر، می توانید به صورت دستی یک را وارد کنید رمز دسترسی کاربر بر روی تنظیمات برگه

همچنین می توانید هر زمان که بخواهید ارتباط کاربری خود را قطع کنید.

کلید API و راز برای کاربران #

با اتصال TestRail به Assembla با استفاده از یک API Key and Secret، باید یک کلید و یک رمز API در حساب Assembla خود ایجاد کنید. می توانید این کار را در قسمت Account انجام دهید > برنامه های کاربردی API & جلسه. لطفاً مطمئن شوید که کادرهای دسترسی API و دسترسی به مخزن را علامت بزنید.

پس از ذخیره، کلید و راز API در دسترس خواهد بود. در TestRail باید کلید و راز خود را در قسمت مربوطه ذخیره کنید متغیرهای کاربر برای ادغام پیکربندی شده است.

آدرس های اینترنتی نقص #

نشانی‌های وب نقص برای اینکه TestRail بداند چگونه شناسه نقص را به URL برای نمونه Assembla خود تبدیل کند، استفاده می‌شود. دو نوع URL وجود دارد: مشاهده URL ها و Add URLs.

را نشانی وب مشاهده نقص برای ایجاد پیوند به Assembla بر اساس Defect ID استفاده می شود، بنابراین می توانید به سادگی بر روی یک ID کلیک کنید تا موضوع به طور مستقیم در Assembla باز شود.

را نقص اضافه کردن URL برای ایجاد پیوند به صفحه ایجاد مشکل در داخل Assembla استفاده می شود. هنگامی که URL پیکربندی شد، یک پیوند افزودن جدید در کنار فیلد نقص در گفتگوی افزودن نتیجه آزمایش و منوی “نقایص” ظاهر می شود. نقص فشاری TestRail از هر کجا ویژگی این پیوند به شما امکان می دهد برای گزارش یک اشکال جدید به فرم Assembla’s New Issue بروید.

اگر از اضافه کنید پیوند، می توانید شناسه شماره جدید Assembla خود را کپی کنید و آن را در هر قسمت Defects یا References در TestRail وارد کنید.

می توانید URL های Assembla را در TestRail به صورت جهانی تحت مدیریت پیکربندی کنید > ادغام یا بر اساس هر پروژه در تنظیمات هر پروژه. برای پیکربندی آدرس ها از URL های مثال زیر استفاده کنید:

Assembla installation
Defect View Url: https://app.assembla.com/spaces/<space>/tickets/%id%
Defect Add Url:  https://app.assembla.com/spaces/<space>/tickets/new?from=tickets

لطفا حتما تعویض کنید <space> با نام واقعی نمونه کارها و فضای موجود در Assembla که می خواهید با آن ادغام شوید.

اگر نمونه Assembla شما در اتحادیه اروپا قرار دارد، URL های شما باید با https://eu-app.assembla.com/…

URL های مرجع #

URL های مرجع به شیوه ای بسیار شبیه به URL های نقصی که در بالا توضیح داده شد پیاده سازی می شوند. تفاوت اصلی این است که URL های مرجع برای فیلد “مرجع” در موجودیت های مختلف TestRail (به جای قسمت نقص) استفاده می شود.

را نشانی وب مشاهده مرجع به همان روشی که در بالا توضیح داده شد پیکربندی شده است و به TestRail اجازه می دهد تا یک پیوند مستقیم به Assembla بر اساس شناسه وارد شده در یک قسمت References ایجاد کند.

را مرجع اضافه کردن URL همچنین به همان روش Defect Add URL پیکربندی شده است. پس از پیکربندی، یک اضافه کنید پیوند در کنار هر فیلد References در نمونه یا پروژه شما ظاهر می شود. اگر از اضافه کنید پیوند، می توانید شناسه شماره جدید Assembla خود را کپی کنید و آن را در هر قسمت Defects یا References در TestRail وارد کنید.

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

پلاگین های نقص #

پلاگین های نقص را می توان برای پیاده سازی یکپارچگی ردیاب اشکال تنگ استفاده کرد و TestRail با یک افزونه نقص Assembla آماده برای استفاده ارائه می شود. برای پیکربندی افزونه نقص، را انتخاب کنید مدیر > یکپارچه سازی و Assembla را در قسمت انتخاب کنید افزونه نقص لیست کشویی مرحله بعدی پیکربندی تمام تنظیمات اتصال لازم است. پلاگین های خاص پروژه و تنظیمات پیکربندی را می توان به صورت اختیاری در زیر مشخص کرد مدیر > پروژه ها.
لطفاً مطمئن شوید که از شناسه فضای کاری خود استفاده می کنید نه از نام فضای کاری. وقتی وارد نمونه Assembla خود شوید، شناسه را می توان در نوار URL پیدا کرد.

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

هنگامی که نتیجه آزمایش اضافه شد، نشانگر ماوس را روی a نگه دارید شناسه نقص پنجره ای با اطلاعات مفید و جزئیات وضعیت در مورد نقص در Assembla باز می شود.

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

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

پلاگین نقص Assembla برای کار با پیکربندی استاندارد Assembla ساخته شده است. TestRail به شما امکان می‌دهد فیلدهایی را که در کادر محاوره‌ای Push ظاهر می‌شوند و همچنین هنگام نگه داشتن ماوس روی شناسه‌های نقص سفارشی کنید. فیلدهای فشار از پیش پیکربندی شده و فیلدهای شناور را می توان در بخش های [push.fields] و [hover.fields] مربوطه روی «روشن» یا «خاموش» تنظیم کرد یا ترتیب ظاهر شدن آنها را بر اساس فیلدهای هر بخش تغییر داد.

لطفاً به خاطر داشته باشید که برخی از فیلدها (مانند فیلد عنوان) همیشه فعال هستند و ممکن است در این بخش ها ظاهر نشوند به دلیل وجود همیشه مورد نیاز TestRail یا Assembla.

افزونه نقص Assembla همچنین از اصلاح خصوصیات فیلد و همچنین فیلدهای سفارشی پشتیبانی می کند.

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

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

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

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

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

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

[push.fields]
...
description=on
customfield_11002=on

فیلدهای سفارشی توسط customfield_ تعیین می شوند. مقدار شناسه یک فیلد سفارشی را می توان از طریق Assembla API، با استفاده از مرورگر خود برای بررسی مقدار یک فیلد سفارشی در یک بلیط یا در URL صفحه ویرایش یک فیلد سفارشی به دست آورد.

سپس، بخش [field.settings.customfield_] را اضافه کنید. این بخش مورد نیاز است تا افزونه بتواند داده ها را از ابزار شما فشار دهد و/یا بازیابی کند. نمونه زیر است:

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

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

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

پیوست ها #

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

پلاگین مرجع #

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

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

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

سفارشی سازی های اضافی #

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