Skip Navigation Links.

فرم‌ساز

فرم و اسناد / Form and List

افزونه‌ی Form and List که پیش‌تر با نام User Defined Table شناخته می‌شد، یکی از ماژول‌های قدرتمند و انعطاف‌پذیر در پلتفرم DNN است که امکان ساخت فرم‌های ورودی داده و نمایش لیستی اطلاعات را بدون نیاز به کدنویسی فراهم می‌سازد. این افزونه برای مدیریت داده‌های ساخت‌یافته، ثبت اطلاعات کاربران، ساخت جداول قابل فیلتر و نمایش گزارش‌ها کاربرد دارد و راه‌حلی ساده برای جمع‌آوری و نمایش اطلاعات در سایت‌های مبتنی بر DNN ارائه می‌دهد.

ویژگی‌ها

تعریف جدول سفارشی

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

ساخت فرم خودکار

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

نمایش لیستی و قابل فیلتر

نمایش داده‌ها در قالب جدول با قابلیت مرتب‌سازی و فیلتر.

پشتیبانی از انواع داده‌ها

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

قابلیت ویرایش و حذف رکوردها

مدیریت کامل داده‌ها با مجوزهای مبتنی بر نقش‌های امنیتی DNN.

خروجی XML و XSLT

امکان نمایش داده‌ها با قالب‌های سفارشی و طراحی خروجی دلخواه.

ورود و خروج داده‌ها با CSV

انتقال اطلاعات به‌صورت فایل‌های قابل استفاده در اکسل یا پایگاه‌داده.

پشتیبانی از چند کاربر هم‌زمان

امکان ثبت اطلاعات توسط چند کاربر به‌صورت هم‌زمان.

نحوه عملکرد

نصب افزونه:

1. دریافت فایل نصب از GitHub یا DNN Forge.

2. ورود به پنل مدیریت DNN و نصب از بخش Extensions.

3. افزودن ماژول به صفحه دلخواه.
 

تعریف جدول:

1. ورود به بخش تنظیمات ماژول و تعریف فیلدهای جدول با نوع داده و اعتبارسنجی.

2. تعیین مجوزهای دسترسی برای افزودن، ویرایش یا حذف رکوردها.
 

ساخت فرم و لیست:

1. فرم ورودی به‌صورت خودکار بر اساس فیلدهای جدول ساخته می‌شود.

2. لیست نمایش داده‌ها نیز به‌صورت پیش‌فرض فعال می‌گردد.
 

تنظیمات نمایش:

1. انتخاب قالب نمایش (Grid، XSLT، یا سفارشی).

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

مدیریت داده‌ها:

1. افزودن رکورد جدید از طریق فرم.

2. ویرایش، حذف یا فیلتر رکوردها از طریق لیست.
 

توصیه‌های حرفه‌ای

برای نمایش حرفه‌ای‌تر داده‌ها، از قابلیت XSLT Rendering استفاده کنید و قالب‌های سفارشی طراحی نمایید.
در پروژه‌های چندزبانه، از فیلدهای قابل ترجمه و ساختار XML برای نمایش محتوای بومی‌سازی‌شده بهره ببرید.
برای جلوگیری از ورود داده‌های نامعتبر، از Regular Expressions در اعتبارسنجی فیلدها استفاده کنید.
در صورت نیاز به خروجی اکسل، از قابلیت Export to CSV استفاده نمایید.
برای نمایش تصاویر یا لینک‌ها، از فیلدهای مخصوص و قالب‌های HTML سفارشی بهره ببرید.
درخواست دمو

راهنمای تصویری کار با این افزونه

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

مراحل نصب افزونه‌ی Form and List از طریق بخش Extensions.

تنظیم نوع داده، نام فیلد، اعتبارسنجی و مجوزهای دسترسی.

فرم ساخته‌شده بر اساس فیلدهای تعریف‌شده برای ورود اطلاعات.

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

نمایش داده‌ها با قالب طراحی‌شده توسط فایل XSLT.

سوالات متداول

