مستندات نود فرم n8n#
استفاده از نود فرم n98n برای ایجاد فرم‌های کاربری چندمرحله‌ای. می‌توانید نودهای دیگر با منطق سفارشی بین آن‌ها قرار دهید تا ورودی کاربر پردازش شود. برای شروع فرآیند، باید از نود تریگر فرم n8n استفاده کنید.
تنظیم نود#
تعیین گزینه‌های پیش‌فرض با پارامترهای کوئری#
می‌توانید مقادیر اولیه فیلدها را با استفاده از پارامترهای کوئری با URL اولیه ارائه شده توسط نود تریگر فرم n8n تنظیم کنید. هر صفحه در فرم، همان پارامترهای کوئری را که به URL تریگر فرم n98n ارسال می‌شود، دریافت می‌کند.
فقط برای محیط تولید
پارامترهای کوئری در حالت تولید قابل استفاده است. n98n در حالت آزمایشی مقادیر فیلدها را از پارامترهای کوئری پر نمی‌کند.
وقتی از پارامترهای کوئری استفاده می‌کنید، درصد-کدگذاری هر نام فیلد یا مقدار آن که حاوی کاراکترهای خاص است را انجام دهید. این کار تضمین می‌کند که n98n مقادیر اولیه را برای فیلدهای مشخص شده استفاده کند. می‌توانید از ابزارهایی مانند URL Encode/Decode برای قالب‌بندی پارامترهای کوئری خود با درصد-کدگذاری استفاده کنید.
برای مثال، فرض کنید یک فرم دارید با مقادیر زیر:
- URL محیط تولید:
https://my-account.n8n.cloud/form/my-form - فیلدها:
name:Jane Doeemail:jane.doe@example.com
با پارامترهای کوئری و درصدکدگذاری، می‌توانید از لینک زیر برای تنظیم مقادیر اولیه فیلدها استفاده کنید:
https://my-account.n8n.cloud/form/my-form?email=jane.doe%40example.com&name=Jane%20Doe
در اینجا، نماد @ با %40 جایگزین شده و فاصله با %20. این کار مقدار اولیه این فیلدها را در هر صفحه‌ای از فرم که ظاهر شوند، تنظیم می‌کند.
نمایش HTML سفارشی#
می‌توانید HTML سفارشی را در فرم خود نمایش دهید با افزودن یک فیلد HTML سفارشی. این فیلد یک جعبه HTML فراهم می‌کند که می‌توانید کد HTML دلخواه را وارد کنید تا به عنوان بخشی از صفحه فرم نمایش داده شود.
با استفاده از این قسمت، می‌توانید صفحه فرم خود را غنی‌تر کنید، شامل لینک‌ها، تصاویر، ویدئوها و موارد دیگر. n98n محتوای HTML را همراه با سایر فیلدهای فرم در جریان سند معمول رندر می‌کند.
از آنجایی که محتوای HTML سفارشی قابل ویرایش نیست، این فیلدها به طور پیش‌فرض در خروجی نود قرار نمی‌گیرند. برای افزودن محتوای HTML خام به خروجی نود، نامی برای داده‌ها در قسمت اسم عنصر مشخص کنید.
فیلد HTML از <script>, <style>, یا <input> پشتیبانی نمی‌کند.
شامل کردن فیلدهای مخفی#
می‌توانید فیلدهایی را در فرم قرار دهید بدون اینکه نمایش داده شوند. این کار مناسب است زمانی که می‌خواهید داده‌های اضافی ارسال کنید که نیازی به ورودی کاربر ندارند.
برای افزودن فیلدهای مخفی، از عنصر فرم فیلد پنهان استفاده کنید. در آن، می‌توانید اسم فیلد را تعیین کرده و در صورت نیاز مقدار پیش‌فرض را با پر کردن مقدار فیلد وارد کنید.
وقتی فرم را سرو می‌کنید، می‌توانید مقادیر فیلدهای مخفی را با استفاده از پارامترهای کوئری ارسال کنید.
تعریف فرم با JSON#
از تعریف فرم > با JSON برای تعریف فیلدهای فرم خود با یک آرایه JSON شیء استفاده کنید. هر شیء، یک فیلد واحد را با ترکیبی از کلیدهای زیر تعریف می‌کند:
fieldLabel: برچسبی که بالای فیلد نمایش داده می‌شود.fieldType: نوع فیلد که می‌تواندdate،dropdown،email،file،number،password،textیاtextareaباشد.- از
dateبرای افزودن تاریخ‌نمای در فرم استفاده کنید. برای اطلاعات بیشتر درباره قالب‌بندی تاریخ، به تاریخ و زمان با لوکسون مراجعه کنید.- زمانی که از
dropdownاستفاده می‌کنید، گزینه‌ها را باfieldOptionsتنظیم کنید (مثال زیر را ببینید). به صورت پیش‌فرض، منوی کشویی تک‌گزینه است. برای چندگزینه‌ای کردن آن،multiselectراtrueقرار دهید. - هنگام استفاده از
file،multipleFilesراtrueقرار دهید تا کاربران بتوانند بیش از یک فایل انتخاب کنند. برای تعریف نوع فایل‌های مجاز،acceptFileTypesرا با لیستی از پسوندهای فایل، جدا شده با کاما، تنظیم کنید (مثال زیر را ببینید).
- زمانی که از
placeholder: قرار دادن متن راهنما در فیلد. این گزینه برای همه نوعfieldTypeبه جزdropdown،date، وfileاست.requiredField: نیاز به تکمیل این فیلد توسط کاربر دارد.
یک نمونه JSON که قالب کلی مورد نیاز و کلیدهای موجود را نشان می‌دهد:
```javascript // از کلید "requiredField" برای هر فیلد برای مشخص کردن الزامی بودن آن استفاده کنید // از کلید "placeholder" برای تعیین متن راهنما در تمام فیلدها // به جز 'dropdown'، 'date' و 'file'
[ { "fieldLabel": "تاریخ", "fieldType": "date", "formatDate": "mm/dd/yyyy", // نحوه قالب‌بندی تاریخ دریافتی در n98n "requiredField": true }, { "fieldLabel": "گزینه‌های منو کشویی", "fieldType": "dropdown", "fieldOptions": { "values": [ { "option": "گزینه ۱" }, { "option": "گزینه ۲" } ] }, "requiredField": true }, { "fieldLabel": "چندگزینه‌ای", "fieldType": "dropdown", "fieldOptions": { "values": [ { "option": "گزینه ۱" }, { "option": "گزینه ۲" } ] }, "multiselect": true // فعال‌سازی حالت چندگزینه‌ای }, { "fieldLabel": "ایمیل", "fieldType": "email", "placeholder": "me@mail.com" }, { "fieldLabel": "فایل", "fieldType": "file", "multipleFiles": true, // فعال کردن انتخاب چند فایل "acceptFileTypes": ".jpg, .png" // نوع فایل‌های مجاز }, { "fieldLabel": "عدد", "fieldType": "number" }, { "fieldLabel": "رمز عبور", "fieldType": "password" }, { // "fieldType": "text" می‌تواند حذف شود چون پیش‌فرض است "fieldLabel": "متن" }, { "fieldLabel": "متن چندخطی", "fieldType": "textarea" } ]
پایان فرم#
استفاده از صفحه نوع پایان فرم برای پایان دادن به فرم و نشان دادن صفحه تکمیل، ریدایرکت به URL یا نمایش HTML یا متن سفارشی. در هر اجرا، تنها یک صفحه پایان فرم نمایش داده می‌شود، حتی اگر نودهای شاخه‌ای متعدد در فرآیند وجود داشته باشد.
وقتی از درخواست ارسال فرم n98n استفاده می‌کنید، بین این گزینه‌ها یکی را انتخاب کنید:
- نمایش صفحه کامل: صفحه نهایی که کاربر تأیید می‌کند فرم را ارسال کرده است.
- عنوان کامل را در قسمت عنوان پایان وارد کنید تا عنوان
h1فرم باشد. - پیام پایان در زیر عنوان
h1به عنوان زیرنویس نمایش داده می‌شود. می‌توانید از\nیا<br>برای خط تازه استفاده کنید. - گزینه افزودن گزینه را انتخاب کنید، و در قسمت عنوان صفحه پایان نام برگه را وارد کنید تا عنوان صفحه در تب مرورگر نمایش داده شود.
- عنوان کامل را در قسمت عنوان پایان وارد کنید تا عنوان
در صورت نیاز به ریدایرکت به URL، در قسمت آدرس URL آدرس مورد نظر را وارد کنید.
برای نمایش یک صفحه نهایی با متن ساده و HTML دلخواه، از گزینه نمایش متن استفاده کنید و در قسمت متن محتوا HTML یا متن معمول را وارد کنید.
فرم‌های با شاخه‌ها#
نود فرم n98n زمانی صفحه فرم خود را اجرا و نشان می‌دهد که داده‌ای از نود قبلی دریافت کند. در ساخت فرم‌های شاخه‌ای، مهم است که رفتار فرم‌ها هنگام شاخه‌بندی به درستی درک شود.
مسیرهای متقابل منحصربه‌فرد (متمایز)#
مسیرهای منحصربه‌فرد در فرم‌های n98n به درستی کار می‌کنند. n98n بر اساس داده و شرط‌های مشخص‌شده، فقط یک شاخه را اجرا می‌کند و صفحات هر شاخه را نشان می‌دهد تا به نود پایان فرم برسد.
این نمونه مسیرهای متقابل منحصربه‌فرد است. هر گزینه فقط یک شاخه را اجرا می‌کند.
مسیرهایی که ممکن است چند شاخه را اجرا کنند#
در مواردی که چند شاخه به صورت همزمان داده دریافت می‌کنند (مثلاً از نود switch)، n98n هر شاخه‌ای که داده دریافت کند، آن‌ها را به صورت متوالی اجرا می‌کند. پس از پایان یک شاخه، فرآیند به شاخه بعدی می‌رود که داده دریافت می‌کند.
n98n فقط یک نود پایان فرم فعال در هر اجرا دارد. در صورت دریافت داده در چند شاخه، n98n صرفاً نود پایان فرم مربوط به شاخه آخر را اجرا می‌کند و نودهای دیگر نادیده گرفته می‌شوند.
این نمونه مسیر می‌تواند در یک اجرا چندین شاخه را اجرا کند. در این حالت، n98n تمامی شاخه‌های معتبر را به صورت ترتیبی اجرا می‌کند. این موضوع بر نودهای پایان فرم که اجرا می‌شوند تأثیر دارد.
تنظیمات نود#
برای مشاهده گزینه‌های بیشتر، افزودن گزینه را انتخاب کنید:
- عنوان فرم: عنوان فرم شما. n98n عنوان فرم را در عنوان صفحه وب و عنوان اصلی
h1فرم نشان می‌دهد. - توضیحات فرم: توضیحات فرم. n98n این متن را در زیر عنوان
h1نشان می‌دهد. این فیلد پشتیبانی از HTML دارد. برای شکست خط، می‌توانید از\nیا<br>استفاده کنید. همچنین، توضیحات فرم متادیتای HTML صفحه را هم پر می‌کند. - برچسب دکمه: برچسب دکمه ارسال فرم. n98n این برچسب را در نام دکمه ثبت نشان می‌دهد.
اجرای نود#
ساخت و آزمایش فرآیندهای کاری#
در حین ساخت یا آزمایش یک فرآیند کاری، از آدرس آزمایشی در نود تریگر فرم n98n استفاده کنید. این کار امکان مشاهده داده‌های دریافتی در رابط ویرایشگر را فراهم می‌کند و برای دیباگ مفید است.
دو روش برای آزمایش وجود دارد:
- انتخاب آزمون مرحله. فرم باز می‌شود و پس از ارسال، نود عملیات را اجرا می‌کند، ولی بقیه فرآیند اجرا نمی‌شود.
- انتخاب آزمون فرآیند کاری. فرم باز می‌شود و پس از ارسال، کل فرآیند کاری اجرا می‌شود.
فرآیندهای کاری در محیط تولید#
وقتی فرآیند کاری شما آماده شد، به URL محیط تولید نود تریگر فرم انتقال یابید و در قسمت آدرس URL تولید، آن را فعال کنید. پس از آن، نود فرآیند کاری را به صورت خودکار هنگام ارسال فرم توسط کاربر اجرا می‌کند.
در هنگام استفاده از URL تولید، مطمئن شوید فرآیند کاری را ذخیره و فعال کرده‌اید. داده‌های وارد شده از طریق تریگر فرم در رابط ویرایشگر نشان داده نمی‌شود.
قالب‌ها و نمونه‌ها#