Didacticiel : Publication d'un service WPS

Complexité : Débutant Exigences en matière de données : Utiliser vos propres données Objectif : Publier un service WPS sur ArcGIS Server et l'utiliser dans un navigateur Web.

La spécification WPS (Web Processing Service) de l'OGC (Open Geospatial Consortium, Inc.) est une spécification internationale de diffusion et d'exécution de traitement géospatial sur le Web. Lorsqu'un service de géotraitement est publié avec fonctionnalité WPS, tout client prenant en charge WPS peut accéder aux données. Si vous ne connaissez pas WPS et souhaitez en savoir plus avant d'entreprendre ce didacticiel, reportez-vous à la rubrique Services WPS.

Ce didacticiel vous guide à travers le processus de publication sur ArcGIS Server d'un service de géotraitement accessible par les clients WPS. Pour ce faire, vous devez préparer un outil dans ArcGIS for Desktop, exécuter cet outil et obtenir un résultat satisfaisant, avant de publier le résultat du géotraitement avec la fonctionnalité WPS activée.

Avant de commencer ce didacticiel

Si vous venez d'installer ArcGIS Server, vous devez réaliser certaines étapes préparatoires avant de pouvoir vous connecter au serveur dans ArcMap et publier des services.

• Pour plus d'informations sur la façon de configurer le site ArcGIS Server, consultez la rubrique Démarrage après l'installation du système d'aide.
• Pour savoir comment mettre à disposition du serveur les données référencées par la ressource GIS, consultez la rubrique Rendre vos données accessibles à ArcGIS Server.

Préparation de l'outil de géotraitement dans ArcGIS for Desktop

Un service de géotraitement comporte une ou plusieurs tâches. Une tâche n'est pas vraiment différente d'un outil de géotraitement, car elle accepte des paramètres et renvoie des résultats ; il s'agit en fait d'un terme utilisé par les clients d'ArcGIS Server pour décrire les routines qui exécutent un travail sur le serveur et renvoient les résultats. Par exemple, vous pouvez créer un outil de géotraitement qui délimite les bassins versants en fonction des données d'utilisation du sol et d'altitude. Cet outil peut ensuite être publié avec la fonctionnalité WPS activée et être utilisé en tant que tâche dans une application Web conforme à la spécification WPS.

La rubrique Création de tâches de géotraiement avec ModelBuilder vous guidera dans les éléments à considérer lors de la création d'un outil de géotraitement. Lorsque votre outil de géotraitement est prêt, passez à la section suivante.

Exécution de l'outil

Avant de pouvoir publier, vous devez exécuter l'outil et obtenir un résultat de géotraitement adéquat dans la fenêtre Résultats. Pour cela, procédez comme suit :

Etapes :

1. Dans l'arborescence du Catalogue, double-cliquez sur le dossier l'outil de géotraitement.
2. Saisissez les variables appropriées et cliquez sur OK.

   Lorsque l'outil est exécuté avec succès, la fenêtre Résultats apparaît.

Publication du résultat

Lorsque la fenêtre Résultats affiche un résultat de géotraitement adéquat, vous pouvez publier votre outil de géotraitement en tant que service de géotraitement. Dans cette procédure, vous activez la fonctionnalité WPS, qui assure la conformité de votre service de géotraitement (et des tâches subséquentes) à la spécification WPS de l'OGC.

Etapes :

