WindoorERP الدليل 19.0

إدارة إجراءات النوافذ وإجراءات الخادم وأدوات عرض QWeb وشجرة القوائم وتنسيقات الورق

9 دقيقة قراءة آخر تحديث 2026-08-30 WindoorERP 19.0
هذا المقال هو الخطوة 4 من 4 في 12- تجهيز مستنداتك ومطبوعاتك

ما الذي يفعله هذا

الإعدادات › تقني هي غرفة الآلات: الإجراءات خلف كل قائمة وزر، وأدوات العرض التي ترسم كل شاشة، وشجرة القوائم نفسها، وعوامل تصفية البحث المحفوظة، وتنسيقات الورق التي تشكّل كل PDF مطبوع. هذه المقالة مرجع مسؤول النظام لتلك الشاشات — الغرض من كل واحدة، وما الذي يؤمَن لمسُه، وحفنة السلوكيات التي تعضّ. إنها مكان يُقصد عمداً؛ وفي معظم الأيام يكون الوقت الصحيح لقضائه هنا: لا شيء.

قبل أن تبدأ

  • وضع المطوّر — شجرة "تقني" كلها غير مرئية من دونه، وذلك مفروض في الكود لا عرفاً. فعّله من الإعدادات › أدوات المطورين.
  • صلاحية Administrator فوق ذلك لتحرير كود بايثون في إجراء خادم — من دونها لا يظهر محرر الكود في النموذج أصلاً.
  • عادة التوسيع بدل التحرير: فالتغييرات على السجلات القياسية هنا يمحوها تحديث الوحدة التالي.

عائلة الإجراءات

تضم تقني › الإجراءات سجلاً لكل نوع إجراء. إجراءات النافذة تفتح البيانات — النموذج وأوضاع العرض والنطاق والسياق والهدف وتخصيصات العرض لكل وضع؛ وتبويب الظهور يقيّدها بالمجموعات. إجراءات العميل روابط إلى مكوّنات يسجلها كود عميل الويب — يمكنك النظر، لكن لا يمكن تأليف إجراء عامل من هذه الشاشة. الإجراءات المضمنة هي التبويبات الإضافية بجوار مسار التنقل في النموذج (على قاعدة البيانات هذه: شريط لوحة المعلومات/المهام/مراحل الإنجاز في تطبيق المشاريع)؛ التبويبات التي أضافها المستخدمون يمكن حذفها، أما المشحونة مع النظام فترفض بالرسالة "لا يمكنك حذف إجراء ضمني افتراضي". معالِجات التهيئة هي خطوات الإعداد الأول التي تصفّها الوحدات — وزر إطلاق يعيد تشغيل أحدها على قاعدة البيانات الحية. القيم الافتراضية التي يحددها المستخدم تخزن كل قيمة افتراضية ضُبطت عبر قائمة المطوّر تعيين كافتراضي، مقيّدةً بالمستخدم والشركة.

نموذج إجراء خادم: النموذج ونوع الإجراء والأقسام التي تظهر للنوع المختار

وتستحق إجراءات الخادم فقرتها الخاصة. نوع الإجراء واحد من أحد عشر في هذا الإصدار: تحديث سجل أو إنشاؤه أو تكراره، وتنفيذ كود بايثون، وإرسال Webhook، وسلسلة إجراءات في إجراء متعدد، إضافة إلى عائلة البريد والرسائل النصية (إنشاء نشاط، إرسال بريد، إضافة متابعين أو إزالتهم، إرسال SMS). وحاضنة بايثون صارمة — لا استيراد، ومجموعة ثابتة من الدوال المضمنة، ومتغيرات السجل والبيئة التي يوثقها النموذج. ثلاثة سلوكيات يجب احترامها:

  • الإجراء المهيأ خطأً يُحفظ مع مجرد شريط تحذير أصفر — ثم يرفض التشغيل ("Server action … has one or more warnings, address them first." — تظهر هذه الرسالة بالإنجليزية). وقد يبقى موصولاً بقائمة أو مهمة مجدولة أسابيع قبل أن يشغّله أحد ويكتشف المشكلة؛ فأزل التحذير قبل أن تنصرف.
  • إشعارات Webhook تُطلق وتُنسى بمهلة ثانية واحدة: الإرسال الفاشل يُسجَّل في السجلات، ولا يُعرض على أحد، ولا يتراجع أبداً عن التغيير الذي أطلقه.
  • إنشاء إجراء سياقي هو ما يضع الإجراء في قائمة ⚙ للسجل؛ وسجل الكود يحفظ كل مراجعة للبايثون ويقدّم معالج مقارنة واستعادة.

