Kacheln und Karten
Tabs vom Typ TilesGrid und CardList beziehen ihre Inhalte aus dem Grid, das im Tab über gridUri verknüpft ist. Jede Zeile dieses Grids wird zu einer Kachel bzw. Karte.
Kachel-Ansicht TilesGrid
Ein Raster aus Kacheln — der übliche Startbildschirm mit Schnellzugriffen auf Formulare und Links.
| Feld-Key | Feldtyp | Pflicht | Beschreibung |
|---|---|---|---|
title | Text | ja | Beschriftung der Kachel |
icon | Anhang (SVG) | ja | Icon der Kachel, einfarbiges SVG |
uri | Weblink | ja | Ziel der Kachel, etwa ein Formular-Link |
actionType | Text / Einzelauswahl | ja | Wie das Ziel geöffnet wird — siehe unten |
Karten-Ansicht CardList
Eine Liste aus Karten mit Bild, Überschrift und Aktions-Button — für Neuigkeiten, Ankündigungen oder Aufgaben.
| Feld-Key | Feldtyp | Pflicht | Beschreibung |
|---|---|---|---|
headline | Text | ja | Überschrift der Karte |
supportingText | Text | nein | Beschreibungstext unter der Überschrift |
image | Anhang (Bild) | nein | Bild der Karte |
actionUri | Weblink | ja | Ziel des Aktions-Buttons |
actionType | Text / Einzelauswahl | ja | Wie das Ziel geöffnet wird — siehe unten |
actionLabel | Text | nein | Beschriftung des Aktions-Buttons |
createdAt | Datum und Uhrzeit | ja | Wird auf der Karte angezeigt, etwa als „Heute" oder „Gestern" |
createdAt automatisch füllen lassen
Legen Sie das Feld als Spaltentyp Erstellt am an. Dann wird es bei jedem neuen Eintrag automatisch gesetzt — auch bei Einträgen, die über ein Formular oder einen Flow entstehen. → Spaltentypen
Aktionstypen
Der Wert in actionType entscheidet, wie das Ziel geöffnet wird.
| Wert | Verhalten | Kacheln | Karten |
|---|---|---|---|
formLink | Öffnet ein ApptiveGrid-Formular in der App, in einer eingebetteten Webansicht | ✓ | ✓ |
internalFormLink | Öffnet ein ApptiveGrid-Formular nativ in der App, mit den Eingabefeldern der App | ✓ | ✓ |
internalLink | Öffnet die Seite innerhalb der App | ✓ | ✓ |
externalLink | Öffnet die Seite im Browser des Geräts | ✓ | ✓ |
triggerFlow | Öffnet das Ziel in einem In-App-Browser | – | ✓ |
internalLink überträgt, wer angemeldet ist
Bei ApptiveGrid-Links übergibt internalLink die angemeldete Person mit. Ein darüber ausgefülltes Formular trägt dadurch im Feld Erstellt von die richtige Person statt „Formular-Link".
Wenn Sie nachvollziehen wollen, wer eine Meldung abgesetzt hat, ist das der entscheidende Unterschied zu externalLink.
triggerFlow gibt es nur bei Karten. Damit starten Sie einen ApptiveGrid-Flow direkt aus einer Karte heraus. → Flow per Webhook starten
internalFormLink statt formLink
internalFormLink zeigt das Formular mit den nativen Eingabefeldern der App: Datumsauswahl, Kamera, Standort und Anhänge fühlen sich an wie im Rest der App, und ausgefüllte Formulare warten ohne Verbindung auf dem Gerät. formLink bleibt absichtlich bei der Webansicht, damit bestehende Kacheln ihr Verhalten behalten; Sie entscheiden pro Zeile.
Ältere App-Versionen kennen internalFormLink nicht und lassen solche Kacheln und Karten weg. Stellen Sie erst um, wenn die Belegschaft die aktuelle App hat.
Zeilen mit Lücken werden übersprungen
Wie bei den Tabs gilt: Fehlt ein Pflichtfeld, erscheint die Kachel bzw. Karte nicht — ohne Meldung. Fehlt eine Kachel unerwartet, prüfen Sie zuerst die Pflichtfelder und dann die Schreibweise der Feld-Keys.
Reihenfolge über eine sortierte Ansicht steuern
Kacheln und Karten erscheinen in der Reihenfolge des verknüpften Grids. Verknüpfen Sie eine Ansicht statt des Grids, steuern Sie Reihenfolge und Sichtbarkeit über deren Sortierung und Filter — bei Neuigkeiten etwa absteigend nach Datum.