با آسانا یکپارچه شوید
مدت زمان مطالعه: : 9 دقیقه
این مبحث نحوه ادغام TestRail با Asana را توضیح می دهد. در حال حاضر چهار راه برای ادغام TestRail با Asana وجود دارد که عبارتند از:
- استفاده از URL های نقص برای پیوند نتایج تست به آسانا
- استفاده از URL های مرجع برای پیوند تستکیسها به آسانا
- استفاده از افزونه نقص برای آسانا برای فشار دادن و جستجوی مسائل آسانا در قسمت نقص نتایج تست
- استفاده از پلاگین مرجع برای Asana برای جستجوی مشکلات Asana در قسمت References موجودیت های TestRail مانند تستکیسها، اجراهای آزمایشی و نقاط عطف
شما مجبور نیستید از همه گزینه های یکپارچه سازی فهرست شده استفاده کنید، و می توانید ادغام را با ابزارهای دیگر ترکیب و مطابقت دهید. پیکربندی ادغام معمولاً فقط چند دقیقه طول می کشد. این راهنما نحوه پیکربندی ادغام و نحوه عملکرد آن را توضیح می دهد.
آدرس های اینترنتی نقص #
نشانیهای وب نقص برای اینکه TestRail بداند چگونه شناسه نقص را به URL برای نمونه Asana شما تبدیل کند، استفاده میشود. دو نوع URL وجود دارد: مشاهده URL ها و Add URLs.
را نشانی وب مشاهده نقص برای ایجاد پیوند به آسانا بر اساس شناسه نقص استفاده می شود، بنابراین می توانید به سادگی روی یک شناسه کلیک کنید تا موضوع به طور مستقیم در آسانا باز شود.
را نقص اضافه کردن URL برای ایجاد پیوند به صفحه ایجاد مشکل در داخل آسانا استفاده می شود. هنگامی که URL پیکربندی شد، یک پیوند افزودن جدید در کنار فیلد Defects در گفتگوی Add Test Result ظاهر می شود و نقص منو در نقص فشاری TestRail از هر کجا ویژگی این پیوند به شما امکان می دهد برای گزارش یک اشکال جدید به فرم شماره جدید Asana بروید.
اگر می بینید اضافه کنید پیوند، می توانید شناسه شماره جدید آسانا خود را کپی کنید و آن را در هر قسمت نقص یا مرجع در TestRail وارد کنید.
می توانید URL های Asana را در TestRail به صورت جهانی در زیر پیکربندی کنید اداره > یکپارچه سازی یا بر اساس هر پروژه در تنظیمات هر پروژه. برای پیکربندی آدرس ها از URL های مثال زیر استفاده کنید:
Asana installation
Defect View Url: https://app.asana.com/0/0/%id%
Defect Add Url: https://app.asana.com/0/<project_id>/list#
پیوند مستقیمی به صفحه ایجاد مشکل جدید در Asana وجود ندارد، بنابراین URL افزودن نیز می تواند https://app.asana.com/۰/home/ یا هر پیوند دیگری به صفحه فرود Asana باشد.
لطفا حتما تعویض کنید <project_ID> با شناسه پروژه واقعی در آسانا که می خواهید با آن ادغام شوید.
اگر افزونه نقص را پیکربندی کردهاید، میتوانید روی شناسه نقص نگه دارید تا جزئیات مشکل را مستقیماً از داخل TestRail مشاهده کنید.
URL های مرجع #
URL های مرجع به شیوه ای بسیار شبیه به URL های نقصی که در بالا توضیح داده شد پیاده سازی می شوند. تفاوت اصلی این است که URL های مرجع برای فیلد “مرجع” در موجودیت های مختلف TestRail (به جای قسمت نقص) استفاده می شود.
مرجع مشاهده URL به همان روشی که در بالا توضیح داده شد پیکربندی شده است و به TestRail اجازه می دهد تا یک پیوند مستقیم به یک Asana بر اساس شناسه وارد شده در فیلد References ایجاد کند.
مرجع URL را اضافه کنید همچنین به همان روش Defect Add URL پیکربندی شده است. پس از پیکربندی، یک اضافه کنید پیوند در کنار هر فیلد References در نمونه یا پروژه شما ظاهر می شود. اگر از اضافه کنید پیوند، می توانید شناسه شماره جدید آسانا خود را کپی کنید و آن را در هر قسمت نقص یا مرجع در TestRail وارد کنید.
اگر افزونه Reference را پیکربندی کردهاید، میتوانید ماوس را روی شناسه مرجع نگه دارید تا جزئیات مشکل را مستقیماً از داخل TestRail مشاهده کنید. به خواندن ادامه دهید تا نحوه استفاده و پیکربندی افزونه های نقص و مرجع را بیاموزید.
پلاگین نقص #
پلاگینهای نقص را میتوان برای پیادهسازی ادغام ردیاب اشکال عمیقتر استفاده کرد و TestRail با یک پلاگین نقص آماده برای استفاده آسانا ارائه میشود. برای پیکربندی افزونه نقص، را انتخاب کنید اداره > یکپارچه سازی و انتخاب کنید آسانا در افزونه نقص لیست کشویی گام بعدی این است که تمام تنظیمات اتصال لازم را در قسمت پیکربندی کنید [اتصال] دسته بندی همچنین می توانید با ویرایش تنظیمات پروژه، ادغام را برای یک پروژه خاص پیکربندی کنید.
#
ادغام به GID فضای کاری برای نمونه Asana شما نیاز دارد. شما می توانید GID را در https://app.asana.com/api/1.0/workspaces، یا با استفاده از یک سرویس گیرنده API یا مرورگر وب.
پلاگین نقص از API Asana استفاده می کند، بنابراین برای اتصال به API به اعتبارنامه های معتبر نیاز است. میتوانید یک رمز دسترسی شخصی برای همه کاربران آسانا وارد کنید یا میتوانید متغیرهای کاربر را وارد کنید تا به هر کاربر TestRail اجازه دهید توکن خود را پیکربندی کند. یک توکن جدید را می توان در آن ایجاد کرد کنسول توسعه دهنده آسانا.
#
ما قویاً توصیه می کنیم که متغیرهای کاربر را پیکربندی کنید. شما می توانید در مورد پیکربندی این موارد در ما بیشتر بیاموزید مستندات متغیرهای کاربر.
با پیکربندی افزونه نقص، گزینه فشار دادن یک نقص جدید در منوی Defect from Anywhere و همچنین در گفتگوی Add Result در یک اجرای تست ظاهر می شود. این گفتگو به شما امکان می دهد بدون خروج از TestRail یک شماره جدید در Asana ایجاد کنید.
سفارشی سازی ها #
پلاگین نقص Asana برای کار با پیکربندی استاندارد Asana ساخته شده است. TestRail به شما امکان میدهد فیلدهایی را که در کادر محاورهای Push ظاهر میشوند و همچنین هنگام نگه داشتن ماوس روی شناسههای نقص سفارشی کنید. فیلدهای فشار از پیش پیکربندی شده و فیلدهای شناور را می توان در بخش های [push.fields] و [hover.fields] مربوطه روی «روشن» یا «خاموش» تنظیم کرد یا ترتیب ظاهر شدن آنها را بر اساس فیلدهای هر بخش تغییر داد.
لطفاً به خاطر داشته باشید که برخی از فیلدها (مانند فیلد عنوان) همیشه فعال هستند و ممکن است در این بخش ها ظاهر نشوند به دلیل وجود همیشه مورد نیاز TestRail یا Asana.
پلاگین نقص Asana همچنین از اصلاح خصوصیات فیلد و همچنین فیلدهای سفارشی پشتیبانی می کند.
علاوه بر فعال کردن، غیرفعال کردن یا سازماندهی مجدد فیلدها همانطور که در بالا توضیح داده شد، امکان تغییر گزینه های اضافی در هر فیلد نیز وجود دارد. برای انجام این کار، باید یک بخش مانند [push.field.description] برای فیلد تعریف کنید و گزینه های اضافی را در این بخش مشخص کنید.
[field.settings.description]
label=Detailed Description
required=trueلطفاً برای لیست کامل و توضیح گزینه های فیلد موجود به زیر مراجعه کنید:
| گزینه | توضیحات |
|---|---|
| برچسب | نام نمایش فیلد را در گفتگوی Push Defect مشخص می کند (برای فیلدهای سفارشی لازم است) |
| اندازه | مشخص می کند که آیا فیلد به صورت یک فیلد فشرده نمایش داده می شود یا خیر (فشرده) یا از تمام عرض دیالوگ استفاده می کند (کامل) |
| به یاد داشته باشید | مشخص می کند که آیا مقادیر انتخاب شده قبلی برای این فیلد باید در دفعه بعد که گفتگوی Push Defect باز می شود به خاطر بسپارند و بازیابی شوند. |
| مورد نیاز است | اجباری یا اختیاری بودن این فیلد را مشخص میکند و آیا کاربران باید مقداری را برای این فیلد در گفتگوی Push Defect وارد کنند. |
| نوع | نوع این فیلد را مشخص می کند، لطفاً بخش فیلدهای سفارشی را در زیر برای لیستی از انواع فیلدهای پشتیبانی شده ببینید (برای فیلدهای سفارشی لازم است) |
فیلدهای سفارشی #
همچنین می توانید از رویکرد فوق برای افزودن فیلدهای سفارشی به گفتگوی Push Defect TestRail استفاده کنید. برای انجام این کار، کافی است یک خط با فیلد سفارشی خود به بخش [push.fields] اضافه کنید تا یک فیلد اضافه شود:
[push.fields]
...
description=on
customfield_11102=onسپس، بخش [field.settings.customfield_] را اضافه کنید. این بخش مورد نیاز است تا افزونه بتواند داده ها را از ابزار شما فشار دهد و/یا بازیابی کند. نمونه زیر است:
[field.settings.customfield_11102]
label=Customer
size=compact
type=dropdown
required=true#
فیلدهای سفارشی به حساب های Asana برتر نیاز دارند. GID برای فیلدهای سفارشی را می توان از طریق Asana API به دست آورد مستندات فیلدهای سفارشی آسانا.
برچسب و نوع تنظیمات فیلد مورد نیاز برای فیلدهای سفارشی هستند.
انواع فیلدهای زیر پشتیبانی می شوند:
| نوع فیلد | توضیحات |
|---|---|
| بوول | یک منوی کشویی بله/خیر برای مقادیر درست/نادرست، بله/خیر یا مقادیر باینری مشابه. |
| تاریخ | یک فیلد رشته ای که مقدار تاریخ YYYY-MM-DD یا ساختار مشابهی را می پذیرد. قالب بندی ممکن است به نیازهای ابزار یکپارچه بستگی داشته باشد. |
| تاریخ | یک فیلد رشتهای که مقدار تاریخ و زمان YYYY-MM-DD HH:MM یا ساختار مشابهی را میپذیرد. قالب بندی ممکن است به نیازهای ابزار یکپارچه بستگی داشته باشد. |
| کشویی | یک لیست کشویی که به کاربران امکان می دهد یکی از چندین گزینه را انتخاب کنند |
| عدد صحیح | |
| چند انتخابی | به کاربران امکان می دهد چندین گزینه از پیش تعریف شده را انتخاب کنند. |
| رشته | یک فیلد متن آزاد کوچک با حداکثر ۲۵۰ کاراکتر. |
| متن | یک فیلد متن آزاد بزرگ بدون محدودیت اندازه عملی. |
پیوست ها #
پلاگین نقص آسانا از ارسال پیوست ها به آسانا نیز پشتیبانی می کند. این فیلد را می توان روشن و خاموش کرد، اما نمی توان آن را سفارشی کرد. برای ارسال یک یا چند پیوست به آسانا، به سادگی پیوست را به پیوستها یا قسمتهای توضیحات کادر محاوره فشار دهید یا روی ناحیه کلیک کنید تا یک پیوست از سیستم فایل خود انتخاب کنید.
پلاگین مرجع #
پلاگین های مرجع را می توان برای بازیابی اطلاعات اضافی از شناسه های وارد شده در قسمت References موجودیت های TestRail، مانند تستکیسها، اجرای تست و نقاط عطف استفاده کرد. پلاگین مرجع در تب مراجع تنظیمات یکپارچه سازی به همان روشی که افزونه نقص پیکربندی شده است پیکربندی می شود.
این افزونه از شناور شدن روی شناسه های مرجع پشتیبانی می کند اما از یک گفتگوی فشاری برای فیلد مراجع پشتیبانی نمی کند. همچنین میتوان فیلدهایی را که از طریق شناور کردن پیوند ظاهر میشوند سفارشی کرد و فیلدهای سفارشی را همانطور که در بالا توضیح داد اضافه کرد.
اگر افزونه Defect را قبلاً برای Asana پیکربندی کردهاید، میتوانید به سادگی بخشهای [connection] و [hover.fields] خود را از افزونه نقص در پیکربندی پلاگین مرجع کپی کنید. همچنین، میتوانید فیلدهای مختلفی را برای نمایش References و Defects انتخاب کنید.
سفارشی سازی های اضافی #
TestRail همچنین از افزونه های نقص سفارشی پشتیبانی می کند. اگر تیم شما از TestRail Server استفاده میکند، میتوانید افزونه نقص را بیشتر سفارشی کنید (یا خودتان بسازید) تا از انواع فیلدهای اضافی یا دادههای دیگر پشتیبانی کند. لطفا ما را ببینید اسناد پلاگین های سفارشی برای اطلاعات بیشتر
