Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

Link zu dieser Vergleichsansicht

Beide Seiten der vorigen RevisionVorhergehende Überarbeitung
Nächste Überarbeitung		Vorhergehende Überarbeitung
edpweb:sync [2025/01/24 15:49] – [Konfiguration der Einsatzdaten-API] pascaledpweb:sync [2025/01/24 15:52] (aktuell) – [Weiteres] pascal
Zeile 62: Zeile 62:
 </code> </code>
  
-==== Konfiguration der Stammdaten-API ====+=== Konfiguration der Stammdaten-API ===
  
-Die Bereitstellung von Stammdaten über die API von EDPsync wird über die Datei "stammdatensync.ini" konfiguriert. Diese Datei muss zunächst manuell angelegt werden. Hier kann individuell festgelegt werden, welche Stammdaten bereitgestellt werden sollen.+Die Bereitstellung von Stammdaten über die API von edp:sync wird über die Datei "stammdatensync.ini" konfiguriert. Diese Datei muss zunächst manuell angelegt werden. Hier kann individuell festgelegt werden, welche Stammdaten bereitgestellt werden sollen.
  
 Die erfolgt nach folgendem Schema: Die erfolgt nach folgendem Schema:
Zeile 100: Zeile 100:
 </code> </code>
  
-===== Einrichten von EDPsync-Benutzern =====+=== Einrichten von edp:sync-Benutzern ===
  
-Damit sich andere Systeme per Schnittstelle zur API von EDPsync verbinden können, wird für jedes verbundene System ein Benutzer im Mastersystem benötigt, der für die API freigegeben ist. Dafür muss zuerst die API in der Konfigurationsdatei wie oben beschrieben aktiviert und danach EDPweb neugestartet werden. Beim Starten der API wird dann eine Flag in der Datenbank aktiviert, die die Erstellung von Benutzern mit EDPsync Freigabe in der Datenversorgung ermöglicht.+Damit sich andere Systeme per Schnittstelle zur API von edp:sync verbinden können, wird für jedes verbundene System ein Benutzer im Mastersystem benötigt, der für die API freigegeben ist. Dafür muss zuerst die API in der Konfigurationsdatei wie oben beschrieben aktiviert und danach edp:web neugestartet werden. Beim Starten der API wird dann eine Flag in der Datenbank aktiviert, die die Erstellung von Benutzern mit edp:sync Freigabe in der Datenversorgung ermöglicht.
  
-Das Erstellen eines EDPsync-Benutzers läuft in den ersten Schritten identisch mit der bereits bekannten Erststellung eines Benutzers ab. Das heißt es, wird zuerst ein Benutzername und Passwort erstellt. Diese erstellten Zugangsdaten müssen dann im [[server:ansteuerungen:edpsync|Clientsystem in der Schnittstelle]]  angegeben werden. Weiterhin muss im Mastersystem der angelegte Benutzer für die API freigegeben werden und dann kann noch eine Benutzerrolle bestimmt werden, die den Zugriff des Clientsystems auf Daten regelt. Dieses Berechtigungssytem wird im folgenden Abschnitt tiefergehend erläutert.+Das Erstellen eines edp:sync-Benutzers läuft in den ersten Schritten identisch mit der bereits bekannten Erststellung eines Benutzers ab. Das heißt es, wird zuerst ein Benutzername und Passwort erstellt. Diese erstellten Zugangsdaten müssen dann im [[server:ansteuerungen:edpsync|Clientsystem in der Schnittstelle]]  angegeben werden. Weiterhin muss im Mastersystem der angelegte Benutzer für die API freigegeben werden und dann kann noch eine Benutzerrolle bestimmt werden, die den Zugriff des Clientsystems auf Daten regelt. Dieses Berechtigungssytem wird im folgenden Abschnitt tiefergehend erläutert.
  
 {{:edpweb:edp_sync_datenversorgung.png?600|}} {{:edpweb:edp_sync_datenversorgung.png?600|}}
  
