الأخطاء والتحذيراتمرجع
عند رفع أي مصنف، يفحصه Sheetward قبل أن يبني شيئًا، ثم يبلّغ عن نوعين من الرسائل. الأخطاء تمنع الإنشاء حتى تصلحها. أما التحذيرات فإرشادية: يُنشأ التطبيق رغمها، لكن شيئًا ربما قصدته لم يصل. وتنمو هذه القائمة كلما أُضيفت فحوص جديدة.
الأخطاء — هذه توقف الرفع؛ ولا يُنشأ التطبيق حتى تُصلَح:
| الرسالة | ما معناها — وكيف تصلحها |
|---|---|
| لا توجد ورقة نموذج | لا يحتوي المصنف على ورقة Form_، ولم يُكتشف شيء تلقائيًا كبيانات. سمِّ ورقة باسم Form_<الاسم> — مثل Form_Invoice. |
| نموذج فارغ أو بلا حقول | ورقة Form_ فارغة، أو تحمل محتوى لا يستطيع Sheetward قراءته كحقول. أضِف صفوف تسمية/قيمة، أو تخطيط HEADER / LINE ITEMS. |
| قيمة بلا اسم حقل | يحتوي نموذج على قيمة والخلية التي تسبقها في الصف فارغة — تُركت تسمية الحقل خالية — ولن يسمّي Sheetward حقلًا باسم بياناتك. أضِف اسم الحقل، أو احذف القيمة. |
| خلايا مدمجة | تحتوي ورقة غير Info_ على خلايا مدمجة. يقرأ Sheetward كل ورقة بحسب المواضع — النموذج كأزواج اسم حقل / قيمة، وورقة القوائم أو القواعد كعناوين أعمدة فوق الصفوف — والدمج يجعل ذلك غير قابل للقراءة. ألغِ الدمج (الصفحة الرئيسية ← دمج وتوسيط) واجعل لكل إدخال خلية خاصة به. استثناءان: أوراق Info_ لا تُفحص إطلاقًا — فهي نص حر؛ وعنوان مدمج عبر الصف العلوي في ورقة Form_ بدءًا من A1 مقبول أيضًا، شرط أن يكون الصف 2 أسفله فارغًا أو يحمل علامة قسم مثل HEADER فقط. أما خلية A1 مدمجة فوق أول حقل مباشرة فهي خطأ كغيرها. |
| عنوان قسم مكرر أو بأحرف صغيرة | يجوز للنموذج تجميع حقوله في أقسام، لكن يجب أن يكون كل عنوان قسم بأحرف كبيرة وألّا يتكرر أي عنوان. ومع وجود عدة شبكات بنود، تسري القواعد نفسها على لافتات الشبكات — فالقواعد والصيغ والتصدير تجد الشبكة باسمها. |
| البنود قبل الترويسة | جدول البنود يقع فوق حقول الترويسة — يجب أن تأتي الترويسة أولًا، وجدول LINE ITEMS أسفلها. وغالبًا يعني هذا أن الورقة عرّفت النموذج نفسه مرتين عن طريق الخطأ (مرة كشبكة أعمدة ومرة كأزواج تسمية : قيمة)؛ أبقِ تعريفًا واحدًا. |
| تسمية شبكات البنود | النموذج الذي يضم عدة جداول بنود يجب أن يسمّي كل شبكة بلافتة بأحرف كبيرة تنتهي بـ LINES أو LINE ITEMS ("PART LINES"). تظهر هذه الرسالة عندما تَعِد لافتة بشبكة ثم تليها صفوف تسمية/قيمة (line_title_not_grid)، أو عندما تفتقر شبكة ثانية إلى لافتة (line_grid_unbannered)، أو عندما لا يعلو الشبكةَ المعلنة قسمُ ترويسة (line_grid_without_header). |
| تكرار ورقة دور | يحتوي المصنف على أكثر من ورقة Rules_/Validation_ أو Formula_/Logic_ أو Translation_ أو Info_. كل دور من هذه الأدوار يجب أن يقتصر على ورقة واحدة — فادمجها معًا. |
| أكثر من مفتاح | يضع النموذج علامة مفتاح على أكثر من حقل. أبقِ مفتاحًا واحدًا؛ وإذا كان عمودان معًا يحدّدان السجل، فاجعل الثاني مفتاحًا فرعيًا. |
| أكثر من مفتاح فرعي | يضع النموذج علامة مفتاح فرعي على أكثر من حقل — ولا يجوز للنموذج إلا واحد. |
| مفتاح فرعي بلا مفتاح | يحتوي النموذج على مفتاح فرعي دون مفتاح أساسي. أضِف قاعدة مفتاح إلى الحقل الأساسي. |
| مفتاح مكرّر (حقل تلقائي) | ينتهي القسم بحقلَي مفتاح بعد احتساب الحقل المرقّم تلقائيًا — فحقل auto/autogen هو المفتاح ضمنيًا. أبقِ واحدًا: ضع قاعدة المفتاح وقاعدة auto على الحقل نفسه، أو احذف القاعدة الزائدة. |
| اسم حقل مكرّر | قسم في النموذج يكرّر اسم حقل. سيظهر الحقل مرتين في النموذج مع أنه حقل واحد — فتعبئة أحد المربّعين تعبّئ الآخر، وتُحفظ قيمة واحدة. احذف الصف المكرّر من المصنف، أو أعد تسمية أحدهما. (يُسمح بتكرار محدّدات العملة ووحدة القياس.) |
| تعذّر إنشاء التطبيق | حدث خطأ غير متوقع أثناء بناء التطبيق من المصنف — والرسالة تذكر التفاصيل. غالبًا يكون السبب قاعدة أو بنية غير سليمة. |
التحذيرات — يُنشأ التطبيق رغمها. وتصل في قائمتين: يستحق المراجعة (اتخذ Sheetward قرارًا اجتهاديًا — راجعه) ولم يُدرَج في التطبيق (شيء لم يُستخدم إطلاقًا):
| الرسالة | ما معناها — وكيف تصلحها |
|---|---|
| قائمة بيانات رئيسية فارغة | لم تُنتج ورقة List_ أي قيم، لذا ستكون القائمة المنسدلة التي تغذّيها فارغة. |
| لم تُطبَّق القواعد | كانت في ورقة Rules_ صفوف لكن تعذّرت قراءة أي منها — فلم يُضَف أي تحقق. |
| لم تُطبَّق الصيغ | كانت في ورقة Formula_ (أو Logic_) صفوف لكن تعذّرت قراءة أي منها — فلم تُضَف حقول محسوبة. |
| نوع بيانات غير معروف | لم يُتعرَّف على قيمة في عمود Data type، فاستخدم Sheetward النوع الذي استنتجه من قيمك النموذجية بدلًا منها. |
| تسميتان، اسم داخلي واحد | تسميتان مختلفتان تؤولان إلى اسم الحقل الداخلي نفسه ("Amount (EUR)" و"Amount EUR" تصبحان معًا amount_eur). كلا الحقلين يعمل — ويُخزَّن الثاني باسم مرقَّم. ولا يهم ذلك إلا إذا أشرت إليه في ورقة Rules_ أو Formula_. |
| نوع قاعدة غير معروف | قيمة Rule Type ليست من الأنواع المدعومة، فجرى تخطّي تلك القاعدة. |
| قيمة قاعدة غير قابلة للقراءة | تعذّرت قراءة قيمة Value الخاصة بقاعدة وفق نوعها (نمط غير صالح مثلًا)، فجرى تخطّي تلك القاعدة. |
| صيغة غير سليمة | تحتوي صيغة على أقواس غير متوازنة أو حرف غير صالح، فجرى تخطّي تلك الصيغة. |
| صيغة Excel داخل خلية | تحتوي خلية على صيغة Excel (مثل =B2*C2). يُقرأ المصنّف كقيم، لذا وصلت الخلية كالرقم الذي حفظه Excel آخر مرة ولن يُعاد حسابها في التطبيق. انقل الحساب إلى ورقة Formula_ أو قاعدة calc. |
| لم تُحَل العلاقة | تعذّرت مطابقة هدف حقل العلاقة — النموذج أو الحقل مفقود، أو الهدف ليس مفتاحًا ولا مفتاحًا فرعيًا — فبقي الحقل نصًا عاديًا. |
| تلميح Info متجاهَل | كانت قيمة country أو currency أو locale في ورقة Info_ غير سليمة (اسم في موضع رمز، مثلًا)، فتُجوهلت. |
| يبدو كتنسيق إقليمي | القيمة النموذجية لحقل نصي تبدو كتاريخ أو رقم مخزَّن كنص، وهو ما يُقرأ بشكل مختلف من منطقة إلى أخرى. خزّن تواريخ وأرقامًا حقيقية، أو استخدم صيغة ISO (YYYY-MM-DD). |
| ورقة دخيلة متجاهَلة | تم تجاهل ورقة لا يطابق اسمها أي بادئة معروفة. |
| مشكلة في لوحة المعلومات | تعذّرت قراءة ورقة Report_/Analytics_ بالكامل، فجرى تخطّي ذلك العنصر أو لوحة المعلومات. |
كل ما هنا يظهر في خطوة الرفع، قبل إنشاء التطبيق. صحّح كل خطأ وأعد الرفع. ويمكنك المتابعة مع التحذيرات بأمان — لكن اقرأ قائمة يستحق المراجعة أولًا: فتلك الأجزاء موجودة في تطبيقك، وقد لا تطابق ما كتبته.