Handbuch · 8

Apps verwalten

Unter Apps im Hauptmenü siehst du alle Apps mit Adresse, Zugriff und Status. Nur Admins bauen und verwalten Apps.

Anlegen

Neue App fragt nach dem Namen und dem Zugriff. Die Adresse leitet IllusionDB aus dem Namen ab („Lager & Versand“ → /app/lager-versand/); ist sie vergeben, wird eine Zahl angehängt. Eine neue App hat eine leere Startseite und ist noch nicht veröffentlicht.

Vorlagen

Statt mit einer leeren Seite kann eine App mit einer Vorlage beginnen. Du wählst dafür eine Tabelle. IllusionDB baut die App aus deren Spalten, die Texte stehen in deiner aktuellen Oberflächensprache. Danach ist es eine ganz normale App, die du im App-Builder weiter anpasst.

Vorlage Inhalt
Leer eine leere Startseite
Datenpflege Liste mit Suche über die Anzeigespalte, neueste Einträge zuerst; Neu öffnet einen Dialog zum Anlegen, ein Klick auf eine Zeile einen Dialog zum Bearbeiten (vorbelegt) mit Löschen und Rückfrage
Formular ein Formular, das pro Absenden einen Eintrag anlegt, mit Dank-Meldung – passt zu einer öffentlichen App
Übersicht Anzahl der Einträge, je Auswahlspalte (Label-Format) ein Diagramm und die zehn neuesten Einträge

Aus den Spalten wird jeweils das passende Steuerelement: Ja/Nein wird zur Checkbox, Datum zum Datumsfeld, Zahlen zum Zahlenfeld, Label-Spalten und Fremdschlüssel zur Auswahl (gefüllt aus der Zieltabelle, beschriftet mit deren Anzeigespalte), lange Texte zum mehrzeiligen Feld. Berechnete Spalten und Schlüssel, die die Datenbank selbst vergibt, lässt die Vorlage aus den Formularen weg. Für Datenpflege und Formular braucht die Tabelle genau einen Primärschlüssel.

Einstellungen

  • Name und Beschreibung erscheinen in der App-Übersicht unter /app/.
  • Adresse – Kleinbuchstaben, Ziffern und Bindestriche. Änderst du sie, ändert sich auch der Link (installierte Apps müssen dann neu installiert werden).
  • Icon – eigenes Bild für die installierte App und den Browser-Tab (PNG, JPEG, GIF, WebP; wird quadratisch zugeschnitten). Ohne: Anfangsbuchstabe auf der Akzentfarbe.
  • Zugriff – Mit Anmeldung (Admins und die freigegebenen Nutzer und Gruppen) oder Öffentlich (ohne Anmeldung).

Freigeben

Bei Apps mit Anmeldung legst du unter Nutzer und Gruppen fest, wer die App öffnen darf. Admins dürfen immer. Freigeben kannst du Viewer und App-Nutzer sowie Gruppen – auch App-Nutzer können Gruppenmitglied sein.

Entwurf und Veröffentlichen

Du arbeitest immer am Entwurf. Nutzer sehen die veröffentlichte Version – erst Veröffentlichen macht Änderungen sichtbar. Der Status zeigt „Unveröffentlichte Änderungen“, solange sich der Entwurf von der Live-Version unterscheidet.

  • Jedes Veröffentlichen legt eine neue Version an (v1, v2 …). Unter Versionen kannst du eine ältere Version wiederherstellen – sie wird zum Entwurf; veröffentliche danach, damit sie live geht.
  • Offline nehmen sperrt die App, bis du sie wieder veröffentlichst. Entwurf und Versionen bleiben erhalten.

Definition

Eine App ist intern eine Definition im JSON-Format: Seiten mit ihren Elementen im Raster, die Menüleiste und die Abfragen. Unter Definition kannst du sie direkt als JSON bearbeiten. Der Server prüft jede Änderung (zum Beispiel, ob ein Element ins Raster mit 12 Spalten passt) und speichert nur gültige Definitionen.

Exportieren und importieren

Exportieren lädt den Entwurf als Datei <adresse>.app.json herunter. Importieren (in der Übersicht) legt daraus eine neue, unveröffentlichte App an. Freigaben werden nicht mitexportiert, weil Nutzer und Gruppen in jeder Instanz andere sind.

Die App-Übersicht

Unter /app/ sieht jedes angemeldete Konto die veröffentlichten Apps, die es öffnen darf, dazu die öffentlichen Apps. Für App-Nutzer ist das die Startseite: Sie landen nach der Anmeldung immer hier.