Initiale Konfiguration

Diese Seite richtet sich an alle, die eine frisch installierte Terratwin-Instanz zum ersten Mal einrichten. Voraussetzung ist, dass die Instanz bereits läuft und Terratwin Admin eingerichtet ist (vgl. Erste Schritte). Die hier beschriebenen Schritte sind die wesentlichen, um die Anwendung für die ersten Benutzer freizugeben. Je nach Anwendungsfall können weitere Konfigurationen sinnvoll sein (z.B. 3D-Konfiguration, Exris, Jobs u.v.m). Alle Details zu den einzelnen Konfigurationsmöglichkeiten finden Sie in den entsprechenden Kapiteln der Administration.

Schritt 1: Anwendungskonfiguration

Öffnen Sie in Terratwin Admin die Anwendungskonfiguration (appConfig.json). Die wichtigsten Einstellungen für den Einstieg:

Anwendungsname

Geben Sie der Instanz einen passenden Namen:

{
	"appName": "Musterstadt GIS",
	"htmlTitle": "Digitaler Zwilling | Musterstadt"
}

Portal anbinden

Wenn die Anwendung nur öffentliche, nicht-authentifizierte Inhalte zeigen soll (z.B. für eine Demo), reicht zunächst:

{
	"authenticationEnabled": false
}

Sobald sich Benutzer anmelden und auf geschützte Inhalte zugreifen sollen, müssen portalUrl und appId gesetzt sein. Wie Sie die App auf Ihrem Portal registrieren, erfahren Sie unter Anbindung an ArcGIS.

{
	"authenticationEnabled": true,
	"portalUrl": "https://www.arcgis.com/",
	"appId": "IHRE_APP_ID"
}

Logos

Laden Sie Ihre Logos in Terratwin Admin unter Design & Anpassungen → Bilder hoch und referenzieren Sie diese in der Anwendungskonfiguration. Alternativ können Sie auch direkte Pfade zu Bildern via URL hinterlegen, bspw. https://www.musterstadt.de/logo.png.

{
	"logos": {
		"logo_primary": "./api/static/img/custom/logo_primary.png",
		"logo_secondary": "./api/static/img/custom/logo_secondary.png"
	}
}

Das Hauptlogo (logo_primary) erscheint u.a. in der Toolbar der Anwendung. Empfohlene Formate und Größen finden Sie unter Bilder und Icons.

Schritt 2: Kartenkonfiguration

In der Kartenkonfiguration (mapConfig.json) legen Sie fest, welche Karte beim Start von Terratwin geladen wird – das ist der erste Eindruck für jeden Benutzer.

Standard-WebMap

Tragen Sie die ID der WebMap ein, die beim Start der Anwendung angezeigt werden soll:

{
	"webMap": {
		"portalItem": {
			"id": "IHRE_WEBMAP_ID",
			"portal": {
				"url": "https://www.arcgis.com/"
			}
		}
	}
}

Die in der Standard-WebMap hinterlegte Grundkarte bestimmt das Koordinatenreferenzsystem der gesamten Anwendung. Wählen Sie die Grundkarte daher sorgfältig.

Wenn noch keine eigene WebMap vorliegt, bieten die Terratwin Basemaps einen guten Ausgangspunkt. Legen Sie dazu eine neue WebMap in Ihrem Portal an, fügen Sie die gewünschte Terratwin Basemap als Grundkarte hinzu und speichern Sie die WebMap. Die ID dieser WebMap tragen Sie dann als webMap.portalItem.id in der Kartenkonfiguration ein.

Standard-Grundkarten für Light-/Darkmode

Over defaultBasemaps können Sie festlegen, welche Grundkarte beim Wechsel in den Light- bzw. Darkmode aktiv wird. Die angegebene Grundkarte ersetzt die in der WebMap hinterlegte Grundkarte, sobald der Benutzer den Modus wechselt:

{
	"defaultBasemaps": {
		"light": {
			"portalItem": {
				"id": "IHRE_BASEMAP_LIGHT_ID",
				"portal": { "url": "https://www.arcgis.com/" }
			}
		},
		"dark": {
			"portalItem": {
				"id": "IHRE_BASEMAP_DARK_ID",
				"portal": { "url": "https://www.arcgis.com/" }
			}
		}
	}
}

Für Baden-Württemberg empfehlen sich die Terratwin Basemaps als Light- und Dark-Variante – diese sind bereits im passenden Kachelschema und Koordinatensystem (ETRS89-UTM32) aufgebaut und optimal auf Terratwin abgestimmt.

Startansicht und Ausdehnung

Über mapView können Sie sowohl den Startausschnitt als auch die maximale Ausdehnung einstellen, auf die Benutzer navigieren können. Der Startausschnitt wird über viewpoint mit einem Zielpunkt (targetGeometry) und einem Maßstab (scale) definiert:

{
	"mapView": {
		"viewpoint": {
			"targetGeometry": {
				"type": "point",
				"x": 497713.53,
				"y": 5398742.91,
				"spatialReference": {
					"wkid": 25832
				}
			},
			"scale": 36000
		}
	}
}

viewpoint wird nur berücksichtigt, wenn die Standard-WebMap keinen gespeicherten Startausschnitt enthält. Ist ein Ausschnitt in der WebMap hinterlegt, hat dieser Vorrang.

Organisationslayer

Mit orgLayer können Layer definiert werden, die automatisch nach der Anmeldung eines Benutzers zur Karte hinzugefügt werden – unabhängig davon, welche WebMap gerade geladen ist. Das eignet sich z.B. für Katasterdaten oder interne Pflichtlayer:

{
	"orgLayer": {
		"portalUrl": "https://www.arcgis.com/",
		"queryParams": {
			"filter": "group: IHRE_GRUPPEN_ID"
		}
	}
}

Tipp: Legen Sie für Organisationslayer eine mitgliederlose Gruppe in Ihrem Portal an. So können Sie die Freigabe feingranular über weitere Gruppenfreigaben steuern.

Schritt 3: Menü anpassen

In der Menükonfiguration (menuConfig.json) können Sie Links zu weiteren Webangeboten einrichten – z.B. die eigene Webseite, das Stadtportal oder ein internes Geoportal:

{
	"links": [
		{
			"text": "Musterstadt",
			"url": "https://www.musterstadt.de",
			"image": "./api/static/img/custom/logo_primary.png"
		}
	]
}

Über apps lassen sich außerdem externe Anwendungen, die in einem Ihrer verbundenen Portal freigegeben sind, in einer Browser-UI öffnen (z.B. StoryMaps, Dashboards, Dokumente, Links etc.).

Untermenü Karte

Über das mapMenu in der Menükonfiguration steuern Sie, welche WebMaps Benutzer über Karte öffnen laden können. Typischerweise referenzieren Sie hier eine Gruppe in Ihrem Portal, in der alle relevanten WebMaps gesammelt sind. Darüber hinaus haben Sie die Möglichkeit das Teilen von Karten zu aktivieren, damit Benutzer die aktuell angezeigte Karte als WebMap in ihrem Portal speichern können.

{
	"mapMenu": {
		"sharing": {
			"enabled": true,
			"authorizedGroups": ["org"],
			"maxFileAgeDays": 30
		},
		"mapBrowser": {
			"portalQuery": {
				"portalUrl": "https://www.arcgis.com",
				"queryParams": {
					"filter": "type: \"Web Map\" group: groupId"
				}
			}
		}
	}
}

Schritt 4: Design anpassen

style.css

Terratwin lässt sich über die style.css farblich an Ihr Corporate Design anpassen. Die wichtigsten Variablen:

[data-theme="light"] {
	--app-primary-color: #00619b;
	--app-secondary-color: #1b88c7;
}

Für Light- und Dark-Mode können jeweils eigene Farbwerte vergeben werden. Die Primärfarbe wird u.a. für Buttons, Highlights und die Werkzeugleiste verwendet.

App-Manifest

Ergänzen Sie außerdem das App-Manifest mit dem Anwendungsnamen für die PWA-Installation:

{
	"short_name": "Musterstadt GIS",
	"name": "Digitaler Zwilling Musterstadt"
}

Schritt 5: Werkzeuge konfigurieren

Deaktivieren Sie in Terratwin Admin unter Konfiguration → Werkzeuge diejenigen, die aktuell noch nicht benötigt werden oder deren Voraussetzungen noch nicht erfüllt sind. Sie können darüber hinaus auch Werkzeuge nur für bestimmte Benutzergruppen freigeben.

{
	"enabled": true,
	"authorizedGroups": ["Gruppe1", "Gruppe2"],
}

Themen

Das Themen-Werkzeug ist das zentrale Werkzeug, über das Benutzer Layer zur Karte hinzufügen und deren Sichtbarkeit steuern. Richten Sie mindestens eine sinnvolle Quelle ein, damit Benutzer selbst Layer finden und laden können:

{
	"options": {
		"sources": [
			{
				"title": "Eigene Daten",
				"type": "arcgis portal",
				"portalQuery": {
					"portalUrl": "https://www.arcgis.com",
					"queryParams": {
						"filter": "group: IHRE_GRUPPEN_ID"
					}
				}
			},
			{
				"title": "URL hinzufügen",
				"type": "url"
			}
		]
	}
}

Tipp: Die Quelle vom Typ url erlaubt es Benutzern, externe Dienste (WMS, WFS, WMTS, ArcGIS REST) direkt per URL einzubinden.

Grundkarten

Über das Werkzeug Grundkarte können Benutzer zwischen verschiedenen Grundkarten wechseln. Konfigurieren Sie, welche Grundkarten zur Verfügung stehen sollen.

Die schnellste Option für den Einstieg: alle Grundkarten aus Ihrem Portal laden.

{
	"esriProps": {
		"source": {
			"portal": "https://www.yourportal.arcgis.com"
		}
	}
}

Alle Grundkarten, die in Ihrem Portal unter Organisation → Einstellungen → Karte → Grundkarten-Galerie referenziert sind, erscheinen dann automatisch im Werkzeug.

Wenn Sie gezielt ausgewählte Grundkarten anbieten möchten oder die von Terratwin bereitgestellten Karten nutzen wollen, finden Sie alle Details unter Terratwin Basemaps und Grundkarten einrichten.

Weitere Werkzeuge mit individueller Konfiguration

Einige Werkzeuge funktionieren nur, wenn bestimmte Voraussetzungen erfüllt sind. Aktivieren Sie diese erst, wenn alles eingerichtet ist:

Schritt 6: Rechtliche Inhalte hinterlegen

Vor dem produktiven Einsatz müssen Impressum, Datenschutz und Nutzungsbedingungen befüllt werden. Öffnen Sie in Terratwin Admin die entsprechenden Dateien unter Markdown:

Weitere Hinweise zur Markdown-Syntax finden Sie unter Verwendung von Markdown.