1. Cliquez avec le bouton droit sur le résultat du géotraitement et sélectionnez Partager en tant que > Service de géotraitement.
2. Dans la fenêtre Partager en tant que service, sélectionnez Publier un service. Cliquez sur Suivant.
3. Dans la boîte de dialogue Publier un service, cliquez sur Connecter à ArcGIS Server pour créer une connexion au serveur.
4. Dans la fenêtre Ajouter un serveur ArcGIS, sélectionnez Publier les services SIG. Cliquez sur Suivant.
5. Pour l'URL du serveur, saisissez l'URL du site ArcGIS Server auquel vous souhaitez vous connecter. Par exemple : http://gisserver.domain.com:6080/arcgis.
6. Dans la liste déroulante Type de serveur, sélectionnez ArcGIS for Server.
7. Au cours du processus de publication, un fichier de définition de service est créé et stocké temporairement sur un disque local. A l'issue du processus, la définition de service est chargée sur le serveur et le fichier local est supprimé. Dans le cadre de ce didacticiel, acceptez le dossier par défaut et poursuivez.
8. Si votre administrateur de serveur a activé la sécurité de votre site, entrez vos Nom d'utilisateur et Mot de passe. Cliquez sur Terminer.
9. Facultativement, dans la fenêtre Publier un service, entrez un nouveau nom pour le service. Le nom ne doit pas dépasser 120 caractères et ne peut contenir que des caractères alphanumériques et des traits de soulignement. Cliquez sur Suivant.
10. Par défaut, les services sont publiés sur le dossier racine (racine) d'ArcGIS Server. Les services peuvent être organisés dans des sous-dossiers du dossier racine. Choisissez le dossier où vous souhaitez publier le service, ou créez un dossier pour contenir le service. Cliquez sur Continuer.
11. L'Editeur de services s'affiche. Dans l'Editeur de services, sélectionnez les opérations que les utilisateurs peuvent effectuer avec le service de géotraitement. Vous pouvez contrôler en détails la manière dont le serveur exposera votre service de géotraitement. Cliquez sur l'onglet Fonctionnalités.
12. Le géotraitement est activé par défaut. Sélectionnez WPS.
13. Dans le volet gauche de l'Editeur de services, cliquez sur WPS. Ce volet vous permet de sélectionner la configuration des propriétés de votre service WPS. En définissant les propriétés du service WPS, les clients comprennent mieux le publicateur de service.
    • Le champ URL présente l'URL utilisée par les clients pour accéder au service WPS. L'URL utilise le format http://gisserver.domain.com:6080/arcgis/services/folder/service/GPServer/WPSServer.
      Remarque :

      Copiez et enregistrez l'URL du service WPS. Vous en aurez besoin à d'autres étapes de ce didacticiel.

    • Pour configurer un service WPS avec les fichiers de fonctionnalités générés par le système, utilisez l'option par défaut Saisir les propriétés du service ci-dessous. Les champs Nom, Titre et Ressources en ligne sont renseignés automatiquement et ne doivent pas être modifiés. Facultativement, vous pouvez renseigner d'autres propriétés à l'aide des champs de la liste. Pour plus d'informations, reportez-vous à la rubrique Propriétés du service WPS disponible.
    • Pour configurer un service WPS et utiliser des fichiers de fonctionnalités externes, sélectionnez Utiliser les fichiers de fonctionnalités externes. Pour utiliser cette option, vous devez avoir déjà créé un fichier de fonctionnalités WPS.
    • Espace de noms et Préfixe sont les seules propriétés qui permettent de distinguer vos processus WPS des autres processus WPS. Elles sont renseignées automatiquement et ne doivent pas être modifiées.
    Astuce:

    Pour connaître les astuces et les pratiques conseillées concernant la définition des propriétés de service de géotraitement à l'aide de l'Editeur de services, reportez-vous à la rubrique Paramètres du service de géotraitement. Pour plus d'informations sur comment configurer au mieux vos services pour le déploiement, reportez-vous à la rubrique Optimisation et configuration des services.

14. Cliquez sur Analyse . Cette fonction examine votre résultat pour voir s'il peut être publié sur le serveur en tant que service WPS.
    Astuce:

    Pour disposer d'une surface d'affichage plus grande lors de la configuration du service WPS, cliquez sur Réduire en haut du Editeur de services.

15. Le cas échéant, corrigez les erreurs dans la fenêtre Préparation avant de pouvoir publier votre résultat en tant que service WPS. Vous pouvez éventuellement traiter les avertissements et les messages informationnels pour améliorer davantage la performance et l'apparence de votre service. Pour plus d'informations sur la résolution de ces problèmes, reportez-vous à la rubrique Analyse de votre ressource SIG.
    Remarque :

    Vous pouvez enregistrer les dossiers et les géodatabases sur votre site ArcGIS Server et ainsi vous assurer que le serveur puisse reconnaître et utiliser vos données. Si vous effectuez les étapes suivantes, toutes les données référencées par votre outil qui proviennent d'un dossier ou d'une géodatabase non enregistré seront copiées sur le serveur au moment de la publication. Il s'agit d'une mesure de précaution visant à s'assurer que le serveur peut accéder à toutes les données utilisées par le service. Pour obtenir les instructions complètes d'inscription d'un dossier ou d'une géodatabase auprès de votre site ArcGIS Server, reportez-vous à la rubrique Inscription de vos données auprès d'ArcGIS Server à l'aide d'ArcGIS for Desktop.

