Webmap Client

Die Projektion und weitere Einstellungen können über die Admin-GUI unter Akkordeon Einstellungen auf Ihre Bedürfnisse angepasst werden.

Kann man die Themen-Bilder unter "Thema wechseln" anpassen?¶

Ja, die Bilder sind als CSS definiert und liegen als PNG Dateien in den Maßen 140 x 60 vor.

Fügen Sie in der Admin-GUI hierzu unter Akkordeon Style ein CSS-Eintrag mit folgender Syntax:

[ga-topic] .ga-topics-sprite-<KATEGORIE-ID> {
    background: url("<URL-KATEGORIE-IMAGE>");
    width: 140px;
}

Kann man die Reihenfolge der Hintergrundkarten-Auswahl anpassen?¶

Ja, die Reihenfolge der Hintergrundkarte kann man auch per CSS beeinflussen.

Fügen Sie in der Admin-GUI hierzu unter Akkordeon Style CSS-Eintäge mit folgender Syntax:

...
@media (max-width: 768px) {
    ...
    [ga-background-selector].ga-open .ga-<KARTEN-ID> {
        -webkit-transform: translate3d(0, <KARTEN-POSITION>, 0);
        transform: translate3d(0, <KARTEN-POSITION>, 0);
        -ms-transform: translateY(<KARTEN-POSITION>);
    }
}
...
@media (min-width: 769px) {
    ...
    [ga-background-selector].ga-open .ga-<KARTEN-ID> {
        -webkit-transform: translate3d(<KARTEN-POSITION>, 0, 0);
        transform: translate3d(<KARTEN-POSITION>, 0, 0);
        -ms-transform: translateX(<KARTEN-POSITION>);
    }
}
...

Kann man die Bilder für die Hintergrundkarten-Auswahl anpassen?¶

Ja, die Bilder für die Hintergrundkarten werden per CSS definiert.

Die Bilder sollten folgende Formate haben: - Mobile in 38px x 38px - Desktop in 90px x 58px

Fügen Sie in der Admin-GUI hierzu unter Akkordeon Style CSS-Eintäge mit folgender Syntax:

...
@media (max-width: 768px) {
    ...
    [ga-background-selector] .ga-<KARTEN-ID> {
        background-image: url("<URL-KARTEN-IMAGE>");
        background-size: 38px 38px;
    }
    ...
}
...
@media (min-width: 769px) {
    ...
    [ga-background-selector] .ga-<KARTEN-ID> {
        background-image: url("<URL-KARTEN-IMAGE>");
        background-size: 90px 58px;
    }
    ...
}
...

Für diesen Zweck gibt es keine Funktion in der Admin-GUI und es müssen auch Operationen auf dem Server ausgeführt werden.

Sie können unter WebmapClientData/img/category/ entweder per Git, wenn eingerichtet, oder per Hochladen direkt auf den Server ein PNG hinterlegen. Dieses PNG sollten Sie dann per https://<IHRE-DOMAIN>/ingrid-webmap-client/rest/admin/image/category/<DATEINAME-OHNE-DATEIENDUNG> aufrufen können.

Per Admin-GUI können Sie dann unter Akkordeon Style einen neuen CSS-Eintrag hinzufügen, z.B.:

[ga-background-selector] .ga-bg-layer, [ga-background-selector] .ga-bg-layer-bt, [ga-background-selector] .ga-bg-layer-bt-close {
    background: #fff url(https://<IHRE-DOMAIN>/ingrid-webmap-client/rest/admin/image/category/<DATEINAME-OHNE-DATEIENDUNG>) no-repeat 0 center;
}

