Listennutzung - Beispiele Listennutzung

Page / - zuletzt bearbeitet von Form-Solutions GmbH am 14.12.2023

Beispiele Listennutzung

zuletzt bearbeitet von Form-Solutions GmbH

am 14.12.2023

Inhaltsverzeichnis

Dropdownkomponente mit Listenbefüllung

Dropdownkomponente mit Listenbefüllung und automatischer Befüllung von Komponenten

Dropdownkomponente die über eine Autovervollständigung befüllt wird

Autovervollständigung

Konfiguration der Komponente Autovervollständigung

Straßenverzeichnis

Einbindung des Straßenverzeichnisses über eine neue Liste

Einbindung des Straßenverzeichnisses über Verlagsliste

Flurstückskarte

Liste für Flurstückskarte erstellen

Flurstückskartenliste in der Listenverwaltung einbinden

Nutzung der Flurstückskarte in der Geo-Koordinaten-Komponente

SB-Terminal

Abfrage Benutzername & Passwort

Einbindung externer Kartenmaterialien in der Geo-Komponente (WMS-Layer)

Datumskomponente "Tage ausschließen"

Dropdownkomponente mit Listenbefüllung

Mit der Hilfe der Listenbefüllung kann man über eine Dropdownkomponente vordefinierte Auswahlmöglichkeiten dem Benutzer zur Verfügung stellen. Beispielsweise soll über eine Dropdownkomponente, die durch eine Liste befüllt wird, alle Bundesländer dem Ausfüller zur Auswahl zur Verfügung stehen. Hierzu muss in ein Panel im Assistenten eine Dropdownkomponente eingefügt werden. Nach dem Hinzufügen dieser Komponente muss in der „Konfiguration“ der Dropdownkomponente unter den „Speziellen Einstellungen“ die Auswahl „Einträge aus Liste?“ mit „Ja“ ausgewählt werden. Über „Liste auswählen“ werden alle zur Verfügung stehenden Listen angezeigt. Danach kann über die „Beschriftungsspalte“ angegeben werden, aus welcher Spalte mit Werten die Komponente befüllt werden soll, die der Ausfüller sieht. Mit der Auswahl der „Wertespalte“ kann man angeben, welche Spalte mit Werten das XML befüllen soll. Über die „Sortierspalte“ kann die Spalte ausgewählt werden die angibt, nach welcher Spalte die Beschriftungsspalte sortiert wird. Eine Vorauswahl, die dem Ausfüller angezeigt wird, kann mit dem Dropdownfeld „Vorauswahl“ getroffen werden.

Hinweis:
Wird keine Sortierspalte angegeben, wird trotzdem die Werte entsprechend sortiert ausgegeben.

Dropdownkomponente mit Listenbefüllung und automatischer Befüllung von Komponenten

Zusätzlich zu einer Dropdownkomponente, die durch eine Liste vordefiniert wurde, können weitere Eingabefelder automatisch befüllt werden. Beispielsweise soll ein Bundesland über eine Dropdownkomponente, die durch eine Liste befüllt wird, vom Ausfüller ausgewählt werden. Nach der Auswahl eines Bundeslands soll dann automatisch ein Eingabefeld mit der dazugehörigen Landeshauptstadt befüllt werden. Hierzu muss in ein Panel im Assistenten eine Dropdownkomponente eingefügt werden. Nach dem Hinzufügen dieser Komponente muss in der „Konfiguration“ der Dropdownkomponente eine Liste der Dropdownkomponente (siehe hierzu Dropdownkomponente mit Listenbefüllung) zugewiesen werden. Um das im Beispiel vorgenannte Eingabefeld automatisch befüllen zu lassen, muss zusätzlich in der Konfiguration der Dropdownkomponente ein „virtuelles Feld“ ausgewählt werden. Die virtuellen Felder beziehen sich auf die Spalten in der im Vorfeld angegebenen Liste. In diesem Beispiel muss dann die Spalte Landeshauptstadt angehakt werden. Das virtuelle Feld muss unter der Rubrik „Automatische Befüllung von Feldern“ zusätzlich dem Eingabefeld (Landeshauptstadt) zugewiesen werden.

Dropdownkomponente die über eine Autovervollständigung befüllt wird

