Direkt zum Hauptinhalt

Modellgesteuerte App erstellen oder bearbeiten

Ziel​

Eine modellgesteuerte App erstellen – eine benannte App, die eine ausgewählte Menge von Tabellen, Studio-Bildschirmen und Berichten der Umgebung zu einer Navigation (Sitemap) mit einer Startseite zusammenfasst, bereit zum Öffnen in der Plattform-Shell – oder Namen, Navigation oder Startseite einer vorhandenen App ändern.

Voraussetzungen​

  • Sie sind mit einer Erstellerrolle (oder als Plattformadministrator) angemeldet.
  • Die Tabellen, die die App anzeigen soll, sind in der Umgebung bereits vorhanden (siehe „Entität erstellen“), ebenso alle Studio-Bildschirme („Studio-App zeichnen“) oder Berichte („Bericht erstellen“), die in ihre Navigation sollen.
  • Sie kennen das Präfix des besitzenden Herausgebers (zum Beispiel par). Der logische Name der App muss mit diesem Präfix beginnen.

Schritte​

  1. Wählen Sie in der linken Seitenleiste über die Umgebungs- und Lösungsauswahl die Umgebung, in der Sie arbeiten, und die Lösung, zu der die App gehört. Das Präfix des besitzenden Herausgebers erscheint darunter (zum Beispiel par_); die App erhält es als Namensraum.
  2. Öffnen Sie Apps über die Navigation der Seitenleiste. Die Seite zeigt die Apps der Umgebung als Liste.
  3. Wählen Sie Neu, um eine App zu erstellen, oder wählen Sie die Zeile einer vorhandenen App und dann Bearbeiten, um sie zu ändern. In beiden Fällen öffnet sich am Bildschirmrand ein Bereich mit den Details der App.
  4. Geben Sie einen Anzeigenamen ein (zum Beispiel Sales).
  5. Geben Sie bei einer neuen App einen logischen Namen ein, der mit dem Präfix des Herausgebers beginnt – zum Beispiel par_sales_app. Beim Bearbeiten einer vorhandenen App wird der logische Name angezeigt, kann aber nicht geändert werden.
  6. Geben Sie optional eine Beschreibung (sie erscheint auf der Startkachel der App) und einen Symbolschlüssel ein.
  7. Bauen Sie die Navigation der App auf. Jede Navigationsgruppe hat einen Titel und darunter eine Reihe von Schaltflächen – eine pro Zielart: Tabelle zur Navigation hinzufügen, Bericht zur Navigation hinzufügen und Bildschirm zur Navigation hinzufügen. Jede Schaltfläche öffnet eine durchsuchbare Liste dieser Art; tippen Sie, um sie nach dem Namen, den Sie dem Ziel gegeben haben, oder nach seinem logischen Namen einzugrenzen, und wählen Sie dann einen Eintrag aus, um ihn zu platzieren. Eine Schaltfläche erscheint nur, wenn die Umgebung etwas dafür hat; eine Umgebung ohne Berichte zeigt also keine Berichtsschaltfläche. Jedes platzierte Element kann optional eine überschriebene Beschriftung und ein Symbol erhalten und kann entfernt werden. Um die Elemente einer Gruppe neu anzuordnen, ziehen Sie eine Zeile am Griff an ihrer vorderen Kante – die Reihenfolge, in der Sie sie hinterlassen, ist die Reihenfolge in der Navigation der App. Ohne Maus: Setzen Sie den Fokus auf den Griff, drücken Sie Space, um die Zeile aufzunehmen, verschieben Sie sie mit den Pfeiltasten, und drücken Sie erneut Space, um sie abzulegen. Wählen Sie Gruppe hinzufügen, um eine weitere Navigationsgruppe hinzuzufügen.
  8. Wählen Sie optional aus, welche Formulare und Ansichten diese App für eine platzierte Tabelle anbietet – siehe Auswählen, was die App für eine Tabelle anbietet weiter unten. Unter dem Namen jeder platzierten Tabelle gibt die Zeile an, was die App derzeit anbietet („3 Formulare · 2 Ansichten“ oder „2 von 5 Formularen“, sobald Sie eine Liste eingegrenzt haben), und die Schaltfläche mit den Schiebereglern öffnet die Auswahl. Die Zeile eines Dashboards oder eines Berichts gibt stattdessen an, welche der drei Arten es ist, und hat keine Schieberegler-Schaltfläche: Keines von beiden hat Formulare oder Ansichten zur Auswahl.
  9. Wählen Sie die Startseite der App – was sich öffnet, wenn ein Benutzer die App startet, und wohin der Eintrag Start der Leiste führt. Das kann eine Tabelle, ein Studio-Bildschirm oder ein Bericht sein, und die Liste bietet nur an, was Sie in der Navigation platziert haben. Mit einem Bildschirm hier öffnet sich eine App mit aktuellen Kennzahlen statt mit einem Raster aus Zeilen.
  10. Wählen Sie App hinzufügen (bzw. Speichern beim Bearbeiten). Der Bereich schließt sich, und die Liste wird mit Ihren Änderungen aktualisiert.
  11. Geben Sie die App den Personen, die sie verwenden werden. Eine App zu erstellen heißt nicht, sie freizugeben: Eine neue App ist für Ersteller und Administratoren sichtbar und für sonst niemanden. Wählen Sie die Zeile der App und dann Freigeben – siehe App für die Personen freigeben, die sie verwenden.

