AppBuilder Assistent

  • Der AppBuilder Assistent leitet den Benutzer Schritt für Schritt durch die Erstellung oder Bearbeitung eines Elements.

    Der AppBuilder Assistent (Abbildung 1) ist Teil des AppBuilders und wird zum Bearbeiten eines Elements benötigt. Am unteren Rand des Assistenten kann zwischen den drei Abschnitten Listen/Formulare/Menü gewechselt werden indem zurück und nächster angeklickt wird. Alternativ können die Abschnitte am oberen linken Rand direkt ausgewählt werden.


    Abbildung 1: App-Builder Assistent


    Die Tabelle Elementfelder kann über den Button Elementfelder am unteren Rand erneut aufgerufen werden (siehe Abbildung 1 unten).

    Über den Menüeintrag Dateispeicher, welcher über die drei Punkte oben rechts in Abbildung 1 aufgerufen werden kann, wird der Dialog Dateispeicher aufgerufen (Abbildung 2).

    Über diesen Dialog kann ein vorhandener Dateispeicher angebunden werden (zur Einrichtung siehe Dateispeicher).


    Abbildung 2: Einstellung Dateispeicher bezogen auf ein Element


    Das Feld Dateinamenfeld muss auf ein Feld verweisen, welches den Dateiname inkl. der Dateiendung enthält (z.B. "Bild.png"). Der Eintrag Speicherpfad ermöglicht es dynamische Pfade zu vergeben, dazu steht ein Editor zur Verfügung, welcher über den Button Speicherpfad am unteren Rand aufgerufen werden kann. Einschränkungen auf den Zugriff der Dateien können über SQL-Zugriffsfilter erfolgen.

    Wichtiger Hinweis: Wird dieser Zugriffsfilter nicht gesetzt können alle angemeldeten Benutzer auf diese Dateien zugreifen.


    Beim Speichern der Einstellungen des Dateispeichers wird im Hintergrund ein neues Feld für die Kategoriefelder der Formulare bereitgestellt. Das Feld hat den Namen ExtDoc und die Bezeichnung Dokument. Weitere Informationen wie dieses spezielle Feld verwendet werden kann ist unter "Assistent/Formulare > Kategoriefelder" zu finden.

    1 Assistent/Listen

    Die Tabelle Listen oben Links in Abbildung 1 muss mindestens eine Liste enthalten. Diese Tabellen-Liste ist zentral bei dem Assistent-Dialog. Wird an dieser Stelle eine Liste ausgewählt, hat diese Auswahl Auswirkungen auf alle weiteren Tabellen des AppBuilder Assistenten.


    Eine Liste braucht zwingend Listenfelder (falls keine Detaillisten vorhanden sind), welche über den Button Hinzufügen ausgewählt werden können. Die in dem Dialog Hinzufügen verfügbaren Elementfelder entsprechen den Feldern, welche von der Datenbank zur Verfügung gestellt werden (siehe Elementfelder). Sobald die gewünschten Elementfelder den Listenfeldern hinzugefügt wurden, kann eine Vorschau über die Tabelle Listen erzeugt werden. Die Vorschau kann über das Symbol mit der Lupe aufgerufen werden. Wird in der Tabelle Listen eine zweite Liste angelegt, enthält diese Liste wiederum eigene Listenfelder und Berechtigungen.


    Hinweis: Die im Assistenten angezeigten Listenfelder bestimmen letztendlich welche Felder beim Aufruf einer App angezeigt werden. Felder können bei Bedarf aber auch ausgeblendet werden, wenn Listenfelder z.B. nur für eine Filterung verwendet werden sollen.

    1.1 Listen

    In Abbildung 3 sind zwei verschiedene Listen zu sehen, wovon die erste Liste ausgewählt ist. Die jeweils ausgewählte Liste hat Auswirkungen auf die Tabelle Berechtigungen und die Tabelle Listenfelder.


    Abbildung 3: AppBuilder Assistent mit zwei Listen.


    Für die Tabelle Listen ist folgende Funktionalität vorhanden:


    Neu:

    Wird eine Liste neu hinzugefügt (oder bearbeitet) können folgende Einstellungen bearbeitet werden:

    • Aktivieren/Deaktivieren von Neu, Bearbeiten und Löschen für die Liste. Werden diese Optionen ausgewählt muss zudem eine Zieltabelle angelegt werden, damit das Zurückschreiben der Daten funktionieren kann. Was dabei beachtet werden muss ist in dem Video: "Neu, Bearbeiten, Löschen aktivieren mit dem AppBuilder" zu sehen.
    • Layout (Tabelle, Liste, Kacheln, Karte): Die Darstellung und Vorteile des jeweiligen Layouts sind in dem Lexikon-Eintrag zu den Apps zu finden.
    • Inline-Bearbeitung: Die Felder in einer Liste können direkt in der Liste bearbeitet werden, ohne vorher den Bearbeiten-Dialog aufzurufen (Abbildung 4).
    • SQL-Filter können verwendet werden, um in Verbindung mit Parametern den Benutzerzugriff einzuschränken. Dazu kann der Editor, der über den Button am unteren Rand des Dialogs verfügbar ist, verwendet werden. In einem Video von LogiSoft wird dieses Feld anhand eines Beispiel-Videos erklärt. Auf das Feld SQL-Filter wird ab Minute 1:20 eingegangen. Für den Eintrag muss SQL-Syntax verwendet werden.

    Abbildung 4: Inline-Bearbeitung eines Feldes innerhalb einer Liste


    _Funktionen (Drop-Down-Menü):

    • Liste bearbeiten (Symbol: Stift)
    • Liste löschen (Symbol: Mülleimer)
    • Liste duplizieren (Symbol: Zwei Rechtecke)
    • Ereignisse (Symbol: Blitz): Zu bestimmten Ereignissen wie z.B. "Nach Neuanlage eines neuen Datensatzes" können SQL-Anweisungen hinterlegt werden. Weitere Infos zu dem Ereignisfeld sind in dem YouTube-Video: Ereignisse und Standardwerte mit dem AppBuilder speziell ab Minute 1:15 vorhanden.
    • Aktionen (Symbol: Hand): Zu den Listen können verschiedene Aktionen ausgeführt werden, welche dann in der jeweiligen App über einen Button oder das Kontextmenü ausgeführt werden können. Mögliche Aktionen sind:
      • SQL-Anweisungen (Abbildung 5).
      • die Ausführung eines Links (Abbildung 5)
      • der Export der Liste als CSV-Datei (Abbildung 6)
      • das Öffnen einer Datei aus dem Dateispeicher
      • Zusätzlich können die Berechtigungen für die Ausführung einer Aktion festgelegt werden und eine Sicherheitsfrage hinterlegt werden. Die Sicherheitsfrage wird dann vorab bei sensiblen Aktionen ausgelöst und ermöglicht zudem einen individuellen Text wie z.B.: "Möchten Sie den Datensatz wirklich löschen?"
      • Soll eine Aktion nur für bestimmte Datensätze zur Verfügung stehen, kann das in dem Feld SQL-Bedingung definiert werden
    • _Bedingte Formatierung (Symbol: Farb-Fächer): Mit Hilfe der bedingten Formatierung können anhand von SQL-Bedingungen (Abbildung 7) folgende Formatierungen vorgenommen werden
      • Einfärbung der Zeile
      • Einfärbung des Feldwertes
      • Symbol vor dem Feldwert
      • Symbol nach dem Feldwert

    Die bedingten Formatierungen werden in der Tabellenansicht, Kachelansicht und Listenansicht dargestellt (Abbildung 8). Gibt es mehrere Bedingungen können diese über die Reihenfolge der Tabelleneinträge priorisiert werden.


    Abbildung 5: Hyperlinks und SQL-Befehle über die das Funktionsmenü und das Kontextmenü aufrufen.



    Abbildung 6: Export der Liste als CSV-Datei (Ansicht App)


    Abbildung 7: Neuer Eintrag für die bedingte Formatierung



    Abbildung 8: Bedingte Formatierung in der Tabellenansicht (Ansicht App).



    Vorschau:

    Die Vorschau einer Liste zeigt die Datenansicht wie sie nach dem Veröffentlichen der App zur Verfügung gestellt wird.


    1.2 Berechtigungen

    Die Tabelle Berechtigungen beinhaltet die Rollen über welche der Zugriff auf die Listen erlaubt wird.

    • Hinzufügen (Symbol: Plus) - Hier können bestehenden Rollen hinzugefügt werden (siehe Benutzerverwaltung)
    • Bearbeiten (Symbol: Stift) - Hier kann festgelegt werden welchen Zugriff (Neu, Bearbeiten, Löschen) die Rollen ermöglichen.
    • Löschen (Symbol: Mülleimer) - Hier können bestehende Berechtigungen aus der Tabelle gelöscht werden.

    1.3 Listenfelder

    Die Tabelle Listenfelder verwaltet alle Listenfelder welche in der Benutzeransicht als Spalten erscheinen sollen.

    Für die Tabelle Listenfelder ist folgende Funktionalität in der Funktionsleiste vorhanden:

    • Hinzufügen (Symbol: Plus)
    • Bearbeiten über Drop-Down-Menü _Funktionen (Symbol: Stift)
    • Löschen über Drop-Down-Menü _Funktionen (Symbol: Mülleimer)
    • Reihenfolge ändern (Symbol: Pfeile)

    Wird ein Listenfeld bearbeitet, können folgende Einstellungen vorgenommen werden:

    • Bezeichnung
    • Ausblenden: Gibt an ob die Spalte in der Liste ausgeblendet werden soll.
    • Sortier-Reihenfolge: Hier muss eine Nummer beginnend bei 1 eingetragen werden, um so die Reihenfolge der Sortierung zu bestimmen. Je kleiner die Nummer desto höher ist die Priorisierung bei der Sortierung. Wird dort z. B. eine 1 eingetragen wird die Liste zuerst nach dieser Spalte sortiert, dann nach der Spalte mit dem Eintrag 2 usw.
    • Sortierung: Gibt die Art der Sortierung an (Absteigend/Aufsteigend)
    • Gruppier-Reihenfolge: Analog zu der Sortier-Reihenfolge nur das hier die Reihenfolge der Gruppierung festgelegt wird.
    • Aggregat-Funktion: Hier kann eine Funktion ausgewählt werden, welche auf die Daten der Spalte angewendet wird und deren Ergebnis im Fußbereich der Tabelle angezeigt wird. Zur Verfügung stehen die _Funktionen: Summe, Minimum, Maximum, Durchschnitt und Anzahl.
    • Editierbar: Binäre Einstellung ob das Listenfeld bearbeitet werden darf.
    • Funktion: Der Eintrag Funktion ist eine spezielle Angabe, um zusätzliche Ansichten oder Funktionalitäten über die Benutzeroberfläche bereitzustellen. Aktuell existieren folgende Gruppen von Listenfeldern :
      • Listenfelder ohne Funktion (Standard). Diese Listenfelder haben keinen Eintrag in dem Feld Funktion.
      • Listenfelder, um das Einbinden der Kartenansicht zu ermöglichen: Karte.Strasse, Karte.Land, Karte.Postleitzahl, Karte.Ort, Karte.Breitengrad, Karte.Längengrad
      • Listenfelder, um das Einbinden von URL-Schemes für Telefon und E-Mail zu ermöglichen: Anruf.Telefonnummer, EMail.Adresse.
        • URL-Schemes ermöglichen es direkt aus dem Browser heraus z.B. das Email-Programm aufzurufen, falls es sich um eine Mail-Adresse handelt und mit dem entsprechenden URL-Scheme versehen wurde
      • Listenfelder, um das Einbinden der Kalenderansicht zu ermöglichen: Kalender.Startdatum, Kalender.Enddatum, Kalender.Text (Anzeigetext im Kalender), Kalender.Farbe (Angabe einer Bezeichnung)
        • Einträge mit der gleichen Bezeichnung erhalten eine zufällige aber gleiche Farbe im Kalender. Individuelle Farben pro Bezeichnung sind nicht möglich)
    • Linkfeld: Hier stehen Listenfelder zur Auswahl welche über die Benutzeroberfläche als Link ausgegeben werden. Das Listenfeld muss daher eine URL beinhalten

    Wenn in Abbildung 3 auf den Button nächster geklickt wird, wird der nächste Tab im Assistenten aufgerufen: Assistent/Formulare (siehe nächster Abschnitt).


    2 Assistent/Formulare

    Um einen Bezug zu der Benutzeransicht (App) herzustellen ist an dieser Stelle Abbildung 9 eingefügt. Die Abbildung zeigt eine mit dem AppBuilder erstellten Liste.


    Abbildung 9: Eine Liste von einer App wie sie dem Benutzer angezeigt wird.


    Ein Formular ist z.B. die Detailansicht einer Liste. In Abbildung 9 ist zu erkennen, dass die erste Zeile ausgewählt ist. Wird nun über das Kontextmenü oder den Button Details die Detailansicht aufgerufen, ist dort das im AppBuilder erstellte Formular zu finden (Abbildung 10).


    Abbildung 10: Beispiel Detailansicht


    Abbildung 11: AppBuilder Assistent Formulare


    Zurück im AppBuilder ist in Abbildung 11 im unteren Bereich die Tabelle Detaillisten aufgeführt. Detaillisten können Listen von anderen Elementen einbinden und in einem Formular anzeigen. Zu dem Thema Detaillisten wurde von LogiSoft ein Video veröffentlicht: Master-Detail mit dem AppBuilder. Wobei als Master die Liste eines Elements verstanden wird (z. B. eine Liste wie in Abbildung 9) und Detail als eine Detailliste verstanden wird die in ein Formular eingebettet ist (z. B. Abbildung 10 unten).


    Grundsätzlich kann pro Element nur in eine Zieltabelle (Zieltabelle siehe Abbildung 9, Abschnitt Elemente) zurückgeschrieben werden, aber über die Detaillisten können weitere Listen eingebunden werden, um so in weitere Liste zurückzuschreiben. Die in Abbildung 10 dargestellten Ansprechpartner können also bearbeitet werden obwohl es sich um eine andere Tabelle handelt als in dem Feld Zieltabelle des Master-Elements angegeben.

    2.1 Formulare

    Die Tabelle Formulare hat folgende Optionen:

    • Neu (Symbol: Plus)
    • Bearbeiten über Drop-Down-Menü _Funktionen (Symbol: Stift)
    • Löschen über Drop-Down-Menü _Funktionen (Symbol: Mülleimer): Nur vorhanden, wenn das Formular "Benutzerdefiniert" ist
    • Duplizieren über Drop-Down-Menü _Funktionen (Symbol: Rechtecke): Nur vorhanden, wenn das Formular "Benutzerdefiniert" ist.
    • Aufwärts/Abwärts (Symbol: Pfeile): Beeinflusst die Reihenfolge, in der die Buttons angezeigt werden
    • Vorschau (Symbol: Lupe): Anzeige der Liste mit Funktionsleiste um so den Auruf der Formulare zu ermöglichen.

    Wird ein Formular bearbeitet oder neu angelegt stehen folgende Felder zur Verfügung;

    • Bezeichnung: Die Bezeichnung zusammen mit dem Icon definieren den Button der den Zugriff auf das Formular, z.B. aus dem Portal heraus, darstellt.
    • Beschreibung: Optional
    • Größe: Die Größe des Fensters in dem das Formular geöffnet wird.
    • Mehrfachänderung: Kann bei benutzerdefinierten Formularen aktiviert werden, um mehrere Datensätze gleichzeitig zu bearbeiten (siehe Abbildung 12). Werden die Reihen ausgewählt und bearbeitet, werden die Änderungen in diesem Feld für alle ausgewählten Reihen übernommen.
    • Icon: Siehe erster Punkt (Bezeichnung). Die grafische Darstellung des Formulars.

    Abbildung 12: Mehrfachänderung

    2.2 Kategorien

    Mittels der Kategorien können die Formulare übersichtlich gestaltet werden (Abbildung 13). Die Kategorien werden durch die in Abbildung 13 zu sehenden horizontalen grauen Balken dargestellt, welche unterhalb die zugeordneten Kategoriefelder und Detaillisten beinhalten. Die Kategorien können zudem über das das rechte Symbol innerhalb von dem grauen Balken ein- und ausgeklappt werden.


    Abbildung 13: Formular mit mehreren Kategorien (graue einklappbare horizontale Balken)


    Die Tabelle Kategorien hat folgende Optionen:

    • Neu (Symbol: Plus)
    • Bearbeiten (Symbol: Stift)
    • Löschen (Symbol: Mülleimer)
    • Aufwärts/Abwärts (Symbol: Pfeile): Bestimmt die Position innerhalb eines Formulars.

    Wird eine Kategorie neu angelegt oder bearbeitet stehen folgende Felder zur Verfügung:

    • Bezeichnung: Wird in dem Formular angezeigt (siehe Abbildung 13 oben)
    • Beschreibung: Optional
    • Aufklappen: Bestimmt ob die Kategorie beim Öffnen des Formulars geöffnet oder geschlossen ist
    • Position: Gibt die Position der gesamten Kategorien an. Standardmäßig werden die Kategorien untereinander dargestellt, alternativ können die Kategorien auch nebeneinander dargestellt werden
    • Anordnung: Gibt die Anordnung von Feldbeschriftung und Wert der Datensätze innerhalb der Kategorie an. In Abbildung 14 ist die Anordnung der oberen Kategorie nebeneinander und die der unteren Kategorie untereinander.
    • Registrierkarte: Kategorien mit dem gleichen Wert in dem Feld Registrierkarte werden in einer Registrierkarte zusammengefasst (Abbildung 14 oben: Registrierkarten Ansprechpartner und Details)


    Abbildung 14: Darstellung der Kategorien innerhalb von einem Formular


    2.3 Kategoriefelder

    Eine Liste muss mindestens ein Kategoriefeld enthalten. Eine Ausnahme besteht, wenn eine Detailliste vorhanden ist, dann darf die Tabelle Kategoriefelder auch leer sein. Die Kategoriefelder können immer nur einer Kategorie zugeordnet sein. Wenn ein Kategoriefeld bereits einer Kategorie hinzugefügt wurde, kann dieses Kategoriefelder keiner weiteren Kategorie hinzugefügt werden.

    Die Tabelle Kategoriefelder hat folgenden Optionen:

    • Hinzufügen (Symbol: Plus)
    • Bearbeiten (Symbol: Stift)
    • Löschen (Symbol: Mülleimer)
    • Aufwärts/Abwärts (Symbol: Pfeile): Ändern der Reihenfolge eines Kategoriefeldes innerhalb von einem Formular

    Wird ein Kategoriefeld bearbeitet können folgende Einstellungen vorgenommen werden:

    • Bezeichnung: Wird als Bezeichnung in dem Formular angezeigt
    • Sichtbar: Bestimmt ob das Kategoriefeld in dem Formular angezeigt wird
    • Editierbar: Bestimmt ob die Kategoriefelder in der Spalte bearbeitet werden dürfen
    • Reihen: Anzahl der verfügbaren Reihen in einem Eingabefeld. Nummerischer Wert > 1
    • Tooltip: Ein kurzer Text, der angezeigt wird wenn mit der Maus über das Feld gehovert wird
    • Funktion: Dieses Feld unterscheidet sich zu dem Feld _Funktionen aus den Listen. Hier werden nur spezielle _Funktionen aufgeführt. Diese _Funktionen können dazu verwendet werden bei der Neu-Anlage eines Datensatzes die Längen- und Breitengerade automatisch zu ermitteln. Wie sich diese _Funktionen unterscheiden ist im UI des AppBuilders als Beschreibungstext beschrieben.

    Hinweis zur Einbindung von Dateien: Zu der Tabelle Kategoriefelder kann ein spezielles Kategoriefeld zur Darstellung von Daten hinzugefügt werden. Sobald ein Dateispeicher bereitgestellt wurde ist ein zusätzliches Kategoriefeld mit dem Namen ExDoc und der Bezeichnung Dokument verfügbar. Wird dieses Kategoriefeld einem Formular hinzugefügt ist die über den Pfad erreichbare Datei in das Formular eingebunden und wird in dem Formular einer App entsprechend dargestellt (siehe Abbildung 15).


    Ist die Neuanlage erlaubt können über das Formular Dateien

    • mit einer maximalen Größe von 64 MB hinzugefügt werden.
    • ein Dateiname muss den folgenden Namensregeln entsprechen:
      • kann eine beliebige Kombination von Zeichen enthalten.
      • muss mindestens ein Zeichen lang sein und darf nicht länger als 256 Zeichen sein.
      • es wird zwischen Groß- und Kleinschreibung unterschieden.


    Abbildung 15: Anzeige Datei


    2.4 Detaillisten

    Die Tabelle Detaillisten kann weitere Listen einbinden. In Abbildung 10 sind zum Beispiel die Ansprechpartner als Detailliste eingebunden. Durch das Einbinden von weiteren Listen, welche eine Zieltabelle für das Zurückschreiben der Daten enthalten muss, kann somit über mehrere Tabellen hinweg in den Datenbestand zurückgeschrieben werden. Im Beispiel von Abbildung 10 können so die Daten der Ansprechpartner bearbeitet werden.

    Die Tabelle Detaillisten hat folgende Optionen:

    • Hinzufügen (Symbol: Plus)
    • Bearbeiten (Symbol: Stift)
    • Löschen (Symbol: Mülleimer)
    • Aufwärts/Abwärts (Symbol: Pfeile): Ändern der Reihenfolge einer Detailliste in einem Formular. Die Detaillisten erscheinen innerhalb einer Kategorie immer unter den Kategoriefelder (siehe vorheriger Abschnitt). Sollen die Detaillisten über den Kategoriefelder erscheinen oder auch zwischen zwei Kategoriefeldern kann das über mehrere Kategorien realisiert werden.

    Wird eine Detaillisten hinzugefügt oder bearbeitet können folgende Einstellungen vorgenommen werden:

    • Bezeichnung: Die Bezeichnung wird groß im Kopfbereich des Formulars dargestellt.
    • Detaillisten: Auswahl der Liste, welche über den AppBuilder innerhalb von einem Element definiert wurde. Bei der Auswahl der Liste öffnet sich ein Dialog, welcher alle vorhandenen Listen zur Auswahl anbietet. Die integrierte Suche kann dabei helfen die gewünschte Liste zu finden.
    • Filterfeld 1-5: Die Filterfelder ermöglichen es die Felder mit dem übergeordneten Datensatz zu verknüpfen. Wird ein Feld ausgewählt, welches den Datensatz der übergeordneten Liste mit der Detailliste verbindet, kann so eine Beziehung hergestellt werden. Über die zusätzlichen Filterfelder können zusätzlich weitere Filter definiert werden. Es sind maximal 5 Filterfelder möglich.
    • Layout: Über die Auswahlliste Layout kann die Ansicht auf die Daten bestimmt werden. In dem Beispiel aus Abbildung 10 wurde für die Detailliste die Kachelansicht verwendet.

    3 Assistent/Menü

    Der letzte Tab im Assistenten ist der Tab Menü, welcher nur die Tabelle Menü enthält (Abbildung 16). Dort kann die ausgewählte Liste (siehe Abschnitt Assistent/Liste) dem linken Navigationsmenü und dem Dashboard zur Verfügung gestellt werden. Im Folgenden wird sich nur auf das linke Navigationsmenü bezogen, aber dem Dashboard steht dieser Eintrag ebenfalls zur Verfügung.


    Abbildung 16: AppBuilder Assistent Menü


    Wenn die gewünschte Liste unter dem Tab Assistent/Listen ausgewählt wurde, kann anschließend zu dem Tab Menü gewechselt werden. Im Tab Menü kann über den Button Neu ein neuer Menü-Eintrag erzeugt und dem Menü-Eintrag ein Titel und ein Icon zugewiesen werden. Es können grundsätzlich mehrere Menüeinträge erstellt werden, in der Regel ist ein einzelner Menüeintrag ausreichend.


    Über die Vorschau (Button Vorschau in Abbildung 16) sind die Änderungen an dem Menü nicht ersichtlich, die Vorschau stellt lediglich die Ansicht auf die Listen inkl. der Formulare dar. Um die Änderungen am Menü zu sehen muss die App veröffentlicht werden (siehe Abschnitt Apps). Anschließend kann das Portal geöffnet werden und in dem linken Navigationsmenü ist jetzt der entsprechende Menüeintrag vorhanden. Zudem ist der Menüeintrag als Dashlet für das Dashboard verfügbar und kann auf dem Dashboard platziert werden (siehe Dashboard).

Teilen