امتداد:بيانات خارجية

الدليل المرجعي لامتدادات ميدياويكي

External Data حالة الإصدار مستقر
تنفيذ	دوال المحلل اللغوي , صفحة خاصة
بيان	يسمح باستخدام القيم المجلوبة من مصادر مختلفة وعرضها: معرفات مواقع موحدة خارجية وخدمات SOAP أو صفحات ويكي محلية أو ملفات محلية (في صيغة CSV أو JSON أو XML أو أي صيغة أخرى) وكذا جداول قواعد البيانات وخوادم LDAP ونواتج البرامج المحلية.
المؤلف/المؤلفون	Yaron Koren, Alexander Mashin وآخرين
آخر إصدار	3.3 (نوفمبر 2023)
سياسة التوافق	النسخة الرئيسية تحافظ على التوافق مع الإصدارات السابقة.
MediaWiki	1.37+
تغييرات قاعدة البيانات	نعم
Composer	mediawiki/external-data
جداول	ed_url_cache
ترخيص	رخصة جنو العمومية 2.0 أو ما بعدها
التنزيل	طالع التنزيل والتنصيب
مثال	صفحة تحتوي على معلومات مجلوبة من ملف سي إس في خارجي
المتغيرات $wgSources $wgConnectors $wgAllowGetters $wgIntegratedConnectors $wgVerbose $wgParsers
الروابط المستخدمة LoadExtensionSchemaUpdates ParserFirstCallInit ScribuntoExternalLibraries SoftwareInfo
الروابط المقدمة ExternalDataBeforeWebCall
المسائل	المهام المفتوحة · الإبلاغ عن عطل تقني

يسمح امتداد External Data لصفحات ميدياويكي بجلب البيانات المنظمة وترشيحها وتنسيقها من مصدر واحد أو أكثر من مصدر واحد. يجوز أن تشتمل هذه المصادر معرفات مواقع موحدة خارجية وخدمات SOAP وصفحات ويكي معتادة وملفات مرفوعة وملفات على الخادم المحلي وقواعد بيانات ومجلدات LDAP ونواتج البرامج المحلية.

يحدد هذا الامتداد ما يلي من parser functions :

• دوال جلب البيانات والتعامل معها، التي تضبط متغيرات محلية ومن ثم عرضها أو تخزينها:
  • #external_value - تعرض قيمة أي متغير من هذا النوع.
  • #for_external_table - يجول في كافة القيم المجلوبة لمجموعة من المتغيرات ويعرض نفس نص «الحاوية» لكل واحد منها.
  • #display_external_table - يجول في كافة القيم المجلوبة لمجموعة من المتغيرات ويعرض كل «صف» مستخدمًا قالب.
  • #format_external_table - متاح فقط لو كان Cargo مُنَصّبًا. يتولى تعديل صيغة البيانات الخارجية المجلوبة بذات صيغة استفسارات ‎#‎cargo_‎query.
  • #store_external_table - يجول في كافة قيم جدول ما وتخزينها في صفة بيانات دِلَالية مستخدمًا امتداد Semantic MediaWiki عن طريق محاكاة استدعاء لدالة ‎#subobject التي يستخدمها سيمانتك ميدياويكي لكل صف.
• في وضع الإصدارات السابقة، يتولى الامتداد أيضًا تحديد دوال جلب البيانات التي تضبط متغيرات محلية متاحة مع نطاق صفحة الويكي التي يمكن عرضها لاحقًا باستخدام الدوال سالفة الذكر:
  • #get_external_data - يجلب بيانات من مصادر متعددة وبالتالي يستبدل أي من دوال المعرب اللغوي تالية الذكر ويوكلها إلى متغيرات يمكن الوصول إليها على الصفحة.
  • #get_web_data - يجلب بيانات CSV أو GFF أو JSON أو YAML أو XML أو XML أو ini أو بيانات حرة الصيغة من معرف موارد موحد ويخصصها إلى متغيرات يمكن الوصول إليها على الصفحة.
  • #get_soap_data - يجلب بيانات من معرف موارد موحد مستخدمًا بروتوكول البروتوكول للوصول البسيط إلى الأجسام (SOAP).
  • #get_file_data - يجلب بيانات من ملف موجود على الخادم المحلي، مستخدمًا ذات الصيغ المستخدمة في ‎#get_web_data.
  • #get_db_data - يجلب بيانات من قاعدة بيانات.
  • #get_ldap_data - يجلب بيانات من خادم LDAP.
  • #get_program_data - يجلب بيانات ردها برنامج يعمل على ناحية الخادم.
  • #get_inline_data - يتولى الإعراب البرمجي للبيانات الممررة له بذات الصيغ المستخدمة في ‎#get_web_data.
  • and also #clear_external_data يمحو المجموعة الحالية من البيانات المجلوبة أو بعض المتغيرات فقط.

كما أنه يحدد دالة Lua mw.ext.externalData.getExternalData التي تجلب البيانات وتردها في صفة جدول Lua.

في وضع الإصدارات السابقة، تحدد أيضًا دوال Lua الإضافية التالية (يوجد تشابه لكل واحدة بين دوال المحلل اللغوي التي تجلب البيانات ودوال Lua كما هو واضح من أسمائها):

• mw.ext.externalData.getWebData
• mw.ext.externalData.getFileData
• mw.ext.externalData.getDbData
• mw.ext.externalData.getSoapData
• mw.ext.externalData.getLdapData
• mw.ext.externalData.getProgramData
• mw.ext.externalData.getInlineData

في وضع محاكاة الوسوم، يمكن لإداري موقع الويكي تحديد وسوم محلل لغوي إضافية.

يتطلب هذا الإصدار من امتداد البيانات الخارجية إصدار ميدياويكي 1.37 وما بعده.

تنقل بين الصفحات المبينة في شريط الإبحار في أعلى الصفحة كي تتعرف على المزيد عن External Data وكيفية عمله وكيفية استخدامه وكيفية تثبيته.