Eine Dropdownkomponente, die sich in einer Autovervollständigung befindet und mit einer Liste aus der Autovervollständigung befüllt werden soll, benötigt eine spezielle Konfiguration. Hierzu muss in ein Panel im Assistenten eine Dropdownkomponente in eine Autovervollständigung eingefügt werden. Nach dem Hinzufügen dieser Komponente muss in der „Konfiguration“ der Dropdownkomponente anstatt einer Liste die Auswahl „Einträge aus umgebender Autovervollständigung“ zugewiesen werden. Danach kann Autovervollständigung normal konfiguriert werden (siehe hierzu Autovervollständigung).

Autovervollständigung

Mit einer Autovervollständigung über eine Liste können mehrere Felder automatisch befüllt bzw. falsche Eingaben verhindert werden. Für eine Autovervollständigung wird die Komponente „Autovervollständigung“ sowie die entsprechenden Eingabefelder, zum Beispiel einzeilige Textfelder, benötigt. Damit die Eingabefelder in der Autovervollständigung berücksichtigt werden, müssen die Eingabefelder „hierarchisch“ unter die Autovervollständigungskomponente platziert werden. In der Konfiguration der Autovervollständigungskomponente können unter der Rubrik „Spezielle Einstellungen“ weitere Einstellungen vorgenommen werden.

Konfiguration der Komponente Autovervollständigung

Art des Services
Über die Auswahl „Art des Services“ kann man angeben, welchen Dienst für die Autovervollständigung genutzt werden soll. Hierbei steht die Auswahl einer „Vorkonfigurierten Datenliste“, mit der man auf die Listen in der „Listenverwaltung“ zugreifen kann. Bei einer Auswahl „Auto-Vervollständigungsdienst“ kann man auf vordefinierte Service zugreifen. Hierbei steht derzeit nur der Service „Kontoinformationen“ zur Verfügung.

Liste auswählen
Über das Dropdownfeld „Liste auswählen“ werden alle zur Verfügung stehenden Datenlisten, die in der „Listenverwaltung“ angelegt wurden, angezeigt.

Art der Validierung
Hierüber kann angegeben werden, welche „Art der Validierung“ in der Autovervollständigungskomponente ausführt werden soll. Dieses Auswahlfeld steht nur bei der vorherigen Auswahl „Vorkonfigurierte Datenliste“ zur Verfügung.

Nur Autovervollständigung
Bei der Auswahl „Nur Autovervollständigung“ kann der Ausfüller des Assistenten einen Wert eingeben und mittels einer Autovervollständigung werden passende Vorschläge, die in der Liste hinterlegt sind, vorgeschlagen. Diese werden nach der passenden Auswahl automatisch in alle betreffenden Eingabefelder übernommen.

Nur Validierung
Bei der „Validierung“ wird geprüft, ob der eingegebene Wert (zum Beispiel einen Straßennamen) dem hinterlegten Wert in der Liste entspricht. Ist dies nicht der Fall, wird dem Ausfüller eine Fehlermeldung angezeigt.

Autovervollständigung und Validierung
Die Auswahl „Autovervollständigung und Validierung“ ist eine Kombination aus der „Nur Autovervollständigung“ und der „Nur Validierung“.

Listenfeld
Über die Dropdownkomponente „Listenfeld“ müssen die passenden Spalten, die in der ausgewählten Liste hinterlegt sind, den Eingabefeldern zugeordnet werden.

Feldanfang suchen
Mit der Einstellung kann angegeben werden, ob bei einer Eingabe eines Wertes am Anfang des hinterlegten Wertes in der Liste gesucht werden soll oder nicht.

Groß-Klein-Schreibung ignorieren
Bei der Auswahl kann angegeben werden, ob eine Groß-/Kleinschreibung bei der Eingabe eines Wertes in das Eingabefeld beachtet werden soll oder nicht.

Prioritätsstufe
Hier kann man angeben, welches Feld bei der Vervollständigung zuerst gesucht wird.

Straßenverzeichnis

Für die Nutzung eines Straßenverzeichnisses muss eine Liste erstellt und in das System eingebunden werden. Bei der Erstellung der benötigten CSV-Liste für das Straßenverzeichnis ist es zwingend notwendig, dass die Liste folgende Felder in der angegebenen Reihenfolge beinhaltet:

country

federalstate

shortname

place

postalCode

street

houseNumber

Hinweis:
Die Einbindung der Liste kann auch über eine URL (extterner CSV Import) erfolgen.

Einbindung des Straßenverzeichnisses über eine neue Liste

