Exemple de service de géotraitement : découper et expédier

Complexité : DébutantConditions requises pour les données ArcGIS Tutorial Data for Desktop

A propos de cet exemple

Dossier	ClipAndShip
Objectif	A l'aide d'un polygone numérisé par l'utilisateur, ce service découpe des couches de la zone d'étude en géodatabase fichier, puis crée un fichier .zip téléchargeable par l'utilisateur.
Services	Zion (Service de carte), ExtractZionData (Service de géotraitement)
Tâches de géotraitement	ExtractZionData
Entrée(s)	Couches à découper, Zone d'intérêt, Format d'entité, Format de raster
Sorties	Fichier ZIP contenant les données.
Data	L'exemple utilise plusieurs jeux de données de la zone d'étude (parc national de Zion dans l'Utah).
Extensions	Aucun
A remarquer	Crée output.zip, un fichier compressé contenant un fichier au format spécifié. Ce fichier imite la disposition des couches dans le document ArcMap qui est publié en tant que service de géotraitement.

Dossier correspondant

Les données de cet exemple peuvent être téléchargées depuis ArcGIS.com. Extrayez le fichier zip téléchargé dans C:\arcgis\ArcTutor\. Le dossier GP Service Examples\ClipAndShip contient l'intégralité des modèles et des données.

A propos de cet exemple

Cet exemple présente les étapes nécessaires au partage et à l'utilisation d'une carte et d'un service de géotraitement. Le modèle ExtractZionData utilisé dans le service est dérivé de l'outil de modèle Tâche Exporter les données. Cette tâche de géotraitement permet au client de sélectionner les couches qu'il souhaite renvoyer, de numériser un polygone (ou plusieurs polygones) permettant de définir la zone d'intérêt et de sélectionner le format de données raster et le format d'entité en sortie. Les données de la carte sont découpées selon la zone d'intérêt, puis regroupées sous la forme d'un fichier ZIP prêt à être envoyé au client.

Data

La zone d’étude de cet exemple est le parc national de Zion. Ces données incluent une zone de recherche, une limite, des secteurs, des routes, des parcours, des sources, des cours d'eau et un raster d'ombrage de la zone d'étude. Les données se trouvent dans C:\arcgis\ArcTutor\GP Service Examples\ClipAndShip\ToolData\Zion.gdb.

Etablissement d'une connexion Gestion au serveur autorisant la publication

Assurez-vous que vous disposez de l'autorisation de publier sur le serveur. Si tel est le cas, suivez ces étapes pour créer, publier ou gérer une connexion à un serveur :

1. Accédez à Serveurs SIG > Ajouter un site ArcGIS Server pour ouvrir la boîte de dialogue ArcGIS Server.
2. Cochez la case Publier les services GIS ou Administrer le serveur GIS.
3. Dans le panneau Général, saisissez une URL d'administration du serveur, ainsi qu'un Nom d’utilisateur et un Mot de passe.
4. Cliquez sur Terminer pour finaliser la connexion.

Partage d'un service de carte

Pour créer un service de carte que les utilisateurs de votre service pourront utiliser comme carte de référence, conformez-vous aux étapes suivantes :

1. Dans la fenêtre Catalogue, accédez à C:\arcgis\ArcTutor\GP Service Examples. Copiez le dossier ClipAndShip depuis C:\arcgis\ArcTutor\GP Service Examples dans un répertoire local.
2. Dans le répertoire local dans lequel vous avez enregistré le dossier ClipAndShip, ouvrez le fichier Zion.mxd.
3. Dans la barre de menu ArcMap, sélectionnez Fichier > Partager en tant que > Service. L'assistant Partager en tant que service s'ouvre.
4. Dans le premier panneau de l'assistant Partager en tant que service, sélectionnez Publier un service, puis cliquez sur Suivant.
5. Dans la liste déroulante Choisir une connexion, sélectionnez le nom du serveur auquel vous vous êtes connecté précédemment. La valeur par défaut du Nom du service est Zion (le nom de la carte). Vous pouvez accepter la valeur par défaut ou saisir un nouveau nom.
6. Dans le panneau suivant, indiquez un dossier de service ou acceptez la valeur par défaut [racine], puis cliquez sur Continuer. Le Service Editor s'ouvre.
7. Dans l'Editeur de services, cliquez sur l'onglet Fonctionnalités. Par défaut, les fonctions Cartographie et KML sont activées. La fonctionnalité KML n'étant pas nécessaire pour ce service, désactivez la case KML.
8. Dans l'Editeur de services, cliquez sur l'onglet Description d'élément et saisissez le Résumé et les Balises (qui sont obligatoires).
9. Cliquez sur le bouton Analyser en haut à droite de la fenêtre Editeur de services. La fenêtre Préparation s'ouvre.
10. Si la fenêtre Préparation contient des messages d'erreur ou d'avertissement, corrigez-les en cliquant avec le bouton droit sur la ligne du message d'erreur ou d'avertissement, puis en cliquant sur le message en surbrillance.
11. Une fois les erreurs résolues, cliquez sur le bouton Publier en haut à droite de la fenêtre Editeur de services. Un message vous informe du succès de l'opération, une fois la publication terminée.

Le service de carte Zion a été publié et est prêt à l'emploi.

Partage d'un service de géotraitement

Vous devez exécuter l'outil pour créer un résultat pour partager l'outil en tant que service. Pour exécuter cet outil :
1. Dans le répertoire local dans lequel vous avez enregistré le dossier ClipAndShip, ouvrez le fichier ClipAndShip.mxd.
2. Dans la fenêtre Catalogue, cliquez sur le bouton Aller au dossier d'accueil . Développez ExtractZion.tbx et cliquez deux fois sur l'outil de modèle ExtractZionData pour ouvrir sa boîte de dialogue.
3. Pour le paramètre Couches à découper, définissez les couches auxquelles les utilisateurs peuvent accéder dans le service.

   

4. Pour le paramètre Zone d'intérêt, cliquez sur le symbole Area_of_Interest comme illustré ci-dessus et numérisez un polygone sur la carte.
5. Vous pouvez accepter les valeurs par défaut de tous les autres paramètres.
6. Cliquez sur OK pour exécuter l'outil.

   Lorsque l'exécution de l'outil est terminée, un nouveau résultat s'inscrit dans la fenêtre Résultats. Pour ouvrir la fenêtre Résultats, sélectionnez Géotraitement > Résultats dans le menu principal ArcMap.

7. Vérifiez que l'outil s'est exécuté avec succès en examinant le résultat dans la fenêtre Résultats. L'échec d'une exécution entraîne l'affichage d'une icône d'erreur en regard du résultat.

Pour créer un service de géotraitement, vous devez partager un résultat.
1. Dans la fenêtre Résultats, cliquez avec le bouton droit sur le résultat ExtractZionData et sélectionnez Partager en tant que > Service de géotraitement. L'assistant Partager en tant que service s'ouvre.
2. Sélectionnez le serveur auquel vous vous êtes connecté précédemment et publiez le service dans le même dossier que celui du service de carte que vous aviez créé. Le nom par défaut du service est identique au nom de l'outil, ExtractZionData. Vous pouvez accepter ce nom par défaut ou en saisir un nouveau.
3. Dans le dernier panneau de l'assistant Partager en tant que service, cliquez sur Continuer pour ouvrir l'Editeur de services.
Vous pouvez accepter toutes les valeurs par défaut du service de géotraitement et cliquer sur le bouton Publier pour publier le service.
Reportez-vous à la rubrique Présentation rapide de la publication d'un service de géotraitement pour plus d'informations sur la façon d'utiliser l'Editeur de services pour publier un service de géotraitement.
Dans l'Editeur de services vous pouvez affiner la liste des couches qu'un client peut choisir. Cliquez sur l'onglet Couches à découper pour afficher la liste des couches qu'un client peut extraire. Vous pouvez désélectionner les couches que vous ne voulez pas proposer aux clients.

Avec

Les étapes suivantes indiquent comment utiliser la carte et les services de géotraitement que vous avez précédemment publiés.

1. Ouvrez un nouveau document ArcMap.
2. dans la fenêtre Catalogue.
   1. Accédez à votre connexion au serveur sous Serveurs SIG, sélectionnez le service de carte Zion et faites-le glisser dans la table des matières d'ArcMap.
   2. Développez le service de carte Zion dans la table des matières pour afficher toutes les couches qui appartiennent au service de carte Zion.
3. Dans la fenêtre Catalogue, accédez à votre connexion au serveur sous Serveurs SIG, recherchez le service de géotraitement que vous avez publié dans une section précédente et développez-le. La tâche ExtractZionData s'affiche.
4. Cliquez deux fois sur la tâche ExtractZionData pour ouvrir la boîte de dialogue de la tâche.
5. La boîte de dialogue ExtractZionData contient le paramètre Couches à découper comme illustré ci-dessous. Notez que le nom des couches dans la case à cocher correspond à celui des couches du service de carte Zion dans la table des matières. Cochez la case à côté en regard de chaque couche que vous voulez inclure dans le téléchargement.



6. Le paramètre Zone d'intérêt permet de numériser une zone d'intérêt qui sera utilisée pour découper chacune des couches sélectionnée dans le paramètre Couches à découper. Cliquez sur le symbole Area_of_Interest, puis numérisez un polygone sur la carte.
7. Vous pouvez modifier d'autres paramètres Format d'entité et Format de raster ou les laisser comme valeurs par défaut.
8. Cliquez sur OK pour exécuter la tâche de géotraitement.

   Le serveur renvoie la sortie qui est écrite à l'emplacement défini dans l'environnement de l'espace de travail temporaire de géotraitement.

Lorsque la tâche est terminée, ouvrez la fenêtre Résultats pour afficher les résultats de la tâche. Cliquez deux fois sur output.zip pour ouvrir le fichier compressé, puis extrayez les données à un emplacement de votre choix.

Personnalisation du modèle source du service de géotraitement

L'exemple précédent utilise l'outil de modèle Tâche Exporter les données contenue dans la boîte à outils Server. Ce modèle sert uniquement à définir les paramètres pour l'outil Extraire les données. Si vous copiez l'outil de modèle vers une nouvelle boîte à outils personnalisée, vous pouvez l'ouvrir et le modifier dans ModelBuilder. Le modèle Tâche Exporter les données contient les variables en entrée Référence spatiale et Dossier de références spatiales personnalisées, qui ne sont pas exposées en tant que paramètres de modèle. La référence spatiale possède une valeur par défaut, (Identique à l'entrée), qui indique que la référence spatiale des fichiers en sortie est la même que celle des couches en entrée. Pour obtenir une référence spatiale des fichiers en sortie qui soit différente de celle des fichiers en entrée, vous pouvez définir Référence spatiale en tant que paramètre en entrée. Lorsque vous ouvrez la boîte de dialogue de l'outil de modèle, vous pouvez alors spécifier une autre référence spatiale. La variable Dossier de références spatiales personnalisées est un paramètre facultatif qui vous permet de spécifier un chemin d'accès au dossier qui contient la référence spatiale personnalisée et/ou standard.

