تخطَّ إلى المحتوى

خدمات الطرف الثالث وسجلات النظام

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

11 دقائق قراءة وتطبيق4 أهداف

في هذا الدرس ستتعلم

  • تضيف خدمة خارجية بنوعها ومزودها ومفاتيحها
  • تفرّق بين وضع Sandbox ووضع Live وتنتقل بينهما بأمان
  • تعرف من غيّر ماذا ومتى من سجلات المراجعة
  • تجد سبب فشل استيراد ملف Excel سطراً سطراً

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

تظهر الأنواع كتبويبات بأسمائها الإنجليزية:

النوع مثال مزود لماذا؟
Payment Gateway Stripe الدفع الإلكتروني
Social Login Google الدخول بحساب خارجي
Mail Server خادم SMTP إرسال البريد
Maps & Location Google Maps الخرائط والعناوين
Storage تخزين سحابي الصور والملفات
Push Notifications Firebase إشعارات الجوال

ويظهر نوع SMS Gateway لبوابة الرسائل النصية. لربط جوال أندرويد يرسل الرسائل راجع بوابة الرسائل.

  1. من شريط مساحات العمل اختر النظام، ثم طرف ثالث. تفتح تكاملات الطرف الثالث: «إدارة SMS والمدفوعات وتسجيلات الدخول الاجتماعية والخدمات الخارجية الأخرى.»

  2. اضغط إضافة تكامل جديد (أو إعداد أول بوابة في تبويب فارغ).

  3. املأ:

    • نوع الخدمة: من الجدول.
    • اسم المزود: «مثال: Twilio، Stripe، Firebase».
    • وضع التشغيل:
      • Sandbox: تجريبي. لا مال حقيقي ولا رسائل حقيقية. ابدأ به دائماً.
      • Live: فعلي. استخدمه بعد نجاح التجربة.
    • بيانات اعتماد API والمعاملات: اضغط إضافة حقل لكل مفتاح. في المفتاح (مثال: API_KEY) اكتب اسم المفتاح كما يطلبه المزود حرفياً، وفي القيمة القيمة من لوحة المزود.
  4. احفظ. تظهر الخدمة كبطاقة في تبويب نوعها، مع تبديل الحالة لتفعيلها أو إيقافها، وإعداد لتعديلها.

نافذة «إضافة تكامل جديد» فوق صفحة «تكاملات الطرف الثالث»: «نوع الخدمة» = Payment Gateway، «اسم المزود» = Stripe، «وضع التشغيل» = Sandbox، وقسم «بيانات اعتماد API والمعاملات» فيه حقلان مفتاح وقيمة

في مساحة النظام، مجموعة النظام: سجلات المراجعة، سجلات الأخطاء، سجلات الاستيراد.

سجلات المراجعة: من غيّر ماذا؟

Section titled “سجلات المراجعة: من غيّر ماذا؟”
  1. اضغط سجلات المراجعة. تفتح سجل العمليات (Audit Logs): «تتبع جميع تغييرات النظام وإجراءات المستخدمين».
  2. الجدول: المستخدم (أو النظام للتغييرات الآلية)، الإجراء، الجدول (نوع السجل، مثل المنتجات)، التاريخ.
  3. اضغط عرض التفاصيل. تفتح تفاصيل العملية: القيم القديمة والقيم الجديدة جنباً إلى جنب.
  4. للتصفية: تصفية متقدمة بـ أدخل اسم المستخدم، أدخل اسم الجدول، والنوع، ثم تنفيذ.

مثال: سعر منتج تغيّر من 1,500 إلى 150. صفِّ بجدول المنتجات وتاريخ اليوم، وافتح التفاصيل: ترى من غيّره ومتى، والقيمتين.

نافذة «تفاصيل العملية» فوق صفحة «سجل العمليات (Audit Logs)»: كتلة «القيم القديمة» وتحتها «القيم الجديدة» لعنصر في عرض خاطف، والسعر 1800 في القديمة و180 في الجديدة

سجل الأخطاء (Error Logs): «مراقبة استثناءات النظام وأخطاء التطبيق». الجدول: الرسالة، المسار، التاريخ. عرض تتبع الخطأ يفتح تفاصيل الخطأ مع الطريقة وتتبع الخطأ (Stack Trace).

هذه الصفحة لفريق الدعم أساساً. حين تبلّغ عن مشكلة، أرسل وقتها التقريبي ونص الرسالة؛ هذا يختصر وقت الحل كثيراً. إن كانت فارغة ترى «عمل رائع! لم يتم العثور على أخطاء في النظام.».

حين تستورد منتجات أو عملاء من Excel، تُسجَّل كل عملية هنا.

  1. اضغط سجلات الاستيراد: «عرض ومراقبة سجل عمليات استيراد البيانات».
  2. لكل عملية: اسم الملف، نوع البيانات، الحالة، التقدم، والإحصائيات (ناجح وفاشل).
  3. إن كان هناك فاشل، اضغط عرض الأخطاء. تفتح تفاصيل الأخطاء: أسطر فاشلة بأعمدة رقم السطر، رسالة الخطأ، والبيانات الخام.
  4. صحّح هذه الأسطر في ملفك، واستورد الأسطر الفاشلة فقط مرة ثانية.
  • إن لم تعمل خدمة بعد الحفظ، فراجع وضع التشغيل (مفاتيح Live لا تعمل في Sandbox والعكس) وأن البطاقة مفعّلة من تبديل الحالة.
  • إن لم تجد من غيّر شيئاً، فقد يكون التغيير آلياً؛ ابحث عن النظام في عمود المستخدم.
  • إن فشل استيراد كله، فغالباً أعمدة الملف لا تطابق النموذج. حمّل النموذج من شاشة الاستيراد وانسخ بياناتك فيه.

🛠️ جرّبها بنفسك

  1. عدّل سعر منتج تجريبي من صفحة المنتجات واحفظ.
  2. افتح سجلات المراجعة وصفِّ باسمك.
  3. اضغط عرض التفاصيل على آخر سطر.

عند النجاح: ترى السعر القديم في القيم القديمة والجديد في القيم الجديدة، باسمك ووقت التعديل.

  • كل خدمة خارجية = نوع + مزود + وضع (Sandbox ثم Live) + مفاتيح بأسمائها الدقيقة.
  • سجلات المراجعة تجيب «من غيّر ماذا ومتى» بالقيم القديمة والجديدة.
  • سجلات الاستيراد تعطيك رقم كل سطر فاشل وسببه.

اختبر فهمكأضفت مفاتيح بوابة دفع لأول مرة. أي وضع تبدأ به؟

اختبر فهمكاستورد موظف 500 منتج، فشل منها 12. كيف تعرف لماذا؟

يُحفظ تقدّمك في هذا المتصفح.
هل ساعدتك هذه الصفحة؟