Die Liste kann als neue Liste in der Listenverwaltung hinterlegt werden. Danach kann diese über eine Autovervollständigung genutzt werden. Hierzu müssen entsprechende Eingabefelder „hierarchisch“ unter die Autovervollständigungskomponente platziert werden. In der Konfiguration der Autovervollständigungskomponente können unter der Rubrik „Spezielle Einstellungen“, dann die entsprechenden Felder der Liste den Eingabefeldern im Assistenten zugeordnet werden (siehe „Konfiguration der Komponente Autovervollständigung“).

Einbindung des Straßenverzeichnisses über Verlagsliste

Für die Nutzung des Straßenverzeichnisses über beispielsweise die Verlagskomponente „FS - Person - antragstellend (vorbefüllt)_Adresse (HausNr. Getrennt)“ muss die Liste als neue Liste in der Listenverwaltung mit der Bezeichnung „placesAllCountries“ oder „places“ hinterlegt werden. Danach steht in der Komponente nicht nur die Länder, Postleitzahlen und Orte zur Verfügung, sondern auch die hinterlegten Straßen und Hausnummern.

Hinweis:

Beim Hochladen der Liste muss die Option „Zurückgreifen auf globale Liste“ ausgewählt sein.

Die Liste wird in allen Assistenten verwendet bei der die Komponente bzw. Liste hinterlegt wurde.

Flurstückskarte

Sofern gewünscht kann die Geo-Koordinaten-Komponte nicht nur Straßen anzeigen sondern auch Flurstücke. Hierzu muss eine spezielle Liste mit den Flurstückswerten erstellt werden.

Liste für Flurstückskarte erstellen

Folgenden Felder muss die Liste in der nachfolgenden Reihenfolge beinhalten:

country
Hier muss das Länderkürzel hinterlegt werden.
Beispiel: DE

federalstate
Hier muss das Bundesland hinterlegt werden.
Beispiel: Baden-Württemberg

shortname
Hier muss das Bundeslandkürzel hinterlegt werden.
Beispiel: BW

place
Hier muss der Ortsname hinterlegt werden.
Beispiel: Karlsruhe

postalCode
Hier muss die Postleitzahl hinterlegt werden.
Beispiel: 76137

street
Hier muss der Straßenname hinterlegt werden.
Beispiel: Bahnhofstraße

houseNumber
Hier muss die Hausnummer hinterlegt werden.
Beispiel: 10

str_amtlich
Hierbei muss entweder der Wert 1 oder 0 hinterlegt werden.
Beispiel: 0

Hinweis:
Das Feld wurde in einem Pilotprojekt mitübergeben. Kann bei "normalen" Flurstückskarten entfallen.

gemarkungsname
Hier muss der Gemarkungsname des Ortes hinterlegt werden.
Beispiel: Ronsdorf

gemarkungsnummer
Hier muss der Gemarkungsnummer hinterlegt werden.
Beispiel: 3001

flurnummer
Hier muss die Flurnummer hinterlegt werden.
Beispiel: 5

flurstuecksnummer
Hier muss die Flurstücksnummer hinterlegt werden.
Beispiel: 922

flurstueckskennzeichen
Hier muss die Flurstücksnummer hinterlegt werden.
Beispiel: 053267-005-00922

nord-sued-ausdehnung
Hier muss die Nord-Süd-Ausdehnung hinterlegt werden. Die Ausdehnungswerte sind in Metern und dienen der Eingrenzung der zur Verfügung stehenden Kartenformate. D.h. die Maßeinheit muss nur mit den maximalen Ausdehnungswerten der Formatliste übereinstimmen.
Beispiel: 46.3

Hinweis:
Optionales Feld. Wird nur benötigt, wenn im Anschluss über eine Formatsliste Flurstückskarten bestellt werden sollen.

ost-west-ausdehnung
Hier muss die Ost-West-Ausdehnung hinterlegt werden. Die Ausdehnungswerte sind in Metern und dienen der Eingrenzung der zur Verfügung stehenden Kartenformate. D.h. die Maßeinheit muss nur mit den maximalen Ausdehnungswerten der Formartliste übereinstimmen.
Beispiel: 22.8

Hinweis:
Optionales Feld. Wird nur benötigt, wenn im Anschluss über eine Formartliste Flurstückskarten bestellt werden sollen.

geometrie Hier müssen die Geo-Koordinaten hinterlegt werden.

Beispiel für Koordinate

Polyon
In der Liste:
[ [ [51.2,7.1], [51.2,7.2], [51.3,7.2], [51.3,7.1], [51.2,7.1] ] ]
Lesbar:
[
[
[51.2,7.1],
[51.2,7.2],
[51.3,7.2],
[51.3,7.1],
[51.2,7.1]
]
]

