5.4. الدرس: الإجراءات

بعد أن رأيت إجراءً افتراضيًا في الدرس السابق، حان الوقت لتعريف إجراءاتك الخاصة.

الإجراء (action) هو شيء يحدث عند النقر على معلم. ويمكن أن يضيف كثيرًا من الوظائف الإضافية إلى خريطتك، كأن يتيح لك استرجاع معلومات إضافية عن كائن ما مثلًا. إن تعيين الإجراءات قد يضيف بُعدًا جديدًا كليًا إلى خريطتك!

هدف هذا الدرس: تعلّم كيفية إضافة إجراءات مخصصة.

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

5.4.1. ★☆☆ تابع معنا: إضافة حقل للصور

لا تملك الطبقة school_property بعدُ وسيلة لربط صورة بعقار. سننشئ أولًا حقلًا لهذا الغرض.

  1. افتح نافذة الحوار Layer Properties.

  2. انقر على التبويب Fields.

  3. بدّل وضع التحرير:

    ../../../_images/toggle_editing_mode.png

  4. أضف عمودًا جديدًا:

    ../../../_images/add_new_column.png

  5. أدخل القيم أدناه:

    ../../../_images/column_settings.png

  6. بعد إنشاء الحقل، انتقل إلى التبويب Attributes Form وحدّد الحقل image.

  7. اضبط Widget Type على Attachment:

    ../../../_images/select_file_name.png

  8. انقر على OK في نافذة الحوار Layer Properties.

  9. استخدم الأداة identify Identify Features للنقر على أحد المعالم الثلاثة في الطبقة school_property.

    بما أنك لا تزال في وضع التحرير، ينبغي أن تكون نافذة الحوار نشطة وأن تبدو هكذا:

    ../../../_images/school_property_no_image.png

  10. انقر على زر الاستعراض (الزر ... المجاور للحقل image).

  11. حدّد مسار صورتك. توجد الصور في exercise_data/school_property_photos/ وتحمل أسماء المعالم نفسها التي ينبغي ربطها بها.

  12. انقر على OK.

  13. اربط جميع الصور بالمعالم الصحيحة باستخدام هذه الطريقة.

  14. احفظ تعديلاتك واخرج من وضع التحرير.

5.4.2. ★☆☆ تابع معنا: إنشاء إجراء

  1. افتح التبويب Actions للطبقة school_property، وانقر على الزر symbologyAdd Add a new action.

    ../../../_images/layer_actions.png

  2. في نافذة الحوار Add New Action، أدخل الكلمتين Show Image في الحقل Description:

    ../../../_images/show_image_action.png

    يختلف ما ستفعله بعد ذلك بحسب نظام التشغيل لديك، لذا اختر المسار المناسب لتتّبعه:

    • Windows

      انقر على القائمة المنسدلة Type واختر Open.

    • Ubuntu Linux

      تحت Action، اكتب eog لاستخدام Gnome Image Viewer، أو اكتب display لاستخدام ImageMagick. تذكّر أن تضع مسافة بعد الأمر!

    • macOS

      1. انقر على القائمة المنسدلة Type واختر Mac.

      2. تحت Action، اكتب open. تذكّر أن تضع مسافة بعد الأمر!

    يمكنك الآن متابعة كتابة الأمر.

    تريد فتح الصورة، وQGIS يعرف مكانها. كل ما عليه فعله هو إخبار Action بمكان الصورة.

  3. اختر image من القائمة:

    ../../../_images/select_image.png

  4. انقر على الزر Insert field. سيضيف QGIS العبارة [% "image" %] في الحقل Action Text.

  5. انقر على الزر OK لإغلاق نافذة الحوار Add New Action

  6. انقر على OK لإغلاق نافذة الحوار Layer Properties

حان الوقت الآن لاختبار الإجراء الجديد:

  1. انقر على الطبقة school_property في لوحة Layers بحيث تصبح مظلّلة.

  2. اعثر على الزر actionRun Run feature action (في Attributes Toolbar).

  3. انقر على السهم المتجه إلى الأسفل على يمين هذا الزر. يوجد حتى الآن إجراء واحد فقط معرّف لهذه الطبقة، وهو الإجراء الذي أنشأته للتو.

    ../../../_images/run_feature_action_select.png

  4. انقر على الزر نفسه لتفعيل الأداة.

  5. باستخدام هذه الأداة، انقر على أيٍّ من عقارات المدرسة الثلاثة.

    ينبغي أن تُفتح صورة ذلك العقار.

