Extension External Data - Utilisation

Cette extension permet d'afficher des données CSV et JSON (et d'autres mais pas encore testé) sous forme, entre autres, de tableau.

Pour faire appel à cette extension il faut obligatoirement passer par le wikicode.

Pré-requis

Pour accéder à votre CSV, il faut qu'ils soit accessible en ligne directement, c'est à dire que le lien doit pointer directement vers le fichier CSV.

Par exemple, si dans Google Sheets vous faites une « publication pour le Web » en utilisant le format CSV, cela ne fonctionnera pas car le lien n'est pas directement vers le fichier.

Les trois solutions que je vois pour le moment :

Accès depuis serveur

Il suffit d'envoyer votre fichier sur votre serveur via FTP, vous aurez alors accès à votre fichier par une URL de ce style

https://www.vanlindt.be/CSV/testexternaldata.csv

Utiliser un Cloud

Plusieurs solutions permettent d'obtenir un lien direct vers le fichier : NextCloud, OwnCloud, SeaFile...

Pour cela, envoyez le sur votre cloud et partagez le publiquement. Rendez-vous sur ce lien et faites un click droit sur le bouton « Télécharger » pour copier le lien de ce bouton qui est celui vers le fichier.

Vous aurez alors un lien de ce type :

https://cloud.vanlindt.be/index.php/s/g6PmMDkPTkDB2YP/download/testexternaldata.csv

Téléverser le fichier sur Movilab

Cela n'est pas encore réalisable et il n'est pas certains que ça le soit.

En principe Movilab n'a pas besoin de fichiers CSV et ne sait rien en faire dans un article, raison pour laquelle il n'est pas possible de téléverser ce type de fichiers, mais il devrait être possible de l'autoriser afin de pouvoir en téléverser, le mettre à jour facilement, tout en disposant d'un lien direct.

Données du CSV

Les données factices proviennent d'une Google Sheets :

qui permet d'exporter directement en CSV, donnant le résultat suivant.

Titre,Année,Auteur,Lien,Résumé
Titre 1,2005,Auteur 1,https://www.monsite/2005,"Résumé de Titre 1, écrit en 2005 par Auteur 1 qui nous décrit tout un tas de choses trop longues à expliquer pour un résumé."
Titre 2,2006,Auteur 2,https://www.monsite/2006,"Résumé de Titre 2, écrit en 2006 par Auteur 2 qui nous décrit tout un tas de choses trop longues à expliquer pour un résumé."
Titre 3,2007,Auteur 3,https://www.monsite/2007,"Résumé de Titre 3, écrit en 2007 par Auteur 3 qui nous décrit tout un tas de choses trop longues à expliquer pour un résumé."
Titre 4,2006,Auteur 4,https://www.monsite/2006,"Résumé de Titre 4, écrit en 2006 par Auteur 4 qui nous décrit tout un tas de choses trop longues à expliquer pour un résumé."
Titre 5,2005,Auteur 5,https://www.monsite/2005,"Résumé de Titre 5, écrit en 2005 par Auteur 5 qui nous décrit tout un tas de choses trop longues à expliquer pour un résumé."
Titre 6,2010,Auteur 6,https://www.monsite/2010,"Résumé de Titre 6, écrit en 2010 par Auteur 6 qui nous décrit tout un tas de choses trop longues à expliquer pour un résumé."
Titre 7,2006,Auteur 7,https://www.monsite/2006,"Résumé de Titre 7, écrit en 2006 par Auteur 7 qui nous décrit tout un tas de choses trop longues à expliquer pour un résumé."
Titre 8,2005,Auteur 8,https://www.monsite/2005,"Résumé de Titre 8, écrit en 2005 par Auteur 8 qui nous décrit tout un tas de choses trop longues à expliquer pour un résumé."
Titre 9,2005,Auteur 9,https://www.monsite/2005,"Résumé de Titre 9, écrit en 2005 par Auteur 9 qui nous décrit tout un tas de choses trop longues à expliquer pour un résumé."
Titre 10,2010,Auteur 10,https://www.monsite/2010,"Résumé de Titre 10, écrit en 2010 par Auteur 10 qui nous décrit tout un tas de choses trop longues à expliquer pour un résumé."
Titre 11,2006,Auteur 11,https://www.monsite/2006,"Résumé de Titre 11, écrit en 2006 par Auteur 11 qui nous décrit tout un tas de choses trop longues à expliquer pour un résumé."
Titre 12,2010,Auteur 12,https://www.monsite/2010,"Résumé de Titre 12, écrit en 2010 par Auteur 12 qui nous décrit tout un tas de choses trop longues à expliquer pour un résumé."
Titre 13,2005,Auteur 13,https://www.monsite/2005,"Résumé de Titre 13, écrit en 2005 par Auteur 13 qui nous décrit tout un tas de choses trop longues à expliquer pour un résumé."
Titre 14,2006,Auteur 14,https://www.monsite/2006,"Résumé de Titre 14, écrit en 2006 par Auteur 14 qui nous décrit tout un tas de choses trop longues à expliquer pour un résumé."

