Modulbeschreibung
Inhalt des pulsation Designers sind die Generic Views.
...
Generic Views sind eine Art Weiterentwicklung der Dynamischen dynamischen Felder. Der Kunde wird hiermit in die Lage versetzt, sich eigene Eingabemasken zu bauen.
...
Der Kunde konfiguriert sich eine neue Eingabemaske. Diese Generic View erstellt er mit dem pulsation Designer und bindet diese z.B. in die Notfall Dokumentation Notfalldokumentation ein.
In diesem Artikel werden die folgenden Funktionen von Generic Views erläutert:
...
Um die gesamte Funktion der Generic Views aufzuzeigen, wird betrachtet, wie eine neue Maske konfiguriert und wie eine Generic View in ein bestehendes Protokoll eingebunden werden kann.
pulsation Designer
Im Designer können Sie eine eigene Eingabemaske zusammen bauenzusammenbauen.
Um den Designer zu verwenden öffnen Sie die pulsation Web-App WebApp und navigieren Sie zu Stammdaten-> Setup → Generic View Designer
...
Nachdem Sie den Reiter ausgewählt haben, sehen sie Sie eine Liste Ihrer erstellten Eingabelisten. Um eine neue Maske zu erstellen, klicken Sie oben links auf Anlegen“Anlegen”.
...
Anschließen gelangen Sie in die Editor-Ansicht. Diese teilt sich in 3 Bereiche:
...
Komponenten sind Eingabeelemente, mit denen der Benutzer Ihrer View interagieren kann.
Alle Komponenten (auch Rows genannt) finden Sie Hier hier (Muss noch ausgearbeitet werden)
Ansicht (Mitte)
Im Bereich Ansicht sehen Sie eine Vorschau Ihrer Eingabemaske.
Auf dem iPad z.B. wird Ihre Maske genauso aussehen.
...
Im Bereich Eigenschaften können Sie Eigenschaften Ihrer View, Section und Row anpassen.
Beispielsweise können Sie hier den Namen Ihrer View festlegen oder einem Freitextfeld einen Platzhalter geben.
Aufbau Einer einer View
Im Designer wird eine eigene Eingabemaske konfiguriert, dabei ist der Aufbau immer der selbederselbe.
Eine View besteht aus 3 Teilen:
Die View
Die View ist eine Art Hülle für Sections und Rows und hält rudimentäre Daten wie z.B. den Namen Ihrer Maske.
Sections (Sektionen)
Eine View kann aus vielen Sections bestehen. Eine Section dient zur Gliederung Ihrer Maske. Sie bündelt Ihre Rows zu Blöcken und macht die View übersichtlicher. eine Eine Section besitzt z.B. einen Namen und mehrere Row’sRows.
Rows (Komponenten)
Rows sind die Eingabeelemente Ihrer Maske wie z.B. ein Freitextfeld, eine Auswahlliste oder ein Ja/Nein Button.
...
Versuchen Sie eine neu erstellte View zu speichern, werden Ihnen höchstwahrscheinlich Pflichfelder Pflichtfelder angezeigt werden, welche Sie ausfüllen müssen. Diese werden Ihnen immer in Rot angezeigt.
...
Hier finden die als erstes die Eigenschaften Ihrer View:
Kategorie
Hier können Sie einen beliebigen Text vergeben, um Ihre Masken zu kategorisieren.
Bsp.: Sie erstellen ein Modul, welches aus mehreren Masken besteht und wollen diese leichter in der Übersicht wiederfinden.
View-IdID
Eine eindeutige ID Ihrer Maske, diese wird automatisch erzeugt und ist für die Einbindung Ihrer Maske wichtig.
Bsp.: Wenn Sie Ihre Maske in das Notfallprotokoll oder BTK-Protokoll einbinden wollen.
...
View-Name (intern) *
Der Name mit dem Sie Ihre View in der Web-App WebApp oder in Statistiken suchen können.
Dieser muss immer eindeutig sein.
...
Separator
Ein optischer Trenner zwischen den Einzelnen einzelnen Komponenten. (Aktivierung Empfohlenempfohlen).
Scrollbar
Erlaubt das Scrollen in Ihrer Maske . (Aktivierung Empfohlenempfohlen).
Häkchen anzeigen
Wird ein Feld auf einem Endgerät bearbeitet, wird ein Farbiges farbiges Häkchen angezeigt (Aktivierung Empfohlenempfohlen).
Nicht auf Protokoll drucken
Erlaubt das Drucken auf das Protokoll. Es können auch Rows (Komponenten) einzeln angesteuert werden (Aktivierung Empfohlenempfohlen).
...
Erstellen einer Sektion
Eine View besteht immer aus mindestens einer Sektion. Klicken Sie auf “Das kleine Viereck mit dem Stift” im Bereich Ansicht, um die Sektion Auszuwählenauszuwählen. Im Rechten rechten Bereich Eigenschaften “Eigenschaften” sollten Sie nun eine Zeile mit dem Name “Gewählte Sektion“ sehen.
Um eine weitere Sektion zu erstellen, klicken Sie im Bereich Ansicht auf die Schaltfläche “+ Sektion zufügen“
Sektion-IdID
Automatisch generierte ID der Sektion
Sektion-Name (iPad) & Sektion-Name (intern)
Hier können Sie der Sektion einen Namen geben. Dies ist Analog analog zum View-NameNamen. Sektion-Namen Sektionsnamen sind keine Pflicht.
Aktiv
Die Sektion ist ist z.B. auf dem iPad nur sichtbar wenn “Aktiv” ausgewählt ist.
Nicht auf Protokoll drucken
Wenn Aktiv aktiv, können Row Rows der Sektion auf das Protokoll gedruckt werden.
...
Nach dem Sie die Komponente hinzugefügt haben, klicken Sie auf “Das kleine Viereck mit dem Stift”.
Im rechten Bereich Eigenschaften “Eigenschaften” sollte nun ein Abschnitt “GEWÄHLTE ZEILE“ sichtbar sein. Ihre Komponente verfügt hier über die folgenden Eigenschaften:
Zeilen-IdID
Intern generierte eindeutige ID
Zeilen-Name Zeilenname (iPad) *
Der Anzeige Name Ihrer Komponente z.B. “Mein Zusatzangaben“
Zeilen-Name Zeilenname (intern) *
Interner Name für Filter und Statistiken. Der Name muss Eindeutig sein z.B. “Mein Zusatzangaben aus Maske Zusatz“
Zeilen-InformationZeileninformation
Jede Komponente verfügt über ein Informationsfeld. Dies wird z.B. auf dem iPad angezeigt.
Mit dem Informationsfeld können Sie dem Benutzer Ihrer Maske zusätzliche Informationen zu Ihrer Komponente zukommen lassen.
Zeilen-HöheZeilenhöhe
Höhe der Komponente in Pixel (Standard = 70)
Aktiv
Wenn nicht Aktiv aktiv, wird die Komponente ausgeblendet.
Nicht auf Protokoll drucken
Wenn Aktiviert aktiviert wird die Komponente nicht auf das Protokoll gedruckt.
...
Die Konfigurationen selbst sind einfache Schlüssel / Wert Paare Wertpaare, mit eine Beschreibung über Ihre Auswirkung.
...
Komponenten können Validierungen hinzugefügt werden. Eine Validierung löst ein bestimmtes Verhalten einer Komponente aus. Mithilfe von Validierungen wird aus einer einfachen Maske ein komplexer Abfrage Algorithmus.
Eine Validierung besteht aus den folgenden Elementen:
is_required
Wenn Aktiviert aktiviert werden Validierungen der Komponente berücksichtigt. Der Wert wird automatisch gesetzt wenn eine dependency_validation hinzugefügt wird.
...
validation_rule, hidden_rule, enabled_rule & warning_rule
Tipp: Vorher dependency_validation lesen
Mit diesem Feld lassen sich mehrer dependency_validation Objekte Kombinierenkombinieren.
Dabei hat jeder dependency_validation-Typ ein eigenes Feld (validation_rule, hidden_rule ….).
...
Error = Die Komponente zeigt ein einen Fehler an, z. B. ein Pflichtfeld, welches ausgefüllt werden muss.
Hidden = Die Komponente wird ausgeblendet, z. B. um eine weitere Abfragen zu einer bestimmten Auswahl in einer vorherigen Abfrage.
Enabled = Um die Benutzer Interaktion Benutzerinteraktion mit der Komponente zu sperren, z. B., um den einen Wert nicht mehr Ändern ändern zu lassen, Ihn ihn aber dennoch Anzuzeigenanzuzeigen.
Einer Komponente können beliebig viele dependency_validations hinzugefügt werden. Dabei Bekommt bekommt jede dependency_validation einen Buchstaben zugewiesen, z. B. A, B, C..Z
validation_type
Im validation_type einer dependency_validation wird Angegeben angegeben, auf welchen typ Typ von Wert geprüft werden soll:
functionValidator = Eine Funktion mit einem Namen (Nur für Entwickler)
static = Auf ein Datenbankfeld (Nur für Entwickler)
Dynamic = Auf einer Andere andere Komponente (Dies wird in den meisten Fällen verwendet)
query_destination
Hier wird der Ort des Abzufragenden abzufragenden Feldes angegeben.
BTK_ Hauptbericht = Das Feld befindet sich im Hauptbericht der BTK Dokumentation
BTK_MittelBericht = Das Feld befindet sich im Mittelbericht der BTK Dokumentation
Einsatz = Das Feld befindet sich im Notfallprotokoll
Global = Sonderfälle (Nur für Entwickler)
query
Die Query hält unterschiedliche Werte, je nach dem was in das Feld validation_type eingetragen wurde.
Um es an dieser stelle Stelle zu vereinfachen, betrachten wir ausschließlich eine dependency_validation vom typ Typ “Dynamic“
In der Query wird die Komponente angegeben, auf welche geprüft werden soll. Befindet sich die gesuchte Komponente in der selben Maske, wird im Designer ein DropDown-Menü angeboten in der ein Feld ausgewählt werden kann.
comparator
Ein logischer Ausdruck, wie das Feld ausgewertet werden soll, z. B. ist es >, <, beinhaltet es einen Text.
value_type
Der Typ des Wertes, in der Angegebenden angegebenden Komponente, z. B. Bool, String, Int,…
Die Werte können aus der Komponenten Dokumentation Komponentendokumentation entnommen werden (Wird noch ausgearbeitet).
value
Der Wert, auf welchen geprüft werden soll, z. B. “Mein Text“, 5 , true.
...
Tipp: Soll ein Feld ein Pflichtfeld werden, einfach auf den Button “+ Nullcheck zufügen“ klicken.
...
Die Speicherregel einer Komponente beschreibt, wo das Feld gespeichert werden soll.
storage_type
Dynamic = Verwaltet das speichern Speichern der Komponente selber (Voreingestelltvoreingestellt).
Static = Nur für Entwickler
storage_destination
Hier wird angegeben, wo das Feld gespeichert werden soll.
BTK_ Hauptbericht = Das Feld wird im Hauptbericht der BTK-Dokumentation gespeichert
BTK_MittelBericht = Das Feld wird im Mittelbericht der BTK-Dokumentation gespeichert
Einsatz = Das Feld wird im Notfallprotokoll gespeichert
Global = Sonderfälle (Nur für Entwickler)
storage_destination_attribute
Die Speicheradresse der Komponente ist Voreingestellt voreingestellt und sollte nicht verändert werden.
server_query
Nur für Entwickler
server_function
Nur für Entwickler
Verwendung von Generic Views am Beispiel einer Dokumentation einer Brandmeldeanlage
...