-==== Darstellung Benutzernamen in Fremdsystemen ====+=== Darstellung Benutzernamen in Fremdsystemen ===
  
-Um bei einem Austausch von Daten direkt nachvollziehen zu können, von wem die Daten eingegeben wurden, kann der lokale Benutzernamen in anderen Systemen erweitert dargestellt werden. Je nach Anbindung und einsatztaktischer Nutzung von EDPsync können verschiedene Formen sinnvoll sein. Die Darstellung kann in der "EDPapi.ini" angepasst werden:+Um bei einem Austausch von Daten direkt nachvollziehen zu können, von wem die Daten eingegeben wurden, kann der lokale Benutzernamen in anderen Systemen erweitert dargestellt werden. Je nach Anbindung und einsatztaktischer Nutzung von edp:sync können verschiedene Formen sinnvoll sein. Die Darstellung kann in der "EDPapi.ini" angepasst werden:
  
 <code>  <code> 
Zeile 120: Zeile 120:
  
 Es stehen drei Modi zur Auswahl: Es stehen drei Modi zur Auswahl:
-  * 0: Darstellung über Namen des EDPsync-Benutzers+  * 0: Darstellung über Namen des edp:sync-Benutzers
   * 1: Darstellung über Namen des lokalen Benutzers   * 1: Darstellung über Namen des lokalen Benutzers
-  * 2: Darstellung über Kombination aus EDPsync- und lokalem Benutzer, getrennt durch das NameTrennzeichen+  * 2: Darstellung über Kombination aus edp:sync- und lokalem Benutzer, getrennt durch das NameTrennzeichen
  
-Beispielhaft kann beim EDPsync Benutzer "Musterstadt" und dem lokalen Benutzer "Fernmelder" die Bezeichnung so aussehen:+Beispielhaft kann beim edp:sync Benutzer "Musterstadt" und dem lokalen Benutzer "Fernmelder" die Bezeichnung so aussehen:
   * 0: Musterstadt   * 0: Musterstadt
   * 1: Fernmelder   * 1: Fernmelder
Zeile 131: Zeile 131:
  
  
-===== Freigabe von Einsatzdaten =====+=== Freigabe von Einsatzdaten ===
    
-EDPsync verfügt über ein Rollen- und Freigabesystem, um Clientsystemen gezielt Daten zur Verfügung zu stellen und unbefugten Zugriff auf z.B. Einsatzdaten zu vermeiden. Dafür kann jedem Benutzer eine Benutzerrolle zugewiesen werden, die die Datenfreigabe regelt. Falls ein Benutzer alle Einsatzdaten eines Masterservers erhalten soll, kann das Rollenfeld einfach leer gelassen werden. Standardmäßig gibt es drei Möglichkeiten, wie ein Einsatz einem Benutzer freigegeben wird:+edp:sync verfügt über ein Rollen- und Freigabesystem, um Clientsystemen gezielt Daten zur Verfügung zu stellen und unbefugten Zugriff auf z.B. Einsatzdaten zu vermeiden. Dafür kann jedem Benutzer eine Benutzerrolle zugewiesen werden, die die Datenfreigabe regelt. Falls ein Benutzer alle Einsatzdaten eines Masterservers erhalten soll, kann das Rollenfeld einfach leer gelassen werden. Standardmäßig gibt es drei Möglichkeiten, wie ein Einsatz einem Benutzer freigegeben wird:
  
