23.4. مدير السجل

23.4.1. سجل المعالجة

في كل مرة تنفّذ فيها خوارزمية، تُخزَّن معلومات عن العملية في مدير السجل. يُحفظ تاريخ التنفيذ ووقته مع المعاملات المستخدمة، مما يسهّل تتبّع كل العمل المُنجز باستخدام إطار المعالجة وضبطه وإعادة إنتاجه.

../../../_images/history1.png

شكل 23.17 التاريخ

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

انقر بزر الفأرة الأيمن على صف لتتمكن من:

  • Copy as Python Command: يتيح نسخ أمر PyQGIS المكافئ لما شُغّل من نافذة الحوار بسهولة. وهو مطابق للشيفرة المعروضة أسفل قائمة الأوامر.

  • Copy as qgis_process Command: يتيح توليد أمر qgis_process بسهولة، بما في ذلك إعدادات بيئته مثل وحدات المسافة ووحدات المساحة والإهليلج، وأي قيم معاملات معقّدة مثل مخرجات GeoPackage ذات طبقات محددة

  • Copy as JSON: تُنسخ جميع إعدادات الأمر بتنسيق JSON جاهزة للاستخدام في qgis_process. وهذه طريقة مريحة لمعرفة التنسيق المتوقع للأوامر، حتى للمعاملات المعقّدة (مثل معاملات استيفاء TIN). يمكنك حفظها بسهولة ثم استعادتها لاحقًا بلصق القيم في نافذة حوار خوارزمية.

  • Create Test... باستخدام الخوارزمية والمعاملات المعنية، باتباع التعليمات الواردة في Processing README file.

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

توفّر نافذة الحوار History أيضًا طريقة مريحة للمساهمة في تعزيز بنية الاختبار الخاصة بخوارزميات المعالجة وسكربتاتها في QGIS.

23.4.2. سجل رسائل المعالجة

لا تحتوي نافذة حوار السجل إلا على استدعاءات التنفيذ، دون المعلومات التي تنتجها الخوارزمية أثناء تنفيذها. تُكتب تلك المعلومات في سجل QGIS (View ► Panels ► Log Messages Panel).

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

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