أنواع بيانات الحقول
لكل حقل نوع — يحدد كيف يُتحقَّق منه ويُدخَل ويُعرَض. المال يحصل على منتقي عملة، والتاريخ على تقويم، ويُقنَّع الـ SSN، وتسحب القائمة المنسدلة من قائمة.
نادرًا ما تضبط النوع يدويًا — يقرأه SheetApps من اسم الحقل وبياناتك النموذجية. لتحديده صراحةً، ضعه في عمود Data type في ورقة القواعد (تُقبَل صيغ مألوفة كثيرة). وهذا هو الكتالوج الكامل:
| النوع | يتحقق من |
|---|---|
| text / textarea | نص حر. يمكن إضافة حد اختياري للطول باستخدام text(20) — بحد أقصى 20 حرفًا (ينطبق أيضًا على textarea). |
| integer | أعداد صحيحة فقط (بدون كسور عشرية)، مثل أعداد العناصر غير القابلة للتجزئة. |
| number / decimal | أرقام بمنازل عشرية (مرادفات: numeric، decimal، float). تُعرض بمنزلتين عشريتين افتراضيًا؛ يمكن تجاوزها بـ decimal(4). |
| quantity | مقدار عشري بوحدة قياس — مثل «12.50 kg». يحصل على منتقي وحدة ليختار كل سجل وحدته. انظر العملات والوحدات لكيفية اكتشاف الوحدات ومشاركتها. |
| currency / amount | مال (أسماء بديلة: amount، money). يحصل على منتقي عملة ليختار كل سجل عملته؛ والاختيار الفارغ يستخدم عملة التطبيق الافتراضية. انظر العملات والوحدات لكيفية اكتشاف المنتقي ومشاركته ووضعه. |
| percent | قيمة نسبة مئوية تُعرض بعلامة % (15 ← «15%»). |
| date | تاريخ تقويمي (YYYY-MM-DD)؛ يعرض منتقي تاريخ. |
| year | سنة تقويمية من أربعة أرقام، مثل 2026. تظهر كقائمة منسدلة للسنة، ويتم اكتشافها تلقائيًا من عمود أعداد صحيحة باسم السنة / السنة المالية / FY. |
| month | شهر تقويمي مع سنته — يُخزَّن بصيغة YYYY-MM (مثل 2026-07). يظهر كمنتقٍ للشهر، ويتم اكتشافه تلقائيًا من عمود تواريخ باسم الشهر. |
| datetime | تاريخ مع وقت من اليوم، مثل 2026-07-13 14:30. يظهر كمنتقٍ للتاريخ والوقت، ويتم اكتشافه تلقائيًا من الخلايا التي تحمل مكوِّن وقت فعلي. |
| time | وقت من اليوم — HH:MM (مثل 09:30). يظهر كمنتقٍ للوقت، ويتم اكتشافه تلقائيًا من خلايا الوقت. |
| عنوان بريد إلكتروني. | |
| boolean | صحيح / خطأ (مربع اختيار). |
| dropdown | قيمة مختارة من قائمة بحث (ورقة List_ أو قائمة قياسية). |
| ssn | رقم ضمان اجتماعي أمريكي (مُقنّع). |
| zip | ZIP من 5 أرقام أو ZIP+4. |
| phone | هاتف مع قائمة منسدلة لرمز البلد (الافتراضي +1). |
| credit_card | 13–19 رقمًا + فحص Luhn (مُقنّع). تُخزَّن آخر 4 أرقام فقط — يُتحقق من الرقم الكامل مرة واحدة عند الحفظ ولا يُحفظ أبدًا. |
| upc / routing_number | رقم تحقق UPC-A / مجموع تحقق توجيه ABA من 9 أرقام. |
| url | رابط ويب/URL. |
| file | مرفق ملف عام (حد الحجم معروض أسفل الحقل). تُعرض الصور وملفات PDF والنصوص داخل المتصفح؛ وتُرفض النصوص البرمجية. للوسائط المحددة استخدم الأنواع image / video / audio / doc أدناه. |
| image | رفع صورة (jpg, png, webp, gif, bmp — بدون SVG). تعرض صورة مصغّرة؛ انقر للعرض بالحجم الكامل؛ والتنزيل. |
| video | رفع فيديو (mp4, mov, webm). يعرض صورة مصغّرة؛ انقر للتشغيل في مكانه؛ والتنزيل. |
| audio | رفع صوت (mp3, wav, ogg, m4a). يُشغَّل ضمن الصفحة مع زر تنزيل. |
| doc | رفع مستند — للقراءة فقط. تُعرض ملفات PDF والنصوص وCSV داخل المتصفح؛ وتُنزَّل ملفات Word وExcel وPowerPoint. تُقبل أنواع المستندات الآمنة فقط. |
| relation | بحث بين النماذج: يشير إلى سجل في نموذج آخر من التطبيق نفسه عبر مفتاح العمل لذلك النموذج. يظهر كقائمة اختيار سجلات قابلة للبحث تخزّن مفتاح السجل المختار. |
| ulid / nanoid | معرّف للقراءة فقط يُولَّد تلقائيًا ويملؤه التطبيق عند إنشاء السجل. ulid — معرّف من 26 حرفًا قابل للفرز؛ nanoid — معرّف عشوائي مُختصر طوله الافتراضي 21 (nanoid(10) ← الطول 10). كلاهما يستخدم Crockford base32 (أحرف كبيرة، مع إزالة الأحرف المتشابهة I L O U). |
كيف يُحدَّد النوع (الأعلى يفوز): (1) نوع بيانات صريح في ورقة القواعد؛ (2) اسم الحقل — الأسماء التي تحتوي
date ← تاريخ، وprice/amount/total/cost/fee ← عملة، وquantity/qty ← كمية، وcount/units ← عدد صحيح، بالإضافة إلى ssn وzip وphone وemail وimage/photo ← صورة وvideo ← فيديو وaudio/sound ← صوت وdocument/pdf ← مستند وfile؛ (3) قيم البيانات النموذجية وتنسيق الخلية — الأعداد الصحيحة ← عدد صحيح، والأرقام ذات الكسور ← رقم، والخلية المنسّقة كعملة ($ € £ …) ← عملة؛ (4) وإلا text.تلك هي أنواع الحقول. للقوائم القياسية المدمجة (الدول، العملات، الوحدات…)، والتنسيق حسب المنطقة، وقواعد العلاقة الكاملة، انظر مرجع أنواع البيانات.