Vous pouvez non seulement modifier ces deux variables Référence spatiale, mais aussi le paramètre Format d'entité de manière à inclure les autres formats dont vous avez besoin.

La procédure ci-dessous explique comment personnaliser le modèle Tâche Exporter les données en exposant la variable Référence spatiale en tant que paramètre, en ajoutant un chemin d'accès au dossier des références spatiales personnalisées et en ajoutant de nouveaux formats en sortie pour le paramètre Format d'entité.

Remarque :

Une boîte à outils nommée CustomSPRef.tbx qui contient un modèle ExtractZionSPRef personnalisé se trouve à l'emplacement C:\arcgis\ArcTutor\GP Service Examples\ClipAndShip. La boîte à outils et le modèle correspondent au produit fini une fois la procédure suivante terminée.

1. La première étape consiste à créer une nouvelle boîte à outils et un nouveau modèle. Dans la fenêtre Catalogue, copiez le dossier ClipAndShip depuis C:\arcgis\ArcTutor\GP Service Examples vers un répertoire local.
   1. Dans le répertoire local dans lequel vous copiez les données et le modèle, ouvrez le fichier ClipAndShip.mxd.
   2. Dans la fenêtre Catalogue, cliquez sur le bouton Aller au dossier d'accueil . Supprimez la boîte à outils CustomSPRef.tbx et le dossier SpatialReference.
   3. Cliquez avec le bouton droit sur le dossier Accueil et sélectionnez Nouvelle > Boîte à outils.
   4. Renommez la boîte à outils en CustomSPRef.
