تجاوز إلى المحتوى الرئيسي
الإصدار: 1.x

السجلات

تمتلك نقطة البيع واجهتي سجلّات: شاشة السجلات داخل التطبيق (داخل تطبيق نقطة البيع) وصفحة السجلات في WP Admin (داخل WordPress). معًا تمنحانك صورة كاملة عن نشاط نقطة البيع لأغراض التصحيح والتدقيق.

سجلات تطبيق نقطة البيع​

الوصول إلى السجلات​

افتح شاشة السجلات من لوحة الملاحة اليسرى (رمز نبض القلب).

نظرة عامة على الواجهة​

البحث والتصفية​

  • بحث السجلات - العثور على إدخالات سجل محددة حسب محتوى الرسالة
  • تصفية مستوى السجل - التصفية حسب مستوى السجل (info، warn، error)
  • إعدادات العرض - تكوين الأعمدة المرئية

جدول السجلات​

يُظهر كل إدخال سجل ما يلي:

العمودالوصف
الوقتمتى وقع الحدث
المستوىالخطورة: info (رمادي)، warn (برتقالي)، error (أحمر)
الرسالةوصف للحدث يمكن قراءته من قبل الإنسان
السياقJSON قابل للتوسيع مع تفاصيل إضافية
الرمزرمز الخطأ (يرتبط بالوثائق)

مستويات السجل​

Info (رمادي)​

العمليات العادية والأحداث الناجحة:

  • "تم جلب جميع معرّفات المنتجات"
  • "تمت مزامنة العملاء الجدد"
  • "تم جلب جميع معرّفات الضرائب"

Warning (برتقالي)​

مشكلات غير حرجة قد تحتاج إلى الانتباه:

  • "تعذّر تحديث الجلسة"
  • "محاولة إعادة للمزامنة"

Error (أحمر)​

مشكلات تحتاج إلى معالجة:

  • "عذرًا، لا يمكنك سرد الموارد" (مشكلة في الإذن)
  • "فشل طلب API"
  • "خطأ في مزامنة قاعدة البيانات"

Audit (أزرق)​

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

تتضمّن إدخالات التدقيق ما يلي:

  • نوع الكيان - المورد الذي تم تعديله (مثل الطلب، المنتج، العميل)
  • الإجراء - نوع التغيير (إنشاء، تحديث، حذف)
  • الحالة قبل - القيم السابقة قبل التغيير
  • الحالة بعد - القيم الجديدة بعد التغيير

بيانات السياق​

انقر على سهم التوسع في أي إدخال سجل لرؤية سياق JSON التفصيلي:

{
  "total": "6",
  "execution_time": "54.79 ms",
  "server_load": "[10.51, 10.42, 9.98]"
}

تشمل هذه البيانات:

  • أعداد العناصر - عدد السجلات المتأثرة
  • وقت التنفيذ - المدة التي استغرقتها العملية
  • حمل الخادم - مقاييس أداء الخادم
  • تفاصيل الطلب/الاستجابة - لاستكشاف أخطاء API

رموز الخطأ​

تتضمّن العديد من إدخالات السجل رمز خطأ (مثل API02004، DB01001). ترتبط هذه الرموز مباشرةً بوثائق رموز الأخطاء، التي تقدّم:

  • شرحًا مفصّلًا للخطأ
  • الأسباب الشائعة
  • خطوات استكشاف الأخطاء

إدخالات السجل الشائعة​

عمليات المزامنة​

[info] Fetched all IDs for products    {...} 3 items
[info] Synced new customers            {...} 1 item
[info] Fetched all IDs for taxes       {...} 3 items

تشير هذه إلى نشاط مزامنة عادي. يُظهر السياق عدد العناصر التي تمت مزامنتها.

أخطاء الأذونات​

[error] Sorry, you cannot list resources    {...} API02004

يعني هذا عادةً أن المستخدم لا يملك إذن الوصول إلى مورد. تحقّق من أدوار المستخدمين في WP Admin > POS > Settings > Access.

مشكلات الجلسة​

[warn] Unable to refresh session    {...} API02007

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

صفحة السجلات في WP Admin​

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

الوصول إلى صفحة السجلات في WP Admin​

انتقل إلى WP Admin > POS > Settings، ثم اختر علامة التبويب Tools وانقر Logs.

شارة غير المقروء​

يعرض عنصر قائمة السجلات شارة تشير إلى إدخالات السجل غير المقروءة:

  • شارة حمراء - توجد إدخالات غير مقروءة بمستوى خطأ
  • شارة كهرمانية - توجد إدخالات غير مقروءة بمستوى تحذير (لكن دون أخطاء)

تؤدي زيارة صفحة السجلات إلى إعادة تعيين أعداد غير المقروء. تُتتبّع الأعداد لكل مستخدم، فيرى كل مسؤول حالته الخاصة من غير المقروء.

تصفية الإدخالات​

استخدم مرشّح المستوى لتضييق إدخالات السجل:

  • All - عرض جميع إدخالات السجل
  • Errors - عرض الإدخالات بمستوى خطأ فقط
  • Warnings - عرض الإدخالات بمستوى تحذير فقط

الإدخالات القابلة للتوسيع​

تُقتطع رسائل السجل الطويلة عند نحو 100 حرف. انقر على إدخال لتوسيعه ورؤية الرسالة الكاملة مع أي بيانات سياق إضافية.

ترقيم الصفحات​

تُرقّم إدخالات السجل على جانب الخادم. استخدم عناصر التحكم في ترقيم الصفحات للتنقّل بين الإدخالات الأقدم.

شريط الأخطاء الفادحة​

إذا كانت لدى الخادم ملفات fatal-errors-*.log، تعرض صفحة السجلات شريط تحذير في الأعلى. يرتبط هذا الشريط بـ WooCommerce > Status > Logs حيث يمكنك عرض سجلات الأخطاء الفادحة الكاملة. الأخطاء الفادحة عادةً ما تكون أعطالًا على مستوى PHP تمنع واجهة نقطة البيع البرمجية من الاستجابة.

استخدام السجلات للدعم​

عند طلب الدعم:

  1. إعادة إنتاج المشكلة - نفّذ الإجراء الذي يسبّب المشكلة
  2. تحقّق من السجلات - ابحث عن الأخطاء (الحمراء) أو التحذيرات (البرتقالية)
  3. وسّع السياق - احصل على تفاصيل JSON كاملة
  4. دوّن رمز الخطأ - ضمّنه في طلب الدعم الخاص بك
  5. انسخ الإدخالات ذات الصلة - شارك رسائل السجل مع السياق

مراقبة الأداء​

تشمل السجلات وقت التنفيذ ومقاييس حمل الخادم. إذا لاحظت:

  • أوقات تنفيذ عالية - قد يكون الخادم محمّلًا أكثر من اللازم أو بطيئًا
  • قيم حمل خادم عالية - فكّر في تحسين الخادم
  • انقطاعات متكررة - تحقّق من الاتصال بالشبكة
رموز الأخطاءشروحات مفصّلة للأخطاء
استكشاف الأخطاءمشكلات وحلول شائعة
الدعمالحصول على المساعدة