Änderungen von Dokument Bürgerservice Plugin

Von 24.4 nach 24.5 Von 24.6 nach 24.7

Von Version 24.5

bearbeitet von MKO
am 08.06.2023, 10:30

Änderungskommentar: Es gibt keinen Kommentar für diese Version

Auf Version 24.6

bearbeitet von rth
am 12.06.2023, 16:59

Änderungskommentar: Es gibt keinen Kommentar für diese Version

Rohform
Im Layout

Zusammenfassung

Seiteneigenschaften (3 geändert, 0 hinzugefügt, 0 gelöscht)

Details

Seiteneigenschaften

Titel

@@ -1,1 +1,1 @@
--Bürger Services Plugin
++Bürgerservice Plugin

Dokument-Autor

@@ -1,1 +1,1 @@
--XWiki.mko
++XWiki.rth

Inhalt

@@ -3,10 +3,10 @@
  (% class="box infomessage" %)
  (((
  **Achtung:**
--Bevor Sie die Bürger Services in ihre Formular-Prozesse einbinden, stellen Sie bitte sicher, dass die konfigurative Anbindung der Dienste durch einen (% class="xm-smallcaps" %)Xima® Formcycle(%%)-Administrator erfolgt ist!
++Bevor Sie die Bürgerservices in ihre Formular-Prozesse einbinden, stellen Sie bitte sicher, dass die konfigurative Anbindung der Dienste durch einen (% class="xm-smallcaps" %)Xima® Formcycle(%%)-Administrator erfolgt ist!
  )))
--Über das kostenpflichtige //Bürger Services Plugin// werden Möglichkeiten zur Einbindung verschiedener Bürger Services in (% class="xm-smallcaps" %)Xima® Formcycle(%%) bereitgestellt.
++Über das kostenpflichtige //Bürger Services Plugin// werden Möglichkeiten zur Einbindung verschiedener Bürgerservices in (% class="xm-smallcaps" %)Xima® Formcycle(%%) bereitgestellt.
  Dabei kann zwischen den Anbindungen für
  * **BundID**
@@ -15,9 +15,9 @@
  gewählt werden.
--== Einbindung der Bürger Services in Formulare ==
++== Einbindung der Bürgerservices in Formulare ==
--Für eine Einbindung der Bürger Services in (% class="xm-smallcaps" %)Xima® Formcycle(%%) Formulare bestehen grundsätzlich folgende Möglichkeiten:
++Für eine Einbindung der Bürgerservices in (% class="xm-smallcaps" %)Xima® Formcycle(%%) Formulare bestehen grundsätzlich folgende Möglichkeiten:
  * Anmeldung über Formular-Zugriffssteuerung: hier erfolgt eine Nutzer-Legitimierung **vor** der Anzeige des Formulars
  * Anmeldung über Login-Button: In diesem Szenario kann eine Nutzer-Legitimierung während der Anzeige des Formulars (zu jedem Zeitpunkt), durchgeführt werden.
@@ -25,12 +25,12 @@
  === Einbindung über Formular-Zugriff ===
  {{figure image="formularZugriff_login.png"}}
--Konfiguration der Bürger Services als Formularanmeldung
++Konfiguration der Bürgerservices als Formularanmeldung
  {{/figure}}
--Um den Login für einen oder mehrere Bürger Services über einen (% class="wikiinternallink wikiinternallink" %)[[Externen Benutzer>>path:/xwiki/bin/view/Formcycle/UserInterface/UserSettings/ExternalUsers/]](%%) am jeweiligen Formular zu ermöglichen, muss dies als (% class="wikiinternallink wikiinternallink" %)[[Formularanmeldung>>path:/xwiki/bin/view/Formcycle/UserInterface/MyForms/Access]](%%) am Formular hinterlegt sein.
++Um den Login für einen oder mehrere Bürgerservices über einen (% class="wikiinternallink wikiinternallink" %)[[Externen Benutzer>>path:/xwiki/bin/view/Formcycle/UserInterface/UserSettings/ExternalUsers/]](%%) am jeweiligen Formular zu ermöglichen, muss dies als (% class="wikiinternallink wikiinternallink" %)[[Formularanmeldung>>path:/xwiki/bin/view/Formcycle/UserInterface/MyForms/Access]](%%) am Formular hinterlegt sein.
--Die in der Auswahl zur Verfügung stehenden Bürger Services sind abhängig von der Lizenzierung, sowie vom vollständigen Konfigurations-Status der als Externe Benutzer definierten Bürger Service-Anbindungen.
++Die in der Auswahl zur Verfügung stehenden Bürgerservices sind abhängig von der Lizenzierung, sowie vom vollständigen Konfigurations-Status der als Externe Benutzer definierten Bürgerservice-Anbindungen.
  === Einbindung im Designer - per Login Button ===
