Erweiterte Ressourceninformationen (exri)

Erweiterte Ressourceninformationen, Extended Ressource Informations (kurz: exri), sind eine in Terratwin exklusive eingebaut Funktionalität, um Portalinhalte (Layer, WebMaps, ...) aus dem primären Portal um weitere Funktionen und Eigenschaften zu erweitertern. Exri sind nach dem JSON-Standard aufgebaut und haben den gleichen Dateinamen, wie das Element, das erweitert wird.

Exris stehen seit der Version 1.4.2 zur Verfügung

Layer exri

Portalelemente vom Typ Layer (z.B. FeatureLayer) können um verschiedene Funktionen erweitert werden. Diese Funktionen werden aktiv, sobald der entsprechende Layer zur Karte hinzugefügt wird oder eine Karte geöffnet wird, die den Layer enthält.

Allgemeine Layer-Eigenschaften

Ein Layer-exri kann um allgemeine Eigenschaften layerProps erweitert werden, die unabhängig von der Art des Layers sind. Verwenden Sie dazu die einfachen Eigenschaften aus der SDK zu FeatureLayer (opens in a new tab), MapImageLayer (opens in a new tab), ImageryLayer (opens in a new tab) oder anderen Layern, je nach Typ des Layers. Unter Angabe von sublayer können die Eigenschaften auf einen bestimmten Unterlayer angewendet werden. Folgende Eigenschaften bieten sich beispielsweise für einen Featurelayer an:

In der Version 2.0.1 wurde außerdem das Schlüsselwort nosnap in den allgemeinen Eigenschaften eingeführt, um zu verhindern, dass der Layer beim Zeichnen von Geometrien als Fanglayer verwendet werden kann.

{
	"layerProps": [
		{
			"sublayer": 1,
			"opacity": 0.7,
			"listMode": "hide-children",
			"popupEnabled": false,
			"nosnap": true
		}
	]
}

Viele der layerProps können bereits im Dienst bzw. im Portalelement festgelegt werden und werden automatisch übernommen. Die Konfiguration im Layer-exri überschreibt die Einstellungen im Dienst.

Dynamische Suchfunktion

Der Layer kann als Quelle für das Suchen-Werkzeug dienen. Es können mehrere Suchquellen für denselben Layer oder für unterschiedliche Sublayer konfiguriert werden. Suchquellen müssen entsprechend der API für LayerSearchSource (opens in a new tab) aufgebaut werden und können noch um den Parameter sublayer ergänzt werden, um auf einen Unterlayer eines MapServers oder FeatureServers zu verweisen.

{
	"searchSources": [
		{
			"searchFields": ["bezeichnung"],
			"suggestionTemplate": "{bezeichnung} ({code})",
			"exactMatch": false,
			"outFields": ["bezeichnung", "code"],
			"name": "Radrouten",
			"placeholder": "Radroute suchen z.B. Buckelestour",
			"minSuggestCharacters": 3,
			"popupEnabled": true
		}
	]
}

• wird kein sublayer angegeben, wird standardmäßig der erste Unterlayer (Index=0) verwendet
• alle Felder die in searchFields und in suggestionTemplate aufgeführt sind, müssen auch in outFields gelistet werden
• wenn popupEnabled aktiviert ist, öffnet sich das für den Layer konfigurierte Popup, andernfalls wird eine Markierung gesetzt
• mit prefix: "%" können Sie eine Suche konfigurieren, die auch nach Teilinhalten im Suchfeld sucht (Enthält-Suche)

Popup Aktionen

Das im Portalelement konfigurierte Popup kann über das Layer-exri um zusätzliche Aktionsschaltflächen erweitert werden. Standardmäßig stehen in Terratwin folgende Aktionen zur Verfügung:

• Zoomen auf zum Zentrieren auf das Feature
• Teilen zum Erzeugen und Weitergeben eines Links auf das Feature
• Drucken zur Erstellung eines Berichts in DIN A4 mit aktuellen Kartenausschnitt und Information aus dem Popup
• Tabelle zum Öffnen der Attributtabelle

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

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).

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.

{
	"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"
			}
		}
	]
}

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:

{
	"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"
			}
		}
	]
}

Popup Inhalte

Mithilfe eines Layer-exri können auch weitere benutzerdefinierte Inhalte zum Popup hinzugefügt werden, die sich nicht über die eingebaute Möglichkeiten zur Konfiguration von Popups (opens in a new tab) realisieren lassen. Auch hier können mehrere Inhalte dynamisch für denselben Layer oder für unterschiedliche sublayer definiert werden.

Inhalt getXPlanungAttachments

Die benutzerdefinierte Funktion getXPlanungAttachments ruft über den Terratwin API Service xplanung_docs sämtliche externe Referenzen (opens in a new tab), die in einem XPlanung-GML hinterlegt sind. Geben Sie über params folgende Parameter an:

{
	"popupContents": [
		{
			"sublayer": 1,
			"outFields": ["bp_plan_nummer", "bp_plan_gemeinde", "bp_plan_name"],
			"creator": "getXPlanungAttachments",
			"params": {
				"gmlUrl": "https://gis.stadt-xy.de/dok/Bebauungsplaene/{bp_plan_gemeinde}/{bp_plan_name}.gml",
				"namespaces": {
					"": "http://www.xplanung.de/xplangml/5/0"
				},
				"additionalFiles": [
					{
						"url": "https://gis.stadt-xy.de/dok/Bebauungsplaene/{bp_plan_gemeinde}/{bp_plan_nummer}_TZ.pdf",
						"title": "Zusätzliche Dokumente"
					}
				]
			}
		}
	]
}

Inhalt getOwners

Mit der benutzerdefinierten Funktion getOwners werden die Eigentümerinformationen eines Flurstücks abgefragt. Geben Sie über params folgende Parameter an:

{
	"popupContents": [
		{
			"sublayer": 0,
			"outFields": ["fsk"],
			"creator": "getOwners",
			"params": {
				"portalItems": {
					"portalUrl": "https://arcgis.com",
					"queryParams": {
						"filter": "typekeywords:service AND group:326b00756efb4455bd7cc005a2c90c45"
					}
				},
				"ownerKeyField": "fsk",
				"parcelKeyField": "fsk",
				"outFields": [
					"blattart",
					"buchungsblatt",
					"lfdnr",
					"buchungsart",
					"anteil",
					"name",
					"anteilsverhaeltnis",
					"geburtsdatum",
					"anschrift",
					"artderrechtsgemeischaft",
					"abrufdatum"
				],
				"orderByFields": ["buchungsblatt", "lfdnr"]
			}
		}
	]
}