-==== Freigabe über Einsatzort ====+=== Freigabe über Einsatzort ===
  
 Bei der Freigabe über den Einsatzort muss die Rolle des Benutzers identisch mit dem Feld "Ort" des angelegten Einsatzes sein. Dabei ist vor allem auf eine konsistente Datenpflege mit einheitlichen Ortsnamen zu achten. Beispielhaft ist der folgende Einsatz für alle Benutzer freigegeben, deren Benutzerrolle "Musterhausen" ist: Bei der Freigabe über den Einsatzort muss die Rolle des Benutzers identisch mit dem Feld "Ort" des angelegten Einsatzes sein. Dabei ist vor allem auf eine konsistente Datenpflege mit einheitlichen Ortsnamen zu achten. Beispielhaft ist der folgende Einsatz für alle Benutzer freigegeben, deren Benutzerrolle "Musterhausen" ist:
 {{:edpweb:edpsync_einsatz_musterhausen.png?400|}} {{:edpweb:edpsync_einsatz_musterhausen.png?400|}}
  
-==== Freigabe über Einsatzmittel ====+=== Freigabe über Einsatzmittel ===
  
 Weiterhin kann die automatisierte Freigabe von Einsätzen über den Standort der zugewiesenen Einsatzmittel geschehen. Dabei muss das Feld "Standort" des Einsatzmittels identisch mit der Rolle des jeweiligen Benutzers sein. Weiterhin kann die automatisierte Freigabe von Einsätzen über den Standort der zugewiesenen Einsatzmittel geschehen. Dabei muss das Feld "Standort" des Einsatzmittels identisch mit der Rolle des jeweiligen Benutzers sein.
Zeile 146: Zeile 146:
 {{:edpweb:edp_sync_em_zuteilung.png?400|}} {{:edpweb:edp_sync_em_zuteilung.png?400|}}
  
-==== Freigabe über Aufgabe ====+=== Freigabe über Aufgabe ===
  
 Die Freigabe für einen Einsatz kann auch manuell über eine Aufgabe geschehen. Diese Aufgabe kann in der Datenversorgung erstellt werden und wie von anderen Aufgaben gewohnt, automatisch durch verschiedene Trigger oder per Hand im Einsatzleitplatz ausgelöst werden. Auch ist die Auslösung der Aufgabe bei Zuteilung eines bestimmten Einsatzmittels möglich, wodurch z.B. das Szenario eines abgesetzten EDP-Systems in einem ELW abgebildet werden kann, ohne den Standort des Einsatzmittels ändern zu müssen. Bei Erstellung der Aufgabe ist als Wert die freizugebene Benutzerrolle anzugeben. Die Freigabe für einen Einsatz kann auch manuell über eine Aufgabe geschehen. Diese Aufgabe kann in der Datenversorgung erstellt werden und wie von anderen Aufgaben gewohnt, automatisch durch verschiedene Trigger oder per Hand im Einsatzleitplatz ausgelöst werden. Auch ist die Auslösung der Aufgabe bei Zuteilung eines bestimmten Einsatzmittels möglich, wodurch z.B. das Szenario eines abgesetzten EDP-Systems in einem ELW abgebildet werden kann, ohne den Standort des Einsatzmittels ändern zu müssen. Bei Erstellung der Aufgabe ist als Wert die freizugebene Benutzerrolle anzugeben.
Zeile 152: Zeile 152:
 {{:edpweb:edp_sync_aufgabe.png?400|}}  {{:edpweb:edp_sync_aufgabe.png?400|}} 
  
-==== Freigabe über Datenbank-Trigger ====+=== Freigabe über Datenbank-Trigger ===
  
 Eine besonders flexible Möglichkeit eines Einsatzes bieten sogenannte Datenbank-Trigger, die auf Datenänderungen direkt in der Datenbank reagieren können und basierend darauf Freigaben erteilen. Eine besonders flexible Möglichkeit eines Einsatzes bieten sogenannte Datenbank-Trigger, die auf Datenänderungen direkt in der Datenbank reagieren können und basierend darauf Freigaben erteilen.
  
