| ... |
... |
@@ -126,7 +126,7 @@ |
| 126 |
126 |
Formularvorlage //AKDB Basisdienste// |
| 127 |
127 |
{{/figure}} |
| 128 |
128 |
|
| 129 |
|
-Um die Daten aus dem Bürgerservice-Portal im Formular anzuzeigen, existiert die Vorlage //Bürgerkonto personen- und organisationsbezogene Daten.// Die Felder innerhalb dieser Vorlage sind so konfiguriert, dass sie eine automatische Zuordnung und damit die Anzeige der zurück gelieferten Daten ermöglichen. Bei Nutzung des eingangs erwähnten Formular-Templates, ist die Designer-Vorlage bereits eingebunden und je nach Anmeldetyp, werden die organisations-spezifischen Daten automatisch ein- oder ausgeblendet. |
|
129 |
+Um die Daten aus dem Bürgerservice-Portal im Formular anzuzeigen, existiert die Vorlage //Bürgerkonto personen- und organisationsbezogene Daten.// Die Felder innerhalb dieser Vorlage sind so konfiguriert, dass sie eine automatische Zuordnung und damit die Anzeige der zurück gelieferten Daten ermöglichen. Bei Nutzung des eingangs erwähnten Formular-Templates, ist die Designer-Vorlage bereits eingebunden und je nach Anmeldetyp, werden die organisations-spezifischen Daten automatisch ein- oder ausgeblendet. |
| 130 |
130 |
|
| 131 |
131 |
Die vom 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: |
| 132 |
132 |
|
| ... |
... |
@@ -259,7 +259,7 @@ |
| 259 |
259 |
Für die einzelnen Vertrauensniveaus existieren folgende Beschriftungen: |
| 260 |
260 |
|
| 261 |
261 |
* Level 1 (Authentifizierung mittels Benutzername / Passwort): **Standard** |
| 262 |
|
-* Level 3 (Authentifizierung mittels Authega Zertifikat): **Authega** |
|
262 |
+* Level 3 (Authentifizierung mittels Authega Zertifikat): **Zertifikat** |
| 263 |
263 |
* Level 4 (Authentifizierung mittels nPA): **Personalausweis** |
| 264 |
264 |
|
| 265 |
265 |
{{figure image="hilfe_trustlevel_keine_visualisierung.png"}} |
| ... |
... |
@@ -266,6 +266,30 @@ |
| 266 |
266 |
Wenn keine visuelle Markierung gewünscht ist, so kann dies durch ein zusätzliches Attribut „noRibbon“ am Vorlagen-Fieldset unterbunden werden |
| 267 |
267 |
{{/figure}} |
| 268 |
268 |
|
|
269 |
+==== Anpassungen der Darstellung aufgrund reduzierter Nutzerdaten ==== |
|
270 |
+ |
|
271 |
+Mit dem Update des Bürgerservice-Portals (**Release 3.2** vom **18.11.2021**) kann es bei Anmelde-Prozessen zur Übermittlung von reduzierten Nutzerdaten kommen (z.B. Authentifizierung mit eIDAS-notifizierten Identifikationsmittel). Dies äußert sich beispielsweise darin, dass nach der Anmeldung keine Adressdaten vom Nutzer in der Vorlage erscheinen. |
|
272 |
+ |
|
273 |
+ |
|
274 |
+Mit Plugin Version {{version major="3" minor="5"}}{{/version}} werden nach einer Anmeldung am Bürgerservice-Portal nur noch die Eingabefelder innerhalb der Datenvorlage für eine Bearbeitung gesperrt, welche durch den Authentifizierungsprozess am Bürgerservice-Portal befüllt wurden. |
|
275 |
+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. |
|
276 |
+ |
|
277 |
+Zusätzlich werden die Felder bei Wiederanzeige durch kleine Icons gekennzeichnet, wodurch auf einem Blick ersichtlich wird, aus welcher Quelle die Anmeldeinformationen entstammen. |
|
278 |
+ |
|
279 |
+* [[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 |
|
280 |
+* [[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 |
|
281 |
+ |
|
282 |
+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: |
|
283 |
+ |
|
284 |
+* //verify_l1//: Kennzeichnet ein Element dessen Inhaltswert einen Level 1 Vertrauensniveaus (Authentifizierung mittels Benutzername / Passwort) entspricht. |
|
285 |
+* //verify_l3//: Kennzeichnet ein Element dessen Inhaltswert einen Level 3 Vertrauensniveaus (Authentifizierung mittels Zertifikat) entspricht. |
|
286 |
+* //verify_l4//: Kennzeichnet ein Element dessen Inhaltswert einen Level 4 Vertrauensniveaus (Authentifizierung mittels nPA oder eIDAS Identifikationsmittel) entspricht. |
|
287 |
+* //no_verify//: Kennzeichnet ein Element dessen Inhaltswert durch einen Nutzer frei eingegeben wurde und damit durch keinen Identitätsprüfer aus dem Umfeld des Bürgerservice-Portals geprüft wurde. |
|
288 |
+ |
|
289 |
+{{figure image="noVerifyInfo.png"}} |
|
290 |
+Wenn keine visuelle Markierung der Formularelemente gewünscht ist, so kann dies durch ein zusätzliches Attribut „noVerifyInfo“ am Vorlagen-Fieldset unterbunden werden |
|
291 |
+{{/figure}} |
|
292 |
+ |
| 269 |
269 |
== AKDB Postkorbanbindung in der Statusverarbeitung == |
| 270 |
270 |
|
| 271 |
271 |
|
| ... |
... |
@@ -274,7 +274,7 @@ |
| 274 |
274 |
|
| 275 |
275 |
Die Konfigurationsoberfläche des Aktions-Plugins ist in einzelne Bereiche unterteilt die nachfolgend kurz beschrieben werden. |
| 276 |
276 |
|
| 277 |
|
-{{panel title="Einstellungen für Absender und Empfänger" fullwidth="true" initial="visible" triggerable="true"}} |
|
301 |
+{{panel title="Einstellungen für Absender und Empfänger" fullwidth="true" triggerable="true"}} |
| 278 |
278 |
|
| 279 |
279 |
|
| 280 |
280 |
{{figure image="postkorb_absender.png"}} |
| ... |
... |
@@ -289,7 +289,7 @@ |
| 289 |
289 |
: 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 AKDB Postkorb verlinkt wird. |
| 290 |
290 |
; Postkorb ID aus den Vorgangsdaten ermitteln? |
| 291 |
291 |
: Diese Angabe dient zur Bestimmung der Postkorb-ID. Über die Postkorb-ID wird das genaue Ziel für den Nachrichtenversand bestimmt, also der Nachrichten-Empfänger. |
| 292 |
|
-Bei einem AKDB Bürgerkonto-Login wird die Postkorb-ID immer mit übermittelt und standardmäßig am Formulareingang hinterlegt. |
|
316 |
+Wird bei einem AKDB Bürgerkonto-Login die Postkorb-ID mit übermittelt, so wird diese standardmäßig am Formulareingang hinterlegt. |
| 293 |
293 |
Für den Fall, dass es mehrere konfigurierte Anmeldungen innerhalb eines Formulars gibt, kann hier die Auswahl über den [[Bürgerdaten Parameter-Suffix>>doc:||anchor="BK_Parameter_Suffix"]] eingegrenzt werden. |
| 294 |
294 |
Darüber hinaus ist es möglich die Postkorb-ID fest oder über einen Platzhalter (**[%$POSTKORB_ID%]**) zu definieren. (Der Platzhalter wird über das Plugin zur Verfügung gestellt und kann in der Statusverarbeitung verwendet werden.) |
| 295 |
295 |
|
| ... |
... |
@@ -323,6 +323,8 @@ |
| 323 |
323 |
{{info}} |
| 324 |
324 |
**Achtung:** |
| 325 |
325 |
Die Schnittstelle zum Postkorb der AKDB unterstützt dabei maximal 20 Anhänge pro Nachricht mit je 50 MByte Maximalgröße. |
|
350 |
+ |
|
351 |
+Anhänge im Zip-Format werden momentan von der Postkorb-Schnittstelle auf Seite der AKDB nicht unterstützt. Nachrichten mit Zip-Datei Anhängen werden vom System komplett verworfen, weshalb Zip-Dateien aktuell bereits im FORMCYCLE-System herausgefiltert werden, sodass die eigentliche Nachricht trotzdem den Postkorb erreichen kann. Beachten Sie dies bitte innerhalb des jeweiligen Workflows. |
| 326 |
326 |
{{/info}} |
| 327 |
327 |
|
| 328 |
328 |
{{/panel}} |
| ... |
... |
@@ -371,6 +371,39 @@ |
| 371 |
371 |
|
| 372 |
372 |
== Versionshistorie == |
| 373 |
373 |
|
|
400 |
+(% class="wikigeneratedid" %) |
|
401 |
+=== 3.5.7 === |
|
402 |
+ |
|
403 |
+* Erweiterung Postkorb-Aktion: Als Anhang werden jetzt Zip-Dateien unterstützt. (Bitte beachten Sie, dass die Postkorb-Schnittstelle nur das Zip-Format und KEIN GZip-Format (Dateiendung ".gz") unterstützt) |
|
404 |
+* Erweiterung Postkorb-Aktion: Die Prüfroutine für die Postkorb-Webservice-Kommunikation wurde um eine Zertifikats-Validierung erweitert, in deren Erfolgsmeldung das Ablaufdatum für die Gültigkeit des Zertifikats vermerkt ist. |
|
405 |
+ |
|
406 |
+(% class="wikigeneratedid" %) |
|
407 |
+=== 3.5.6 === |
|
408 |
+ |
|
409 |
+* Fehlerbehebung: Es wurde ein Fehler behoben, welcher bei der Wiederanzeige von Organisations-Adressdaten aufgetreten ist. Teilweise waren die Adressdaten unvollständig. |
|
410 |
+ |
|
411 |
+=== 3.5.5 === |
|
412 |
+ |
|
413 |
+* Fehlerbehebung: Es wurde ein JS-Fehler behoben, der entstand, wenn das "TrustLevel"-Feld außerhalb der Daten-Vorlage verwendet wurde. |
|
414 |
+* Fehlerbehebung: Bei einer NPA-Anmeldung fehlten die RAW-Daten für die Adresse und die Stadt in den XFC_METADATEN. Dies wurde behoben. |
|
415 |
+ |
|
416 |
+=== 3.5.4 === |
|
417 |
+ |
|
418 |
+* Erweiterung Postkorb-Aktion: Prüfroutine für Postkorb-Webservice-Kommunikation in Konfigurationsoberfläche hinzugefügt. |
|
419 |
+ |
|
420 |
+=== 3.5.3 === |
|
421 |
+ |
|
422 |
+* Fehlerbehebung: Es wurde ein Sicherheitsproblem behoben, welches bei Laden von zwischengespeicherten Formulardaten auftreten kann. |
|
423 |
+ |
|
424 |
+=== 3.5.2 === |
|
425 |
+ |
|
426 |
+* Fehlerbehebung: Bei Rückleitung aus dem Bürgerservice-Portal und wenn Kommunikation nicht über Frontend-Server stattgefunden hat, wurde teilweise die Seite "Formular nicht gefunden" ausgeliefert. Dies wurde behoben. |
|
427 |
+* Fehlerbehebung: Bei Verwendung mehrerer Anmeldungen innerhalb eines Formulars und damit unterschiedlichen Bürgerdaten-Suffix, kam es zu falschen Formatierungen der Datenfelder. Dies wurde behoben. |
|
428 |
+ |
|
429 |
+=== 3.5.1 === |
|
430 |
+ |
|
431 |
+* Fehlerbehebung: Bei Rückleitung aus dem Bürgerservice-Portal und wenn Kommunikation nicht über Frontend-Server stattgefunden hat, wurde teilweise die Seite "Formular nicht gefunden" ausgeliefert. Dies wurde behoben. |
|
432 |
+ |
| 374 |
374 |
=== 3.5.0 === |
| 375 |
375 |
|
| 376 |
376 |
* Erweiterung der zurück gelieferten Authentifizierungsdaten: Das JSON-Objekt //authVerifyInfos// enthält die Namen der Elemente aus den Bürgerkontodaten, welche über die Authentifizierung am Bürgerservice-Portal übermittelt wurden. |
| ... |
... |
@@ -524,59 +524,4 @@ |
| 524 |
524 |
* Anpassung am Widget für den Bürgerkonto-Login-Button: Dieser wird jetzt beim PDF-Druck über den Designer standardmäßig ausgeblendet |
| 525 |
525 |
* Anpassung an der AKDB-Formular Vorlage: Diese verwendet jetzt die Template-Vorlage für //personen- und organisationsbezogene Daten// |
| 526 |
526 |
|
| 527 |
|
-=== 2.9.2 === |
| 528 |
|
- |
| 529 |
|
-* Erweiterung Template-Vorlage für //personen- und organisationsbezogene Daten//: |
| 530 |
|
-** Auswahlmöglichkeit für ein Eingabe von personen- **oder** organisationsbezogene Daten |
| 531 |
|
-** Eine Anzeige der Auswahlmöglichkeit erfolgt bei folgenden Fällen: |
| 532 |
|
-*** es hat KEINE Authentifizierung über das Bürgerkonto stattgefunden |
| 533 |
|
-*** es existiert ein "vorgeschaltener" Zugriffschutz (Externe Benutzer) |
| 534 |
|
- |
| 535 |
|
-=== 2.9.1 === |
| 536 |
|
- |
| 537 |
|
-* Fehlerbehebung in Anzeige bei Nutzung der Template-Vorlage für //personen- und organisationsbezogene Daten//: |
| 538 |
|
-** die fehlende Anzeige des Authentifizierungsverfahren am Field-Set für die persönlichen Daten wurde beseitigt |
| 539 |
|
-** Nach erfolgter Anmeldung werden die Eingabe-Felder für die persönlichen Daten mit einem Schreibschutz belegt |
| 540 |
|
- |
| 541 |
|
-=== 2.9.0 === |
| 542 |
|
- |
| 543 |
|
-* 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. |
| 544 |
|
-* 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. |
| 545 |
|
-* Vereinheitlichung der Vorlage für Organisationsdaten: Für die personenbezogenen Daten des Organisations-Vertreters werden die geänderten Parameternamen verwendet. |
| 546 |
|
-* 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. |
| 547 |
|
-* Fehlerbehebung bei Verwendung des BK-Authenticators über Frontend-Server: Initialisierung notwendiger OpenSAML-Klassen bei Aufruf über Frontend-Server hinzugefügt. |
| 548 |
|
- |
| 549 |
|
-=== 2.8.2 === |
| 550 |
|
- |
| 551 |
|
-* Ändern BK-Vorlage für //persönliche Daten//: 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 |
| 552 |
|
-* 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. |
| 553 |
|
- |
| 554 |
|
-=== 2.8.1 === |
| 555 |
|
- |
| 556 |
|
-* 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 |
| 557 |
|
- |
| 558 |
|
-=== 2.8.0 === |
| 559 |
|
- |
| 560 |
|
-* Bereitstellung eines Plugin-Authenticator für AKDB-Login als "Externer Benutzer" |
| 561 |
|
-* Hinweis: Log für Authega funktioniert nicht bei Einsatz von Plugin-Authenticator |
| 562 |
|
- |
| 563 |
|
-=== 2.7.0 === |
| 564 |
|
- |
| 565 |
|
-* Umstellung intern genutztes SAML-Framework. Dieses wird nicht mehr durch das Plugin selbst, sondern vom {{formcycle/}}-Core zur Verfügung gestellt. |
| 566 |
|
-* **Achtung:** alle neueren Versionen des Plugins benötigen mindestens {{formcycle/}} Version {{version major="6" minor="4" patch="0"/}} oder höher |
| 567 |
|
- |
| 568 |
|
-=== 2.6.2 === |
| 569 |
|
- |
| 570 |
|
-* Umbenennung Menüpunkt für Metadaten-Generierung für Registrierung bei AKDB, neuer Name: "AKDB Setup" |
| 571 |
|
- |
| 572 |
|
-=== 2.6.1 === |
| 573 |
|
- |
| 574 |
|
-* Fehlerbehebung bei Verwendung des BK-Logins über Frontend-Server |
| 575 |
|
- |
| 576 |
|
-=== 2.6.0 === |
| 577 |
|
- |
| 578 |
|
-* Einbindung {{formcycle/}} Version 6.2.0 |
| 579 |
|
-* Unterstützung Blanko-Druck: |
| 580 |
|
-** Login-Button wird ausgeschlossen |
| 581 |
|
-** Steuerfelder und Trustlevel in den Vorlagen werden standardmäßig vom Druck ausgeschlossen |
| 582 |
|
-* Login-Button um Auswahlmöglichkeit für Seitenvalidierung vor Beginn BK-Login erweitert. |
|
586 |
+=== === |
