For block همیشه نقطه شروع یک حلقه است. این block یک control block در Postman Flows محسوب میشود و برای اجرای چندباره یک زنجیره از blockها در Flow به کار میرود. ورودی آن یک آرایه است و هر آیتم آرایه را جداگانه و به ترتیب از پورت خروجی خود ارسال میکند.
در پایان حلقه، بعد از blockهایی که داده را پردازش میکنند، باید یک Collect block داشته باشید. Collect block آیتمهایی را که For block جداگانه ارسال کرده است جمع میکند و آنها را دوباره با ترتیب اصلی در یک آرایه قرار میدهد.
Inputs #
List یک آرایه از مقدارها را میپذیرد؛ مثل [1,2,3] یا ["one","two","three"]. برای اجرای For block باید یک آرایه به این ورودی ارسال شود.
Start اختیاری است. اگر blockی به این ورودی وصل نباشد، رسیدن داده به ورودی List باعث اجرای For block میشود.
اگر block دیگری را به ورودی Start وصل کنید، For block فقط وقتی اجرا میشود که از هر دو ورودی List و Start داده دریافت کرده باشد. این رفتار برای کنترل ترتیب اجرای blockها مفید است. برای مثال، اگر یک HTTP Request block را به Start وصل کنید، For فقط بعد از رسیدن داده به هر دو ورودی اجرا میشود.
Output #
Item هر آیتم موجود در لیست را به ترتیب و یکییکی ارسال میکند.
Setup #
برای راهاندازی For block، ورودی List را به خروجی blockی وصل کنید که آرایه ارسال میکند. نمونههایی از blockهایی که میتوانند آرایه ارسال کنند عبارتاند از:
- List block
- Get Variable block با متغیری که مقدار آرایهای دارد
- Evaluate block همراه با یک List block درجشده
- Select block که یک آرایه را انتخاب میکند
در صورت نیاز میتوانید ورودی Start را هم به خروجی block دیگری وصل کنید تا اجرای For با آن block هماهنگ شود.
Example #
Postman برای مشاهده نمونه، Flow Snippet با نام Flow Snippets: For را ارائه کرده است.
Related blocks #
برای تأمین آرایه مورد نیاز For block از blockهایی استفاده کنید که در بخش Setup آمدهاند. گزینه دیگر برای شروع حلقه، Repeat block است که برای حلقههای مبتنی بر تعداد اجرا استفاده میشود.
Related pages #
- Loops overview
- Create a count-based loop with the Repeat block
- Create a dashboard using Postman Flows
- Create a list-based loop with the For block
- Send information from one system to another using Postman Flows
منبع آموزشی: Postman Docs، بازنویسی و سادهسازیشده برای کاربران فارسیزبان.