Utilisation de External Data

Code à utiliser

{{#get_web_data:
url=https://cloud.vanlindt.be/index.php/s/g6PmMDkPTkDB2YP/download/testexternaldata.csv
|format=CSV
|data=TITRE=Titre,ANNEE=Année,AUTEUR=Auteur,LIEN=Lien,RESUME=Résumé
|update=yes
}}


{| class="wikitable sortable"
! Titre !! Année !! Auteur !! Lien !! Résumé
{{#for_external_table:<nowiki></nowiki>
{{!}}-
{{!}} {{{TITRE}}} {{!}}{{!}} {{{ANNEE}}} {{!}}{{!}} {{{AUTEUR}}} {{!}}{{!}} [{{{LIEN}}} Lien] {{!}}{{!}} {{{RESUME}}}
}}
|}

La première section est la configuration de la récupération des données :

• url : lien vers votre fichier CSV
• format : le format utilisé (CSV, JSON...)
• data : indique quelles données du CSV doivent être récupérées. Le premier terme (par exemple TITRE) est le nom donné à la variable au sein de External Data. Le second terme est le nom de colonne dans le CSV. Attention : Ne jamais donner au premier le terme le nom URL car cela provoque un bug. Attention 2 : Il faut éviter de mettre des accents dans le premier terme.
• update : assure la mise à jour régulière des données. Après tests il semblerait que la mise à jour soit faites toutes les heures. Attention, cela ne veut pas dire que toutes les heures le serveur sera surchargé de refetch. Cela veut dire que si quand quelqu'un va sur la page et que les données ont plus d'une heure, elles seront rafraichies.

La seconde section est l'affichage de votre tableau. Vous indiquez ici le titre des colonnes et plus bas la variable à afficher pour chaque colonne.

Ce tableau est triable, si vous voulez faire en sort qu'il ne le soit pas, supprimez le « sortable » situé après « wikitable » dans « class ».

Pour la variable LIEN, vous pouvez voir qu'elle est placée entre crochets « [{{{LIEN}}} Lien] », c'est ce qui permet de créer un lien dans MediaWiki. Ici, au lieu d'afficher l'url, nous l'avons placer entre crochets afin que ce soit le mot « Lien » qui apparaisse.

Résultat