أدوات العرض وطرق العرض المخصصة وعناصر القائمة

سجل أداة عرض: محرر بنية XML مع التحذير الدائم من تحرير أدوات العرض القياسية

أدوات العرض هي سجل XML لكل شاشة. والنموذج نفسه يحمل التحذير المهم: التعديلات على أداة عرض قياسية تُمحى أثناء تحديثات الوحدات المقبلة — وسّع عبر أداة عرض موروثة بدلاً من ذلك. وللوراثة قواعدها (أداة العرض بوضع الامتداد يجب أن تسمّي أباها؛ ولا يمكن حذف أب ما دام له أبناء يرثونه؛ والمجموعات توضع داخل XML أداة العرض الموروثة لا على سجلها)، ومحرر البنية يتحقق أثناء الكتابة ويرفض XML المكسور فعلاً برسائل مثل "لا يمكنك إنشاء أدوات عرض موروثة متداخلة."، وزر إعادة تعيين بنية العرض في شريط المطوّر يستطيع استعادة النسخة المحفوظة السابقة (ناعم)، أو إعادة قراءة ملف الوحدة من القرص (صلب)، أو المقارنة بأداة عرض أخرى. أما طرق العرض المخصصة فأهدأ من اسمها: مخزن المستخدمين لتخطيطات القوائم المعاد ترتيبها شخصياً — على قاعدة البيانات هذه قوائم أوامر بيع وعمليات نقل ومهام وفواتير لعدد من المستخدمين — احذف صفاً يُعَد تخطيطُ ذلك المستخدم الشخصي إلى أصله.

عناصر القائمة تسرد شجرة القوائم كاملة، بما يخفيه مبدّل التطبيقات. سلوكان مهمان: القائمة بلا مجموعات ليست عامة — فالظهور يعود إلى صلاحية القراءة على نموذج الإجراء؛ وحذف قائمة أب لا يحذف أبناءها — بل يرقّون إلى المستوى الأعلى، فرتّب الشجرة الفرعية قبل إزالة مجلدها.

عوامل التصفية والتأهيلات والجولات

عوامل التصفية التي يحددها المستخدم تخزن كل بحث محفوظ. في هذا الإصدار يُشارك عامل التصفية مع مجموعة من المستخدمين (تمت المشاركة مع) — وتركُ المجموعة فارغة يعني المشاركة مع الجميع، وهكذا ينتهي تجريب شخصي على شاشات الشركة كلها. ولا شيء يفرض التفرد: عاملا تصفية يمكن أن يحملا الاسم نفسه، وعدة عوامل يمكن تعليمها افتراضية للشاشة ذاتها — وهذه القائمة هي المكان الوحيد لاكتشاف ذلك وترتيبه. التأهيلات والجولات تسردان لافتات التشغيل الأول والجولات الموجهة التي لها حالة في قاعدة البيانات — وقائمة الجولات لا تعرض إلا الجولات التي استُهلكت أو سُجّلت، فهي تقلل مما يشحنه العميل فعلاً.

تنسيقات الورق وسجل التقارير

تنسيق ورقة: حجم الصفحة والاتجاه والهوامش الأربعة وتباعد الترويسة ودقة الإخراج

كل PDF في النظام يشكّله تنسيق الورقة: حجم الصفحة (سلسلتا A وB وLetter وLegal أو مخصص بعرض وارتفاع صريحين)، والاتجاه، والهوامش الأربعة، وتباعد الترويسة (المسافة المحجوزة للترويسة المتكررة — مستقلة عن الهامش العلوي، ولا تساويه إلا حين يريد التنسيق ترويسة ملاصقة)، وخط الترويسة، ودقة الإخراج، والتحكم بالتقليص الذكي. ثلاثة عشر تنسيقاً تسكن قاعدة البيانات هذه: A4 وUS Letter القياسيان، وأحد عشر تنسيقاً خاصاً بـ WindoorERP — أوراق الملصقات، وشارة الهوية، والسيرة الذاتية، وتقارير المسح، وقائمة الزجاج الأفقية — حيث ضُبطت الهوامش وتباعد الترويسة عمداً لكل مستند.

