| ... |
... |
@@ -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. |
| ... |
... |
@@ -93,15 +93,39 @@ |
| 93 |
93 |
Im letzten Schritt besteht die Möglichkeit die Konfiguration individuell anzupassen. |
| 94 |
94 |
Dazu können folgende Einstellungen getroffen werden: |
| 95 |
95 |
|
|
123 |
+ |
|
124 |
+ |
| 96 |
96 |
; LoginTyp |
| 97 |
97 |
: Mit dieser Einstellung lassen sich die Arten der zurück gelieferten Daten festlegen. |
| 98 |
98 |
: Ist als Wert **Person** definiert, so können nur personenbezogene Daten zurückgeliefert werden. |
| 99 |
99 |
: Ist **Organisation** definiert, so ist es nur möglich organisationsbezogene Daten zurückzuliefern. Das heißt ein Login als natürliche Person ist nicht möglich. |
| 100 |
100 |
: Ist dieser Parameter nicht konfiguriert, so kann der Nutzer selbst bestimmen, welche Datenart (personen- oder organisationsbezogen) er zurück liefern möchte. |
| 101 |
|
-; AuthTyp |
|
130 |
+; --AuthTyp-- (wird ab Version {{version major="3" minor="6"}}{{/version}}nicht mehr unterstützt) |
| 102 |
102 |
: Über diese Einstellung kann das geforderte Authentisierungsverfahren festgelegt werden. |
| 103 |
103 |
: Entweder mit Authega-Zertifikat (Wert: **Authega**) oder Personalausweis (Wert: **NPA**). |
| 104 |
104 |
: Ist nichts gesetzt oder das Attribut nicht vorhanden, so werden dem Nutzer alle möglichen Authentisierungsverfahren zur Auswahl angeboten. |
|
134 |
+; LoginMethod (ersetzt die Eigenschaft AuthTyp ab Version {{version major="3" minor="6"}}{{/version}}) |
|
135 |
+: Über diese Einstellung kann das geforderte Authentisierungsverfahren eingeschränkt werden. |
|
136 |
+: Es können dabei ein oder mehrere Werte (mit Komma getrennt) der folgenden Auflistung angegeben werden: |
|
137 |
+:; Benutzername |
|
138 |
+:; Authega |
|
139 |
+:; Elster |
|
140 |
+:; FINK |
|
141 |
+:; eID |
|
142 |
+:; eIDAS |
|
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. |
|
145 |
+; PflichtElemente (ab Version {{version major="3" minor="6"}}{{/version}}) |
|
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. |
|
148 |
+: Sofern der Formular-Workflow beispielsweise die Kommunikation mit dem Postkorb zwingend erfordert, |
|
149 |
+: kann hier der Wert **Postkorb** angegeben werden, wodurch das Ausblenden der temporären Anmeldung erreicht wird. |
|
150 |
+: Als Werte können können folgende Begriffe angegeben werden (Bei mehreren Werten sind diese durch Komma zu trennen): |
|
151 |
+:; PIN |
|
152 |
+:: In diesem Fall wird die sektor-spezifische Personen-Identifikations-Nummer (ssPIN) angefordert |
|
153 |
+:; Postkorb |
|
154 |
+:: In diesem Fall wird die Postkorb-Id als verpflichtender Wert angefordert, sodass im Workflow |
|
155 |
+:: die Voraussetzungen für den Versand einer Nachricht an den Postkorb des Nutzers gegeben sind. |
| 105 |
105 |
|
| 106 |
106 |
=== Bürgerkonto Login als Formularanmeldung einrichten === |
| 107 |
107 |
|
| ... |
... |
@@ -295,15 +295,24 @@ |
| 295 |
295 |
|
| 296 |
296 |
|
| 297 |
297 |
{{figure image="postkorb_absender.png"}} |
| 298 |
|
-Einstellungen für Absender und Empfänger |
|
349 |
+Einstellungen für Absender und Empfänger in V6 Formularen |
| 299 |
299 |
{{/figure}} |
| 300 |
300 |
|
| 301 |
|
-; Dienst (Pflicht) |
| 302 |
|
-: Wird als Information in der Postkorb-Ansicht im Bürgerservice-Portal verwendet. |
| 303 |
|
-; Mandant (Pflicht) |
| 304 |
|
-: 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. |
| 305 |
305 |
; Absender-Link |
| 306 |
306 |
: 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. |
| 307 |
307 |
; Postkorb ID aus den Vorgangsdaten ermitteln? |
| 308 |
308 |
: 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. |
| 309 |
309 |
Wird bei einem AKDB Bürgerkonto-Login die Postkorb-ID mit übermittelt, so wird diese standardmäßig am Formulareingang hinterlegt. |
| ... |
... |
@@ -317,9 +317,12 @@ |
| 317 |
317 |
|
| 318 |
318 |
|
| 319 |
319 |
{{figure image="postkorb_nachricht.png"}} |
| 320 |
|
-Konfiguration von Betreff, Nachrichteninhalt und Anhängen |
|
380 |
+Konfiguration von Betreff, Nachrichteninhalt und Anhängen in V6 Formularen |
| 321 |
321 |
{{/figure}} |
| 322 |
322 |
|
|
383 |
+{{figure image="postkorb_nachricht_v3_6_fc_V7.png"}} |
|
384 |
+Konfiguration von Betreff, Nachrichteninhalt und Anhängen in V7 Formularen |
|
385 |
+{{/figure}} |
| 323 |
323 |
|
| 324 |
324 |
; Betreff (Pflicht) |
| 325 |
325 |
: Nahrichtenbetreff, es werden Platzhalter unterstützt. |
| ... |
... |
@@ -327,6 +327,7 @@ |
| 327 |
327 |
: Nachrichtentext, es werden Platzhalter unterstützt. |
| 328 |
328 |
; Anhänge |
| 329 |
329 |
: 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 |
| 330 |
330 |
: Zur Auswahl stehen dabei: |
| 331 |
331 |
:; Upload |
| 332 |
332 |
:: bezieht sich auf alle Dateianhänge, die über das Formular hochgeladen wurden |
| ... |
... |
@@ -334,9 +334,7 @@ |
| 334 |
334 |
:: bezieht sich auf alle Dateianhänge, die über den aktuellen FORMCYCLE Workflow hochgeladen wurden. |
| 335 |
335 |
:; Posteingang |
| 336 |
336 |
:: bezieht sich auf alle Dateianhänge, die über das Postfach hochgeladen wurden. |
| 337 |
|
-:: Unterstützte Dateiformate sind: PDF, HTML, Plaintext, MS Word, JPEG, GIF, PNG |
| 338 |
338 |
|
| 339 |
|
- |
| 340 |
340 |
{{info}} |
| 341 |
341 |
**Achtung:** |
| 342 |
342 |
Die Schnittstelle zum Postkorb der AKDB unterstützt dabei maximal 20 Anhänge pro Nachricht mit je 50 MByte Maximalgröße. |
| ... |
... |
@@ -390,15 +390,31 @@ |
| 390 |
390 |
|
| 391 |
391 |
== Versionshistorie == |
| 392 |
392 |
|
| 393 |
|
-(% class="wikigeneratedid" %) |
| 394 |
|
-=== 3.6.0 === |
|
455 |
+=== 3.6.0 - Bereitstellung erfolgt nach offiziellen Release der AKDB === |
| 395 |
395 |
|
| 396 |
396 |
* Erweiterungen / Anpassungen aufgrund von Schnittstellenanpassungen im Bürgerservice-Portal der AKDB: |
| 397 |
397 |
** Möglichkeit zur Anforderung von Pflicht-Attributen (Postkorb-ID) |
| 398 |
398 |
** Umstellung der Auswahlmöglichkeiten für das geforderte Authentifizierungsverfahren auf eine weiter reichende Auswahl (+Migration bestehender Konfigurationen am BK-Login-Button) |
|
460 |
+* Anpassung Postkorb-Aktion: Im Bereich des Absenders sind //Dienst //und //Mandant //keine Pflichtfelder mehr. Wenn Sie nicht definiert werden, werden die globalen Einstellungen |
|
461 |
+aus den Plugin-Properties herangezogen. |
|
462 |
+* 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. |
|
463 |
+* Anpassung AKDB-Vorlage: Anpassung der Verlage, da im Bereich des Absenders Dienst und Mandant keine Pflichtfelder mehr repräsentieren. |
| 399 |
399 |
* Anpassung AKDB-Setup: Hinweis auf freizugebende URL's (Firewall-Einstellungen) hinzugefügt |
| 400 |
400 |
* Fehlerbehebung: Fehlerbehandlung im Plugin-Action-Servlet 'AKDBLogin' angepasst |
| 401 |
401 |
|
|
467 |
+(% class="wikigeneratedid" %) |
|
468 |
+=== 3.5.10 === |
|
469 |
+ |
|
470 |
+* 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. |
|
471 |
+ |
|
472 |
+=== 3.5.9 === |
|
473 |
+ |
|
474 |
+* 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. |
|
475 |
+ |
|
476 |
+=== 3.5.8 === |
|
477 |
+ |
|
478 |
+* Fehlerbehebung: JavaScript für Datenvorlage wurde angepasst, sodass bei Ausblenden von Organisationsdaten, diese geleert werden, wenn dies im Designer konfiguriert ist. |
|
479 |
+ |
| 402 |
402 |
=== 3.5.7 === |
| 403 |
403 |
|
| 404 |
404 |
* 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) |
