Von Version < 13.11 >
bearbeitet von rth
am 12.03.2020, 09:23
Auf Version < 13.13 >
bearbeitet von rth
am 12.03.2020, 09:41
< >
Änderungskommentar: Es gibt keinen Kommentar für diese Version

Zusammenfassung

Details

Seiteneigenschaften
Inhalt
... ... @@ -2,7 +2,7 @@
2 2  
3 3  {{info}}
4 4  **Achtung:**
5 -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.
5 +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!
6 6  {{/info}}
7 7  
8 8  {{figure image="formular_vorlage.png"}}
... ... @@ -13,7 +13,7 @@
13 13  Über das //AKDB Bürgerkonto Service Plugin// werden Möglichkeiten zur Einbindung der AKDB Basisdienste **Bürgerkonto** und **Postkorb** in {{formcycle/}} bereitgestellt.
14 14  
15 15  
16 -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.
16 +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.
17 17  
18 18  
19 19  == Einbindung des Bürgerkonto Logins im Designer ==
... ... @@ -30,35 +30,35 @@
30 30  ; Login im Popup
31 31  : Wenn aktiviert, wird die Login-Seite des Bürgerservice-Portals in einem Popup geöffnet, ansonst erfolgt die Anzeige in der gleichen Seite.
32 32  ; Formularseite nach Login
33 -: Hier wird die Formularseite festgelegt, welche angezeigt werden soll, wenn der Login erfolgreich war.
33 +: Hier wird die Formularseite festgelegt, welche angezeigt werden soll, wenn der Login **erfolgreich **war.
34 34  ; Formularseite nach abgebrochenen Login
35 -: Formularseite welche angezeigt werden soll, wenn der Login abgebrochen wurde.
35 +: Hier wird die Formularseite festgelegt, welche angezeigt werden soll, wenn der Login **abgebrochen** wurde.
36 36  ; Eingaben prüfen vor Login
37 37  : 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.
38 -; Art der Rückgabedaten
38 +; Art der Rückgabedaten {{id name="Art_Rueckgabedaten"/}}
39 39  : Hier besteht die Auswahl zwischen:
40 -:: **personenbezogenen Daten**
41 -:: **organisationsbezogenen Daten**
42 -:: **personen- oder organisationsbezogenen Daten**
43 -: Mit dieser Einstellung lässt sich die Art der zu erwarteten Rückgabedaten, je nach Anforderung, steuern.
44 -: Das heißt, wenn beispielsweise nur Daten einer natürlichen Person im Formularprozess zulassen sind, ist hier die Auswahl auf //personenbezogene Daten// einzustellen.
40 +
41 +* **personenbezogenen Daten**
42 +* **organisationsbezogenen Daten**
43 +* **personen- oder organisationsbezogenen Daten**
44 +
45 +: Mit dieser Einstellung lässt sich die Art der zu erwarteten Rückgabedaten steuern, je nach Anforderung.
46 +: Das heißt, wenn beispielsweise nur Daten einer natürlichen Person im Formularprozess zugelassen sind, ist hier die Auswahl auf //personenbezogene Daten// einzustellen.
45 45  ; Bürgerdaten Parameter-Suffix
46 46  : Hier kann ein Suffix definiert werden, welches beim Vorbelegen von Formularelementen, mit den ermittelten Bürgerkonto-Daten, Anwendung findet.
49 +Durch das Suffix wird es möglich mehrere Authentifizierungen und Formularelement-Vorbelegungen innerhalb eines Formulars zu realisieren.
47 47  : Als Suffix sind Buchstaben, Zahlen und der Unterstrich erlaubt.
48 48  : __Beispiel:__
49 -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. Durch das Suffix wird es möglich mehrere Authentifizierungen und Formularelement-Vorbelegungen innerhalb eines Formulars zu realisieren.
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. 
50 50  ; gefordertes Authentifizierungsverfahren
51 51  : Hier kann das dem Nutzer zur Verfügung stehende Authentifizierungsverfahren eingeschränkt werden.
52 -Es gibt folgende Auswahlmöglichkeiten:
53 -:; keine Einschränkung
54 -:: Login mittels Passwort, Authega-Zertifikat oder Personalausweis steht zur Auswahl
55 -:; Authega
56 -:: nur Authentifizierung mittels Authega-Zertifikat steht zur Auswahl
57 -:; Authega oder Personalausweis
58 -:: Login mittels Authega-Zertifikat oder Personalausweis steht zur Auswahl **(Achtung: Diese Auswahl wird momentan nicht mehr vom AKDB Portal unterstützt)**
59 -:; Personalausweis
60 -:: nur Authentifizierung mittels Personalausweis steht zur Auswahl
55 +: Es gibt folgende Auswahlmöglichkeiten:
61 61  
57 +* **keine Einschränkung**: Login mittels Passwort, Authega-Zertifikat oder Personalausweis steht zur Auswahl
58 +* **Authega**: Nur die Authentifizierung mittels Authega-Zertifikat steht zur Auswahl
59 +* **Authega oder Personalausweis**: Login mittels Authega-Zertifikat oder Personalausweis steht zur Auswahl **(Achtung: Diese Auswahl wird momentan nicht mehr vom AKDB Portal unterstützt!)**
60 +* **Personalausweis**: nur Authentifizierung mittels Personalausweis steht zur Auswahl
61 +
62 62  == Designer-Element: Bürgerkonto Daten Vorlage ==
63 63  
64 64  {{figure image="hilfe_bk_vorlagen.png"}}
... ... @@ -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 Anzeige, der zurückgelieferten Daten ermöglichen.
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:]] am //AKDB Bürgerkonto//-Button zu wählen.
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  
Copyright 2000-2025