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.1.0 zu beachten:

die esriProps richten sich nun nach dem LayerListViewModel (opens in a new tab), d.h. nur die Eigenschaft listModeDisabled wird unterstützt. Alle anderen Angaben werden ignoriert.

die esriProps richten sich nun nach dem PrintViewModel (opens in a new tab)
die Auflistung der Layouts mit Maßen ist ab sofort obsolet, stattdessen muss in den options ein defaultLayoutItem für die Standard-Druckvorlage sowie alle weiteren Layouts in den layoutItems definiert werden.
für die Verwendung des neuen Drucken Werkzeugs muss ein Druckdienst über ArcGIS Enterprise zur Verfügung stehen. Der Standard-Druckdienst von ArcGIS Online unterstützt keine benutzerdefinierten Layoutvorlagen bzw. ausschließlich für die Benutzertypen Professional und Professional Plus.
das bisherige Drucken-Werkzeug ist daher weiterhin als Drucken (AGOL) verfügbar, um die Standard-Druckvorlagen von ArcGIS Online zu verwenden. Die esriProps richten sich hier nachwievor nach dem PrintWidget (opens in a new tab). Die Auflistung der Layouts mit Maßen ist ebenfalls nicht mehr erforderlich für die Berechnung des Druckbereichs.

neben den links können in der Menükonfiguration auch Verweisung auf externen Apps (apps) konfiguriert werden. Für die Konfiguration können Quellen (sources) angegeben werden (ähnlich wie im Werkzeug Themen).
außerdem stehen die Eigenschaften enabled zum Aktivieren/Deaktivieren des Menüeintrags und title zum Festlegen des Anzeigetitels zur Verfügung.

die Popup-Aktion toggleRaster wurde um die Möglichkeit erweitert, auch Bilddaten aus WMS-Diensten zu verwenden. Dazu muss type: "wms" in der Eigenschaft rasterLayer angegeben werden sowie in urlFielddas Feld, das die URL enthält.
die bisherige Implementierung über ArcGIS-Imageservice (Mosaik-Dataset) ist ohne weitere Anpassungen weiterhin verfügbar.

die params für die Abfrage der Anlagen wurden angepasst. Die maskierte gmlUrl wird nun nicht mehr in der Servicekonfiguration von xplan_docs konfiguriert, sondern direkt im Layer-exri. Gleiches gilt für den Parameter namespaces.
weiterhin können mit additionalFiles zusätzliche Dateien für die Abfrage bereitgestellt werden.
somit fällt die Konfiguration im Service weg und wird vollständig im Layer-exri abgebildet.

bei den outFields kann nun auch das Feld abrufdatum angegeben werden, um den Stand der letzten Aktualisierung anzuzeigen.

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