Bildschirme und Berichte in einer App​

Ein Navigationselement ist ein Ziel, und es gibt drei Arten:

  • Eine Tabelle öffnet ihre Liste und die Datensätze, Ansichten und Formulare dahinter.
  • Ein Studio-Bildschirm nimmt den gesamten Inhaltsbereich ein – was Sie gezeichnet haben, ist der Bildschirm.
  • Ein Bericht öffnet die Berichtsanzeige über die gesamte Tabelle, druckbereit. (Ein Bericht, der aus dem Formular eines Datensatzes oder der Befehlsleiste einer Ansicht ausgeführt wird, übernimmt diesen Datensatz bzw. diesen Filter; einer, der aus der Navigation geöffnet wird, nicht, weil nichts auf dem Bildschirm ist, das er übernehmen könnte.)

Jedes hat eine eigene Adresse, sodass jedes als Lesezeichen gespeichert, geteilt, aktualisiert und angeheftet werden kann: /apps/{app}/{table}, /apps/{app}/dashboard/{name}, /apps/{app}/report/{name}.

Wer eines öffnen darf, ist eine Berechtigung. Einen Bildschirm zu öffnen und einen Bericht auszuführen sind Berechtigungen, die eine Sicherheitsrolle wie jede andere Berechtigung erteilt. Ein Benutzer ohne diese Berechtigung sieht das Element in der Leiste und erhält den Hinweis, dass er es nicht öffnen darf, statt die Zahlen eines anderen zu sehen. Unabhängig davon wird alles, was die Datensätze eines Bildschirms und eines Berichts lesen, nach den eigenen Datensatzberechtigungen des Lesers gefiltert – zwei Personen, die denselben Bildschirm öffnen, sehen also jeweils die Datensätze, die sie sehen dürfen.

Dashboards sind eingestellt

Die Plattform bot früher ein Dashboard – ein Raster aus KPI-, Diagramm- und Ansichts-Widgets – als vierte Zielart an, und das Application Studio hat es ersetzt: Ein gezeichneter Bildschirm kann alles, was ein Dashboard konnte, und er ist die Arbeitsfläche, die Sie ohnehin gerade lernen. Es gibt daher keine Dashboard-Liste, keinen Dashboard-Designer und keine Schaltfläche Dashboard hinzufügen. Eine App, die bereits eines benennt, öffnet es weiterhin, und seine Berechtigung gilt weiter – nichts Gespeichertes hat sich geändert –, aber ein neues wird als Studio-Bildschirm gezeichnet. Siehe Studio-App zeichnen.

Auswählen, was die App für eine Tabelle anbietet​

Eine Tabelle sammelt im Laufe ihres Lebens Formulare und Ansichten an – ein Administratorformular neben dem, das ein Vertriebsmitarbeiter verwendet, eine Ansicht „Meine offenen Elemente“, die nur für ein Team relevant ist. Eine App, die jedes davon anzeigt, macht aus einer aufgeräumten Tabelle eine überladene App.

Wählen Sie die Schieberegler-Schaltfläche in der Zeile einer platzierten Tabelle (Formulare und Ansichten für Tabelle), um die Auswahl zu öffnen. Jede Liste ist entweder:

  • Jedes Formular dieser Tabelle, auch später hinzugefügte – die App folgt der Tabelle. Ein Formular, das Sie morgen zur Tabelle hinzufügen, erscheint automatisch in dieser App.
  • Nur die unten ausgewählten – eine feste Auswahl. Ein danach zur Tabelle hinzugefügtes Formular erscheint nicht in dieser App, bis Sie zurückkommen und es aktivieren.

Genau dieser Unterschied ist der Grund, warum es beides gibt, und er entspricht nicht dem Aktivieren aller Kontrollkästchen: Ein Ersteller, der die Formulare einer App kuratiert hat, möchte selten, dass das nächste unangekündigt darin auftaucht, und ein Ersteller, der nichts kuratiert hat, möchte das immer. Der Wechsel zu Nur die ausgewählten beginnt mit allen aktivierten Einträgen, sodass Sie entfernen, was Sie nicht möchten, statt die Liste neu aufzubauen.