2. dans la fenêtre Catalogue.
   1. Développez Boîtes à outils > Boîtes à outils système > Outils de serveur.tbx > Exportation de données.
   2. Avec le bouton droit, cliquez sur Tâche Exporter les données, puis sélectionnez Copier.
   3. Cliquez avec le bouton droit sur la boîte à outils CustomSPRef.tbx que vous avez créée plus haut et sélectionnez Coller.

      Le modèle Tâche Exporter les données est copié dans la boîte à outils.

   4. Cliquez avec le bouton droit sur le modèle que vous avec copié et sélectionnez Renommer, puis renommez le modèle en ExtractZionSPRef.
3. Cliquez avec le bouton droit sur le modèle ExtractZionSPRef et sélectionnez Modifier pour ouvrir ce modèle dans ModelBuilder. Dans le modèle, cliquez avec le bouton droit sur la variable Référence spatiale, puis sélectionnez Paramètre du modèle. La lettre P s'affiche dans l'angle supérieur droit de la variable pour indiquer qu'il s'agit d'un paramètre de modèle.

   

4. Créez un dossier de références spatiales personnalisées ainsi qu'un fichier de projection. Enregistrez le fichier de projection dans le dossier.
   1. Dans la fenêtre Catalogue, avec le bouton droit cliquez sur le dossier Accueil. Créez un nouveau dossier en cliquant avec le bouton droit sur le dossier et en sélectionnant Nouveau > Dossier.
   2. Renommez le nouveau dossier en SpatialReference.
   3. Depuis le dossier Accueil, accédez à ToolData/Zion.gdb. Cliquez avec le bouton droit sur une classe d'entités de la géodatabase, puis sélectionnez Propriétés pour ouvrir la boîte de dialogue Propriétés. Cliquez sur l'onglet Système de coordonnées XY.
   4. Développez le Système de coordonnées projetées/State Plane/NAD 1983 (US Feet). Faites défiler la liste jusqu'à ce que vous trouviez le libellé NAD 1983 StatePlane Utah South FIPS 4303 (US Feet).
   5. Avec le bouton droit cliquez sur NAD 1983 StatePlane Utah South FIPS 4303 (US Feet) et sélectionnez Enregistrer sous.
   6. Enregistrez le fichier de projection dans le nouveau dossier, SpatialReference. Enregistrez le fichier avec son nom par défaut NAD 1983 StatePlane Utah South FIPS 4303 (US Feet).prj.
