Lien CSV ou JSON

Avec un lien CSV ou JSON, vous affichez à l’écran les lignes d’un tableau, par exemple un horaire de cours, une liste de prix ou un aperçu d’occupation. Vous collez le lien, choisissez jusqu’à quatre colonnes et gibeon.io fait le reste. Un Google Sheet fonctionne aussi.

Ce que fait le lien CSV ou JSON

gibeon.io récupère le lien toutes les 15 minutes.
gibeon.io garde 100 lignes au maximum, dans l’ordre du fichier. Une ligne dont toutes les colonnes choisies sont vides est écartée.
Une valeur s’affiche sous forme de texte, telle qu’elle figure dans le fichier, avec 200 caractères au maximum par cellule.
Un fichier CSV peut utiliser une virgule, un point-virgule ou une tabulation comme séparateur, et peut être en UTF-8, dans l’ancien encodage d’Excel ou en texte Unicode d’Excel.
Un fichier JSON est une liste d’objets, ou une liste placée sous une seule clé.
Si le lien ne fonctionne plus pendant un moment, les dernières lignes restent à l’écran.

Prérequis

Un lien vers un fichier CSV, une liste JSON ou un Google Sheet.
Le lien doit être accessible sans connexion et sans clé API.

Ajouter un lien CSV ou JSON

Connectez-vous à app.gibeon.io.
Allez dans Design › Données et cliquez sur Nouvelle source.
Cliquez sur la tuile Lien CSV ou JSON. Une fenêtre s’ouvre.
Collez le lien dans Lien et cliquez sur Vérifier. gibeon.io affiche les noms des colonnes et les premières lignes.
Sous Colonnes à l’écran (jusqu’à quatre), choisissez les colonnes à afficher. Choisissez-les dans l’ordre où elles apparaissent à l’écran.
Cliquez sur Ajouter.

gibeon.io crée la source et récupère les lignes immédiatement. Vous voyez les lignes sur la page de la source sous Design › Données.

La tuile ne se trouve que sous Design › Données, pas sous Apps. Vous placez ensuite la source sur un écran par le parcours habituel des sources de données.

Modifier les colonnes plus tard

Ouvrez la page de la source sous Design › Données. Dans la section Colonnes, cliquez sur Modifier les colonnes, choisissez d’autres colonnes ou un autre ordre, puis cliquez sur Enregistrer les colonnes. gibeon.io récupère ensuite à nouveau le lien.

Mises en page

Il y a deux mises en page pour les lignes :

un tableau horizontal : 8 lignes par page
un tableau vertical : 12 lignes par page

Les deux utilisent les noms des colonnes comme en-tête. Quand il y a plus de lignes que n’en contient une page, l’écran fait défiler les lignes.

Utiliser un Google Sheet

Il y a deux méthodes. Dans les deux cas, collez l’adresse dans Lien.

Partager avec toute personne disposant du lien

Dans le Google Sheet, cliquez sur Share.
Sous General access, choisissez Anyone with the link.
Collez le lien ordinaire du Sheet.

Publier sur le web

Dans le Google Sheet, choisissez File › Share › Publish to web.
Choisissez CSV comme format.
Collez le lien affiché par Google.

Fichiers d’exemple

Vous voulez d’abord essayer ? Collez l’un de ces liens dans Lien :

https://www.gibeon.io/media/docs/data-integraties/lesrooster.csv
https://www.gibeon.io/media/docs/data-integraties/lesrooster.json

Les deux contiennent les mêmes cinq cours, avec les colonnes Tijd, Les, Zaal et Docent (heure, cours, salle et enseignant).

Limites

Une organisation peut avoir 10 liens CSV ou JSON au maximum. Au onzième, gibeon.io indique : « Votre organisation a déjà 10 liens CSV ou JSON. »
Vous choisissez quatre colonnes au maximum.
gibeon.io affiche 100 lignes au maximum.
Le lien doit être accessible sans connexion.
Le lien commence par https://.

Dépannage

Quand le lien ne fonctionne pas, la fenêtre indique ce qui s’est mal passé. Après l’ajout, le même message apparaît sur la page de la source, tandis que l’écran continue d’afficher les dernières lignes.

Message	Ce que cela signifie
Ce lien n’est pas valide.	L’adresse n’est pas une adresse web valide, ou elle ne commence pas par https://.
Ce lien pointe vers une adresse interne.	L’adresse appartient à un réseau interne ou local. Utilisez un lien public.
Le lien ne répond pas dans les 10 secondes.	Le serveur répond trop lentement.
Le fichier dépasse 2 Mo.	Le fichier est trop volumineux.
Le lien renvoie une erreur (404).	Le serveur renvoie un code d’erreur, ici 404. Le code dans le message est celui de votre lien.
Le lien renvoie une erreur.	Le lien redirige trop souvent vers une autre adresse.
Le lien est inaccessible.	Le serveur est injoignable.
Ce lien ne mène ni à un fichier CSV ni à une liste JSON. Partagez un Google Sheet avec toute personne disposant du lien, ou publiez-le en CSV.	Le lien renvoie autre chose, comme une page web ordinaire ou une page de connexion.
Le fichier ne contient aucune ligne.	Le fichier ne contient qu’un en-tête, ou rien.
Le fichier n’a pas pu être lu.	gibeon.io ne peut pas lire le fichier comme un tableau.
La colonne {nom} ne figure plus dans le fichier. Choisissez à nouveau les colonnes.	Une colonne choisie a disparu du fichier. Choisissez à nouveau les colonnes dans la section Colonnes.

Aucune ligne n’apparaît

Ouvrez le lien dans un navigateur sans être connecté. S’il affiche le fichier, gibeon.io peut aussi le lire. S’il affiche une page de connexion, le lien ne fonctionne pas.

Les lignes ne sont pas à jour

gibeon.io récupère le lien toutes les 15 minutes. Si un message figure sur la page de la source, les dernières lignes restent à l’écran jusqu’à ce que le lien refonctionne.