n8n از پایه
ساخت ورکفلوی قطعی، خوانا و قابل اشکالزدایی در n8n پیش از افزودن هوش مصنوعی: محل اجرا و مجوز، آیتم و Expression، منطق جریان، Credential و صفحهبندی، و خطا.
آنچه یاد میگیری
- انتخاب محل اجرای n8n و شناخت محدودیتهای مجوز Sustainable Use License
- ساخت ورکفلوی قطعی با ماشه، نگاشت داده و مسیر خطا
- کار با آیتمها، Expression، شرط، حلقه و زیرورکفلو
- اتصال سرویس با Credential و HTTP Request و مدیریت صفحهبندی
- اشکالزدایی با تاریخچه اجرا و داده سنجاقشده
پیشنیاز
- زبان مشترک نرمافزارها: HTTP، JSON و API
ابزارها
- n8n 2.x (اجرای محلی با Docker یا Cloud در صورت دسترسی قانونی)
- Python 3.9 یا بالاتر (API آزمایشی)
- n8n چیست، کجا اجرا شود و مجوزش چه میگوید
n8n را بشناس، بین Cloud و اجرای شخصی با دلیل انتخاب کن، آن را با Docker روی کامپیوتر خودت اجرا کن و بدان مجوزش چه کاری را اجازه میدهد.
- اولین ورکفلوی قطعی در n8n
یک ورکفلوی کامل بدون هوش مصنوعی بساز: ماشه، درخواست HTTP، جدا کردن آیتمها، شرط و ساختن خروجی؛ و آن را بیازما، زمانبندی کن و منتشر کن.
- داده در n8n: آیتم، Expression و نگاشت
با Expression به داده آیتم فعلی و گرههای قبلی برس، فیلدها را با Edit Fields نگاشت کن و بدان پیوند آیتمها کی کمک میکند و کی میشکند.
- منطق جریان: شرط، حلقه، تجمیع و زیرورکفلو
آیتمها را با If و Switch مسیریابی کن، با Merge و Aggregate جمع کن، با Loop Over Items و Wait دستهدسته بفرست و کار تکراری را در زیرورکفلو بگذار.
- Credential، HTTP Request و صفحهبندی
کلید را در Credential بگذار، هر API را با گره HTTP Request صدا بزن، همه صفحهها را با صفحهبندی داخلی بخوان و پاسخهای خطا را بهجای پنهان کردن ببین.
- خطا و اشکالزدایی در n8n
برای هر گره رفتار خطا را انتخاب کن، تلاش دوباره را فقط جای درست روشن کن، یک ورکفلوی خطا با هشدار بساز و اجرای ناموفق را با داده خودش اشکالزدایی کن.
راهاندازی و اولین ورکفلو
موقعیت (ساختگی): برگ سبز میخواهد هر صبح فهرست سفارشهای «processing» قدیمیتر از سه روز را برای مسئول انبار بفرستد. یکی از کارکنان پیشنهاد میدهد n8n را روی سرور اجارهای بالا بیاورد و به دو کتابفروشی دوست هم حساب بدهد تا خودشان ورکفلو بسازند. تحویل بده: (۱) پاسخ به پیشنهاد از نظر مجوز و محل اجرا؛ (۲) گرههای ورکفلو به ترتیب با تعداد آیتم پیشبینیشده برای داده API آزمایشی؛ (۳) دو آزمون لبه با داده سنجاقشده؛ (۴) گامهای انتشار و بررسی اولین اجرای زمانبندیشده.
- دادن n8n به کتابفروشیهای دیگر برای ساخت ورکفلو را خارج از مجوز بدون قرارداد میداند (2)
- Split Out پیش از شرط و تعداد آیتمها درست است (2)
- آزمون لبه شامل فهرست خالی است (2)
- انتشار و دیدن اولین اجرای واقعی آمده است (2)
داده و منطق
موقعیت (ساختگی): ورکفلوی تیکتهای برگ سبز برای هر تیکت سفارش مربوط را میخواند و پاسخ میسازد. شکایتها: (الف) با چند تیکت همزمان، همه پاسخها وضعیت یک سفارش را دارند؛ (ب) تیکتهای فوری پرداخت دو پیام به مدیر میدهند؛ (ج) سامانه پشتیبانی بیرونی روزهای شلوغ 429 میدهد؛ (د) دسته تازه «gift» هیچجا نمیرود. تحویل بده: علت و اصلاح هر چهار مورد با نام گره و Expression یا تنظیم.
- الف: .first() به .item و آزمون با چند آیتم (2)
- ب: یکی کردن شرط پیش از اقدام (2)
- ج: Loop Over Items یا Batching با Wait (2)
- د: شاخه پیشفرض Switch به صف بررسی (2)
اتصال و خطا
موقعیت (ساختگی): گزارش ماهانه فروش برگ سبز همیشه کمتر از حسابهاست، کلید سامانه در هدر گره نوشته شده، گزینه Never Error روشن است، و هیچ ورکفلوی خطایی وجود ندارد. تحویل بده: (۱) ترتیب اقدامها برای کلید؛ (۲) تنظیم صفحهبندی با شرط توقف و سقف؛ (۳) تصمیم درباره Never Error و جایگزینش؛ (۴) طرح ورکفلوی خطا با متن هشدار نمونه.
- کلید باطل و عوض و به Credential منتقل میشود (2)
- $pageCount + 1 با شرط توقف next_page و سقف صفحه (2)
- Never Error خاموش یا همراه بررسی صریح کد وضعیت (2)
- هشدار با نام ورکفلو، گره، خطا و پیوند و بدون داده آیتم (2)
آزمون عبور از دوره
در حدود ۴۵ دقیقه، با n8n محلی و API آزمایشی برگ سبز ورکفلویی بساز که: همه صفحههای GET /orders را با Credential از نوع Header Auth بخواند؛ سفارشها را جدا کند و با Switch بر اساس وضعیت (با شاخه پیشفرض) مسیریابی کند؛ برای سفارشهای shipped با Edit Fields پیام بسازد و با POST /tickets و هدر Idempotency-Key ثبت کند؛ و یک ورکفلوی خطا داشته باشد که با کلید غلط هشدار بدهد. اگر نصب ممکن نیست، طرح کامل گرهها و تنظیمات را با پیشبینی تعداد آیتم هر گره بنویس.
- هفت سفارش آزمایشی در سه درخواست خوانده میشوند و صفحه اول تکرار نمیشود.
- هیچ کلیدی در گره یا خروجی ورکفلو نیست.
- Switch شاخه پیشفرض دارد و هیچ آیتمی از دو مسیر به ثبت تیکت نمیرسد.
- اجرای دوباره، تیکت تکراری نمیسازد.
- شکست با کلید غلط هشدار بدون داده آیتم میفرستد.