ArcObjects SDKs (für .NET und für Java)

Erweiterungen werden nur für Karten- und Image-Services unterstützt. Da Karten- und Image-Services eine Service-Definitionsdatei verwenden und nicht direkt auf ein Kartendokument (MXD) zugreifen, sind beim Programmieren von Erweiterungen bestimmte Classes zu vermeiden und andere wiederum vorzuziehen.

Vermeiden Sie die Nutzung von ArcObjects aus der Carto-Bibliothek, die eigens für den Einsatz mit MXDs vorgesehen sind. Zu diesen zählen IMap, ILayer und Elemente, die sich auf Datenrahmen und Seitenlayouts beziehen. Verwenden Sie stattdessen ArcObjects, die für den Einsatz mit Kartenservices konzipiert wurden, z. B. MapServer, MapLayerInfos und MapDescription. Verwenden Sie die Oberfläche IMapServerDataAccess, um auf Datasets zuzugreifen, die den Layern in Ihrer Karte zugrunde liegen.

Bibliotheken, die nicht unmittelbar mit dem Kartendokument in Beziehung stehen, z. B. ESRI.ArcGIS.Geometry und ESRI.ArcGIS.Geodatabase for .NET oder com.esri.arcgis.geometry und com.esri.arcgis.geodatabase for Java, können immer in Erweiterungen verwendet werden.

ArcGIS Enterprise SDK

Erweiterungen werden nur für Kartenservices unterstützt.

Das ArcGIS Enterprise SDK befindet sich in einem Paket mit einem Kernsatz aus Bibliotheken, um die Entwicklung benutzerdefinierter Erweiterungen zu vereinfachen. Die verfügbaren Klassen und Schnittstellen in diesem SDK wurden für die Verwendung in Erweiterungen gestaltet.

Abfangen von REST-, SOAP- und OGC-Service-Anforderungen

Karten- und Image-Services unterstützen drei Anforderungstypen:

• REST-API-Anforderungen
• SOAP-API-Anforderungen
• OGC-Anforderungen

Die folgenden Schnittstellen müssen implementiert werden, damit ein SOI diese Anforderungen abfangen kann:

• IRESTRequestHandler: Zum Behandeln von REST-API-Anforderungen
• IRequestHandler2 (für ArcObjects SDKs) oder IRequestHandler (für ArcGIS Enterprise SDK): Zum Behandeln von SOAP-API-Anforderungen, einschließlich Anforderungen durch ArcMap und ArcGIS Pro
• IWebRequestHandler: Zum Behandeln von OGC-Anforderungen

Alle oben genannten Schnittstellen müssen auch dann behandelt werden, wenn eine bestimmte Service-Konfiguration keine OGC-Anforderungen unterstützt. Je nach Geschäftslogik, die Sie implementieren, können Sie zwei allgemeine Ansätze nutzen.

Wenn Sie einen SOI implementieren, der Sicherheitsfunktionen ausführt, empfiehlt es sich, zunächst alle oben aufgeführten Schnittstellen zu implementieren und alle Anforderungen zu blockieren. Wenn Sie Ihren benutzerdefinierten Code implementieren, können Sie den Zugriff logisch über die Schnittstellen oben gewähren. Wenn Sie eingehende Anforderungen nicht zuerst blockieren und dann den Zugriff wie gewünscht erlauben, gehen Sie ungewollt ein höheres Sicherheitsrisiko ein.

Wenn Sie keine Sicherheitsfunktionen implementieren, können Sie die drei Schnittstellen implementieren, indem Sie alle Anforderungen über die zugrunde liegende Standardimplementierung übergeben, um normale Funktionen zu erlauben. Fügen Sie anschließend Geschäftslogik zu den Operationen hinzu, die Sie verbessern möchten.

Wenn ein Service mit einem SOI konfiguriert wird, werden alle Service-Anforderungen vom Server-Framework an den SOI weitergeleitet. Der SOI ist dafür zuständig, die Anforderungen zu filtern, die Anforderung an die Karten- oder Image-Service-Objekte (falls zutreffend) zu delegieren und anschließend optional die Antworten zu verarbeiten, bevor sie an den Client zurückgesendet werden.

Implementieren der Zugriffssteuerung auf Layer-Ebene

Wenn Sie die Zugriffssteuerung auf Layer-Ebene über einen SOI implementieren, müssen Sie außerdem den REST-Handler von ArcGIS Server konfigurieren, um das Caching aller im Service enthaltenen Layer-Ressourcen zu deaktivieren. Dadurch können Sie Operationen abfangen und Layer herausfiltern, die nicht zulässig sind. Dies kann deaktiviert werden, indem Sie die Eigenschaft disableCaching des Service im ArcGIS-Server-Administratorverzeichnis auf true festlegen.

1. Öffnen Sie das ArcGIS-Server-Administratorverzeichnis, und melden Sie sich an. Die URL hat oft das Format https://gisserver.domain.com:6443/arcgis/admin.
2. Klicken Sie auf Services und auf den Namen des gewünschten Service. Wenn er nicht in der Liste angezeigt wird, befindet er sich möglicherweise in einem Ordner in diesem Verzeichnis.
3. Klicken Sie auf Bearbeiten.
4. Fügen Sie im Abschnitt properties des Service-JSON die Eigenschaft disableCaching hinzu, und legen Sie deren Wert auf true fest, z. B.:

   "properties": {
     ...
     "disableCaching": "true",
     ...
    },

5. Klicken Sie auf Änderungen speichern.