انتظار

از نود Wait برای توقف اجرای ورکفلو خود استفاده کنید. زمانی که ورکفلو متوقف می‌شود، داده‌های اجرا به پایگاه داده بارگذاری می‌شود. وقتی شرط ادامه فراهم شد، ورکفلو داده‌ها را مجدداً بارگذاری می‌کند و اجرا ادامه می‌یابد.

اکشن‌ها

نود Wait می‌تواند ادامه دهد بر اساس شرایط زیر:

• پس از فاصله زمانی: نود برای مدت زمان مشخصی منتظر می‌ماند.
• در زمان مشخص: نود تا زمان خاصی منتظر می‌ماند.
• در هنگام فراخوانی وب‌هوک: نود تا دریافت تماس HTTP منتظر می‌ماند.
• پس از ارسال فرم: نود تا دریافت ارسال فرم صبر می‌کند.

برای دستورالعمل‌های دقیق‌تر، به بخش‌های زیر مراجعه کنید.

پس از فاصله زمانی

منتظر یک مدت زمان مشخص باشید.

این پارامتر شامل دو فیلد دیگر است:

• مقدار انتظار: میزان زمان انتظار را وارد کنید.
• واحد انتظار: واحد اندازه‌گیری برای مقدار انتظار را انتخاب کنید. گزینه‌ها شامل:
  • ثانیه‌ها
  • دقیقه‌ها
  • ساعت‌ها
  • روزها

برای جزئیات بیشتر درباره نحوه کار این فواصل و منطقه زمانی مورد استفاده، به عملیات‌های مبتنی بر زمان مراجعه کنید.

در زمان مشخص

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

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

در هنگام فراخوانی وب‌هوک

این پارامتر امکان ادامه روند کاری‌هایتان را می‌دهد زمانی که نود Wait تماس HTTP دریافت می‌کند.

آدرس وب‌هوک که پس از تماس، اجرای فرآیند را ادامه می‌دهد، در زمان اجرا تولید می‌شود. نود Wait متغیر $execution.resumeUrl را فراهم می‌کند تا بتوانید آدرس URL تولیدنشده را ارجاع دهید و در هر جای لازم ارسال کنید، مثلاً به سرویس‌های ثالث یا در ایمیل.

هنگامی که فرآیند اجرا می‌شود، نود Wait آدرس URL ادامه را تولید می‌کند و در روند شما از طریق $execution.resumeUrl از آن استفاده می‌نماید. این URL منحصر به فرد برای هر اجرا است، بنابراین می‌تواند شامل چندین نود Wait باشد و با فراخوانی URL، هر نود Wait به ترتیب ادامه می‌یابد.

برای این ادامه‌دادن، پارامترهای زیر را تنظیم کنید.

احراز هویت

انتخاب کنید اگر و چگونه درخواست‌های وب‌هوک ادامه، احراز هویت شوند. گزینه‌ها شامل:

• احراز هویت پایه‌ای: از احراز هویت پایه‌ای استفاده کنید. یک اعتبارنامه برای احراز هویت پایه‌ای جدید انتخاب یا وارد کنید.
• احراز هویت هدر: از احراز هویت در هدرها استفاده کنید. یک اعتبارنامه برای احراز هویت در هدر جدید وارد یا انتخاب کنید.
• احراز هویت JWT: از احراز هویت JWT استفاده کنید. یک اعتبارنامه برای احراز هویت JWT وارد یا انتخاب کنید.
• بدون: از احراز هویت استفاده نکنید.

مرجع احراز هویت

برای اطلاعات بیشتر در مورد هر نوع احراز هویت، به سندهای احراز هویت نود Webhook مراجعه کنید.

روش HTTP

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

کد پاسخ

کد پاسخ مورد انتظار از وب‌هوک را وارد کنید. می‌توانید از کدهای رایج یا کد دلخواه شخصی استفاده کنید.

پاسخ‌دهی

زمان و نحوه پاسخ به وب‌هوک را در این گزینه‌ها تنظیم کنید:

