| ... |
... |
@@ -1,12 +1,10 @@ |
| 1 |
|
-{{info}} |
| 2 |
|
-**Hinweis für Plugin-/{{formcycle/}}-Administratoren:** |
| 3 |
|
-Am 13.04.2021 wurde die Testumgebung des Bürgerservice-Portals aktualisiert. Diese ist jetzt unter [[**BayernID - Startseite**>>url:https://infra-pre-bayernid.freistaat.bayern/de/bayern/freistaat||rel="noopener noreferrer" target="_blank"]] erreichbar. Diese Änderung auf Seiten des Bürgerservice-Portals macht Anpassungen bei den Dienst-Anbindungen notwendig. |
|
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) |
| 4 |
4 |
|
| 5 |
|
-Bei einer Aktualisierung des Plugins auf mindestens eine Version {{version major="2" minor="15"}}{{/version}} werden die notwendigen Anpassungen automatisch durchgeführt und es sind keine weiteren manuellen Eingriffe durch den Administrator notwendig. |
|
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 |
6 |
{{/info}} |
| 7 |
7 |
|
| 8 |
|
-[[**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) |
| 9 |
|
- |
| 10 |
10 |
{{content/}} |
| 11 |
11 |
|
| 12 |
12 |
{{info}} |
| ... |
... |
@@ -27,9 +27,13 @@ |
| 27 |
27 |
== Einbindung des Bürgerkonto Logins im Designer == |
| 28 |
28 |
|
| 29 |
29 |
{{figure image="hilfe_bk_button.png"}} |
| 30 |
|
-Formular-Element //AKDB Bürgerkonto// |
|
28 |
+Einstellungen am Formular-Element //AKDB Bürgerkonto// bis Version {{version major="3" minor="6"}}{{/version}} |
| 31 |
31 |
{{/figure}} |
| 32 |
32 |
|
|
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 |
+ |
| 33 |
33 |
{{id name="BK_LoginButton"/}} |
| 34 |
34 |
|
| 35 |
35 |
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: |
| ... |
... |
@@ -60,15 +60,33 @@ |
| 60 |
60 |
: Als Suffix sind Buchstaben, Zahlen und der Unterstrich erlaubt. |
| 61 |
61 |
: __Beispiel:__ |
| 62 |
62 |
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. |
| 63 |
|
-; 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.) |
| 64 |
64 |
: Hier kann das dem Nutzer zur Verfügung stehende Authentifizierungsverfahren eingeschränkt werden. |
| 65 |
65 |
: 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. |
| 66 |
66 |
|
| 67 |
|
-* **keine Einschränkung**: Login mittels Passwort, Authega-Zertifikat oder Personalausweis steht zur Auswahl |
| 68 |
|
-* **Authega**: Nur die Authentifizierung mittels Authega-Zertifikat steht zur Auswahl |
| 69 |
|
-* **Authega oder Personalausweis**: Login mittels Authega-Zertifikat oder Personalausweis steht zur Auswahl **(Achtung: Diese Auswahl wird momentan nicht mehr vom AKDB Portal unterstützt!)** |
| 70 |
|
-* **Personalausweis**: nur Authentifizierung mittels Personalausweis steht zur Auswahl |
| 71 |
|
- |
| 72 |
72 |
== Einbindung des Bürgerkonto Logins als Externer Benutzer == |
| 73 |
73 |
|
| 74 |
74 |
{{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. |
| ... |
... |
@@ -100,15 +100,39 @@ |
| 100 |
100 |
Im letzten Schritt besteht die Möglichkeit die Konfiguration individuell anzupassen. |
| 101 |
101 |
Dazu können folgende Einstellungen getroffen werden: |
| 102 |
102 |
|
|
123 |
+ |
|
124 |
+ |
| 103 |
103 |
; LoginTyp |
| 104 |
104 |
: Mit dieser Einstellung lassen sich die Arten der zurück gelieferten Daten festlegen. |
| 105 |
105 |
: Ist als Wert **Person** definiert, so können nur personenbezogene Daten zurückgeliefert werden. |
| 106 |
106 |
: 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. |
| 107 |
107 |
: Ist dieser Parameter nicht konfiguriert, so kann der Nutzer selbst bestimmen, welche Datenart (personen- oder organisationsbezogen) er zurück liefern möchte. |
| 108 |
|
-; AuthTyp |
|
130 |
+; --AuthTyp-- (wird ab Version {{version major="3" minor="6"}}{{/version}}nicht mehr unterstützt) |
| 109 |
109 |
: Über diese Einstellung kann das geforderte Authentisierungsverfahren festgelegt werden. |
| 110 |
110 |
: Entweder mit Authega-Zertifikat (Wert: **Authega**) oder Personalausweis (Wert: **NPA**). |
| 111 |
111 |
: 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. |
| 112 |
112 |
|
| 113 |
113 |
=== Bürgerkonto Login als Formularanmeldung einrichten === |
| 114 |
114 |
|
| ... |
... |
@@ -302,15 +302,24 @@ |
| 302 |
302 |
|
| 303 |
303 |
|
| 304 |
304 |
{{figure image="postkorb_absender.png"}} |
| 305 |
|
-Einstellungen für Absender und Empfänger |
|
349 |
+Einstellungen für Absender und Empfänger in V6 Formularen |
| 306 |
306 |
{{/figure}} |
| 307 |
307 |
|
| 308 |
|
-; Dienst (Pflicht) |
| 309 |
|
-: Wird als Information in der Postkorb-Ansicht im Bürgerservice-Portal verwendet. |
| 310 |
|
-; Mandant (Pflicht) |
| 311 |
|
-: 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. |
| 312 |
312 |
; Absender-Link |
| 313 |
313 |
: 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. |
| 314 |
314 |
; Postkorb ID aus den Vorgangsdaten ermitteln? |
| 315 |
315 |
: 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. |
| 316 |
316 |
Wird bei einem AKDB Bürgerkonto-Login die Postkorb-ID mit übermittelt, so wird diese standardmäßig am Formulareingang hinterlegt. |
| ... |
... |
@@ -324,9 +324,12 @@ |
| 324 |
324 |
|
| 325 |
325 |
|
| 326 |
326 |
{{figure image="postkorb_nachricht.png"}} |
| 327 |
|
-Konfiguration von Betreff, Nachrichteninhalt und Anhängen |
|
380 |
+Konfiguration von Betreff, Nachrichteninhalt und Anhängen in V6 Formularen |
| 328 |
328 |
{{/figure}} |
| 329 |
329 |
|
|
383 |
+{{figure image="postkorb_nachricht_v3_6_fc_V7.png"}} |
|
384 |
+Konfiguration von Betreff, Nachrichteninhalt und Anhängen in V7 Formularen |
|
385 |
+{{/figure}} |
| 330 |
330 |
|
| 331 |
331 |
; Betreff (Pflicht) |
| 332 |
332 |
: Nahrichtenbetreff, es werden Platzhalter unterstützt. |
| ... |
... |
@@ -334,7 +334,9 @@ |
| 334 |
334 |
: Nachrichtentext, es werden Platzhalter unterstützt. |
| 335 |
335 |
; Anhänge |
| 336 |
336 |
: 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 |
| 337 |
337 |
: Zur Auswahl stehen dabei: |
|
395 |
+: (Auswahlmöglichkeiten in V6-Formularen) |
| 338 |
338 |
:; Upload |
| 339 |
339 |
:: bezieht sich auf alle Dateianhänge, die über das Formular hochgeladen wurden |
| 340 |
340 |
:; Workflow |
| ... |
... |
@@ -341,9 +341,18 @@ |
| 341 |
341 |
:: bezieht sich auf alle Dateianhänge, die über den aktuellen FORMCYCLE Workflow hochgeladen wurden. |
| 342 |
342 |
:; Posteingang |
| 343 |
343 |
:: bezieht sich auf alle Dateianhänge, die über das Postfach hochgeladen wurden. |
| 344 |
|
-:: 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) |
| 345 |
345 |
|
| 346 |
|
- |
| 347 |
347 |
{{info}} |
| 348 |
348 |
**Achtung:** |
| 349 |
349 |
Die Schnittstelle zum Postkorb der AKDB unterstützt dabei maximal 20 Anhänge pro Nachricht mit je 50 MByte Maximalgröße. |
| ... |
... |
@@ -397,6 +397,30 @@ |
| 397 |
397 |
|
| 398 |
398 |
== Versionshistorie == |
| 399 |
399 |
|
|
467 |
+=== 3.6.0 - Bereitstellung erfolgt nach offiziellen Release der AKDB === |
|
468 |
+ |
|
469 |
+* Erweiterungen / Anpassungen aufgrund von Schnittstellenanpassungen im Bürgerservice-Portal der AKDB: |
|
470 |
+** Möglichkeit zur Anforderung von Pflicht-Attributen (Postkorb-ID) |
|
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 |
+* Anpassung AKDB-Setup: Hinweis auf freizugebende URL's (Firewall-Einstellungen) hinzugefügt |
|
477 |
+* Fehlerbehebung: Fehlerbehandlung im Plugin-Action-Servlet 'AKDBLogin' angepasst |
|
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 |
+ |
| 400 |
400 |
=== 3.5.7 === |
| 401 |
401 |
|
| 402 |
402 |
* 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) |
