Abfragen
Abfragen legen fest, was eine App lesen und ändern darf. Sie stehen im Reiter Abfragen des App-Builders und laufen auf dem Server: Der Browser schickt nur den Namen der Abfrage und die Werte ihrer Parameter – Tabelle, Filter, Felder und Werte kommen nie bei ihm an und lassen sich nicht verändern.
Arten
| Art | Wozu | Felder |
|---|---|---|
| Datensätze auflisten | Liste für Tabelle, Liste, Diagramm, Auswahl | Tabelle, Felder (keine = alle), Filter, Sortierung, höchstens pro Seite |
| Ein Datensatz | Details, z. B. in einem Dialog | Tabelle, Datensatz (Primärschlüssel), Felder |
| Datensatz anlegen | Formular speichern | Tabelle, Werte (Spalte → Wert) |
| Datensatz ändern | Status setzen, bearbeiten | Tabelle, Datensatz, Werte |
| Datensatz löschen | – | Tabelle, Datensatz |
| Datei hochladen | Anhänge an einen Datensatz, z. B. Fotos oder Belege | Tabelle, Datensatz, Anhang-Spalte; die Datei kommt aus einem Datei-Feld |
| Workflow ausführen | Logik auf dem Server | Workflow (siehe Workflows und REST-Quellen) |
| Custom Endpoint | vorhandene Skript-Endpunkte | Methode, Pfad |
| REST-Quelle | externe API | Quelle, Methode, Pfad, Body |
Parameter und Platzhalter
Eine Abfrage nimmt nur erklärte Parameter an (Name, Typ Text/Zahl/Ja-Nein/Datum/beliebig, Pflicht). In Filter, Werten, Datensatz, Pfad und Body setzen Platzhalter sie ein:
{{params.<name>}}– ein Parameter. Steht er allein, behält er seinen Typ.{{user.id}},{{user.email}},{{user.role}}– das angemeldete Konto (in öffentlichen Apps leer).{{now}}(Zeitpunkt) und{{today}}(Datum).
Platzhalter werden in die gespeicherte Struktur eingesetzt, nie in einen Abfragetext – ein Wert kann nur ein Wert werden. In Pfaden von REST-Quellen werden sie URL-kodiert. Leerer Filterwert = keine Bedingung: Ist ein Platzhalter in einer Filterbedingung leer, fällt die Bedingung weg – ein leeres Suchfeld zeigt alles. Aus Platzhaltern legt die Parameter aus den verwendeten Platzhaltern an.
Datenelemente geben die Werte der Parameter in ihren Eigenschaften an, Aktionen im Schritt Abfrage ausführen (mit Formular werden die Werte eines Formulars zu Parametern gleichen Namens). Unten im Reiter lässt sich jede Abfrage mit Beispielwerten ausprobieren (schreibende Abfragen ändern dabei wirklich Daten).
Rechte
- Apps mit Anmeldung: Jede Abfrage erreicht genau ihre Tabelle mit ihrer Stufe (lesen bzw. schreiben) – und nie mehr, als das Konto ohnehin darf: Für Viewer gelten zusätzlich ihre Tabellen-Berechtigungen.
- App-Nutzer haben keine Tabellenrechte; für sie gelten nur die Abfragen ihrer Apps.
- Öffentliche Apps laufen mit einer namenlosen App-Identität: genau die Abfragen der App, für alle Besucher gleich – auch für angemeldete.
- Berechnete Felder gehören zur Tabelle: Lookups, Rollups, Formeln, Links, Kind-Datensätze und die Anzeigewerte von Fremdschlüsseln kommen mit der Tabelle der Abfrage (bzw. den Tabellen eines Workflows), auch wenn sie in andere Tabellen greifen – in
fieldsundwherestehen sie unter ihrem API-Namen. App-Nutzer und öffentliche Apps sehen sie so, wie die Tabelle gebaut ist; für Viewer bleiben Felder aus Tabellen, die sie nicht lesen dürfen, weiter verborgen. - Hooks, Webhooks und berechnete Felder laufen wie bei der REST-API. Die Laufzeit begrenzt Aufrufe auf 600 je Minute und IP.