-**Wichtig: Das direkte Schreiben in der Datenbank wird nur SQL-Erfahrenen Kunden empfohlen, da jede falsche Konfiguration zum Ausfall von EDPsync führen kann. Bei Fragen und Konfigurationswünschen, die nicht mit den vorher beschriebenen Freigabeverfahren möglich sind, wenden Sie sich bitte an unseren Support. ** +**Wichtig: Das direkte Schreiben in der Datenbank wird nur SQL-Erfahrenen Kunden empfohlen, da jede falsche Konfiguration zum Ausfall von edp:sync führen kann. Bei Fragen und Konfigurationswünschen, die nicht mit den vorher beschriebenen Freigabeverfahren möglich sind, wenden Sie sich bitte an unseren Support. ** 
  
-===== Besonderheit: Freigabe Einsatzabschluss =====+=== Besonderheit: Freigabe Einsatzabschluss ===
  
 Um ein vorzeitiges Abschließen eines Einsatzes auf Masterserverebene zu vermeiden, wurde eine zusätzliche Freigabestufe eingeführt, die direkt von der Benutzerrolle abhängig ist. Diese Stufe sorgt dafür, dass Einsätze global nur von Benutzern abgeschlossen werden können, die als Benutzerrolle den Ort des Einsatzes haben und damit vermeintlich die Einsatzleitung verantworten. Jeder andere Benutzer kann den Einsatz nur lokal schließen und den Einsatzabschluss nicht auf den Masterserver übertragen.   Um ein vorzeitiges Abschließen eines Einsatzes auf Masterserverebene zu vermeiden, wurde eine zusätzliche Freigabestufe eingeführt, die direkt von der Benutzerrolle abhängig ist. Diese Stufe sorgt dafür, dass Einsätze global nur von Benutzern abgeschlossen werden können, die als Benutzerrolle den Ort des Einsatzes haben und damit vermeintlich die Einsatzleitung verantworten. Jeder andere Benutzer kann den Einsatz nur lokal schließen und den Einsatzabschluss nicht auf den Masterserver übertragen.  
Zeile 170: Zeile 170:
 Dadurch kann jetzt jedes angebundene System einen Einsatz schließen, wenn es die normalen Zugriffsrechte hat. Dadurch kann jetzt jedes angebundene System einen Einsatz schließen, wenn es die normalen Zugriffsrechte hat.
  
-===== Zeitsynchronisation =====+=== Zeitsynchronisation ===
  
 Die richtige Uhrzeit auf allen beteiligten Systemen ist eine wichtige Vorraussetzung für eine reibungslose Synchronisation, da über Zeitstempel die Aktualität von Daten bestimmt wird und damit entschieden wird, welche Daten ins Mastersystem übernommen werden. Eine Anleitung zur Vornahme aller wichtigen Zeiteinstellungen finden Sie unter folgendem Link: [[allgemein:zeitsynchron|Zeitsynchronisation]] Die richtige Uhrzeit auf allen beteiligten Systemen ist eine wichtige Vorraussetzung für eine reibungslose Synchronisation, da über Zeitstempel die Aktualität von Daten bestimmt wird und damit entschieden wird, welche Daten ins Mastersystem übernommen werden. Eine Anleitung zur Vornahme aller wichtigen Zeiteinstellungen finden Sie unter folgendem Link: [[allgemein:zeitsynchron|Zeitsynchronisation]]
  
  
-===== API-Beschreibung ===== +=== API-Beschreibung === 
-  * [[edpweb:syncapi|API-Beschreibung von EDP-Sync für Drittsysteme]]+  * [[edpweb:syncapi|API-Beschreibung von edp:sync für Drittsysteme]]
  
-===== Weiteres ===== +=== Weiteres ===
  
-  * [[checklisten:edpsync|Checkliste vor Installation / Inbetriebnahme EDPsync]]+  * [[checklisten:edpsync|Checkliste vor Installation / Inbetriebnahme edp:sync]]
  
edpweb/sync.1737730150.txt.gz · Zuletzt geändert: von pascal


  • Seite anzeigen
  • Ältere Versionen
  • Links hierher
  • Letzte Änderungen
  • Medien-Manager
  • Übersicht