Wiki source code of AKDB: Bürgerkonto-Service-Plugin
Show last authors
| 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 | : Zu beachten ist, dass die angeforderten Eigenschaften mit dem unter LoginTyp angegebenen Wert korrespondieren. Dies bedeutet, dass beispielsweise bei einer angeforderten Authentifizierungsverfahren als Person, keine Organisations-Eigenschaften zurück geliefert werden können. | ||
| 164 | : Es können ein oder mehrere Werte aus der nachfolgenden Auflistung (mit Komma getrennt) angegeben werden: | ||
| 165 | : | ||
| 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-Adresse | ||
| 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 | |bkVorlagenAuswahl|(ab Version {{version major="3" minor="7" patch="1"}}{{/version}}) Enthält im Falle einer Anmeldung als natürliche Person den Wert //IsIndividualPerson//, im Falle der Anmeldung als Organisation den Wert //IsOrganization//. | ||
| 343 | {{/table}} | ||
| 344 | |||
| 345 | {{info}} | ||
| 346 | **Hinweis:** | ||
| 347 | 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. | ||
| 348 | \\__Beispiel:__ | ||
| 349 | Wenn als Suffix "**_Person2**" definiert wurde, so ergibt sich beim Vornamen der Formular-Elementname "tfAntragstellerVorname**_Person2**". | ||
| 350 | {{/info}} | ||
| 351 | |||
| 352 | === Darstellung des genutzten Authentifizierungsverfahren === | ||
| 353 | |||
| 354 | {{figure image="hilfe_trustlevel_visualisierung.png"}} | ||
| 355 | Darstellung des verwendeten Vertrauensniveaus an der Bürgerkonto Daten Vorlage | ||
| 356 | {{/figure}} | ||
| 357 | |||
| 358 | 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. | ||
| 359 | |||
| 360 | Für die einzelnen Vertrauensniveaus existieren folgende Beschriftungen: | ||
| 361 | |||
| 362 | * Level 1 (Authentifizierung mittels Benutzername / Passwort): **Standard** | ||
| 363 | * Level 3 (Authentifizierung mittels Authega Zertifikat): **Zertifikat** | ||
| 364 | * Level 4 (Authentifizierung mittels nPA): **Personalausweis** | ||
| 365 | |||
| 366 | {{figure image="hilfe_trustlevel_keine_visualisierung.png"}} | ||
| 367 | Wenn keine visuelle Markierung gewünscht ist, so kann dies durch ein zusätzliches Attribut „noRibbon“ am Vorlagen-Fieldset unterbunden werden | ||
| 368 | {{/figure}} | ||
| 369 | |||
| 370 | ==== Anpassungen der Darstellung aufgrund reduzierter Nutzerdaten ==== | ||
| 371 | |||
| 372 | 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. | ||
| 373 | |||
| 374 | |||
| 375 | 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. | ||
| 376 | 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. | ||
| 377 | |||
| 378 | Zusätzlich werden die Felder bei Wiederanzeige durch kleine Icons gekennzeichnet, wodurch auf einem Blick ersichtlich wird, aus welcher Quelle die Anmeldeinformationen entstammen. | ||
| 379 | |||
| 380 | * [[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 | ||
| 381 | * [[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 | ||
| 382 | |||
| 383 | 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: | ||
| 384 | |||
| 385 | * //verify_l1//: Kennzeichnet ein Element dessen Inhaltswert einen Level 1 Vertrauensniveaus (Authentifizierung mittels Benutzername / Passwort) entspricht. | ||
| 386 | * //verify_l3//: Kennzeichnet ein Element dessen Inhaltswert einen Level 3 Vertrauensniveaus (Authentifizierung mittels Zertifikat) entspricht. | ||
| 387 | * //verify_l4//: Kennzeichnet ein Element dessen Inhaltswert einen Level 4 Vertrauensniveaus (Authentifizierung mittels nPA oder eIDAS Identifikationsmittel) entspricht. | ||
| 388 | * //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. | ||
| 389 | |||
| 390 | {{figure image="noVerifyInfo.png"}} | ||
| 391 | Wenn keine visuelle Markierung der Formularelemente gewünscht ist, so kann dies durch ein zusätzliches Attribut „noVerifyInfo“ am Vorlagen-Fieldset unterbunden werden | ||
| 392 | {{/figure}} | ||
| 393 | |||
| 394 | == AKDB Postkorbanbindung in der Statusverarbeitung == | ||
| 395 | |||
| 396 | |||
| 397 | Für die Anbindung zum Versand von Postkorbnachrichten wird das Aktions-Plugin **AKDB:Postkorbnachricht senden** zur Verfügung gestellt. | ||
| 398 | Mittels dieser Plugin-Aktion, können ähnlich einer E-Mail Aktion, Nachrichten an den Postkorb der AKDB weitergeleitet werden. | ||
| 399 | |||
| 400 | Die Konfigurationsoberfläche des Aktions-Plugins ist in einzelne Bereiche unterteilt die nachfolgend kurz beschrieben werden. | ||
| 401 | |||
| 402 | {{panel title="Einstellungen für Absender und Empfänger" fullwidth="true" triggerable="true"}} | ||
| 403 | |||
| 404 | |||
| 405 | {{figure image="postkorb_absender.png"}} | ||
| 406 | Einstellungen für Absender und Empfänger in V6 Formularen | ||
| 407 | {{/figure}} | ||
| 408 | |||
| 409 | {{figure image="postkorb_absender_v3_6_fc_V7.png"}} | ||
| 410 | Einstellungen für Absender und Empfänger in V7 Formularen | ||
| 411 | {{/figure}} | ||
| 412 | |||
| 413 | ; Mandant (ab Version {{version major="3" minor="6"}}{{/version}} kein Pflichtfeld) | ||
| 414 | : 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. | ||
| 415 | ; Dienst (ab Version {{version major="3" minor="6"}}{{/version}} kein Pflichtfeld) | ||
| 416 | : 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. | ||
| 417 | ; Absender-Link | ||
| 418 | : 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. | ||
| 419 | ; Vertrauensniveau der Anmeldung für Zugriff auf Postkorb-Nachricht weiterreichen? (verfügbar ab Version {{version major="3" minor="6"}}{{/version}} im V7 Formular Workflow) | ||
| 420 | : Über diese Option können Sie festlegen, ob das Vertrauensniveau der Anmeldung (wenn dies ermittelt werden kann) | ||
| 421 | : für den Zugriff auf die Postkorb-Nachricht weitergereicht werden soll. | ||
| 422 | : Wenn kein Vertrauensniveau aus den Anmeldedaten ermittelt werden kann, wird das niedrigste Vertrauensniveau gesetzt, | ||
| 423 | : um einen Zugriff auf die Nachricht im Postfach der AKDB zu ermöglichen. | ||
| 424 | ; Postkorb ID aus den Vorgangsdaten ermitteln? | ||
| 425 | : 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. | ||
| 426 | Wird bei einem AKDB Bürgerkonto-Login die Postkorb-ID mit übermittelt, so wird diese standardmäßig am Formulareingang hinterlegt. | ||
| 427 | 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. | ||
| 428 | 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.) | ||
| 429 | |||
| 430 | |||
| 431 | {{/panel}} | ||
| 432 | |||
| 433 | {{panel title="Konfiguration des Nachrichteninhalts" fullwidth="true" triggerable="true"}} | ||
| 434 | |||
| 435 | |||
| 436 | {{figure image="postkorb_nachricht.png"}} | ||
| 437 | Konfiguration von Betreff, Nachrichteninhalt und Anhängen in V6 Formularen | ||
| 438 | {{/figure}} | ||
| 439 | |||
| 440 | {{figure image="postkorb_nachricht_v3_6_fc_V7.png"}} | ||
| 441 | Konfiguration von Betreff, Nachrichteninhalt und Anhängen in V7 Formularen | ||
| 442 | {{/figure}} | ||
| 443 | |||
| 444 | ; Betreff (Pflicht) | ||
| 445 | : Nahrichtenbetreff, es werden Platzhalter unterstützt. | ||
| 446 | ; Inhalt (Pflicht) | ||
| 447 | : Nachrichtentext, es werden Platzhalter unterstützt. | ||
| 448 | ; Anhänge | ||
| 449 | : Hier können Dateien als Attachments an die Postkorb-Nachricht gehangen werden. | ||
| 450 | : Unterstützte Dateiformate sind: PDF, HTML, Plaintext, MS Word, JPEG, GIF, PNG, ZIP | ||
| 451 | : Zur Auswahl stehen dabei: | ||
| 452 | : (Auswahlmöglichkeiten in V6-Formularen) | ||
| 453 | :; Upload | ||
| 454 | :: bezieht sich auf alle Dateianhänge, die über das Formular hochgeladen wurden | ||
| 455 | :; Workflow | ||
| 456 | :: bezieht sich auf alle Dateianhänge, die über den aktuellen FORMCYCLE Workflow hochgeladen wurden. | ||
| 457 | :; Posteingang | ||
| 458 | :: bezieht sich auf alle Dateianhänge, die über das Postfach hochgeladen wurden. | ||
| 459 | : (Auswahlmöglichkeiten in V7-Formularen) | ||
| 460 | :; Dateien aus vorherigen Aktionen | ||
| 461 | :: Eine Liste mit Dateien, von Datei-bereitstellenden Aktionen, die der Postkorb-Aktion vorangestellt sind. | ||
| 462 | :; Mandantdateien | ||
| 463 | :: Liefert eine Auswahlliste über alle Datei-Ressourcen am Mandanten | ||
| 464 | :; Formulardateien | ||
| 465 | :: Liefert eine Auswahlliste über alle Datei-Ressourcen, welche am Formular-Projekt hinterlegt sind. | ||
| 466 | :; Externe Ressourcen-URL | ||
| 467 | :: Dateien die über externe Quellen (HTTP-Requests) ermittelt werden können. | ||
| 468 | :; Vorgangsanhänge mittels Dateinamen suchen | ||
| 469 | :: 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) | ||
| 470 | |||
| 471 | {{info}} | ||
| 472 | **Achtung:** | ||
| 473 | Die Schnittstelle zum Postkorb der AKDB unterstützt dabei maximal 20 Anhänge pro Nachricht mit je 50 MByte Maximalgröße. | ||
| 474 | |||
| 475 | 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. | ||
| 476 | {{/info}} | ||
| 477 | |||
| 478 | {{/panel}} | ||
| 479 | |||
| 480 | === Bedingte Ausführung der //AKDB:Postkorbnachricht senden//-Aktion === | ||
| 481 | |||
| 482 | {{figure image="postkorb_nachricht_bedingung.png"}} | ||
| 483 | Konfiguration einer Bedingung für Ausführung der Aktion //AKDB~:Postkorbnachricht senden// | ||
| 484 | {{/figure}} | ||
| 485 | |||
| 486 | 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. | ||
| 487 | Dies bedeutet aber auch, dass wenn in einem Formularprozess kein zwingender Bürgerkonto-Login erfolgt, die Postkorb-ID **nicht** in der Statusverarbeitung vorhanden ist. | ||
| 488 | 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. | ||
| 489 | |||
| 490 | 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. | ||
| 491 | |||
| 492 | {{code language="javascript"}} | ||
| 493 | REGEX([%$POSTKORB_ID%]=^.+$) | ||
| 494 | {{/code}} | ||
| 495 | |||
| 496 | ==== Erweitere Bedingungsprüfung bei Verwendung unterschiedlicher Login-Arten (personenbezogenes bzw. organisationsbezogenes Login) ==== | ||
| 497 | |||
| 498 | |||
| 499 | 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. | ||
| 500 | Im Formular müssen dann versteckte Eingabefelder mit den Element-Namen **IsIndividualPerson** und **IsOrganization** vorhanden sein. | ||
| 501 | |||
| 502 | Die Konfiguration einer Ausführungs-Bedingung an einer Aktion //AKDB:Postkorbnachricht senden// für eine **personenbezogene** Anmeldung wäre dann folgendermaßen: | ||
| 503 | |||
| 504 | |||
| 505 | {{code language="javascript"}} | ||
| 506 | REGEX([%IsIndividualPerson%]=true) REGEX([%$POSTKORB_ID%]=^.+$) | ||
| 507 | {{/code}} | ||
| 508 | |||
| 509 | |||
| 510 | Bei Nutzung einer **organisationsbezogenen** Anmeldung ist folgende Bedingung zu konfigurieren: | ||
| 511 | |||
| 512 | |||
| 513 | {{code language="javascript"}} | ||
| 514 | REGEX([%IsOrganization%]=true) REGEX([%$POSTKORB_ID%]=^.+$) | ||
| 515 | {{/code}} | ||
| 516 | |||
| 517 | {{info}} | ||
| 518 | 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. | ||
| 519 | {{/info}} | ||
| 520 | |||
| 521 | |||
| 522 | == Versionshistorie == | ||
| 523 | |||
| 524 | === 3.8.3 === | ||
| 525 | |||
| 526 | * Fehlerbehebung: Automatischer Login im Popup Existenz des Url-Parameters 'xfc-pp-external' wurde wieder entfernt. | ||
| 527 | Damit hat nur die aktuelle Konfiguration an Login-Button Einfluss einen Aufruf im Popup | ||
| 528 | |||
| 529 | === 3.8.2 === | ||
| 530 | |||
| 531 | * Anpassung für Login innerhalb eines Ajax-Aufrufs: Login wird immer in einem Popup ausgeführt. | ||
| 532 | |||
| 533 | === 3.8.1 === | ||
| 534 | |||
| 535 | * Fehlerbeseitigung der Nichtanzeige der Konfiguration von einschränkenden Attributen am Login-Button | ||
| 536 | |||
| 537 | === 3.8.0 === | ||
| 538 | |||
| 539 | * Einbindung {{formcycle/}} Version {{version major="7" minor="4" }}{{/version}} | ||
| 540 | |||
| 541 | === 3.7.5 === | ||
| 542 | |||
| 543 | * Behebung einer Sicherheitslücke | ||
| 544 | |||
| 545 | === 3.7.4 === | ||
| 546 | |||
| 547 | * Fehlerbehebung: JavaScript-Fehler beim Einlesen der zurück gelieferten Anmeldedaten behoben | ||
| 548 | * Interne Anpassungen beim Abholen von Datei-Ressourcen über die API | ||
| 549 | |||
| 550 | === 3.7.3 === | ||
| 551 | |||
| 552 | * Anpassung AKDB-Setup: bei Vorbelegung der Entity-ID mit der URL vom Mandant wird jetzt Port-Nummer entfernt | ||
| 553 | * Behebung Anzeigefehler in Datenvorlage: Wenn Anmeldung abgebrochen und anschließend aber erfolgreich durchgeführt wurde, da waren die Felder in der Datenvorlage fehlerhaft markiert (als manuell durch Nutzereingaben vorbelegt). Dies wurde korrigiert. | ||
| 554 | |||
| 555 | === 3.7.2 === | ||
| 556 | |||
| 557 | * Interne Anpassungen zur besseren Fehleranalyse | ||
| 558 | |||
| 559 | === 3.7.1 === | ||
| 560 | |||
| 561 | * Anpassung AKDB-Setup: Erweiterung des Upload-Element für Ausführung eines Viren Scans versehen | ||
| 562 | * Erweiterung BuergerkontoData-Struktur: Bei einer Anmeldung über BK wird zusätzlich das Feld 'bkVorlagenAuswahl' zurück gegeben. | ||
| 563 | |||
| 564 | === 3.7.0 === | ||
| 565 | |||
| 566 | * Erweiterungen / Anpassungen aufgrund von Schnittstellenanpassungen im Bürgerservice-Portal der AKDB: | ||
| 567 | ** Möglichkeit zur Einschränkung der angeforderten Nutzerdaten am BK-Login-Button, sowie in der Plugin-Authenticator Konfiguration. | ||
| 568 | |||
| 569 | === 3.6.2 === | ||
| 570 | |||
| 571 | * 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. | ||
| 572 | |||
| 573 | === 3.6.1 === | ||
| 574 | |||
| 575 | * Fehlerbehebung: Beim Drucken eines Formulars mit Anmeldinformationen über den Print-Service erfolgte keine Darstellung des genutzten Authentifizierungsverfahren im erzeugten PDF. Dies wurde behoben. | ||
| 576 | * 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. | ||
| 577 | |||
| 578 | === 3.6.0 === | ||
| 579 | |||
| 580 | * Erweiterungen / Anpassungen aufgrund von Schnittstellenanpassungen im Bürgerservice-Portal der AKDB: | ||
| 581 | ** Möglichkeit zur Anforderung von Pflicht-Attributen (Postkorb-ID) | ||
| 582 | ** Umstellung der Auswahlmöglichkeiten für das geforderte Authentifizierungsverfahren auf eine weiter reichende Auswahl (+Migration bestehender Konfigurationen am BK-Login-Button) | ||
| 583 | * Anpassung Postkorb-Aktion: Im Bereich des Absenders sind //Dienst //und //Mandant //keine Pflichtfelder mehr. Wenn Sie nicht definiert werden, werden die globalen Einstellungen | ||
| 584 | aus den Plugin-Properties herangezogen. | ||
| 585 | * 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. | ||
| 586 | * Anpassung AKDB-Vorlage: Anpassung der Verlage, da im Bereich des Absenders Dienst und Mandant keine Pflichtfelder mehr repräsentieren. | ||
| 587 | * Anpassung AKDB-Setup: Hinweis auf freizugebende URL's (Firewall-Einstellungen) hinzugefügt, Konfigurationsmöglichkeit für Proxy-Server-Einstellungen | ||
| 588 | * Fehlerbehebung: Fehlerbehandlung im Plugin-Action-Servlet 'AKDBLogin' angepasst | ||
| 589 | |||
| 590 | === 3.5.13 === | ||
| 591 | |||
| 592 | * 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. | ||
| 593 | |||
| 594 | === 3.5.12 === | ||
| 595 | |||
| 596 | * Erweiterung von Log-Ausgaben innerhalb der Postkorb-Kommunikation zum Zwecke der Fehleranalyse. | ||
| 597 | |||
| 598 | === 3.5.11 === | ||
| 599 | |||
| 600 | * 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. | ||
| 601 | |||
| 602 | === 3.5.10 === | ||
| 603 | |||
| 604 | * 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. | ||
| 605 | |||
| 606 | === 3.5.9 === | ||
| 607 | |||
| 608 | * 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. | ||
| 609 | |||
| 610 | === 3.5.8 === | ||
| 611 | |||
| 612 | * Fehlerbehebung: JavaScript für Datenvorlage wurde angepasst, sodass bei Ausblenden von Organisationsdaten, diese geleert werden, wenn dies im Designer konfiguriert ist. | ||
| 613 | |||
| 614 | === 3.5.7 === | ||
| 615 | |||
| 616 | * 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) | ||
| 617 | * 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. | ||
| 618 | |||
| 619 | === 3.5.6 === | ||
| 620 | |||
| 621 | * Fehlerbehebung: Es wurde ein Fehler behoben, welcher bei der Wiederanzeige von Organisations-Adressdaten aufgetreten ist. Teilweise waren die Adressdaten unvollständig. | ||
| 622 | |||
| 623 | === 3.5.5 === | ||
| 624 | |||
| 625 | * Fehlerbehebung: Es wurde ein JS-Fehler behoben, der entstand, wenn das "TrustLevel"-Feld außerhalb der Daten-Vorlage verwendet wurde. | ||
| 626 | * Fehlerbehebung: Bei einer NPA-Anmeldung fehlten die RAW-Daten für die Adresse und die Stadt in den XFC_METADATEN. Dies wurde behoben. | ||
| 627 | |||
| 628 | === 3.5.4 === | ||
| 629 | |||
| 630 | * Erweiterung Postkorb-Aktion: Prüfroutine für Postkorb-Webservice-Kommunikation in Konfigurationsoberfläche hinzugefügt. | ||
| 631 | |||
| 632 | === 3.5.3 === | ||
| 633 | |||
| 634 | * Fehlerbehebung: Es wurde ein Sicherheitsproblem behoben, welches bei Laden von zwischengespeicherten Formulardaten auftreten kann. | ||
| 635 | |||
| 636 | === 3.5.2 === | ||
| 637 | |||
| 638 | * 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. | ||
| 639 | * Fehlerbehebung: Bei Verwendung mehrerer Anmeldungen innerhalb eines Formulars und damit unterschiedlichen Bürgerdaten-Suffix, kam es zu falschen Formatierungen der Datenfelder. Dies wurde behoben. | ||
| 640 | |||
| 641 | === 3.5.1 === | ||
| 642 | |||
| 643 | * 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. | ||
| 644 | |||
| 645 | === 3.5.0 === | ||
| 646 | |||
| 647 | * 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. | ||
| 648 | * Ü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 | ||
| 649 | * Fehlerbehebung: Fehlendes URL-Encoding eines Parameters führte dazu, dass Formular nach AKDB-Login nicht mehr gefunden wurde. Dies wurde behoben. | ||
| 650 | * Anpassung AKDB-Setup: beim Prüfung der Postkorb-Verbindung werden jetzt separat Zertifikat und Passwort auf Korrektheit geprüft und im Fehlerfall extra ausgewiesen. | ||
| 651 | |||
| 652 | === 3.4.0 === | ||
| 653 | |||
| 654 | * Konfigurative Möglichkeit eines URL-Rewritings am Login-Button auf die Assertion Consumer Service URL aus der Bürgerservice-Portal-Registrierung | ||
| 655 | * 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. | ||
| 656 | |||
| 657 | === 3.3.1 === | ||
| 658 | |||
| 659 | * 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. | ||
| 660 | |||
| 661 | === 3.3.0 === | ||
| 662 | |||
| 663 | * Überarbeitung der Revisionsicherheit und damit Anpassung an Weiterentwicklung in {{formcycle/}} | ||
| 664 | * 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 | ||
| 665 | * Neues Replacer-Plugin ('LOGIN_PROTOCOL') für eine Ausgabe aller Anmeldedaten, welche am Vorgang hinterlegt sind. | ||
| 666 | * Fehlerbehebung: Ein Fehler, welcher im Zusammenhang mit dem Einsatz des Bürgerkonto-Login-Buttons bei Benutzung in einem Popup auftrat, wurde behoben. | ||
| 667 | * 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 | ||
| 668 | |||
| 669 | === 3.2.1 === | ||
| 670 | |||
| 671 | * 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. | ||
| 672 | |||
| 673 | === 3.2.0 === | ||
| 674 | |||
| 675 | * Fehlerbehebung: Es wurde ein Fehler bei der Authentifizierung mittels Plugin-Authenticator behoben, der dazu führte, dass | ||
| 676 | das Formular mit den zurückgelieferten Nutzerdaten nicht mehr angezeigt wurde. | ||
| 677 | * 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. | ||
| 678 | (Hinweis: Formulare die auf den veralteten Vorlagen abbauen werden weiterhin unterstützt) | ||
| 679 | * Erweiterung der Vorlage für //personen- und organisationsbezogene Daten// um das Attribut 'IdentitaetsPruefer', welches zur Differenzierung der Art der Anmeldung innerhalb eines Vertrauensniveaus dient. | ||
| 680 | * Anpassung der Formular-Vorlage auf Grundlage der geänderten Nutzerdaten-Vorlage | ||
| 681 | |||
| 682 | === 3.1.0 === | ||
| 683 | |||
| 684 | * **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 | ||
| 685 | * Anpassung AKDB-Setup: im Bereich des Zertifikatsuploads für die Kommunikation mit dem Postkorb | ||
| 686 | |||
| 687 | === 3.0.0 === | ||
| 688 | |||
| 689 | * **Achtung:** alle neueren Versionen des Plugins benötigen ab dieser Version mindestens {{formcycle/}} Version {{version major="7" minor="0"}}{{/version}} oder höher | ||
| 690 | * Postkorb-Plugin für V7-Workflow | ||
| 691 | * Überarbeitung Formular-Vorlage für Nutzung des V7-Workflows | ||
| 692 | |||
| 693 | === === |