Skip to Content
latest

Popup Aktionen

Das im Portalelement konfigurierte Popup kann über das Layer-exri um zusätzliche Aktionsschaltflächen erweitert werden. Dabei wird zwischen zwei Arten von Aktionen unterschieden:

  • Standard-Popup-Aktionen sind in Terratwin fest eingebaut und stehen ohne Konfiguration zur Verfügung. Über das exri werden sie lediglich layerweise deaktiviert oder auf Gruppen eingeschränkt.
  • Benutzerdefinierte Popup-Aktionen werden vollständig über das exri definiert und über params parametrisiert.

Die Aktion Zoomen auf zum Zentrieren auf das Feature ist immer aktiv und kann nicht konfiguriert werden.

Standard-Popup-Aktionen

Folgende Aktionen sind fest in Terratwin implementiert:

idBeschreibung
shareTeilen zum Erzeugen und Weitergeben eines Links auf das Feature. Layer mit noShare bleiben ausgenommen.
printDrucken zur Erstellung eines Berichts in DIN A4 mit aktuellem Kartenausschnitt und Informationen aus dem Popup
tableTabelle zum Öffnen der Attributtabelle. Zusätzlich zur Konfiguration hier muss das Werkzeug Attributtabelle für den Benutzer freigegeben sein; Layer mit noTable bleiben ausgenommen.
export
new@2.4.0
Exportieren zum Export des Features

Globale Konfiguration

Standard-Popup-Aktionen werden anwendungsweit über die Eigenschaft popup.actions der Kartenkonfiguration gesteuert. Dort lassen sich die Aktionen aktivieren, deaktivieren und auf Gruppen einschränken:

{ "popup": { "actions": [ { "id": "print" }, { "id": "table" }, { "id": "share", "enabled": true }, { "id": "export", "authorizedGroups": ["org"] } ] } }

actions ist eine abschließende Liste. Nicht aufgeführte Aktionen stehen in der Anwendung gar nicht zur Verfügung und lassen sich auch über das exri nicht wieder aktivieren. Führen Sie daher alle Aktionen auf, die verfügbar sein sollen. Fehlt popup.actions vollständig, sind alle vier Standard-Aktionen aktiv.

Überschreiben im exri

Die globale Konfiguration kann im Layer-exri layerweise überschrieben werden - in beide Richtungen. Damit lässt sich z.B. der Export für einen einzelnen Layer abschalten, obwohl er anwendungsweit aktiv ist, oder umgekehrt eine global deaktivierte Aktion für einen einzelnen Layer wieder freigeben. Voraussetzung ist, dass die Aktion in der globalen Liste popup.actions überhaupt aufgeführt ist. enabled und authorizedGroups werden dabei getrennt ausgewertet: Nur die im exri gesetzte Eigenschaft überschreibt die globale Vorgabe, die jeweils andere bleibt bestehen.

ParameterBeschreibung
sublayerId des Unterlayers. Default: 0
id requiredZulässige Werte sind share, print, table und export
enabled
new@2.4.0
Aktiviert bzw. deaktiviert die Aktion für diesen Layer
authorizedGroups
new@2.4.0
Beschränkt die Aktion auf bestimmte Gruppen bzw. mit dem Schlüsselwort org auf angemeldete Benutzer
{ "popupActions": [ { "sublayer": 0, "id": "export", "enabled": false }, { "sublayer": 0, "id": "print", "authorizedGroups": ["org"] } ] }

Bei Standard-Popup-Aktionen sind title, icon und params wirkungslos. Beschriftung, Symbol und Verhalten sind fest vorgegeben.

Benutzerdefinierte Popup-Aktionen

Layerspezifische Aktionen lassen sich ausschließlich über exri realisieren. Es können mehrere Aktionen pro Layer definiert werden. Eine Aktion muss wie folgt aufgebaut werden:

ParameterBeschreibung
sublayerId des Unterlayers. Default: 0
id requiredName der auszuführenden Funktion. Derzeit ist toggleRaster verfügbar
titleangezeigter Text auf der Aktionsschaltfläche
iconName des Calcite Icons 
enabled
new@2.4.0
Aktiviert bzw. deaktiviert die Aktion für diesen Layer
authorizedGroups
new@2.4.0
Beschränkt die Aktion auf bestimmte Gruppen bzw. mit dem Schlüsselwort org auf angemeldete Benutzer
paramsParameter, die der auszuführenden Funktion übergeben werden sollen

