Utilisation d’une extension d’objet serveur dans des applications client

Vous pouvez utiliser des extensions d’objet serveur dans toute application pouvant envoyer une demande HTTP au serveur et analyser la réponse. Les entrées et les sorties des extensions d’objet serveur sont des types simples, tels que des nombres, des chaînes de texte et des objets XML et JSON. Il n’est pas nécessaire que l’application consommatrice comprenne les API utilisées pour implémenter les extensions d’objet serveur. Celle-ci doit préparer les entrées à envoyer à l’extension d’objet serveur et analyser et comprendre les sorties renvoyées par l’extension d’objet serveur.

Vous testerez souvent votre extension d’objet serveur dans le répertoire des services ArcGIS REST (si vous utilisez une extension d’objet serveur REST), puis écrirez un code pour consommer l’extension d’objet serveur dans votre application client.

Test de votre extension d’objet serveur dans le répertoire des services

La soumission de types simples à votre extension d’objet serveur vous permet de tester vos extensions d’objet serveur de service Web REST dans le répertoire des services. Après avoir activé l’extension d’objet serveur dans votre service de carte, accédez à la page du service dans le répertoire des services. L’extension d’objet serveur est répertoriée au bas de la page sous Supported Extensions (Extensions prises en charge). (Si vous ne la voyez pas, vérifiez que l’administrateur de ArcGIS Server a nettoyé le cache REST.)

Si vous cliquez sur l’extension d’objet serveur dans le répertoire des services, vous pourrez cliquer sur les ressources et les opérations que vous avez exposées et les explorer. Cliquez sur une opération pour afficher certaines zones de saisie que vous pouvez utiliser pour tester les demandes et les réponses de l’extension d’objet serveur. Vous devez obtenir une réponse JSON ou HTML simple.

Utilisation de votre extension d’objet serveur dans une application client

Lorsque vous exposez votre extension d’objet serveur en tant que service Web REST, vous ne pouvez pas l’utiliser dans les API Web et Mobile d’Esri. Quelle que soit l’API que vous utilisez, pour utiliser votre service Web d’extension d’objet serveur, vos devez :

• Effectuer une demande à partir du service Web : implique l’établissement d’une liste de paramètres et l’envoi de l’URL complète au serveur

• Traiter la réponse : requiert de comprendre le format de la réponse et de savoir analyser les informations pour en faire quelque chose d’utile dans votre application.

Bien que les modèles de codage soient similaires, les classes que vous utilisez avec les extensions d’objet serveur varient dans ArcGIS API for JavaScript. Par exemple, dans l’API, vous configurez une variable au format JSON, qui contient tous les paramètres en entrée pour votre extension d’objet serveur. Ensuite, vous utilisez la méthode esri.request() pour appeler le service Web. La réponse est un objet JSON.