يتيح نوع سؤال رفع الملفات في NueForm للمستجيبين إرفاق ملفات بإرسالات نماذجهم. يغطي هذا الدليل كيفية إعداد رفع الملفات وتكوين القيود والوصول إلى الملفات المرفوعة.
إعداد سؤال رفع الملفات
- افتح نموذجك في منشئ NueForm.
- انقر على زر + لإضافة سؤال جديد.
- اختر رفع ملف من قائمة أنواع الأسئلة.
- قم بتكوين عنوان السؤال (مثل "ارفع سيرتك الذاتية" أو "أرفق المستندات الداعمة").
- اضبط السؤال كـ مطلوب إذا كان يجب تقديم ملف.
أنواع الملفات المدعومة
يقبل NueForm مجموعة واسعة من أنواع الملفات. بشكل افتراضي، يتم قبول جميع أنواع الملفات الشائعة. يمكنك تقييد الأنواع المقبولة في خصائص السؤال.
أنواع الملفات الشائعة
| الفئة | الامتدادات |
|---|---|
| المستندات | .pdf, .doc, .docx, .txt, .rtf, .odt |
| جداول البيانات | .xls, .xlsx, .csv, .ods |
| العروض التقديمية | .ppt, .pptx, .odp |
| الصور | .jpg, .jpeg, .png, .gif, .svg, .webp, .bmp |
| الصوت | .mp3, .wav, .ogg, .m4a, .aac |
| الفيديو | .mp4, .mov, .avi, .webm, .mkv |
| الأرشيفات | .zip, .rar, .7z, .tar, .gz |
الملفات التنفيذية (.exe و.bat و.sh و.cmd) محظورة لأسباب أمنية ولا يمكن رفعها بغض النظر عن التكوين.
حدود حجم الملفات
يعتمد الحد الأقصى لحجم الملف لكل عملية رفع على خطة NueForm الخاصة بك:
| الخطة | الحد الأقصى لحجم الملف | حصة التخزين |
|---|---|---|
| Entrepreneur (مجانية) | 10 ميجابايت لكل ملف | 100 ميجابايت إجمالي |
| Pro ($29/شهر) | 50 ميجابايت لكل ملف | 10 جيجابايت إجمالي |
| Enterprise ($99/شهر) | 100 ميجابايت لكل ملف | غير محدود |
تنطبق حدود حجم الملفات على كل عملية رفع فردية. إذا احتاج المستجيب إلى رفع ملفات متعددة، يتم فحص كل ملف مقابل الحد بشكل مستقل.
حصص التخزين
يحتوي كل حساب NueForm على حصة تخزين إجمالية تغطي جميع الملفات المرفوعة عبر جميع النماذج. يشمل ذلك:
- الملفات المرفوعة من المستجيبين عبر أسئلة رفع الملفات.
- ملفات الوسائط المرفوعة بواسطتك في منشئ النماذج (صور وفيديوهات لوسائط الأسئلة).
التحقق من استخدام التخزين
يتم تتبع استخدام التخزين الحالي في إعدادات حسابك. يخزّن NueForm إجمالي البايتات المستهلكة عبر جميع عمليات الرفع.
ماذا يحدث عند الوصول إلى الحد
عند الوصول إلى حصة التخزين:
- ستفشل عمليات رفع الملفات الجديدة من المستجيبين مع رسالة خطأ.
- سيتم رفض إرسالات النماذج التي تتضمن رفع ملفات.
- أنواع الأسئلة الأخرى (نص واختيار وتقييم وغيرها) لا تتأثر.
- يمكنك تحرير مساحة بحذف الردود القديمة التي تحتوي على مرفقات ملفات.
راقب استخدام التخزين بانتظام، خاصة في النماذج ذات حجم الإرسالات العالي. إذا لم يتمكن المستجيبون من رفع الملفات، فقد يتخلون عن النموذج.
كيف يعمل تخزين الملفات
يخزّن NueForm الملفات المرفوعة في Vercel Blob Storage:
- عندما يختار المستجيب ملفًا، يتم رفعه مباشرة إلى تخزين NueForm.
- يُعيّن لكل ملف اسم ملف فريد قائم على UUID (مثل
a1b2c3d4.pdf) لمنع تعارض الأسماء. - يُحفظ اسم الملف الأصلي في البيانات الوصفية إلى جانب الملف المخزّن.
- يُخزّن عنوان URL للملف كقيمة إجابة في الاستجابة.
يتضمن سجل الملف المخزّن:
| الحقل | الوصف |
|---|---|
blobUrl | عنوان URL الدائم للوصول إلى الملف |
originalName | اسم الملف الأصلي من المستجيب |
uuidName | اسم التخزين القائم على UUID |
size | حجم الملف بالبايت |
contentType | نوع MIME (مثل application/pdf) |
formId | النموذج الذي تم رفع الملف له |
createdAt | طابع وقت الرفع |
الوصول إلى الملفات المرفوعة
في لوحة الردود
عند عرض استجابة في لوحة تحكم NueForm، تعرض إجابات رفع الملفات:
- اسم الملف الأصلي.
- رابط تنزيل للوصول إلى الملف.
- حجم الملف.
عبر الواجهة البرمجية
عند استرداد استجابة عبر واجهة الردود البرمجية، تحتوي إجابات رفع الملفات على عنوان URL لتخزين الملف:
{
"questionId": "507f1f77bcf86cd799439033",
"value": "https://storage.nueform.com/uploads/a1b2c3d4.pdf"
}
يمكنك تنزيل الملف بإجراء طلب GET إلى عنوان URL هذا.
عبر Webhooks
تتضمن حمولات webhook عنوان URL للملف كقيمة إجابة:
{
"event": "form.submitted",
"formId": "...",
"responseId": "...",
"answers": [
{
"questionId": "507f1f77bcf86cd799439033",
"value": "https://storage.nueform.com/uploads/a1b2c3d4.pdf"
}
]
}
راجع حمولات Webhook للمرجع الكامل للحمولة.
في تصديرات CSV
عند تصدير الردود كـ CSV، تظهر إجابات رفع الملفات كعناوين URL في خلايا CSV. يمكنك النقر على عناوين URL هذه لتنزيل الملفات.
تكوين خصائص رفع الملفات
في لوحة خصائص السؤال، يمكنك تكوين:
| الخاصية | الوصف |
|---|---|
| العنوان | نص السؤال (مثل "ارفع سيرتك الذاتية") |
| الوصف | نص مساعد أسفل السؤال |
| مطلوب | هل يجب على المستجيب رفع ملف |
رفع ملفات متعددة
إذا كنت تحتاج من المستجيبين رفع ملفات متعددة، أضف عدة أسئلة رفع ملفات إلى نموذجك. كل سؤال يقبل ملفًا واحدًا، مما يبقي الإرسال منظمًا ومرتبًا.
على سبيل المثال:
- السؤال 1: "ارفع سيرتك الذاتية (PDF)"
- السؤال 2: "ارفع خطاب التغطية (PDF)"
- السؤال 3: "ارفع محفظة أعمالك (PDF أو ZIP)"
أفضل الممارسات
كن محددًا بشأن ما يجب رفعه. استخدم عنوان السؤال والوصف لإخبار المستجيبين بالضبط ما هو الملف المطلوب وبأي تنسيق. على سبيل المثال: "ارفع سيرتك الذاتية كملف PDF (حد أقصى 10 ميجابايت)."
اضبط الأسئلة كمطلوبة عند الاقتضاء. إذا كان الملف ضروريًا (مثل سيرة ذاتية لطلب وظيفة)، حدد السؤال كمطلوب. إذا كان اختياريًا (مثل مستندات داعمة إضافية)، اتركه اختياريًا.
راقب استخدام التخزين. تحقق من حصة التخزين بشكل دوري، خاصة إذا كانت نماذجك تتلقى حجمًا عاليًا من الإرسالات. قم بترقية خطتك إذا كنت تقترب من الحد.
عالج الملفات فورًا. إذا كنت تستخدم webhooks لتلقي عناوين URL للملفات، قم بتنزيل ومعالجة الملفات من جانبك. لا تعتمد فقط على تخزين NueForm للأرشفة طويلة المدى.
فكّر في تسمية الملفات في التعليمات. اطلب من المستجيبين تسمية ملفاتهم بشكل وصفي قبل الرفع (مثل "الاسم-اللقب-سيرة-ذاتية.pdf")، حيث يحفظ NueForm أسماء الملفات الأصلية في البيانات الوصفية.
استكشاف الأخطاء وإصلاحها
| المشكلة | الحل |
|---|---|
| فشل الرفع بدون رسالة خطأ | تحقق مما إذا تم تجاوز حصة التخزين. |
| يبدو أن الملف يُرفع لكن الإجابة فارغة | تحقق من أن النموذج منشور وأن رفع الملف اكتمل قبل إرسال النموذج. |
| لا يمكن تنزيل الملف من عنوان URL | عناوين URL للملفات دائمة. إذا لم يعمل عنوان URL، فقد تم حذف الملف كجزء من حذف الاستجابة. |
| رفع الملفات الكبيرة بطيء | قد تستغرق الملفات الكبيرة وقتًا للرفع حسب اتصال الإنترنت للمستجيب. لا يفرض NueForm حدودًا على سرعة الرفع. |
ذو صلة
- أنواع الأسئلة: الوسائط --- نظرة عامة على أنواع الأسئلة المتعلقة بالوسائط
- حمولات Webhook --- كيف تظهر عناوين URL للملفات في بيانات webhook
- مرجع API: الردود --- الوصول إلى الملفات المرفوعة عبر الواجهة البرمجية