Aktion toggleRaster

Mit toggleRaster können zugehörige Bilddaten eines Objekts zur Anzeige gebracht werden. Diese Funktion ist nützlich, wenn gescannte Pläne oder einzelne Orthofotos zu Features angezeigt werden sollen (z.B. bei Bebauungsplänen oder UAV-Befliegungen).

ArcGIS ImageService

In den params können Sie einen ArcGIS-Imageservice referenzieren und die Verbindungsfelder definieren. Der ArcGIS-Imageservice muss aus einem Mosaik-Dataset heraus veröffentlicht werden.

ParameterBeschreibung
rasterLayerReferenz auf einen Imageservice. Siehe Referenzieren von Portalelementen
primaryKeyFeldname im Layer, auf den sich das exri bezieht
foreignKeyFeldname im Mosaik-Dataset, der zum Filtern genutzt wird
{ "popupActions": [ { "sublayer": 0, "id": "toggleRaster", "title": "Rasterplan anzeigen", "icon": "image-segmentation", "params": { "rasterLayer": { "portalUrl": "https://arcgis.com", "queryParams": { "filter": "id:2fb1bab4122f44f4bb443c17f5732f30" } }, "primaryKey": "nummer", "foreignKey": "nummer_in_fc" } } ] }

WMS-Dienste

Seit der Version 2.2.1 ist es ebenfalls möglich WMS-Dienste für die Bilddaten zu verwenden. Geben Sie dazu in den params den Typ wms an und definieren Sie die übrigen Parameter wie folgt:

ParameterBeschreibung
rasterLayer.typeErlaubter Wert ist wms
rasterLayer.urlFieldFeldname im Layer, der die WMS-URL enthält. Entfällt, wenn rasterLayer.staticUrl gesetzt ist.
rasterLayer.staticUrl
new@2.4.0
Feste WMS-URL für alle Features des Layers. Wird bevorzugt ausgewertet; ist sie gesetzt, wird urlField nicht mehr benötigt.
rasterLayer.layerNameFieldFeldname im Layer, der den WMS-Layernamen enthält. Wenn dieser Parameter angegeben wird, hat er Vorrang vor rasterLayer.defaultLayerName.
rasterLayer.defaultLayerNameStandard-Name des WMS-Layers, der am Endpunkt abgerufen werden soll (wenn rasterLayer.layerNameField nicht angegeben wird). Bei Fehlen beider Parameter wird der Layername rasterplan angewandt.
rasterLayer.filterFieldFeldname im Layer, der zum Filtern genutzt wird. Der Filter wird als <Feld>='<Wert>' an den Dienst übergeben.
rasterLayer.filterTypeName des Filterparameters, unter dem der Filter übergeben wird. Standardmäßig CQL_FILTER (GeoServer). Für andere Dienste z. B. FILTER.
rasterLayer.titleTemplateTitel des WMS-Layers, der im Werkzeug Themen angezeigt wird. Feldnamen in geschweiften Klammern werden durch den Attributwert des Features ersetzt, z. B. "Bebauungsplan {Name}". Wird dieser Parameter nicht angegeben, wird der Standardtitel Rasterplan: {primaryKey} verwendet.
rasterLayer.customParametersSchlüsselwertpaare für benutzerdefinierte Parameter, die an die URL des WMS-Dienstes angehängt werden. Siehe CustomParameters 
primaryKeyFeldname im Layer, auf den sich das exri bezieht
{ "popupActions": [ { "sublayer": 0, "id": "toggleRaster", "title": "Rasterplan anzeigen", "icon": "image-segmentation", "params": { "rasterLayer": { "type": "wms", "urlField": "wms_url", "defaultLayerName": "bp_planRaster", "filterField": "Nummer", "titleTemplate": "Bebauungsplan {Name}" }, "primaryKey": "Nummer" } } ] }
Beispielkonfiguration und Screenshot für eine Popup-Aktion
Beispielkonfiguration und Screenshot für eine Popup-Aktion