| ... |
... |
@@ -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}} |
| ... |
... |
@@ -83,11 +83,14 @@ |
| 83 |
83 |
; Postkorbversand obligatorisch |
| 84 |
84 |
: Diese Einstellung ermöglich es die Postkorb-ID als verpflichtendes Rückgabe-Attribut zu kennzeichnen. |
| 85 |
85 |
: Auf Seiten der AKDB werden dann alle Authentifizierungsarten, die keinen Postkorbversand ermöglichen, für den Nutzer ausgeblendet. |
|
91 |
+; Einschränkung der angeforderten Eigenschaften (Eigenschaft steht ab Version {{version major="3" minor="7"}}{{/version}} zur Verfügung) |
|
92 |
+: Über diese Checkbox-Auswahl kann der Nutzer die zurück gelieferten Eigenschaften einer erfolgreichen Authentifizierung einschränken. |
|
93 |
+: Damit wird dem Grundsatz der Datensparsamkeit der DSGVO (Datenschutz-Grundverordnung) entsprochen. Sind beispielsweise nur der Name und der Vorname einer Person in einem Formularprozess notwendig, |
|
94 |
+: so sind nur die entsprechenden Felder in dieser Auswahlliste zu selektieren. |
|
95 |
+: Ist nichts ausgewählt, erfolgt keine Einschränkung und alle möglichen Eigenschaften werden vom Bürgerservice-Portal angefordert. |
| 86 |
86 |
|
| 87 |
87 |
== Einbindung des Bürgerkonto Logins als Externer Benutzer == |
| 88 |
88 |
|
| 89 |
|
-{{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. |
| 90 |
|
- |
| 91 |
91 |
=== Konfiguration eines Externen Benutzers für das Bürgerkonto Login === |
| 92 |
92 |
|
| 93 |
93 |
{{figure image="externer_benutzer_akdb.png"}} |
| ... |
... |
@@ -148,6 +148,59 @@ |
| 148 |
148 |
:; Postkorb |
| 149 |
149 |
:: In diesem Fall wird die Postkorb-Id als verpflichtender Wert angefordert, sodass im Workflow |
| 150 |
150 |
:: die Voraussetzungen für den Versand einer Nachricht an den Postkorb des Nutzers gegeben sind. |
|
159 |
+; AngeforderteEigenschaften (ab Version {{version major="3" minor="7"}}{{/version}}) |
|
160 |
+: Diese Eigenschaft dient zum Einschränken der zurück gelieferten Attribute aus einer erfolgreichen Nutzer-Anmeldung. |
|
161 |
+: In erster Linie ist diese Eigenschaft dazu gedacht dem Grundsatz der Datensparsamkeit aus den Vorgaben der DSGVO (Datenschutz-Grundverordnung) gerecht zu werden. |
|
162 |
+: Sind keine Werte gesetzt, erfolgt keine Einschränkung und es werden alle vom Identity-Provider zur Verfügung gestellten Nutzer-Eigenschaften zurück geliefert. |
|
163 |
+: Es können ein oder mehrere Werte aus der nachfolgenden Auflistung (mit Komma getrennt) angegeben werden. |
|
164 |
+: Zu beachten ist, dass die angeforderten Eigenschaften mit dem unter LoginTyp angegebenen Wert korrespondieren. |
|
165 |
+: Dies bedeutet, dass beispielsweise bei einer angeforderten Authentifizierungsverfahren als Person, keine Organisations-Eigenschaften zurück geliefert werden können. |
|
166 |
+:; FIRST_NAME |
|
167 |
+:: Vorname |
|
168 |
+:; LAST_NAME |
|
169 |
+:: Nachname |
|
170 |
+:; EMAIL |
|
171 |
+:: Email |
|
172 |
+:; ADDRESS_STREET |
|
173 |
+:: Adresse |
|
174 |
+:; ADDRESS_ZIP_CODE |
|
175 |
+:: PLZ |
|
176 |
+:; ADDRESS_CITY |
|
177 |
+:: Ort |
|
178 |
+:; COUNTRY |
|
179 |
+:: Land |
|
180 |
+:; PERSONAL_TITLE |
|
181 |
+:: Titel |
|
182 |
+:; GENDER_TYPE |
|
183 |
+:: Geschlecht |
|
184 |
+:; BIRTHDATE |
|
185 |
+:: Geburtsdatum |
|
186 |
+:; PLACE_OF_BIRTH |
|
187 |
+:: Geburtsort |
|
188 |
+:; BIRTH_NAME |
|
189 |
+:: Geburtsname, nur bei Anmeldung als natürliche Person verfügbar |
|
190 |
+:; NATIONALITY |
|
191 |
+:: Staatsangehörigkeit, nur bei Anmeldung als natürliche Person verfügbar |
|
192 |
+:; DE_MAIL |
|
193 |
+:: DE-Mail |
|
194 |
+:; TELEPHONE_NUMBER |
|
195 |
+:: Telefon |
|
196 |
+:; ORGANIZATION_NAME |
|
197 |
+:: Name der Organisation, nur bei Anmeldung als Organisation verfügbar |
|
198 |
+:; ORGANIZATION_ID |
|
199 |
+:: Organisations-Id, nur bei Anmeldung als Organisation verfügbar |
|
200 |
+:; HOUSE_NUMBER |
|
201 |
+:: Hausnummer, nur bei Anmeldung als Organisation verfügbar |
|
202 |
+:; HOUSE_NUMBER_ADDITION |
|
203 |
+:: Hausnummern-Zusatz, nur bei Anmeldung als Organisation verfügbar |
|
204 |
+:; ADDRESS_ADDITION |
|
205 |
+:: Adress-Zusatz, nur bei Anmeldung als Organisation verfügbar |
|
206 |
+:; UK_HANDLE |
|
207 |
+:: Unternehmenskonto-Handle, nur bei Anmeldung als Organisation verfügbar |
|
208 |
+:; REGISTER_LOCATION |
|
209 |
+:: Register(gerichts)-Ort, nur bei Anmeldung als Organisation verfügbar |
|
210 |
+:; REGISTER_NUMBER |
|
211 |
+:: Registernummer, nur bei Anmeldung als Organisation verfügbar |
| 151 |
151 |
|
| 152 |
152 |
=== Bürgerkonto Login als Formularanmeldung einrichten === |
| 153 |
153 |
|
| ... |
... |
@@ -341,15 +341,24 @@ |
| 341 |
341 |
|
| 342 |
342 |
|
| 343 |
343 |
{{figure image="postkorb_absender.png"}} |
| 344 |
|
-Einstellungen für Absender und Empfänger |
|
405 |
+Einstellungen für Absender und Empfänger in V6 Formularen |
| 345 |
345 |
{{/figure}} |
| 346 |
346 |
|
| 347 |
|
-; Dienst (Pflicht) |
| 348 |
|
-: Wird als Information in der Postkorb-Ansicht im Bürgerservice-Portal verwendet. |
| 349 |
|
-; Mandant (Pflicht) |
| 350 |
|
-: Wird als Information in der Postkorb-Ansicht im Bürgerservice-Portal verwendet. |
|
408 |
+{{figure image="postkorb_absender_v3_6_fc_V7.png"}} |
|
409 |
+Einstellungen für Absender und Empfänger in V7 Formularen |
|
410 |
+{{/figure}} |
|
411 |
+ |
|
412 |
+; Mandant (ab Version {{version major="3" minor="6"}}{{/version}} kein Pflichtfeld) |
|
413 |
+: 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. |
|
414 |
+; Dienst (ab Version {{version major="3" minor="6"}}{{/version}} kein Pflichtfeld) |
|
415 |
+: 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. |
| 351 |
351 |
; Absender-Link |
| 352 |
352 |
: 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. |
|
418 |
+; Vertrauensniveau der Anmeldung für Zugriff auf Postkorb-Nachricht weiterreichen? (verfügbar ab Version {{version major="3" minor="6"}}{{/version}} im V7 Formular Workflow) |
|
419 |
+: Über diese Option können Sie festlegen, ob das Vertrauensniveau der Anmeldung (wenn dies ermittelt werden kann) |
|
420 |
+: für den Zugriff auf die Postkorb-Nachricht weitergereicht werden soll. |
|
421 |
+: Wenn kein Vertrauensniveau aus den Anmeldedaten ermittelt werden kann, wird das niedrigste Vertrauensniveau gesetzt, |
|
422 |
+: um einen Zugriff auf die Nachricht im Postfach der AKDB zu ermöglichen. |
| 353 |
353 |
; Postkorb ID aus den Vorgangsdaten ermitteln? |
| 354 |
354 |
: 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. |
| 355 |
355 |
Wird bei einem AKDB Bürgerkonto-Login die Postkorb-ID mit übermittelt, so wird diese standardmäßig am Formulareingang hinterlegt. |
| ... |
... |
@@ -363,9 +363,12 @@ |
| 363 |
363 |
|
| 364 |
364 |
|
| 365 |
365 |
{{figure image="postkorb_nachricht.png"}} |
| 366 |
|
-Konfiguration von Betreff, Nachrichteninhalt und Anhängen |
|
436 |
+Konfiguration von Betreff, Nachrichteninhalt und Anhängen in V6 Formularen |
| 367 |
367 |
{{/figure}} |
| 368 |
368 |
|
|
439 |
+{{figure image="postkorb_nachricht_v3_6_fc_V7.png"}} |
|
440 |
+Konfiguration von Betreff, Nachrichteninhalt und Anhängen in V7 Formularen |
|
441 |
+{{/figure}} |
| 369 |
369 |
|
| 370 |
370 |
; Betreff (Pflicht) |
| 371 |
371 |
: Nahrichtenbetreff, es werden Platzhalter unterstützt. |
| ... |
... |
@@ -373,7 +373,9 @@ |
| 373 |
373 |
: Nachrichtentext, es werden Platzhalter unterstützt. |
| 374 |
374 |
; Anhänge |
| 375 |
375 |
: Hier können Dateien als Attachments an die Postkorb-Nachricht gehangen werden. |
|
449 |
+: Unterstützte Dateiformate sind: PDF, HTML, Plaintext, MS Word, JPEG, GIF, PNG, ZIP |
| 376 |
376 |
: Zur Auswahl stehen dabei: |
|
451 |
+: (Auswahlmöglichkeiten in V6-Formularen) |
| 377 |
377 |
:; Upload |
| 378 |
378 |
:: bezieht sich auf alle Dateianhänge, die über das Formular hochgeladen wurden |
| 379 |
379 |
:; Workflow |
| ... |
... |
@@ -380,9 +380,18 @@ |
| 380 |
380 |
:: bezieht sich auf alle Dateianhänge, die über den aktuellen FORMCYCLE Workflow hochgeladen wurden. |
| 381 |
381 |
:; Posteingang |
| 382 |
382 |
:: bezieht sich auf alle Dateianhänge, die über das Postfach hochgeladen wurden. |
| 383 |
|
-:: Unterstützte Dateiformate sind: PDF, HTML, Plaintext, MS Word, JPEG, GIF, PNG |
|
458 |
+: (Auswahlmöglichkeiten in V7-Formularen) |
|
459 |
+:; Dateien aus vorherigen Aktionen |
|
460 |
+:: Eine Liste mit Dateien, von Datei-bereitstellenden Aktionen, die der Postkorb-Aktion vorangestellt sind. |
|
461 |
+:; Mandantdateien |
|
462 |
+:: Liefert eine Auswahlliste über alle Datei-Ressourcen am Mandanten |
|
463 |
+:; Formulardateien |
|
464 |
+:: Liefert eine Auswahlliste über alle Datei-Ressourcen, welche am Formular-Projekt hinterlegt sind. |
|
465 |
+:; Externe Ressourcen-URL |
|
466 |
+:: Dateien die über externe Quellen (HTTP-Requests) ermittelt werden können. |
|
467 |
+:; Vorgangsanhänge mittels Dateinamen suchen |
|
468 |
+:: 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) |
| 384 |
384 |
|
| 385 |
|
- |
| 386 |
386 |
{{info}} |
| 387 |
387 |
**Achtung:** |
| 388 |
388 |
Die Schnittstelle zum Postkorb der AKDB unterstützt dabei maximal 20 Anhänge pro Nachricht mit je 50 MByte Maximalgröße. |
| ... |
... |
@@ -436,14 +436,56 @@ |
| 436 |
436 |
|
| 437 |
437 |
== Versionshistorie == |
| 438 |
438 |
|
| 439 |
|
-=== 3.6.0 - Bereitstellung erfolgt nach offiziellen Release der AKDB === |
|
523 |
+=== 3.7.0 === |
| 440 |
440 |
|
| 441 |
441 |
* Erweiterungen / Anpassungen aufgrund von Schnittstellenanpassungen im Bürgerservice-Portal der AKDB: |
|
526 |
+** Möglichkeit zur Einschränkung der angeforderten Nutzerdaten am BK-Login-Button, sowie in der Plugin-Authenticator Konfiguration. |
|
527 |
+ |
|
528 |
+=== 3.6.2 === |
|
529 |
+ |
|
530 |
+* Fehlerbehebung: Bei Verwendung der Datenvorlage für //personen- und organisationsbezogene Daten // im Designer wurde nur das erste Element im Container angezeigt. Dies wurde behoben. Der Fehler tritt ab {{formcycle/}} Version {{version major="7" patch="11"}}{{/version}}auf. |
|
531 |
+ |
|
532 |
+=== 3.6.1 === |
|
533 |
+ |
|
534 |
+* Fehlerbehebung: Beim Drucken eines Formulars mit Anmeldinformationen über den Print-Service erfolgte keine Darstellung des genutzten Authentifizierungsverfahren im erzeugten PDF. Dies wurde behoben. |
|
535 |
+* Fehlerbehebung: URL-Rewriting am Login-Button wurde nicht angewendet, wenn hinterlegte Mandant-BaseURL der URL in der SAML-Konfiguration entsprach, obwohl Formular aufgrund eines verwendeten Proxy-Servers über abweichenden Aufruf-URL verwies. Dies wurde angepasst. |
|
536 |
+ |
|
537 |
+=== 3.6.0 === |
|
538 |
+ |
|
539 |
+* Erweiterungen / Anpassungen aufgrund von Schnittstellenanpassungen im Bürgerservice-Portal der AKDB: |
| 442 |
442 |
** Möglichkeit zur Anforderung von Pflicht-Attributen (Postkorb-ID) |
| 443 |
443 |
** Umstellung der Auswahlmöglichkeiten für das geforderte Authentifizierungsverfahren auf eine weiter reichende Auswahl (+Migration bestehender Konfigurationen am BK-Login-Button) |
| 444 |
|
-* Anpassung AKDB-Setup: Hinweis auf freizugebende URL's (Firewall-Einstellungen) hinzugefügt |
|
542 |
+* Anpassung Postkorb-Aktion: Im Bereich des Absenders sind //Dienst //und //Mandant //keine Pflichtfelder mehr. Wenn Sie nicht definiert werden, werden die globalen Einstellungen |
|
543 |
+aus den Plugin-Properties herangezogen. |
|
544 |
+* 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. |
|
545 |
+* Anpassung AKDB-Vorlage: Anpassung der Verlage, da im Bereich des Absenders Dienst und Mandant keine Pflichtfelder mehr repräsentieren. |
|
546 |
+* Anpassung AKDB-Setup: Hinweis auf freizugebende URL's (Firewall-Einstellungen) hinzugefügt, Konfigurationsmöglichkeit für Proxy-Server-Einstellungen |
| 445 |
445 |
* Fehlerbehebung: Fehlerbehandlung im Plugin-Action-Servlet 'AKDBLogin' angepasst |
| 446 |
446 |
|
|
549 |
+=== 3.5.13 === |
|
550 |
+ |
|
551 |
+* Fehlerbehebung: Behebt einen Fehler, welcher im Zusammenhang mit Ajax-Uploads und dem Absenden eines Formulars ab {{formcycle/}} Version {{version major="7" patch="11"}}{{/version}} steht. |
|
552 |
+ |
|
553 |
+=== 3.5.12 === |
|
554 |
+ |
|
555 |
+* Erweiterung von Log-Ausgaben innerhalb der Postkorb-Kommunikation zum Zwecke der Fehleranalyse. |
|
556 |
+ |
|
557 |
+=== 3.5.11 === |
|
558 |
+ |
|
559 |
+* Fehlerbehebung: Im Zusammenspiel mit der {{formcycle/}} Version {{version major="7" patch="10"}}{{/version}}konnten Zertifikatsdateien nicht über das AKDB Setup hochgeladen werden. Dieser Fehler wurde behoben. |
|
560 |
+ |
|
561 |
+=== 3.5.10 === |
|
562 |
+ |
|
563 |
+* 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. |
|
564 |
+ |
|
565 |
+=== 3.5.9 === |
|
566 |
+ |
|
567 |
+* 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. |
|
568 |
+ |
|
569 |
+=== 3.5.8 === |
|
570 |
+ |
|
571 |
+* Fehlerbehebung: JavaScript für Datenvorlage wurde angepasst, sodass bei Ausblenden von Organisationsdaten, diese geleert werden, wenn dies im Designer konfiguriert ist. |
|
572 |
+ |
| 447 |
447 |
=== 3.5.7 === |
| 448 |
448 |
|
| 449 |
449 |
* 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) |
| ... |
... |
@@ -523,34 +523,4 @@ |
| 523 |
523 |
* Postkorb-Plugin für V7-Workflow |
| 524 |
524 |
* Überarbeitung Formular-Vorlage für Nutzung des V7-Workflows |
| 525 |
525 |
|
| 526 |
|
-=== 2.18.3 === |
| 527 |
|
- |
| 528 |
|
-* Anpassung JS für Anzeige-Steuerung der BK-Vorlagen: Steuerparameter 'TrustLevel', 'IsOrganization' und 'IsIndividualPerson' können jetzt auch außerhalb des Vorlagen-Containers verwendet werden |
| 529 |
|
-* Fehlerbehebung: Es wurden Fehler bei der Wiederanzeige von zwischengespeicherten Daten bei Kommunikation über FS behoben. |
| 530 |
|
- |
| 531 |
|
-=== 2.18.2 === |
| 532 |
|
- |
| 533 |
|
-* Anpassung Postkorb: Umstellung von ID auf UUID bei Dateianhängen |
| 534 |
|
- |
| 535 |
|
-=== 2.18.1 === |
| 536 |
|
- |
| 537 |
|
-* Fehlerbehebung: Es wurde ein Fehler, beim Zwischenspeichern von Formulardaten vor der Weiterleitung zum BK-Portal, behoben. |
| 538 |
|
- |
| 539 |
|
-=== 2.18.0 === |
| 540 |
|
- |
| 541 |
|
-* Erweiterung AKDB-Setup: Neuer Einrichtungsschritt für die Erhebung von Organisationsdaten für Verwaltungszwecke. |
| 542 |
|
- |
| 543 |
|
-=== 2.17.0 === |
| 544 |
|
- |
| 545 |
|
-* Abschließende Anpassungen für Einführung Bürgerservice-Portal 2.0: |
| 546 |
|
-** Aktualisierung der Metadaten des Identity Providers, sowie des Postkorb-Webservice-Endpoints für die Anbindung des neuen Live-Systems |
| 547 |
|
-* Änderung im AKDB-Setup: |
| 548 |
|
-** Anpassungen am Layout, da es bei niedrigen Auflösungen dazu kam, dass Navigations-Buttons nicht angezeigt wurden |
| 549 |
|
-** Verbesserung der Logik für die Verbindungsprüfung bei Einrichtung der Postkorb-Anbindung |
| 550 |
|
- |
| 551 |
|
-=== 2.16.0 === |
| 552 |
|
- |
| 553 |
|
-* Aufnahme zusätzlicher vom Bürgerkonto übermittelter Daten. Die genaue Beschreibung dieser kann der obigen Parameter-Tabelle entnommen werden. |
| 554 |
|
-* Änderung im AKDB-Setup: Möglichkeit zur Prüfung der Erreichbarkeit des Postkorb-Webservice |
| 555 |
|
- |
| 556 |
556 |
=== === |
