Modulauswahl - Konfiguration

In diesem Abschnitt wird die Modulauswahl konfiguriert. In der fertigen App ist diese über icon moduleselector im Bereich Allgemeine Funktionen der Karte zu erreichen.

Das Modul, welches das Modulauswahl-Plugin enthält, wird bei der Konfiguration der Modulauswahl als Basismodul bezeichnet.

Mit Klick auf icon edit öffnet sich das Plugin Editor Fenster, welches die verfügbaren Konfigurationsmöglichkeiten aufzeigt.

Figure 1. Menü zum Konfigurieren der Modulauswahl

Folgende Einstellungen sind möglich:

Einstellungen

Allgemeine Einstellungen

Option	Beschreibung
Fenster Titel	Titel, der in der Kopfzeile des Fensters angezeigt wird. Standardwert ist ein Übersetzungsschlüssel (siehe Internationalisierung), der von der Anwendung in "Themenkartenauswahl" (de) bzw. "Theme map selection" (en) übersetzt wird.
Themenkartenauswahl beim Start der Karte zeigen	Gibt an, ob das Fenster der Themenkartenauswahl beim Start der Anwendung bereits geöffnet ist.
Modulauswahl erforderlich machen	Gibt an, ob der Button "Anwendung starten" im Fenster der Themenkartenauswahl aktiv ist, wenn (abgesehen vom Basismodul) noch kein Modul ausgewählt wurde. Wird die Checkbox aktiviert, wird eine Modulauswahl erforderlich, bevor die Anwendung gestartet werden kann.

Option

Beschreibung

Fenster Titel

Titel, der in der Kopfzeile des Fensters angezeigt wird. Standardwert ist ein Übersetzungsschlüssel (siehe Internationalisierung), der von der Anwendung in "Themenkartenauswahl" (de) bzw. "Theme map selection" (en) übersetzt wird.

Themenkartenauswahl beim Start der Karte zeigen

Gibt an, ob das Fenster der Themenkartenauswahl beim Start der Anwendung bereits geöffnet ist.

Modulauswahl erforderlich machen

Gibt an, ob der Button "Anwendung starten" im Fenster der Themenkartenauswahl aktiv ist, wenn (abgesehen vom Basismodul) noch kein Modul ausgewählt wurde. Wird die Checkbox aktiviert, wird eine Modulauswahl erforderlich, bevor die Anwendung gestartet werden kann.

Basismodul

Option Beschreibung

Option	Beschreibung
Basismodul anzeigen	Gibt an, ob das Basismodul, in das das Plugin eingebunden ist, als Modulkarte in der Themenkartenauswahl erscheint. Da das Basismodul die Themenkartenauswahl beinhaltet, ist dieses Modul permanent aktiv und kann nicht deaktiviert werden.
Titel	Titel, welcher auf der Karte des Basismoduls angezeigt wird.
Icon	Icon, welches auf der Karte des Basismoduls dargestellt wird. Es sind ausschließlich Material Design Icons möglich, welche anhand der Syntax `mdi-<icon-name>` angegeben werden.

Basismodul anzeigen

Gibt an, ob das Basismodul, in das das Plugin eingebunden ist, als Modulkarte in der Themenkartenauswahl erscheint. Da das Basismodul die Themenkartenauswahl beinhaltet, ist dieses Modul permanent aktiv und kann nicht deaktiviert werden.

Titel

Titel, welcher auf der Karte des Basismoduls angezeigt wird.

Icon

Icon, welches auf der Karte des Basismoduls dargestellt wird. Es sind ausschließlich Material Design Icons möglich, welche anhand der Syntax mdi-<icon-name> angegeben werden.

Themen- & Modulzuordnung

Das Fenster der Modulauswahl wird später aus dieser Liste generiert und wird von den hier dargestellten Modulen/Gruppen und ihrer Anzeigetitel und Icons bestimmt.

Die Reihenfolge der Elemente hat Einfluss auf die spätere Darstellungsreihenfolge und kann per Drag & Drop angepasst werden.

