CSV- oder JSON-Link

Mit einem CSV- oder JSON-Link bringst du die Zeilen einer Tabelle auf deinen Bildschirm, zum Beispiel einen Stundenplan, eine Preisliste oder eine Belegungsübersicht. Du fügst den Link ein, wählst bis zu vier Spalten, und gibeon.io erledigt den Rest. Auch ein Google Sheet funktioniert.

Was der CSV- oder JSON-Link macht

gibeon.io ruft den Link alle 15 Minuten neu ab.
gibeon.io speichert höchstens 100 Zeilen, in der Reihenfolge der Datei. Eine Zeile, in der alle gewählten Spalten leer sind, entfällt.
Ein Wert wird als Text gezeigt, so wie er in der Datei steht, mit höchstens 200 Zeichen pro Zelle.
Eine CSV-Datei darf Komma, Semikolon oder Tabulator als Trennzeichen haben und UTF-8, die ältere Excel-Kodierung oder Unicode-Text aus Excel verwenden.
Eine JSON-Datei ist eine Liste von Objekten oder eine Liste unter einem einzigen Schlüssel.
Funktioniert der Link kurz nicht, bleiben die letzten Zeilen auf dem Bildschirm stehen.

Voraussetzungen

Ein Link zu einer CSV-Datei, einer JSON-Liste oder einem Google Sheet.
Der Link muss ohne Login und ohne API-Schlüssel erreichbar sein.

Einen CSV- oder JSON-Link hinzufügen

Melde dich bei app.gibeon.io an.
Gehe zu Design › Daten und klicke auf Neue Quelle.
Klicke auf die Kachel CSV- oder JSON-Link. Es öffnet sich ein Fenster.
Füge den Link bei Link ein und klicke auf Prüfen. gibeon.io zeigt die Spaltennamen und die ersten Zeilen.
Wähle unter Spalten auf dem Bildschirm (bis zu vier) die Spalten, die du zeigen willst. Wähle sie in der Reihenfolge, in der sie auf dem Bildschirm stehen sollen.
Klicke auf Hinzufügen.

gibeon.io legt die Quelle an und ruft die Zeilen sofort ab. Auf der Seite der Quelle unter Design › Daten siehst du die Zeilen.

Die Kachel steht nur unter Design › Daten, nicht unter Apps. Die Quelle bringst du danach über den bestehenden Ablauf für Datenquellen auf einen Bildschirm.

Die Spalten später anpassen

Öffne die Seite der Quelle unter Design › Daten. Klicke im Abschnitt Spalten auf Spalten ändern, wähle andere Spalten oder eine andere Reihenfolge und klicke auf Spalten speichern. gibeon.io ruft den Link danach neu ab.

Layouts

Für die Zeilen gibt es zwei Layouts:

Tabelle im Querformat: 8 Zeilen pro Seite
Tabelle im Hochformat: 12 Zeilen pro Seite

Beide verwenden die Spaltennamen als Überschrift. Gibt es mehr Zeilen, als auf eine Seite passen, blättert der Bildschirm durch die Zeilen.

Ein Google Sheet verwenden

Es gibt zwei Wege. Füge in beiden Fällen die Adresse bei Link ein.

Mit allen teilen, die den Link haben

Klicke im Google Sheet auf Share.
Stelle bei General access die Auswahl auf Anyone with the link.
Füge den normalen Link des Sheets ein.

Im Web veröffentlichen

Wähle im Google Sheet File › Share › Publish to web.
Wähle als Format CSV.
Füge den Link ein, den Google anzeigt.

Beispieldateien

Du willst es erst ausprobieren? Füge einen dieser Links bei Link ein:

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

Beide enthalten dieselben fünf Unterrichtsstunden mit den Spalten Tijd, Les, Zaal und Docent (Uhrzeit, Stunde, Raum und Lehrkraft).

Einschränkungen

Eine Organisation kann höchstens 10 CSV- oder JSON-Links haben. Beim elften sagt gibeon.io: „Ihre Organisation hat bereits 10 CSV- oder JSON-Links.“
Du wählst höchstens vier Spalten.
gibeon.io zeigt höchstens 100 Zeilen.
Der Link muss ohne Login erreichbar sein.
Der Link beginnt mit https://.

Fehlerbehebung

Funktioniert der Link nicht, sagt das Fenster, was schiefgegangen ist. Nach dem Hinzufügen steht dieselbe Meldung auf der Seite der Quelle, während der Bildschirm die letzten Zeilen weiter zeigt.

Meldung	Was sie bedeutet
Das ist kein gültiger Link.	Die Adresse ist keine gültige Webadresse oder beginnt nicht mit https://.
Dieser Link verweist auf eine interne Adresse.	Die Adresse gehört zu einem internen oder lokalen Netzwerk. Verwende einen öffentlichen Link.
Der Link antwortet nicht innerhalb von 10 Sekunden.	Der Server reagiert zu langsam.
Die Datei ist größer als 2 MB.	Die Datei ist zu groß.
Der Link liefert einen Fehler (404).	Der Server gibt einen Fehlercode zurück, hier 404. Der Code in der Meldung ist der Code deines Links.
Der Link liefert einen Fehler.	Der Link leitet zu oft an eine andere Adresse weiter.
Der Link ist nicht erreichbar.	Der Server ist nicht zu erreichen.
Unter diesem Link befindet sich weder eine CSV-Datei noch eine JSON-Liste. Teilen Sie ein Google Sheet mit allen, die den Link haben, oder veröffentlichen Sie es als CSV.	Der Link liefert etwas anderes zurück, etwa eine normale Webseite oder eine Anmeldeseite.
Die Datei enthält keine Zeilen.	Die Datei enthält nur eine Kopfzeile oder nichts.
Die Datei konnte nicht gelesen werden.	gibeon.io kann die Datei nicht als Tabelle lesen.
Die Spalte {Name} ist nicht mehr in der Datei vorhanden. Wählen Sie die Spalten erneut aus.	Eine gewählte Spalte ist aus der Datei verschwunden. Wähle die Spalten erneut im Abschnitt Spalten.

Es erscheinen keine Zeilen

Öffne den Link in einem Browser, ohne angemeldet zu sein. Zeigt er die Datei, kann gibeon.io sie auch lesen. Zeigt er eine Anmeldeseite, funktioniert der Link nicht.

Die Zeilen sind nicht aktuell

gibeon.io ruft den Link alle 15 Minuten ab. Steht auf der Seite der Quelle eine Meldung, bleiben die letzten Zeilen auf dem Bildschirm stehen, bis der Link wieder funktioniert.