| ... |
... |
@@ -1,3 +1,5 @@ |
|
1 |
+[[**Plugin-Download**>>url:https://customer.formcycle.eu/index.php/apps/files/?dir=/FORMCYCLE%20-%20Plugins%20Customer/B%C3%BCrgerservice%20Plugin%20(buerger-service)&fileid=52647||rel="noopener noreferrer" target="_blank"]] (erfordert Anmeldung) |
|
2 |
+ |
| 1 |
1 |
(% class="box infomessage" %) |
| 2 |
2 |
((( |
| 3 |
3 |
**Achtung:** |
| ... |
... |
@@ -22,19 +22,9 @@ |
| 22 |
22 |
|
| 23 |
23 |
=== Einbindung über Formular-Zugriff === |
| 24 |
24 |
|
| 25 |
|
- |
| 26 |
|
-(% class="xm-figure xm-float-right xm-clear-h2" data-alt="Konfiguration der Bürger Services als Formularanmeldung" %) |
| 27 |
|
-((( |
| 28 |
|
-(% class="xm-figure-inner" style="width:310px" %) |
| 29 |
|
-((( |
| 30 |
|
-(% class="wikiinternallink" %)[[~[~[image:/xwiki/bin/download/Formcycle/PluginDocumentation/Buerger%20Services-Plugin/WebHome/formularZugriff_login.png?width=300&rev=1.2~|~|alt="/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"]] |
| 31 |
|
- |
| 32 |
|
-(% class="xm-figure-caption" %) |
| 33 |
|
-((( |
|
27 |
+{{figure image="formularZugriff_login.png"}} |
| 34 |
34 |
Konfiguration der Bürger Services als Formularanmeldung |
| 35 |
|
-))) |
| 36 |
|
-))) |
| 37 |
|
-))) |
|
29 |
+{{/figure}} |
| 38 |
38 |
|
| 39 |
39 |
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. |
| 40 |
40 |
|
| ... |
... |
@@ -43,19 +43,9 @@ |
| 43 |
43 |
|
| 44 |
44 |
=== Einbindung im Designer - per Login Button === |
| 45 |
45 |
|
| 46 |
|
- |
| 47 |
|
-(% class="xm-figure xm-float-right xm-clear-h2" data-alt="Allgemeine Einstellungen am Formular-Element Bürger Services Login" %) |
| 48 |
|
-((( |
| 49 |
|
-(% class="xm-figure-inner" style="width:310px" %) |
| 50 |
|
-((( |
| 51 |
|
-(% class="wikiinternallink" %)[[~[~[image:/xwiki/bin/download/Formcycle/PluginDocumentation/Buerger%20Services-Plugin/WebHome/designer_loginBtn.png?width=300&rev=1.1~|~|alt="/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"]] |
| 52 |
|
- |
| 53 |
|
-(% class="xm-figure-caption" %) |
| 54 |
|
-((( |
|
38 |
+{{figure image="designer_loginBtn.png"}} |
| 55 |
55 |
Allgemeine Einstellungen am Formular-Element //Bürger Services Login// |
| 56 |
|
-))) |
| 57 |
|
-))) |
| 58 |
|
-))) |
|
40 |
+{{/figure}} |
| 59 |
59 |
|
| 60 |
60 |
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. |
| 61 |
61 |
Die nachfolgenden aufgeführten Einstellungen gelten dabei für alle Bürger Services (BundID, ELSTER etc.) gleichermaßen. |
| ... |
... |
@@ -81,19 +81,9 @@ |
| 81 |
81 |
|
| 82 |
82 |
==== Zusätzliche Konfigurationsmöglichkeiten für **BundID** / **BayernID** ==== |
| 83 |
83 |
|
| 84 |
|
- |
| 85 |
|
-(% 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" %) |
| 86 |
|
-((( |
| 87 |
|
-(% class="xm-figure-inner" style="width:310px" %) |
| 88 |
|
-((( |
| 89 |
|
-(% class="wikiinternallink" %)[[~[~[image:/xwiki/bin/download/Formcycle/PluginDocumentation/Buerger%20Services-Plugin/WebHome/designer_loginBtn_ext.png?width=300&rev=1.1~|~|alt="/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"]] |
| 90 |
|
- |
| 91 |
|
-(% class="xm-figure-caption" %) |
| 92 |
|
-((( |
|
66 |
+{{figure image="designer_loginBtn_ext.png"}} |
| 93 |
93 |
Erweiterte Einstellungen am Formular-Element //Bürger Services Login// für **BundID** und **BayernID** |
| 94 |
|
-))) |
| 95 |
|
-))) |
| 96 |
|
-))) |
|
68 |
+{{/figure}} |
| 97 |
97 |
|
| 98 |
98 |
Die nachfolgend beschriebenen Konfigurationsmöglichkeiten stehen nur im Zusammenhang mit den Bürger Services von BundID und BayernID zur Verfügung |
| 99 |
99 |
und ermöglichen es die Anmeldemöglichkeiten, sowie die zurück gelieferten Daten aus dem jeweiligen Bürger Service-Portal zu beeinflussen. |
| ... |
... |
@@ -135,35 +135,14 @@ |
| 135 |
135 |
|
| 136 |
136 |
== Anzeige der Anmeldedaten im Formular == |
| 137 |
137 |
|
| 138 |
|
- |
| 139 |
|
-(% class="xm-figure xm-float-right xm-clear-h2" data-alt="Elementvorlagen zur Datenanzeige" %) |
| 140 |
|
-((( |
| 141 |
|
-(% class="xm-figure-inner" style="width:310px" %) |
| 142 |
|
-((( |
| 143 |
|
-(% class="wikiinternallink" %)[[~[~[image:/xwiki/bin/download/Formcycle/PluginDocumentation/Buerger%20Services-Plugin/WebHome/designer_vorlage.png?width=300&rev=1.1~|~|alt="/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"]] |
| 144 |
|
- |
| 145 |
|
-(% class="xm-figure-caption" %) |
| 146 |
|
-((( |
|
110 |
+{{figure image="designer_vorlage.png"}} |
| 147 |
147 |
Elementvorlagen zur Datenanzeige |
| 148 |
|
-))) |
| 149 |
|
-))) |
| 150 |
|
-))) |
|
112 |
+{{/figure}} |
| 151 |
151 |
|
| 152 |
|
- |
| 153 |
|
-(% class="xm-figure xm-float-right xm-clear-h2" data-alt="Elementkatalog mit allen möglichen Datenelementen" %) |
| 154 |
|
-((( |
| 155 |
|
-(% class="xm-figure-inner" style="width:310px" %) |
| 156 |
|
-((( |
| 157 |
|
-(% class="wikiinternallink" %)[[~[~[image:/xwiki/bin/download/Formcycle/PluginDocumentation/Buerger%20Services-Plugin/WebHome/designer_elementkatalog.png?width=300&rev=1.1~|~|alt="/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"]] |
| 158 |
|
- |
| 159 |
|
-(% class="xm-figure-caption" %) |
| 160 |
|
-((( |
|
114 |
+{{figure image="designer_elementkatalog.png"}} |
| 161 |
161 |
Elementkatalog mit allen möglichen Datenelementen |
| 162 |
|
-))) |
| 163 |
|
-))) |
| 164 |
|
-))) |
|
116 |
+{{/figure}} |
| 165 |
165 |
|
| 166 |
|
- |
| 167 |
167 |
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. |
| 168 |
168 |
Für die Erweiterung der Anzeigedaten steht der ebenfalls im Designer eingebundene Elementkatalog //Bürger Services Elemente //zur Verfügung//.// |
| 169 |
169 |
|
| ... |
... |
@@ -180,19 +180,9 @@ |
| 180 |
180 |
|
| 181 |
181 |
=== Darstellung des genutzten Authentifizierungsverfahren === |
| 182 |
182 |
|
| 183 |
|
- |
| 184 |
|
-(% class="xm-figure xm-float-right xm-clear-h2" data-alt="Darstellung des verwendeten Vertrauensniveaus in einer Datenvorlage" %) |
| 185 |
|
-((( |
| 186 |
|
-(% class="xm-figure-inner" style="width:310px" %) |
| 187 |
|
-((( |
| 188 |
|
-(% class="wikiinternallink" %)[[~[~[image:/xwiki/bin/download/Formcycle/PluginDocumentation/Buerger%20Services-Plugin/WebHome/formular_trustlevel_visualisierung.png?width=300&rev=1.1~|~|alt="/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"]] |
| 189 |
|
- |
| 190 |
|
-(% class="xm-figure-caption" %) |
| 191 |
|
-((( |
|
134 |
+{{figure image="formular_trustlevel_visualisierung.png"}} |
| 192 |
192 |
Darstellung des verwendeten Vertrauensniveaus in einer Datenvorlage |
| 193 |
|
-))) |
| 194 |
|
-))) |
| 195 |
|
-))) |
|
136 |
+{{/figure}} |
| 196 |
196 |
|
| 197 |
197 |
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. |
| 198 |
198 |
|
| ... |
... |
@@ -202,18 +202,9 @@ |
| 202 |
202 |
* Level 3 (Authentifizierung mittels Zertifikat, Vertrauensniveau nach BSI: //substanziell//): **Zertifikat** |
| 203 |
203 |
* Level 4 (Authentifizierung mittels Personalausweis (eID) oder vergleichbaren Authentifizierungsmittel (eIDAS), Vertrauensniveau nach BSI: //hoch//): **Personalausweis** |
| 204 |
204 |
|
| 205 |
|
-(% 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" %) |
| 206 |
|
-((( |
| 207 |
|
-(% class="xm-figure-inner" style="width:310px" %) |
| 208 |
|
-((( |
| 209 |
|
-(% class="wikiinternallink" %)[[~[~[image:/xwiki/bin/download/Formcycle/PluginDocumentation/Buerger%20Services-Plugin/WebHome/formular_trustlevel_keine_visualisierung.png?width=300&rev=1.1~|~|alt="/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"]] |
| 210 |
|
- |
| 211 |
|
-(% class="xm-figure-caption" %) |
| 212 |
|
-((( |
|
146 |
+{{figure image="formular_trustlevel_keine_visualisierung.png"}} |
| 213 |
213 |
Wenn keine visuelle Markierung gewünscht ist, so kann dies durch ein zusätzliches Attribut „noRibbon“ am Vorlagen-Fieldset unterbunden werden |
| 214 |
|
-))) |
| 215 |
|
-))) |
| 216 |
|
-))) |
|
148 |
+{{/figure}} |
| 217 |
217 |
|
| 218 |
218 |
==== Darstellung der Nutzerdaten nach Anmeldung ==== |
| 219 |
219 |
|
| ... |
... |
@@ -222,8 +222,8 @@ |
| 222 |
222 |
|
| 223 |
223 |
Zusätzlich werden die Felder bei Wiederanzeige durch kleine Icons gekennzeichnet, wodurch ersichtlich wird aus welcher Quelle die Anmeldeinformationen entstammen. |
| 224 |
224 |
|
| 225 |
|
-* [[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 |
| 226 |
|
-* [[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 |
|
157 |
+* [[image:attach: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 |
|
158 |
+* [[image:attach: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 |
| 227 |
227 |
|
| 228 |
228 |
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: |
| 229 |
229 |
|
| ... |
... |
@@ -333,6 +333,10 @@ |
| 333 |
333 |
|
| 334 |
334 |
== Anbindung Postkorb im Workflow == |
| 335 |
335 |
|
|
268 |
+{{figure image="workflow_bedingung_aktion.png"}} |
|
269 |
+Workflow mit Bedingung für Prüfung des Authentifikationslevels und einer Postkorb Nachricht versenden Aktion |
|
270 |
+{{/figure}} |
|
271 |
+ |
| 336 |
336 |
Für die Anbindung zum Versand Nachrichten an den Postkorb des jeweiligen Bürger Service steht die Workflow-Aktion //Postkorbnachricht senden// zur Verfügung. |
| 337 |
337 |
Mittels dieser Workflow-Aktion können (ähnlich einer E-Mail Aktion) Nachrichten weitergeleitet werden, wenn zum Ausführungszeitpunkt eine Postkorb ID ermittelt werden kann. |
| 338 |
338 |
|
| ... |
... |
@@ -340,6 +340,10 @@ |
| 340 |
340 |
|
| 341 |
341 |
=== Absender === |
| 342 |
342 |
|
|
279 |
+{{figure image="workflow_postkorb_absender.png"}} |
|
280 |
+Einstellungen für den Absender einer Postkorb Nachricht |
|
281 |
+{{/figure}} |
|
282 |
+ |
| 343 |
343 |
; Mandant / Absender |
| 344 |
344 |
: Wird als Information in der Postkorb-Ansicht im Bürgerservice-Portal verwendet. |
| 345 |
345 |
; Dienst |
| ... |
... |
@@ -353,6 +353,10 @@ |
| 353 |
353 |
|
| 354 |
354 |
=== Empfänger === |
| 355 |
355 |
|
|
296 |
+{{figure image="workflow_postkorb_empfaenger.png"}} |
|
297 |
+Einstellungen für den Empfänger einer Postkorb Nachricht |
|
298 |
+{{/figure}} |
|
299 |
+ |
| 356 |
356 |
; Postkorb ID aus einer Anmeldung innerhalb der Vorgangsdaten ermitteln? |
| 357 |
357 |
: 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. |
| 358 |
358 |
: 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 |
| ... |
... |
@@ -374,6 +374,13 @@ |
| 374 |
374 |
|
| 375 |
375 |
=== Inhalt der Nachricht === |
| 376 |
376 |
|
|
321 |
+{{figure image="workflow_postkorb_nachricht.png"}} |
|
322 |
+Konfiguration von Betreff, Nachrichteninhalt und Anhängen |
|
323 |
+{{/figure}} |
|
324 |
+ |
|
325 |
+* für **BundID **/ **BayernID**: //PDF//, //HTML//, //Plaintext//, //MS Word//, //JPEG//, //GIF//, //PNG//, //ZIP// |
|
326 |
+* für **ELSTER**: //PDF//, //JPEG//, //PNG//, //XML//, //CSV// |
|
327 |
+ |
| 377 |
377 |
; Betreff (Pflicht) |
| 378 |
378 |
: Nachrichtenbetreff. Es werden Platzhalter unterstützt. |
| 379 |
379 |
; Inhalt (Pflicht) |
| ... |
... |
@@ -381,8 +381,6 @@ |
| 381 |
381 |
; Anhänge |
| 382 |
382 |
: Hier können Dateien als Attachments an die Postkorb-Nachricht gehangen werden. |
| 383 |
383 |
: Die dabei unterstützten Dateiformat unterscheiden sich dabei je nach genutzten Bürger Service: |
| 384 |
|
-: * für BundID / BayernID: PDF, HTML, Plaintext, MS Word, JPEG, GIF, PNG, ZIP |
| 385 |
|
-: * für ELSTER: PDF, JPEG, PNG, XML, CSV |
| 386 |
386 |
: Zur Auswahl stehen dabei: |
| 387 |
387 |
:; Dateien aus vorherigen Aktionen |
| 388 |
388 |
:: Eine Liste mit Dateien, von Datei-bereitstellenden Aktionen, die der Postkorb-Aktion vorangestellt sind. |
| ... |
... |
@@ -395,3 +395,18 @@ |
| 395 |
395 |
:; Vorgangsanhänge mittels Dateinamen suchen |
| 396 |
396 |
:: Eine Suche innerhalb von Dateinamen mittels übereinstimmenden Suchbegriffs. Es kann dabei mittels Filter eingegrenzt werden, |
| 397 |
397 |
:: innerhalb welcher Datei-Quellen die Suche ausgeführt wird (Dateien aus Uploads, Datei aus der Statusverarbeitung, Dateien aus dem Posteingang) |
|
347 |
+ |
|
348 |
+== Bedingte Ausführung von Workflow-Aktionen auf Grundlage des Authentifizierungslevels == |
|
349 |
+ |
|
350 |
+{{figure image="workflow_bedingung.png"}} |
|
351 |
+Workflow-Steuerungselement //Authentifizierungslevel prüfen// |
|
352 |
+{{/figure}} |
|
353 |
+ |
|
354 |
+Um eine einfache Prüfung auf Grundlage des Authentifizierungslevels durchzuführen steht das Workflow-Steuerelement //Authentifizierungslevel prüfen// zur Verfügung. |
|
355 |
+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. |
|
356 |
+ |
|
357 |
+; Prüfung des Authentifizierungslevels |
|
358 |
+: 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. |
|
359 |
+; Festlegung der zu prüfenden Authentifizierung |
|
360 |
+: 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. |
|
361 |
+: Die Standardeinstellung ist: //kein Daten-Suffix// |