@@ -39,27 +39,27 @@
  Allgemeine Einstellungen am Formular-Element //Bürger Services Login//
  {{/figure}}
--Zur vereinfachten Einbindung von einem Bürger Services innerhalb eines Formularprozesses gibt es das Formular-Element //Bürger Services Login//. Dieses kann per "Drag & Drop" in den Seitenbereich gezogen werden. Das dann vorhandene Button-Element kann im Bereich **Bürger Services: Login Einstellungen** konfiguriert werden.
++Zur vereinfachten Einbindung von einem Bürgerservices innerhalb eines Formularprozesses gibt es das Formular-Element //Bürger Services Login//. Dieses kann per "Drag & Drop" in den Seitenbereich gezogen werden. Das dann vorhandene Button-Element kann im Bereich **Bürger Services: Login Einstellungen** konfiguriert werden.
  Die nachfolgenden aufgeführten Einstellungen gelten dabei für alle Bürger Services (BundID, ELSTER etc.) gleichermaßen.
  ; Bezeichner
  : Beschriftung des Login-Buttons im Formular
  ; Authentikator
--: Hier muss ein konkreter Bürger Services aus den im System konfigurierten (% class="wikiinternallink wikiinternallink" %)[[Externen Benutzern>>path:/xwiki/bin/view/Formcycle/UserInterface/UserSettings/ExternalUsers/]](%%) ausgewählt werden. Zu diesem konkreten Bürger Service (ELSTER, BundID etc.) wird zum Aufrufzeitpunkt weitergeleitet.
++: Hier muss ein konkreter Bürgerservice aus den im System konfigurierten (% class="wikiinternallink wikiinternallink" %)[[Externen Benutzern>>path:/xwiki/bin/view/Formcycle/UserInterface/UserSettings/ExternalUsers/]](%%) ausgewählt werden. Zu diesem konkreten Bürgerservice (ELSTER, BundID etc.) wird zum Aufrufzeitpunkt weitergeleitet.
  ; Seite bei Login
  : Hier wird die Formularseite festgelegt, welche angezeigt werden soll, wenn der Login **erfolgreich **war.
  ; Seite bei Abbruch
  : Hier wird die Formularseite festgelegt, welche angezeigt werden soll, wenn der Login **abgebrochen** wurde.
  ; Element Suffix
--: Hier kann ein Suffix definiert werden, welches beim Vorbelegen von Formularelementen, mit den ermittelten Daten aus einem Bürger Service, zur Anwendung kommt.
++: Hier kann ein Suffix definiert werden, welches beim Vorbelegen von Formularelementen, mit den ermittelten Daten aus einem Bürgerservice, zur Anwendung kommt.
  Durch das Suffix wird es möglich mehrere Authentifizierungen und Formularelement-Vorbelegungen innerhalb eines Formulars zu realisieren.
  : Als Suffix sind Buchstaben, Zahlen und der Unterstrich erlaubt.
  : __Beispiel:__
  Wenn als Suffix "**_1**" definiert wurde, muss das Formularfeld für die Adresse mit dem Namen "tfAntragstellerAdresse**_1**" benannt werden, damit eine Vorbelegung erfolgreich stattfinden kann.
  ; Login im Popup
--: Wenn aktiviert, wird die Login-Seite des jeweiligen Bürger Service-Portals in einem Popup geöffnet, ansonst erfolgt die Anzeige in der gleichen Seite.
++: Wenn aktiviert, wird die Login-Seite des jeweiligen Bürgerservice-Portals in einem Popup geöffnet, ansonst erfolgt die Anzeige in der gleichen Seite.
  ; Validieren
--: Wenn aktiviert, werden die bisherigen Formulareingaben validiert. Der Start des Login-Prozesses ist dann erst möglich, wenn alle Nutzereingaben auf der Seite valide sind. Wenn deaktiviert, findet keine Überprüfung der bisherigen Formulareingaben statt und es wird sofort zum jeweiligen Bürger Service-Portal weitergeleitet.
++: Wenn aktiviert, werden die bisherigen Formulareingaben validiert. Der Start des Login-Prozesses ist dann erst möglich, wenn alle Nutzereingaben auf der Seite valide sind. Wenn deaktiviert, findet keine Überprüfung der bisherigen Formulareingaben statt und es wird sofort zum jeweiligen Bürgerservice-Portal weitergeleitet.
  ==== Zusätzliche Konfigurationsmöglichkeiten für **BundID** / **BayernID** ====
