پارامترسازی تست یعنی همان تست را با چند مقدار متفاوت اجرا کنید. این نوع تست مبتنی بر داده به شما امکان میدهد منطق یا عملکرد اصلی یکسانی را در برنامه خود با ورودیهای مختلف تست کنید، بدون اینکه مجبور باشید test caseهای تکراری را کپی و نگهداری کنید.
در TestRail میتوانید تستهای پارامتری را با استفاده از test data اجرا کنید؛ test data اصطلاحی کلی است که متغیرها، datasetها و مقدارهای مخصوص هر project را شامل میشود. test data به تسترها کمک میکند متغیرهای تست و datasetهایی بسازند که مقدارهای هر متغیر را در خود دارند و از آنها در test caseها و test runها استفاده کنند. متغیرها را میتوان در فیلدهای متنی و string مربوط به test caseها وارد کرد؛ سپس در test run، مقدار متناظر همان متغیر در تست استفاده میشود.
با استفاده از تستهای پارامتری، test caseهای شما انعطافپذیرتر میشوند و میتوانید با تعداد caseهای کمتر، پوشش تست بیشتری داشته باشید.
#
قابلیت test data بهصورت پیشفرض برای هر instance از TestRail Enterprise که نسخه ۷.۶ یا جدیدتر را اجرا میکند در دسترس است.
بخشهای زیر توضیح میدهند چگونه در TestRail از test data، متغیرها و datasetها استفاده کنید:
- مجوزهای کاربر
- مدیریت test data
- افزودن متغیرهای test data به test caseها
- استفاده از test data در test runها & Plans
- endpointهای API مربوط به test data
مجوزهای کاربر #
test data برای هر project در instance شما در TestRail جداگانه تعریف میشود. مدیران با استفاده از نقشها و مجوزها تعیین میکنند تسترها چگونه میتوانند از این test data استفاده کنند. میتوانید نقشهایی مانند «Lead»، «Tester» و «Guest» بسازید و مجوزها را بر اساس کارهایی که هر نقش انجام میدهد تنظیم کنید.
مجوز Test Data and Variables که در ادامه مشخص شده است، تعیین میکند نقشهای کاربری در هر project چگونه میتوانند این دادهها را مدیریت کنند.
- افزودن/ویرایش: به کاربران اجازه میدهد در بخش مدیریت test data، متغیرها و datasetها را اضافه یا ویرایش کنند.
- حذف: به کاربران اجازه میدهد متغیرها و/یا datasetها را بهطور کامل حذف کنند.
برای اطلاعات بیشتر درباره پیکربندی نقشها و مجوزهای کاربر، به Permissions مراجعه کنید.
مدیریت test data #
هر project در TestRail یک داشبورد اختصاصی برای مشاهده و مدیریت test data همان project دارد. برای دسترسی به این داشبورد، در فهرست test runها، test suiteها یا test caseها روی دکمه View Test Data کلیک کنید.
در بخش مدیریت test data میتوانید مقدارهای جدید test data را اضافه کنید، دادههای موجود را ببینید و ویرایش کنید، و test data را از طریق CSV import یا export کنید. این نما جدولی از datasetها و متغیرهای موجود شما نشان میدهد. توجه داشته باشید که test data در هر project منحصر به همان project است.
- یک Variable همان placeholderی است که در test caseهای خود وارد میکنید. حداکثر میتوانید ۵۰۰ متغیر داشته باشید.
- یک Dataset مجموعهای از مقدارهای متناظر با هر متغیر است. همیشه یک dataset پیشفرض وجود دارد و میتوانید با اضافه کردن ستونهای جدید به جدول test data، تا ۹۹ dataset دیگر اضافه کنید؛ یعنی در مجموع ۱۰۰ dataset.
نام Variableها و Datasetها باید این معیارها را داشته باشد:
- باید فقط شامل حروف، اعداد و آندرلاین باشد (بدون فاصله یا کاراکتر خاص)
- نباید با آندرلاین شروع شود.
- نباید بیشتر از ۵۰ کاراکتر باشد
- نام متغیرها باید در project فعلی یکتا باشد
- نام datasetها باید در project فعلی یکتا باشد
- در نامها، بزرگی و کوچکی حروف مهم است
datasetها لازم نیست برای هر متغیر مقدار داشته باشند. اگر مقدار یک dataset خالی باشد، test caseهای مرتبط، در صورت وجود، از مقدار dataset پیشفرض استفاده میکنند.
داشبورد test data به شما امکان میدهد کارهای زیر را انجام دهید:
ویرایش test data #
روی Edit کلیک کنید تا حالت ویرایش test data باز شود.
- برای افزودن یک متغیر جدید، نام متغیر جدید را در یکی از ردیفهای خالی ستون Variable جدول وارد کنید.
- برای افزودن یک dataset جدید، نام dataset جدید را در ردیف سربرگ جدول وارد کنید. سپس میتوانید مقدارهای جدید را به datasetهای جدید خود اضافه کنید.
- برای انتخاب کل ردیف یا ستون، روی شماره ردیف یا سربرگ ستون کلیک کنید. برای حذف کل ردیف یا ستون انتخابشده، روی گزینه حذف مقدارها کلیک کنید.
- برای نگهداشتن تغییرات، باید روی Save کلیک کنید.
#
test runهای باز همیشه مقدار فعلی dataset و متغیر را دریافت میکنند. ویرایش مقدارهای داخل datasetها روی هر test موجود در test runهای باز اثر میگذارد. وقتی یک test run یا test plan را میبندید، مقدارهای dataset در همان زمان ثبت و حفظ میشوند و یک رکورد ثابت ایجاد میشود.
ایجاد test runها #
روی Create Test Runs کلیک کنید تا بر اساس datasetهای خود test run ایجاد کنید. با این کار پنجره Create Test Runs باز میشود:
datasetهایی را که میخواهید برای test runهای خود استفاده کنید انتخاب کنید و سپس روی Continue کلیک کنید. TestRail اکنون به شما امکان میدهد انتخاب کنید با datasetهای انتخابشده چه کاری انجام شود؛ همانطور که در پنجره زیر نشان داده شده است.
این پنجره گزینههای زیر را برای runهای جدید شما ارائه میدهد:
-
ایجاد یک test plan شامل test runهای شما
- این گزینه یک test plan ایجاد میکند که برای هر dataset انتخابشده یک test run دارد. سپس TestRail صفحه ایجاد test plan جدید را باز میکند و test runهای جدید شما را در آن قرار میدهد.
-
افزودن test runهای خود به یک test plan موجود
- این گزینه برای هر dataset انتخابشده یک test run جدید ایجاد میکند و همچنین به شما امکان میدهد این test runها را به یک test plan موجود اضافه کنید. با انتخاب این گزینه، TestRail از شما test plan مقصد را میخواهد و سپس این runها را بهصورت خودکار به plan انتخابشده اضافه میکند.
-
ایجاد test runهای جداگانه
- این گزینه برای هر dataset انتخابشده یک test run جدید و جداگانه ایجاد میکند. میتوانید test caseها را برای این runها انتخاب کنید، اما همه test runها با مجموعه یکسانی از test caseها ساخته میشوند.
#
به خاطر داشته باشید که بعداً نمیتوانید این گزینهها را به یک test run جدید یا موجود اضافه کنید.
وارد کردن test data #
روی Import CSV کلیک کنید تا یک فایل CSV شامل datasetها و متغیرها وارد شود.
فایل خود و encoding مناسب آن را انتخاب کنید و سپس جداکننده CSV را مشخص کنید تا فرایند import شروع شود.
TestRail پیشنمایشی از دادههای importشده را نشان میدهد. قبل از import کردن دادهها بررسی کنید که پیشنمایش درست باشد. هر موردی که با رنگ سبز نمایش داده شود، مقدار جدید یا بهروزرسانیشده را نشان میدهد.
#
Import کردن دادههای تست از طریق CSV، همه مقدارهای مرتبط با datasetها و variableهای منطبق را بازنویسی میکند؛ حتی مقدارهای خالی.
Export کردن دادههای تست #
روی Export CSV کلیک کنید تا datasetهای خود را در یک فایل CSV export کنید. در پنجره Export CSV، datasetهایی را که میخواهید export شوند انتخاب کنید و سپس روی Export کلیک کنید.
افزودن variableهای داده تست به test caseها #
وقتی در project خود dataset و variable دارید، میتوانید از این دادهها در test caseهای خود استفاده کنید. هنگام ویرایش یک test case، میتوانید یک variable را در هر فیلد text، string، و separate step که از Markdown پشتیبانی میکند وارد کنید؛ از جمله shared test steps.
TestRail از استفاده از variableها در فیلدهایی غیر از موارد بالا، در عنوانهای test case، یا در هر فیلدی خارج از test caseها (مثل نام Sectionها، توضیحات Test Plan و موارد مشابه) پشتیبانی نمیکند.
درج یک variable در test case #
هنگام ویرایش یک test case، میتوانید نام variable را سریع وارد کنید؛ یا آن را مستقیم در فیلد و بین دو علامت درصد «%» تایپ کنید، یا با استفاده از دکمه variable یک variable موجود را انتخاب کنید.
استفاده از دادههای تست در test runها & و test planها #
وقتی یک test run از یک dataset استفاده میکند و test caseهای داخل آن test run متغیرها را فراخوانی میکنند، TestRail بهطور خودکار از مقدارهای dataset مرتبط در تستهای همان run استفاده میکند. این مقدارها در تست شما highlight میشوند تا بتوانید سریع تشخیص دهید کدام variableها در حال استفاده هستند:
test runهای باز همیشه مقدار فعلی dataset و variable را دریافت میکنند. اگر مقدارهای داخل datasetها را ویرایش کنید، این تغییر روی همه تستهای موجود در test runهای باز اثر میگذارد. بستن یک test run یا test plan، مقدارهای dataset را در زمان بسته شدن ثبت و حفظ میکند و یک رکورد ثابت میسازد.
میتوانید با ویرایش test run و انتخاب یک dataset از منوی کشویی، test runها را برای استفاده از datasetها تنظیم کنید.
همچنین میتوانید test runهای داخل test planها را برای استفاده از datasetها تنظیم کنید؛ برای این کار روی تب Description, References & & Data کلیک کنید و سپس از منوی کشویی، dataset موردنظر را انتخاب کنید؛ همانطور که در تصویر زیر نشان داده شده است:
endpointهای API مربوط به test data #
قابلیت Test Data در TestRail توسط TestRail API هم پشتیبانی میشود. endpointهای API زیر برای مشاهده و مدیریت test data شما در دسترس هستند:
- get_dataset
- get_datasets
- add_dataset
- update_dataset
- delete_dataset
- get_variables
- add_variable
- update_variable
- delete_variable
endpointهای Test Run و Test Plan هم از انتخاب dataset و استفاده از آن در test runها پشتیبانی میکنند.
لطفاً مستندات API را برای جزئیات بیشتر بررسی کنید.
