Handbuch · 8

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 fields und where stehen 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.