السجلات وحلول الأعطال #
هذه الصفحة مخصصة عند حدوث خطأ أو لتتبع ما يقوم به النظام في الخلفية. سنشرح
كيف تقرأ السجل بسرعة، أهم الرسائل التي قد تظهر، وما هي الخطوات التي ننصح بها
لإصلاح المشاكل المتكررة.
الوصول إلى السجل #
- من لوحة التحكم افتح Yaxii Smart Form → Integrations.
- اضغط زر Settings (أو الرابط المكافئ) في بطاقة المزود المتصل.
- في صفحة الإعدادات ستجد قسم Logs يعرض آخر العمليات مع تفاصيلها.
يمكنك مسح السجل عبر زر Clear Logs. سيقوم النظام أيضاً بتسجيل رسالة جديدة تفيد بأن المشرف قام بالمحو.
قراءة الرسائل #
| نوع السطر | ماذا يعني؟ | مثال |
|---|---|---|
| success | عملية تمت بنجاح (اتصال، إرسال، مزامنة). | Successfully processed order #154 مع Ecotrack. |
| error | حدث خطأ في الاتصال أو أثناء إرسال الطلب. | Invalid token or provider not available. |
| warning | معلومة تحتاج انتباه، لكن النظام أكمل العملية. | Commune name adjusted to Alger Centre. |
| info | رسالة عامة مثل بدء أو انتهاء مزامنة. | Logs cleared by admin. |
أخطاء شائعة وحلولها #
| الرسالة | السبب المحتمل | الحل |
|---|---|---|
| Invalid shipping provider | حاولت إرسال طلب لمزود غير متصل. | أعد الاتصال من صفحة Integrations وتأكد أن حالة المزود أصبحت Connected. |
| Orders already assigned | الطلب لديه رقم تتبع محفوظ. | تحقق من الطلب. إذا كانت الشحنة ألغيت حذف الرقم ثم أعد الإرسال. |
| Rate limit exceeded | أرسلت عدد طلبات كبير في نفس الدقيقة. | انتظر دقيقة ثم أعد المحاولة. النظام يعيد المحاولة تلقائياً مرة واحدة. |
| Tracking data not found | الشركة حذفت الشحنة أو الرقم غير صحيح. | أعد إنشاء الشحنة من لوحة المزود أو أعد إرسال الطلب من Yaxii. |
| Premium license required | الرخصة غير مفعلة أو انتهت. | اذهب إلى صفحة الترخيص داخل Yaxii وفعل المفتاح. |
تفعيل وضع التصحيح #
إذا احتجت تفاصيل أكثر، فعّل WP_DEBUG في ووردبريس. سيقوم
النظام بتسجيل بيانات إضافية داخل ملف debug.log مثل الطلبات
الكاملة والردود من API (مع إخفاء التوكنات). لا تنس إعادته إلى False بعد حل المشكلة.
نموذج خطة عمل عند حدوث خطأ #
- اقرأ الرسالة في المودال أو السجل.
- تأكد من صحة بيانات الطلب (الولاية، الهاتف، نوع الخدمة).
- حاول إعادة الاتصال من زر Connect في صفحة Integrations للتأكد أن المفتاح ما زال صالحاً.
- إذا استمر الخطأ، فعّل WP_DEBUG وجرب العملية مرة أخرى.
- أرسل تفاصيل الخطأ للدعم التقني مع رقم الطلب والرسالة كاملة.