افزونه Form and List چیست و چه کاربردی دارد؟

افزونه Form and List که قبلاً با نام User Defined Table شناخته می‌شد، یک ماژول قدرتمند برای ایجاد فرم‌های ورود اطلاعات و نمایش لیستی از داده‌ها در سایت‌های DNN است. این افزونه به شما امکان می‌دهد جدول دلخواه خود را با فیلدهای سفارشی، نوع داده مشخص، اعتبارسنجی و مجوزهای دسترسی طراحی کنید و داده‌های وارد شده را به‌صورت لیست یا گزارش نمایش دهید.

نحوه نصب و راه‌اندازی افزونه چگونه است؟

برای نصب، کافی است فایل افزونه را از مخزن رسمی GitHub دریافت کرده و از طریق بخش Extensions در پنل مدیریت DNN نصب نمایید. پس از نصب، می‌توانید ماژول را به صفحه دلخواه اضافه کرده، جدول خود را طراحی کرده و فیلدهای مورد نظر را تعریف کنید. فرم ورود اطلاعات و لیست نمایش به‌صورت خودکار بر اساس ساختار جدول ایجاد می‌شوند.

آیا افزونه با نسخه‌های جدید DNN سازگار است؟

بله، نسخه‌های اخیر افزونه با DNN 9.x و حتی نسخه‌های جدیدتر مانند 10.x سازگار هستند. با این حال، توصیه می‌شود قبل از نصب در محیط تولید، افزونه را در محیط تست بررسی کرده و از سازگاری با قالب و سایر ماژول‌های سایت اطمینان حاصل نمایید.

آیا امکان اعتبارسنجی داده‌ها و کنترل نوع ورودی وجود دارد؟

کاملاً. افزونه از انواع داده مانند متن، عدد، تاریخ، ایمیل، لینک، تصویر و ... پشتیبانی می‌کند و می‌توان برای هر فیلد اعتبارسنجی خاصی مانند Regular Expression یا محدودیت طول و مقدار تعریف کرد. همچنین امکان تعریف فیلدهای محاسباتی و فیلترهای جستجو نیز وجود دارد.

تفاوت افزونه Form and List با ماژول‌های فرم‌ساز دیگر مانند Live Forms یا Action Form چیست؟

Form and List بیشتر برای ساختاردهی داده‌ها در قالب جدول و نمایش لیستی مناسب است، در حالی که افزونه‌هایی مانند Live Forms برای طراحی فرم‌های تعاملی با منطق شرطی، اتصال به سرویس‌های خارجی و پرداخت آنلاین کاربرد دارند. اگر هدف شما ثبت و نمایش داده‌های ساخت‌یافته در قالب لیست یا گزارش است، Form and List انتخاب مناسبی خواهد بود.

آیا امکان نمایش سفارشی داده‌ها با قالب‌های دلخواه وجود دارد؟

بله، افزونه از قابلیت XSL Rendering پشتیبانی می‌کند که به شما اجازه می‌دهد خروجی لیست را با استفاده از قالب‌های XSLT سفارشی‌سازی کنید. همچنین می‌توانید از Token Based XSL Generator برای طراحی ساده‌تر قالب‌ها استفاده نمایید. این ویژگی برای نمایش داده‌ها به‌صورت کارت، جدول، گرید یا حتی HTML سفارشی بسیار کاربردی است.

در صورت بروز خطا یا عملکرد نادرست، چگونه مشکل را بررسی کنیم؟

ابتدا فایل‌های لاگ DNN را بررسی کنید تا پیام‌های خطا یا هشدار مرتبط با افزونه را مشاهده نمایید. سپس تنظیمات فیلدها، نوع داده‌ها و مجوزهای دسترسی را بررسی کنید. در صورت نیاز، می‌توانید از مستندات رسمی در صفحه Wiki افزونه یا انجمن DNN Community کمک بگیرید. همچنین توصیه می‌شود از نسخه پشتیبان قبل از اعمال تغییرات استفاده نمایید.