أنواع بيانات الحقول
لكل حقل نوع — يحدد كيف يُتحقَّق منه ويُدخَل ويُعرَض. المال يحصل على منتقي عملة، والتاريخ على تقويم، ويُقنَّع الـ SSN، وتسحب القائمة المنسدلة من قائمة.
نادرًا ما تضبط النوع يدويًا — يقرأه Sheetward من اسم الحقل وبياناتك النموذجية. لتحديده صراحةً، ضعه في عمود 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%»). |
| rating | تقييم من 1 إلى 5 نجوم. يُعرض كخمس نجوم قابلة للنقر (فارغة افتراضيًا)، وتظهر نجوم للقراءة فقط في الجدول والطباعة. يُخزَّن كعدد صحيح من 1 إلى 5؛ اتركه فارغًا عند عدم التقييم. يُكتشف تلقائيًا من عمود باسم Rating أو Stars. في لوحات المعلومات يُحسب متوسط التقييم ولا يُجمع؛ المتوسط هو الإعداد الافتراضي والجمع غير متاح. هل تحتاج إلى مقياس مختلف؟ اكتب rating(n) في عمود «نوع البيانات» بورقة القواعد للحصول على حقل من n نجوم — أي عدد صحيح من 1 إلى 10 (على سبيل المثال، rating(7) يعطي سبع نجوم، بتقييم من 1 إلى 7). أما rating المجرَّد فيستخدم القيمة القياسية 5. |
| 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 ← عدد صحيح، وrating/stars ← تقييم، بالإضافة إلى ssn وzip وphone وemail وimage/photo ← صورة وvideo ← فيديو وaudio/sound ← صوت وdocument/pdf ← مستند وfile؛ (3) قيم البيانات النموذجية وتنسيق الخلية — الأعداد الصحيحة ← عدد صحيح، والأرقام ذات الكسور ← رقم، والخلية المنسّقة كعملة ($ € £ …) ← عملة؛ (4) وإلا text.تلك هي أنواع الحقول. للقوائم القياسية المدمجة (الدول، العملات، الوحدات…)، والتنسيق حسب المنطقة، وقواعد العلاقة الكاملة، انظر مرجع أنواع البيانات.