Collections and Organizing Requests (Postman)

جمع‌بندی آزمونی سرفصل

Collection در Postman چیست؟

Collection مجموعه‌ای از درخواست‌های API است که برای سازماندهی، نگهداری و اجرای منظم تست‌ها استفاده می‌شود.

در واقع Collection مثل یک Test Suite در API Testing عمل می‌کند.

ساختار Collection

یک Collection می‌تواند شامل:

• Requests (GET, POST, PUT, DELETE…)

• Folders (برای دسته‌بندی منطقی)

• Variables

• Scripts (Pre-request / Tests)

• Documentation

• Examples

اهمیت Collections در API Testing

• سازماندهی تست‌ها

• اجرای گروهی تست‌ها

• Reusability

• Automation

• Regression Testing

• Collaboration بین تیم‌ها

Folder در Collection

Folder برای دسته‌بندی منطقی Requestها استفاده می‌شود.

مثال:

Customer APIs
   ├── Create Customer
   ├── Get Customer
   ├── Update Customer

Collection Runner چیست؟

ابزاری در Postman برای اجرای کل یا بخشی از Collection به صورت پشت سر هم.

کاربرد:

• اجرای Regression Test

• اجرای Smoke Test

• اجرای batch request

اجرای بخشی از Collection

می‌توان:

• فقط یک Collection

• یا فقط یک Folder خاص
  را اجرا کرد.

👉 این قابلیت برای تست‌های ماژولار بسیار مهم است.

Environment Integration

Collections می‌توانند با Environment Variables کار کنند.

مثال:

{{baseUrl}}/customers

کاربرد:

• تغییر سریع بین Dev / QA / Prod

• جلوگیری از hardcode شدن URL

• افزایش انعطاف تست‌ها

Variables در Collection

در Collection می‌توان از Variable استفاده کرد:

• Collection Variables

• Environment Variables

• Global Variables

• Local Variables

مثال:

{{token}}

Variable Precedence (اولویت‌ها)

ترتیب اولویت:

1. Local Variable

2. Data Variable (Runner)

3. Environment Variable

4. Collection Variable

5. Global Variable

Data-driven Testing

اجرای یک Collection با داده‌های مختلف (CSV / JSON)

کاربرد:

• تست چندین کاربر

• تست سناریوهای مختلف

• افزایش coverage

Chaining Requests

استفاده از خروجی یک Request در Request بعدی.

مثال:

1. Login → گرفتن token

2. استفاده از token در Request بعدی

{{token}}

Collection Runner

ویژگی مهم Postman برای:

• اجرای sequential requests

• استفاده از data file

• اجرای regression suite

Regression Pack

مجموعه تست‌هایی که برای اطمینان از عدم خراب شدن سیستم استفاده می‌شود.

کاربرد:

• بعد از تغییرات سیستم

• قبل از release

Smoke Pack

مجموعه تست‌های سبک و سریع برای بررسی سلامت سیستم.

کاربرد:

• بررسی سریع deployment

• sanity check

Export / Import Collection

• Export: ذخیره Collection به JSON

• Import: وارد کردن Collection از فایل یا Swagger/cURL

نکات مهم آزمونی (L7 → L8)

1. Collection = Test Suite

• در سطح سازمانی برای مدیریت API test cases

2. Execution Models

• Single request execution

• Folder execution

• Full collection execution

• Data-driven execution

3. Automation Layer

• Collection Runner

• Newman (CLI)

• CI/CD integration

4. Test Design Strategy

• Regression Pack → کامل

• Smoke Pack → سریع

• Data-driven → coverage بالا

5. Real-world Testing Flow

• Setup Environment

• Run Login → get token

• Chain requests

• Validate response

• Run regression suite

خطاهای رایج در آزمون

• عدم تفکیک Collection و Folder

• استفاده نکردن از environment

• عدم درک variable precedence

• نداشتن chaining logic

• عدم استفاده از data-driven testing

• اجرای تست بدون regression strategy

نکته امتحانی مهم

در پاسخ کامل باید این کلیدواژه‌ها دیده شوند:

Collection, Folder, Runner, Environment, Variables, Chaining, Data-driven Testing, Regression Pack, Smoke Pack, Automation, Newman

نمونه پاسخ کامل کوتاه

Collections in Postman مجموعه‌ای از API requests هستند که برای سازماندهی، اجرای گروهی و اتوماسیون تست‌ها استفاده می‌شوند. Collections شامل Requestها، Folderها، Variables و Scripts هستند و می‌توان آن‌ها را از طریق Collection Runner یا Newman اجرا کرد. همچنین امکان Data-driven Testing، Chaining Requests و تعریف Regression Pack و Smoke Pack برای مدیریت تست‌ها وجود دارد.

کلیدواژه‌ها

Postman Collection Folder Collection Runner Environment Variables Variable Precedence Data-driven Testing Chaining Requests Regression Pack Smoke Pack Automation Newman Test Suite API Testing Strategy

Collection (مجموعه‌ای از API requests): برای سازماندهی و اجرای گروهی تست‌ها استفاده می‌شود.

Folder (دسته‌بندی داخل Collection): برای گروه‌بندی منطقی درخواست‌ها استفاده می‌شود.

Collection Runner (اجرای گروهی تست‌ها): برای اجرای sequential test cases و regression testing استفاده می‌شود.

Environment (محیط اجرا): برای مدیریت متغیرها در محیط‌های مختلف مثل Dev و Prod استفاده می‌شود.

Variables (متغیرها): برای جلوگیری از hardcode و افزایش انعطاف تست‌ها استفاده می‌شوند.

Data-driven Testing (اجرای تست با داده‌های مختلف): برای افزایش coverage و تست سناریوهای متعدد استفاده می‌شود.

Chaining Requests (وابستگی بین درخواست‌ها): استفاده از خروجی یک request در request بعدی.

Regression Pack (مجموعه تست کامل سیستم): برای اطمینان از عدم شکست سیستم بعد از تغییرات استفاده می‌شود.

Smoke Pack (تست سریع سلامت سیستم): برای بررسی سریع deploy یا sanity check استفاده می‌شود.

جمع‌بندی ذهنی

Collections یعنی:
👉 “مدیریت حرفه‌ای تست‌ها + اجرای قابل اتوماسیون + آماده‌سازی برای پروژه واقعی”