frendeitpt

csv-info

Cette action a été proposée et écrite par Denis HANTZ un utilisateur de UP qui avait besoin de récupérer une valeur dans un fichier CSV pour l'afficher dans l'article.

🆙 csv_info : Retourne la valeur brute d'un élément (ligne/colonne) d'un fichier CSV

Cliquer pour lire la documentation

syntaxe {up csv-info=chemin-fichier | col=x | line=x}
@version: UP-2.6 @license: GNU/GPLv3 @author: Denis HANTZ @tags: HTML
  • csv_info: URL ou chemin et nom d'un fichier local
  • separator = ;: séparateur des colonnes
  • line = -1: Titre dans la 1ere colonne ou numéro de la ligne où se trouve l'information. un nombre négatif recherche à partir de la fin
  • col = 1: Titre de la colonne dans la première ligne ou numero de colonne de l'information. Négatif à partir de la fin
  • default = [b class="t-red"]###[/b]: valeur retournée si coordonnées cellule hors feuille

    Pour les démonstrations, je vais utiliser le fichier ci-contre

    Il est mis en forme avec ce shortcode

    {up csv2table=images/actions-demo/csv2/mini.csv}
    title-1 title-2 title-3
    Line-1-Col-1 Line-1-Col-2 Line-1-Col-3
    Line-2-Col-1 Line-2-Col-2 Line-2-Col-3
    Line-3-Col-1 Line-3-Col-2 Icône hamburger pour un tutoriel Firefox réalisé par Sorgin Informatique.
    Footer-1 Footer-2 Footer-3

     

    Un exemple simple

    Le shortcode

    {up csv-info=images/actions-demo/csv2/mini.csv}

    ou

    {up csv-info=https://up.lomart.fr/images/actions-demo/csv2/mini.csv}

    Le résultat

    Footer-1

    Explication

    On indique uniquement le nom et l'emplacement du fichier (sur le serveur ou sur un autre site).

    Par défaut, l'action retourne la première valeur de la dernière ligne

     

    Par défaut, le séparateur CSV est le point-virgule. Si besoin, utilisez l'option separator pour indiquer celui de votre fichier

    Spécifier la cellule

    Pour récupérer une autre cellule du fichier CSV, il suffit d'indiquer ses coordonnées à l'aide des options line et col

    A partir de la cellule en haut et à gauche

    {up csv-info==images/actions-demo/csv2/mini.csv
    | line=1 | col=1}

    Résultat : title-1

    {up csv-info=images/actions-demo/csv2/mini.csv
    | line=2 | col=1}

    Résultat : Line-1-Col-1

    {up csv-info=images/actions-demo/csv2/mini.csv
    | line=2 | col=2}

    Résultat : Line-1-Col-2

    A partir de la dernière cellule en bas et à droite

    Une valeur négative permet de rechercher à partir de la fin.  line=-1 et col=-1 retournent la dernière cellule du fichier.

    {up csv-info=images/actions-demo/csv2/mini.csv
    | line=-1 | col=-1}

    Résultat : Footer-3

    {up csv-info=images/actions-demo/csv2/mini.csv
    | line=-2 | col=-1}

    Résultat : Icône hamburger pour un tutoriel Firefox réalisé par Sorgin Informatique.

    un moyen simple pour ne pas prendre en compte la dernière ligne

    {up csv-info=images/actions-demo/csv2/mini.csv
    | line=0 | col=0}

    Résultat : Footer-3

    La dernière colonne ou ligne peut être indiquée par 0 (zéro)

    A partir du titre de la colonne ou du contenu de la première colonne

    {up csv-info=images/actions-demo/csv2/mini.csv
    | line=Line-2-Col-1 | col=2}

    Résultat : Line-2-Col-2

    La première cellule d'une ligne peut être le libellé pour les autres cellules

    {up csv-info=images/actions-demo/csv2/mini.csv
    | line=0 | col=title-3}

    Résultat : Footer-3

    la dernière cellule de la colonne "title-3"

    {up csv-info=images/actions-demo/csv2/mini.csv
    | line=FOOTER-1 | col=TITLE-3}

    Résultat : Footer-3

    La recherche ne tient pas compte des minuscules/majuscules

    Pour utiliser le contenu de la première colonne, il est impératif que la première ligne du CSV contienne le titre des colonnes

    En cas d'erreur !

    2 types d'erreurs peuvent se produire.

    le fichier est introuvable ou vide. 

    Résultat : {up csv-info=vide.csv}

    Résultat : ###

    Le contenu de l'option default est affiché ainsi qu'un message en haut de votre site

    indice (numéro ou texte) pour ligne/colonne non trouvé

    Résultat : {up csv-info=images/actions-demo/csv2/mini.csv
    | line=99 | col=-99}

    Résultat : ###

    Le contenu de l'option default est affiché

    L'option default accepte du bbcode. exemple : [b class="t-red"]###[/b]

    Elle peut aussi retourner une valeur par défaut (d'où son nom) pour l'action appelante comme dans l'exemple ci-dessous.

    {up counter={up csv-info=fichier.csv | default=120}}