Der per Default eingestellte URL-Shortner (https://is.gd/create.php?format=json) verkürzt nur URL's mit einer Domain und keine mit einer IP-Adresse. Hier liefert der URL-Shortener einen Fehler und vom Webmap Client wird die ungekürzte URL zurückgeliefert.

Passwortgeschützte Karten/Dienste¶

Über die Admin-GUI können auch Karten von passwortgeschützten Diensten eingepflegt werden.

Laden Sie hierbei über den Reiter "Karten" und den Button "Dienst laden" die Dienst-URL indem Sie zusätzlich über die Checkbox "Login verwenden" den Benutzername und das Passwort angeben.

Wurde der Dienst erfolgreich geladen, so wird Ihnen der passwortgeschützte Dienst wie gewohnt in einer Baumstruktur dargestellt. Sobald Sie nun eine odere mehrere Karten/Layern zu Ihrem MapClient hinzufügen, wird das Login (Benutzername, Passwort) zu dem Hostname Ihres Dienstes zugeordnet und intern in einer JSON-Datei gespeichert.

Warum das Login gespeichert werden muss? Für die Kartendarstellung werden die Kacheln/Tiles (GetMap-Anfrage) Ihrer passwortgeschützten Karten nun nicht mehr direkt aufgerufen, sondern über den Server, wo der Webmap Client installiert ist, mit Authentifizierung (anhand der internen JSON-Datei) geladen.

Neben der GetMap-Anfrage wird die interne JSON-Datei auch für den Druck, GetCapabilities- und GetFeatureInfo-Abfrage verwendet.

Passwortgeschützte Dienste/Karten können nur über die Pflege per Admin-GUI verwendet werden. Ein Laden/Importieren direkt über den Webmap Client ist nicht möglich.

Fehlerhafte Karten¶

Je nach Einstellung läuft (per Default: täglich um 3:00 Uhr) ein Job, welches diverse Einstellungen (Extent, Legend-URL, Scales, etc.) zur Ihren eingepflegten Karten (nicht bei kombinierten Karten) automatisch aktualisiert.

Hierbei wird auch geprüft, ob der Dienst noch erreichbar und die Karte in der GetCapabilities des Dienstes noch vorhanden ist. Ist der Dienst nicht mehr erreichbar, z.B. durch https-Umstellung, wird der eingepflegten Karten ein Status "Dienst existiert nicht mehr" und bei nicht vorhandsein der Karte in der GetCapabilities der Status "Karte existiert nicht mehr" hinzugefügt.

In der Liste der eingepflegten Karten unter dem Akkordeon "Karten" der Admin-GUI kann über die Checkbox "Nur fehlerhafte Karten" nach allen fehlerhaften Karten gefiltert werden.

Um den Fehler bei den fehlerhaften Karten zu beheben, muss manuell in der Admin-GUI, je nach dem was der Status ist, entweder die Dienst-URL oder der Layer-Name geändert werden.

Ist bei einer fehlerhaften Karte der Dienst noch erreichbar, aber die Karte (Layer-Name) existiert nicht mehr, so werden unterhalb des existierenden Layer-Name einer Karte eine Liste (in rot markiert) zur Verfügung gestellt, welches alle Layer-Namen eines Dienstes auflistet. Meistens ändert sich nur der Layer-Name für eine Karte und somit kann einfach der Layer-Name aktualisiert werden. Wählen Sie den passend Layer-Name aus der Liste aus und bestätigen Sie Ihre Änderung mit dem "Speichern"-Button.

Zudem werden bei dem Job die eingepflegte Karten, die keine Zuordnung zu einer Kategorie haben, entfernt.

Möchten Sie eine E-Mail-Benachrichtigung, falls eingepflegte Karten nicht mehr erreichbar sind und einen Fehler aufweisen, so setzen Sie die Einstellung scheduler.layer.update.mail auf true. Gehen Sie hier wie unter Konfiguration beschrieben vor. Bei Änderung muss das Portal neugestartet werden. Ein SMTP-Server (Einstellung "feedback.host") muss eingestellt sein und die E-Mail geht an die Adresse unter Einstellung "feedback.to".

Der MapClient ist für Dimension-Time-Karten mit einer jährlichen Zeitperiode abgestimmt, d.h Karten mit einer Zeitperiode von z.b. 2010, 2011, 2013, etc..

Theoretisch können auch andere Zeitperioden eingepflegt werden, aber die Funktionen im Mapclient werden nicht korrekt dargestellt oder funktionieren nicht richtig, z.B. bei einer monatlichen Zeitperiode eines Jahres:

• Zeitregler: Der Regler bleibt immer auf dem Jahr und lässt sich nicht verschieben. Ein Abspielen der Zeitperioden ist nicht möglich.
• Zeitabhängige Darstellung der Karte: Bei Klick auf die Jahreszahl würden alle Zeitperioden nur mit dem Jahr angezeigt werden. Hier kann man zwar die einzelnen Zeitstempeln auswählen und die Karte ändert sich auch, aber man weiß nicht wirklich, welcher Zeitstempel z.Zt. aktiv ist.

Im Mapclient wird der "layers"-Parameter in der URL komprimiert dargestellt. Hierbei werden die hinzugefügten Layern in der Karte nicht mehr per Komma getrennt in der URL aufgelistet, sondern die Liste der Layern werden in eine Datei geschrieben und im "layers"-Parameter wird der Dateiname referenziert.

Dadurch wird vermieden, dass die URL des Mapclients zu lange wird und im Browser Probleme verursacht.

Der Mapclient läuft in einem Tomcat und über die Login-Konfiguration vom Tomcat kann man die Login-Daten für die Admin-GUI des Mapclients festlegen. Die Datei für die Login-Konfiguration findet Sie unter

/PORTAL-INSTALLATIONS-PFAD/apache-tomcat/conf/tomcat-users.xml

Dort können Sie Benutzer und Passwort ändern bzw. hinzufügen. Der Benutzer muss nur die Rolle "admin-gui" haben.

...
<user username="BENUTZER" password="PASSWORT_IN_SHA-256" roles="admin-gui"/>
...

Das Passwort muss mit SHA-256 verschlüsselt eingetragen werden. Hierbei können Sie folgenden Befehl aus dem Tomcat verwenden, um sich ein Passwort verschlüsselt zu generieren:

/PORTAL-INSTALLATIONS-PFAD/apache-tomcat/bin/digest.sh -a sha-256 -s 0 PASSWORT

Die Sessiondauer eines Benutzers wird in der Datei "opt/ingrid/ingrid-portal/apache-tomcat/webapps/ingrid-webmap-client/WEB-INF/web.xml" festgelegt:

<session-config>
    <session-timeout>10</session-timeout>
</session-config>

Per Default beträgt die Sessiondauer 10 min.