Utilisation de l'extension d'objet serveur dans des applications client

Vous pouvez utiliser des extensions d'objets serveur (SOE) dans toute application qui peut transmettre une requête HTTP au serveur et analyser la réponse. Les entrées et sorties d'extension d'objets serveur sont des types simples, tels que des nombres, des chaînes de texte et des objets XML et JSON. L'application utilisée ne doit pas nécessairement connaître ArcObjects.

Vous testerez souvent votre extension d'objet serveur dans le répertoire des services (si vous utilisez une extension d'objet serveur REST), puis vous rédigerez du code pour utiliser l'extension d'objet serveur dans votre application client.

Test de votre extension d'objet client dans le répertoire des services

En soumettant des types simples de vos extensions d'objets serveur, vous pouvez tester vos extensions d'objets serveur de services Web REST dans le répertoire des services. Après avoir activé l'extension d'objet serveur sur votre service de carte ou d'imagerie, accédez à la page du service dans le répertoire des services. Au bas de la page, l'extension d'objet serveur figurera dans la liste Extensions prises en charge. (Si ce n'est pas le cas, vérifiez que l'administrateur d'ArcGIS Server a effacé 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 opérations que vous proposez et les examiner. Cliquez sur une opération pour afficher des zones de saisie qui vous permettent de tester les requêtes et réponses des extensions d'objets serveur. Vous devriez recevoir une réponse JSON ou HTML simple.

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

Lorsque vous proposez votre extension d'objet serveur en tant que service Web REST, vous pouvez l'utiliser dans les API mobiles et Web Esri. Quelle que soit l'API que vous utilisez, vous devez effectuer les opérations suivantes avant d'utiliser un service Web d'extension d'objet serveur :

• Soumettre une requête à partir du service Web - Cela implique la création d'une liste de paramètres et l'envoi de l'URL complète au serveur.

• Exploiter la réponse - Pour ce faire, vous devez comprendre le format de la réponse et savoir comment analyser les informations pour les exploiter correctement dans votre application.

Bien que les types de codage soient semblables, les classes qui vous permettent d'utiliser vos extensions d'objets serveur varient en fonction des API.

• Dans ArcGIS API for JavaScript, vous configurez une variable via JSON, laquelle contient tous les paramètres en entrée de votre extension d'objet serveur. La méthode esri.request() vous permet ensuite d'effectuer l'appel à destination du service Web. La réponse est un objet JSON.

• Dans ArcGIS API for Flex, vous développez la classe BaseTask. La propriété url de BaseTask doit désigner l'extension d'objet serveur. Vous pouvez alors utiliser la méthode sendURLVariables de la classe BaseTask pour transmettre la requête au service Web. La réponse est un objet Flex à partir duquel vous pouvez accéder aux divers objets JSON renvoyés dans la réponse.

• Avec ArcGIS API for Silverlight, vous utilisez des extensions d'objets serveur en vous conformant aux pratiques Silverlight standard de transmission de requêtes de service Web et d'utilisation des réponses JSON. Ces points sont expliqués en détails dans les rubriques d'aide Microsoft suivantes :

  • Procédure : exécuter des requêtes auprès des services HTTP (explique comment exécuter des requêtes auprès de l'extension d'objet serveur)

  • Utilisation des données JSON (explique comment utiliser la réponse)

Les SDK des API Web Esri contiennent des exemples de code illustrant les scénarios susmentionnés.