#
این مقاله به ادغام با مشکلات GitHub. اگر به دنبال اطلاعاتی در مورد ادغام CI/CD هستید، لطفاً به مستندات موجود در آن مراجعه کنید ادغام با GitHub Actions.
TestRail با GitHub ادغام می شود، بنابراین تیم شما می تواند مشکلات را بین TestRail و GitHub پیوند دهد، مشاهده کند، اضافه کند، و به عنوان اشکال / نقص، الزامات / مراجع، یا هر دو. ادغام TestRail با GitHub از موارد استفاده زیر پشتیبانی می کند:
- موارد آزمون را به الزامات پیوند دهید
- شروع به ایجاد الزامات از TestRail کنید
- مشاهده الزامات در TestRail
- عیوب را به نتایج تست پیوند دهید
- نقص های جدید را در GitHub ارسال کنید
- نقص های جدید را از TestRail ارسال کنید
- مشاهده عیوب در TestRail
لازم نیست از همه گزینه های ادغام فهرست شده استفاده کنید. می توانید ادغام را با ابزارهای دیگر ترکیب و مطابقت دهید. پیکربندی ادغام معمولاً فقط چند دقیقه طول می کشد. این راهنما نحوه پیکربندی ادغام و نحوه عملکرد آن را توضیح می دهد.
موارد آزمون را به الزامات پیوند دهید #
برای تنظیم پوشش آزمایشی، زمانی که در حال ایجاد یا ویرایش تستکیسها هستید، به سادگی یک یا چند شناسه مورد کاری (که با کاما از هم جدا شده اند) به آن اضافه کنید. مراجع زمینه

را مراجع در تستکیسها خود تنظیم کرده اید به یک پیوند مستقیم به مسائل GitHub تبدیل می شود.

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

پیکربندی آدرس افزودن مرجع #
برای شروع ایجاد الزامات جدید از TestRail، باید GitHub را پیکربندی کنید مرجع اضافه کردن آدرس در TestRail با دنبال کردن مراحل زیر.
- برو به مدیر صفحه، انتخاب کنید یکپارچه سازی برای پیکربندی جهانی یا پروژه ها برای یک پروژه واحد، و باز کنید مرجعبرگه s
- خود را وارد کنید مرجع اضافه کردن آدرس با استفاده از الگوی زیر
https://github.com/<OWNER>/<REPOSITORY>/issues/new - کلیک کنید تنظیمات را ذخیره کنید
مشاهده الزامات در TestRail #
TestRail می تواند اطلاعات اضافی را از شناسه های وارد شده در آن بازیابی کند مراجع زمینه موجودیت های TestRail، مانند تستکیسها، اجرای تست، و نقاط عطف. به سادگی ماوس را روی پیوندها نگه دارید و یک گفتگو تمام آخرین اطلاعات را بدون نیاز به پیمایش به GitHub به شما نشان می دهد.

پیکربندی پلاگین مرجع #
برای مشاهده مستقیم نیازمندی ها در TestRail، باید GitHub را پیکربندی کنید پلاگین مرجع در TestRail با دنبال کردن مراحل زیر.
- ایجاد یک متغیر کاربر برای رمز دسترسی شخصی GitHub (PAT)
- برو به مدیر صفحه، انتخاب کنید یکپارچه سازی برای پیکربندی جهانی یا پروژه ها برای یک پروژه واحد، و برگه References را باز کنید
- خود را انتخاب کنید GitHub نوع در لیست کشویی پلاگین مرجع
- تنظیمات اتصال را در [اتصال] بخش
- آدرس: https://<GitHub_URL>/
- کاربر: نام کاربری شما برای Github
- رمز عبور: شما متغیر کاربر برای رمز دسترسی شخصی GitHub (PAT)
- مالک: صاحب مخزن GitHub
- نام: نام مخزن GitHub
- کلیک کنید تنظیمات را ذخیره کنید

#
برای ایجاد توکن GitHub API در حساب GitHub خود، بر روی آن کلیک کنید تنظیمات، سپس تنظیمات برنامه نویس. سپس بر روی کلیک کنید توکن های دسترسی شخصی در منوی سمت چپ کلیک کنید توکن جدید تولید کنید.
عیوب را به نتایج تست پیوند دهید #
را نشانی وب مشاهده نقص برای ایجاد پیوند به GitHub بر اساس شناسه نقص استفاده می شود، بنابراین می توانید به سادگی روی یک شناسه کلیک کنید تا مشکل را مستقیماً در GitHub باز کنید.
هنگامی که URL یکپارچه سازی Defect View را با مشکلات GitHub تنظیم می کنید، می توانید شناسه یک مشکل GitHub را در قسمت Defects نتیجه آزمایش جایگذاری کنید و TestRail به طور خودکار آن شناسه را به یک پیوند قابل کلیک تبدیل می کند تا مشکل را در GitHub مشاهده کند. این به تیم شما اجازه میدهد تا آزمایشها را با مشکلات GitHub مرتبط کند و گزارشهای نقص و ردیابی را در TestRail ایجاد کند.

