ArcGIS Maritime verwendet eine Serverobjekterweiterung (SOE). Sie müssen die SOE zu einem Kartenservice in Ihrer ArcGIS-Site hinzufügen, um die Funktionalität Maritime Chart Service für den Kartenservice zu aktivieren.
Hinweis:
Lesen Sie die folgenden Informationen zu den Systemanforderungen, bevor Sie Ihren Service einrichten:
- Zugeordnete Netzlaufwerke werden für die Einstellung der Eigenschaft workspaceDirectories aufgrund möglicher Performance-Probleme nicht empfohlen. Es wird empfohlen, die .senc-Dateien auf einem physischen Server zu speichern.
- Maritime Chart Service kann nur auf einer Instanz vom Typ "Dedizierte Instanz" aktiviert werden. Pools geteilter Instanzen werden nicht unterstützt.
- Wenn Sie Anzeigeparameter in Ihrer GET-Anforderung verwenden, werden Sie eine URL-Länge von 2.048 Zeichen überschreiten. POST wird nicht von allen Drittanbieter-Apps unterstützt. Wenn Sie POST in Ihren Apps nicht unterstützen können, wird empfohlen, die zulässige URL-Länge unter Verwendung einer web.config.xml-Datei zu erhöhen.
- Für die Bereitstellung von Custom Chart Builder (CCB) müssen Sie web.config.xml verwenden, um die Standard-URL-Länge zu erhöhen.
- Es wird empfohlen, den Wert für javaHeapSize des Kartenservice von der Standardeinstellung von 128 MB auf 2048 MB oder mehr zu erhöhen, abhängig von Ihren Systemressourcen und der Anzahl von Datasets in Ihrem Service. Die Operation queryDataset und Custom Chart Builder (CCB)-Exporte können diesen Standardgrenzwert überschreiten.
Aktivieren von Maritime Chart Service
Führen Sie die folgenden Schritte aus, um Maritime Chart Service zu aktivieren:
- Erstellen Sie einen Ordner mit dem Namen maritimeserver in der ArcGIS Server-Site unter <ArcGIS Server installation drive>\arcgisserver\directories.
Hinweis:
Wenn dieser Speicherort nicht existiert, überprüfen Sie, dass Ihre ArcGIS Server-Site erstellt wurde.
- Kopieren Sie den Ordner "maritimechartservice" von <ArcGIS Server Installation Directory>\MaritimeServer\Server<version> in den Ordner "maritimeserver".
- Melden Sie sich bei ArcGIS Server Manager an.
- Klicken Sie auf die Registerkarte Site.
- Klicken Sie im Bereich GIS-Server auf Erweiterungen.
- Klicken Sie auf Erweiterung hinzufügen.
- Klicken Sie auf Durchsuchen, und navigieren Sie zu <ArcGIS Install Directory>\MaritimeServer\Server<version>\Bin.
- Klicken Sie auf MaritimeServer.soe.
- Klicken Sie auf Hinzufügen.
MaritimeServer.soe wurde dem Kartenservice hinzugefügt.
- Klicken Sie auf die Registerkarte Services.
- Klicken Sie auf Ihren Kartenservice.
- Klicken Sie im Bereich Kartenservices auf Funktionen.
- Aktivieren Sie das Kontrollkästchen Maritime Chart Service.
- Überprüfen Sie alle Eigenschaften.
Hinweis:
Die MaritimeServer.soe-Datei verwendet den Ordner "maritimechartservice", um die Eigenschaften der Funktionen von Maritime Chart Service automatisch auszufüllen.
- Klicken Sie auf Speichern und neu starten in ArcGIS Server Manager, um den Kartenservice neu zu starten.
Die Funktionen von Maritime Chart Service sind jetzt aktiviert.
- Jetzt können Sie die Datasets S-57 und S-63 in Ihren Kartenservice laden.
Hinweis:
Sie können die Standardeinstellung der Konfigurationseinstellungen ändern.
Hinweis:
Wenn Sie Maritime Chart Service in einem Cluster installiert haben, müssen Sie es nur auf einem der Computer in dem Cluster aktivieren. Die Änderungen der Konfiguration werden automatisch auf die anderen Computer im Cluster angewendet.
Bereitstellen von Custom Chart Builder (CCB)
Mit ArcGIS Maritime können Sie eine webbasierte App bereitstellen, um informative Kartenprodukte in Echtzeit zu generieren, und jedes beliebige Produkt in jedem Maßstab erstellen.
Kopieren des Ordners "customchartbuilder"
Kopieren Sie den Ordner "customchartbuilder" der Custom Chart Builder (CCB)-Installation in den Speicherort der Bereitstellung. Die Dateien im Installationsverzeichnis können als Sicherung angesehen werden; die Dateien im Verzeichnis der Bereitstellung werden bei Bedarf geändert. Kopieren Sie den Ordner nach <ArcGIS Server installation drive>\arcgisserver\directories\ maritimeserver, sodass der CCB-Ordner und der Maritime Server-Ordner sich im selben Ordner befinden.
Führen Sie die folgenden Schritte aus, um Custom Chart Builder (CCB) in Ihrer ArcGIS Server-Site bereitzustellen.
Hinweis:
Um die folgenden Schritte für die Bereitstellung von Custom Chart Builder (CCB) ausführen zu können, müssen Sie einen Kartenservice haben, in dem Maritime Chart Service aktiviert ist.
- Erstellen Sie gegebenenfalls einen Ordner mit dem Namen maritimeserver in der ArcGIS Server-Site unter <ArcGIS Server installation drive>\arcgisserver\directories.
Hinweis:
Wenn dieser Speicherort nicht existiert, überprüfen Sie, dass Ihre ArcGIS Server-Site erstellt wurde und Maritime Chart Service aktiviert wurde.
- Kopieren Sie den Ordner "customchartbuilder" von <ArcGIS Server Installation Directory>\MaritimeServer\Server<version> in den Ordner "maritimeserver".
- Konfigurieren Sie das ArcGIS Server-Konto.
Konfigurieren der Freigabe und der Berechtigungen
Geben Sie den <ArcGIS Server installation drive>\arcgisserver-Ordner frei, und fügen Sie ihm Berechtigungen hinzu, indem Sie die folgenden Schritte ausführen, um sicherzustellen, dass der Nutzer des ArcGIS Server-Kontos Berechtigungen für die vollständige Steuerung in diesem Ordner hat:
Hinweis:
Die Produktexportverarbeitung von Custom Chart Builder (CCB) schreibt oder ändert notwendige Dateien in diesem Ordner.
- Klicken Sie mit der rechten Maustaste auf den Ordner "arcgisserver", und wählen Sie Eigenschaften aus.
- Klicken Sie auf die Registerkarte Freigeben.
- Klicken Sie auf Erweiterte Freigabe.
- Aktivieren Sie das Kontrollkästchen Diesen Ordner freigeben.
- Klicken Sie auf Berechtigungen.
- Klicken Sie auf der Registerkarte Freigabeberechtigungen auf die Option Hinzufügen.
- Fügen Sie das ArcGIS Server-Konto hinzu.
Hinweis:
Sie können das Gebietsschema Ihres ArcGIS Server-Kontos angeben. Die Standardeinstellung für diesen Nutzer ist in der Regel ArcGIS.
- Wenn das ArcGIS Server-Konto hinzugefügt wurde, klicken Sie auf OK, um das Dialogfeld Benutzer oder Gruppen auswählen zu schließen.
- Wählen Sie das neu hinzugefügte ArcGIS Server-Konto im Fenster Gruppen- oder Benutzernamen auf der Registerkarte Freigabeberechtigungen aus, und aktivieren Sie das Kontrollkästchen Zulassen neben Vollständige Steuerung.
- Klicken Sie auf OK.
- Klicken Sie erneut auf OK, um das Dialogfeld Erweiterte Freigabe zu schließen.
- Klicken Sie auf Schließen.
- Klicken Sie auf OK, um das Dialogfeld Eigenschaften zu schließen.
Veröffentlichen der Service-Definitionsdateien
Veröffentlichen Sie die beiden Service-Definitionsdateien in ArcGIS Server für Custom Chart Builder (CCB), um die Ausdehnung des Interessenbereichs (area of interest, AOI) zu berechnen, wenn Sie auf der Karte eine Ausdehnung für den Export einer PDF-Seekarte erstellen.
- Melden Sie sich bei ArcGIS Server Manager an.
Hinweis:
Veröffentlichen Sie die Service-Definitionsdateien mit ArcGIS Server Manager. Zur Vereinfachung der Bereitstellung wird empfohlen, einen Ordner in ArcGIS Server Manager mit dem Namen CCB zu erstellen, um Ihre Services im Zusammenhang mit CCB zu organisieren.
- Klicken Sie auf Services > Services verwalten, wählen Sie den Ordner CCB aus, und klicken Sie auf Service veröffentlichen.
- Klicken Sie auf Datei auswählen, um zu der Service-Definition zu navigieren, die Sie veröffentlichen möchten, oder geben Sie den Pfad zu der Datei ein.
Das Standardverzeichnis ist <ArcGIS Server installation drive>\arcgisserver\directories\maritimeserver\customchartbuilder\ServiceDefinitionFiles.
- Wählen Sie Calculators.sd aus, und klicken Sie auf Öffnen.
Vorsicht:
Ändern Sie nicht den Namen des Service. Die Web-App funktioniert nicht, wenn Sie ihn ändern.
Standardmäßig wird die Service-Definition in dem bei der Konfiguration der Service-Definition angegebenen Serverordner veröffentlicht. Um den Ordner zu ändern, in dem die Service-Definition veröffentlicht wird, wählen Sie einen Ordner aus der Dropdown-Liste aus, oder klicken Sie auf Neu.
Hinweis:
Alle Custom Chart Builder (CCB)-Service-Definitionen müssen sich in demselben Ordner befinden, um Custom Chart Builder (CCB) korrekt bereitzustellen. Es wird empfohlen, einen Ordner zum Organisieren Ihrer Services im Zusammenhang mit CCB zu erstellen. Der empfohlene Ordnername ist "CCB".
- Klicken Sie auf Weiter.
Sie müssen die Eigenschaften für Ihren neuen Service angeben. Es sind keine zusätzlichen Funktionen erforderlich.
- Klicken Sie nach Bedarf auf Zurück oder Weiter.
- Klicken Sie auf Freigeben.
- Wiederholen Sie diese Schritte für ExportWebmap.sd.
Aktualisieren der Datei "Utilities.py"
Aktualisieren Sie die Datei Utilities.py, nachdem Sie Ihre Custom Chart Builder (CCB)-Service-Definitionsdateien veröffentlicht haben, damit die Geoverarbeitungsservices "Calculators" und "ExportWebmap" die aktualisierte Datei verwenden.
- Navigieren Sie im File Explorer zu der Datei Utilities.py, und bearbeiten Sie diese.
Das Standardverzeichnis ist <ArcGIS Server installation drive>\arcgisserver\directories\maritimeserver\customchartbuilder\Tools.
- Aktualisieren Sie die folgenden Variablen:
- shared_products_path und output_directory: Aktualisieren Sie diese mit dem Namen Ihres Computers und der Domäne, und aktualisieren Sie den Pfad, wenn Sie nicht die empfohlenen Standardeinstellungen verwenden.
- output_url: localhost wird nur für das lokale Testen verwendet. Aktualisieren Sie diese Variable sonst mit dem Namen Ihres Computers und der Domäne, und aktualisieren Sie den Pfad, wenn Sie nicht die empfohlenen Standardeinstellungen verwenden.
- Speichern Sie Ihre Änderungen in der Datei Utilities.py, und schließen Sie die Datei.
- Kopieren Sie die aktualisierte Datei Utilities.py in den Speicherort "arcgisinput" Ihrer neu veröffentlichten Custom Chart Builder (CCB)-Services "Calculators" und "ExportWebmap".
- Navigieren Sie zu Ihrem Speicherort von "arcgisinput" für Custom Chart Builder (CCB). Das Standardverzeichnis ist <ArcGIS Server installation drive>\arcgisserver\directories\arcgissystem\arcgisinput\CCB.
- Kopieren Sie die aktualisierte Datei Utilities.py aus Schritt 1 nach <ArcGIS Server installation drive>\arcgisserver\directories\arcgissystem\arcgisinput\CCB\Calculators.GPServer\extracted\p20\tools.
- Kopieren Sie die aktualisierte Datei Utilities.py aus Schritt 1 nach <ArcGIS Server installation drive>\arcgisserver\directories\arcgissystem\arcgisinput\CCB\ExportWebmap.GPServer\extracted\p20\tools.
- Klicken Sie in ArcGIS Server Manager auf Services > Services verwalten.
- Klicken Sie auf Ordner > CCB.
- Starten Sie die Geoverarbeitungsservices "Calculators" und "ExportWebmap" neu.
Aktivieren einer benutzerdefinierten Symbolisierung
Die ServerConfiguration.xml-Datei bietet einen true/false-Umschalter zum Aktivieren oder Deaktivieren der Anzeige von benutzerdefinierter Symbolisierung, die die Standard-Präsentationsbibliothek S-52 überschreibt. Wenn er aktiviert ist, referenziert Maritime Chart Service Regeln in der Datei CustomSymbolMap.XML, Symbole des Typs Scalable Vector Graphics (SVG), und Lua-Skripte, um eine papierkartenähnliche Ansicht der S-57-Daten bereitzustellen.
Wenn Sie die benutzerdefinierte Symbolisierung auf "true" festgelegt haben, müssen Sie die .senc-Dateien für die Symbole, die in Ihrem Service angezeigt werden, erneut erstellen.
Lua in Maritime Chart Service kann:
- SVG-Dateien referenzieren, um Punktsymbole oder einfache oder komplexe Linienmuster zu überschreiben.
- Anweisungen für Symbole überschreiben, wie Farbe, Füllmuster oder Transparenz.
- Auf die Anzeige von Gruppen oder Anzeigeeigenschaften zugreifen.
- Anweisungen für das Ändern des Schriftartnamens, der Größe, Gewichtung, Farbe und des Versatzes einer Textgruppe bereitstellen.
Aktualisieren von geoaktivierten Notizen
Mit geoaktivierten Notizen können Sie Textnotizen für Custom Chart Builder (CCB)-Ausgaben auf der Grundlage der geographischen Position des Produkts generieren.
Die Notizen werden in einer Punkt-, Linien- oder Multipart-Polygon-Feature-Class gespeichert, in der jeder Datensatz ein Textfeld hat, das die Notiz enthält. Wenn ein neuer Interessenbereich des Produkts eingefügt wird, wird der Interessenbereich mit den Layern der geoaktivierten Notizen verschnitten, und ein separates A4-Blatt wird an die Ausgabe angehängt. Wenn es mehr als eine Seite an Notizen gibt, wird eine zweite Seite generiert, und so weiter.
Führen Sie die folgenden Schritte aus, um geoaktivierte Notizen anzupassen:
- Entpacken Sie Notes.zip in <ArcGIS Server installation drive>\arcgisserver\directories\maritimeserver\customchartbuilder\LayoutTemplates\Notes.gdb.
Tipp:
In der Notes.zip-Datei befindet sich ein Beispiel für eine Notizen-Geodatabase.
- Fügen Sie Multipart-Polygon-Features zu der Feature-Class "FeatureClassForNotes" hinzu, die sich im Ordner Notes.gdb befindet.
Tipp:
- Beispielnotizen befinden sich in der Feature-Class "FeatureClassForNotes_Sample" im Ordner Notes.gdb.
- Multipart-Polygone ermöglichen Ihnen, mehrere geographische Positionen zu haben, die ohne Redundanz denselben Notizentext teilen.
- Bearbeiten Sie die Felder in der Feature-Class "FeatureClassForNotes" wie folgt:
| Notizen | Titel | Farbe | minScale | maxScale |
|---|---|---|---|---|
Dies ist ein obligatorisches Feld. Notizentext oder Textkörper des Absatzes. | Dies ist ein optionales Feld. Der Name der Notiz, der oberhalb des Notizenabsatzes gedruckt wird. | Dies ist ein optionales Feld. Der RGB-Wert des Absatzes und des Titels der Notiz. Trennen Sie die Werte durch ein Komma (,) voneinander. Die Notiz wird mit schwarzem Text angezeigt, wenn das Feld leer oder NULL ist oder ungültige Werte enthält. Hinweis: Dieses Feld unterstützt CMYK nicht. | Dies ist ein optionales Feld. Geben Sie die Seekarte mit dem größten Maßstab an, auf der die Notiz angezeigt wird. Wenn eine Notiz zum Beispiel auf Seekarten mit einem Maßstab zwischen 1:40000 und 1:90000 angezeigt werden soll, geben Sie 40000 in das Feld ein. | Dies ist ein optionales Feld. Geben Sie die Seekarte mit dem kleinsten Maßstab an, auf der die Notiz angezeigt wird. Wenn eine Notiz zum Beispiel auf Seekarten mit einem Maßstab zwischen 1:40000 und 1:90000 angezeigt werden soll, geben Sie 90000 in das Feld ein. |
Anpassen von Layout-Vorlagen
Sie können die Layout-Vorlagen wie im Folgenden beschrieben anpassen.
Kartenelemente
Custom Chart Builder (CCB) bietet mehrere Layout-Vorlagen für verschiedene Seitengrößen und -ausrichtungen. Jedes Layout enthält Kartenelemente, wie Maßstabsleisten, Nordpfeile und Legenden, sowie Logos, Text oder anderen Grafiken, die für besondere Zwecke in der Seekarte erstellt werden. Auch Kartenrahmen können Layout-Elemente sein.
Mit der letzten Version von Maritime Chart Service wurden den Vorlagen für die Seitengrößen A0 und ANSI E allgemeine Seekartennotizen hinzugefügt. Sie können diese Notizen so anpassen, dass sie Ihren lokalen Bedürfnissen entsprechen. Wenn Sie Seekarten in der Größe A0 oder ANSI E nicht mit Notizen erstellen möchten, können Sie diese Vorlagen aus Ihrem Setup entfernen und sie durch frühere Versionen dieser Vorlagen ersetzen, die jetzt mit einem Suffix "_withoutnotes" umbenannt sind.
Tipp:
Benennen Sie Ihre A0- und ANSI E-Vorlagen um, z. B. mit einem Suffix "_withnotes" in ihrem Namen. Entfernen Sie den Suffix "_withoutnotes" von Ihren Sicherungsvorlagen A0 und ANSI E. Das System erkennt die A0- und ANSI E-Vorlagen, die keine allgemeinen Notizen mehr haben.
Die Standardeinstellung für die Schriftart der Layout-Vorlage ist Arial.
Verwalten von Elementen
Während der Erstellung des Produkts werden die Kartenelemente dynamisch aktualisiert, um Änderungen in der Seekarte abzubilden, wie Maßstab, geographische Ausdehnung und das Datum der Erstellung. Custom Chart Builder (CCB) verwendet die Namen der Elemente, um zu verwalten und zu ermitteln, welche Elemente von dem Automatisierungsskript geändert werden sollen. Die Namen von Kartenelementen sollten nicht geändert werden. Wenn Namen geändert werden, kann das Element nicht mit dem Automatisierungsskript verwaltet werden. Sie können bei Bedarf auf den Namen zugreifen, indem Sie auf Elementname auf der Registerkarte Größe und Position im Dialogfeld Eigenschaften klicken.
Kartenrahmen
Der in der Custom Chart Builder (CCB)-Web-App generierte AOI wird von dem Kartenrahmen der Layout-Vorlage abgerufen. Ein Rechner sucht die untere linke Ecke des Datenrahmens; dann sucht er die linke und die untere Kante. Das Ändern der Größe des Kartenrahmens hat Auswirkungen auf die Größe des AOI.
Konfigurieren der Web-App
Wenn Sie Ihre Service-Definitionsdateien veröffentlicht, Ihre Layout-Vorlagen aktualisiert, einen Kartenservice mit aktiviertem Maritime Chart Service veröffentlicht und die Datei Utilities.py aktualisiert haben, können Sie jetzt die Custom Chart Builder (CCB)-Web-App konfigurieren und bereitstellen.
- Navigieren Sie zu <ArcGIS Server Installation Directory>\MaritimeServer\Server<version>\WebApplications, und kopieren Sie den Ordner "CCB". Navigieren Sie z. B. zu C:\inetpub\wwwroot, wenn Sie Internet Information Server (IIS) verwenden, um Ihre Web-App bereitzustellen.
Hinweis:
Sie können den Ordner "CCB" umbenennen. Dies ist der Name der App, auf die Sie im Web zugreifen.
- Registrieren Sie Ihre Web-App, und rufen Sie die App-ID ab. Weitere Informationen finden Sie im Abschnitt "Hinzufügen von Anwendungen".
Sie können auch Ihre Web-App über Ihr Portal registrieren.
- Aktualisieren Sie die Datei ccbconfig.js, die sich unter ccb\js befindet.
- Aktualisieren Sie serviceURL auf den in Schritt 2 von Veröffentlichen der Service-Definitionsdateien erstellten Speicherort. Bei Verwendung von Standardeinstellungen lautet der Pfad https://gisserver.domain.com/arcgis/rest/services/CCB.
- Aktualisieren Sie MCSURL auf den Kartenservice mit aktiviertem Maritime Chart Service. Wenn Sie Maritime Chart Service für "SampleWorldCities" aktiviert haben, lautet der Pfad https://gisserver.domain.com/arcgis/rest/services/SampleWorldCities/MapServer/exts/MaritimeChartService/MapServer.
Hinweis:
Die App verwendet als Standardeinstellung die Esri Grundkarte "Meere". Sie können eine andere Grundkarte auswählen, indem Sie die Variable "basemap" ändern.
- Aktualisieren Sie "appID" mit der in Schritt 2 erstellten App-ID. Dadurch können Sie sich bei ArcGIS Online oder in Ihrem Portal-Konto anmelden.
- Speichern Sie die Änderungen an der Datei ccbconfig.js.
Jetzt können Sie die Custom Chart Builder (CCB)-App verwenden.
Registrieren der Web-App über Ihr Portal
Führen Sie die folgenden Schritte aus, um Ihre Web-App über das Portal zu registrieren:
- Navigieren Sie zum Ordner "CCB" in Ihrem Webstammordner. Navigieren Sie z. B. zu C:\inetpub\wwwroot\ccb, wenn Sie Internet Information Server (IIS) verwenden, um Ihre Web-App bereitzustellen.
- Öffnen Sie im Ordner widgets\AddData die Datei Widget.js.
- Aktualisieren Sie die Variable portalUrl auf https://portalserver.domain.com/arcgis.
- Klicken Sie auf Speichern.
- Öffnen Sie im Ordner widgets\LayerList die Datei Widget.js.
- Aktualisieren Sie im Abschnitt appConfig die portalUrl auf https://portalserver.domain.com/arcgis.
- Klicken Sie auf Speichern.
- Öffnen Sie im Ordner "js" die Datei SignInButton.js.
- Heben Sie die Auskommentierung von // portalUrl: "https://portalserver.domain.com/arcgis", auf, und aktualisieren Sie den Parameter portalUrl.
- Klicken Sie auf Speichern.
Problembehandlung für Maritime-Server-Konfigurationsprobleme
Was ist, wenn ich die Maritime Chart Service-Daten in meiner Custom Chart Builder (CCB)-App nicht sehe?
Überprüfen Sie, dass die in Schritt 3 des Abschnitts "Konfigurieren der Web-App" festgelegte MCSURL für den Nutzer, der auf die App zugreift, zugänglich ist.
Was ist, wenn ich den Fehler "Vorgang kann nicht abgeschlossen werden" erhalte?
Fügen Sie "ArcGIS Server-Konto konfigurieren" zu dem Installationsverzeichnis hinzu, wenn der Fehler Vorgang kann nicht abgeschlossen werden. Fehler bei der Ausführung des Werkzeuges. Ausdehnung berechnen auftritt.
Was ist, wenn Maritime Chart Service nicht angezeigt wird oder nach dem Ändern der Anzeigeeigenschaften verschwindet?
Prüfen Sie, ob Ihre Server-URL-Länge bei der Verwendung der Anzeigeparameter über 2.048 Zeichen hinausgeht. Wenn dies der Fall ist, dann erhöhen Sie die zulässige URL-Länge unter Verwendung einer web.config.xml-Datei.
Was ist, wenn ich einen möglichen Fehler aufgrund des fehlgeschlagenen Aktivierens von HTTPS auf dem Webserver beobachte?
Überprüfen Sie, dass HTTPS für Ihren Webserver aktiviert ist.