Розширення:Зовнішні дані

This page is a translated version of the page Extension:External Data and the translation is 82% complete.
Outdated translations are marked like this.
Other languages:
Довідка про розширення MediaWiki
OOjs UI icon advanced-invert.svg
External Data
Статус релізу: стабільний
Реалізація Функція парсера , Спеціальна сторінка
Опис Дозволяє використовувати та відображати значення, отримані з різних джерел: зовнішні URL-адреси, локальні вікі-сторінки та локальні файли (у форматах CSV, JSON, XML та інших), таблиці бази даних і сервери LDAP.
Автор(и) Yaron Koren, Alexander Mashin and others
Найновіша версія 3.1 (березень 2022)
Compatibility policy Master maintains backward compatibility.
MediaWiki 1.29+
Зміни в БД Yes
Composer mediawiki/external-data
Ліцензія GNU General Public License 2.0 or later
Завантажити See Download and installation
Приклад A page containing information retrieved from an external CSV file
  • $wgParsers
  • $wgSources
  • $wgVerbose
  • $wgConnectors

Переглянути використання

Issues Open tasks · Report a bug

Розширення External Data дозволяє сторінкам MediaWiki отримувати, фільтрувати та форматувати структуровані дані з одного або кількох джерел. Ці джерела можуть включати зовнішні URL-адреси, звичайні вікі-сторінки, завантажені файли, файли на локальному сервері, бази даних і каталоги LDAP.

Розширення визначає такий Parser functions :

  • Data retrieval functions, which set local variables available with wikipage scope:
    • #get_web_data - отримує дані CSV, GFF, JSON, XML, HTML або у довільній формі з URL-адреси та призначає їх змінним, до яких можна отримати доступ на сторінці.
    • #get_soap_data - отримує дані з URL-адреси через протокол 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.