پیکربندی آدرس اینترنتی Defect View #
برای پیوند دادن نقص ها به نتایج تست در TestRail، باید آدرس GitHub Defect View را در TestRail با دنبال کردن مراحل زیر پیکربندی کنید.
- برو به مدیر صفحه، انتخاب کنید یکپارچه سازی برای پیکربندی جهانی یا پروژه ها برای یک پروژه واحد، و باز کنید نقص برگه
- خود را وارد کنید نشانی وب مشاهده نقص با استفاده از الگوی زیر
https://github.com/<OWNER>/<REPOSITORY>/issues/%id% - کلیک کنید تنظیمات را ذخیره کنید
توجه داشته باشید : لطفا حتما تعویض کنید <OWNER> و <REPOSITORY>با مخزن واقعی و نام مالک در GitHub که می خواهید با آن ادغام شوید.

نقص های جدید را در GitHub ارسال کنید #
TestRail ناوبری سریع برای گزارش نقص با استفاده از رابط GitHub را فراهم می کند. شما می توانید آن را از دو مکان مختلف انجام دهید – منوی نقص و گفتگوی نتیجه آزمایش را اضافه کنید.
را منوی نقص، همچنین به عنوان TestRail’s شناخته می شود نقص از هر کجا ویژگی، برای دسترسی سریع در بالای اکثر صفحات نمایش داده می شود.

را گفتگوی نتیجه آزمایش را اضافه کنید را نمایش می دهد لینک اضافه کنید در کنار زمینه نقص برای پیمایش سریع و راحت به GitHub به منظور ارائه نقص در زمانی که آزمون شما ناموفق است.

پیکربندی Defect Add URL #
برای پیمایش سریع به GutHub برای ایجاد یک نقص جدید، باید URL نقص GitHub را در TestRail با دنبال کردن مراحل زیر پیکربندی کنید.
- برو به مدیر صفحه، انتخاب کنید یکپارچه سازی برای پیکربندی جهانی یا پروژه ها برای یک پروژه واحد، و باز کنید نقص برگه
- خود را وارد کنید نقص آدرس URL را اضافه کنید با استفاده از الگوی زیر
https://github.com/<OWNER>/<REPOSITORY>/issues/new - کلیک کنید تنظیمات را ذخیره کنید

توجه: لطفا حتما تعویض کنید <OWNER> و <REPOSITORY> با مخزن واقعی و نام مالک در GitHub که می خواهید با آن ادغام شوید.
نقص های جدید را از TestRail ارسال کنید #
برای افزایش یکپارچگی یکپارچه گزارش نقص، TestRail یک افزونه نقص GitHub از پیش پیکربندی شده ارائه می دهد. این افزونه به شما این امکان را می دهد که بدون زحمت مسائل جدید را مستقیماً از داخل TestRail به GitHub ارسال کنید.
با استفاده از شهود دیالوگ Push Defect، می توانید به سرعت یک نقص جدید با عنوان، توضیحات و هر فیلد اضافی که GitHub پشتیبانی می کند ایجاد کنید. این فرآیند کارآمد، گردش کار مدیریت نقص نرمتر را تضمین میکند.

می توانید گفتگوی ارسال نقص را از دو مکان باز کنید – منوی نقص و گفتگوی نتیجه آزمایش را اضافه کنید.
را منوی نقص، همچنین به عنوان TestRail’s شناخته می شود نقص از هر کجا ویژگی، برای دسترسی سریع در بالای اکثر صفحات نمایش داده می شود.

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

پیکربندی افزونه نقص #
برای ارسال عیوب جدید مستقیماً از TestRail، باید GutHub را پیکربندی کنید افزونه نقص در TestRail با دنبال کردن مراحل زیر.
- برو به مدیر صفحه، انتخاب کنید یکپارچه سازی برای پیکربندی جهانی یا پروژه ها برای یک پروژه واحد، و برگه References را باز کنید
- خود را انتخاب کنید GitHub نوع در لیست کشویی پلاگین مرجع
- تنظیمات اتصال را در [اتصال] بخش
- آدرس: https://<GitHub_URL>/
- کاربر: نام کاربری شما برای GitHub
- رمز عبور: رمز دسترسی شخصی GitHub شما (PAT)
- مالک: صاحب مخزن GitHub
- نام: نام مخزن GitHub
- کلیک کنید تنظیمات را ذخیره کنید

مشاهده عیوب در TestRail #
به سادگی روی پیوندهای نقص حرکت کنید و یک گفتگو تمام آخرین اطلاعات را بدون نیاز به پیمایش به GutHub به شما نشان می دهد. این پیوندها مستقیماً در نتایج تست و همچنین بخش نقص در آزمایشها، طرحهای آزمایشی و نقاط عطف موجود هستند.

