Jump to content

Расширение:External Data

From mediawiki.org
This page is a translated version of the page Extension:External Data and the translation is 100% complete.
Not to be confused with: Extension:External Content.
Справка по расширениям MediaWiki
External Data
Статус релиза: стабильно
Реализация Функция парсера , Служебная страница
Описание Позволяет использовать и отображать значения, полученные из различных источников: внешних URL-адресов и SOAP-сервисов, локальных вики-страниц и файлов (в форматах CSV, JSON, XML и других), таблиц баз данных, серверов LDAP и вывода локальных программ.
Автор(ы) Yaron Koren, Alexander Mashin и другие
Последняя версия 3.6.1 (июнь 2026)
Политика совместимости Мастер поддерживает обратную совместимость.
MediaWiki 1.40+
Изменения в БД Да
  • $wgCacheSize
  • $wgSources
  • $wgAllowGetters
  • $wgConnectors
  • $wgPresetGroups
  • $wgIntegratedConnectors
  • $wgVerbose
  • $wgParsers
Licence GNU General Public License 2.0 or later
Скачать См. Загрузка и установка .
Пример Страница, содержащая информацию, полученную из внешнего CSV-файла
Переведите расширение External Data, если оно доступно на translatewiki.net
Проблемы Открытые задачи · Сообщить об ошибке

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

Расширение определяет следующие parser functions :

  • Функции получения и обработки данных, которые устанавливают локальные переменные, а затем отображают или сохраняют их:
    • #external_value - отображает значение любой такой переменной.
    • #for_external_table - перебирает все значения, полученные для набора переменных, отображая один и тот же текст-«контейнер» для каждого из них.
    • #display_external_table - перебирает все полученные значения для набора переменных, отображая каждую «строку» с помощью заданного шаблона.
    • #format_external_table - доступно только при установленном расширении Cargo. Форматирует полученные внешние данные так же, как и #cargo_query .
  • В устаревшем режиме расширение также определяет функции получения данных, которые устанавливают локальные переменные в области видимости вики-страницы; в дальнейшем их можно отобразить с помощью вышеупомянутых функций:
    • #get_external_data - извлекает данные из различных источников, заменяя собой любую из перечисленных ниже функций парсера, и присваивает их переменным, доступным в пределах страницы.
    • #get_web_data - извлекает данные из CSV, GFF, JSON, YAML, XML, HTML, ini или в произвольном формате по URL-адресу и присваивает их переменным, доступным в пределах страницы.
    • #get_soap_data - извлекает данные по URL-адресу через протокол SOAP.
    • #get_file_data - извлекает данные из файла на локальном сервере в тех же форматах, что и #get_web_data.
    • #get_db_data - извлекает данные из базы данных.
    • #get_ldap_data - извлекает данные с сервера LDAP.
    • #get_program_data - извлекает данные, возвращаемые программой, запущенной на стороне сервера.
    • #get_inline_data - анализирует переданные в него данные в тех же форматах, что и #get_web_data.
    • и также #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

В режиме эмуляции тегов администратор вики-сайта может определять дополнительные теги парсера.

Текущая версия расширения External Data требует MediaWiki 1.40+.

Используйте ссылки в навигационной панели выше, чтобы узнать больше о расширении External Data, принципах его работы, способах использования и установки.