Update von Terratwin

Die Installationsvoraussetzungen bleiben unverändert. (HttpPlatformHandler, MIME-Type, Anwendungspool, etc.).

Entpacken Sie das ZIP-Archiv terratwin-2.x.x - wie in den Vorbemerkungen beschrieben - in ein Verzeichnis neben der bisherigen Version.
Prüfen Sie die Berechtigungen des Unterordners api: Der Benutzer (i. d. R. IIS_IUSRS) benötigt Schreib- und Leserechte.
Stoppen Sie den Anwendungspool TerratwinApiAppPool im IIS-Manager, damit keine Dateien mehr geöffnet sind.
Entfernen Sie die api Anwendung im IIS-Manager, indem Sie mit Rechtsklick auf das Verzeichnis api die Option Anwendung entfernen wählen.
Kopieren Sie - nur wenn angepasst - folgende Elemente aus api/terratwin/ der alten Version in den neuen Ordner:
- settings.json
- config/* - alle Config-Dateien
- exri/* - alle Exri-Dateien
- jobs/* - alle Job-Dateien
- license/* - alle Lizenzdateien
- markdown/* - alle Markdown-Dateien
- static/img/* - alle Logos
- static/manifest.json
- static/popupPrint.css
- static/style.css
Passen Sie gegebenenfalls neue Optionen in den Dateien (vor allem im Ordner config) an Ihre Anforderungen an.
Stellen Sie im IIS-Manager sicher, dass das virtuelle Verzeichnis auf terratwin-2.x.x zeigt.
Konvertieren Sie den neuen Ordner api in eine Anwendung und ordnen Sie diese dem Anwendungspool TerratwinApiAppPool zu.
Starten Sie Site und Anwendungspool neu, um das Update zu aktivieren.
Testen Sie die Anwendung, indem Sie die URL der Anwendung & API im Browser aufrufen.

Änderungen in der Konfiguration zur vorherigen Version

Folgende Änderungen sind in der Konfiguration gegenüber der vorherigen Version 2.2.2 zu beachten:

bei den credentials kann nun die optionale Eigenschaft authMode mit den Werten oauth oder windows angegeben werden. Standardmäßig ist oauth eingestellt, wenn die Eigenschaft nicht angegeben ist.

neue optionale Eigenschaft authenticationMode zur Auswahl des Authentifizierungsmodus oauth oder neu windows nun verfügbar. Standardmäßig ist oauth eingestellt, wenn die Eigenschaft nicht angegeben ist.
neue optionale Eigenschaft authenticationPopup zur Steuerung, ob das OAuth-Login im Popup-Fenster oder im selben Fenster erfolgen soll. Standardmäßig ist true eingestellt, wenn die Eigenschaft nicht angegeben ist.
neue optionale Eigenschaft underConstruction zur Aktivierung des Wartungsmodus der Anwendung. Wenn true, wird eine entsprechende Meldung angezeigt und die Anwendung ist für Benutzer nicht zugänglich.

neue optionale Eigenschaft queries eingeführt, um vordefinierte Abfragen für Layer zu konfigurieren. Diese können im Werkzeug Abfrage verwendet werden.

neue Konfigurationsdatei für das Werkzeug Abfrage, um vordefinierte Abfragen aus den Layer-Exris zu laden und anzubieten.

Konfiguration für neues Werkzeug Geoverarbeitung hinzugefügt, um Geoverarbeitungsdienste aus ArcGIS Server zu nutzen.

neue Konfigurationsdatei für den Task Metadaten bereitstellen verfügbar, um Metadaten aus Portalelementen aus ArcGIS Enterprise oder ArcGIS Online zu veröffentlichen. Zugriff und Harvest über Metadaten-Browser möglich.

für den Menüeintrag Apps steht nun für jede der sources die optionale Eigenschaft authorizedGroups zur Verfügung, um den Zugriff auf bestimmte Gruppen bzw. mit dem Schlüsselwort org auf angemeldete Benutzer zu beschränken.

mit der neuen Top-Level-Eigenschaft mapMenu können Sie Einstellungen für das Submenu Karte vornehmen. Zum einen können Sie darin mit sharing die Freigabe von Karten steuern. Zum anderen wurde die Option mapBrowser hinzugefügt, um die Anzeige des Kartenbrowsers zu steuern. Bisher wurde der Kartenbrowser über die orgMaps in der Anwendungskonfiguration gesteuert. Dies ist zwar weiterhin möglich, aber seit Version 2.3.1 deprecated und die neue Einstellung mapMenu.mapBrowser wird bevorzugt.

bei der Referenzierung von Portalinhalten (z.B. Karten, Layer, Durckvorlagen, Tools, etc.) kann nun anstelle von portalUrl auch ein Objekt portal angegeben werden, dass neben der url auch den authMode umfassen kann. Beide Angaben sind möglich, aber die neue Angabe mit portal wird bevorzugt.

innerhalb von mapView bzw. sceneView ist die Option highlights implementiert worden, um die Darstellung der Selektion und Hervorhebung von Features in der Karte zu steuern.

in Feldkonfiguration ist bei den Operatoren nun der Wert IN zulässig, um die Auswahl von mehreren Werten zu ermöglichen. In diesem Fall wird im Werkzeug Abfrage eine Mehrfachauswahl angeboten.

Optionen mit Pfaden zu Icons oder Bildern können nun entweder wie bisher als String mit absolutem Pfad oder als Objekt mit den Eigenschaften light und dark angegeben werden, um unterschiedliche Grafiken für den Light- und Darkmode zu verwenden. Wenn nur ein String angegeben wird, wird dieses Bild in beiden Modi verwendet.
betrifft image in den Links innerhalb der Menükonfiguration. Die bisherige Eigenschaft imageDark wird nicht mehr unterstützt!
logo_primary und logo_secondary in der Anwendungskonfiguration können nun abhängig vom Modus unterschiedliche Grafiken annehmen.
Tab-Icons von Quellen bei den apps in der Menükonfiguration sowie die Tab-Icons im Dialog “Themen hinzufügen” (siehe Werkzeug Themen) können nun passend zum Farbmodus konfiguriert werden.

Bei Fehlern hilft die FAQ - Installation mit typischen Ursachen und Lösungen.