Extension:External Data/fr

From mediawiki.org
This page is a translated version of the page Extension:External Data and the translation is 100% complete.
Manuel des extensions MediaWiki
External Data
État de la version : stable
Implémentation Fonction d'analyseur , Page spéciale
Description Permet d'utiliser et d'afficher les valeurs extraites de différentes sources : URL externes et services SOAP, pages wiki locales et fichiers locaux (au format CSV, JSON, XML, ou autre), tables de base de données, serveurs LDAP et sorties des programmes locaux.
Auteur(s) Yaron Koren, Alexander Mashin et autres
Dernière version 3.3 (novembre 2023)
Politique de compatibilité Le master conserve la compatibilité arrière.
MediaWiki 1.37+
Modifie la base
de données
Oui
Composer mediawiki/external-data
Tables ed_url_cache
Licence Licence publique générale GNU v2.0 ou supérieur
Téléchargement Voir Téléchargement et installation
Exemple Page contenant des informations récupérées d'un fichier CSV externe
  • $wgSources
  • $wgConnectors
  • $wgAllowGetters
  • $wgIntegratedConnectors
  • $wgVerbose
  • $wgParsers
Problèmes Tâches ouvertes · Signaler un bogue

L'extension External Data permet aux pages MediaWiki de récupérer, filtrer et formater des données structurées à partir d'une ou plusieurs sources. Ces sources peuvent inclure des URL externes et des services SOAP, des pages de wiki régulières, des fichiers téléversés, des fichiers du serveur local, des bases de données, des répertoires LDAP et des sorties générées par les programmes locaux.

L’extension définit les Fonctions d'analyse suivantes :

  • Les fonctions de récupération et de traitement des données, qui définissent, affichent, enregistrent ou effacent des variables locales :
    • #external_value - affiche la valeur d'une telle variable donnée.
    • #for_external_table - parcourt toutes les valeurs récupérées pour un ensemble de variables, en affichant le même texte conteneur pour chacune d'elles.
    • #display_external_table - parcourt toutes les valeurs récupérées pour un ensemble de variables, en affichant le même texte conteneur pour chacune d'elles.
    • #format_external_table - disponible uniquement si Cargo est installé. Formate les données externes récupérées de la même manière que #cargo_query.
    • #store_external_table - parcourt un tableau de valeurs, en les enregistrant en tant que données sémantiques via l'extension Semantic MediaWiki en imitant un appel à la fonction #subobject de SMW pour chaque ligne.
  • Dans l'ancien mode l'extension définit également des fonctions de récupération de données qui initialisent les variables locales disponibles en fonction de l'étendue de la page du wiki et qui peuvent ultérieurement être affichées en utilisant les fonctions ci-dessus :
    • #get_external_data - récupère les données provenant de diverses sources, remplaçant ainsi toute fonctions ci-dessous d'analyse syntaxique, et les attribue aux variables accessibles sur la page.
    • #get_web_data - récupère les données CSV, GFF, JSON, YAML, XML, HTML, ini ou de format libre, à partir d'une URL et les affecte à des variables accessibles sur la page.
    • #get_soap_data - récupère les données d'une URL via le protocole SOAP.
    • #get_file_data - récupère les données d'un fichier du serveur local, dans les mêmes formats que #get_web_data.
    • #get_db_data - récupère les données d'une base de données.
    • #get_ldap_data - récupère les données d'un serveur LDAP.
    • #get_program_data - récupère les données renvoyées par un programme qui s'exécute côté serveur.
    • #get_inline_data - analyse syntaxiquement les données qui lui sont passées, dans les mêmes formats que ceux de #get_web_data.
    • and also #clear_external_data ceci efface l'ensemble actuel des données récupérées ou seulement quelques variables.

Elle définit également la fonction Lua mw.ext.externalData.getExternalData qui récupère les données et les renvoie en tant que table Lua.

Dans l'ancien mode, les fonctions Lua additionnelles suivantes sont aussi définies (il y a correspondance biunivoque entre les fonctions d'analyse syntaxique qui récupèrent les données, et les fonctions Lua au vu simplement de leur nom) :

  • 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

Dans le mode d'émulation de balise, l'administrateur du site wiki peut définir des balises d'analyse syntaxique supplémentaires.

Cette version de l'extension External Data nécessite MediaWiki 1.37+.

Cliquez sur les pages de la barre de navigation ci-dessus pour en savoir plus sur External Data, son fonctionnement, son utilisation et son installation.