Sie können Serverobjekterweiterungen (SOEs) in jeder Anwendung verwenden, die eine HTTP-Anforderung an den Server senden und die Antwort parsen kann. Bei den Ein- und Ausgaben von SOEs handelt es sich um einfache Typen, wie z. B. Zahlen, Zeichenfolgen sowie XML- und JSON-Objekte. Die konsumierende Anwendung benötigt keine Kenntnis der APIs, mit denen die SOEs implementiert wurden. Sie muss die an die SOE zu sendenden Eingaben vorbereiten und die von der SOE zurückgegebenen Ausgaben parsen und verstehen.
Die SOE wird häufig im ArcGIS REST-Services-Verzeichnis getestet (sofern Sie eine REST-SOE verwenden) und anschließend Code erstellt, um die SOE in der Client-Anwendung zu konsumieren.
Testen der SOE im Services-Verzeichnis
Da Sie einfache Typen an die SOEs übermitteln, können Sie Ihre REST-Web-Service-SOEs im Services-Verzeichnis testen. Navigieren Sie, nachdem Sie die SOE für Ihren Kartenservice aktiviert haben, auf die Seite des Service im Services-Verzeichnis. Die SOE ist unten auf der Seite unter "Unterstützte Erweiterungen" aufgeführt. (Wenn Sie sie nicht finden, vergewissern Sie sich, dass der REST-Cache vom ArcGIS Server-Administrator gelöscht wurde.)
Wenn Sie im Services-Verzeichnis auf die SOE klicken, können Sie auf die von Ihnen bereitgestellten Ressourcen und Operationen klicken und sie erkunden. Klicken Sie auf eine Operation, woraufhin verschiedene Eingabefelder angezeigt werden, die Sie zum Testen der SOE-Anforderungen und -Antworten verwenden können. Sie sollten eine einfache JSON- oder HTML-Antwort zurückerhalten.
Verwenden der SOE in einer Client-Anwendung
Wenn Sie Ihre SOE als REST-Web-Service bereitstellen, können Sie sie in den Web- und Mobil-APIs von Esri konsumieren. Unabhängig davon, welche API Sie verwenden, gelten für die Arbeit mit Ihrem SOE-Web-Service die folgenden Anforderungen:
-
Senden einer Anforderung an den Web-Service: Beinhaltet das Erstellen einer Parameter-Liste und Senden der vollständigen URL an den Server
-
Verarbeiten der Antwort: Erfordert das Verständnis des Antwortformats und Kenntnis darüber, wie die Informationen geparst werden müssen, um in Ihrer Anwendung nutzbringend verwendet werden zu können
Obwohl sich die Codierungsmuster ähneln, unterscheiden sich die Klassen, die Sie für die Arbeit mit SOEs verwenden, in der ArcGIS API for JavaScript. Beispielsweise erstellen Sie in der API mithilfe von JSON eine Variable, die alle Eingabeparameter für Ihre SOE enthält. Anschließend verwenden Sie die Methode esri.request(), um den Web-Service aufzurufen. Die Antwort ist ein JSON-Objekt.