| ... |
... |
@@ -62,7
+62,7 @@ |
| 62 |
62 |
|
| 63 |
63 |
== Einbindung des Bürgerkonto Logins als Externer Benutzer == |
| 64 |
64 |
|
| 65 |
|
-{{version major="6" minor="4" patch="0"/}} Die Option steht in der {{formcycle/}} - Version ab **6.4.0** mit der Plugin - Version ab **2.8.0** zur Verfügung. |
|
65 |
+{{version major="6" minor="4" patch="0"/}} Die Option steht in der {{formcycle/}} - Version ab **6.4.0** mit der Plugin - Version ab **2.8.1** zur Verfügung. |
| 66 |
66 |
|
| 67 |
67 |
=== Konfiguration eines Externen Benutzers für das Bürgerkonto Login === |
| 68 |
68 |
|
| ... |
... |
@@ -75,9
+75,7 @@ |
| 75 |
75 |
Dazu muss im jeweiligen Mandaten in den Konfigurationsbereich Externe Benutzer gewechselt werden. Dort muss mittels {{ficon name="plus-circle-outline"/}} der über das Plugin zur Verfügung gestellte **AKDB Login** ausgewählt werden. |
| 76 |
76 |
|
| 77 |
77 |
{{info}} |
| 78 |
|
-**Achtung:** |
| 79 |
|
-Beachten Sie, dass vor Verwendung des //Bürgerkonto-Login als Externer Benutzer// die konfigurative Anbindung des Dienstes durch den {{formcycle/}}-Administrator stattgefunden hat, |
| 80 |
|
-da die zur Kommunikation benötigten Zertifikate und Informationen aus den Plugin-Einstellungen bezogen werden. |
|
78 |
+Beachten Sie, dass vor Verwendung des //Bürgerkonto-Login als Externer Benutzer// die konfigurative Anbindung des Dienstes durch den {{formcycle/}}-Administrator stattgefunden hat, da die zur Kommunikation benötigten Zertifikate und Informationen aus den Plugin-Einstellungen entnommen werden. |
| 81 |
81 |
{{/info}} |
| 82 |
82 |
|
| 83 |
83 |
{{figure image="externer_benutzer_akdb_s2.png"}} |
| ... |
... |
@@ -121,6
+121,8 @@ |
| 121 |
121 |
|
| 122 |
122 |
Um die Daten aus dem Bürgerservice-Portal im Formular anzuzeigen, existieren zwei Vorlagen //Bürgerkonto personenbezogene Daten// und //Bürgerkonto organisationsbezogene Daten//. Die Felder innerhalb dieser Vorlagen sind so konfiguriert, dass sie eine automatische Zuordnung und damit die Anzeige der zurückgelieferten Daten ermöglichen. Die jeweilige Vorlage ist je nach der eingestellten [[Art der Rückgabedaten>>doc:||anchor="Art_Rueckgabedaten"]] am //AKDB Bürgerkonto//-Button zu wählen. Bei Nutzung der eingangs erwähnten Formular-Templates, sind beide Designer-Vorlagen bereits eingebunden und werden nach anzuzeigender Datenart ein- oder ausgeblendet. |
| 123 |
123 |
|
|
122 |
+Ab Plugin Version {{version major="2" minor="9"/}} gibt es eine weitere Vorlage, welche die Daten von person- und organisations-bezogenen Daten in einer Vorlage vereint. Das Anzeigeverhalten dieser Vorlage entspricht den eingangs erwähnten Vorlagen. Das heißt, je nach Anmeldetyp, wird die organisations-spezifischen Daten ein- oder ausgeblendet. |
|
123 |
+ |
| 124 |
124 |
Die vom Bürgerservice-Portal zurückgelieferten 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: |
| 125 |
125 |
|
| 126 |
126 |
|
| ... |
... |
@@ -133,6
+133,9 @@ |
| 133 |
133 |
{{info}} |
| 134 |
134 |
Parameter, welche nur bei einer **p**ersonen**b**ezogenen **A**nmeldung vorhanden sind, sind mit **(PBA)** und die die nur bei einer **o**rganisations**b**ezogenen **A**nmeldung vorhanden sind, mit **(OBA)** gekennzeichnet. |
| 135 |
135 |
Ist keine extra Kennzeichnung vorhanden, so ist der Parameter in beiden Bereichen vorhanden. |
|
136 |
+ |
|
137 |
+**Achtung: **Ab Plugin-Version **2.9.0** sind im Zuge einer Vereinheitlichung der Parameter-Name für **PBA** und **OBA**, bestimmte Parameter, die bisher nur bei **PBA** vorhanden waren auch bei einer **OBA** vorhanden. Im Zuge der Abwärtskompatibilität sind die OBA-spezifischen Parameter zusätzlich noch vorhanden. |
|
138 |
+Die betreffenden Parameter sind in der Tabelle mit **(PBA + OBA)** gekennzeichnet. |
| 136 |
136 |
{{/info}} |
| 137 |
137 |
|
| 138 |
138 |
{{table dataTypeAlpha="0" preSort="0-asc"}} |
| ... |
... |
@@ -142,7
+142,7 @@ |
| 142 |
142 |
|PostboxId|Postkorb-ID des Nutzers. Muss bei Anbindung des Postkorbs verwendet werden. |
| 143 |
143 |
|((( |
| 144 |
144 |
Email (PBA) |
| 145 |
|
-tfAntragstellerEmail (PBA) |
|
148 |
+tfAntragstellerEmail (PBA + OBA) |
| 146 |
146 |
)))|Email-Adresse |
| 147 |
147 |
|Gender|Anrede als numerischer Wert nach ISO 5218:2004 |
| 148 |
148 |
|GenderName|Lesbarer Text für Geschlechter-Code aus Attribut „gender“. |
| ... |
... |
@@ -149,45
+149,45 @@ |
| 149 |
149 |
Mögliche Werte: //männlich//, //weiblich// |
| 150 |
150 |
|((( |
| 151 |
151 |
Salutation |
| 152 |
|
-tfAntragstellerAnrede (PBA) |
|
155 |
+tfAntragstellerAnrede (PBA + OBA) |
| 153 |
153 |
selAntragstellerAnrede (PBA) |
| 154 |
154 |
)))|Anrede, wird mit Hilfe des Geschlechter-Code aus Attribut „gender“ erzeugt. |
| 155 |
155 |
Mögliche Werte: //Herr//, //Frau, Nicht bekannt// |
| 156 |
156 |
|((( |
| 157 |
157 |
PersonalTitle (PBA) |
| 158 |
|
-tfAntragstellerTitel (PBA) |
|
161 |
+tfAntragstellerTitel (PBA + OBA) |
| 159 |
159 |
)))|Akademischer Titel |
| 160 |
160 |
|((( |
| 161 |
161 |
FirstName |
| 162 |
|
-tfAntragstellerVorname (PBA) |
|
165 |
+tfAntragstellerVorname (PBA + OBA) |
| 163 |
163 |
)))|Vorname |
| 164 |
164 |
|((( |
| 165 |
165 |
LastName |
| 166 |
|
-tfAntragstellerName (PBA) |
|
169 |
+tfAntragstellerName (PBA + OBA) |
| 167 |
167 |
)))|Nachname |
| 168 |
168 |
|((( |
| 169 |
169 |
ZipCode (PBA) |
| 170 |
|
-tfAntragstellerPLZ (PBA) |
|
173 |
+tfAntragstellerPLZ (PBA + OBA) |
| 171 |
171 |
)))|Postleitzahl |
| 172 |
172 |
|((( |
| 173 |
173 |
Address (PBA) |
| 174 |
|
-tfAntragstellerAdresse (PBA) |
|
177 |
+tfAntragstellerAdresse (PBA + OBA) |
| 175 |
175 |
)))|Adresse bestehend aus Strasse und Hausnummer |
| 176 |
176 |
|((( |
| 177 |
177 |
City (PBA) |
| 178 |
|
-tfAntragstellerOrt (PBA) |
|
181 |
+tfAntragstellerOrt (PBA + OBA) |
| 179 |
179 |
)))|Ort |
| 180 |
180 |
|((( |
| 181 |
181 |
BirthDate |
| 182 |
|
-tfAntragstellerGeburtsdatum (PBA) |
|
185 |
+tfAntragstellerGeburtsdatum (PBA + OBA) |
| 183 |
183 |
)))|Geburtsdatum im Format: dd.MM.yyyy |
| 184 |
184 |
|((( |
| 185 |
185 |
PlaceOfBirth |
| 186 |
|
-tfAntragstellerGeburtsort (PBA) |
|
189 |
+tfAntragstellerGeburtsort (PBA + OBA) |
| 187 |
187 |
)))|Geburtsort |
| 188 |
188 |
|((( |
| 189 |
189 |
TelephoneNumber |
| 190 |
|
-tfAntragstellerTelefon (PBA) |
|
193 |
+tfAntragstellerTelefon (PBA + OBA) |
| 191 |
191 |
)))|Telefonnummer |
| 192 |
192 |
|tfOrgVertreterVorname (OBA)|Vorname der Person, welche der hinterlegten Organisation angehört und über deren Account die Anmeldung erfolgte. |
| 193 |
193 |
|tfOrgVertreterName (OBA)|Nachname der Person, welche der hinterlegten Organisation angehört und über deren Account die Anmeldung erfolgte. |
| ... |
... |
@@ -356,3
+356,48 @@ |
| 356 |
356 |
{{info}} |
| 357 |
357 |
Bitte beachten Sie, dass Bedingungen vom Typ "Mehrere Bedinungen" werden immer UND-Verknüpft sind. Somit müssen alle REGEX-Bedingungen erfüllt sein, damit die Aktion ausgeführt wird. |
| 358 |
358 |
{{/info}} |
|
362 |
+ |
|
363 |
+== Versionshistorie == |
|
364 |
+ |
|
365 |
+=== 2.9.0 === |
|
366 |
+ |
|
367 |
+* Neue Template-Vorlage für personen- und organisationsbezogene Daten: Unterteilt in 2 Fieldsets, wobei //persönliche Daten// bei beiden Anmeldungstypen angezeigt werden und //organisationsbezogene Daten// nur im Fall einer Organisations-Anmeldung. Die Vorlage wird standardmäßig ausgeblendet, wenn keine Anmeldedaten vorliegen. |
|
368 |
+* Vereinheitlichung der Datenbezeichnungen bei den persönlichen Daten für den Vertreter innerhalb einer Organisations-Anmeldung: die personenbezogenen Daten für den Vertreter werden unter den gleichen Parameter-Namen, wie bei einer reinen personenbezogenen Anmeldung zur Verfügung gestellt. Im Zuge der Abwärtskompatibilität bleiben alte Parameternamen (Präfix **tfOrg**) weiterhin erhalten. |
|
369 |
+* Vereinheitlichung der Vorlage für Organisationsdaten: Für die personenbezogenen Daten des Organisations-Vertreters werden die geänderten Parameternamen verwendet. |
|
370 |
+* Anpassung PreRender-Logik bei Nutzung von Authenticatoren: Bei "Ohne Login" werden von Nachname und Titel die Default-Werte gelöscht, damit diese Felder bei Anzeige in der Vorlage leer sind. |
|
371 |
+* Fehlerbehebung bei Verwendung des BK-Authenticators über Frontend-Server: Initialisierung notwendiger OpenSAML-Klassen bei Aufruf über Frontend-Server hinzugefügt. |
|
372 |
+ |
|
373 |
+=== 2.8.2 === |
|
374 |
+ |
|
375 |
+* Ändern BK-Vorlage für natürliche Person: Platzhalter für Authenticator-User-Objekt-Werte gesetzt, soweit wie möglich, um Nutzung für andere Authenticatoren (Google, NTLM, Facebook) prinzipiell zu ermöglichen |
|
376 |
+* Anpassung PreRender-Logik: Bei Vorhandensein eines User-Profils aus einem Authenticator wird Steuervariable 'IsIndividualPerson' auf "true" gesetzt, damit BK-Vorlage automatisch eingeblendet und genutzt werden kann. |
|
377 |
+ |
|
378 |
+=== 2.8.1 === |
|
379 |
+ |
|
380 |
+* Fehlerbehebung bei Verwendung des BK-Logins über Frontend-Server: Factory-Klasse (org.opensaml.core.xml.XMLObjectBuilderFactory) durch pac4j-Implementierung ersetzt, um Fehler bei Kommunikation über den Frontend-Server zu beheben |
|
381 |
+ |
|
382 |
+=== 2.8.0 === |
|
383 |
+ |
|
384 |
+* Bereitstellung eines Plugin-Authenticator für AKDB-Login als "Externer Benutzer" |
|
385 |
+* Hinweis: Log für Authega funktioniert nicht bei Einsatz von Plugin-Authenticator |
|
386 |
+ |
|
387 |
+=== 2.7.0 === |
|
388 |
+ |
|
389 |
+* Umstellung intern genutztes SAML-Framework. Dieses wird nicht mehr durch das Plugin selbst, sondern vom {{formcycle/}}-Core zur Verfügung gestellt. |
|
390 |
+* **Achtung:** alle neueren Versionen des Plugins benötigen mindestens {{formcycle/}} Version {{version major="6" minor="4" patch="0"/}} oder höher |
|
391 |
+ |
|
392 |
+=== 2.6.2 === |
|
393 |
+ |
|
394 |
+* Umbenennung Menüpunkt für Metadaten-Generierung für Registrierung bei AKDB, neuer Name: "AKDB Setup" |
|
395 |
+ |
|
396 |
+=== 2.6.1 === |
|
397 |
+ |
|
398 |
+* Fehlerbehebung bei Verwendung des BK-Logins über Frontend-Server |
|
399 |
+ |
|
400 |
+=== 2.6.0 === |
|
401 |
+ |
|
402 |
+* Einbindung {{formcycle/}} Version 6.2.0 |
|
403 |
+* Unterstützung Blanko-Druck: |
|
404 |
+** Login-Button wird ausgeschlossen |
|
405 |
+** Steuerfelder und Trustlevel in den Vorlagen werden standardmäßig vom Druck ausgeschlossen |
|
406 |
+* Login-Button um Auswahlmöglichkeit für Seitenvalidierung vor Beginn BK-Login erweitert. |