@@ -67,8 +67,8 @@
  Erweiterte Einstellungen am Formular-Element //Bürger Services Login// für **BundID** und **BayernID**
  {{/figure}}
--Die nachfolgend beschriebenen Konfigurationsmöglichkeiten stehen nur im Zusammenhang mit den Bürger Services von BundID und BayernID zur Verfügung
--und ermöglichen es die Anmeldemöglichkeiten, sowie die zurück gelieferten Daten aus dem jeweiligen Bürger Service-Portal zu beeinflussen.
++Die nachfolgend beschriebenen Konfigurationsmöglichkeiten stehen nur im Zusammenhang mit den Bürgerservices von BundID und BayernID zur Verfügung
++und ermöglichen es die Anmeldemöglichkeiten, sowie die zurück gelieferten Daten aus dem jeweiligen Bürgerservice-Portal zu beeinflussen.
  ; Vertrauensniveau
  : Hier kann das dem Nutzer zur Verfügung stehende Authentifizierungsverfahren eingeschränkt werden.
@@ -99,11 +99,11 @@
  : Über diese Checkbox-Auswahl kann der Nutzer die zurück gelieferten Eigenschaften einer erfolgreichen Authentifizierung einschränken.
  : Damit wird dem Grundsatz der Datensparsamkeit der DSGVO (Datenschutz-Grundverordnung) entsprochen. Sind beispielsweise nur der Name und der Vorname einer Person in einem Formularprozess notwendig,
  : so sind nur die entsprechenden Felder in dieser Auswahlliste zu selektieren.
--: Ist nichts ausgewählt, erfolgt keine Einschränkung und alle möglichen Eigenschaften werden vom jeweiligen Bürger Service-Portal angefordert.
++: Ist nichts ausgewählt, erfolgt keine Einschränkung und alle möglichen Eigenschaften werden vom jeweiligen Bürgerservice-Portal angefordert.
  ; Nur mit Postkorb
  : Diese Einstellung ermöglich es die Postkorb-ID als verpflichtendes Rückgabe-Attribut zu kennzeichnen.
--: Auf Seiten des Bürger Service-Portals werden dann alle Authentifizierungsarten, die keinen Postkorbversand ermöglichen, für den Nutzer ausgeblendet.
--Mit dieser Einstellung wird sichergestellt, dass bei einer erfolgreichen Nutzer-Authentifizierung immer ein nachgeordneter Nachrichtenversand an den Postkorb des Nutzers im jeweiligen Bürger Service-Portal möglich ist.
++: Auf Seiten des Bürgerservice-Portals werden dann alle Authentifizierungsarten, die keinen Postkorbversand ermöglichen, für den Nutzer ausgeblendet.
++Mit dieser Einstellung wird sichergestellt, dass bei einer erfolgreichen Nutzer-Authentifizierung immer ein nachgeordneter Nachrichtenversand an den Postkorb des Nutzers im jeweiligen Bürgerservice-Portal möglich ist.
  == Anzeige der Anmeldedaten im Formular ==
@@ -115,10 +115,10 @@
  Elementkatalog mit allen möglichen Datenelementen
  {{/figure}}
--Um die Daten aus dem jeweiligen Bürger Service-Portal im Formular anzuzeigen, existieren unterschiedliche Vorlagen im Designer. Diese Vorlagen sind nach dem Schwerpunkt, ob sie für eine Anzeige von Personen- oder Organisationsdaten eingesetzt werden sollen, gestaltet. Sie enthalten bereits eine Reihe sinnvoller Elemente für die Datenanzeige, können aber mit weiteren Elementen (auch eigens Definierten) erweitert werden.
++Um die Daten aus dem jeweiligen Bürgerservice-Portal im Formular anzuzeigen, existieren unterschiedliche Vorlagen im Designer. Diese Vorlagen sind nach dem Schwerpunkt, ob sie für eine Anzeige von Personen- oder Organisationsdaten eingesetzt werden sollen, gestaltet. Sie enthalten bereits eine Reihe sinnvoller Elemente für die Datenanzeige, können aber mit weiteren Elementen (auch eigens Definierten) erweitert werden.
  Für die Erweiterung der Anzeigedaten steht der ebenfalls im Designer eingebundene Elementkatalog //Bürger Services Elemente //zur Verfügung//.//
