24.1.5. أدوات الملفات

24.1.5.1. تنزيل ملف عبر HTTP(S)

تنزّل عنوان URL إلى نظام الملفات بطلب HTTP(S) من نوع GET أو POST.

المعاملات

المعاملات الأساسية

Label	اﻷسم	النوع	وصف
عنوان URL	URL	[string]	عنوان URL للملف المراد تنزيله.
وجهة الملف	OUTPUT	[string] القيمة الافتراضية: [Save to temporary file]	تحديد وجهة الملف. أحد الخيارات: الحفظ في ملف مؤقت الحفظ في ملف…

المعاملات المتقدمة

Label	اﻷسم	النوع	وصف
الطريقة	METHOD	[enumeration] القيمة الافتراضية: 0	طريقة HTTP المستخدمة في الطلب. الخيارات هي: 0 --- GET 1 --- POST
البيانات اختياري	DATA	[string]	البيانات المراد إضافتها في متن الطلب إذا كان الطلب من نوع POST.

المخرجات

Label	اﻷسم	النوع	وصف
وجهة الملف	OUTPUT	[string]	موقع الملف المنزَّل

شيفرة Python

معرّف الخوارزمية: native:filedownloader

import processing
processing.run("algorithm_id", {parameter_dictionary})

يظهر معرّف الخوارزمية عند تمرير المؤشر فوق الخوارزمية في صندوق أدوات المعالجة. يوفّر قاموس المعاملات أسماء المعاملات (NAME) وقيمها. انظر استخدام خوارزميات المعالجة من وحدة التحكم لمعرفة تفاصيل تشغيل خوارزميات المعالجة من وحدة تحكم Python.

24.1.5.2. طلب HTTP(S) من نوع POST/GET

Added in 3.40

تنفّذ طلب HTTP(S) من نوع POST/GET وتُعيد رمز حالة HTTP وبيانات الرد. إذا حدث خطأ فسيُعاد رمز الخطأ والرسالة. يمكن اختياريًا كتابة النتيجة في ملف على القرص. تُصدر الخوارزمية افتراضيًا تحذيرًا عند حدوث أخطاء، ويمكن اختياريًا ضبطها لتعامل أخطاء HTTP على أنها حالات فشل.

المعاملات

Label	اﻷسم	النوع	وصف
عنوان URL أو مسار الملف	URL	[string]	عنوان URL أو مسار الملف المراد فتحه.
الطريقة	METHOD	[enumeration] القيمة الافتراضية: 0	طريقة HTTP المستخدمة في الطلب. الخيارات هي: 0 --- GET 1 --- POST
بيانات POST اختياري	DATA	[string]	البيانات المراد إضافتها في متن الطلب إذا كان الطلب من نوع POST.
المصادقة اختياري	AUTH_CONFIG	[authconfig] القيمة الافتراضية: بلا مصادقة	إعداد مصادقة لتمريره
اعتبار أخطاء HTTP حالات فشل	FAIL_ON_ERROR	[boolean] القيمة الافتراضية: False	إذا فُعِّل، فستفشل الخوارزمية عند مواجهة خطأ HTTP.
وجهة الملف اختياري	OUTPUT	[string] القيمة الافتراضية: [Skip Output]	يمكن كتابة النتيجة في ملف بدلًا من إعادتها سلسلةً نصية. تحديد وجهة الملف. أحد الخيارات: تخطي المخرجات الحفظ في ملف مؤقت الحفظ في ملف…

المخرجات

Label	اﻷسم	النوع	وصف
وجهة الملف	OUTPUT	[file]	الملف المنزَّل الذي يحتوي على النتيجة المُعادة
حالة HTTP	STATUS_CODE	[string]	حالة HTTP
رمز خطأ الشبكة	ERROR_CODE	[string]	رمز الخطأ عند الفشل (كما في حالة HTTP رقم 404 وغيرها)
رسالة خطأ الشبكة	ERROR_MESSAGE	[string]	سلسلة نصية تحتوي على رسالة الخطأ في حالة الفشل
بيانات النتيجة	RESULT_DATA	[string]	سلسلة نصية تحتوي على بيانات النتيجة في حالة النجاح

شيفرة Python

معرّف الخوارزمية: native:httprequest

import processing
processing.run("algorithm_id", {parameter_dictionary})

يظهر معرّف الخوارزمية عند تمرير المؤشر فوق الخوارزمية في صندوق أدوات المعالجة. يوفّر قاموس المعاملات أسماء المعاملات (NAME) وقيمها. انظر استخدام خوارزميات المعالجة من وحدة التحكم لمعرفة تفاصيل تشغيل خوارزميات المعالجة من وحدة تحكم Python.

24.1.5.3. فتح ملف أو عنوان URL

تفتح الملفات في التطبيق الافتراضي المرتبط بها، أو عناوين URL في متصفح الويب الافتراضي للمستخدم.

المعاملات

Label	اﻷسم	النوع	وصف
عنوان URL أو مسار الملف	URL	[string]	عنوان URL أو مسار الملف المراد فتحه.

المخرجات

لا تُنتج الخوارزمية أي مخرجات.

شيفرة Python

معرّف الخوارزمية: native:openurl

import processing
processing.run("algorithm_id", {parameter_dictionary})

يظهر معرّف الخوارزمية عند تمرير المؤشر فوق الخوارزمية في صندوق أدوات المعالجة. يوفّر قاموس المعاملات أسماء المعاملات (NAME) وقيمها. انظر استخدام خوارزميات المعالجة من وحدة التحكم لمعرفة تفاصيل تشغيل خوارزميات المعالجة من وحدة تحكم Python.