Puede usar extensiones de objeto de servidor (SOE) en cualquier aplicación que pueda realizar una solicitud HTTP al servidor y analizar la respuesta. Las entradas y salidas de SOE son tipos simples, como números, cadenas de texto y objetos XML y JSON. La aplicación que utiliza no necesita tener ningún conocimiento de las API utilizadas para implementar las SOE. Necesita preparar las entradas para enviarlas a la SOE y analizar y comprender las salidas devueltas por la SOE.
A menudo, probará su SOE en el Directorio de servicios REST de ArcGIS (suponiendo que esté utilizando una SOE REST) y, a continuación, escribirá código para consumir la SOE en su aplicación cliente.
Probar la SOE en el Directorio de Servicios
El hecho de que envíe tipos simples a sus SOE le permite probar sus SOE de servicio web REST en el Directorio de servicios. Después de habilitar las SOE en su servicio de mapas, vaya a la página del servicio en el Directorio de servicios. En la parte inferior de la página, verá la lista de SOE en Extensiones admitidas. (Si no la ve, verifique que el administrador de ArcGIS Server haya borrado la caché REST).
Si hace clic en la SOE en el Directorio de servicios, podrá hacer clic y explorar los recursos y las operaciones expuestos. Haga clic en una operación y verá algunos cuadros de entrada que puede usar para probar las solicitudes y respuestas de SOE. Debería obtener una respuesta JSON o HTML simple.
Usar la SOE en una aplicación cliente
Cuando expone su SOE como un servicio web REST, puede consumirlo en las API móviles y web de Esri. Independientemente de la API que utilice, trabajar con su servicio web SOE requiere lo siguiente:
-
Realizar una solicitud desde el servicio web: implica crear una lista de parámetros y enviar la URL completa al servidor
-
Hacer algo con la respuesta: requiere comprender el formato de la respuesta y saber cómo analizar la información para hacer algo útil en su aplicación
Aunque los patrones de codificación son similares, las clases que utiliza para trabajar con las SOE varían en el ArcGIS API for JavaScript. Por ejemplo, en la API configure una variable usando JSON con todos los parámetros de entrada para su SOE. A continuación, utilice el método esri.request() para realizar la llamada al servicio web. La respuesta es un objeto JSON.