Extension:External Data/fr

From mediawiki.org
This page is a translated version of the page Extension:External Data and the translation is 83% complete.
Outdated translations are marked like this.
Manuel des extensions MediaWiki
OOjs UI icon advanced-invert.svg
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.2 (octobre 2022)
Politique de compatibilité Le master conserve la compatibilité arrière.
MediaWiki 1.33+
Modifie la base
de données
Oui
Composer mediawiki/external-data
Licence Licence publique générale GNU v2.0 ou supérieur
Téléchargement Voir Download and 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 le mode de compatibilité arrière, l'extension définit également des fonctions de récupération des 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 - 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 - 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 efface l'ensemble actuel de données récupérées.

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 le mode de compatibilité, les fonctions Lua additionnelles suivantes sont également définies (il y a une correspondance biunivoque évidente en fonction du nom, entre les fonctions d'analyse syntaxique qui récupèrent les données, et les fonctions 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

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.29 ou plus récent.

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.