3.1. الأساسيات¶

يصف هذا القسم المفاهيم والمعاملات المشتركة بين الخدمات. بعضها قياسي ومعرَّف في مواصفات OGC، وبعضها الآخر خاص جدًا بـ QGIS Server.

المفاهيم القياسية:

المفهوم	وصف
SERVICE	اسم الخدمة
REQUEST	اسم الطلب

المفاهيم الخاصة بالمورّد:

المفهوم	وصف
MAP	ملف مشروع QGIS
FILE_NAME	اسم الملف الذي يتم تنزيله
الاسم المختصر	تعريف الاسم المختصر

3.1.1. SERVICE¶

يتيح هذا المعامل القياسي تحديد اسم الخدمة المستخدمة في طلب معين، ويجب أن يُكتب بالشكل SERVICE=NAME.

مثال على عنوان URL لخدمة WMS:

http://localhost/qgisserver?
SERVICE=WMS
&...

ملاحظة

غير متاح للخدمات المبنية على REST مثل WFS3 (OGC API Features).

3.1.2. REQUEST¶

يتيح هذا المعامل القياسي تحديد اسم الطلب المراد تنفيذه في خدمة معينة، ويجب أن يُكتب بالشكل REQUEST=RequestName.

مثال على عنوان URL للطلب GetCapabilities:

http://localhost/qgisserver?
REQUEST=GetCapabilities
&...

ملاحظة

غير متاح للخدمات المبنية على REST مثل WFS3 (OGC API Features).

3.1.3. MAP¶

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

مثال على عنوان URL:

http://localhost/qgisserver?
MAP=/tmp/QGIS-Training-Data/exercise_data/qgis-server-tutorial-data/world.qgs
&...

3.1.4. FILE_NAME¶

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

مثال على عنوان URL لحفظ مستند GetCapabilities بصيغة XML:

http://localhost/qgisserver?
SERVICE=WMS
&REQUEST=GetCapabilities
&FILE_NAME=wms_capabilities.xml
&...

ملاحظة

غير متاح للخدمات المبنية على REST مثل WFS3 (OGC API Features).

3.1.5. الاسم المختصر¶

لعدد من العناصر اسم مختصر و عنوان معًا. الاسم المختصر سلسلة نصية تُستخدم في الاتصال بين الآلات، بينما العنوان موجَّه للبشر. على سبيل المثال، قد تحمل مجموعة بيانات العنوان الوصفي “Maximum Atmospheric Temperature” ويُطلب باستخدام الاسم المختصر “ATMAX”. يمكنك ضبط العنوان والاسم المختصر والملخص لكل من:

الطبقات: انقر بزر الفأرة الأيمن على طبقة واختر Properties... ► QGIS Server ► Description.
المجموعات: انقر بزر الفأرة الأيمن على مجموعة واختر Set Group WMS data
المشروع: انتقل إلى Project ► Properties... ► QGIS Server ► Service Capabilities.

../../../_images/set_group_wms_data.png — شكل 3.2 نافذة حوار ضبط بيانات WMS للمجموعة¶

وهكذا يمكن استخدام الاسم المختصر لتعريف هذه العناصر عند التعامل مع QGIS Server، على سبيل المثال مع المعامل القياسي LAYERS:

http://localhost/qgisserver?
SERVICE=WMS
&REQUEST=GetMap
&LAYERS=shortname1,shortname2
&...