این مدل وظیقه‌ی نگه‌داری فرم‌های ساخته شده توسط کاربران را دارد و اطلاعات مربوط به هر فرم را در خود ذخیره کرده تا در ادامه با استفاده از مدل Field بتوانیم سوالات برای این فرم ایجاد کنیم و آن را برای پاسخ‌دهی به اشتراک بگذاریم.

• باید بتوان از طریق مدل User با استفاده از ویژگی created_forms به فرم‌های ساخته شده توسط کاربر دسترسی داشت و همچنین در صورت حذف کاربر فرم‌های مربوط به آن نیز حذف شوند.
• مقدار پیش‌فرض برای فیلد success_message برابر با رشته‌ی زیر است:

Thank you for your submission!

ویژگی is_expired

بررسی می‌کند آیا فرم منقضی شده است؛ برای این‌کار باید بررسی کنید زمان فعلی از زمان منقضی شدن فرم کمتر باشد.

ویژگی is_submission_limit_reached

بررسی می‌کند آیا محدودیت پاسخ‌ها پر شده است یا خیر؛ برای این‌کار باید از ارتباط میان این مدل با مدل Response استفاده کنید و در صورتی که متغیر submission_limit برای این فرم مقداردهی شده است، چک کنید آیا تعداد پاسخ‌ها بیشتر مساوی مقدار این فیلد باشد؛ در غیر این‌صورت False برگردانید.

ویژگی can_accept_submissions

یک مقدار بولی برمی‌گرداند که نشان می‌دهد فرم هنوز می‌تواند پاسخ جدید بگیرد یا خیر؛ برای پیاده‌سازی باید چک کنید فرم فعال باشد و منقضی نشده باشد و محدودیت پاسخ آن پر نشده باشد؛ در غیر این‌صورت مقدار False برگردانده شود.

متد‌ __str__

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

TITLE

متد‌ get_response_count()

در این متد باید تعداد پاسخ‌های مرتبط با فرم را از طریق رابطه‌ی میان مدل‌های Form و Response برگردانید.

متد‌ get_completion_rate()

نرخ تکمیل فرم را برمی‌گرداند؛ نرخ تکمیل که عددی ببین 0 و 100 است، از تقسیم تعداد پاسخ‌ها بر تعداد بازدید‌های فرم ضرب‌در 100 بدست می‌آید. همچنین برای دریافت تعداد ویو‌های مربوط به هر فرم باید از رابطه‌ی موجود میان مدل‌های Form و FormView استفاده کرد.

این مدل وظیفه‌ی نگه‌داری اطلاعات مربوط به سوالات یک فرم را دارد و باید حاوی فیلدهای زیر باشد.

• فیلد field_type می‌تواند از یک فیلد انتخابی است که مقادیر مجاز برای آن به شکل زیر است:

FIELD_TYPES = [
    ('text', 'Text'),
    ('email', 'Email'),
    ('number', 'Number'),
    ('textarea', 'Textarea'),
    ('select', 'Select'),
    ('radio', 'Radio'),
    ('checkbox', 'Checkbox'),
    ('file', 'File Upload'),
    ('date', 'Date'),
    ('url', 'URL'),
    ('phone', 'Phone'),
]

• options فقط برای فیلدهای چند گزینه‌ای (select, radio, checkbox) استفاده می‌شود و انتخاب‌های مجاز آن را نشان می‌دهد.
• min_length و max_length برای فیلدهای متنی کاربرد دارند و درصورت مقدار دهی یک بازه‌ی مشخص برای طول کاراکترهای آن فیلد تعیین می‌شود.
• min_value و max_value برای فیلدهای عددی کاربرد دارند و درصورت مقدار دهی یک بازه‌ی مشخص برای مقدار آن فیلد تعیین می‌شود.

متد‌ __str__

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

FORM_TITLE - LABEL

متد‌ clean()

در این متد باید صحت مقادیر داده شده را برای ایجاد یک نمونه از مدل Field را بررسی کنید.

برای این کار ابتدا بررسی کنید اگر این فیلد از یکی از انواع فیلدهای انتخابی است و مقدار options خالی یا برابر لیست خالی است، یک ValidationError با پیغام زیر پرتاب کنید:

Choice fields must have at least one option.

در مرحله‌ی بعد، در صورت مقداردهی فیلد‌های min_value و max_value بایستی بررسی کنید مقدار max_value همواره بزرگتر مساوی مقدار min_value باشد و در غیر این صورت یک ValidationError با پیغام زیر پرتاب کنید:

Minimum value cannot be greater than maximum value.

در ادامه همین اعتبارسنجی را برای فیلدهای min_legth و max_length نیز انجام دهید و در صورت وجود خطا باید حاوی پیغام زیر باشد:

Minimum length cannot be greater than maximum length.

در نهایت در صورت مقداردهی فیلد regex_pattern، بررسی کنید آیا الگوی وارد شده یک الگوری Regex معتبر است یا خیر. در صورت نامعتبر بودن یک ValidationError با پیغام زیر پرتاب کنید:

Invalid regex pattern.

متد‌ validate_value(value)

این متد وظیفه‌ی اعتبارسنجی مقدار ورودی (value) برای یک نمونه از مدل Field را دارد. خروجی این متد یک لیست خواهد بود که در صورت وجود خطا حاوی این خطاها می‌باشد.

در صورتی که فیلد اجباری است اما مقدار ورودی خالی است (یعنی مقدار دهی نشده است) یک لیست تک‌عضوی حاوی رشته‌ی زیر را برگردانید:

"{label} is required."

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

اما در غیر این صورت بر اساس نوع فیلد (field_type) اعتبارسنجی‌های زیر را انجام دهید:

• email: مقدار ورودی را با الگوی [a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\.[a-zA-Z]{2,}$ تطابق داده و در صورت عدم تطابق خطای زیر را به لیست خطاها اضافه کنید:

Please enter a valid email address.

• number: در این‌صورت سه مرحله اعتبارسنجی باید انجام دهید و هر کجا به خطا برخوردید دیگر ادامه ندهید؛ در مرحله‌ی اول، چک کنید مقدار داده شده از نوع عددی باشد و در غیر این صورت ارور زیر را به لیست ارورها اضافه کنید:

Please enter a valid number.

اگر ورودی از نوع عددی بود و فیلد min_value مقداردهی شده بود باید بررسی شود مقدار ورودی بیشتر مساوی مقدار این فیلد باشد و در غیر این‌صورت خطای زیر به لیست خطاها اضافه شود:

Value must be at least {min_value}.

و اگر ورودی از نوع عددی بود و از مراحل قبل عبور کردید، این بار همین کار را برای فیلد max_value انجام دهید و بررسی کنید مقدار ورودی کمتر مساوی مقدار این فیلد باشد و در غیر این صورت خطای زیر را اضافه کنید:

Value must be at most {max_value}.

• url: باید مقدار آدرس داده شده را بررسی کنیم تا یک URL معتبر باشد؛ برای این‌کار با استفاده از الگوی زیر این مورد را بررسی کنید:

^https?://(?:[-\w.])+(?:[:\d]+)?(?:/(?:[\w/_.])*(?:\?(?:[\w&=%.])*)?(?:#(?:\w*))?)?$

در صورت عدم تطابق پیغام خطای زیر را به لیست خطاها اضافه کنید:

Please enter a valid URL.

• phone: برای بررسی معتبر بود شماره تلفن وارد شده باید ابتدا آن را با الگوی ^\+?[1-9][0-9]{7,14}$ تطبیق داده و در صورت عدم مطابقت پیغام خطای زیر را اضافه کنید:

Please enter a valid phone number.

• select یا radio: در صورتی که مقدار ورودی داده‌شده در فیلد options که مقادیر مجاز برای فیلدهای انتخابی است وجود نداشت، پیغام خطای زیر را اضافه کنید:

Please select a valid option.

• checkbox: برای فیلدهای از نوع چند انتخابی که ورودی از نوع لیست است، باید تمام اعضای لیست را بررسی کنید و در صورتی که حداقل یکی از اعضای لیست ورودی جز مقادیر مجاز برای این فیلد نبود خطای زیر را به لیست خطاها اضافه کنید:

Please select valid options.

در ادامه باید مقادیر max_length و min_length را بررسی کنید؛ در صورت مقداردهی باید مقدار ورودی را با توجه به مقادیر موجو در این متغیر ها بررسی کنید تا در بازه‌ی مورد نظر باشند. در صورتی که طول کاراکترهای ورودی از min_legth کمتر است خطای زیر را اضافه کنید:

Must be at least {min_length} characters long.

در غیر این‌صورت اگر طول کاراکترها از max_length بیشتر است پیغام خطای زیر را اضافه کنید:

Must be at most {max_length} characters long.

در آخر، در صورت مقداردهی فیلد regex_pattern باید الگوی موجود در این فیلد را با مقدار ورودی تطبیق داده و در صورت عدم تطابق، اگر فیلد custom_error_message مقداردهی شده بود آن را به لیست ارورها اضافه کنید و در غیر این‌صورت خطای زیر را اضافه کنید:

Invalid format.

در نهایت پس از انجام اعتبارسنجی‌های بالا لیست خطاها را برگردانید.