Änderungen von Dokument Bürgerservice Plugin

Von 14.12 nach 14.13 Von 14.14 nach 14.15

Von Version 14.13

bearbeitet von rth
am 09.05.2023, 10:38

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

Auf Version 14.14

bearbeitet von rth
am 09.05.2023, 10:39

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

Rohform
Im Layout

Zusammenfassung

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

Details

Seiteneigenschaften

Inhalt

@@ -1,9 +1,10 @@
--{{info}}
++(% 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 {{formcycle/}}-Administrator erfolgt ist!
--{{/info}}
++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!
++)))
--Über das kostenpflichtige //Bürger Services Plugin// werden Möglichkeiten zur Einbindung verschiedener Bürger Services in {{formcycle/}} bereitgestellt.
++Über das kostenpflichtige //Bürger Services Plugin// werden Möglichkeiten zur Einbindung verschiedener Bürger Services in (% class="xm-smallcaps" %)Xima® Formcycle(%%) bereitgestellt.
  Dabei kann zwischen den Anbindungen für
  * **BundID**
@@ -14,7 +14,7 @@
  == Einbindung der Bürger Services in Formulare ==
--Für eine Einbindung der Bürger Services in {{formcycle/}} Formulare bestehen grundsätzlich folgende Möglichkeiten:
++Für eine Einbindung der Bürger Services 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.
@@ -21,11 +21,21 @@
  === Einbindung über Formular-Zugriff ===