Mutipolygon
In der Liste:
[ [ [51.2,7.1], [51.2,7.2], [51.3,7.2], [51.3,7.1], [51.2,7.1] ], [ [49.0,8.4], [49.0,8.5], [49.1,8.5], [49.1,8.4], [49.0,8.4] ] ]
Lesbar:
[
[
[51.2,7.1],
[51.2,7.2],
[51.3,7.2],
[51.3,7.1],
[51.2,7.1]
],
[
[49.0,8.4],
[49.0,8.5],
[49.1,8.5],
[49.1,8.4],
[49.0,8.4]
]
]

Hinweis:
Beim Upload der Liste in der Listenverwaltung muss diese Spalte als Feldtyp "Koordinaten" umgestellt werden.
Polygone und Multipolygne werden nur akteptiert wenn sie im oben genanten Format sind
Ist ein Fehler in einer Zeile der CSV Koordinaten, werden alle Koordinaten der Tabelle nicht importiert.

Flurstückskartenliste in der Listenverwaltung einbinden

Nach der Erstellung der Liste kann diese als eine neue Liste in der Listenverwaltung hinterlegt werden oder es kann die Verlagsliste „placesAllCountries“ ergänzt werden. Nach dem Upload muss die Spalte „geometrie“ zwingend auf den Feldtyp „Koordinaten“ umgestellt werden. Danach nochmal die Liste speichern.

Nutzung der Flurstückskarte in der Geo-Koordinaten-Komponente

Um schlussendlich die erstellte Flurstückskartenliste nutzen zu können, muss diese in einer Geo-Koordinaten-Komponente mit entsprechenden Feldern hinterlegt werden. Hierzu gibt es zwei verschiedene Möglichkeiten.

Flurstücksauswahl über Anschrift

Sofern die Auswahl über eine Anschrift erfolgen soll, muss innerhalb der Geo-Koordinaten-Komponente die Felder Ort, Straße und Hausnummer hinterlegt werden.

Flurstücksauswahl über Flurstück

Sofern die Auswahl über eine Flustücksauswahl erfolgen soll, muss innerhalb der Geo-Koordinaten-Komponente die Felder die Gemarkung, Flurnummer und Flurstück hinterlegt werden.

SB-Terminal

Für die Nutzung des SB-Terminals muss eine speziell definierte Datenliste in der Listenverwaltung hinterlegt werden, die die anzuzeigenden Inhalte bereitstellt. Bei der Erstellung der Liste müssen folgende Felder eingepflegt werden:

name
Der unter name abgelegte Wert wird auf der Oberfläche direkt angezeigt.

description
Der description Wert wird in einem Hilfsdialog angezeigt, der mit Hilfe eines Info-Buttons auf dem Terminal direkt angezeigt wird. Dieser Wert ist optional, wenn dieses Feld leer ist, wird kein Info-Button dargestellt.

category
Sollten mehr Einträge in der Liste vorhanden sein, als gleichzeitig angezeigt werden dürfen, werden die anzuzeigenden Elemente nach diesem Wert gefiltert. Der Benutzer erhält dann als Auswahl den hier hinterlegten Namen.

subCategory
Sollten auch die Einträge der Kategorieeinschränkung zu viel sein, werden diese weiter in Sub-Kategorien gespalten und gefiltert. Der hier angegebene Wert wird dem Benutzer klickbar angezeigt.

link
Hier muss der Veröffentlichungslink des anzusprechenden Assistenten hinterlegt werden.

sortOrder
Hier wird eine Sortierreihenfolge durch Ganzzahlen festgelegt, wobei eine niedrigere Zahl eine höhere Ordnung bedeutet. Die Sortierung wird in Lesereihenfolge vorgenommen. Der Wert ist Optional, wenn kein Wert gesetzt ist, wird alphabetisch sortiert. Wenn nur manche Einträge einen sortOrder-Wert haben, werden diese nach vorn sortiert, und die restlichen werden alphabetisch sortiert.

Hinweis:

Die Felder müssen in der CSV-Liste in der oben genannten Reihenfolge eingepflegt sein.

Weiterhin muss die Liste in der Listenverwaltung als statische Liste sowie unter dem Feld „Namen“ mit dem Wert „terminal“ hinterlegt werden.

Die exakte Benamung der Felder wie oben angegeben ist zwingend zu beachten.

Abfrage Benutzername & Passwort

