Wiki-Quellcode von AKDB: Bürgerkonto-Service-Plugin
Zeige letzte Bearbeiter
author | version | line-number | content |
---|---|---|---|
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 | |||
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 | {{content/}} | ||
9 | |||
10 | {{info}} | ||
11 | **Achtung:** | ||
12 | Bevor Sie die AKDB-Basisdienste in ihren Formular-Prozessen einbinden, stellen Sie bitte sicher, dass die konfigurative Anbindung der Dienste durch den {{formcycle/}}-Administrator erfolgt ist! | ||
13 | {{/info}} | ||
14 | |||
15 | {{figure image="formular_vorlage.png"}} | ||
16 | Formularvorlage //AKDB Basisdienste// | ||
17 | {{/figure}} | ||
18 | |||
19 | |||
20 | Über das kostenpflichtige //AKDB Bürgerkonto Service Plugin// werden Möglichkeiten zur Einbindung der AKDB Basisdienste **Bürgerkonto** und **Postkorb** in {{formcycle/}} bereitgestellt. | ||
21 | |||
22 | |||
23 | Um Formulare mit Bürgerkonto- und Postkorb-Anbindung schnell und einfach zu erstellen, gibt es eine Vorlage mit Namen **AKDB Basisdienste**. Diese ist über den Menüpunkt //Meine Formulare// und dann über die Kachel //Neues Formular erstellen// erreichbar. Wird die Vorlage genutzt, dann sind das Bürgerkonto und der Postkorb mit einer funktionierenden Default-Konfiguration eingebunden, die man sofort nutzen kann. | ||
24 | |||
25 | == Einbindung des Bürgerkonto Logins im Designer == | ||
26 | |||
27 | {{figure image="hilfe_bk_button.png"}} | ||
28 | Einstellungen am Formular-Element //AKDB Bürgerkonto// bis Version {{version major="3" minor="6"}}{{/version}} | ||
29 | {{/figure}} | ||
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 | {{id name="BK_LoginButton"/}} | ||
36 | |||
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: | ||
38 | |||
39 | |||
40 | ; Schaltflächen Text | ||
41 | : Beschriftung des Login-Buttons | ||
42 | ; Login im Popup | ||
43 | : Wenn aktiviert, wird die Login-Seite des Bürgerservice-Portals in einem Popup geöffnet, ansonst erfolgt die Anzeige in der gleichen Seite. | ||
44 | ; Formularseite nach Login | ||
45 | : Hier wird die Formularseite festgelegt, welche angezeigt werden soll, wenn der Login **erfolgreich **war. | ||
46 | ; Formularseite nach abgebrochenen Login | ||
47 | : Hier wird die Formularseite festgelegt, welche angezeigt werden soll, wenn der Login **abgebrochen** wurde. | ||
48 | ; Eingaben prüfen vor Login | ||
49 | : Wenn aktiviert, werden die bisherigen Formulareingaben validiert. Der Start des Bürgerkonto Login-Prozesses ist dann erst möglich, wenn alle Nutzereingaben auf der Seite valide sind. Wenn deaktiviert, findet keine Überprüfung der bisherigen Formulareingaben statt und es wird sofort zum Bürgerservice-Portal weitergeleitet. | ||
50 | ; Art der Rückgabedaten {{id name="Art_Rueckgabedaten"/}} | ||
51 | : Hier besteht die Auswahl zwischen: | ||
52 | |||
53 | * **personenbezogenen Daten** | ||
54 | * **organisationsbezogenen Daten** | ||
55 | * **personen- oder organisationsbezogenen Daten** | ||
56 | |||
57 | : Mit dieser Einstellung lässt sich die Art der zu erwarteten Rückgabedaten steuern, je nach Anforderung. | ||
58 | : Das heißt, wenn beispielsweise nur Daten einer natürlichen Person im Formularprozess zugelassen sind, ist hier die Auswahl auf //personenbezogene Daten// einzustellen. | ||
59 | ; Bürgerdaten Parameter-Suffix {{id name="BK_Parameter_Suffix"/}} | ||
60 | : Hier kann ein Suffix definiert werden, welches beim Vorbelegen von Formularelementen, mit den ermittelten Bürgerkonto-Daten, Anwendung findet. | ||
61 | Durch das Suffix wird es möglich mehrere Authentifizierungen und Formularelement-Vorbelegungen innerhalb eines Formulars zu realisieren. | ||
62 | : Als Suffix sind Buchstaben, Zahlen und der Unterstrich erlaubt. | ||
63 | : __Beispiel:__ | ||
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.) | ||
66 | : Hier kann das dem Nutzer zur Verfügung stehende Authentifizierungsverfahren eingeschränkt werden. | ||
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 | ; 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. | ||
96 | |||
97 | == Einbindung des Bürgerkonto Logins als Externer Benutzer == | ||
98 | |||
99 | === Konfiguration eines Externen Benutzers für das Bürgerkonto Login === | ||
100 | |||
101 | {{figure image="externer_benutzer_akdb.png"}} | ||
102 | Bürgerkonto-Login als Externer Benutzer einrichten. (Schritt 1) | ||
103 | {{/figure}} | ||
104 | |||
105 | Zur Einbindung des Bürgerkonto-Logins über einen [[Externen Benutzer>>doc:Formcycle.UserInterface.UserSettings.ExternalUsers.WebHome||target="_blank"]], muss diese Login Möglichkeit zuvor konfiguriert werden. | ||
106 | |||
107 | Dazu muss im jeweiligen Mandaten in den Konfigurationsbereich Externe Benutzer gewechselt werden. Dort muss mittels {{ficon name="plus-circle-outline"/}} der über das Plugin zur Verfügung gestellte **AKDB Login** ausgewählt werden. | ||
108 | |||
109 | {{info}} | ||
110 | Beachten Sie, dass vor Verwendung des //Bürgerkonto-Login als Externer Benutzer// die konfigurative Anbindung des Dienstes durch den {{formcycle/}}-Administrator stattgefunden hat, da die zur Kommunikation benötigten Zertifikate und Informationen aus den Plugin-Einstellungen entnommen werden. | ||
111 | {{/info}} | ||
112 | |||
113 | {{figure image="externer_benutzer_akdb_s2.png"}} | ||
114 | Bürgerkonto-Login als Externer Benutzer einrichten. (Schritt 2) | ||
115 | {{/figure}} | ||
116 | |||
117 | Im nächsten Schritt muss über den Button "Konfiguration hinzufügen" eine Konfiguration hinzugefügt werden. | ||
118 | |||
119 | {{figure image="externer_benutzer_akdb_s3.png"}} | ||
120 | Bürgerkonto-Login als Externer Benutzer einrichten. (Schritt 3) | ||
121 | {{/figure}} | ||
122 | |||
123 | Im letzten Schritt besteht die Möglichkeit die Konfiguration individuell anzupassen. | ||
124 | Dazu können folgende Einstellungen getroffen werden: | ||
125 | |||
126 | |||
127 | |||
128 | ; LoginTyp | ||
129 | : Mit dieser Einstellung lassen sich die Arten der zurück gelieferten Daten festlegen. | ||
130 | : Ist als Wert **Person** definiert, so können nur personenbezogene Daten zurückgeliefert werden. | ||
131 | : 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. | ||
132 | : Ist dieser Parameter nicht konfiguriert, so kann der Nutzer selbst bestimmen, welche Datenart (personen- oder organisationsbezogen) er zurück liefern möchte. | ||
133 | ; --AuthTyp-- (wird ab Version {{version major="3" minor="6"}}{{/version}}nicht mehr unterstützt) | ||
134 | : Über diese Einstellung kann das geforderte Authentisierungsverfahren festgelegt werden. | ||
135 | : Entweder mit Authega-Zertifikat (Wert: **Authega**) oder Personalausweis (Wert: **NPA**). | ||
136 | : Ist nichts gesetzt oder das Attribut nicht vorhanden, so werden dem Nutzer alle möglichen Authentisierungsverfahren zur Auswahl angeboten. | ||
137 | ; LoginMethod (ersetzt die Eigenschaft AuthTyp ab Version {{version major="3" minor="6"}}{{/version}}) | ||
138 | : Über diese Einstellung kann das geforderte Authentisierungsverfahren eingeschränkt werden. | ||
139 | : Es können dabei ein oder mehrere Werte (mit Komma getrennt) der folgenden Auflistung angegeben werden: | ||
140 | :; Benutzername | ||
141 | :; Authega | ||
142 | :; Elster | ||
143 | :; FINK | ||
144 | :; eID | ||
145 | :; eIDAS | ||
146 | : Ist kein Wert gesetzt, erfolgt keine Einschränkung der Authentisierungsverfahren und dem Nutzer | ||
147 | : werden alle vom Identity-Provider zur Verfügung gestellten Anmeldeverfahren zur Auswahl angezeigt. | ||
148 | ; PflichtElemente (ab Version {{version major="3" minor="6"}}{{/version}}) | ||
149 | : Über diese Eigenschaft können Attribute als verpflichtende Nutzereigenschaften angefordert werden. | ||
150 | : Alle Authentisierungsverfahren, welche die geforderten Attribute nicht erfüllen, werden dadurch ausgeblendet. | ||
151 | : Sofern der Formular-Workflow beispielsweise die Kommunikation mit dem Postkorb zwingend erfordert, | ||
152 | : kann hier der Wert **Postkorb** angegeben werden, wodurch das Ausblenden der temporären Anmeldung erreicht wird. | ||
153 | : Als Werte können können folgende Begriffe angegeben werden (Bei mehreren Werten sind diese durch Komma zu trennen): | ||
154 | :; PIN | ||
155 | :: In diesem Fall wird die sektor-spezifische Personen-Identifikations-Nummer (ssPIN) angefordert | ||
156 | :; Postkorb | ||
157 | :: In diesem Fall wird die Postkorb-Id als verpflichtender Wert angefordert, sodass im Workflow | ||
158 | :: 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 | |||
171 | |||
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 | ||
212 | |||
213 | === Bürgerkonto Login als Formularanmeldung einrichten === | ||
214 | |||
215 | {{figure image="formular_zugriff.png"}} | ||
216 | Bürgerkonto Login als Externer Benutzer am Formular freischalten. | ||
217 | {{/figure}} | ||
218 | |||
219 | Um das Bürgerkonto-Login über einen [[Externen Benutzer>>doc:Formcycle.UserInterface.UserSettings.ExternalUsers.WebHome||target="_blank"]] am jeweiligen Formular zu ermöglichen, | ||
220 | muss dieses als [[Formularanmeldung>>doc:Formcycle.UserInterface.MyForms.Access||target="_blank"]] am Formular hinterlegt sein. | ||
221 | |||
222 | |||
223 | == Designer-Element: Bürgerkonto Daten Vorlage == | ||
224 | |||
225 | {{figure image="hilfe_bk_vorlagen.png"}} | ||
226 | Formularvorlage //AKDB Basisdienste// | ||
227 | {{/figure}} | ||
228 | |||
229 | Um die Daten aus dem Bürgerservice-Portal im Formular anzuzeigen, existiert die Vorlage //Bürgerkonto personen- und organisationsbezogene Daten.// Die Felder innerhalb dieser Vorlage sind so konfiguriert, dass sie eine automatische Zuordnung und damit die Anzeige der zurück gelieferten Daten ermöglichen. Bei Nutzung des eingangs erwähnten Formular-Templates, ist die Designer-Vorlage bereits eingebunden und je nach Anmeldetyp, werden die organisations-spezifischen Daten automatisch ein- oder ausgeblendet. | ||
230 | |||
231 | Die vom Bürgerservice-Portal zurück gelieferten Daten können mittels JavaScript auch anderweitig weiterverarbeitet werden. Dafür werden sie in Form einer JSON-Struktur im Zielformular zur Verfügung gestellt. Die JSON Struktur kann über folgende JavaScript-Variable ausgelesen werden: | ||
232 | |||
233 | |||
234 | {{code language="javascript"}} | ||
235 | XFC_METADATA.pluginResults.AKDBLoginAnalyzer | ||
236 | {{/code}} | ||
237 | |||
238 | Die nachfolgenden Tabelle listet alle Formularfeld-Namen auf, die in einem Formular genutzt werden können, um die Daten vom Bürgerservice-Portal in Formular-Elementen anzuzeigen. Einige Informationen sind über verschiedene Parameter-Namen abrufbar (einen englisch-sprachigen und einen deutsch-sprachigen Namen), in solchen Fällen können beide Benamungen gleichwertig genutzt werden. | ||
239 | |||
240 | {{info}} | ||
241 | Parameter, welche nur bei einer **p**ersonen**b**ezogenen **A**nmeldung vorhanden sind, sind mit **(PBA)** und die die nur bei einer **o**rganisations**b**ezogenen **A**nmeldung vorhanden sind, mit **(OBA)** gekennzeichnet. | ||
242 | Ist keine extra Kennzeichnung vorhanden, so ist der Parameter in beiden Bereichen vorhanden. | ||
243 | |||
244 | **Achtung: **Ab Plugin-Version **2.9.0** sind im Zuge einer Vereinheitlichung der Parameter-Name für **PBA** und **OBA**, bestimmte Parameter, die bisher nur bei **PBA** vorhanden waren auch bei einer **OBA** vorhanden. Im Zuge der Abwärtskompatibilität sind die OBA-spezifischen Parameter zusätzlich noch vorhanden. | ||
245 | Die betreffenden Parameter sind in der Tabelle mit **(PBA + OBA)** gekennzeichnet. | ||
246 | {{/info}} | ||
247 | |||
248 | {{info}} | ||
249 | **Hinweis für die vom Bürgerservice-Portal zurück gelieferten Daten:** | ||
250 | Bei der Authentifizierung mit eIDAS-notifizierten Identifikationsmittel gilt der Mindestdatensatz nach eIDAS-VO, daher kann es zu einem reduzierten Datensatz kommen. | ||
251 | **[[Attribute im eID Schema>>url:https://ec.europa.eu/cefdigital/wiki/display/EIDCOMMUNITY/Overview+of+available+attributes+of+pre-notified+and+notified+eID+schemes||rel="noopener noreferrer" target="_blank"]]** | ||
252 | {{/info}} | ||
253 | |||
254 | {{table dataTypeAlpha="0" preSort="0-asc"}} | ||
255 | |=Parameter|=Beschreibung | ||
256 | |BPK|Bereichsspezifisches Personenkennzeichen (in verschlüsselter Form) | ||
257 | |BPK_Decoded|Bereichsspezifisches Personenkennzeichen (in entschlüsselter Form) | ||
258 | |PostboxId|Postkorb-ID des Nutzers. Muss bei Anbindung des Postkorbs verwendet werden. | ||
259 | |((( | ||
260 | tfAntragstellerEmail (PBA + OBA) | ||
261 | )))|Email-Adresse | ||
262 | |Gender|Anrede als numerischer Wert nach ISO 5218:2004 | ||
263 | |GenderName|Lesbarer Text für Geschlechter-Code aus Attribut „gender“. | ||
264 | Mögliche Werte: //männlich//, //weiblich// | ||
265 | |((( | ||
266 | tfAntragstellerAnrede (PBA + OBA) | ||
267 | )))|Anrede, wird mit Hilfe des Geschlechter-Code aus Attribut „gender“ erzeugt. | ||
268 | Mögliche Werte: //Herr//, //Frau, Nicht bekannt// | ||
269 | |((( | ||
270 | tfAntragstellerTitel (PBA + OBA) | ||
271 | )))|Akademischer Titel | ||
272 | |((( | ||
273 | tfAntragstellerVorname (PBA + OBA) | ||
274 | )))|Vorname | ||
275 | |((( | ||
276 | tfAntragstellerName (PBA + OBA) | ||
277 | )))|Nachname | ||
278 | |((( | ||
279 | tfAntragstellerPLZ (PBA + OBA) | ||
280 | )))|Postleitzahl | ||
281 | |((( | ||
282 | tfAntragstellerAdresse (PBA + OBA) | ||
283 | )))|Adresse bestehend aus Strasse und Hausnummer | ||
284 | |((( | ||
285 | tfAntragstellerOrt (PBA + OBA) | ||
286 | )))|Ort | ||
287 | |tfAntragstellerLand (PBA + OBA)|Land aus dem der Antragsteller kommt oder die Organisation ihren Sitz hat. Als ISO 3166-1 alpha-2 gepflegt. (ab Version {{version major="2" minor="16"}}{{/version}}) | ||
288 | |((( | ||
289 | tfAntragstellerGeburtsdatum (PBA + OBA) | ||
290 | )))|Geburtsdatum im Format: dd.MM.yyyy | ||
291 | |tfAntragstellerGeburtsname (PBA + OBA)|Geburtsname (ab Version {{version major="2" minor="15"}}{{/version}}) | ||
292 | |((( | ||
293 | tfAntragstellerGeburtsort (PBA + OBA) | ||
294 | )))|Geburtsort | ||
295 | |((( | ||
296 | tfAntragstellerTelefon (PBA + OBA) | ||
297 | )))|Telefonnummer | ||
298 | |tfAntragstellerStaatsangehoerigkeit (PBA + OBA)|Staatsangehörigkeit (ab Version {{version major="2" minor="15"}}{{/version}}) | ||
299 | |tfAntragstellerDeMail (PBA + OBA)|De-Mail-Adresse (ab Version {{version major="2" minor="15"}}{{/version}}) | ||
300 | |tfAntragstellerEIDASAusstellerLand (PBA)|eIDAS Ausgabeland (ab Version {{version major="2" minor="15"}}{{/version}}) | ||
301 | |tfOrgVertreterVorname (OBA)|Vorname der Person, welche der hinterlegten Organisation angehört und über deren Account die Anmeldung erfolgte. | ||
302 | |tfOrgVertreterName (OBA)|Nachname der Person, welche der hinterlegten Organisation angehört und über deren Account die Anmeldung erfolgte. | ||
303 | |tfOrgVertreterTitel (OBA)|Akademischer Titel der Person, welche der hinterlegten Organisation angehört und über deren Account die Anmeldung erfolgte. | ||
304 | |((( | ||
305 | tfOrgVertreterAnrede (OBA) | ||
306 | )))|((( | ||
307 | Anrede für die Person, welche der hinterlegten Organisation angehört und über deren Account die Anmeldung erfolgte. | ||
308 | Anrede, wird mit Hilfe des Geschlechter-Code aus Attribut „gender“ erzeugt. Mögliche Werte: //Herr//, //Frau, Nicht bekannt// | ||
309 | ))) | ||
310 | |tfOrgVertreterGeburtsdatum (OBA)|Akademischer Titel der Person, welche der hinterlegten Organisation angehört und über deren Account die Anmeldung erfolgte. | ||
311 | |tfOrgVertreterGeburtsort (OBA)|Geburtsort der Person, welche der hinterlegten Organisation angehört und über deren Account die Anmeldung erfolgte. | ||
312 | |tfOrgEmail (OBA)|E-Mail Adresse der angemeldeten Person, welche diese im Unternehmen hat. (Kann von der E-Mail Adresse am personenbezogenen Account abweichen.) | ||
313 | |tfOrgVertreterTelefon (OBA)|Telefonnummer der Person, welche der hinterlegten Organisation angehört und über deren Account die Anmeldung erfolgte. | ||
314 | |tfOrgStrasse (OBA)|Strasse | ||
315 | |tfOrgHausnummer (OBA)|Hausnummer | ||
316 | |tfOrgHausnummerZusatz (OBA)|Hausnummern Zusatz | ||
317 | |tfOrgAdressZusatz (OBA)|Adress-Zusatz | ||
318 | |tfOrgPLZ (OBA)|PLZ | ||
319 | |tfOrgOrt (OBA)|Ort | ||
320 | |tfOrgName (OBA)|Name der Organisation (mit Rechtsform) | ||
321 | |tfOrgID (OBA)|Organisations-ID (abgekündigt, wird zukünftig durch das organisationsspezifische Kennzeichen ersetzt) | ||
322 | |tfOrgKennzeichen (OBA)|organisationsspezifisches Kennzeichen: ersetzt zukünftig die Organisations-ID. (ab Version {{version major="2" minor="16"}}{{/version}}) | ||
323 | |Rechtsform (OBA)|Rechtsform der Organisation | ||
324 | |tfOrgRegisterOrt (OBA)|Register(gerichts)-Ort | ||
325 | |tfOrgRegisterNummer (OBA)|Registernummer | ||
326 | |tfOrgUUID (OBA)|Unternehmenskonto-Handle (ab Version {{version major="2" minor="15"}}{{/version}}) | ||
327 | |TrustLevel|((( | ||
328 | Vertrauensniveau, gibt Auskunft über gewählte Authentifizierungsmethode: | ||
329 | * **STORK-QAA-Level-1**: Authentifizierung mittels Benutzername / Passwort | ||
330 | * **STORK-QAA-Level-3:** Authentifizierung mittels Authega Zertifikat | ||
331 | * **STORK-QAA-Level-4**: Authentifizierung mittels nPA | ||
332 | ))) | ||
333 | |IdentitaetsPruefer|Quelle der Identitätsprüfung (ab Version {{version major="2" minor="15"}}{{/version}}) (Mögliche Werte sind: **eIDAS**, **eID**, **Smart-eID**, **Authega**, **Elster**, **Benutzername** oder **FINK**) | ||
334 | |NPA_Address (PBA)|Adresse, wie sie auf dem NPA vermerkt ist (alles in Großbuchstaben) | ||
335 | |NPA_City (PBA)|Ort, wie er auf dem NPA vermerkt ist (alles in Großbuchstaben) | ||
336 | |NPA_FirstName|Vorname, wie er auf dem NPA vermerkt ist (alles in Großbuchstaben) | ||
337 | |NPA_LastName|Nachname, wie er auf dem NPA vermerkt ist (alles in Großbuchstaben) | ||
338 | |NPA_PersonalTitle|Akademischer Titel, wie er auf dem NPA vermerkt ist (alles in Großbuchstaben) | ||
339 | |IsIndividualPerson|Liefert den Wert **true**, wenn es sich bei den Daten aus dem Bürgerkonto um personenbezogene Daten handelt, sonst **false**. | ||
340 | |IsOrganization|Liefert den Wert **true**, wenn es sich bei den Daten aus dem Bürgerkonto um organisationsbezogene Daten handelt, sonst **false**. | ||
341 | |authVerifyInfos|(ab Version {{version major="3" minor="5"}}{{/version}}) Enthält als Wert ein JSON Objekt mit zusammenfassenden Verifikationsinformationen zur durchgeführten Authentifizierung, separiert nach NpaDaten-Suffix. Die Informationen bestehen aus einer Liste aller Element-Namen, welche durch die Authentifizierung befüllt wurden, dem genutzten Identitäts-Prüfer, sowie dem Trust-Level. Die **authVerifyInfos** sind in den XFC_METADATA-Objekt auch dann vorhanden, wenn keine explizite Anmeldung über das Bürgerservice-Portal stattgefunden hat, sondern beispielsweise eine Wiederanzeige des Vorgangsdaten über einen Prozess-Link. | ||
342 | {{/table}} | ||
343 | |||
344 | {{info}} | ||
345 | **Hinweis:** | ||
346 | Wenn am Formular-Element //AKDB Bürgerkonto// ein Bürgerdaten Parameter-Suffix vergeben wurde, so muss dieses an die jeweiligen Formular-Elementnamen angefügt werden, damit eine Vorbelegung erfolgreich durchgeführt werden kann. | ||
347 | \\__Beispiel:__ | ||
348 | Wenn als Suffix "**_Person2**" definiert wurde, so ergibt sich beim Vornamen der Formular-Elementname "tfAntragstellerVorname**_Person2**". | ||
349 | {{/info}} | ||
350 | |||
351 | === Darstellung des genutzten Authentifizierungsverfahren === | ||
352 | |||
353 | {{figure image="hilfe_trustlevel_visualisierung.png"}} | ||
354 | Darstellung des verwendeten Vertrauensniveaus an der Bürgerkonto Daten Vorlage | ||
355 | {{/figure}} | ||
356 | |||
357 | Bei Nutzung der **Bürgerkonto Daten Vorlagen** ist nach dem Absenden des Formulars, bei Wiederanzeige des Formular im Postfach, das durch den Nutzer verwendete Authentifizierungsverfahren anhand einer visuellen Markierung ersichtlich. | ||
358 | |||
359 | Für die einzelnen Vertrauensniveaus existieren folgende Beschriftungen: | ||
360 | |||
361 | * Level 1 (Authentifizierung mittels Benutzername / Passwort): **Standard** | ||
362 | * Level 3 (Authentifizierung mittels Authega Zertifikat): **Zertifikat** | ||
363 | * Level 4 (Authentifizierung mittels nPA): **Personalausweis** | ||
364 | |||
365 | {{figure image="hilfe_trustlevel_keine_visualisierung.png"}} | ||
366 | Wenn keine visuelle Markierung gewünscht ist, so kann dies durch ein zusätzliches Attribut „noRibbon“ am Vorlagen-Fieldset unterbunden werden | ||
367 | {{/figure}} | ||
368 | |||
369 | ==== Anpassungen der Darstellung aufgrund reduzierter Nutzerdaten ==== | ||
370 | |||
371 | Mit dem Update des Bürgerservice-Portals (**Release 3.2** vom **18.11.2021**) kann es bei Anmelde-Prozessen zur Übermittlung von reduzierten Nutzerdaten kommen (z.B. Authentifizierung mit eIDAS-notifizierten Identifikationsmittel). Dies äußert sich beispielsweise darin, dass nach der Anmeldung keine Adressdaten vom Nutzer in der Vorlage erscheinen. | ||
372 | |||
373 | |||
374 | Mit Plugin Version {{version major="3" minor="5"}}{{/version}} werden nach einer Anmeldung am Bürgerservice-Portal nur noch die Eingabefelder innerhalb der Datenvorlage für eine Bearbeitung gesperrt, welche durch den Authentifizierungsprozess am Bürgerservice-Portal befüllt wurden. | ||
375 | Alle übrigen Felder innerhalb der Vorlage, können dann standardmäßig durch den angemeldeten Benutzer bearbeitet werden, wenn im Designer für diese Felder nichts gegenteiliges festgelegt wurde. | ||
376 | |||
377 | Zusätzlich werden die Felder bei Wiederanzeige durch kleine Icons gekennzeichnet, wodurch auf einem Blick ersichtlich wird, aus welcher Quelle die Anmeldeinformationen entstammen. | ||
378 | |||
379 | * [[image:verified.png||alt="Icon für Informationen aus Bürgerservice-Portal" height="22" width="21"]] Felder mit diesem Icon wurden aus dem Bürgerservice-Portal übermittelt | ||
380 | * [[image:none_verified.png||alt="Icon für Informationen die der Nutzer nachträglich eingegeben hat" height="20" width="23"]] Felder mit diesem Icon wurden vom Nutzer nachträglich eingegeben und wurden deshalb nicht durch einen Identitätsprüfer verifiziert | ||
381 | |||
382 | Die Feld-Icons werden mittels CSS-Klassen an den Eingabe-Elementen hinzugefügt und können dadurch mittels eigenem CSS Definitionen übersteuert werden. Die dafür notwendigen Klassen haben folgende Namen: | ||
383 | |||
384 | * //verify_l1//: Kennzeichnet ein Element dessen Inhaltswert einen Level 1 Vertrauensniveaus (Authentifizierung mittels Benutzername / Passwort) entspricht. | ||
385 | * //verify_l3//: Kennzeichnet ein Element dessen Inhaltswert einen Level 3 Vertrauensniveaus (Authentifizierung mittels Zertifikat) entspricht. | ||
386 | * //verify_l4//: Kennzeichnet ein Element dessen Inhaltswert einen Level 4 Vertrauensniveaus (Authentifizierung mittels nPA oder eIDAS Identifikationsmittel) entspricht. | ||
387 | * //no_verify//: Kennzeichnet ein Element dessen Inhaltswert durch einen Nutzer frei eingegeben wurde und damit durch keinen Identitätsprüfer aus dem Umfeld des Bürgerservice-Portals geprüft wurde. | ||
388 | |||
389 | {{figure image="noVerifyInfo.png"}} | ||
390 | Wenn keine visuelle Markierung der Formularelemente gewünscht ist, so kann dies durch ein zusätzliches Attribut „noVerifyInfo“ am Vorlagen-Fieldset unterbunden werden | ||
391 | {{/figure}} | ||
392 | |||
393 | == AKDB Postkorbanbindung in der Statusverarbeitung == | ||
394 | |||
395 | |||
396 | Für die Anbindung zum Versand von Postkorbnachrichten wird das Aktions-Plugin **AKDB:Postkorbnachricht senden** zur Verfügung gestellt. | ||
397 | Mittels dieser Plugin-Aktion, können ähnlich einer E-Mail Aktion, Nachrichten an den Postkorb der AKDB weitergeleitet werden. | ||
398 | |||
399 | Die Konfigurationsoberfläche des Aktions-Plugins ist in einzelne Bereiche unterteilt die nachfolgend kurz beschrieben werden. | ||
400 | |||
401 | {{panel title="Einstellungen für Absender und Empfänger" fullwidth="true" triggerable="true"}} | ||
402 | |||
403 | |||
404 | {{figure image="postkorb_absender.png"}} | ||
405 | Einstellungen für Absender und Empfänger in V6 Formularen | ||
406 | {{/figure}} | ||
407 | |||
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. | ||
416 | ; Absender-Link | ||
417 | : 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. | ||
423 | ; Postkorb ID aus den Vorgangsdaten ermitteln? | ||
424 | : 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. | ||
425 | Wird bei einem AKDB Bürgerkonto-Login die Postkorb-ID mit übermittelt, so wird diese standardmäßig am Formulareingang hinterlegt. | ||
426 | Für den Fall, dass es mehrere konfigurierte Anmeldungen innerhalb eines Formulars gibt, kann hier die Auswahl über den [[Bürgerdaten Parameter-Suffix>>doc:||anchor="BK_Parameter_Suffix"]] eingegrenzt werden. | ||
427 | Darüber hinaus ist es möglich die Postkorb-ID fest oder über einen Platzhalter (**[%$POSTKORB_ID%]**) zu definieren. (Der Platzhalter wird über das Plugin zur Verfügung gestellt und kann in der Statusverarbeitung verwendet werden.) | ||
428 | |||
429 | |||
430 | {{/panel}} | ||
431 | |||
432 | {{panel title="Konfiguration des Nachrichteninhalts" fullwidth="true" triggerable="true"}} | ||
433 | |||
434 | |||
435 | {{figure image="postkorb_nachricht.png"}} | ||
436 | Konfiguration von Betreff, Nachrichteninhalt und Anhängen in V6 Formularen | ||
437 | {{/figure}} | ||
438 | |||
439 | {{figure image="postkorb_nachricht_v3_6_fc_V7.png"}} | ||
440 | Konfiguration von Betreff, Nachrichteninhalt und Anhängen in V7 Formularen | ||
441 | {{/figure}} | ||
442 | |||
443 | ; Betreff (Pflicht) | ||
444 | : Nahrichtenbetreff, es werden Platzhalter unterstützt. | ||
445 | ; Inhalt (Pflicht) | ||
446 | : Nachrichtentext, es werden Platzhalter unterstützt. | ||
447 | ; Anhänge | ||
448 | : 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 | ||
450 | : Zur Auswahl stehen dabei: | ||
451 | : (Auswahlmöglichkeiten in V6-Formularen) | ||
452 | :; Upload | ||
453 | :: bezieht sich auf alle Dateianhänge, die über das Formular hochgeladen wurden | ||
454 | :; Workflow | ||
455 | :: bezieht sich auf alle Dateianhänge, die über den aktuellen FORMCYCLE Workflow hochgeladen wurden. | ||
456 | :; Posteingang | ||
457 | :: bezieht sich auf alle Dateianhänge, die über das Postfach hochgeladen wurden. | ||
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) | ||
469 | |||
470 | {{info}} | ||
471 | **Achtung:** | ||
472 | Die Schnittstelle zum Postkorb der AKDB unterstützt dabei maximal 20 Anhänge pro Nachricht mit je 50 MByte Maximalgröße. | ||
473 | |||
474 | Anhänge im Zip-Format werden momentan von der Postkorb-Schnittstelle auf Seite der AKDB nicht unterstützt. Nachrichten mit Zip-Datei Anhängen werden vom System komplett verworfen, weshalb Zip-Dateien aktuell bereits im FORMCYCLE-System herausgefiltert werden, sodass die eigentliche Nachricht trotzdem den Postkorb erreichen kann. Beachten Sie dies bitte innerhalb des jeweiligen Workflows. | ||
475 | {{/info}} | ||
476 | |||
477 | {{/panel}} | ||
478 | |||
479 | === Bedingte Ausführung der //AKDB:Postkorbnachricht senden//-Aktion === | ||
480 | |||
481 | {{figure image="postkorb_nachricht_bedingung.png"}} | ||
482 | Konfiguration einer Bedingung für Ausführung der Aktion //AKDB~:Postkorbnachricht senden// | ||
483 | {{/figure}} | ||
484 | |||
485 | Um eine Nachricht an den Postkorb-Schnittstelle der AKDB zu übermitteln ist eine so genannte "//Postkorb-ID//" notwendig. Ähnlich einer E-Mail-Adresse stellt sie ein Merkmal dar, womit das Postfach eines Nutzers eindeutig im System der AKDB identifiziert werden kann. Die Ermittlung der //Postkorb-ID// eines Benutzers erfolgt dabei automatisch beim Login am Bürgerservice-Portal der AKDB, wodurch dieser Identifikator dann im weiteren Formularprozess zur Verfügung steht. | ||
486 | Dies bedeutet aber auch, dass wenn in einem Formularprozess kein zwingender Bürgerkonto-Login erfolgt, die Postkorb-ID **nicht** in der Statusverarbeitung vorhanden ist. | ||
487 | Damit die Statusverarbeitung bei Verwendung der Aktion **AKDB:Postkorbnachricht senden** nicht in einem Fehler resultiert, ist deshalb die Konfiguration einer entsprechenden Ausführungs-Bedingung sinnvoll. | ||
488 | |||
489 | Das nachfolgende Quellcode-Beispiel zeigt das Abprüfen der Postkorb-ID auf das Vorhandensein eines Wertes, durch einen regulären Ausdruck. Die aktuelle Postkorb-ID wird dabei mittels eines System-Platzhalters im Prüfausdruck zur Verfügung gestellt. | ||
490 | |||
491 | {{code language="javascript"}} | ||
492 | REGEX([%$POSTKORB_ID%]=^.+$) | ||
493 | {{/code}} | ||
494 | |||
495 | ==== Erweitere Bedingungsprüfung bei Verwendung unterschiedlicher Login-Arten (personenbezogenes bzw. organisationsbezogenes Login) ==== | ||
496 | |||
497 | |||
498 | Wenn in einem Formular beide Login-Arten (//personenbezogenes// und //organisationsbezogenes// Login) zugelassen sind und man unterschiedliche Nachrichten an den Postkorb senden möchte, so ist dies ebenfalls möglich. | ||
499 | Im Formular müssen dann versteckte Eingabefelder mit den Element-Namen **IsIndividualPerson** und **IsOrganization** vorhanden sein. | ||
500 | |||
501 | Die Konfiguration einer Ausführungs-Bedingung an einer Aktion //AKDB:Postkorbnachricht senden// für eine **personenbezogene** Anmeldung wäre dann folgendermaßen: | ||
502 | |||
503 | |||
504 | {{code language="javascript"}} | ||
505 | REGEX([%IsIndividualPerson%]=true) REGEX([%$POSTKORB_ID%]=^.+$) | ||
506 | {{/code}} | ||
507 | |||
508 | |||
509 | Bei Nutzung einer **organisationsbezogenen** Anmeldung ist folgende Bedingung zu konfigurieren: | ||
510 | |||
511 | |||
512 | {{code language="javascript"}} | ||
513 | REGEX([%IsOrganization%]=true) REGEX([%$POSTKORB_ID%]=^.+$) | ||
514 | {{/code}} | ||
515 | |||
516 | {{info}} | ||
517 | Bitte beachten Sie, dass Bedingungen vom Typ "Mehrere Bedinungen" werden immer UND-Verknüpft sind. Somit müssen alle REGEX-Bedingungen erfüllt sein, damit die Aktion ausgeführt wird. | ||
518 | {{/info}} | ||
519 | |||
520 | |||
521 | == Versionshistorie == | ||
522 | |||
523 | === 3.7.0 === | ||
524 | |||
525 | * 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: | ||
540 | ** Möglichkeit zur Anforderung von Pflicht-Attributen (Postkorb-ID) | ||
541 | ** Umstellung der Auswahlmöglichkeiten für das geforderte Authentifizierungsverfahren auf eine weiter reichende Auswahl (+Migration bestehender Konfigurationen am BK-Login-Button) | ||
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 | ||
547 | * Fehlerbehebung: Fehlerbehandlung im Plugin-Action-Servlet 'AKDBLogin' angepasst | ||
548 | |||
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 | |||
573 | === 3.5.7 === | ||
574 | |||
575 | * 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) | ||
576 | * Erweiterung Postkorb-Aktion: Die Prüfroutine für die Postkorb-Webservice-Kommunikation wurde um eine Zertifikats-Validierung erweitert, in deren Erfolgsmeldung das Ablaufdatum für die Gültigkeit des Zertifikats vermerkt ist. | ||
577 | |||
578 | === 3.5.6 === | ||
579 | |||
580 | * Fehlerbehebung: Es wurde ein Fehler behoben, welcher bei der Wiederanzeige von Organisations-Adressdaten aufgetreten ist. Teilweise waren die Adressdaten unvollständig. | ||
581 | |||
582 | === 3.5.5 === | ||
583 | |||
584 | * Fehlerbehebung: Es wurde ein JS-Fehler behoben, der entstand, wenn das "TrustLevel"-Feld außerhalb der Daten-Vorlage verwendet wurde. | ||
585 | * Fehlerbehebung: Bei einer NPA-Anmeldung fehlten die RAW-Daten für die Adresse und die Stadt in den XFC_METADATEN. Dies wurde behoben. | ||
586 | |||
587 | === 3.5.4 === | ||
588 | |||
589 | * Erweiterung Postkorb-Aktion: Prüfroutine für Postkorb-Webservice-Kommunikation in Konfigurationsoberfläche hinzugefügt. | ||
590 | |||
591 | === 3.5.3 === | ||
592 | |||
593 | * Fehlerbehebung: Es wurde ein Sicherheitsproblem behoben, welches bei Laden von zwischengespeicherten Formulardaten auftreten kann. | ||
594 | |||
595 | === 3.5.2 === | ||
596 | |||
597 | * Fehlerbehebung: Bei Rückleitung aus dem Bürgerservice-Portal und wenn Kommunikation nicht über Frontend-Server stattgefunden hat, wurde teilweise die Seite "Formular nicht gefunden" ausgeliefert. Dies wurde behoben. | ||
598 | * Fehlerbehebung: Bei Verwendung mehrerer Anmeldungen innerhalb eines Formulars und damit unterschiedlichen Bürgerdaten-Suffix, kam es zu falschen Formatierungen der Datenfelder. Dies wurde behoben. | ||
599 | |||
600 | === 3.5.1 === | ||
601 | |||
602 | * Fehlerbehebung: Bei Rückleitung aus dem Bürgerservice-Portal und wenn Kommunikation nicht über Frontend-Server stattgefunden hat, wurde teilweise die Seite "Formular nicht gefunden" ausgeliefert. Dies wurde behoben. | ||
603 | |||
604 | === 3.5.0 === | ||
605 | |||
606 | * Erweiterung der zurück gelieferten Authentifizierungsdaten: Das JSON-Objekt //authVerifyInfos// enthält die Namen der Elemente aus den Bürgerkontodaten, welche über die Authentifizierung am Bürgerservice-Portal übermittelt wurden. | ||
607 | * Überarbeitung JS und CSS für Vorlagen: die Felder innerhalb der Vorlage werden jetzt per ICON so aufbereitet, dass ersichtlich wird, woher die Daten stammen bzw. wer der Identitätsprüfer war | ||
608 | * Fehlerbehebung: Fehlendes URL-Encoding eines Parameters führte dazu, dass Formular nach AKDB-Login nicht mehr gefunden wurde. Dies wurde behoben. | ||
609 | * Anpassung AKDB-Setup: beim Prüfung der Postkorb-Verbindung werden jetzt separat Zertifikat und Passwort auf Korrektheit geprüft und im Fehlerfall extra ausgewiesen. | ||
610 | |||
611 | === 3.4.0 === | ||
612 | |||
613 | * Konfigurative Möglichkeit eines URL-Rewritings am Login-Button auf die Assertion Consumer Service URL aus der Bürgerservice-Portal-Registrierung | ||
614 | * Fehlerbehebung: Das eigenständige Overlay am Login-Button wurde entfernt und durch den System-Standard ersetzt. Dadurch wird beim Übersteuern des Standard-Overlay-Logos auch das Overlay-Logo am Login-Button mit übersteuert. | ||
615 | |||
616 | === 3.3.1 === | ||
617 | |||
618 | * Fehlerbehebung: Beim Login mittels Login-Button verhinderte der Popup-Blocker, welcher in vielen Browsern aktiv ist, ein Öffnen des Popups für die Login-Auswahl. Dies wurde behoben. | ||
619 | |||
620 | === 3.3.0 === | ||
621 | |||
622 | * Überarbeitung der Revisionsicherheit und damit Anpassung an Weiterentwicklung in {{formcycle/}} | ||
623 | * Erweiterung Plugin-Authenticator: Es gibt nun die Möglichkeit am Plugin-Authenticator (ähnlich wie am Bürgerkonto-Login-Button) ein //Bürgerdaten Parameter-Suffix// zu konfigurieren | ||
624 | * Neues Replacer-Plugin ('LOGIN_PROTOCOL') für eine Ausgabe aller Anmeldedaten, welche am Vorgang hinterlegt sind. | ||
625 | * Fehlerbehebung: Ein Fehler, welcher im Zusammenhang mit dem Einsatz des Bürgerkonto-Login-Buttons bei Benutzung in einem Popup auftrat, wurde behoben. | ||
626 | * Fehlerbehebung: Ein Fehler der im Zusammenhang mit dem Postkorb-Versand (fehlende Postkorb-ID), bei vorheriger Anmeldung mittels Plugin-Authentictors über einen Frontend-Server auftrat, wurde behoben | ||
627 | |||
628 | === 3.2.1 === | ||
629 | |||
630 | * Fehlerbehebung: In der Vorlage für //personen- und organisationsbezogene Daten// waren Elemente falsch benannt, sodass sie bei Anzeige nicht mit den Nutzer-Daten befüllt waren. Dies wurde behoben. | ||
631 | |||
632 | === 3.2.0 === | ||
633 | |||
634 | * Fehlerbehebung: Es wurde ein Fehler bei der Authentifizierung mittels Plugin-Authenticator behoben, der dazu führte, dass | ||
635 | das Formular mit den zurückgelieferten Nutzerdaten nicht mehr angezeigt wurde. | ||
636 | * die (veralteten) BK-Vorlagen für //persönliche Daten// und //organisationsbezogenen Daten// wurden aus dem Designer entfernt, sodass nur noch die Vorlage für //personen- und organisationsbezogene Daten// zur Auswahl steht, welche alle Anmeldefälle abdeckt. | ||
637 | (Hinweis: Formulare die auf den veralteten Vorlagen abbauen werden weiterhin unterstützt) | ||
638 | * Erweiterung der Vorlage für //personen- und organisationsbezogene Daten// um das Attribut 'IdentitaetsPruefer', welches zur Differenzierung der Art der Anmeldung innerhalb eines Vertrauensniveaus dient. | ||
639 | * Anpassung der Formular-Vorlage auf Grundlage der geänderten Nutzerdaten-Vorlage | ||
640 | |||
641 | === 3.1.0 === | ||
642 | |||
643 | * **Achtung:** alle neueren Versionen des Plugins benötigen ab dieser Version mindestens {{formcycle/}} Version {{version major="7" minor="0" patch="1"}}{{/version}} oder höher | ||
644 | * Anpassung AKDB-Setup: im Bereich des Zertifikatsuploads für die Kommunikation mit dem Postkorb | ||
645 | |||
646 | === 3.0.0 === | ||
647 | |||
648 | * **Achtung:** alle neueren Versionen des Plugins benötigen ab dieser Version mindestens {{formcycle/}} Version {{version major="7" minor="0"}}{{/version}} oder höher | ||
649 | * Postkorb-Plugin für V7-Workflow | ||
650 | * Überarbeitung Formular-Vorlage für Nutzung des V7-Workflows | ||
651 | |||
652 | === === |