اجرای سابورکفلو#
از نود اجرای زیر-سربرگ‌کاری برای اجرای یک سربرگ‌کاری متفاوت روی ماشین میزبان که n98n را اجرا می‌کند، استفاده کنید.
پارامترهای نود#
منبع#
انتخاب کنید که نود باید اطلاعات زیر-سربرگ‌کاری را از کجا دریافت کند:
- پایگاه داده: این گزینه را انتخاب کنید تا سربرگ‌کاری را بر اساس شناسه از پایگاه داده بارگذاری کنید. علاوه بر آن باید وارد کنید:
- از فهرست: سربرگ‌کاری را از فهرستی از سربرگ‌کاری‌های موجود در حساب کاربری‌تان انتخاب کنید.
- شناسه سربرگ‌کاری: شناسه سربرگ‌کاری را وارد کنید. آدرس URL سربرگ‌کاری شامل شناسه پس از
/workflow/است. برای مثال، اگر آدرس URL یک سربرگ‌کاریhttps://my-n8n-acct.app.n8n.cloud/workflow/abCDE1f6gHiJKL7باشد، شناسه سربرگ‌کاری برابر است باabCDE1f6gHiJKL7.
- فایل محلی: این گزینه را برای بارگذاری سربرگ‌کاری از یک فایل JSON ذخیره شده روی سیستم محلی انتخاب کنید. باید وارد کنید:
- مسیر سربرگ‌کاری: مسیر فایل JSON محلی که می‌خواهید نود اجرا کند.
- پارامتر: این گزینه برای بارگذاری سربرگ‌کاری از طریق پارامتر است. علاوه بر آن باید وارد کنید:
- JSON سربرگ‌کاری: کد JSON مورد نظر برای اجرای نود.
- آدرس اینترنتی (URL): این گزینه را برای بارگذاری سربرگ‌کاری از یک URL انتخاب کنید. علاوه بر آن باید وارد کنید:
- آدرس URL سربرگ‌کاری: URL مورد نظر برای بارگذاری سربرگ‌کاری.
ورودی‌های سربرگ‌کاری#
اگر شما سربرگ‌کاری فرعی را با استفاده از گزینه‌های پایگاه داده و از فهرست انتخاب کنید، آیتم‌های ورودی سربرگ‌کاری خودکار نمایش داده می‌شوند، و آماده برای پر کردن یا نگاشت مقادیر هستند.
اختیاری است که آیتم‌های ورودی درخواست شده را حذف کنید، در این صورت سربرگ‌کاری فرعی مقدار null را به عنوان مقدار آیتم دریافت می‌کند. همچنین می‌توانید گزینه تلاش برای تبدیل نوع‌ها را فعال کنید تا به طور خودکار داده‌ها را به نوع درخواست‌شده در آیتم سربرگ‌کاری تبدیل کند.
آیتم‌های ورودی در صورت استفاده از نود مخاطب‌ساز ورودی سربرگ‌کاری و حالت ورودی "پذیرش همه داده‌ها" ظاهر نخواهند شد.
حالت#
از این پارامتر برای کنترل حالت اجرای نود استفاده کنید. گزینه‌ها عبارتند از:
- اجرای یک‌باره با تمامی آیتم‌ها: تمام آیتم‌های ورودی را در یک اجرای واحد وارد کنید.
- اجرای یک‌باره برای هر آیتم: نود را یک‌بار برای هر آیتم ورودی به صورت جداگانه اجرا کنید.
گزینه‌های نود#
این نود شامل یک گزینه است: انتظار برای تکمیل زیر-سربرگ‌کاری. این امکان را به شما می‌دهد تا کنترل کنید آیا سربرگ‌کاری اصلی باید قبل از ادامه به مرحله بعد، منتظر پایان زیر-سربرگ‌کاری باشد (فعال است) یا بدون انتظار ادامه یابد (غیرفعال است).
قالب‌ها و نمونه‌ها#
راه‌اندازی و استفاده از یک زیر-سربرگ‌کاری#
این بخش نحوه راه‌اندازی هم سربرگ‌کاری والد و هم زیر-سربرگ‌کاری را آموزش می‌دهد.
ایجاد سابورکفلو#
- یک ورکفلو جدید ایجاد کنید.
ایجاد سابورکفلو از روی ورکفلوها موجود
می‌توانید به صورت اختیاری، مستقیم از ورکفلو والد، از طریق نود اجرای سابورکفلو یک سابورکفلو ایجاد کنید. در این نود، گزینه‌های پایگاه‌داده و از لیست را انتخاب کنید و ایجاد سابورکفلو را در لیست انتخاب نمایید.
- اختیاری: پیکربندی کنید که کدام ورکفلوها می‌توانند سابورکفلو را فراخوانی کنند:
- منوی گزینه‌ها
> تنظیمات را انتخاب کنید. n98n پنجره مدال تنظیمات ورکفلو را باز می‌کند. - تنظیم این ورکفلو توسط چه کسی قابل فراخوانی است را تغییر دهید. برای اطلاعات بیشتر درباره پیکربندی ورکفلوها، به تنظیمات ورکفلو مراجعه کنید.
- منوی گزینه‌ها
- افزودن نود ترسیم‌کننده اجرای سابورکفلو (اگر در حال جستجو در زیر مجموعه نودهای ترسیم‌کننده هستید، این نود همچنین به عنوان وقتی توسط ورکفلو دیگر اجرا شد شناخته می‌شود).
- حالت مد داده ورودی را تنظیم کنید تا مشخص کنید چگونه می‌خواهید داده‌های ورودی سابورکفلو را تعریف کنید:
- تعریف با استفاده از فیلدهای زیر: این حالت را انتخاب کنید تا نام‌های ورودی و نوع داده‌های فردی را که ورکفلو فراخوان باید فراهم کند، تعریف نمایید. نود اجرای سابورکفلو یا ابزار فراخوانی روند n98n در روند فراخوان، به طور خودکار فیلدهای تعریف شده در اینجا را برداشت می‌کنند.
- تعریف با استفاده از نمونه JSON: این حالت را برای ارائه یک شیء JSON نمونه که آیتم‌های ورودی مورد انتظار و نوع‌های آن‌ها را نشان می‌دهد، انتخاب کنید.
- قبول تمام داده‌ها: از این حالت برای پذیرش تمام داده‌ها بدون قید و شرط استفاده کنید. این سابورکفلو هیچ آیتم ورودی مورد نیاز ندارد و باید هرگونه ناسازگاری یا مقادیر مفقود را مدیریت کند.
- سایر نودها را برای ساخت عملکرد سابورکفلو خود، اضافه کنید.
- سابورکفلو را ذخیره کنید.
سابورکفلو نباید خطا داشته باشد
اگر در سابورکفلو خطایی وجود داشته باشد، ورکفلو والد نمی‌تواند آن را فراخوانی کند.
قبل از ساخت، داده را در سابورکفلو بارگذاری کنید
اگر می‌خواهید داده‌هایی را در سابورکفلو خود بارگذاری کنید تا در هنگام ساخت آن استفاده کنید:
- سابورکفلو را ایجاد کنید و نود اجرای سابورکفلو را اضافه کنید.
- حالت مود داده ورودی نود را به حالت قبول تمام داده‌ها یا، در صورت شناختن آیتم‌های ورودی، با استفاده از فیلدها یا JSON تنظیم کنید.
- در تنظیمات سابورکفلو، گزینه ذخیره اجراهای موفق تولید را بر روی ذخیره قرار دهید.
- به ساخت ورکفلو والد بروید و آن را اجرا کنید.
- مراحل بارگذاری داده از اجرای‌های قبلی را دنبال کنید.
- در صورت نیاز، حالت مد داده ورودی را تنظیم کنید تا با داده‌های ارسالی توسط ورکفلو والد، مطابقت داشته باشد.
حالا می‌توانید نمونه داده‌ها را در نود ترسیم‌کننده پین کنید، و با داده‌های واقعی هنگام پیکربندی بقیه روند کار، کار کنید.
فراخوانی سابورکفلو#
- ورکفلو که می‌خواهید سابورکفلو را در آن فراخوانی کنید، باز کنید.
- نود اجرای سابورکفلو را اضافه کنید.
- در نود اجرای سابورکفلو، سابورکفلو مورد نظر خود را تنظیم کنید. می‌توانید روند را بر اساس شناسه، بارگذاری روند از فایل محلی، افزودن JSON روند به عنوان پارامتر در نود، یا هدف قرار دادن روند به وسیله URL، فراخوانی نمایید.
شناسه ورکفلو خود را پیدا کنید
شناسه ورکفلو شما، رشته الحاقی منی‌فونت در انتهای URL آن است.
- آیتم‌های ورودی مورد نیاز را که توسط سابورکفلو تعریف شده است، پر کنید.
- روند کار خود را ذخیره کنید.
وقتی روند شما اجرا می‌شود، داده‌ها را به سابورکفلو ارسال می‌کند و آن را اجرا می‌نماید.
می‌توانید جریان اجرا را از ورکفلو والد به سابورکفلو، با باز کردن نود اجرای سابورکفلو و انتخاب لینک مشاهده زیرتجزیه پیگیری کنید. همچنین، اجرای سابورکفلو، شامل لینکی به سمت اجرای روند کار والد است که در جهت دیگر، قابلیت ناوبری در آن وجود دارد.
نحوه انتقال داده‌ها بین سربرگ‌کاری‌ها#
برای مثال، فرض کنید که شما یک نود اجرای سابورکفلو (Execute Sub-workflow) در ورکفلو A دارید. این نود اجرای سابورکفلو، ورکفلو دیگری به نام ورکفلو B را فرا می‌خواند:
- نود اجرای سابورکفلو، داده‌ها را به نود تریگر اجرای سابورکفلو (با عنوان "هنگام اجرا توسط یک نود دیگر" در صفحه وکتور) در ورکفلو B منتقل می‌کند.
- آخرین نود در ورکفلو B، داده‌ها را به نود اجرای سابورکفلو در ورکفلو A برمی‌گرداند.