Aktion	..UI
Modul hinzufügen (via Publisher) Öffnet die Auswahl an vorhandenen Modulen des Publisherprojekt und fügt ein Modul zur Liste Themen- & Modulzuordnung hinzu. In einem anschließenden Schritt können Modul Name (Anzeigetitel) und Icon Name (siehe Icon unter Basismodul) gesetzt werden.
Modul hinzufügen (via URL) Siehe Modul hinzufügen (via Publisher). Ermöglicht statt einer Modulauswahl über die Nutzeroberfläche die Angabe einer Modul-URL, so dass auch Module eingebunden werden können, die sich außerhalb des Publisher-Projektes befinden. Modul Gruppe hinzufügen Fügt einen Gruppenknoten hinzu, welchem mehrere Module untergeordnet werden können. Dies erzeugt eine zweite Ebene in der Modulauswahl. Weitere Informationen unter Gruppeneinstellungen
Modul bearbeiten Ändern des Namens (Anzeigetitel), des Icons oder der URL des Moduls.
Modul-Gruppe bearbeiten Ändern des Namens (Anzeigetitel), des Icons oder der zugeordneten Module der Modulgruppe.
Modul/Gruppe löschen Entfernt das Modul/die Gruppe aus der Konfiguration der Modulauswahl.

Aktion

..UI

Modul hinzufügen (via Publisher)
Öffnet die Auswahl an vorhandenen Modulen des Publisherprojekt und fügt ein Modul zur Liste Themen- & Modulzuordnung hinzu. In einem anschließenden Schritt können Modul Name (Anzeigetitel) und Icon Name (siehe Icon unter Basismodul) gesetzt werden.

icon uploadElement

Modul hinzufügen (via URL)
Siehe Modul hinzufügen (via Publisher). Ermöglicht statt einer Modulauswahl über die Nutzeroberfläche die Angabe einer Modul-URL, so dass auch Module eingebunden werden können, die sich außerhalb des Publisher-Projektes befinden.

Modul Gruppe hinzufügen
Fügt einen Gruppenknoten hinzu, welchem mehrere Module untergeordnet werden können. Dies erzeugt eine zweite Ebene in der Modulauswahl. Weitere Informationen unter Gruppeneinstellungen

icon overflowMenu

Modul bearbeiten
Ändern des Namens (Anzeigetitel), des Icons oder der URL des Moduls.

icon edit

Modul-Gruppe bearbeiten
Ändern des Namens (Anzeigetitel), des Icons oder der zugeordneten Module der Modulgruppe.

icon playlistEdit

Modul/Gruppe löschen
Entfernt das Modul/die Gruppe aus der Konfiguration der Modulauswahl.

icon removeElement

Fensterposition

Option	Beschreibung
Oben	Gibt die Positionierung (Abstand) des oberen Fensterrandes relativ zur Kartenansicht in Pixel (px) oder Prozent (%) an. Standardwert ist 10%.
Rechts	Gibt die Positionierung (Abstand) des rechten Fensterrandes relativ zur Kartenansicht in Pixel (px) oder Prozent (%) an. Standardwert ist 33%.
Unten	Gibt die Positionierung (Abstand) des unteren Fensterrandes relativ zur Kartenansicht in Pixel (px) oder Prozent (%) an.
Links	Gibt die Positionierung (Abstand) des linken Fensterrandes relativ zur Kartenansicht in Pixel (px) oder Prozent (%) an. Standardwert ist 33%.
Breite	Feste Breite des Fensters in Pixel (px) oder Prozent (%). Unabhängig vom Inhalt wird dieser Wert strikt eingehalten. Aufgrund der Dimensionen der Modulkarten ist ein Wert größer 200 px zu empfehlen.
Max. Breite	Maximale Höhe des Fensters in Pixel (px) oder Prozent (%). Die Fensterhöhe wird an den Inhalt angepasst, beträgt aber maximal den angegebenen Wert.
Höhe	Feste Höhe des Fensters in Pixel (px) oder Prozent (%). Unabhängig vom Inhalt wird dieser Wert strikt eingehalten. Aufgrund der Dimensionen der Modulkarten ist ein Wert größer 200 px zu empfehlen.
Max. Höhe	Maximale Breite des Fensters in Pixel (px) oder Prozent (%). Die Fensterbreite wird an den Inhalt angepasst, beträgt aber maximal den angegebenen Wert.

