Integration مربوط به defect tracker در TestRail قابلیتی دارد که به شما اجازه میدهد متغیرها و فیلدهایی تعریف کنید تا کاربران آنها را پر کنند. سپس میتوانید از این متغیرها بهعنوان placeholder در تنظیمات integration با defect tracker استفاده کنید.
شاید بپرسید این قابلیت چه کاربردی دارد. فرض کنید میخواهید کاربران TestRail بتوانند برای ارسال bug report از حساب defect tracker خودشان استفاده کنند، نه مثلا از یک حساب عمومی مثل «QA» برای همه تسترها. با استفاده از متغیرهای کاربر، کاربران میتوانند login name و password مربوط به defect tracker خود را بهصورت امن در TestRail وارد کنند تا نگاشت کاربران بین دو سیستم سادهتر انجام شود.
این مقاله قابلیت متغیرهای کاربر را بهصورت کلی توضیح میدهد و مراحل دقیق راهاندازی نگاشت کاربران از طریق متغیرها را شرح میدهد، چون این یکی از کاربردهای رایج این قابلیت است.
متغیرهای کاربر چگونه کار میکنند #
میتوانید متغیرهای کاربر جدید را از مسیر Administration > Integration. پس از اینکه متغیرهای کاربر را تعریف کردید، کاربران میتوانند اطلاعات مربوط به این متغیرها را از بخش My Settings وارد کنند؛ این بخش از طریق لینک My Settings در گوشه بالا سمت راست رابط کاربری TestRail در دسترس است.
بعد از آن میتوانید از متغیرهای کاربر بهعنوان placeholder در پیکربندی defect plugin استفاده کنید. برای مثال، اگر متغیر کاربری با system name «jira_user» تعریف کرده باشید، کافی است %jira_user% را در کادر پیکربندی وارد کنید تا TestRail آن را برای هر کاربر با مقدار مربوط به همان کاربر جایگزین کند. برای دیدن یک نمونه عملی از کاربرد این قابلیت، بخش بعدی را ببینید.
پیکربندی نگاشت کاربران #
بهطور پیشفرض، معمولا از یک حساب کاربری واحد در defect tracker خود استفاده میکنید تا همه bug reportها از TestRail به ابزار شما ارسال شوند؛ فرقی نمیکند چه کسی bug report را از TestRail ارسال کرده باشد. یعنی همه bug reportها در bug tracker شما با همان یک کاربر ساخته میشوند. معمولا برای این کار یک حساب عمومی مانند testrail یا qa ایجاد میکنید. متغیرهای کاربر راه سادهای برای نگاشت کاربران بین TestRail و ابزار defect tracking شما فراهم میکنند و این بخش توضیح میدهد چطور این کار را انجام دهید.
ابتدا باید دو متغیر تعریف کنید تا کاربران TestRail بتوانند login name و password مربوط به bug tracker خود را وارد کنند. در این مثال فرض میکنیم میخواهیم TestRail را با Jira یکپارچه کنیم، اما شما میتوانید Jira را با نام ابزاری که استفاده میکنید جایگزین کنید. برای تنظیم متغیرهای کاربر، این مراحل را دنبال کنید:
- به مسیر Administration > Integration بروید
- روی لینک Add User Variable در پایین فرم کلیک کنید
- در فیلد Label ، مقدار Jira User را وارد کنید
- در فیلد Description ، مقدار Your Jira user name را وارد کنید
- در فیلد System name ، مقدار jira_user را وارد کنید
- نوع String را انتخابشده نگه دارید
- برای گزینه Fallback در فیلد موردنظر، پیشنهاد میکنیم یک کاربر عمومی با نام «testrail» را که در Jira ساختهاید وارد کنید. این مقدار برای همه کاربرانی استفاده میشود که اطلاعات ورود Jira خود را وارد نکردهاند. اگر Fallback را مشخص نکنید، TestRail یک پیام نمایش میدهد و از کاربران میخواهد اطلاعات خود را در بخش My Settings وارد کنند تا بتوانند bug report ارسال کنند.
- روی OK کلیک کنید تا user variable ذخیره شود.
لطفاً یک user variable دیگر هم با تنظیمات زیر ایجاد کنید:
- Label: Jira Password
- Description: Your Jira password
- System Name: jira_password
- Type: Password
- Fallback: رمز عبور کاربر عمومی «testrail» که در Jira ساختهاید (اختیاری)
برای passwordهای واقعی، حتماً نوع فیلد Password را انتخاب کنید. با این کار، passwordها در رابط کاربری TestRail بهصورت متن ساده نمایش داده نمیشوند.
همچنین حتماً روی دکمه Save Settings در فرم Integration کلیک کنید. حالا کاربران میتوانند صفحه My Settings خود را باز کنند و تب Settings را انتخاب کنند تا اطلاعات ورود Jira خود را وارد کنند:
حالا مرحله آخر این است که از user variableها در پیکربندی defect plugin استفاده کنید. برای این کار کافی است system name را بین علامتهای درصد قرار دهید، مثل %jira_user%. پیکربندی defect plugin در مثال ما میتواند به این شکل باشد:
; Please configure your Jira connection below
[connection]
address=http://jira/
user=%jira_user%
password=%jira_password%همین! کاربران اکنون میتوانند اطلاعات ورود به defect tracker خود را در بخش My Settings وارد کنند و TestRail از همین اطلاعات برای ارسال bug report استفاده میکند.
نکته: اگر ابزار defect tracking شما از آدرس ایمیل بهعنوان نام کاربری ورود استفاده میکند، TestRail دو user variable داخلی هم دارد که میتوانید بدون تعریف متغیر اضافی از آنها استفاده کنید:
-
%user_email%– آدرس ایمیل کاربر TestRail -
%user_name%– نام کامل کاربر TestRail
استفاده پیشرفته #
اگر در حال سفارشیسازی یک defect plugin موجود هستید یا حتی plugin خودتان را میسازید، میتوانید از داخل کدتان مستقیماً به هر user variable تعریفشده دسترسی داشته باشید. از آنجا که user variableها بخشی از $context متغیر هستند، میتوانید بهسادگی به user variableها به این شکل دسترسی پیدا کنید:
$context['user']->settings['jira_user']با استفاده از user variableها در defect plugin میتوانید در صورت نیاز، رفتارها و تنظیمات متفاوتی را برای کاربران مختلف پیادهسازی کنید.
