Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

Link zu dieser Vergleichsansicht

Beide Seiten der vorigen RevisionVorhergehende Überarbeitung
Nächste Überarbeitung
Vorhergehende Überarbeitung
edpweb3:dev [2024/12/11 14:26] – [Aufbau der Template-Struktur] adminedpweb3:dev [2025/02/03 15:19] (aktuell) admin
Zeile 1: Zeile 1:
-====== EDPweb ======+==== edp:web 3 ====
  
-==== Aufbau der Template-Struktur ====+=== Aufbau der Template-Struktur ===
  
-Beim Start des Dienstes EDPweb wird zunächst der Ordner "html" komplett geleert. Anschließend werden alle Dateien unter Beibehaltung der Ordner-Struktur aus dem Ordner Templates vorprozessiert und in den Ordner HTML kopiert.+Beim Start des Dienstes edp:web wird zunächst der Ordner "html" komplett geleert. Anschließend werden alle Dateien unter Beibehaltung der Ordner-Struktur aus dem Ordner Templates vorprozessiert und in den Ordner HTML kopiert.
  
-Der Ordner HTML bildet die Rechtestruktur von EDPweb in der Version 3 ab. In der obersten Ebene des Ordners sind die Benutzerrollen angegeben. Standardmäßig vorgesehen sind die Benutzerrollen Default, UHS für Unfallhilfstellen, Abschnitt für Einsatzabschnitte, Abteilung für die Abteilungsrolle sowie.+Der Ordner HTML bildet die Rechtestruktur von edp:web in der Version 3 ab. In der obersten Ebene des Ordners sind die Benutzerrollen angegeben. Standardmäßig vorgesehen sind die Benutzerrollen Default, UHS für Unfallhilfstellen, Abschnitt für Einsatzabschnitte, Abteilung für die Abteilungsrolle sowie.
  "info" für EDPinfo.  "info" für EDPinfo.
  
Zeile 11: Zeile 11:
  
  
-==== Sql-Abfragen ====+=== Sql-Abfragen ===
  
 Sql-Abfragen können nach folgendem Schema in den Templates eingebaut werden. Sql-Abfragen können nach folgendem Schema in den Templates eingebaut werden.
Zeile 35: Zeile 35:
 </code> </code>
  
-Abfragen mit dem Präfix presql werden einmal beim Start von EDPweb vorprozessiert. Das kann genutzt werden, um beispielsweise Standardtexte aus der Datenbank zu laden, die im Einsatz keine Änderungen erfahren.+Abfragen mit dem Präfix presql werden einmal beim Start von edp:web vorprozessiert. Das kann genutzt werden, um beispielsweise Standardtexte aus der Datenbank zu laden, die im Einsatz keine Änderungen erfahren.
  
 === Automatische Zeilenumbrüche / BR-Tag === === Automatische Zeilenumbrüche / BR-Tag ===
Zeile 47: Zeile 47:
  
  
-==== IF-Abfragen ====+=== IF-Abfragen ===
  
 IF-Abfragen können nach folgender Syntax eingebaut werden. IF-Abfragen können nach folgender Syntax eingebaut werden.
Zeile 61: Zeile 61:
 Bei Listen, Ansichten, bei denen viele Datensätze möglich sind, sollte unbedingt vermieden werden, pro Datensatz eine IF-Abfrage vorzusehen. Bei Listen, Ansichten, bei denen viele Datensätze möglich sind, sollte unbedingt vermieden werden, pro Datensatz eine IF-Abfrage vorzusehen.
  
-====Includes-Tags====+===Includes-Tags===
  
-Includes können verwendet werden, um einzelne Seiten einzubinden.+Includes können verwendet werden, um einzelne Seiten einzubinden. Hierbei ist der komplette Pfad bezogen auf das Verzeichnis der Anwendung edpweb.exe anzugeben.
  
-Hierbei ist der komplette Pfad bezogen auf das Verzeichnis der Anwendung edp-web.exe anzugeben.+Im nachfolgenden Beispiel wird die Datei "wachbuchtable.html" aus dem Ordner "templates\default\wachbuch\views" eingebunden: 
 +<code> 
 +{inc}templates/default/wachbuch/views/wachbuchtable.html{/inc} 
 +</code>
  