Alle Häkchen zu entfernen blendet die Tabelle nicht aus – eine Tabelle ohne Formular ließe sich nicht öffnen –, daher wird das als „jedes“ gespeichert, und der Dialog weist darauf hin, solange Sie in diesem Zustand sind.

Die Auswahl bestimmt, welche Formulare und Ansichten die App anbietet, nicht deren Reihenfolge oder welches zuerst geöffnet wird. Das bleibt Sache der Tabelle.

Die Zähler unter dem Tabellennamen verraten den Zustand, ohne den Dialog zu öffnen: 3 Formulare · 2 Ansichten ist eine Tabelle, der die App folgt, und 2 von 5 Formularen ist eine Liste, die Sie festgelegt haben.

Eine lange Navigation in Bereiche aufteilen​

Neben dem Titel jeder Gruppe steht ein Feld Bereich. Geben Sie Gruppen denselben Bereich – Empfang für Buchungen und Kunden, Einstellungen für die Konfiguration –, und sobald zwei oder mehr Bereiche benannt sind, zeigt die Navigation der App jeweils einen Bereich, mit einem Umschalter an ihrem Fuß. Lassen Sie das Feld leer für eine Gruppe, die jeder Bereich zeigen soll, etwa eine Startseite oder Heute. Ohne Bereiche bleibt die Navigation unverändert.

Was im Hintergrund passiert​

Die App wird als Metadaten gespeichert, die auf diese Umgebung beschränkt sind und das Präfix des Herausgebers als Namensraum tragen, als Komponente der ausgewählten Lösung. Ihre Navigation verweist auf jedes Ziel über Art und Namen; vor dem Speichern prüft die Plattform, ob jede referenzierte Tabelle, jedes Dashboard und jeder Bericht existiert – in dem Speicher, den seine Art benennt – und ob die Startseite eines der Ziele der Navigation ist. Die App selbst enthält keine Daten: Sie ist eine kuratierte Sicht auf die Komponenten der Umgebung.

Fehlerbehebung​

  • „… must be lower snake-case and start with the publisher prefix.“ – Der logische Name muss mit {prefix}_ beginnen und darf nur Kleinbuchstaben, Ziffern und Unterstriche enthalten.
  • „Entity … is not defined in this environment.“ – Eine Tabelle der Navigation existiert in dieser Umgebung nicht; erstellen Sie die Tabelle zuerst, oder entfernen Sie sie aus der Navigation.
  • „Dashboard … is not defined in this environment.“ (oder Report …) – Die Navigation nennt eines, das gelöscht oder hier nie importiert wurde. Erstellen Sie es, importieren Sie es, oder entfernen Sie das Element.
  • „The home page … must appear in the app's navigation.“ – Wählen Sie eine Startseite, die Sie der Navigation hinzugefügt haben. Eine Startseite, zu der niemand zurücknavigieren kann, ist ein Bildschirm ohne Zugang, sobald der Benutzer irgendwo anders hingeklickt hat.
  • „An app named … already exists in this environment.“ – Wählen Sie einen anderen logischen Namen; logische Namen von Apps sind innerhalb einer Umgebung eindeutig.
  • „You do not have permission to open the dashboard …“ (oder … run the report …) – Das Ziel existiert, aber Ihre Sicherheitsrolle hat keine Berechtigung dafür. Ein Administrator erteilt <name>.Open für ein Dashboard oder <name>.Run für einen Bericht, oder den Platzhalter *.Open / *.Run, der alles abdeckt, was künftig erstellt wird.
  • „Form … is not defined on entity …“ (oder View …) – Die App wählt ein Formular oder eine Ansicht aus, die die Tabelle nicht mehr hat, meist weil sie nach dem Erstellen der App umbenannt oder gelöscht wurde. Öffnen Sie den Dialog Formulare und Ansichten der Tabelle, und aktivieren Sie die aktuellen.
  • Ein Formular, das ich einer Tabelle hinzugefügt habe, erscheint nicht in einer App. – Diese App wählt bestimmte Formulare aus, sodass ein neues erst enthalten ist, wenn Sie es hinzufügen. Die Zeile zeigt dann „2 von 5 Formularen“ statt einer einfachen Anzahl. Öffnen Sie die App, wählen Sie die Schaltfläche Formulare und Ansichten der Tabelle, und aktivieren Sie entweder das neue Formular, oder stellen Sie die Liste wieder auf jedes Formular dieser Tabelle um.

Verwandte Szenarien​

  • App für die Personen freigeben, die sie verwenden.
  • Entität erstellen.
  • Formular erstellen.
  • Ansicht erstellen.
  • Bericht erstellen.