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

Довідка про розширення MediaWiki

External Data Статус релізу: стабільний
Реалізація	Функція парсера , Спеціальна сторінка
Опис	Дозволяє використовувати та відображати значення, отримані з різних джерел: зовнішні URL-адреси, локальні вікі-сторінки та локальні файли (у форматах CSV, JSON, XML та інших), таблиці бази даних і сервери LDAP.
Автор(и)	Yaron Koren, Alexander Mashin and others
Найновіша версія	3.3 (листопад 2023)
Compatibility policy	Master maintains backward compatibility.
MediaWiki	1.37+
Зміни в БД	Yes
Composer	mediawiki/external-data
Tables	ed_url_cache
Ліцензія	GNU General Public License 2.0 or later
Завантажити	See Download and installation
Приклад	A page containing information retrieved from an external CSV file
Параметри $wgSources $wgConnectors $wgAllowGetters $wgIntegratedConnectors $wgVerbose $wgParsers
Використані hook'и LoadExtensionSchemaUpdates ParserFirstCallInit ScribuntoExternalLibraries SoftwareInfo
Hooks provided ExternalDataBeforeWebCall
Issues	Open tasks · Report a bug

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

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

• Data retrieval and handling functions, which set local variables and then display or store them:
  • #external_value - displays the value of any such variable.
  • #for_external_table - перебирає всі значення, отримані для набору змінних, відображаючи один і той же текст «контейнера» для кожної з них.
  • #display_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.
• In the Legacy mode the extension also defines data retrieval functions, which set local variables available with wikipage scope that can later be displayed using the above functions:
  • #get_external_data - retrieves data from various sources, thus replacing any of the below parser functions, and assigns it to variables that can be accessed on the page.
  • #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_inline_data - parses data passed to it, in the same formats as #get_web_data.
  • and also #clear_external_data стирає поточний набір отриманих даних.

It also defines a Lua function mw.ext.externalData.getExternalData that retrieves data and returns it as Lua table.

In the Legacy mode, the following additional Lua functions are also defined (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.getInlineData

In tag emulation mode, the wiki site administrator can define additional parser tags.

This version of the External Data extension requires MediaWiki 1.37+.

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.