-====Einbinden von Parametern====+===Einbinden von Parametern===
  
 Parameter können sowohl aus der URL als auch aus der Session eingebunden werden. Parameter können sowohl aus der URL als auch aus der Session eingebunden werden.
Zeile 75: Zeile 78:
 Parameter aus der Session werden über die Raute angegeben. ({#FUNKTION}) Parameter aus der Session werden über die Raute angegeben. ({#FUNKTION})
  
-==== Nutzerberechtigungen ====+=== Nutzerberechtigungen ===
  
-Zum Aufruf von Endpunkten, die schreibend Daten an EDPweb senden, muss jeder dieser Endpunkte, der über die URL /action aufgerufen wird, auch explizit für die Benutzerrolle freigeschaltet werden.+Zum Aufruf von Endpunkten, die schreibend Daten an edp:web senden, muss jeder dieser Endpunkte, der über die URL /action aufgerufen wird, auch explizit für die Benutzerrolle freigeschaltet werden.
  
 Um dies möglichst einfach zu gestalten, kann in jeder Template-Vorlage innerhalb eines Action-Tags ein Endpoint angegeben werden, der in dieser Template-Datei benötigt wird. Um dies möglichst einfach zu gestalten, kann in jeder Template-Vorlage innerhalb eines Action-Tags ein Endpoint angegeben werden, der in dieser Template-Datei benötigt wird.
Zeile 85: Zeile 88:
 </code> </code>
  
-Beim Prozessieren der Templates werden so alle eingetragenen Actions aus der jeweiligen Benutzerrolle übernommen und in der Rechtestruktur von EDPweb gespeichert.+Beim Prozessieren der Templates werden so alle eingetragenen Actions aus der jeweiligen Benutzerrolle übernommen und in der Rechtestruktur von edp:web gespeichert.
  
 Innerhalb einer jeden Template-Datei können beliebig viele Action-Tags angegeben werden. Innerhalb einer jeden Template-Datei können beliebig viele Action-Tags angegeben werden.
Zeile 97: Zeile 100:
 Dadurch, dass die Templates immer in der Ordnerstruktur einer jeweiligen Benutzerrolle liegen, beziehen sich die Freischaltungen der Actions immer auf diese Benutzerrolle. Dadurch, dass die Templates immer in der Ordnerstruktur einer jeweiligen Benutzerrolle liegen, beziehen sich die Freischaltungen der Actions immer auf diese Benutzerrolle.
  
-==== Einbinden eigener Anpassungen ====+=== Einbinden eigener Anpassungen ===
  
 Wenn eigene, selbst angepasste Template-Vorlagen eingebunden werden sollen, können diese im Ordner "custom" abgelegt werden. Dieser Ordner wird beim Präprozessieren der Templates nach dem eigentlichen Templates-Ordner verarbeitet und überschreibt damit die Standard-Daten. Da der custom-Ordner von EDP standardmäßig nicht genutzt und beschrieben wird, werden hier hinterlegte Anpassungen auch bei Updates nicht verändert und bleiben so bestehen. Wenn eigene, selbst angepasste Template-Vorlagen eingebunden werden sollen, können diese im Ordner "custom" abgelegt werden. Dieser Ordner wird beim Präprozessieren der Templates nach dem eigentlichen Templates-Ordner verarbeitet und überschreibt damit die Standard-Daten. Da der custom-Ordner von EDP standardmäßig nicht genutzt und beschrieben wird, werden hier hinterlegte Anpassungen auch bei Updates nicht verändert und bleiben so bestehen.
 +
 +====== Zugriff Websockets ======
 +
 +Wenn eigene Benutzerrolle angelegt werden, erhalten diese Standardmäßig keinen Zugriff auf den Websocket-Channel "Einsätze". Wenn innerhalb der Template-Struktur für diese Nutzerrolle auch der Ordner einsatz mit der Datei elw.html hinterlegt ist, wird der Einsatzchannel mit Zugriff auf alle Einsätze freigegeben (ab Version 3.1.96).