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

This page is a translated version of the page Extension:External Data and the translation is 100% complete.
الدليل المرجعي لامتدادات ميدياويكي
OOjs UI icon advanced-invert.svg
External Data
حالة الإصدار مستقر
تنفيذ دوال المحلل اللغوي , صفحة خاصة
بيان يسمح باستخدام القيم المجلوبة من مصادر مختلفة وعرضها: معرفات مواقع موحدة خارجية وخدمات SOAP أو صفحات ويكي محلية أو ملفات محلية (في صيغة CSV أو JSON أو XML أو أي صيغة أخرى) وكذا جداول قواعد البيانات وخوادم LDAP ونواتج البرامج المحلية.
المؤلف/المؤلفون Yaron Koren, Alexander Mashin and others
آخر إصدار 3.1 (مارس 2022)
سياسة التوافق النسخة الرئيسية تحافظ على التوافق مع الإصدارات السابقة.
MediaWiki 1.29+
تغييرات قاعدة البيانات نعم
Composer mediawiki/external-data
ترخيص رخصة جنو العمومية 2.0 أو ما بعدها
التنزيل See Download and installation
مثال A page containing information retrieved from an external CSV file
  • $wgParsers
  • $wgSources
  • $wgVerbose
  • $wgConnectors

طالع مصفوفة الاستخدام والإصدارات.

المسائل المهام المفتوحة · الإبلاغ عن عطل تقني

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

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

  • Data retrieval functions, which set local variables available with wikipage scope:
    • #get_web_data - يجلب بيانات CSV أو GFF أو JSON أو XML أو HTML أو بيانات حرة الصيغة من معرف موارد موحد ويخصصها إلى متغيرات يمكن الوصول إليها على الصفحة.
    • #get_soap_data - يجلب بيانات من معرف موارد موحد مستخدمًا بروتوكول البروتوكول للوصول البسيط إلى الأجسام (SOAP).
    • #get_file_data - retrieves data from a file on the local server, in the same formats as #get_web_data.
    • #get_db_data - يجلب بيانات من قاعدة بيانات.
    • #get_ldap_data - retrieves data from an LDAP server.
    • #get_program_data - retrieves data returned by a program run server-side.
    • #get_external_data - a universal alias for any of the above functions.
  • Data handling functions, which display, store or clear previously set local variables:
    • #external_value - displays the value of any such variable.
    • #for_external_table - يجول في كافة القيم المجلوبة لمجموعة من المتغيرات ويعرض نفس نص «الحاوية» لكل واحد منها.
    • #format_external_table - available only if Cargo is installed. Formats the retrieved external data the same way as #cargo_query.
    • #store_external_table - cycles through a table of values, storing them as semantic data via the Semantic MediaWiki extension, by mimicking a call to SMW's #subobject function for each row.
    • #display_external_table - يجول في كافة القيم المجلوبة لمجموعة من المتغيرات ويعرض كل «صف» مستخدمًا قالب.
    • #clear_external_data - يمحو المجموعة الحالية من البيانات المجلوبة.

It also defines the following Lua functions that retrieve data and return it as Lua tables. There is one-to-one correspondence between parser functions retrieving data and Lua functions evident from their names:

  • 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.getExternalData

In tag emulation mode, an administrator can define additional parser tags.

This version of the External Data extension requires MediaWiki 1.29 or higher.

Click through the pages in the navigation bar above to learn more about External Data, how it works, how to use it, and how to install it.