16. Facultativement, dans l'Editeur de services, cliquez sur Aperçu . Cela peut vous donner une idée de l'apparence de la boîte de dialogue de votre outil sur le Web.
17. Après avoir corrigé les erreurs dans votre modèle de géotraitement, cliquez sur Publier .

Utilisation du service WPS

Une fois que vous avez publié un service WPS, il peut être utilisé dans n'importe quel client prenant en charge WPS 1.0.0. Un navigateur Web constitue l'un des clients les plus simples d'un service WPS. Vous pouvez demander des informations via HTTP ; les réponses ou exceptions sont renvoyées via le navigateur.

Suivez les étapes ci-dessous pour accéder aux services WPS par l'intermédiaire d'un navigateur Web.

Etapes :

1. Ouvrez un navigateur Web.
2. Effectuez les opérations GetCapabilities et DescribeProcess selon les instructions des sections suivantes.

GetCapabilities

Cette demande renvoie tous les processus et métadonnées disponibles par l'intermédiaire du service au format GML. Pour utiliser l'opération GetCapabilities, copiez et collez l'URL du service WPS dans la barre d'adresse et ajoutez ?SERVICE=WPS&VERSION=1.0.0&REQUEST=GetCapabilities à la fin de l'URL.

Exemple d'URL : http://gisserver.domain.com:6080/arcgis/services/my_wps/GPServer/WPSServer?SERVICE=WPS&VERSION=1.0.0&REQUEST=GetCapabilities

DescribeProcess

La réponse à une demande DescribeProcess contient des informations détaillées concernant un processus particulier, telles que l'identifiant unique du processus et l'identifiant, le type et la structure de chaque paramètre obligatoire ou facultatif en entrée ou en sortie pour le processus. Les clients WPS ont besoin de cette information pour envoyer des demandes subséquentes d'exécution du traitement géospatial réel. Pour utiliser l'opération DescribeProcess, copiez et collez l'URL du service WPS dans la barre d'adresse et ajoutez ?SERVICE=WPS&VERSION=1.0.0&REQUEST=DescribeProcess à la fin de l'URL.

Exemple d'URL : http://gisserver.domain.com:6080/arcgis/services/my_wps/GPServer/WPSServer?SERVICE=WPS&VERSION=1.0.0&REQUEST=DescribeProcess&Identifier=output_feature_layer

Exécution d'un processus de service WPS

Pour effectuer le traitement géospatial sur le Web, vous pouvez envoyer une demande Exécuter au service WPS par l'intermédiaire d'un client WPS. Une demande Exécuter contient généralement la valeur ou la référence de chaque paramètre en entrée ou en sortie du processus WPS et précise en outre comment le service WPS doit renvoyer le résultat du processus. La réponse à une demande d'exécution contient le résultat intégré du traitement spatial ; elle peut être configurée pour renvoyer les résultats des travaux récents de traitement spatial.

Les opérations d'exécution sont généralement appelées au moyen d'une requête HTTP Post dans le client WPS. Voici un exemple de demande d'exécution :

<wps:Execute xmlns:wps="http://www.opengis.net/wps/1.0.0" service="WPS" version="1.0.0" language="en-US">
   <ows:Identifier xmlns:ows="http://www.opengis.net/ows/1.1">SampleProcessId</ows:Identifier>
   <wps:DataInputs>
      <wps:Input>
         <ows:Identifier xmlns:ows="http://www.opengis.net/ows/1.1">Input_String</ows:Identifier>
         <wps:Data>
            <wps:LiteralData dataType="xs:string">abcdefg</wps:LiteralData>
         </wps:Data>
      </wps:Input>
   </wps:DataInputs>
   <wps:ResponseForm>
      <wps:ResponseDocument storeExecuteResponse="true" lineage="true" status="false">
         <wps:Output schema="http://www.w3.org/TR/xmlschema-2/#string" asReference="false">
            <ows:Identifier xmlns:ows="http://www.opengis.net/ows/1.1">Output_String</ows:Identifier>
         </wps:Output>
      </wps:ResponseDocument>
   </wps:ResponseForm>
</wps:Execute>

Pour en savoir plus sur les demandes WPS et les paramètres connexes, consultez la page sur la spécification WPS 1.0.0 de l'OGC. Esri propose également une page Web relative à l'interopérabilité et aux normes, qui détaille sa prise en charge des services OGC dans ArcGIS.