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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

- کلیک کنید تنظیمات را ذخیره کنید

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

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

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

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







