عیب‌یابی Postman Flows

گاهی Flow دقیقا کاری را که انتظار دارید انجام نمی‌دهد. Troubleshooting یعنی پیدا کردن دلیل تفاوت بین رفتار واقعی Flow و نتیجه‌ای که انتظار داشتید. Postman Flows چند ابزار داخلی دارد که این کار را ساده‌تر می‌کند.

پیش‌نمایش input، output و details #

بیشتر blockها وقتی روی آن‌ها کلیک می‌کنید، پیش‌نمایش داده ورودی و خروجی را نشان می‌دهند. در Create with AI block، بخش Details هم prompt را نمایش می‌دهد. این پیش‌نمایش برای بررسی اینکه داده ورودی و خروجی درست است یا نه بسیار مفید است.

برای دیدن داده، روی block کلیک کنید و سپس Input، Output یا Details را انتخاب کنید.

استفاده از Display block #

Display block داده‌ای را که از آن عبور می‌کند تغییر نمی‌دهد. به همین دلیل برای مشاهده داده بین دو block گزینه خوبی است. اگر یک HTTP Request block داده زیادی برمی‌گرداند، می‌توانید فقط بخش مرتبط را انتخاب کنید و در Display block نمایش دهید تا عیب‌یابی ساده‌تر شود.

Run logs #

Run logs فعالیت blockها را برای اجراهای مشخص نشان می‌دهد. از toolbar گزینه View run logs را باز کنید. سپس می‌توانید هر run را بر اساس زمان شروع انتخاب کنید و روی blockها کلیک کنید تا input، output، test results و details آن‌ها را ببینید.

همچنین می‌توانید نتیجه‌ها را بر اساس نوع block و وضعیت run فیلتر کنید. برای دیدن و دانلود نتیجه تست‌های همه HTTP Request blockها، روی All tests کلیک کنید.

Postman Console #

هر request و response در Postman Console ثبت می‌شود. Console تاریخچه اتفاق‌هایی را نشان می‌دهد که در Flow رخ داده‌اند. اگر لازم است داده خاصی را در Console ببینید، از Log block استفاده کنید.

این روش مخصوصا در loopها مفید است، چون Display block معمولا بعد از پایان Flow فقط آخرین item عبورکرده را نشان می‌دهد.

نکته‌های کلی برای عیب‌یابی #

• اگر request شکست می‌خورد، run logs و Console را بررسی کنید و مطمئن شوید variableها درست مقداردهی شده‌اند.
• اگر request از environment variable استفاده می‌کند، مطمئن شوید environment درست در HTTP Request block انتخاب شده است.
• وقتی نتیجه مطابق انتظار نیست، در مسیر عبور داده از Display یا Log block استفاده کنید.
• هر بار فقط یک علت احتمالی را تست کنید تا مشکل را به یک block یا یک مرحله محدود کنید.

منبع آموزشی: Postman Docs، بازنویسی و ساده‌سازی‌شده برای کاربران فارسی‌زبان.