Option

Beschreibung

Oben

Gibt die Positionierung (Abstand) des oberen Fensterrandes relativ zur Kartenansicht in Pixel (px) oder Prozent (%) an. Standardwert ist 10%.

Rechts

Gibt die Positionierung (Abstand) des rechten Fensterrandes relativ zur Kartenansicht in Pixel (px) oder Prozent (%) an. Standardwert ist 33%.

Unten

Gibt die Positionierung (Abstand) des unteren Fensterrandes relativ zur Kartenansicht in Pixel (px) oder Prozent (%) an.

Links

Gibt die Positionierung (Abstand) des linken Fensterrandes relativ zur Kartenansicht in Pixel (px) oder Prozent (%) an. Standardwert ist 33%.

Breite

Feste Breite des Fensters in Pixel (px) oder Prozent (%). Unabhängig vom Inhalt wird dieser Wert strikt eingehalten. Aufgrund der Dimensionen der Modulkarten ist ein Wert größer 200 px zu empfehlen.

Max. Breite

Maximale Höhe des Fensters in Pixel (px) oder Prozent (%). Die Fensterhöhe wird an den Inhalt angepasst, beträgt aber maximal den angegebenen Wert.

Höhe

Feste Höhe des Fensters in Pixel (px) oder Prozent (%). Unabhängig vom Inhalt wird dieser Wert strikt eingehalten. Aufgrund der Dimensionen der Modulkarten ist ein Wert größer 200 px zu empfehlen.

Max. Höhe

Maximale Breite des Fensters in Pixel (px) oder Prozent (%). Die Fensterbreite wird an den Inhalt angepasst, beträgt aber maximal den angegebenen Wert.

Gruppeneinstellungen

Wird die Option Modul-Gruppe bearbeiten ausgewählt, öffnet sich im gleichen Fenster eine zweite Ansicht zur Bearbeiten von Gruppeneinstellungen. Über die Verzeichnisstrukur am oberen Rand des Fensters gelangt man zurück zur Hauptansicht der Konfiguration.

Figure 2. Menü zum Konfigurieren von Gruppen innterhalb der Modulauswahl

Allgemeine Einstellungen

Option Beschreibung

Option	Beschreibung
Gruppen Name	Titel, der auf der Karte der Gruppe in der Modulauswahl angezeigt wird.
Icon Name	Icon, welches auf der Karte der Gruppe dargestellt wird. Es sind ausschließlich Material Design Icons möglich, welche anhand der Syntax `mdi-<icon-name>` angegeben werden.

Gruppen Name

Titel, der auf der Karte der Gruppe in der Modulauswahl angezeigt wird.

Icon Name

Icon, welches auf der Karte der Gruppe dargestellt wird. Es sind ausschließlich Material Design Icons möglich, welche anhand der Syntax mdi-<icon-name> angegeben werden.

Themen- & Modulzuordnung

Das Fenster der Gruppenebene der Modulauswahl wird später aus dieser Liste generiert und wird von den hier dargestellten Modulen und ihrer Anzeigetitel und Icons bestimmt.

Die Reihenfolge der Elemente hat Einfluss auf die spätere Darstellungsreihenfolge und kann per Drag & Drop angepasst werden.

Aktion	..UI
Modul hinzufügen (via Publisher) Öffnet die Auswahl an vorhandenen Modulen des Publisherprojekten und fügt ein Modul zur Liste Themen- & Modulzuordnung hinzu. In einem anschließenden Schritt können Modul Name (Anzeigetitel) und Icon Name (siehe Icon unter Basismodul) gesetzt werden.
Modul hinzufügen (via URL) Siehe Modul hinzufügen (via Publisher). Ermöglicht statt einer Modulauswahl über die Nutzeroberfläche die Angabe einer Modul-URL, so dass auch Module eingebunden werden können, die sich außerhalb des Publisher-Projektes befinden.	n/a
Modul bearbeiten Ändern des Namens (Anzeigetitel), des Icons oder der URL des Moduls.
Modul löschen Entfernt das Modul aus der Konfiguration der Modulauswahl.

Aktion

..UI