5.4.3. ★★☆ تابع معنا: البحث في الإنترنت

لنفترض أننا ننظر إلى الخريطة ونريد معرفة المزيد عن المنطقة التي تقع فيها مزرعة ما. افترض أنك لا تعرف شيئًا عن تلك المنطقة وتريد العثور على معلومات عامة عنها. أول ما سيخطر ببالك، بما أنك تستخدم حاسوبًا الآن، هو على الأرجح البحث عن اسم المنطقة في Google. لذا لنطلب من QGIS أن يفعل ذلك تلقائيًا نيابةً عنا!

  1. افتح جدول البيانات الوصفية للطبقة landuse.

    سنستخدم الحقل name لكل منطقة من مناطق استخدام الأراضي للبحث في Google.

  2. أغلق جدول البيانات الوصفية.

  3. ارجع إلى Actions في Layer Properties.

  4. انقر على الزر Create Default Actions لإضافة عدد من الإجراءات المعرّفة مسبقًا.

  5. احذف جميع الإجراءات باستثناء الإجراء Open URL ذي الاسم المختصر Search Web باستخدام الزر symbologyRemove Remove the selected action في الأسفل.

  6. انقر نقرًا مزدوجًا على الإجراء المتبقي لتحريره

  7. غيّر Description إلى Google Search، واحذف محتوى الحقل Short Name.

  8. تأكد من أن Canvas من بين Action scopes المحددة.

    يختلف ما ستفعله بعد ذلك بحسب نظام التشغيل لديك، لذا اختر المسار المناسب لتتّبعه:

    • Windows

      تحت Type، اختر Open. سيطلب هذا من Windows فتح عنوان إنترنت في متصفحك الافتراضي، مثل Internet Explorer.

    • Ubuntu Linux

      تحت Action، اكتب xdg-open. سيطلب هذا من Ubuntu فتح عنوان إنترنت في متصفحك الافتراضي، مثل Chrome أو Firefox.

    • macOS

      تحت Action، اكتب open. سيطلب هذا من macOS فتح عنوان إنترنت في متصفحك الافتراضي، مثل Safari.

    يمكنك الآن متابعة كتابة الأمر

    أيًّا كان الأمر الذي استخدمته أعلاه، عليك أن تخبره بعنوان الإنترنت الذي سيفتحه بعد ذلك. تريد منه زيارة Google، والبحث عن عبارة تلقائيًا.

    عادةً عندما تستخدم Google، تُدخل عبارة البحث في شريط بحث Google. لكنك تريد في هذه الحالة أن يفعل حاسوبك ذلك نيابةً عنك. والطريقة التي تطلب بها من Google البحث عن شيء ما (إن لم تُرد استخدام شريط البحث مباشرةً) هي أن تعطي متصفح الإنترنت العنوان https://www.google.com/search?q=SEARCH_PHRASE، حيث SEARCH_PHRASE` هي ما تريد البحث عنه. وبما أننا لا نعرف بعدُ العبارة التي سنبحث عنها، فسنُدخل الجزء الأول فقط (من دون عبارة البحث).

  9. في الحقل Action، اكتب https://www.google.com/search?q=. تذكّر أن تضيف مسافة بعد أمرك الأوّلي قبل كتابة هذا!

    تريد الآن من QGIS أن يطلب من المتصفح أن يطلب من Google البحث عن قيمة name لأي معلم قد تنقر عليه.

  10. اختر الحقل name.

  11. انقر على الزر Insert:

    ../../../_images/google_search_action.png

    معنى هذا أن QGIS سيفتح المتصفح ويوجّهه إلى العنوان https://www.google.com/search?q=[% "name" %]. تطلب [% "name" %] من QGIS استخدام محتوى الحقل name بوصفه العبارة المراد البحث عنها.

    فإذا كانت منطقة استخدام الأراضي التي تنقر عليها مثلًا تحمل الاسم Marloth Nature Reserve، فسيوجّه QGIS المتصفح إلى https://www.google.com/search?q=Marloth%20Nature%20Reserve، مما يجعل متصفحك يزور Google، الذي سيبحث بدوره عن "Marloth Nature Reserve".

  12. إن لم تكن قد فعلت ذلك بعد، فاضبط كل شيء كما شُرح أعلاه.

  13. انقر على الزر OK لإغلاق نافذة الحوار Add New Action

  14. انقر على OK لإغلاق نافذة الحوار Layer Properties

