Änderungen von Dokument Bürgerservice Plugin

Von Version 15.1
bearbeitet von rth
am 09.05.2023, 15:36
Ä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

Zusammenfassung

Details

Seiteneigenschaften
Titel
... ... @@ -1,1 +1,1 @@
1 -Bürger Services Plugin
1 +Bürgerservice Plugin
Inhalt
... ... @@ -1,10 +1,12 @@
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:**
4 -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!
6 +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!
5 5  )))
6 6  
7 -Über das kostenpflichtige //Bürger Services Plugin// werden Möglichkeiten zur Einbindung verschiedener Bürger Services in (% class="xm-smallcaps" %)Xima® Formcycle(%%) bereitgestellt.
9 +Über das kostenpflichtige //Bürger Services Plugin// werden Möglichkeiten zur Einbindung verschiedener Bürgerservices in (% class="xm-smallcaps" %)Xima® Formcycle(%%) bereitgestellt.
8 8  Dabei kann zwischen den Anbindungen für
9 9  
10 10  * **BundID**
... ... @@ -13,9 +13,9 @@
13 13  
14 14  gewählt werden.
15 15  
16 -== Einbindung der Bürger Services in Formulare ==
18 +== Einbindung der Bürgerservices in Formulare ==
17 17  
18 -Für eine Einbindung der Bürger Services in (% class="xm-smallcaps" %)Xima® Formcycle(%%) Formulare bestehen grundsätzlich folgende Möglichkeiten:
20 +Für eine Einbindung der Bürgerservices in (% class="xm-smallcaps" %)Xima® Formcycle(%%) Formulare bestehen grundsätzlich folgende Möglichkeiten:
19 19  
20 20  * Anmeldung über Formular-Zugriffssteuerung: hier erfolgt eine Nutzer-Legitimierung **vor** der Anzeige des Formulars
21 21  * Anmeldung über Login-Button: In diesem Szenario kann eine Nutzer-Legitimierung während der Anzeige des Formulars (zu jedem Zeitpunkt), durchgeführt werden. 
... ... @@ -22,81 +22,51 @@
22 22  
23 23  === Einbindung über Formular-Zugriff ===
24 24  
27 +{{figure image="formularZugriff_login.png"}}
28 +Konfiguration der Bürgerservices als Formularanmeldung
29 +{{/figure}}
25 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 +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.
31 31  
32 -(% class="xm-figure-caption" %)
33 -(((
34 -Konfiguration der Bürger Services als Formularanmeldung
35 -)))
36 -)))
37 -)))
38 -
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 -
41 -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.
33 +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.
42 42  
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 -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.
42 +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.
61 61  Die nachfolgenden aufgeführten Einstellungen gelten dabei für alle Bürger Services (BundID, ELSTER etc.) gleichermaßen.
62 62  
63 63  ; Bezeichner
64 64  : Beschriftung des Login-Buttons im Formular
65 65  ; Authentikator
66 -: 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.  
48 +: 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.  
67 67  ; Seite bei Login
68 68  : Hier wird die Formularseite festgelegt, welche angezeigt werden soll, wenn der Login **erfolgreich **war.
69 69  ; Seite bei Abbruch
70 70  : Hier wird die Formularseite festgelegt, welche angezeigt werden soll, wenn der Login **abgebrochen** wurde.
71 71  ; Element Suffix
72 -: Hier kann ein Suffix definiert werden, welches beim Vorbelegen von Formularelementen, mit den ermittelten Daten aus einem Bürger Service, zur Anwendung kommt.
54 +: Hier kann ein Suffix definiert werden, welches beim Vorbelegen von Formularelementen, mit den ermittelten Daten aus einem Bürgerservice, zur Anwendung kommt.
73 73  Durch das Suffix wird es möglich mehrere Authentifizierungen und Formularelement-Vorbelegungen innerhalb eines Formulars zu realisieren.
74 74  : Als Suffix sind Buchstaben, Zahlen und der Unterstrich erlaubt.
75 75  : __Beispiel:__
76 76  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. 
77 77  ; Login im Popup
78 -: 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.
60 +: Wenn aktiviert, wird die Login-Seite des jeweiligen Bürgerservice-Portals in einem Popup geöffnet, ansonst erfolgt die Anzeige in der gleichen Seite.
79 79  ; Validieren
80 -: 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.
62 +: 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.
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 -Die nachfolgend beschriebenen Konfigurationsmöglichkeiten stehen nur im Zusammenhang mit den Bürger Services von BundID und BayernID zur Verfügung
99 -und ermöglichen es die Anmeldemöglichkeiten, sowie die zurück gelieferten Daten aus dem jeweiligen Bürger Service-Portal zu beeinflussen.
70 +Die nachfolgend beschriebenen Konfigurationsmöglichkeiten stehen nur im Zusammenhang mit den Bürgerservices von BundID und BayernID zur Verfügung
71 +und ermöglichen es die Anmeldemöglichkeiten, sowie die zurück gelieferten Daten aus dem jeweiligen Bürgerservice-Portal zu beeinflussen.
100 100  
101 101  ; Vertrauensniveau
102 102  : Hier kann das dem Nutzer zur Verfügung stehende Authentifizierungsverfahren eingeschränkt werden.
... ... @@ -127,47 +127,26 @@
127 127  : Über diese Checkbox-Auswahl kann der Nutzer die zurück gelieferten Eigenschaften einer erfolgreichen Authentifizierung einschränken.
128 128  : 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,
129 129  : so sind nur die entsprechenden Felder in dieser Auswahlliste zu selektieren.
130 -: Ist nichts ausgewählt, erfolgt keine Einschränkung und alle möglichen Eigenschaften werden vom jeweiligen Bürger Service-Portal angefordert.
102 +: Ist nichts ausgewählt, erfolgt keine Einschränkung und alle möglichen Eigenschaften werden vom jeweiligen Bürgerservice-Portal angefordert.
131 131  ; Nur mit Postkorb
132 132  : Diese Einstellung ermöglich es die Postkorb-ID als verpflichtendes Rückgabe-Attribut zu kennzeichnen.
133 -: Auf Seiten des Bürger Service-Portals werden dann alle Authentifizierungsarten, die keinen Postkorbversand ermöglichen, für den Nutzer ausgeblendet.
134 -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.
105 +: Auf Seiten des Bürgerservice-Portals werden dann alle Authentifizierungsarten, die keinen Postkorbversand ermöglichen, für den Nutzer ausgeblendet.
106 +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.
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 -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.
118 +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.
168 168  Für die Erweiterung der Anzeigedaten steht der ebenfalls im Designer eingebundene Elementkatalog //Bürger Services Elemente //zur Verfügung//.//
169 169  
170 -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:
121 +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:
171 171  
172 172  
173 173  (% class="box" %)
... ... @@ -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,28 +202,19 @@
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  
220 -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.
152 +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.
221 221  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.
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  
... ... @@ -234,9 +234,9 @@
234 234  
235 235  == Übersicht Element-Matrix ==
236 236  
237 -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.
169 +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.
238 238  
239 -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.
171 +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.
240 240  
241 241  
242 242  (% style="margin-right:auto" %)
... ... @@ -296,6 +296,12 @@
296 296  |=(% style="text-align:left" %)tfPersTyp|Personentyp|(((
297 297  mögliche Werte:
298 298  
231 +* //NatPers //(der Inhaber des Kontos wird als Privatperson angesehen)
232 +* //NNatPers// (der Inhaber des Kontos wird als Organisation betrachtet)
233 +)))|(% style="background-color:#c6efce" %)Pflichtfeld|(% style="background-color:#c6efce" %)Pflichtfeld|(% style="background-color:#c6efce" %)Pflichtfeld|(% style="background-color:#c6efce" %)Pflichtfeld|(% style="background-color:#c6efce" %)Pflichtfeld|(% style="background-color:#c6efce" %)Pflichtfeld|(% style="background-color:#c6efce" %)Pflichtfeld|(% style="background-color:#c6efce" %)Pflichtfeld|(% style="background-color:#c6efce" %)Pflichtfeld|(% style="background-color:#c6efce" %)Pflichtfeld|(% style="background-color:#c6efce" %)Pflichtfeld|(% style="background-color:#c6efce" %)Pflichtfeld|(% style="background-color:#c6efce" %)Pflichtfeld
234 +|=(% style="text-align:left" %)selOrgPersTyp|Inhabertyp des Steuerkontos|(((
235 +mögliche Werte:
236 +
299 299  * //NatPers //(der Inhaber des Kontos ist eine natürliche Person, z.B.: Einzelunternehmer)
300 300  * //NNatPers// (bei einer nicht natürlichen Person, z.B.: GmbH)
301 301  )))|(% style="background-color:#c6efce" %)Pflichtfeld|(% style="background-color:#c6efce" %)Pflichtfeld|(% style="background-color:#c6efce" %)Pflichtfeld|(% style="background-color:#c6efce" %)Pflichtfeld|(% style="background-color:#c6efce" %)Pflichtfeld|(% style="background-color:#c6efce" %)Pflichtfeld|(% style="background-color:#c6efce" %)Pflichtfeld|(% style="background-color:#c6efce" %)Pflichtfeld|(% style="background-color:#c6efce" %)Pflichtfeld|(% style="background-color:#c6efce" %)Pflichtfeld|(% style="background-color:#c6efce" %)Pflichtfeld|(% style="background-color:#c6efce" %)Pflichtfeld|(% style="background-color:#c6efce" %)Pflichtfeld
... ... @@ -333,7 +333,11 @@
333 333  
334 334  == Anbindung Postkorb im Workflow ==
335 335  
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.
274 +{{figure image="workflow_bedingung_aktion.png"}}
275 +Workflow mit Bedingung für Prüfung des Authentifikationslevels und einer Postkorb Nachricht versenden Aktion
276 +{{/figure}}
277 +
278 +Für die Anbindung zum Versand Nachrichten an den Postkorb des jeweiligen Bürgerservice 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  
339 339  Die Konfigurationsoberfläche der Aktion ist in einzelne Bereiche unterteilt die nachfolgend kurz beschrieben werden.
... ... @@ -340,12 +340,16 @@
340 340  
341 341  === Absender ===
342 342  
285 +{{figure image="workflow_postkorb_absender.png"}}
286 +Einstellungen für den Absender einer Postkorb Nachricht
287 +{{/figure}}
288 +
343 343  ; Mandant / Absender
344 344  : Wird als Information in der Postkorb-Ansicht im Bürgerservice-Portal verwendet.
345 345  ; Dienst
346 346  : Wird als Information in der Postkorb-Ansicht im Bürgerservice-Portal verwendet.
347 347  ; Absender-Link
348 -: 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,
294 +: 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,
349 349  : mit dem der Mandant bei der Anzeige im Postkorb der **BundID **oder **BayernID **verlinkt wird.
350 350  ; TransferId-Referenz
351 351  : Diese Eigenschaft findet nur in Zusammenhang mit der Postkorbanbindung von **ELSTER** Verwendung.
... ... @@ -353,9 +353,13 @@
353 353  
354 354  === Empfänger ===
355 355  
302 +{{figure image="workflow_postkorb_empfaenger.png"}}
303 +Einstellungen für den Empfänger einer Postkorb Nachricht
304 +{{/figure}}
305 +
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 -: 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
308 +: 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
359 359  : innerhalb eines Formulars gibt, kann die Auswahl über den Daten-Suffix eingegrenzt werden.
360 360  : 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.)
361 361  : 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:
... ... @@ -362,7 +362,7 @@
362 362  :; Postkorb ID (Pflichtfeld)
363 363  :: Hier ist die Angabe einer konkreten Postkorb ID erforderlich. Diese muss zur Laufzeit mit dem in Feld //Webservice Umgebung// definierten Authentikator korrespondieren.
364 364  :; Webservice Umgebung
365 -:: 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.
315 +:: 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.
366 366  ; Vertrauensniveau der Anmeldung für Zugriff auf Postkorb-Nachricht weiterreichen?
367 367  : Diese Option steht nur im BundID und BayernID Portal zur Verfügung. 
368 368  : 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.
... ... @@ -374,6 +374,13 @@
374 374  
375 375  === Inhalt der Nachricht ===
376 376  
327 +{{figure image="workflow_postkorb_nachricht.png"}}
328 +Konfiguration von Betreff, Nachrichteninhalt und Anhängen
329 +{{/figure}}
330 +
331 +* für **BundID **/ **BayernID**: //PDF//, //HTML//, //Plaintext//, //MS Word//, //JPEG//, //GIF//, //PNG//, //ZIP//
332 +* für **ELSTER**: //PDF//, //JPEG//, //PNG//, //XML//, //CSV//
333 +
377 377  ; Betreff (Pflicht)
378 378  : Nachrichtenbetreff. Es werden Platzhalter unterstützt.
379 379  ; Inhalt (Pflicht)
... ... @@ -380,9 +380,7 @@
380 380  : Nachrichtentext. Es werden Platzhalter unterstützt.
381 381  ; Anhänge
382 382  : Hier können Dateien als Attachments an die Postkorb-Nachricht gehangen werden.
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
340 +: Die dabei unterstützten Dateiformat unterscheiden sich dabei je nach genutzten Bürgerservice:
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,38 @@
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)
353 +
354 +== Bedingte Ausführung von Workflow-Aktionen auf Grundlage des Authentifizierungslevels ==
355 +
356 +{{figure image="workflow_bedingung.png"}}
357 +Workflow-Steuerungselement //Authentifizierungslevel prüfen//
358 +{{/figure}}
359 +
360 +Um eine einfache Prüfung auf Grundlage des Authentifizierungslevels durchzuführen steht das Workflow-Steuerelement //Authentifizierungslevel prüfen// zur Verfügung.
361 +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.
362 +
363 +; Prüfung des Authentifizierungslevels
364 +: 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.
365 +; Festlegung der zu prüfenden Authentifizierung
366 +: 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.
367 +: Die Standardeinstellung ist: //kein Daten-Suffix//
368 +
369 +== Versionshistorie ==
370 +
371 +=== 1.7.9 ===
372 +
373 +* Wird bei der Postkorb-Aktion ein Upload als zu übertragen angegeben, schlägt diese jetzt nicht mehr fehl, wenn hier keine Datei im Formular ausgewählt wurde (Betrifft BayernID und BundID)
374 +* Der Login-Button innerhalb des Formulars wird bei migrierten Anbindungen nicht mehr deaktiviert
375 +* Anpassung der Metadaten-Generierung bei BayernID und BundID
376 +** Sprach-Tags werden jetzt auf "de-DE" gesetzt
377 +** Das Gültigkeitsdatum wurde entfernt
378 +* Kleine UI-Anpassung, um die nicht vorhandene Notwendigkeit der Ausfüllung der Service Provider Entity-ID bei BayernID und BundID hervorzuheben
379 +
380 +=== 1.7.8 ===
381 +
382 +* Der Mail-Versand als Fallback bei fehlgeschlagenem Postkorb-Versand wird nun bei migrierten Anbindungen nicht standardmäßig aktiviert
383 +* Kleinere Fehlerbehebungen
384 +
385 +=== 1.7.7 ===
386 +
387 +* Initialer öffentlicher Release
workflow_bedingung.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.rth
Größe
... ... @@ -1,0 +1,1 @@
1 +66.5 KB
Inhalt
workflow_bedingung_aktion.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.rth
Größe
... ... @@ -1,0 +1,1 @@
1 +104.5 KB
Inhalt
workflow_postkorb_absender.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.rth
Größe
... ... @@ -1,0 +1,1 @@
1 +18.5 KB
Inhalt
workflow_postkorb_empfaenger.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.rth
Größe
... ... @@ -1,0 +1,1 @@
1 +36.5 KB
Inhalt
workflow_postkorb_nachricht.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.rth
Größe
... ... @@ -1,0 +1,1 @@
1 +33.7 KB
Inhalt