• فوراً: بلافاصله پس از اجرای نود پاسخ دهید.
• وقتی آخرین نود تمام شد: کد پاسخ و داده‌های خروجی آخرین نود اجرا شده در روند را برمی‌گرداند. اگر این گزینه را انتخاب کنید، همچنین تنظیم کنید:
  • داده‌های پاسخ: نوع داده‌هایی که باید برگردانده شوند و قالب آن‌ها. گزینه‌ها شامل:
    • همه ورودی‌ها: تمامی ورودی‌های آخرین نود در آرایه برمی‌گرداند.
    • JSON اولین ورودی: داده‌های JSON اولین ورودی آخرین نود در یک شی JSON برمی‌گرداند.
    • دوتایی اولین ورودی: داده‌های باینری اولین ورودی آخرین نود در یک فایل باینری برمی‌گرداند.
    • بدون بدنه پاسخ: بدون بدنه پاسخ می‌دهد.
• با استفاده از نود «پاسخ به وب‌هوک»: همانطور که در مستندات نود [پاسخ به وب‌هوک] توضیح داده شده است، پاسخ دهید.

محدود کردن زمان انتظار

تعیین کنید ورکفلو پس از رسیدن به یک نوع محدودیت (فعال شده) خودکار ادامه یابد یا خیر (غیرفعال).

در صورت فعال بودن، موارد زیر را تنظیم کنید: * نوع محدودیت: نوع محدودیت را از میان گزینه‌های زیر انتخاب کنید: * پس از فاصله زمانی: برای مدت زمان معین منتظر بمانید. * مقدار محدودیت زمان را وارد کنید. * واحد زمان مورد نظر برای محدودیت را انتخاب کنید. * در زمان مشخص: تا زمان و تاریخ مشخصی منتظر بمانید. * حداکثر تاریخ و زمان: با استفاده از پنجره تنظیم تاریخ و زمان، زمان مشخص شده‌ای که نود باید ادامه یابد را تنظیم کنید.

گزینه‌های تماس وب‌هوک

• ویژگی باینری: نام ویژگی باینری برای نوشتن داده فایل دریافتی. فقط در صورت دریافت داده باینری کاربرد دارد.
• صرف‌نظر کردن از ربات‌ها: تعیین کنید آیا درخواست‌های ربات مانند پیش‌نمایش لینک و خزنده‌های وب باید نادیده گرفته شوند یا نه.
• لیست سفید IP: IPهای مجاز برای فراخوانی URL وب‌هوک را وارد کنید. یک لیست جداشده با کاما از IPهای مجاز وارد کنید. درخواست‌ها از IP خارج از لیست، خطای ۴۰۳ برمی‌گرداند. اگر خالی باشد، هر IP می‌تواند تماس بگیرد.
• بدنه پاسخ ندهید: تعیین کنید آیا n98n باید در پاسخ، بدنه‌ای ارسال کند یا خیر.
• بدنه خام: تعیین کنید آیا باید بدنه در قالب خام مانند JSON یا XML برگردانده شود یا خیر.
• داده‌های پاسخ: هر داده‌ای را که می‌خواهید در پاسخ ارسال کنید، وارد کنید.
• هدایت‌های پاسخ: هدرهای بیشتری در پاسخ وب‌هوک ارسال کنید. برای اطلاعات بیشتر درباره هدرهای پاسخ، به مشخصه‌های Web MDN | Response header مراجعه کنید.
• پسوند وب‌هوک: پسوندی وارد کنید تا به URL ادامه افزوده شود. این برای ساخت URLهای منحصر به فرد برای هر نود Wait کاربرد دارد، به خصوص زمانی که ورکفلو شامل چندین نود است. توجه داشته باشید که $resumeWebhookUrl تولید شده، این پسوند را به‌طور خودکار شامل نخواهد شد؛ باید دستی آن را به URL وب‌هوک اضافه کنید.

محدودیت‌های تماس وب‌هوک

در استفاده از تماس وب‌هوک، محدودیت‌هایی وجود دارد: * اجراهای جزئی روند, $resumeWebhookUrl را تغییر می‌دهد، بنابراین اطمینان حاصل کنید که نودای که این URL را می‌فرستد، در همان اجرا با نود Wait اجرا شده باشد.

پس از ارسال فرم

منتظر بمانید تا کاربر فرم را ارسال کند تا ادامه یابد. این پارامترها را تنظیم کنید:

عنوان فرم

عنوانی که در بالای فرم نمایش داده می‌شود را وارد کنید.

توضیحات فرم

توضیحی که زیر عنوان نمایش داده می‌شود را وارد کنید. این توضیحات می‌تواند کاربران را در نحوه کامل کردن فرم راهنمایی کند.

فیلدهای فرم

هر فیلدی که می‌خواهید در فرم ظاهر شود را با تنظیمات زیر تنظیم کنید:

• برچسب فیلد: برچسب فیلد را وارد کنید.
• نوع فیلد: نوع فیلد را انتخاب کنید. گزینه‌ها شامل:
  • تاریخ
  • لیست کشویی: گزینه‌های لیست کشویی را در گزینه‌های فیلد وارد کنید.
    • چند گزینه‌ای: تعیین کنید کاربر آیا می‌تواند یک گزینه انتخاب کند (غیرفعال) یا چند گزینه (فعال)
  • عددی
  • رمز عبور
  • متن
  • متن‌ناحیه
• فیلد الزامی: تعیین کنید کاربر باید این فیلد را کامل کند یا خیر.

پاسخ‌دهی زمانی فرم

تعیین کنید چه زمانی به ارسال فرم پاسخ داده شود. گزینه‌ها شامل:

• در زمان ارسال فرم: پس از دریافت فرم، پاسخ دهید.
• پایان ورکفلو: هنگام پایان آخرین نود روند، پاسخ دهید.
• با استفاده از نود «پاسخ به وب‌هوک»: هنگامی که این نود اجرا شود.

محدود کردن زمان انتظار

تنظیم کنید روند بر اساس نوع محدودیت، ادامه یابد یا خیر.

در صورت فعال بودن، موارد زیر را تنظیم کنید: * نوع محدودیت: نوع محدودیت را از میان گزینه‌های زیر انتخاب کنید: * پس از فاصله زمانی: منتظر مدت زمانی مشخص باشید. * مدت زمان محدودیت را وارد کنید. * واحد زمان محدودیت را انتخاب کنید. * در زمان مشخص: منتظر بمانید تا زمان و تاریخ مشخصی فرا برسد. * حداکثر تاریخ و زمان: با استفاده از ابزار انتخاب، زمان تنظیم شده برای ادامه را مشخص کنید.

گزینه‌های پاسخ فرم

• پاسخ فرم: نحوه و محتواهای پاسخ به فرم را در این گزینه‌ها مشخص کنید:
  • متن تایید فرم: متنی که در هنگام پر کردن فرم نمایش داده می‌شود و پس از آن فرم تایید می‌شود. اگر این گزینه را فعال کنید، می‌توانید متنی برای تأیید نمایش دهید.
  • آدرس بازنشانی: پس از پر کردن فرم، کاربر به ―URL برای بازنشانی‖ هدایت می‌شود. این باید یک URL معتبر باشد.
• پسوند وب‌هوک: پسوندی وارد کنید تا به URL ادامه افزوده شود. این برای ساخت URLهای منحصر به فرد برای هر نود است، زمانی که روند چندین نود Wait دارد. توجه کنید که $resumeWebhookUrl تولید شده، این پسوند را به صورت خودکار شامل نمی‌شود؛ باید قبل از نشان دادن، آن را به URL وب‌هوک اضافه کنید.

قالب‌ها و نمونه‌ها

Browse انتظار integration templates, or search all templates

عملیات‌های مبتنی بر زمان

برای عملیات‌های ادامه بر اساس زمان، نکات زیر را در نظر داشته باشید:

• برای زمان‌های انتظار کمتر از ۶۵ ثانیه، روند داده‌های اجرا به پایگاه داده منتقل نمی‌شود. در عوض، فرآیند ادامه می‌یابد و پس از سپری شدن مدت زمان مشخص، ادامه پیدا می‌کند.
• زمان سرور n98n همیشه زمان سرور است و تفاوتی در منطقه زمانی ندارد. تنظیمات منطقه زمانی ورکفلو هم، و هر تغییری در آن‌ها، بر فواصل یا زمان‌های مشخص شده در نود Wait تأثیر نمی‌گذارد.