Ahmed Qasid
121
عند حدوث مشكلة في تطبيق نقطة البيع (Nama POS)، أحتاج إلى مراجعة ملفات اللوج لتشخيص المشكلة.
ملفات اللوج الخاصة بنقطة البيع يتم حفظها في مجلد تشغيل التطبيق نفسه (working directory)، أي نفس المجلد الذي يحتوي على الملف التنفيذي pos-launcher.exe. لا يتم حفظها في مسار مطلق ثابت مثل C:\Logs أو ما شابه، بل بجوار التطبيق مباشرة.
الملف الأساسي الذي يحتوي على معظم رسائل التطبيق هو:
namapos.log
بجانب الملف الرئيسي، يقوم النظام بإنشاء عدة ملفات لوج متخصصة، كل منها يخص نوعًا معينًا من الرسائل، وهي:
| اسم الملف | محتواه |
|---|---|
namapos.log |
اللوج العام لنقطة البيع (الأخطاء والمعلومات الرئيسية) |
performance.log |
قياسات الأداء |
cost.log |
عمليات حساب التكلفة |
other.log |
رسائل متفرقة لا تنتمي للفئات السابقة |
كل ملف من الملفات السابقة محدود بحجم 100 ميجابايت كحد أقصى. عندما يصل الملف لهذا الحجم، يقوم النظام تلقائيًا بـ:
namapos.1.log.gz
namapos.2.log.gz
...
أي إذا أردت مراجعة لوج قديم نسبيًا فابحث عن الملفات بصيغة *.log.gz في نفس مجلد التطبيق.
namapos.log وباقي الملفات في نفس المجلد.أو يمكنك مباشرة فتح المجلد الذي تم تنصيب نقطة البيع فيه (المجلد الذي يحتوي على pos-launcher.exe).
run-and-wait.bat لرؤية الأخطاء غير المسجَّلةفي بعض الحالات النادرة قد يحدث استثناء (Exception) في وقت مبكر جدًا من بدء تشغيل التطبيق، أو في موضع لم يتم فيه التقاط الخطأ وتسجيله في ملفات اللوج بشكل صحيح. في هذه الحالة لن تجد أثرًا للمشكلة في namapos.log.
لتشخيص هذه الحالات يوجد ملف باتش باسم:
run-and-wait.bat
موجود في نفس مجلد تنصيب نقطة البيع. عند تشغيل نقطة البيع عن طريق هذا الملف بدلًا من الاختصار العادي، يقوم بـ:
لذلك إذا واجهت مشكلة لا تظهر في ملفات اللوج، شغّل run-and-wait.bat وأعد إنتاج المشكلة، ثم انسخ محتوى نافذة الـ Console وأرسله للدعم الفني.
عند التواصل مع الدعم الفني للإبلاغ عن مشكلة، يُفضّل إرسال:
namapos.log (الحالي).namapos.1.log.gz إن وُجد (لاحتمال أن المشكلة حدثت قبل دوران الملف).هذا يساعد فريق الدعم على تشخيص المشكلة بشكل أسرع وأدق.