أنواع بيانات الحقول
لكل حقل نوع، والنوع يؤدي عملًا صامتًا لصالحك: فهو يحدد كيف يُتحقق من الحقل وكيف يُدخَل ويُعرَض. يحصل المال على منتقي عملة، والتاريخ على تقويم، ويُقنَّع رقم الضمان الاجتماعي، وتعرض القائمة المنسدلة خياراتها — كل ذلك دون أي إعداد من جانبك.
نادرًا ما تحدد النوع يدويًا. يقرؤه Sheetward من اسم الحقل وبياناتك النموذجية — فعمود باسم Unit Price يحوي مبالغ بالدولار يصبح حقل عملة من تلقاء نفسه. ولتحديد النوع صراحةً، ضعه في عمود 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. يُكتشف تلقائيًا من عمود باسم Rating أو Stars. وفي لوحات المعلومات يُحسب متوسط التقييم دائمًا ولا يُجمع أبدًا — فمتوسط 4.2 نجوم له معنى، أما مجموع النجوم فلا، ولذلك لا يُعرض الجمع أصلًا. أتحتاج إلى مقياس مختلف؟ صرِّح بـ rating(n) في عمود Data type بورقة القواعد لأي عدد صحيح من النجوم بين 2 و10 — rating(7) يعطي سبع نجوم بتقييم من 1 إلى 7. أما rating المجرّد فيعني الخمس القياسية. |
| date | تاريخ تقويمي (YYYY-MM-DD)، يُدخَل بمنتقي تاريخ. |
| year | سنة من أربعة أرقام، مثل 2026. تظهر كقائمة منسدلة للسنوات؛ وتُكتشف تلقائيًا من عمود أعداد صحيحة باسم Year أو Fiscal Year أو FY. |
| month | شهر مع سنته، يُخزَّن بصيغة YYYY-MM (مثل 2026-07). يظهر كمنتقي شهر؛ ويُكتشف تلقائيًا من عمود تواريخ باسم Month. |
| datetime | تاريخ مع وقت من اليوم، مثل 2026-07-13 14:30. يظهر كمنتقي تاريخ ووقت؛ ويُكتشف تلقائيًا عندما تحمل الخلايا النموذجية وقتًا فعليًا. |
| time | وقت من اليوم بصيغة HH:MM (مثل 09:30). يظهر كمنتقي وقت؛ ويُكتشف تلقائيًا من خلايا الوقت. |
| عنوان بريد إلكتروني. | |
| boolean | إجابة نعم/لا، تظهر كمربع اختيار. |
| dropdown | قيمة تُختار من قائمة — ورقة List_ تقدّمها أنت، أو قائمة قياسية مدمجة. |
| multi | اختر عدة خيارات من قائمة — تُعرض كمربعات اختيار. صرّح بـ multi في عمود نوع البيانات واربط ورقة List_ بالطريقة نفسها التي تربط بها قائمة منسدلة (باسم الحقل، أو باسم الورقة في عمود القيمة). الحقل الإلزامي يعني اختيارًا واحدًا على الأقل؛ وتكتب عمليات التصدير الاختيارات بصيغة A; B; C. أدرج خيار Other (please specify) في القائمة وسيضيف Sheetward مربع نص بجوار الحقل — إلزامي فقط عندما يكون خيار Other محددًا. |
| ssn | رقم ضمان اجتماعي أمريكي، مُقنَّع على الشاشة. |
| zip | رمز ZIP أمريكي من 5 أرقام، أو ZIP+4. |
| phone | رقم هاتف مع قائمة منسدلة لرمز البلد (الافتراضي +1). |
| credit_card | رقم بطاقة — من 13 إلى 19 رقمًا مع فحص صلاحية (فحص Luhn)، مُقنَّع على الشاشة. لا تُحفظ إلا آخر 4 أرقام: يُفحص الرقم الكامل مرة واحدة عند حفظ السجل ولا يُخزَّن أبدًا، فلا يمكن أن يتسرّب لاحقًا. |
| upc / routing_number | باركود UPC-A أو رقم توجيه مصرفي أمريكي (ABA) من 9 أرقام، ويُتحقق من كلٍّ منهما برقم التحقق الخاص به. |
| 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 · ورقة القواعد | قيد Data type الصريح يفوز دائمًا — مثل rating(7) أو text(20). |
| 2 · اسم الحقل | الأسماء تحمل معنى: date ← تاريخ؛ وprice وamount وtotal وcost وfee ← عملة؛ وquantity / qty ← كمية؛ وcount / number_of ← عدد صحيح (عمود unit هو منتقي وحدة لحقل كمية، لا عدّاد)؛ وrating / stars ← تقييم؛ وكذلك ssn وzip وphone وemail وfile؛ وللوسائط: image / photo ← صورة، وvideo ← فيديو، وaudio / sound ← صوت، وdocument / pdf ← مستند. |
| 3 · بياناتك النموذجية | تحسم القيم وتنسيق الخلايا الأمر: الأعداد الصحيحة ← عدد صحيح، والأرقام ذات الكسور العشرية ← رقم، والخلية المنسَّقة تنسيقًا نقديًا ($ € £ …) ← عملة. |
| وإلا | يكون الحقل نصًا عاديًا text. |
قائمتا «الوحدة» و«العملة» لا تحتاجان نوعًا خاصًا بهما. فهما حقلا dropdown مرتبطان بالقوائم القياسية المدمجة، لذا اترك عمود Data type في ورقة القواعد فارغًا في أي صف يستهدف إحداهما — وما يُكتب فيه يُتجاهل. المهم هو نوع عمود القيمة المجاور: quantity هو ما يستدعي قائمة الوحدة، وcurrency هو ما يستدعي قائمة العملة. أما إعلان integer أو number بدلًا منهما فيعطيك رقمًا عاديًا بلا أي قائمة — وهذا هو السبب المعتاد في عدم ظهور قائمة كنت تتوقعها.
كيف يُحدَّد النوع (الأعلى يفوز): (1) Data type صريح في ورقة القواعد؛ (2) اسم الحقل — الأسماء التي تحتوي
date ← تاريخ، وprice/amount/total/cost/fee ← عملة، وquantity/qty ← كمية، وcount/number_of ← عدد صحيح، وrating/stars ← تقييم، إضافةً إلى ssn وzip وphone وemail، وimage/photo ← صورة، وvideo ← فيديو، وaudio/sound ← صوت، وdocument/pdf ← مستند، وfile؛ (3) قيم البيانات النموذجية وتنسيق الخلايا — الأعداد الصحيحة ← عدد صحيح، والأرقام ذات الكسور ← رقم، والخلية المنسَّقة تنسيقًا نقديًا ($ € £ …) ← عملة؛ (4) وإلا فـ text.تلك هي أنواع الحقول كلها. للاطلاع على القوائم القياسية المدمجة (الدول والعملات والوحدات…)، والتنسيق المراعي للمنطقة، وكل ما تستطيعه العلاقة، انظر مرجع أنواع البيانات.