Update von Terratwin

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

1. Entpacken Sie das ZIP-Archiv terratwin-2.x.x - wie in den Vorbemerkungen beschrieben - in ein Verzeichnis neben der bisherigen Version.
2. Prüfen Sie die Berechtigungen des Unterordners api: Der Benutzer (i. d. R. IIS_IUSRS) benötigt Schreib- und Leserechte.
3. Stoppen Sie den Anwendungspool TerratwinApiAppPool im IIS-Manager, damit keine Dateien mehr geöffnet sind.
4. Entfernen Sie die api Anwendung im IIS-Manager, indem Sie mit Rechtsklick auf das Verzeichnis api die Option Anwendung entfernen wählen.
5. 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
6. Passen Sie gegebenenfalls neue Optionen in den Dateien (vor allem im Ordner config) an Ihre Anforderungen an.
7. Stellen Sie im IIS-Manager sicher, dass das virtuelle Verzeichnis auf terratwin-2.x.x zeigt.
8. Konvertieren Sie den neuen Ordner api in eine Anwendung und ordnen Sie diese dem Anwendungspool TerratwinApiAppPool zu.
9. Starten Sie Site und Anwendungspool neu, um das Update zu aktivieren.
10. 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:

Themen

• 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.
• ab Version 2.2.2: die sources können nun über den optionalen Parameter authorizedGroups auf bestimmte Gruppen bzw. mit dem Schlüsselwort org auf angemeldete Benutzer beschränkt werden.

Drucken

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

Menü

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

Popup-Aktion toggleRaster

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

Popup-Inhalt getXplanungattachments

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

Popup-Inhalt getOwners

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

Popup-Inhalt urlCall

• ab Version 2.2.2 verfügbar
• verwenden Sie in params die Eigenschaften url, heading, linkText und fallback für die Konfiguration.
• mit dem optionalen Parameter authorizedGroups kann der Content auf bestimmte Gruppen bzw. mit dem Schlüsselwort org auf angemeldete Benutzer beschränkt werden (gilt ab 2.2.2 grundsätzlich für alle Popup-Inhalte).

Allgemeine Layereigenschaften

• ab Version 2.2.2 können Sie mit dem Parameter noTable: true festlegen, dass für Layer keine Tabellenansicht bereitgestellt werden soll.

Werkzeug Grundkarte

• ab Version 2.2.2 richten sich die esriProps nach dem BasemapGalleryViewModel (opens in a new tab). In der Konfiguration ändert sich dadurch i.d.R. nichts, da die relevante Eigenschaft source unverändert bleibt.

Problembehandlung

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