شاشة التقارير (الشاشة نفسها تحت الإجراءات وتحت إعداد التقارير) هي حيث يوصَّل المستند المطبوع: اسم قالب QWeb الخاص به (Template Name)، ونوعه (PDF أو HTML أو نص)، وتنسيق الورقة (يظهر لـ PDF فقط؛ وفراغه يعني افتراضي الشركة)، وتعبير اسم التقرير المطبوع الذي يبني اسم ملف التنزيل من السجل، وزر Add to the 'Print' menu (يظهر بالإنجليزية)، ونطاق اختياري يقيّد أي السجلات تعرضه، وإعادة تحميل من المرفقات لإعادة طباعة النسخة المخزنة بدل توليدها من جديد. وزر Qweb Views (بالإنجليزية) بحثٌ بالاسم لا رابط مخزن — ففراغ نتيجته لا يعني غياب القالب.

إعطاء مستند تنسيق ورقه الخاص

  1. 01
    في تقني › إعداد التقارير › تنسيق الورقة، كرّر التنسيق الأقرب لما تحتاج — A4 للمستندات، وتنسيق ملصقات للملصقات.
  2. 02
    عدّل الحجم أو الهوامش، واضبط تباعد الترويسة بقصد: مساوياً للهامش العلوي لترويسة ملاصقة، وأصغر منه لفتح فجوة.
  3. 03
    في تقني › إعداد التقارير › التقارير، افتح التقرير ووجّه تنسيق الورقة فيه إلى سجلك الجديد — فالتقرير بلا تنسيق يتبع تنسيق الشركة الافتراضي.
  4. 04
    اضبط اسم التقرير المطبوع إن كان ينبغي لاسم الملف أن يحمل مرجع السجل.
  5. 05
    اطبع المستند من شاشته الخاصة وافحص الصفحتين الأولى والثانية — فالترويسة والتذييل يتكرران في كل صفحة، وترقيم الصفحات هو حيث تظهر أخطاء الهوامش.

استكشاف الأخطاء

قائمة "تقني" غائبة كلياً — وضع المطوّر مطفأ؛ ولا صلاحية تغني عنه.

مربع كود بايثون غائب في إجراء خادم — حقل الكود يتطلب صلاحية Administrator فوق وضع المطوّر.

"Server action … has one or more warnings, address them first." — حُفظ الإجراء وشريطه الأصفر بلا حل؛ أصلح ما يسميه الشريط ثم شغّل من جديد.

أداة عرض ترفض الحفظ — الرسالة تقتبس القاعدة المخالفة حرفياً (وراثة متداخلة، وسم حقل بلا name، صفحة خارج دفتر، أداة QWeb بلا مفتاح)؛ أصلح الـ XML الذي تشير إليه، وفضّل أداة عرض موروثة على تحرير الأصل أصلاً.

بحث محفوظ يظهر لكل المستخدمين — قائمته "تمت المشاركة مع" تُركت فارغة، وذاك يعني المشاركة مع الجميع؛ أضف المستخدمين المقصودين إلى القائمة، أو احذف الصف.

شاشة قياسية حُررت يدوياً ارتدت في الليل — تحديثُ وحدةٍ أعاد شحن أداة العرض، كما يعد تحذير النموذج نفسه؛ أعد بناء التغيير كأداة عرض موروثة.

تبحث عن "Automated Actions" — تلك الوحدة غير مثبتة في هذا الإصدار؛ وقائمة الأتمتة تضم الإجراءات المجدولة فقط.

أخطاء شائعة

  • تحرير XML أداة عرض قياسية مباشرة لأنه يعمل اليوم — فالتحديث التالي يمحوه؛ ورّث بدلاً من ذلك.
  • وصل إجراء خادم محذَّر بمهمة مجدولة — سيفشل في الثالثة فجراً، لا عند الحفظ.
  • حذف قائمة أب "للترتيب" وبعثرة المستوى الأعلى بأبنائها اليتامى.
  • افتراض أن القائمة بلا مجموعات مرئية للجميع — فالظهور يتبع صلاحيات النموذج.
  • فرض تساوي تباعد الترويسة مع الهامش العلوي في كل تنسيق ورق — فتنسيقات الملصقات والشارة والمسح تعتمد على اختلافهما.
  • معاملة إجراء Webhook كتسليم مؤكد — فهو لا يبلّغ المستخدم بالفشل أبداً.

هل كان هذا المقال مفيداً؟

تدير مصنع نوافذ أو أبواب؟

اطلب عرضاً تجريبياً