Modul hinzufügen (via Publisher)
Öffnet die Auswahl an vorhandenen Modulen des Publisherprojekten und fügt ein Modul zur Liste Themen- & Modulzuordnung hinzu. In einem anschließenden Schritt können Modul Name (Anzeigetitel) und Icon Name (siehe Icon unter Basismodul) gesetzt werden.

icon addElement

n/a

Modul bearbeiten
Ändern des Namens (Anzeigetitel), des Icons oder der URL des Moduls.

icon edit

Modul löschen
Entfernt das Modul aus der Konfiguration der Modulauswahl.

icon removeElement

Anwendungsbeispiele

Grundlegende Informationen zum Modulkonzept sind im Bereich App Konfigurator zu finden.

Digitialer Basiszwilling als Ausgangsbasis

Konzeptionell kann für die Modulauswahl als Basismodul z.B. ein Modul mit Daten des digitalen Basiszwillings genutzt werden (d.h. als Mindestumfang: ein digitales Geländemodell, eine Basiskarte, das digitale 3D Stadtmodell).

Ergänzend dazu können verschiedene Anwendungsthemen (z.B. Hochwasserrisiko, Solarpotential, Stadtplanung u.v.m.) jeweils in eigene Modulen verpackt werden, welche dann alle erforderlichen Daten, Konfigurationen und Plugins für das entsprechende Thema bereitstellen und den Basiszwilling anwendungsspezifisch erweitern.

Dies können z.B. sein:

weitere Kartenebenen, die den Inhaltsbaum erweitern.
Verfügbarkeit/Anwendung von Stildefinitionen auf das Stadtmodell, um ein Thema auf Basis vorhandener Attributdaten zu visualisieren/hervorzuheben.
zusätzliche Plugins, um thematisch relevante Analysen und Aktionen zu ermöglichen.

In das Modul mit den Daten des digitalen Basiszwillings wird das Plugin der Modulauswahl integriert. Damit wird dieses zum Basismodul der Kartenanwendung.

Geht man davon aus, dass es für Endnutzern auch möglich sein soll ausschließlich mit dem Basiszwilling zu arbeiten, ist in den Einstellungen die Optionen "Basismodul anzeigen" zu aktivieren, damit der Basiszwilling eine eigene Karte in der Modulauswahl erhält. Zeitgleich sollte die Option "Modulauswahl erforderlich machen" deaktiviert sein, damit Nutzer auch ohne die Auwahl eines zusätzlichen Moduls zum Basismodul die Anwendung starten können.

Einstiegspunkt zu unterschiedlichen Stadtmodellen

Alternativ kann konzeptionell z.B. ein Modul, das nur eine 2D Basiskarte für den Überblick enthält, als Basismodul für die Modulauswahl konfiguriert sein und so Einstiegspunkt zu mehreren unabhängigen Stadtmodellen einer Region sein.

Die einzelnen Stadtmodelle können dementsprechend jeweils in eigene Modulen verpackt werden, welche dann alle erforderlichen Daten, Konfigurationen und Plugins für die jeweilige Stadt bzw. Gemeinde bereitstellen. Nach Selektion des jeweiligen Moduls über das Modulsauswahl-Fenster wird dadruch die reine (2D) Basiskarte um die 3D Ansicht, 3D Kartenebenen und weitere ergänzende Inhalte und relevante Plugins für eine Stadt/Gemeinde erweitert.

Geht man davon aus, dass das Basismodul nur dem Überblick und Einstieg dienen soll, sollen Endnutzern voraussichtlich geleitet werden, zunächst eine Stadt/Gemeinde anzuwählen, mit deren Kartenanwendung sie weiterarbeiten möchten. Das Basismodul selbst bietet daher keinen weiteren Mehrwert, in den Einstellungen wird entsprechend die Optionen "Basismodul anzeigen" deaktiviert, damit das Basismodul nicht als Auswahlmöglichkeit in der Modulauswahl erscheint. Zeitgleich sollte die Option "Modulauswahl erforderlich machen" aktiviert sein, damit zunächst die Auwahl eines stadt- bzw. gemeindespezifischen Moduls erforderlich ist, um die Anwendung starten zu können.