| ... |
... |
@@ -49,7
+49,7 @@ |
| 49 |
49 |
Durch das Suffix wird es möglich mehrere Authentifizierungen und Formularelement-Vorbelegungen innerhalb eines Formulars zu realisieren. |
| 50 |
50 |
: Als Suffix sind Buchstaben, Zahlen und der Unterstrich erlaubt. |
| 51 |
51 |
: __Beispiel:__ |
| 52 |
|
-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. |
|
52 |
+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. |
| 53 |
53 |
; gefordertes Authentifizierungsverfahren |
| 54 |
54 |
: Hier kann das dem Nutzer zur Verfügung stehende Authentifizierungsverfahren eingeschränkt werden. |
| 55 |
55 |
: Es gibt folgende Auswahlmöglichkeiten: |
| ... |
... |
@@ -65,7
+65,7 @@ |
| 65 |
65 |
Formularvorlage //AKDB Basisdienste// |
| 66 |
66 |
{{/figure}} |
| 67 |
67 |
|
| 68 |
|
-Um die Daten aus dem Bürgerservice-Portal im Formular anzuzeigen, existieren zwei Vorlagen //Bürgerkonto personenbezogene Daten// und //Bürgerkonto organisationsbezogene Daten//. Die Felder innerhalb dieser Vorlagen sind so konfiguriert, dass sie eine automatische Zuordnung und damit die Anzeige der zurückgelieferten Daten ermöglichen. Die jeweilige Vorlage ist je nach der eingestellten [[Art der Rückgabedaten>>doc:||anchor="Art_Rueckgabedaten"]] am //AKDB Bürgerkonto//-Button zu wählen. |
|
68 |
+Um die Daten aus dem Bürgerservice-Portal im Formular anzuzeigen, existieren zwei Vorlagen //Bürgerkonto personenbezogene Daten// und //Bürgerkonto organisationsbezogene Daten//. Die Felder innerhalb dieser Vorlagen sind so konfiguriert, dass sie eine automatische Zuordnung und damit die Anzeige der zurückgelieferten Daten ermöglichen. Die jeweilige Vorlage ist je nach der eingestellten [[Art der Rückgabedaten>>doc:||anchor="Art_Rueckgabedaten"]] am //AKDB Bürgerkonto//-Button zu wählen. Bei Nutzung der eingangs erwähnten Formular-Templates, sind beide Designer-Vorlagen bereits eingebunden und werden nach anzuzeigender Datenart ein- oder ausgeblendet. |
| 69 |
69 |
|
| 70 |
70 |
Die vom Bürgerservice-Portal zurückgelieferten 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: |
| 71 |
71 |
|
| ... |
... |
@@ -77,7
+77,8 @@ |
| 77 |
77 |
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. |
| 78 |
78 |
|
| 79 |
79 |
{{info}} |
| 80 |
|
-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. Ist keine extra Kennzeichnung vorhanden, so ist der Parameter in beiden Bereichen vorhanden. |
|
80 |
+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. |
|
81 |
+Ist keine extra Kennzeichnung vorhanden, so ist der Parameter in beiden Bereichen vorhanden. |
| 81 |
81 |
{{/info}} |
| 82 |
82 |
|
| 83 |
83 |
{{table dataTypeAlpha="0" preSort="0-asc"}} |
| ... |
... |
@@ -113,7
+113,7 @@ |
| 113 |
113 |
|((( |
| 114 |
114 |
ZipCode (PBA) |
| 115 |
115 |
tfAntragstellerPLZ (PBA) |
| 116 |
|
-)))|PLZ |
|
117 |
+)))|Postleitzahl |
| 117 |
117 |
|((( |
| 118 |
118 |
Address (PBA) |
| 119 |
119 |
tfAntragstellerAdresse (PBA) |
| ... |
... |
@@ -161,17
+161,17 @@ |
| 161 |
161 |
|tfOrgRegisterNummer (OBA)|Registernummer |
| 162 |
162 |
|TrustLevel|((( |
| 163 |
163 |
Vertrauensniveau, gibt Auskunft über gewählte Authentifizierungsmethode: |
| 164 |
|
-**STORK-QAA-Level-1**: Authentifizierung mittels Benutzername / Passwort |
| 165 |
|
-**STORK-QAA-Level-3:** Authentifizierung mittels Authega Zertifikat |
| 166 |
|
-**STORK-QAA-Level-4**: Authentifizierung mittels nPA |
|
165 |
+* **STORK-QAA-Level-1**: Authentifizierung mittels Benutzername / Passwort |
|
166 |
+* **STORK-QAA-Level-3:** Authentifizierung mittels Authega Zertifikat |
|
167 |
+* **STORK-QAA-Level-4**: Authentifizierung mittels nPA |
| 167 |
167 |
))) |
| 168 |
|
-|NPA_Address (PBA)|Adresse, wie sie auf dem NPA vermerkt ist (Alles in Großbuchstaben) |
| 169 |
|
-|NPA_City (PBA)|Ort, wie er auf dem NPA vermerkt ist (Alles in Großbuchstaben) |
| 170 |
|
-|NPA_FirstName|Vorname, wie er auf dem NPA vermerkt ist (Alles in Großbuchstaben) |
| 171 |
|
-|NPA_LastName|Nachname, wie er auf dem NPA vermerkt ist (Alles in Großbuchstaben) |
| 172 |
|
-|NPA_PersonalTitle|Akademischer Titel, wie er auf dem NPA vermerkt ist (Alles in Großbuchstaben) |
| 173 |
|
-|IsIndividualPerson|Liefert den Wert **true** wenn es sich bei den Daten aus dem Bürgerkonto um personenbezogene Daten handelt, sonst **false**. |
| 174 |
|
-|IsOrganization|Liefert den Wert **true** wenn es sich bei den Daten aus dem Bürgerkonto um organisationsbezogene Daten handelt, sonst **false**. |
|
169 |
+|NPA_Address (PBA)|Adresse, wie sie auf dem NPA vermerkt ist (alles in Großbuchstaben) |
|
170 |
+|NPA_City (PBA)|Ort, wie er auf dem NPA vermerkt ist (alles in Großbuchstaben) |
|
171 |
+|NPA_FirstName|Vorname, wie er auf dem NPA vermerkt ist (alles in Großbuchstaben) |
|
172 |
+|NPA_LastName|Nachname, wie er auf dem NPA vermerkt ist (alles in Großbuchstaben) |
|
173 |
+|NPA_PersonalTitle|Akademischer Titel, wie er auf dem NPA vermerkt ist (alles in Großbuchstaben) |
|
174 |
+|IsIndividualPerson|Liefert den Wert **true**, wenn es sich bei den Daten aus dem Bürgerkonto um personenbezogene Daten handelt, sonst **false**. |
|
175 |
+|IsOrganization|Liefert den Wert **true**, wenn es sich bei den Daten aus dem Bürgerkonto um organisationsbezogene Daten handelt, sonst **false**. |
| 175 |
175 |
{{/table}} |
| 176 |
176 |
|
| 177 |
177 |
{{info}} |
| ... |
... |
@@ -221,9
+221,10 @@ |
| 221 |
221 |
; Absender-Link |
| 222 |
222 |
: 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. |
| 223 |
223 |
; Postkorb ID aus den Vorgangsdaten ermitteln? |
| 224 |
|
-: Diese Angabe dient der Bestimmung zur Ermittlung der Postkorb-ID. Über die Postkorb-ID wird das genaue Ziel für den Nachrichtenversand bestimmt, also der Nachrichten-Empfänger. |
| 225 |
|
-Bei einem AKDB Bürgerkonto-Login wird die Postkorb-ID immer mit übermittelt und standardmäßig am FORMCYCLE Vorgang hinterlegt. |
| 226 |
|
-Standardmäßig wird versucht die notwendige Postkorb-ID aus den am FORMCYCLE Vorgang hinterlegten Daten zu ermitteln. Wenn es mehrere konfigurierte Anmeldungen innerhalb eines Formulars gibt, so ist die Auswahl über den Bürgerdaten Parameter-Suffix einzugrenzen. |
|
225 |
+: 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. |
|
226 |
+Bei einem AKDB Bürgerkonto-Login wird die Postkorb-ID immer mit übermittelt und standardmäßig am Formulareingang hinterlegt. |
|
227 |
+Wenn an dieser Stelle die standardmäßige Einstellung verwendet wird, so wird versucht die Postkorb-ID immer aus den am Formulareingang hinterlegten Daten zu ermitteln. |
|
228 |
+Für den Fall, dass es mehrere konfigurierte Anmeldungen innerhalb eines Formulars gibt, kann hier die Auswahl über den Bürgerdaten Parameter-Suffix eingegrenzt werden. |
| 227 |
227 |
Darüber hinaus ist es möglich die Postkorb-ID fest oder über einen Platzhalter (**[%$POSTKORB_ID%]**) zu definieren. |
| 228 |
228 |
|
| 229 |
229 |
|
| ... |
... |
@@ -265,7
+265,8 @@ |
| 265 |
265 |
Konfiguration einer Bedingung für Ausführung der Aktion //AKDB~:Postkorbnachricht senden// |
| 266 |
266 |
{{/figure}} |
| 267 |
267 |
|
| 268 |
|
-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. Dies bedeutet aber auch, dass wenn in einem Formularprozess kein zwingender Bürgerkonto-Login erfolgt, die Postkorb-ID **nicht** in der Statusverarbeitung vorhanden ist. |
|
270 |
+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. |
|
271 |
+Dies bedeutet aber auch, dass wenn in einem Formularprozess kein zwingender Bürgerkonto-Login erfolgt, die Postkorb-ID **nicht** in der Statusverarbeitung vorhanden ist. |
| 269 |
269 |
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. |
| 270 |
270 |
|
| 271 |
271 |
Das nachfolgende Quellcode-Beispiel zeigt das Abprüfen der Postkorb-ID durch einen regulären Ausdruck. Die aktuelle Postkorb-ID wird dabei mittels eines System-Platzhalters im Prüfausdruck zur Verfügung gestellt. |