والآن لنختبر الإجراء الجديد.

  1. مع تفعيل الطبقة landuse في لوحة Layers، انقر على السهم المتجه إلى الأسفل على يمين الزر actionRun Run feature action، واختر الإجراء الوحيد (Google Search) المعرّف لهذه الطبقة.

  2. انقر على أي منطقة استخدام أراضٍ تراها على الخريطة. سيُفتح متصفحك الآن، وسيبدأ بحثًا في Google عن المكان المسجّل في قيمة name لتلك المنطقة.

ملاحظة

إن لم يعمل الإجراء، فتحقّق من أن كل شيء أُدخل بشكل صحيح؛ فالأخطاء الإملائية شائعة في هذا النوع من العمل!

5.4.4. ★★★ تابع معنا: فتح صفحة ويب مباشرةً في QGIS

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

غير أن QGIS مبني على مكتبة Qt القوية والمرنة للغاية. كما يمكن أن تكون إجراءات QGIS أوامر Python اعتباطية ومُرمَّزة (أي تستخدم معلومات متغيرة بحسب محتوى سمة حقل ما)!

سترى الآن كيفية استخدام إجراء Python لعرض صفحة ويب. الفكرة العامة هي نفسها فتح موقع في متصفح خارجي، لكنها لا تتطلب وجود متصفح على نظام المستخدم لأنها تستخدم الصنف QWebView من Qt (وهو عنصر واجهة html مبني على webkit) لعرض المحتوى في نافذة منبثقة.

لنستخدم Wikipedia هذه المرة. سيبدو عنوان URL الذي تطلبه هكذا:

https://wikipedia.org/wiki/SEARCH_PHRASE

لإنشاء إجراء الطبقة:

  1. افتح نافذة الحوار Layer Properties وانتقل إلى التبويب Actions.

  2. أنشئ إجراءً جديدًا بالخصائص التالية:

    • Type: Python

    • Description: Wikipedia

    • Scope: Feature، Canvas

    • Action Text:

      from qgis.PyQt.QtCore import QUrl
from qgis.PyQt.QtWebKitWidgets import QWebView

myWV = QWebView(None)
myWV.load(QUrl('https://wikipedia.org/wiki/[%name%]'))
myWV.show()
    ../../../_images/python_action_example.png

    هناك أمران يحدثان هنا:

    • ستُستبدل [%name%] بقيمة السمة الفعلية عند استدعاء الإجراء (كما في السابق).

    • تُنشئ الشيفرة ببساطة نسخة جديدة من QWebView، وتضبط عنوان URL الخاص بها، ثم تستدعي show() عليها لجعلها ظاهرة بوصفها نافذة على سطح مكتب المستخدم.

    يمكنك أيضًا استخدام هذا الأسلوب لعرض صورة دون اشتراط وجود عارض صور معيّن على نظام المستخدمين.

  3. حاول استخدام الطرق الموضّحة أعلاه لتحميل صفحة من Wikipedia باستخدام إجراء Wikipedia الذي أنشأته للتو.

5.4.5. الخلاصة

تتيح لك الإجراءات منح خريطتك وظائف إضافية مفيدة للمستخدم النهائي الذي يعرض الخريطة نفسها في QGIS. ونظرًا لأن العمليات المستدعاة يمكن أن تكون أوامر shell لأي نظام تشغيل، إضافةً إلى Python، فلا حدود للوظائف التي يمكنك دمجها!

5.4.6. ما التالي؟

بعد أن أجريت جميع أنواع إنشاء البيانات المتجهية، ستتعلّم كيفية تحليل البيانات لحل المسائل. وهذا هو موضوع الوحدة التالية.