Sie können aus ArcGIS Pro veröffentlichte Karten- und Image-Services mit Serverobjekterweiterungen (SOEs) und Serverobjekt-Interceptoren (SOIs) erweitern. SOEs ermöglichen Ihnen die Erstellung von Service-Operationen, um die Basisfunktionalität von Services zu erweitern. SOIs ermöglichen Ihnen, Anforderungen und Antworten für integrierte Operationen eines Service abzufangen.
SOEs und SOIs können mit Esri ArcGIS Enterprise SDK entwickelt werden. Beide Erweiterungen sind in .soe-Dateien gekapselt. Sie können in ArcGIS Enterprise Manager verwaltet und der Organisation hinzugefügt werden. Nachdem sie der Organisation hinzugefügt wurden, können SOEs und SOIs für Karten- und Image-Services beim Veröffentlichen aus ArcGIS Pro oder auf der Elementdetailseite eines Kartenbild-Layers aktiviert werden.
Hinzufügen einer Erweiterung
Um einer Organisation eine Erweiterung hinzuzufügen, benötigen Sie die .soe-Datei, die vom Entwickler der Erweiterung erstellt wurde. Die Datei kann eine oder viele Erweiterungen enthalten.
Sobald Sie die Datei haben, führen Sie die folgenden Schritte aus:
-
Melden Sie sich bei ArcGIS Enterprise Manager als Administrator an.
Hinweis:
Organisationen können Publisher für die Bereitstellung von Erweiterungen aktivieren. Weitere Informationen erhalten Sie unter Ändern der Publishing-Berechtigungen für Geoverarbeitungsservices und Service-Erweiterungen.
- Klicken Sie auf die Schaltfläche Erweiterungen auf der Seitenleiste.
Die Seite "Erweiterungen" wird angezeigt.
- Klicken Sie auf Erweiterung hinzufügen.
- Klicken Sie auf Datei auswählen, und wählen Sie eine .soe-Datei aus, die der Organisation hinzugefügt werden soll.
- Klicken Sie auf Erweiterung hinzufügen.
Die .soe-Datei wird der Organisation hinzugefügt.
Nachdem Sie die Erweiterung zu Ihrer Organisation hinzugefügt haben, müssen Sie die SOE- oder SOI-Funktion für den gewünschten Karten- oder Image-Service aktivieren.
Aktivieren von SOE
Sobald der Organisation eine SOE hinzugefügt wurde, können Sie die Funktion für einen Karten- oder Image-Service aktivieren. SOEs können auf der Elementdetailseite eines Kartenbild-Layers aktiviert werden.
Führen Sie die folgenden Schritte aus, um eine SOE über die Elementdetailseite eines Layers zu aktivieren:
- Melden Sie sich als Elementbesitzer mit Veröffentlichungsberechtigungen oder als Administrator bei einer Organisation an.
- Öffnen Sie die Elementdetailseite für den Kartenbild-Layer.
- Klicken Sie auf Einstellungen.
- Scrollen Sie zum Abschnitt Kartenbild-Layer, und erweitern Sie die Überschrift Erweiterungen.
- Erweitern Sie die Überschrift Serverobjekterweiterungen (SOEs).
Eine Liste der SOEs, die Ihrer Organisation hinzugefügt wurden, wird angezeigt.
- Aktivieren Sie die Umschaltfläche neben der SOE, die Sie für den Service aktivieren möchten.
- Erweitern Sie die Überschrift für die aktivierte SOE.
Die Operationen und Eigenschaften für die SOE werden angezeigt. Diese wurden vom Entwickler der Erweiterung optional erstellt und geben Ihnen eine genauere Kontrolle darüber, wie die Benutzer SOEs einsetzen können.
- Wählen Sie ggf. die Opertionen aus, die Sie zulassen möchten.
- Bearbeiten Sie ggf. die verfügbaren Eigenschaften.
- Klicken Sie auf Speichern, um die Änderungen zu speichern.
Die SOE ist jetzt für den Service aktiviert. Um sie zu deaktivieren, deaktivieren Sie die entsprechende Umschaltfläche neben der SOE, und klicken Sie auf Speichern.
Aktivieren von SOI
Sobald der Organisation ein SOI hinzugefügt wurde, können Sie die Funktion für einen Karten- oder Image-Service aktivieren. SOIs können auf der Elementdetailseite eines Kartenbild-Layers aktiviert werden.
Die Aktivierung mehrerer SOIs wird als Verkettung bezeichnet. Beim Verketten müssen Sie die Reihenfolge festlegen, in der die SOIs im Service ausgeführt werden.
Führen Sie die folgenden Schritte aus, um eine SOI über die Elementdetailseite eines Layers zu aktivieren:
- Melden Sie sich als Elementbesitzer mit Veröffentlichungsberechtigungen oder als Administrator bei einer Organisation an.
- Öffnen Sie die Elementdetailseite für den Kartenbild-Layer.
- Klicken Sie auf Einstellungen.
- Scrollen Sie zum Abschnitt Kartenbild-Layer, und erweitern Sie die Überschrift Erweiterungen.
- Erweitern Sie die Überschrift Serverobjekt-Interceptoren (SOIs).
Eine Liste der SOIs, die Ihrer Organisation hinzugefügt wurden, wird angezeigt.
- Aktivieren Sie die Umschaltfläche neben den SOIs, die Sie für den Service aktivieren möchten.
- Wenn Sie mehrere SOIs aktivieren; verwenden Sie die Drag-and-Drop-Funktionalität, um die Reihenfolge anzugeben, in der die SOIs in der Kette ausgeführt werden.
Der SOI ganz oben in der Liste wird zuerst ausgeführt.
Tipp:
Sie können jederzeit zu diesem Dialogfeld zurückkehren, um die Liste der aktivierten SOIs und die Reihenfolge ihrer Ausführung in der Kette zu ändern.
- Erweitern Sie die Überschrift für die einzelnen aktivierten SOIs.
Die Operationen und Eigenschaften für den jeweiligen SOI werden angezeigt. Diese wurden vom Entwickler der Erweiterung optional erstellt und geben Ihnen eine genauere Kontrolle darüber, wie die Benutzer SOIs einsetzen können.
- Wählen Sie ggf. die Opertionen aus, die Sie zulassen möchten.
- Bearbeiten Sie ggf. die verfügbaren Eigenschaften.
- Klicken Sie auf Speichern, um die Änderungen zu speichern.
Die SOIs sind jetzt für den Service aktiviert. Um sie zu deaktivieren, deaktivieren Sie die entsprechende Umschaltfläche neben der SOI, und klicken Sie auf Speichern.
Konfigurieren der Debug-Einstellungen
Zum Aktivieren von Debugging bietet ArcGIS Enterprise Manager die Möglichkeit, das Verhalten von Erweiterungen zu ändern. Sie können das Starten von Services unterbrechen, damit Sie den Debugger an den Service-Prozess anfügen können, bevor die Initialisierungsmethoden der Erweiterung aufgerufen werden. Zudem können Sie einen Portbereich festlegen, der beim Debuggen des Service verwendet werden soll.
Um auf diese Debugging-Einstellungen in Enterprise Manager zuzugreifen, führen Sie die folgenden Schritte aus:
- Melden Sie sich bei ArcGIS Enterprise Manager als Administrator an.
- Klicken Sie auf die Schaltfläche Services auf der Seitenleiste.
Die Seite "Services" wird angezeigt.
- Suchen Sie einen bei einer SOE registrierten Service, und klicken Sie auf dessen Namen.
- Wählen Sie die Registerkarte Erweitert aus, und aktivieren Sie den Debugmodus.
Nach der Aktivierung des Debugmodus werden die Debug-Einstellungen für Erweiterungen angezeigt.
- Aktivieren Sie optional Service beim Programmstart unterbrechen, und geben Sie die Anzahl der Sekunden ein, um die der Service-Start verzögert werden soll.
- Zudem können Sie optional einen Portbereich angeben, der beim Debuggen verwendet werden soll.
- Klicken Sie auf Speichern.
Löschen einer Erweiterung
Wenn Sie eine Erweiterung in ArcGIS Enterprise Manager löschen, wird die Erweiterung aus der Organisation entfernt. Falls die Erweiterung bei einem Service registriert ist, wird durch den Löschvorgang auch die Registrierung bei dem Service aufgehoben.
Führen Sie zum Löschen einer Erweiterung die folgenden Schritte aus:
- Melden Sie sich bei ArcGIS Enterprise Manager als Administrator an.
- Klicken Sie auf die Schaltfläche Erweiterungen auf der Seitenleiste.
Die Seite "Erweiterungen" wird angezeigt.
- Klicken Sie neben der zu löschenden Erweiterung auf die Schaltfläche Weitere Optionen
, und klicken Sie auf Löschen. - Klicken Sie erneut auf Löschen, um den Vorgang zu bestätigen.
Die Registrierung der Erweiterung bei dem Service wird aufgehoben, und sie wird aus der Organisation entfernt.
Aktualisieren einer Erweiterung
Sie können eine Erweiterung in Ihrer Organisation durch Hinzufügen der aktualisierten .soe-Datei aktualisieren.
Führen Sie zum Aktualisieren der Erweiterung die folgenden Schritte aus:
- Melden Sie sich bei ArcGIS Enterprise Manager als Administrator an.
- Klicken Sie auf die Schaltfläche Erweiterungen auf der Seitenleiste.
Die Seite "Erweiterungen" wird angezeigt.
- Klicken Sie neben der zu aktualisierenden Erweiterung auf die Schaltfläche Weitere Optionen , und klicken Sie auf Aktualisieren.
- Klicken Sie auf Datei auswählen, und wählen Sie die aktualisierte Version der .soe-Datei aus.
Der Dateiname muss mit dem ursprünglichen Namen der .soe-Datei übereinstimmen.
- Klicken Sie auf Erweiterung aktualisieren.
Die Erweiterung wird durch die neue .soe-Datei aktualisiert.