Mit der Listenfunktion besteht die Möglichkeit eine Abfrage von Benutzernamen und Passwort. So kann beispielsweise sichergestellt werden, dass nur berechtigte Benutzer einen Assistenten ausfüllen und einreichen. Für eine solche Abfrage muss eine entsprechende Liste mit den Werten in der Listenverwaltung hochgeladen werden. Hierbei spielt es keine Rolle, ob es sich um eine lokale, externe oder manuell hinterlegte Liste handelt. Nach dem Hochladen der Liste kann im entsprechenden Assistenten für das oben genannte Beispiel eine Autovervollständigung sowie zwei Eingabefelder in die Autovervollständigung „hierarchisch“ platziert werden. Nach dem Hinzufügen der Komponenten muss in der „Konfiguration“ der Autovervollständigung die hochgeladene Liste hinterlegt und die folgenden Einstellungen vorgenommen werden:

Art des Services
Hierr muss die Auswahl „Vorkonfigurierte Datenliste“ ausgewählt werden.

Liste auswählen
Hier muss die zuvor hochgeladene Liste ausgewählt werden.

Art der Validierung
Hier muss die Art „Nur Validierung“ ausgewählt werden. Somit wird später nach der Eingabe der Werte geprüft, ob diese den Werten in der hinterlegten Liste entsprechen. Ist dies nicht der Fall, wird dem Ausfüller eine Fehlermeldung angezeigt.

Listenfeld
Über die Dropdownkomponente „Listenfeld“ müssen die passenden Spalten, die in der ausgewählten Liste hinterlegt sind, den Eingabefeldern zugeordnet werden.

Einbindung externer Kartenmaterialien in der Geo-Komponente (WMS-Layer)

Über die Standard-Komponente „Geo-Koordinaten“ besteht die Möglichkeit eigenes Kartenmaterial einzubinden und dem Antragsteller zu Verfügung zu stellen.

Beispiel:
https://formulare-extern.de:443/metaform/Form-Solutions/sid/assistant/5bfbdafac2dcee364db2d19f

Für die Konfiguration steht in der Konfiguration der Komponente der Reiter „Speziellen Einstellungen“ zur Verfügung. Nach Betätigen der Schaltfläche „Layer hinzufügen“ können die entsprechenden Eingabefelder befüllt werden.

WMS-Basis URL:
Hier muss ein Link hinterlegt werden, unter welchem eine Schnittstelle (Web Map Service) zum Abrufen von Auszügen von Karten erreichbar ist. Beispiel:
https://mapserver.de/ows?

WMS-Layer:
Hier muss ein/mehrere Layer-Name hinterlegt werden, die angezeigt werden sollen. Ein Layer beschreibt die Anzeigeart des Kartenmaterials. So kann beispielsweise die Anzeige von Luftbildern, Schwarz-Weiß, o.Ä. konfiguriert werden, sofern die verwendete Schnittstelle diese Optionen anbietet. Werden mehr als ein Layer definiert, erhält der Benutzer über ein Optionsfeld die Möglichkeit die Anzeigeart zu wechseln. Beispiel:
karte:grau oder karte:grau,karte:ortsnamen

Anzeigenname:
Für jeden WMS-Layer kann ein beschreibender Name definiert werden. Dieser wird anschließend für die Beschriftung des Optionsfelds verwendet. Beispiel:
karte:grau ist als Layer hinterlegt. Als Anzeigename wird "Schwarz-Weiß Karte" verwendet.

Es können auch mehrere Layers und die entsprechenden Parameter wie URL, Anzeigewert und Anzeigename konfiguriert werden.

Hinweis:
Auch wenn der Antragsteller GPS nicht aktiv hat, wird nach der Eingabe der Adresse die Karte angezeigt.

Datumskomponente "Tage ausschließen"

Mittels der Funktion "Tage ausschließen" in der Datumskomponente können über eine hinterlegte Liste spezielle Tage definiert werden, die nicht dem Bürger zur Eingabe/Auswahl in der Komponente zur Verfügung stehen sollen. Hierzu muss im Vorfeld eine Liste erstellt und in der Listenverwaltung hochgeladen werden, die diese Datumsangaben enthält. Hierzu muss eine Excelliste erstellt werden mit folgenden Werten:

Bezeichnung

Datum

Nach dem Hochladen der Liste kann in der Konfiguration der Datums-Komponente die Liste ausgewählt werden. Hierzu muss zuerst die Auswahl auf "Ja" bei der Auswahl "Tage ausschließen" gesetzt werden. In den darauf folgenden Feldern "Liste auswählen" und "Wertespalte auswählen" muss die Liste und die dazugehörige Wertespalte hinterlegt werden.