--Die aus dem Bürger Service-Portal zurück gelieferten Daten können mittels JavaScript auch anderweitig weiterverarbeitet werden. Dafür werden sie in Form einer JSON-Struktur im Zielformular zur Verfügung gestellt. Die JSON Struktur kann über folgende JavaScript-Variable ausgelesen werden:
++Die aus dem Bürgerservice-Portal zurück gelieferten Daten können mittels JavaScript auch anderweitig weiterverarbeitet werden. Dafür werden sie in Form einer JSON-Struktur im Zielformular zur Verfügung gestellt. Die JSON Struktur kann über folgende JavaScript-Variable ausgelesen werden:
  (% class="box" %)
@@ -149,7 +149,7 @@
  ==== Darstellung der Nutzerdaten nach Anmeldung ====
--Nach einer Anmeldung am Bürger Service-Portal sind die Eingabefelder innerhalb der Datenvorlage für eine Bearbeitung gesperrt, welche durch den Authentifizierungsprozess befüllt wurden.
++Nach einer Anmeldung am Bürgerservice-Portal sind die Eingabefelder innerhalb der Datenvorlage für eine Bearbeitung gesperrt, welche durch den Authentifizierungsprozess befüllt wurden.
  Alle übrigen Felder innerhalb der Vorlage, können dann standardmäßig durch den angemeldeten Benutzer bearbeitet werden, wenn im Designer für diese Felder nichts gegenteiliges festgelegt wurde.
  Zusätzlich werden die Felder bei Wiederanzeige durch kleine Icons gekennzeichnet, wodurch ersichtlich wird aus welcher Quelle die Anmeldeinformationen entstammen.
@@ -166,9 +166,9 @@
  == Übersicht Element-Matrix ==
--Die nachfolgenden Tabelle listet alle Formular-Elemente auf, die im Zusammenhang mit den Bürger Services existieren. Dabei werden nicht alle Elemente durch jeden angebundenen Bürger Service gleichermaßen befüllt, bzw. die Elementdaten können je nach genutzten Authentifizierungsverfahren innerhalb des jeweiligen Bürger Service Portal zurück oder auch nicht zurück geliefert werden.
++Die nachfolgenden Tabelle listet alle Formular-Elemente auf, die im Zusammenhang mit den Bürgerservices existieren. Dabei werden nicht alle Elemente durch jeden angebundenen Bürgerservice gleichermaßen befüllt, bzw. die Elementdaten können je nach genutzten Authentifizierungsverfahren innerhalb des jeweiligen Bürgerservice Portal zurück oder auch nicht zurück geliefert werden.
--Hinweis: Die Tabelle gibt den aktuell entnommen Stand aus den Dokumentationen der jeweiligen Bürger Service-Portale (BundID, BayernID und ELSTER) wieder und erhebt deshalb nicht den Anspruch der Vollständigkeit.
++Hinweis: Die Tabelle gibt den aktuell entnommen Stand aus den Dokumentationen der jeweiligen Bürgerservice-Portale (BundID, BayernID und ELSTER) wieder und erhebt deshalb nicht den Anspruch der Vollständigkeit.
  (% style="margin-right:auto" %)
@@ -275,7 +275,7 @@
  Workflow mit Bedingung für Prüfung des Authentifikationslevels und einer Postkorb Nachricht versenden Aktion
  {{/figure}}
--Für die Anbindung zum Versand Nachrichten an den Postkorb des jeweiligen Bürger Service steht die Workflow-Aktion //Postkorbnachricht senden// zur Verfügung.
++Für die Anbindung zum Versand Nachrichten an den Postkorb des jeweiligen Bürgerservice steht die Workflow-Aktion //Postkorbnachricht senden// zur Verfügung.
  Mittels dieser Workflow-Aktion können (ähnlich einer E-Mail Aktion) Nachrichten weitergeleitet werden, wenn zum Ausführungszeitpunkt eine Postkorb ID ermittelt werden kann.
  Die Konfigurationsoberfläche der Aktion ist in einzelne Bereiche unterteilt die nachfolgend kurz beschrieben werden.
@@ -291,7 +291,7 @@
  ; Dienst
  : Wird als Information in der Postkorb-Ansicht im Bürgerservice-Portal verwendet.
  ; Absender-Link
--: Falls sich die Angabe im Feld Mandant auf einen Mandanten bezieht, der nicht im Bürger Service-Portal registriert ist, kann über den Absender-Link ein Link mitgegeben werden,
++: Falls sich die Angabe im Feld Mandant auf einen Mandanten bezieht, der nicht im Bürgerservice-Portal registriert ist, kann über den Absender-Link ein Link mitgegeben werden,
  : mit dem der Mandant bei der Anzeige im Postkorb der **BundID **oder **BayernID **verlinkt wird.
  ; TransferId-Referenz
  : Diese Eigenschaft findet nur in Zusammenhang mit der Postkorbanbindung von **ELSTER** Verwendung.