Titre	Année	Auteur	Lien	Résumé
Titre 1	2005	Auteur 1	Lien	Résumé de Titre 1, écrit en 2005 par Auteur 1 qui nous décrit tout un tas de choses trop longues à expliquer pour un résumé.
Titre 2	2006	Auteur 2	Lien	Résumé de Titre 2, écrit en 2006 par Auteur 2 qui nous décrit tout un tas de choses trop longues à expliquer pour un résumé.
Titre 3	2007	Auteur 3	Lien	Résumé de Titre 3, écrit en 2007 par Auteur 3 qui nous décrit tout un tas de choses trop longues à expliquer pour un résumé.
Titre 4	2006	Auteur 4	Lien	Résumé de Titre 4, écrit en 2006 par Auteur 4 qui nous décrit tout un tas de choses trop longues à expliquer pour un résumé.
Titre 5	2005	Auteur 5	Lien	Résumé de Titre 5, écrit en 2005 par Auteur 5 qui nous décrit tout un tas de choses trop longues à expliquer pour un résumé.
Titre 6	2010	Auteur 6	Lien	Résumé de Titre 6, écrit en 2010 par Auteur 6 qui nous décrit tout un tas de choses trop longues à expliquer pour un résumé.
Titre 7	2006	Auteur 7	Lien	Résumé de Titre 7, écrit en 2006 par Auteur 7 qui nous décrit tout un tas de choses trop longues à expliquer pour un résumé.
Titre 8	2005	Auteur 8	Lien	Résumé de Titre 8, écrit en 2005 par Auteur 8 qui nous décrit tout un tas de choses trop longues à expliquer pour un résumé.
Titre 9	2005	Auteur 9	Lien	Résumé de Titre 9, écrit en 2005 par Auteur 9 qui nous décrit tout un tas de choses trop longues à expliquer pour un résumé.
Titre 10	2010	Auteur 10	Lien	Résumé de Titre 10, écrit en 2010 par Auteur 10 qui nous décrit tout un tas de choses trop longues à expliquer pour un résumé.
Titre 11	2006	Auteur 11	Lien	Résumé de Titre 11, écrit en 2006 par Auteur 11 qui nous décrit tout un tas de choses trop longues à expliquer pour un résumé.
Titre 12	2010	Auteur 12	Lien	Résumé de Titre 12, écrit en 2010 par Auteur 12 qui nous décrit tout un tas de choses trop longues à expliquer pour un résumé.
Titre 13	2005	Auteur 13	Lien	Résumé de Titre 13, écrit en 2005 par Auteur 13 qui nous décrit tout un tas de choses trop longues à expliquer pour un résumé.
Titre 14	2006	Auteur 14	Lien	Résumé de Titre 14, écrit en 2006 par Auteur 14 qui nous décrit tout un tas de choses trop longues à expliquer pour un résumé.

Filtrer le tableau

Pour filtrer un tableau, vous devez ajouter dans la première section la ligne « filters=Nom de la colonne=valeur filtrée ».

Vous pouvez utilisez plusieurs filtres, mais vous ne pouvez pas filtrer plusieurs fois la même colonne.

Par exemple, vous pourrez filtrer toutes les données par année afin de ne voir que celles de 2006. Mais il ne sera pas possible (ou alors j'ai pas trouvé), d'avoir les données de 2006 ET de 2005.

Exemple avec un filtre

{{#get_web_data:
url=https://cloud.vanlindt.be/index.php/s/g6PmMDkPTkDB2YP/download/testexternaldata.csv
|format=CSV
|data=TITRE=Titre,ANNEE=Année,AUTEUR=Auteur,LIEN=Lien,RESUME=Résumé
|filters=Année=2006
|update=yes
}}
{| class="wikitable sortable"
! Titre !! Année !! Auteur !! Lien !! Résumé
{{#for_external_table:<nowiki></nowiki>
{{!}}-
{{!}} {{{TITRE}}} {{!}}{{!}} {{{ANNEE}}} {{!}}{{!}} {{{AUTEUR}}} {{!}}{{!}} [{{{LIEN}}} Lien] {{!}}{{!}} {{{RESUME}}}
}}}}
|} 