5. Dans le dossier Accueil, développez la boîte à outils CustomSPRef.tbx, cliquez avec le bouton droit sur le modèle ExtractZionSPRef et sélectionnez Modifier. Double-cliquez sur la variable Dossier des références spatiales personnalisées, saisissez le chemin d'accès au nouveau dossier SpatialReference que vous avez créé plus haut, puis cliquez sur OK. Le modèle qui s'affiche doit ressembler à celui illustré ci-dessus.
6. Avec le modèle ExtractZionSPRef toujours ouvert dans ModelBuilder
   1. Accédez au menu Modèle, > à Propriétés, > puis à l'onglet Paramètres

      Le paramètre Référence spatiale s'affiche en bas de la liste des paramètres.

   2. Réorganisez les paramètres de telle sorte que le paramètre Fichier Zip en sortie soit le dernier paramètre. Sélectionnez le fichier Zip en sortie et cliquez sur le bouton Bas pour le déplacer vers le bas de la liste.



7. Toujours dans l'onglet Paramètres
   1. Sélectionnez la variable Référence spatiale, puis modifiez la valeur Filtre en Liste de valeurs.
   2. Saisissez les valeurs Identique à l'entrée et NAD 1983 StatePlane Utah South FIPS 4303 (US Feet) dans la liste de valeurs. Vérifiez que vous n'avez pas fait d'erreur dans la saisie de ces valeurs. NAD 1983 StatePlane Utah South FIPS 4303 (US Feet) est utilisé par l'outil pour rechercher le fichier .prj que vous avez enregistré.
   3. Cliquez sur OK pour fermer la boîte de dialogue Liste de valeurs.
   4. Cliquez sur OK pour fermer la boîte de dialogue Propriétés du modèle.
   5. Enregistrez le modèle et quittez ModelBuilder.
Le paramètre Format d'entité peut aussi être personnalisé en ajoutant d'autres types de données à la liste de formats.
En savoir plus sur les différents formats de données pris en charge par l'extension Data Interoperability.
8. Enregistrez le modèle personnalisé.
9. Exécutez le modèle personnalisé sur le bureau. Lors de l'exécution du modèle, choisissez NAD 1983 StatePlane Utah South FIPS 4303 (US Feet) dans la liste déroulante des paramètres Référence spatiale.
10. Reportez-vous aux procédures des sections Publication et Utilisation ci-dessus pour publier et utiliser le modèle personnalisé en tant que service de géotraitement.