سجلات داخل مقال المعرفة: عرض للعمل الحالي أم مثال ثابت؟

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

يتناول هذا الدليل العلاقة بين الشرح والبيانات المدرجة فيه، لا نشر السجلات الداخلية على موقعكم العام. استخدموا سجلات مختلقة عند إعداد المتطلبات أو عرض الميزة على المطور.

اختاروا ما الذي يدخل في الشرح

قد يشرح فريق خدمة افتراضي كيفية مراجعة الطلبات المفتوحة ويضع بجوار التعليمات عرضا لهذه الطلبات. قد يوفر ذلك الانتقال بين الشاشات. أما التدريب فقد يحتاج إلى مثال مستقر يظل مفهوما بعد إغلاق الطلبات الحقيقية.

اختاروا بوضوح بين رابط إلى شاشة العمل، وعرض مضمّن، وصورة مؤرخة. سموا الغرض. لا تقدموا صورة لقائمة الشهر الماضي وكأنها أعمال اليوم، ولا تصفوا قائمة حية بأنها المثال نفسه الذي استخدم في تدريب سابق.

توثق Odoo 19 إمكانية إدراج عرض من تطبيق آخر أو رابط إليه داخل مقال Knowledge. يثبت ذلك إمكانية وصل التعليمات ببيانات التطبيق. لكنه لا يحدد وتيرة تحديث معينة أو نسخة دون اتصال أو لقطة تاريخية لتنفيذكم.

وضحوا معنى العرض عند فتحه

اتفقوا على مجموعة السجلات والتصفية والترتيب وعلاقة العرض بالمستخدم. هل تعني «طلباتي» عمل مؤلف المقال أم عمل القارئ؟ وأي تاريخ وموقع يطبقان؟ لا تتركوا الموظفين يخمنون سبب اختلاف قوائمهم.

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

إذا كان العرض يتيح التحرير، فميزوا هذا الإجراء عن قراءة التعليمات. تعديل سجل عملية تشغيلية، لا مجرد تعديل صياغة المقال. يجب أن يكون أثر الإجراء وطريق العودة مفهومين.

الوصول إلى المقال مختلف عن الوصول إلى بياناته

تقول وثائق Odoo صراحة إن من لا يملك صلاحية العرض المدرج لا يراه داخل Knowledge حتى لو أمكنه قراءة المقال. وتوضح ملاحظة المشاركة عبر الويب أن امتلاك رابط المقال لا يكشف المحتوى المدرج دون صلاحية الوصول إليه.

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

اختبروا الطبقتين بحسابات غير حساسة. افحصوا العرض المضمّن ووجهة رابطه وأي تصدير متاح. نجاح تحميل الصفحة وحده لا يثبت اكتمال الوصول ولا سلامة منع الوصول إلى البيانات.

استعادة النص لا تثبت استعادة الماضي التشغيلي

توثق Odoo استعادة نسخة سابقة من المقال. لكن التعليمات لا تثبت أن العملية تستعيد أيضا سجلات المصدر التي يعرضها المحتوى المدرج. افصلوا هذين الادعاءين.

إذا احتجتم إلى حفظ ما رآه المراجع في وقت محدد، فحددوا لقطة مؤرخة مقصودة مع نطاقها وسياسة الوصول إليها. لا تفترضوا أن تاريخ المقال أرشيف تدقيق للبيانات التشغيلية. وبالمثل، لا تجعلوا فهم مثال تدريبي ثابت يتطلب الوصول إلى سجلات عملاء حقيقية.

اختبروا قارئين وسجلا يتغير

استخدموا طلبا وهميا وقارئين ضمن معايير القبول. امنحوا الأول صلاحية بيانات المصدر المتفق عليها، والثاني قراءة المقال فقط. قارنوا التعليمات والعرض المضمّن ووجهة الرابط. ثم عدلوا الطلب التجريبي وافحصوا التحديث المتفق عليه وحالة تعذر تحميل البيانات.

استعيدوا نسخة نصية أقدم وافحصوا ما يحدث للعرض من دون افتراض رجوع السجلات إلى الماضي. وتأكدوا من بقاء المثال المؤرخ واضحا بصفته مثالا. أحضروا هذه القرارات عند مناقشة تطبيق داخلي. النتيجة المفيدة اتصال مفهوم بين التعليمات والعمل، مع حدود صريحة للحداثة والتاريخ والرؤية.

المصدر

Odoo 19: المعرفة، بالإنجليزية، تمت القراءة في 26 أكتوبر 2026. تدعم الوثائق إدراج العروض وحد الوصول المنفصل واستعادة نسخ المقال. أما قواعد التحديث واللقطات والاختبارات المقترحة فهي إرشادات لتحديد المشروع، لا سلوك منتج تحقق منه هنا بصورة مستقلة.