| ... |
... |
@@ -1,5 +1,10 @@ |
| 1 |
1 |
[[**Plugin-Download**>>url:https://customer.formcycle.eu/index.php/apps/files/?dir=/FORMCYCLE%20-%20Plugins%20Customer/plugin-bundle-akdb-services&fileid=2671||rel="noopener noreferrer" target="_blank"]] (erfordert Anmeldung) |
| 2 |
2 |
|
|
3 |
+{{info}} |
|
4 |
+**Hinweis zur Inbetriebnahme des Plugins:** |
|
5 |
+Im Download-Ordner der jeweilige Plugin-Version befindet sich eine Anleitung zur initialen Inbetriebnahme, sowie zu weiter reichenden Information die den allgemeinen Betrieb dieses Plugins betreffen. |
|
6 |
+{{/info}} |
|
7 |
+ |
| 3 |
3 |
{{content/}} |
| 4 |
4 |
|
| 5 |
5 |
{{info}} |
| ... |
... |
@@ -20,9 +20,13 @@ |
| 20 |
20 |
== Einbindung des Bürgerkonto Logins im Designer == |
| 21 |
21 |
|
| 22 |
22 |
{{figure image="hilfe_bk_button.png"}} |
| 23 |
|
-Formular-Element //AKDB Bürgerkonto// |
|
28 |
+Einstellungen am Formular-Element //AKDB Bürgerkonto// bis Version {{version major="3" minor="6"}}{{/version}} |
| 24 |
24 |
{{/figure}} |
| 25 |
25 |
|
|
31 |
+{{figure image="hilfe_bk_button_v3_6.png"}} |
|
32 |
+Einstellungen am Formular-Element //AKDB Bürgerkonto// ab Version {{version major="3" minor="6"}}{{/version}} |
|
33 |
+{{/figure}} |
|
34 |
+ |
| 26 |
26 |
{{id name="BK_LoginButton"/}} |
| 27 |
27 |
|
| 28 |
28 |
Zur vereinfachten Einbindung des Bürgerkontos in Formulare gibt es das Formular-Element //AKDB Bürgerkonto//. Dieses kann per "Drag & Drop" in den Seitenbereich gezogen werden. Der dann vorhandene Absende-Button kann im Bereich **Buergerkonto-Login Einstellungen** konfiguriert werden. Die Einstellungen haben folgende Bedeutung: |
| ... |
... |
@@ -53,15 +53,33 @@ |
| 53 |
53 |
: Als Suffix sind Buchstaben, Zahlen und der Unterstrich erlaubt. |
| 54 |
54 |
: __Beispiel:__ |
| 55 |
55 |
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. |
| 56 |
|
-; gefordertes Authentifizierungsverfahren |
|
65 |
+; --gefordertes Authentifizierungsverfahren-- (Die hier beschriebenen Eigenschaften werden bis zur Version {{version major="3" minor="6"}}{{/version}} unterstützt. Bestehende Konfigurationen werden automatisch in die neue Auswahl //Einschränkung der Authentisierungsverfahren// übernommen.) |
| 57 |
57 |
: Hier kann das dem Nutzer zur Verfügung stehende Authentifizierungsverfahren eingeschränkt werden. |
| 58 |
58 |
: Es gibt folgende Auswahlmöglichkeiten: |
|
68 |
+:; keine Einschränkung |
|
69 |
+:: Login mittels Passwort, Authega-Zertifikat oder Personalausweis steht zur Auswahl |
|
70 |
+:; Authega |
|
71 |
+:: Nur die Authentifizierung mittels Authega-Zertifikat steht zur Auswahl |
|
72 |
+:; Authega oder Personalausweis |
|
73 |
+:: Login mittels Authega-Zertifikat oder Personalausweis steht zur Auswahl |
|
74 |
+:; Personalausweis |
|
75 |
+:: nur Authentifizierung mittels Personalausweis steht zur Auswahl |
|
76 |
+; Einschränkung der Authentisierungsverfahren (Eigenschaft steht ab Version {{version major="3" minor="6"}}{{/version}} zur Verfügung) |
|
77 |
+: Über diese Checkbox-Auswahl kann das dem Nutzer zur Verfügung stehende Authentifizierungsverfahren eingeschränkt werden. |
|
78 |
+: Ist nichts ausgewählt, erfolgt keine Einschränkung. |
|
79 |
+:; Benutzername |
|
80 |
+:: Authentifizierung erfolgt über Login / Passwort |
|
81 |
+:; Authega-Zertifikat |
|
82 |
+:; Elster-Zertifikat |
|
83 |
+:; FINK |
|
84 |
+:: Authentifizierung erfolgt über ein Identifikationsmittel aus dem Portfolio des //Föderierten Identitätsmanagements Interoperable Nutzerkonten// |
|
85 |
+:; eID (Personalausweis) |
|
86 |
+:; eIDAS |
|
87 |
+:: Authentifizierung mittels Identifikationsmittels nach eIDAS-Verordnung (//electronic IDentification, Authentication and Trust Services//) |
|
88 |
+; Postkorbversand obligatorisch |
|
89 |
+: Diese Einstellung ermöglich es die Postkorb-ID als verpflichtendes Rückgabe-Attribut zu kennzeichnen. |
|
90 |
+: Auf Seiten der AKDB werden dann alle Authentifizierungsarten, die keinen Postkorbversand ermöglichen, für den Nutzer ausgeblendet. |
| 59 |
59 |
|
| 60 |
|
-* **keine Einschränkung**: Login mittels Passwort, Authega-Zertifikat oder Personalausweis steht zur Auswahl |
| 61 |
|
-* **Authega**: Nur die Authentifizierung mittels Authega-Zertifikat steht zur Auswahl |
| 62 |
|
-* **Authega oder Personalausweis**: Login mittels Authega-Zertifikat oder Personalausweis steht zur Auswahl **(Achtung: Diese Auswahl wird momentan nicht mehr vom AKDB Portal unterstützt!)** |
| 63 |
|
-* **Personalausweis**: nur Authentifizierung mittels Personalausweis steht zur Auswahl |
| 64 |
|
- |
| 65 |
65 |
== Einbindung des Bürgerkonto Logins als Externer Benutzer == |
| 66 |
66 |
|
| 67 |
67 |
{{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. |
| ... |
... |
@@ -113,10 +113,11 @@ |
| 113 |
113 |
:; FINK |
| 114 |
114 |
:; eID |
| 115 |
115 |
:; eIDAS |
| 116 |
|
-: Ist kein Wert gesetzt, erfolgt keine Einschränkung der Authentisierungsverfahren und dem Nutzer werden alle vom Identity-Provider zur Verfügung gestellten Anmeldeverfahren zur Auswahl angezeigt. |
|
143 |
+: Ist kein Wert gesetzt, erfolgt keine Einschränkung der Authentisierungsverfahren und dem Nutzer |
|
144 |
+: werden alle vom Identity-Provider zur Verfügung gestellten Anmeldeverfahren zur Auswahl angezeigt. |
| 117 |
117 |
; PflichtElemente (ab Version {{version major="3" minor="6"}}{{/version}}) |
| 118 |
|
-: Über diese Eigenschaft können Attribute als verpflichtende Nutzereigenschaften angefordert werden. Alle Authentisierungsverfahren, |
| 119 |
|
-: welche die geforderten Attribute nicht erfüllen, werden dadurch ausgeblendet. |
|
146 |
+: Über diese Eigenschaft können Attribute als verpflichtende Nutzereigenschaften angefordert werden. |
|
147 |
+: Alle Authentisierungsverfahren, welche die geforderten Attribute nicht erfüllen, werden dadurch ausgeblendet. |
| 120 |
120 |
: Sofern der Formular-Workflow beispielsweise die Kommunikation mit dem Postkorb zwingend erfordert, |
| 121 |
121 |
: kann hier der Wert **Postkorb** angegeben werden, wodurch das Ausblenden der temporären Anmeldung erreicht wird. |
| 122 |
122 |
: Als Werte können können folgende Begriffe angegeben werden (Bei mehreren Werten sind diese durch Komma zu trennen): |
| ... |
... |
@@ -318,15 +318,24 @@ |
| 318 |
318 |
|
| 319 |
319 |
|
| 320 |
320 |
{{figure image="postkorb_absender.png"}} |
| 321 |
|
-Einstellungen für Absender und Empfänger |
|
349 |
+Einstellungen für Absender und Empfänger in V6 Formularen |
| 322 |
322 |
{{/figure}} |
| 323 |
323 |
|
| 324 |
|
-; Dienst (Pflicht) |
| 325 |
|
-: Wird als Information in der Postkorb-Ansicht im Bürgerservice-Portal verwendet. |
| 326 |
|
-; Mandant (Pflicht) |
| 327 |
|
-: Wird als Information in der Postkorb-Ansicht im Bürgerservice-Portal verwendet. |
|
352 |
+{{figure image="postkorb_absender_v3_6_fc_V7.png"}} |
|
353 |
+Einstellungen für Absender und Empfänger in V7 Formularen |
|
354 |
+{{/figure}} |
|
355 |
+ |
|
356 |
+; Mandant (ab Version {{version major="3" minor="6"}}{{/version}} kein Pflichtfeld) |
|
357 |
+: Wird als Information in der Postkorb-Ansicht im Bürgerservice-Portal verwendet. Ist an dieser Stelle kein Wert konfiguriert, wird die globale Einstellungen aus den Eigenschaften des Plugins verwendet. |
|
358 |
+; Dienst (ab Version {{version major="3" minor="6"}}{{/version}} kein Pflichtfeld) |
|
359 |
+: Wird als Information in der Postkorb-Ansicht im Bürgerservice-Portal verwendet. Ist an dieser Stelle kein Wert konfiguriert, wird die globale Einstellungen aus den Eigenschaften des Plugins verwendet. |
| 328 |
328 |
; Absender-Link |
| 329 |
329 |
: 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. |
|
362 |
+; Vertrauensniveau der Anmeldung für Zugriff auf Postkorb-Nachricht weiterreichen? (verfügbar ab Version {{version major="3" minor="6"}}{{/version}} im V7 Formular Workflow) |
|
363 |
+: Über diese Option können Sie festlegen, ob das Vertrauensniveau der Anmeldung (wenn dies ermittelt werden kann) |
|
364 |
+: für den Zugriff auf die Postkorb-Nachricht weitergereicht werden soll. |
|
365 |
+: Wenn kein Vertrauensniveau aus den Anmeldedaten ermittelt werden kann, wird das niedrigste Vertrauensniveau gesetzt, |
|
366 |
+: um einen Zugriff auf die Nachricht im Postfach der AKDB zu ermöglichen. |
| 330 |
330 |
; Postkorb ID aus den Vorgangsdaten ermitteln? |
| 331 |
331 |
: 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. |
| 332 |
332 |
Wird bei einem AKDB Bürgerkonto-Login die Postkorb-ID mit übermittelt, so wird diese standardmäßig am Formulareingang hinterlegt. |
| ... |
... |
@@ -340,9 +340,12 @@ |
| 340 |
340 |
|
| 341 |
341 |
|
| 342 |
342 |
{{figure image="postkorb_nachricht.png"}} |
| 343 |
|
-Konfiguration von Betreff, Nachrichteninhalt und Anhängen |
|
380 |
+Konfiguration von Betreff, Nachrichteninhalt und Anhängen in V6 Formularen |
| 344 |
344 |
{{/figure}} |
| 345 |
345 |
|
|
383 |
+{{figure image="postkorb_nachricht_v3_6_fc_V7.png"}} |
|
384 |
+Konfiguration von Betreff, Nachrichteninhalt und Anhängen in V7 Formularen |
|
385 |
+{{/figure}} |
| 346 |
346 |
|
| 347 |
347 |
; Betreff (Pflicht) |
| 348 |
348 |
: Nahrichtenbetreff, es werden Platzhalter unterstützt. |
| ... |
... |
@@ -350,7 +350,9 @@ |
| 350 |
350 |
: Nachrichtentext, es werden Platzhalter unterstützt. |
| 351 |
351 |
; Anhänge |
| 352 |
352 |
: Hier können Dateien als Attachments an die Postkorb-Nachricht gehangen werden. |
|
393 |
+: Unterstützte Dateiformate sind: PDF, HTML, Plaintext, MS Word, JPEG, GIF, PNG, ZIP |
| 353 |
353 |
: Zur Auswahl stehen dabei: |
|
395 |
+: (Auswahlmöglichkeiten in V6-Formularen) |
| 354 |
354 |
:; Upload |
| 355 |
355 |
:: bezieht sich auf alle Dateianhänge, die über das Formular hochgeladen wurden |
| 356 |
356 |
:; Workflow |
| ... |
... |
@@ -357,9 +357,18 @@ |
| 357 |
357 |
:: bezieht sich auf alle Dateianhänge, die über den aktuellen FORMCYCLE Workflow hochgeladen wurden. |
| 358 |
358 |
:; Posteingang |
| 359 |
359 |
:: bezieht sich auf alle Dateianhänge, die über das Postfach hochgeladen wurden. |
| 360 |
|
-:: Unterstützte Dateiformate sind: PDF, HTML, Plaintext, MS Word, JPEG, GIF, PNG |
|
402 |
+: (Auswahlmöglichkeiten in V7-Formularen) |
|
403 |
+:; Dateien aus vorherigen Aktionen |
|
404 |
+:: Eine Liste mit Dateien, von Datei-bereitstellenden Aktionen, die der Postkorb-Aktion vorangestellt sind. |
|
405 |
+:; Mandantdateien |
|
406 |
+:: Liefert eine Auswahlliste über alle Datei-Ressourcen am Mandanten |
|
407 |
+:; Formulardateien |
|
408 |
+:: Liefert eine Auswahlliste über alle Datei-Ressourcen, welche am Formular-Projekt hinterlegt sind. |
|
409 |
+:; Externe Ressourcen-URL |
|
410 |
+:: Dateien die über externe Quellen (HTTP-Requests) ermittelt werden können. |
|
411 |
+:; Vorgangsanhänge mittels Dateinamen suchen |
|
412 |
+:: Eine Suche innerhalb von Dateinamen mittels übereinstimmenden Suchbegriffs. Es kann dabei mittels Filter eingegrenzt werden, innerhalb welcher Datei-Quellen die Suche ausgeführt wird (Dateien aus Uploads, Datei aus der Statusverarbeitung, Dateien aus dem Posteingang) |
| 361 |
361 |
|
| 362 |
|
- |
| 363 |
363 |
{{info}} |
| 364 |
364 |
**Achtung:** |
| 365 |
365 |
Die Schnittstelle zum Postkorb der AKDB unterstützt dabei maximal 20 Anhänge pro Nachricht mit je 50 MByte Maximalgröße. |
| ... |
... |
@@ -413,14 +413,30 @@ |
| 413 |
413 |
|
| 414 |
414 |
== Versionshistorie == |
| 415 |
415 |
|
| 416 |
|
-=== 3.6.0 === |
|
467 |
+=== 3.6.0 - Bereitstellung erfolgt nach offiziellen Release der AKDB === |
| 417 |
417 |
|
| 418 |
418 |
* Erweiterungen / Anpassungen aufgrund von Schnittstellenanpassungen im Bürgerservice-Portal der AKDB: |
| 419 |
419 |
** Möglichkeit zur Anforderung von Pflicht-Attributen (Postkorb-ID) |
| 420 |
420 |
** Umstellung der Auswahlmöglichkeiten für das geforderte Authentifizierungsverfahren auf eine weiter reichende Auswahl (+Migration bestehender Konfigurationen am BK-Login-Button) |
|
472 |
+* Anpassung Postkorb-Aktion: Im Bereich des Absenders sind //Dienst //und //Mandant //keine Pflichtfelder mehr. Wenn Sie nicht definiert werden, werden die globalen Einstellungen |
|
473 |
+aus den Plugin-Properties herangezogen. |
|
474 |
+* Erweiterung Postkorb-Aktion: Im Bereich des Empfängers kann jetzt konfiguriert werden, dass das Vertrauensniveau der Anmeldung für den Zugriff auf die Nachricht im AKDB-Postfach mitgegeben wird. |
|
475 |
+* Anpassung AKDB-Vorlage: Anpassung der Verlage, da im Bereich des Absenders Dienst und Mandant keine Pflichtfelder mehr repräsentieren. |
| 421 |
421 |
* Anpassung AKDB-Setup: Hinweis auf freizugebende URL's (Firewall-Einstellungen) hinzugefügt |
| 422 |
422 |
* Fehlerbehebung: Fehlerbehandlung im Plugin-Action-Servlet 'AKDBLogin' angepasst |
| 423 |
423 |
|
|
479 |
+=== 3.5.10 === |
|
480 |
+ |
|
481 |
+* Fehlerbehebung: JavaScript für Datenvorlage wurde angepasst um eine zusätzliche Validierungsroutine für die Elemente innerhalb der Vorlage. Diese Validierung wird ausgeführt, wenn die Auswahl 'Privatperson / Organisation' geändert wurde. |
|
482 |
+ |
|
483 |
+=== 3.5.9 === |
|
484 |
+ |
|
485 |
+* Fehlerbehebung: JavaScript für Datenvorlage wurde angepasst, sodass sich ein Ändern der Steuerfelder 'IsOrganization' und 'IsIndividualPerson' auf alle Elemente innerhalb der Vorlage auswirken kann, wenn diese entsprechend Bedingungen ausweisen. |
|
486 |
+ |
|
487 |
+=== 3.5.8 === |
|
488 |
+ |
|
489 |
+* Fehlerbehebung: JavaScript für Datenvorlage wurde angepasst, sodass bei Ausblenden von Organisationsdaten, diese geleert werden, wenn dies im Designer konfiguriert ist. |
|
490 |
+ |
| 424 |
424 |
=== 3.5.7 === |
| 425 |
425 |
|
| 426 |
426 |
* 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) |
