CSV- of JSON-link

Met een CSV- of JSON-link zet je de rijen van een tabel op je scherm, bijvoorbeeld een lesrooster, een prijslijst of een bezettingsoverzicht. Je plakt de link, kiest tot vier kolommen en gibeon.io doet de rest. Ook een Google Sheet werkt.

Wat doet de CSV- of JSON-link

gibeon.io haalt de link elke 15 minuten opnieuw op.
gibeon.io bewaart maximaal 100 rijen, in de volgorde van het bestand. Een rij waarvan alle gekozen kolommen leeg zijn, valt weg.
Een waarde toont als tekst, zoals ze in het bestand staat, met maximaal 200 tekens per cel.
Een CSV-bestand mag een komma, een puntkomma of een tab als scheidingsteken hebben, en mag UTF-8 zijn, de oudere Excel-codering of Unicode-tekst uit Excel.
Een JSON-bestand is een lijst van objecten, of een lijst onder één sleutel.
Als de link even niet werkt, blijven de laatste rijen op het scherm staan.

Vereisten

Een link naar een CSV-bestand, een JSON-lijst of een Google Sheet.
De link moet bereikbaar zijn zonder login en zonder API-sleutel.

Een CSV- of JSON-link toevoegen

Log in op app.gibeon.io.
Ga naar Ontwerp › Data en klik op Nieuwe bron.
Klik op de tegel CSV- of JSON-link. Er opent een venster.
Plak de link bij Link en klik op Controleren. gibeon.io toont de kolomnamen en de eerste rijen.
Kies bij Kolommen op het scherm (tot vier) de kolommen die je wilt tonen. Kies ze in de volgorde waarin ze op het scherm staan.
Klik op Toevoegen.

gibeon.io maakt de bron aan en haalt de rijen meteen op. Op de pagina van de bron onder Ontwerp › Data zie je de rijen.

De tegel staat alleen onder Ontwerp › Data, niet onder Apps. Je zet de bron daarna op een scherm via de bestaande flow voor databronnen.

De kolommen later aanpassen

Open de pagina van de bron onder Ontwerp › Data. Klik in de sectie Kolommen op Kolommen wijzigen, kies andere kolommen of een andere volgorde en klik op Kolommen bewaren. gibeon.io haalt de link daarna opnieuw op.

Layouts

Er zijn twee layouts voor de rijen:

Tabel liggend: 8 rijen per pagina
Tabel staand: 12 rijen per pagina

Beide gebruiken de kolomnamen als kop. Bij meer rijen dan op één pagina past, bladert het scherm door de rijen.

Een Google Sheet gebruiken

Er zijn twee manieren. Plak in beide gevallen het adres bij Link.

Delen met iedereen met de link

Klik in de Google Sheet op Delen.
Zet bij Algemene toegang de keuze op Iedereen met de link.
Plak de gewone link van de Sheet.

Publiceren op internet

Kies in de Google Sheet Bestand › Delen › Publiceren op internet.
Kies als formaat CSV.
Plak de link die Google toont.

Voorbeeldbestanden

Wil je het eerst proberen? Plak een van deze links bij Link:

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

Beide bevatten dezelfde vijf lessen met de kolommen Tijd, Les, Zaal en Docent.

Beperkingen

Een organisatie kan maximaal 10 CSV- of JSON-links hebben. Bij de elfde zegt gibeon.io: “Je organisatie heeft al 10 CSV- of JSON-links.”
Je kiest maximaal vier kolommen.
gibeon.io toont maximaal 100 rijen.
De link moet zonder login bereikbaar zijn.
De link begint met https://.

Probleemoplossing

Als de link niet werkt, zegt het venster wat er misging. Na het toevoegen staat dezelfde melding op de pagina van de bron, terwijl het scherm de laatste rijen blijft tonen.

Melding	Wat het betekent
Dit is geen geldige link.	Het adres is geen geldig webadres, of het begint niet met https://.
Deze link wijst naar een intern adres.	Het adres hoort bij een intern of lokaal netwerk. Gebruik een publieke link.
De link antwoordt niet binnen 10 seconden.	De server reageert te traag.
Het bestand is groter dan 2 MB.	Het bestand is te groot.
De link geeft een fout (404).	De server geeft een foutcode terug, hier 404. De code in de melding is de code van jouw link.
De link geeft een fout.	De link stuurt te vaak door naar een ander adres.
De link is niet bereikbaar.	De server is niet te bereiken.
Op deze link staat geen CSV-bestand of JSON-lijst. Deel een Google Sheet met iedereen met de link, of publiceer hem als CSV.	De link geeft iets anders terug, zoals een gewone webpagina of een inlogpagina.
Het bestand heeft geen rijen.	Het bestand bevat alleen een kop of niets.
Het bestand kon niet gelezen worden.	gibeon.io kan het bestand niet als tabel lezen.
De kolom {naam} staat niet meer in het bestand. Kies de kolommen opnieuw.	Een gekozen kolom is uit het bestand verdwenen. Kies de kolommen opnieuw in de sectie Kolommen.

Er verschijnen geen rijen

Open de link in een browser zonder te zijn ingelogd. Toont die het bestand, dan kan gibeon.io het ook lezen. Toont die een loginpagina, dan werkt de link niet.

De rijen zijn niet bijgewerkt

gibeon.io haalt de link elke 15 minuten op. Staat er een melding op de pagina van de bron, dan blijven de laatste rijen op het scherm tot de link weer werkt.