... |
... |
@@ -1,10 +1,5 @@ |
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 |
|
- |
8 |
8 |
{{content/}} |
9 |
9 |
|
10 |
10 |
{{info}} |
... |
... |
@@ -25,13 +25,9 @@ |
25 |
25 |
== Einbindung des Bürgerkonto Logins im Designer == |
26 |
26 |
|
27 |
27 |
{{figure image="hilfe_bk_button.png"}} |
28 |
|
-Einstellungen am Formular-Element //AKDB Bürgerkonto// bis Version {{version major="3" minor="6"}}{{/version}} |
|
23 |
+Formular-Element //AKDB Bürgerkonto// |
29 |
29 |
{{/figure}} |
30 |
30 |
|
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 |
|
- |
35 |
35 |
{{id name="BK_LoginButton"/}} |
36 |
36 |
|
37 |
37 |
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: |
... |
... |
@@ -62,33 +62,15 @@ |
62 |
62 |
: Als Suffix sind Buchstaben, Zahlen und der Unterstrich erlaubt. |
63 |
63 |
: __Beispiel:__ |
64 |
64 |
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. |
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.) |
|
56 |
+; gefordertes Authentifizierungsverfahren |
66 |
66 |
: Hier kann das dem Nutzer zur Verfügung stehende Authentifizierungsverfahren eingeschränkt werden. |
67 |
67 |
: 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. |
91 |
91 |
|
|
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 |
+ |
92 |
92 |
== Einbindung des Bürgerkonto Logins als Externer Benutzer == |
93 |
93 |
|
94 |
94 |
{{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. |
... |
... |
@@ -346,24 +346,15 @@ |
346 |
346 |
|
347 |
347 |
|
348 |
348 |
{{figure image="postkorb_absender.png"}} |
349 |
|
-Einstellungen für Absender und Empfänger in V6 Formularen |
|
322 |
+Einstellungen für Absender und Empfänger |
350 |
350 |
{{/figure}} |
351 |
351 |
|
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. |
|
325 |
+; Dienst (Pflicht) |
|
326 |
+: Wird als Information in der Postkorb-Ansicht im Bürgerservice-Portal verwendet. |
|
327 |
+; Mandant (Pflicht) |
|
328 |
+: Wird als Information in der Postkorb-Ansicht im Bürgerservice-Portal verwendet. |
360 |
360 |
; Absender-Link |
361 |
361 |
: 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. |
367 |
367 |
; Postkorb ID aus den Vorgangsdaten ermitteln? |
368 |
368 |
: 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. |
369 |
369 |
Wird bei einem AKDB Bürgerkonto-Login die Postkorb-ID mit übermittelt, so wird diese standardmäßig am Formulareingang hinterlegt. |
... |
... |
@@ -377,12 +377,9 @@ |
377 |
377 |
|
378 |
378 |
|
379 |
379 |
{{figure image="postkorb_nachricht.png"}} |
380 |
|
-Konfiguration von Betreff, Nachrichteninhalt und Anhängen in V6 Formularen |
|
344 |
+Konfiguration von Betreff, Nachrichteninhalt und Anhängen |
381 |
381 |
{{/figure}} |
382 |
382 |
|
383 |
|
-{{figure image="postkorb_nachricht_v3_6_fc_V7.png"}} |
384 |
|
-Konfiguration von Betreff, Nachrichteninhalt und Anhängen in V7 Formularen |
385 |
|
-{{/figure}} |
386 |
386 |
|
387 |
387 |
; Betreff (Pflicht) |
388 |
388 |
: Nahrichtenbetreff, es werden Platzhalter unterstützt. |
... |
... |
@@ -390,9 +390,7 @@ |
390 |
390 |
: Nachrichtentext, es werden Platzhalter unterstützt. |
391 |
391 |
; Anhänge |
392 |
392 |
: 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 |
394 |
394 |
: Zur Auswahl stehen dabei: |
395 |
|
-: (Auswahlmöglichkeiten in V6-Formularen) |
396 |
396 |
:; Upload |
397 |
397 |
:: bezieht sich auf alle Dateianhänge, die über das Formular hochgeladen wurden |
398 |
398 |
:; Workflow |
... |
... |
@@ -399,18 +399,9 @@ |
399 |
399 |
:: bezieht sich auf alle Dateianhänge, die über den aktuellen FORMCYCLE Workflow hochgeladen wurden. |
400 |
400 |
:; Posteingang |
401 |
401 |
:: bezieht sich auf alle Dateianhänge, die über das Postfach hochgeladen wurden. |
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 |
+:: Unterstützte Dateiformate sind: PDF, HTML, Plaintext, MS Word, JPEG, GIF, PNG |
413 |
413 |
|
|
363 |
+ |
414 |
414 |
{{info}} |
415 |
415 |
**Achtung:** |
416 |
416 |
Die Schnittstelle zum Postkorb der AKDB unterstützt dabei maximal 20 Anhänge pro Nachricht mit je 50 MByte Maximalgröße. |
... |
... |
@@ -464,30 +464,14 @@ |
464 |
464 |
|
465 |
465 |
== Versionshistorie == |
466 |
466 |
|
467 |
|
-=== 3.6.0 - Bereitstellung erfolgt nach offiziellen Release der AKDB === |
|
417 |
+=== 3.6.0 === |
468 |
468 |
|
469 |
469 |
* Erweiterungen / Anpassungen aufgrund von Schnittstellenanpassungen im Bürgerservice-Portal der AKDB: |
470 |
470 |
** Möglichkeit zur Anforderung von Pflicht-Attributen (Postkorb-ID) |
471 |
471 |
** 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. |
476 |
476 |
* Anpassung AKDB-Setup: Hinweis auf freizugebende URL's (Firewall-Einstellungen) hinzugefügt |
477 |
477 |
* Fehlerbehebung: Fehlerbehandlung im Plugin-Action-Servlet 'AKDBLogin' angepasst |
478 |
478 |
|
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 |
|
- |
491 |
491 |
=== 3.5.7 === |
492 |
492 |
|
493 |
493 |
* 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) |