Anwender
HilfeChangelogAdministratoren
Einrichtung BundIDWidget erstellenCSV-Mitarbeiter-ImportAnbindung Active DirectoryAnbindung d.velop documentsAnbindung Exchange ServerEinrichtung BesucherverwaltungAnbindung FormularserverDienstleister
Webseiten-WidgetSuch- und GraphQL-APIEinbindung TerminvereinbarungPartner
Anbindung DMSAnbindung FormularserverOAuth2.0Integration in eine Webseite
Die optiGov-Bürgerserviceplattform wird für den Bürger über ein JavaScript-Widget angebunden. Da über JavaScript dargestellter Inhalt aber nicht optimal von Suchmaschinen erfasst wird, stellt jede optiGov-Instanz einen Widget-Endpunkt zur Verfügung, welcher einen Hydration-Ansatz umsetzt. Darüber wird statisches HTML zusammen mit dem JavaScript-Widget ausgeliefert.
Des Weiteren erleichtert dies die Integration in der Hinsicht, dass durch Sie als Webseiten-Dienstleister keine Konfiguration mehr vorgenommen werden muss. Die einzelnen Inhaltsseiten werden über ein Query-Parameter unterschieden und von einer einzelnen Seite auf der Webseite dargestellt.
Vorbereitungen
Kommunizieren Sie als Dienstleister mit Ihrer Kommune die URL unter der die Startseite des Bürgerservices später verfügbar sein wird.
In diesem Beispiel nehmen wir folgende URL: https://optistadt.de/de/buergerservice.php
Diese muss im Backend von optiGov durch die Kommune oder uns hinterlegt werden.
/de/index.php als ein anderer Pfad interpretiert als nur /de/.Integration
Sobald dies geschehen ist erhalten Sie von Ihrer Kommune oder uns eine “Widget-URL”. Auf der Seite auf der Sie die Integration vornehmen muss der Inhalt hinter dieser durch einen HTTP-Aufruf mit der GET-Methode und den folgenden Parametern ausgegeben werden.
urlgibt die URL an, von welcher die Integration aufgerufen wird bzw. auf der sich der Bürger momentan befindet. Der Pfad inklusive der Query-Parameter ist dabei ausreichend.user-agentgibt den User-Agent des Nutzers an. Anhand diesem wird untersucht, ob der Aufruf durch einen Crawler initiiert wurde. Der User-Agent wird nicht gespeichert.
Beispiele
Im Folgenden finden Sie Beispiele für verschiedene Server-Side-Sprachen.
Erweiterung Datenschutzerklärung
Da optiGov als s.g. externer Dienst auf der Webseite mit eingebunden wird, ist die Ergänzung der folgenden Texte innerhalb Ihrer Datenschutzerklärung empfohlen.