@@ -305,7 +305,7 @@
  ; Postkorb ID aus einer Anmeldung innerhalb der Vorgangsdaten ermitteln?
  : Diese Angabe dient zur Bestimmung der Postkorb ID. Über diese ID wird das genaue Ziel für den Nachrichtenversand bestimmt, also der Nachrichten-Empfänger.
--: Wird bei einem Bürger Service-Login die Postkorb ID übermittelt, so wird diese standardmäßig am Formulareingang hinterlegt. Für den Fall, dass es mehrere konfigurierte Anmeldungen
++: Wird bei einem Bürgerservice-Login die Postkorb ID übermittelt, so wird diese standardmäßig am Formulareingang hinterlegt. Für den Fall, dass es mehrere konfigurierte Anmeldungen
  : innerhalb eines Formulars gibt, kann die Auswahl über den Daten-Suffix eingegrenzt werden.
  : Darüber hinaus ist es möglich die Postkorb-ID fest oder über einen Platzhalter **[%$POSTKORB%]** zu definieren. (Diese Platzhalter wird über das Plugin zur Verfügung gestellt.)
  : Wird an dieser Stelle die standardmäßig ausgewählte Einstellung entfernt, so werden andere Konfigurationseigenschaften sichtbar, welche das direkte Festlegen einer Postkorb ID ermöglichen:
@@ -312,7 +312,7 @@
  :; Postkorb ID (Pflichtfeld)
  :: Hier ist die Angabe einer konkreten Postkorb ID erforderlich. Diese muss zur Laufzeit mit dem in Feld //Webservice Umgebung// definierten Authentikator korrespondieren.
  :; Webservice Umgebung
--:: Hier werden alle registrierten Bürger Service Authentikatoren zur Auswahl aufgeführt. Es muss  darauf geachtet werden, dass der gewählte Authenticator den angebundenen Bürger Service widerspiegelt, in dessen Kontext zur Laufzeit die Postkorb ID verortet ist.
++:: Hier werden alle registrierten Bürgerservice Authentikatoren zur Auswahl aufgeführt. Es muss  darauf geachtet werden, dass der gewählte Authenticator den angebundenen Bürgerservice widerspiegelt, in dessen Kontext zur Laufzeit die Postkorb ID verortet ist.
  ; Vertrauensniveau der Anmeldung für Zugriff auf Postkorb-Nachricht weiterreichen?
  : Diese Option steht nur im BundID und BayernID Portal zur Verfügung.
  : Hier können Sie festlegen, ob das Vertrauensniveau der Anmeldung (wenn dies ermittelt werden kann) für den Zugriff auf die Postkorb-Nachricht weitergereicht werden soll.
@@ -337,7 +337,7 @@
  : Nachrichtentext. Es werden Platzhalter unterstützt.
  ; Anhänge
  : Hier können Dateien als Attachments an die Postkorb-Nachricht gehangen werden.
--: Die dabei unterstützten Dateiformat unterscheiden sich dabei je nach genutzten Bürger Service:
++: Die dabei unterstützten Dateiformat unterscheiden sich dabei je nach genutzten Bürgerservice:
  : Zur Auswahl stehen dabei:
  :; Dateien aus vorherigen Aktionen
  :: Eine Liste mit Dateien, von Datei-bereitstellenden Aktionen, die der Postkorb-Aktion vorangestellt sind.
@@ -361,7 +361,7 @@
  Mit diesem Element kann das Vertrauensniveau, auf dessen Grundlage sich ein Nutzer am Formular authentifiziert hat, abgeprüft und für eine unterschiedliche Ausführung von Verarbeitungsketten genutzt werden.
  ; Prüfung des Authentifizierungslevels
--: Zur Auswahl stehen die einzelnen Authentifizierungslevel (normal, substanziell und hoch), sowie die Festlegung kein, dass explizit keine Bürger Service Authentifizierung stattgefunden hat. Es wird eine Mehrfachauswahl unterstützt.
++: Zur Auswahl stehen die einzelnen Authentifizierungslevel (normal, substanziell und hoch), sowie die Festlegung kein, dass explizit keine Bürgerservice Authentifizierung stattgefunden hat. Es wird eine Mehrfachauswahl unterstützt.
  ; Festlegung der zu prüfenden Authentifizierung
  : Prinzipiell können sich an einem Formular mehrere Nutzer authentifizieren. Um die einzelnen Anmeldungen im Workflow zu unterscheiden und festzulegen welches Vertrauensniveau für die Prüfung herangezogen werden soll, muss der Daten-Suffix angegeben werden.
  : Die Standardeinstellung ist: //kein Daten-Suffix//