Apps
Apps verwalten
Apps anlegen, freigeben, versionieren und aus dem App Store installieren
Die Verwaltung erfolgt unter Einstellungen → Integration in Umsysteme → Apps. Alternativ gelangen Sie über die Schaltfläche Apps verwalten auf der Übersichtsseite der Apps dorthin.
Neue App erstellen
- Öffnen Sie Einstellungen → Integration in Umsysteme → Apps.
- Klicken Sie auf App erstellen. Es öffnet sich der Schritt Spezifikationen.
- Geben Sie Name und Slug ein, optional auch Beschreibung und Anbieter.
- Klicken Sie auf Erstellen. Die App wird angelegt, zunächst mit einem leeren Python-Gerüst.
- Wechseln Sie zum Schritt Code und schreiben Sie dort den Code der App.
- Klicken Sie auf Ausführen. Die Ausgabe erscheint im Feld Vorschau.
- Klicken Sie auf Speichern.
Wie Sie den Code einer App schreiben, beschreibt Apps entwickeln.
Aufbau einer App
Jede App besteht aus:
| Bestandteil | Beschreibung |
|---|---|
| Name | Anzeigename in der Seitenleiste und in den Einstellungen |
| Slug | Pflichtfeld. Eindeutiger technischer Bezeichner (z.B. mein-dashboard), der in der URL verwendet wird. Erlaubt sind nur Buchstaben, Ziffern, Bindestrich und Unterstrich — keine Leerzeichen, Umlaute oder Punkte. Wenn Sie den Slug später ändern, ändert sich auch die Adresse der App; bestehende Links und Lesezeichen funktionieren dann nicht mehr |
| Beschreibung | Optionale Beschreibung des Zwecks der App |
| Anbieter | Optional: Wer die App erstellt hat |
| App-Symbol | Optional: Symbol der App auf den App-Karten. Nur als SVG-Datei möglich |
| Zugriff | Optional: Beschränkt die App auf ausgewählte Teams (siehe Zugriff auf Teams beschränken) |
| Code | Der Code, der bei Aufruf ausgeführt wird (Python, Node.js oder PHP). Technisch heißt dieser Teil „Executor“ |
Schritte im Bearbeitungsfenster
Eine bestehende App hat vier Schritte:
- Spezifikationen — Name, Slug, Beschreibung, Anbieter und weitere Eigenschaften der App
- Code — der Code der App mit Vorschau
- Daten — die Einträge, die die App im App Storage abgelegt hat
- Versionshistorie — frühere Versionen der App, die sich wiederherstellen lassen
Im Schritt Spezifikationen laden Sie unter Erscheinungsbild über SVG hochladen ein App-Symbol hoch; mit Entfernen löschen Sie es wieder.
Zugriff auf Teams beschränken
Standardmäßig steht eine App allen Benutzern mit der Berechtigung readApps zur Verfügung. Im Schritt
Spezifikationen können Sie das unter Zugriff einschränken: Aktivieren Sie
Zugriff auf ausgewählte Teams beschränken und wählen Sie unter Teams mit Zugriff die Teams aus.
Dabei gilt:
- Nur Mitglieder der ausgewählten Teams sehen und öffnen die App.
- Wer keinem Team angehört, sieht eine beschränkte App nicht.
- Benutzer, die Apps erstellen oder verwalten dürfen (
appCreator,manageApps), sehen immer alle Apps. - Die Teamauswahl wird beim Export nicht mitgenommen. Nach einem Import in eine andere Umgebung legen Sie sie dort neu fest.
App bearbeiten und Versionshistorie
Ungespeicherte Änderungen zeigt ein Entwurf-Tag neben dem betroffenen Schritt im Bearbeitungsfenster an. Wenn Sie die Seite mit ungespeicherten Änderungen verlassen, erscheint eine Warnung.
Jedes Speichern legt eine neue Version der App an. Im Schritt Versionshistorie sind alle gespeicherten Versionen mit ihrem Autor aufgelistet. Klappen Sie eine Version auf, um zu sehen, was sich gegenüber der vorigen Version geändert hat.
Um zu einer früheren Version zurückzukehren, klicken Sie bei dieser Version auf Wiederherstellen und bestätigen im Fenster Wiederherstellung bestätigen.
Warning
Die wiederhergestellte Version ist sofort aktiv und wird allen Benutzern angezeigt.
App löschen
- Öffnen Sie die App und klicken Sie im Schritt Spezifikationen auf Löschen.
- Bestätigen Sie die Rückfrage „Möchten Sie die App wirklich löschen?“.
Zum Löschen benötigen Sie die Berechtigung manageApps. Benutzer, die nur appCreator haben, sehen
die Schaltfläche zwar, erhalten beim Löschen aber eine Fehlermeldung.
Export und Import
Über Export und Import übertragen Sie eine App zum Beispiel von einer Testumgebung in die Produktivumgebung.
Exportieren:
- Öffnen Sie die App und klicken Sie im Schritt Spezifikationen auf Exportieren.
- Im Fenster App exportieren wird die App als JSON angezeigt. Klicken Sie auf In Zwischenablage kopieren.
Importieren:
- Klicken Sie unter Einstellungen → Integration in Umsysteme → Apps auf Importieren.
- Fügen Sie im Fenster App importieren das kopierte JSON ein und klicken Sie auf Importieren.
Der Import legt immer eine neue App an, die mit Version 1 beginnt. Die Versionshistorie und die Teamauswahl der ursprünglichen App werden nicht übernommen.
App Store
Im App Store finden Sie fertige Apps von Enneo, die Sie ohne eigenen Code nutzen können. Er befindet sich unter Einstellungen → Integration in Umsysteme → Apps, unterhalb der Installierten Apps.
Zu jeder App sehen Sie Anbieter, Version, Preis, Sprache und Zweck. Über die Schaltflächen oberhalb der Liste filtern Sie nach Zweck; Alle zeigt wieder das gesamte Angebot.
Installieren und Deinstallieren
- Installieren legt die App als normale App in Ihrem Workspace an. Sie erscheint anschließend unter Installierte Apps, und im App Store ist sie als Installiert gekennzeichnet.
- Eine installierte App bearbeiten Sie wie jede andere App — zum Beispiel, um den Zugriff auf Teams zu beschränken.
- Deinstallieren löscht die App wieder aus Ihrem Workspace.
Für das Installieren und Deinstallieren benötigen Sie die Berechtigung manageApps.