Titre	Année	Auteur	Lien	Résumé <nowiki></nowiki>
Titre 2	2006	Auteur 2	Lien	Résumé de Titre 2, écrit en 2006 par Auteur 2 qui nous décrit tout un tas de choses trop longues à expliquer pour un résumé.<nowiki></nowiki>
Titre 4	2006	Auteur 4	Lien	Résumé de Titre 4, écrit en 2006 par Auteur 4 qui nous décrit tout un tas de choses trop longues à expliquer pour un résumé.<nowiki></nowiki>
Titre 7	2006	Auteur 7	Lien	Résumé de Titre 7, écrit en 2006 par Auteur 7 qui nous décrit tout un tas de choses trop longues à expliquer pour un résumé.<nowiki></nowiki>
Titre 11	2006	Auteur 11	Lien	Résumé de Titre 11, écrit en 2006 par Auteur 11 qui nous décrit tout un tas de choses trop longues à expliquer pour un résumé.<nowiki></nowiki>
Titre 14	2006	Auteur 14	Lien	Résumé de Titre 14, écrit en 2006 par Auteur 14 qui nous décrit tout un tas de choses trop longues à expliquer pour un résumé.}}

Exemple avec deux filtres

{{#get_web_data:
url=https://cloud.vanlindt.be/index.php/s/g6PmMDkPTkDB2YP/download/testexternaldata.csv
|format=CSV
|data=TITRE=Titre,ANNEE=Année,AUTEUR=Auteur,LIEN=Lien,RESUME=Résumé
|filters=Année=2005, Auteur=Auteur 8
|update=yes
}}
{| class="wikitable sortable"
! Titre !! Année !! Auteur !! Lien !! Résumé
{{#for_external_table:<nowiki></nowiki>
{{!}}-
{{!}} {{{TITRE}}} {{!}}{{!}} {{{ANNEE}}} {{!}}{{!}} {{{AUTEUR}}} {{!}}{{!}} [{{{LIEN}}} Lien] {{!}}{{!}} {{{RESUME}}}
}}}}
|} 

Titre	Année	Auteur	Lien	Résumé <nowiki></nowiki>
Titre 8	2005	Auteur 8	Lien	Résumé de Titre 8, écrit en 2005 par Auteur 8 qui nous décrit tout un tas de choses trop longues à expliquer pour un résumé.}}

Autre usage

Nous pouvons simplement afficher les informations.

{{#get_web_data:
url=https://cloud.vanlindt.be/index.php/s/g6PmMDkPTkDB2YP/download/testexternaldata.csv
|format=CSV
|data=TITRE=Titre,ANNEE=Année,AUTEUR=Auteur,LIEN=Lien,RESUME=Résumé
|filters=Année=2005
|update=yes
}}
{{#for_external_table:<nowiki></nowiki>
==={{{TITRE}}}===
{{{RESUME}}}<br>
* Auteur : {{{AUTEUR}}}<br>
* Année : {{{ANNEE}}} <br>
* Lien : [{{{LIEN}}} {{{LIEN}}}]<br>
}}

Titre 1

Résumé de Titre 1, écrit en 2005 par Auteur 1 qui nous décrit tout un tas de choses trop longues à expliquer pour un résumé.

• Auteur : Auteur 1
  
• Année : 2005
  
• Lien : https://www.monsite/2005
  

Titre 5

Résumé de Titre 5, écrit en 2005 par Auteur 5 qui nous décrit tout un tas de choses trop longues à expliquer pour un résumé.

• Auteur : Auteur 5
  
• Année : 2005
  
• Lien : https://www.monsite/2005
  

Titre 8

Résumé de Titre 8, écrit en 2005 par Auteur 8 qui nous décrit tout un tas de choses trop longues à expliquer pour un résumé.

• Auteur : Auteur 8
  
• Année : 2005
  
• Lien : https://www.monsite/2005
  

Titre 9

Résumé de Titre 9, écrit en 2005 par Auteur 9 qui nous décrit tout un tas de choses trop longues à expliquer pour un résumé.

• Auteur : Auteur 9
  
• Année : 2005
  
• Lien : https://www.monsite/2005
  

Titre 13

Résumé de Titre 13, écrit en 2005 par Auteur 13 qui nous décrit tout un tas de choses trop longues à expliquer pour un résumé.

• Auteur : Auteur 13
  
• Année : 2005
  
• Lien : https://www.monsite/2005