پیکربندی افزونه نقص #
برای ارسال عیوب جدید مستقیماً از TestRail، باید GitHub را پیکربندی کنید افزونه نقص در TestRail با دنبال کردن مراحل زیر.
- برو به مدیر صفحه، انتخاب کنید یکپارچه سازی برای پیکربندی جهانی یا پروژه ها برای یک پروژه واحد، و برگه References را باز کنید
- خود را انتخاب کنید GitHub نوع در لیست کشویی پلاگین مرجع
- تنظیمات اتصال را در [اتصال] بخش
- آدرس: https://<GitHub_URL>/
- کاربر: نام کاربری شما برای GitHub
- رمز عبور: رمز دسترسی شخصی GitHub شما (PAT)
- مالک: صاحب مخزن GitHub
- نام: نام مخزن GitHub
- کلیک کنید تنظیمات را ذخیره کنید

#
برای ایجاد توکن GitHub API در حساب GitHub خود، بر روی آن کلیک کنید تنظیمات، سپس تنظیمات برنامه نویس. سپس بر روی کلیک کنید توکن های دسترسی شخصی در منوی سمت چپ کلیک کنید توکن جدید تولید کنید.
همچنین امکان سفارشی سازی فیلدهایی که از طریق شناور کردن پیوند ظاهر می شوند وجود دارد. شما می توانید اطلاعات بیشتر در مورد نحوه انجام آن را در سفارشی کردن پلاگین های مورد نیاز/ نقص بخش
سفارشی سازی های پیشرفته #
متغیرهای کاربر #
توصیه می کنیم استفاده کنید متغیرهای کاربر هنگام پیکربندی هر گونه اعتبار یکپارچه سازی. این به شما این امکان را میدهد تا اعتبارنامههای عمومی را بدون افشای آنها ارائه کنید، و همچنین به کاربران اجازه میدهد تا برای کنترل دسترسی بهتر، اعتبارنامههای خود را در تنظیمات شخصیشان تعریف کنند. در زیر می توانید نمونه ای از نحوه تنظیم متغیرها در پیکربندی خود را مشاهده کنید.
user=%github_username%
password=%github_password%

سفارشی کردن پلاگین های مورد نیاز/ نقص #
پلاگین GitHub برای کار با پیکربندی استاندارد GitHub ساخته شده است. TestRail به شما امکان میدهد فیلدهایی را که در کادر محاورهای Push ظاهر میشوند و همچنین هنگام نگهداشتن ماوس روی شناسههای مورد کار، هم برای نیازمندیها و هم برای نقصها، سفارشی کنید. فیلدهای فشار از پیش تنظیم شده و فیلدهای شناور را می توان روی آن تنظیم کرد on یا off مربوط به خود [push.fields] و [hover.fields] بخش ها، و همچنین می توانید ترتیب آنها را تغییر دهید، که در UI منعکس می شود.
#
برخی از فیلدها (مانند عنوان) همیشه فعال هستند و ممکن است در این بخش ها ظاهر نشوند زیرا همیشه توسط TestRail یا GitHub مورد نیاز هستند.
علاوه بر فعال کردن، غیرفعال کردن یا سازماندهی مجدد فیلدها همانطور که در بالا توضیح داده شد، امکان تغییر گزینه های اضافی در هر فیلد نیز وجود دارد. برای انجام این کار، یک بخش برای فیلد تعریف می کنید، مانند [push.field.description] و گزینه های اضافی را در این قسمت مشخص کنید.
[push.field.description]
label=Detailed Description
required=true
لطفاً برای لیست کامل و توضیح گزینه های فیلد موجود به زیر مراجعه کنید:
| گزینه | توضیحات |
|---|---|
label |
نام نمایش فیلد را در گفتگوی Push Defect مشخص می کند (برای فیلدهای سفارشی لازم است) |
size |
مشخص می کند که آیا فیلد به صورت یک فیلد فشرده نمایش داده می شود یا خیر (compact) یا از تمام عرض دیالوگ استفاده می کند (full)
|
remember |
مشخص می کند که آیا مقادیر انتخاب شده قبلی برای این فیلد باید در دفعه بعد که گفتگوی Push Defect باز می شود به خاطر بسپارند و بازیابی شوند. |
required |
اجباری یا اختیاری بودن این فیلد را مشخص میکند و آیا کاربران باید مقداری را برای این فیلد در گفتگوی Push Defect وارد کنند. |
پیوست ها #
افزونه نقص GitHub از ارسال پیوست ها به GitHub نیز پشتیبانی می کند. این فیلد را می توان روشن و خاموش کرد، اما نمی توان آن را سفارشی کرد. برای ارسال یک یا چند پیوست به GitHub، به سادگی پیوست را به پیوستها یا قسمتهای توضیحات کادر محاوره فشار دهید یا روی ناحیه کلیک کنید تا یک پیوست از سیستم فایل خود انتخاب کنید.
#
برای فعال کردن پیوستها در محاوره فشار، «attachments=on» را به آن اضافه کنید [push.fields] بخش تنظیمات افزونه نقص.