--{{figure image="formularZugriff_login.png"}}
++
++(% class="xm-figure xm-float-right xm-clear-h2" data-alt="Konfiguration der Bürger Services als Formularanmeldung" %)
++(((
++(% class="xm-figure-inner" style="width:310px" %)
++(((
++[[~[~[image:/xwiki/bin/download/Formcycle/PluginDocumentation/Buerger%20Services-Plugin/WebHome/formularZugriff_login.png?rev=1.2~|~|width="300"~]~]>>path:/xwiki/bin/download/Formcycle/PluginDocumentation/Buerger%20Services-Plugin/WebHome/formularZugriff_login.png?rev=1.2||rel="lightbox[$group]" title="Konfiguration der Bürger Services als Formularanmeldung"]]
++
++(% class="xm-figure-caption" %)
++(((
  Konfiguration der Bürger Services als Formularanmeldung
--{{/figure}}
++)))
++)))
++)))
--Um den Login für einen oder mehrere Bürger Services über einen [[Externen Benutzer>>path:/xwiki/bin/view/Formcycle/UserInterface/UserSettings/ExternalUsers/]] am jeweiligen Formular zu ermöglichen, muss dies als [[Formularanmeldung>>path:/xwiki/bin/view/Formcycle/UserInterface/MyForms/Access]] am Formular hinterlegt sein.
++Um den Login für einen oder mehrere Bürger Services über einen (% class="wikiinternallink" %)[[Externen Benutzer>>path:/xwiki/bin/view/Formcycle/UserInterface/UserSettings/ExternalUsers/]](%%) am jeweiligen Formular zu ermöglichen, muss dies als (% class="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.
@@ -32,9 +32,19 @@
  === Einbindung im Designer - per Login Button ===
--{{figure image="designer_loginBtn.png"}}
++
++(% class="xm-figure xm-float-right xm-clear-h2" data-alt="Allgemeine Einstellungen am Formular-Element Bürger Services Login" %)
++(((
++(% class="xm-figure-inner" style="width:310px" %)
++(((
++[[~[~[image:/xwiki/bin/download/Formcycle/PluginDocumentation/Buerger%20Services-Plugin/WebHome/designer_loginBtn.png?rev=1.1~|~|width="300"~]~]>>path:/xwiki/bin/download/Formcycle/PluginDocumentation/Buerger%20Services-Plugin/WebHome/designer_loginBtn.png?rev=1.1||rel="lightbox[$group]" title="Allgemeine Einstellungen am Formular-Element Bürger Services Login"]]
++
++(% class="xm-figure-caption" %)
++(((
  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.
  Die nachfolgenden aufgeführten Einstellungen gelten dabei für alle Bürger Services (BundID, ELSTER etc.) gleichermaßen.
@@ -42,7 +42,7 @@
  ; Bezeichner
  : Beschriftung des Login-Buttons im Formular
  ; Authentikator
--: Hier muss ein konkreter Bürger Services aus den im System konfigurierten [[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ürger Services aus den im System konfigurierten (% class="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.
  ; Seite bei Login
  : Hier wird die Formularseite festgelegt, welche angezeigt werden soll, wenn der Login **erfolgreich **war.
  ; Seite bei Abbruch
@@ -60,9 +60,19 @@
  ==== Zusätzliche Konfigurationsmöglichkeiten für **BundID** / **BayernID** ====
--{{figure image="designer_loginBtn_ext.png"}}
++
++(% class="xm-figure xm-float-right xm-clear-h2" data-alt="Erweiterte Einstellungen am Formular-Element Bürger Services Login für BundID und BayernID" %)
++(((
++(% class="xm-figure-inner" style="width:310px" %)
++(((
++[[~[~[image:/xwiki/bin/download/Formcycle/PluginDocumentation/Buerger%20Services-Plugin/WebHome/designer_loginBtn_ext.png?rev=1.1~|~|width="300"~]~]>>path:/xwiki/bin/download/Formcycle/PluginDocumentation/Buerger%20Services-Plugin/WebHome/designer_loginBtn_ext.png?rev=1.1||rel="lightbox[$group]" title="Erweiterte Einstellungen am Formular-Element Bürger Services Login für BundID und BayernID"]]
++
++(% class="xm-figure-caption" %)
++(((
  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.
@@ -104,13 +104,33 @@
  == Anzeige der Anmeldedaten im Formular ==
--{{figure image="designer_vorlage.png"}}
++
++(% class="xm-figure xm-float-right xm-clear-h2" data-alt="Elementvorlagen zur Datenanzeige" %)
++(((
++(% class="xm-figure-inner" style="width:310px" %)
++(((
++[[~[~[image:/xwiki/bin/download/Formcycle/PluginDocumentation/Buerger%20Services-Plugin/WebHome/designer_vorlage.png?rev=1.1~|~|width="300"~]~]>>path:/xwiki/bin/download/Formcycle/PluginDocumentation/Buerger%20Services-Plugin/WebHome/designer_vorlage.png?rev=1.1||rel="lightbox[$group]" title="Elementvorlagen zur Datenanzeige"]]
++
++(% class="xm-figure-caption" %)
++(((
  Elementvorlagen zur Datenanzeige
--{{/figure}}
++)))
++)))
++)))
--{{figure image="designer_elementkatalog.png"}}
++
++(% class="xm-figure xm-float-right xm-clear-h2" data-alt="Elementkatalog mit allen möglichen Datenelementen" %)
++(((
++(% class="xm-figure-inner" style="width:310px" %)
++(((
++[[~[~[image:/xwiki/bin/download/Formcycle/PluginDocumentation/Buerger%20Services-Plugin/WebHome/designer_elementkatalog.png?rev=1.1~|~|width="300"~]~]>>path:/xwiki/bin/download/Formcycle/PluginDocumentation/Buerger%20Services-Plugin/WebHome/designer_elementkatalog.png?rev=1.1||rel="lightbox[$group]" title="Elementkatalog mit allen möglichen Datenelementen"]]
++
++(% class="xm-figure-caption" %)
++(((
  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.
@@ -119,15 +119,29 @@
  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:
--{{code language="javascript"}}
++(% class="box" %)
++(((
++(% class="code" %)
++(((
  XFC_METADATA.pluginResults.XM_BuergerServicesLoginAnalyzer
--{{/code}}
++)))
++)))
  === Darstellung des genutzten Authentifizierungsverfahren ===
--{{figure image="formular_trustlevel_visualisierung.png"}}
++
++(% class="xm-figure xm-float-right xm-clear-h2" data-alt="Darstellung des verwendeten Vertrauensniveaus in einer Datenvorlage" %)
++(((
++(% class="xm-figure-inner" style="width:310px" %)
++(((
++[[~[~[image:/xwiki/bin/download/Formcycle/PluginDocumentation/Buerger%20Services-Plugin/WebHome/formular_trustlevel_visualisierung.png?rev=1.1~|~|width="300"~]~]>>path:/xwiki/bin/download/Formcycle/PluginDocumentation/Buerger%20Services-Plugin/WebHome/formular_trustlevel_visualisierung.png?rev=1.1||rel="lightbox[$group]" title="Darstellung des verwendeten Vertrauensniveaus in einer Datenvorlage"]]
++
++(% class="xm-figure-caption" %)
++(((
  Darstellung des verwendeten Vertrauensniveaus in einer Datenvorlage
--{{/figure}}
++)))
++)))
++)))
  Bei Nutzung der Vorlagen aus dem Designer ist nach dem Absenden des Formulars, sowie bei der Wiederanzeige des Formulars im Postfach, das durch den Nutzer verwendete Authentifizierungsverfahren anhand einer visuellen Markierung ersichtlich.
@@ -137,9 +137,19 @@
  * Level 3 (Authentifizierung mittels Zertifikat, Vertrauensniveau nach BSI: //substanziell//): **Zertifikat**
  * Level 4 (Authentifizierung mittels Personalausweis (eID) oder vergleichbaren Authentifizierungsmittel (eIDAS), Vertrauensniveau nach BSI: //hoch//): **Personalausweis**
--{{figure image="formular_trustlevel_keine_visualisierung.png"}}
++
++(% class="xm-figure xm-float-right xm-clear-h2" data-alt="Wenn keine visuelle Markierung gewünscht ist, so kann dies durch ein zusätzliches Attribut „noRibbon“ am Vorlagen-Fieldset unterbunden werden" %)
++(((
++(% class="xm-figure-inner" style="width:310px" %)
++(((
++[[~[~[image:/xwiki/bin/download/Formcycle/PluginDocumentation/Buerger%20Services-Plugin/WebHome/formular_trustlevel_keine_visualisierung.png?rev=1.1~|~|width="300"~]~]>>path:/xwiki/bin/download/Formcycle/PluginDocumentation/Buerger%20Services-Plugin/WebHome/formular_trustlevel_keine_visualisierung.png?rev=1.1||rel="lightbox[$group]" title="Wenn keine visuelle Markierung gewünscht ist, so kann dies durch ein zusätzliches Attribut „noRibbon“ am Vorlagen-Fieldset unterbunden werden"]]
++
++(% class="xm-figure-caption" %)
++(((
  Wenn keine visuelle Markierung gewünscht ist, so kann dies durch ein zusätzliches Attribut „noRibbon“ am Vorlagen-Fieldset unterbunden werden
--{{/figure}}
++)))
++)))
++)))
  ==== Darstellung der Nutzerdaten nach Anmeldung ====
@@ -148,8 +148,8 @@
  Zusätzlich werden die Felder bei Wiederanzeige durch kleine Icons gekennzeichnet, wodurch ersichtlich wird aus welcher Quelle die Anmeldeinformationen entstammen.
--* [[image:verified.png||alt="Icon für Informationen aus Bürgerservice-Portal" height="22" width="21"]] Felder mit diesem Icon wurden aus dem Bürgerservice-Portal übermittelt
--* [[image:none_verified.png||alt="Icon für Informationen die der Nutzer nachträglich eingegeben hat" height="20" width="23"]] Felder mit diesem Icon wurden vom Nutzer nachträglich eingegeben und wurden deshalb nicht durch einen Identitätsprüfer verifiziert
++* [[image:/xwiki/bin/download/Formcycle/PluginDocumentation/Buerger%20Services-Plugin/WebHome/verified.png?width=21&height=22&rev=1.1||alt="Icon für Informationen aus Bürgerservice-Portal" height="22" width="21"]] Felder mit diesem Icon wurden aus dem Bürgerservice-Portal übermittelt
++* [[image:/xwiki/bin/download/Formcycle/PluginDocumentation/Buerger%20Services-Plugin/WebHome/none_verified.png?width=23&height=20&rev=1.1||alt="Icon für Informationen die der Nutzer nachträglich eingegeben hat" height="20" width="23"]] Felder mit diesem Icon wurden vom Nutzer nachträglich eingegeben und wurden deshalb nicht durch einen Identitätsprüfer verifiziert
  Die Feld-Icons werden mittels CSS-Klassen an den Eingabe-Elementen hinzugefügt und können dadurch mittels eigenem CSS Definitionen übersteuert werden. Die dafür notwendigen Klassen haben folgende Namen: