Service de géotraitement pas à pas : bufferisation de points

Complexité : Débutant Conditions requises pour les données ArcGIS Tutorial Data Setup

Dossier	BufferPoints
Objet	Crée des polygones autour des points.
Services	BufferService (service de géotraitement)
Tâches de géotraitement	Bufferiser des points
Entrées	L'utilisateur numérise un point.
Sorties	Polygone
Données	Aucune
Extensions	Aucune
A remarquer	Parmi tous les exemples, il s'agit du service le plus élémentaire.

A propos de cet exemple

Dossier correspondant

Les données se trouvent à l'emplacement suivant : C:\arcgis\ArcTutor\GP Service Examples\BufferPoints. Après avoir complété toutes les étapes décrites ci-dessous, le contenu de ce dossier sera reproduit.

Préparation des données

Créez un dossier Toolshare

Etapes :

1. Lancez ArcCatalog.
2. Créez un dossier (BufferPts) à l'emplacement de votre choix, en procédant comme suit :
   1. Accédez à un dossier existant de votre choix.
   2. Dans l'arborescence du catalogue, cliquez avec le bouton droit sur le dossier, puis cliquez sur Nouveau > Dossier.
   3. Nommez ce dossier BufferPts.
3. Dans l'arborescence du catalogue, cliquez avec le bouton droit sur BufferPts, puis cliquez sur Nouveau > Dossier.
4. Nommez le dossier ToolData.
5. Dans l'arborescence du catalogue, cliquez avec le bouton droit sur ToolData, puis cliquez sur Nouveau > Géodatabase fichier.
6. Nommez la géodatabase fichier Schema.
7. Procédez de la même manière pour créer un dossier nommé Scratch dans BufferPts. Dans le dossier Scratch, créez une géodatabase fichier nommée Scratch.

Créez la boîte à outils

Dans l'arborescence du catalogue, procédez comme suit :

Etapes :

1. Cliquez avec le bouton droit sur le dossier BufferPts.
2. Cliquez sur Nouveau > Boîte à outils.
3. Nommez la boîte à outils BufferService.

Créez une classe d'entités de structure

Vous devrez utiliser une classe d'entités points comme structure pour la variable de jeu d'entités que vous utiliserez dans le modèle décrit ci-dessous.

Etapes :

1. Dans BufferPts/ToolData, cliquez avec le bouton droit sur la géodatabase Schema et cliquez sur Nouveau > Classe d'entités.
2. Nommez la classe d'entités Point.

   Le type d'entités est Points.

3. Cliquez sur Suivant.
Comme système de coordonnées, sélectionnez Systèmes de coordonnées géographiques > World > WGS 1984. (Bien que vous puissiez sélectionner Inconnu comme système de coordonnées, cela n'est pas recommandé.)
4. Cliquez sur Suivant.
5. Acceptez la valeur par défaut de Tolérance XY, puis cliquez sur Suivant.
6. Acceptez la valeur par défaut de Mot-clé de configuration, puis cliquez sur Suivant.
7. Cliquez sur Terminer (la classe d'entités ne contient pas d'attributs définis par l'utilisateur).

Créer le modèle.

Les étapes ci-dessous vous permettent de créer un nouveau modèle de géotraitement pour mettre en zone tampon les entités ponctuelles.

Etapes :

1. Cliquez avec le bouton droit sur la boîte à outils BufferService, pointez sur Nouveau, puis cliquez sur Modèle. La fenêtre ModelBuilder s'ouvre.
2. Pour ajouter l'outil Zone tampon :
   1. Cliquez sur Ajouter dans la barre d'outils ModelBuilder.
   2. Dans la boîte de dialogue Ajouter des données ou un outil, accédez à Boîtes à outils > Boîtes à outils système > Outils d'analyse > Proximité.
   3. Cliquez sur Zone tampon, puis sur Ajouter. (Vous pouvez également faire glisser l'outil Zone tampon de la fenêtre ArcToolbox, Rechercher ou Catalogue vers la zone d'affichage ModelBuilder.)
      La zone d'affichage ModelBuilder se présente maintenant comme suit :

      

3. Lors de l'utilisation de ModelBuilder, vous devez souvent déplacer et redimensionner des éléments (outils et variables). Dans l'illustration susmentionnée, la variable en sortie est en fait nommée Classe d'entités en sortie, mais elle est tronquée en raison de la taille de la variable. Pour la redimensionner, cliquez sur la variable en sortie, puis cliquez sur l'un des petits carrés de sélection bleus et faites-le glisser. Votre modèle se présente maintenant comme suit :
4. Cliquez avec le bouton droit sur Zone tampon, pointez sur Générer une variable > Paramètre de départ, puis cliquez sur Entités en entrée.Votre modèle se présente maintenant comme suit :
5. Cliquez avec le bouton droit sur Entités en entrée et cliquez sur Propriétés. Dans la boîte de dialogue Propriétés des entités en entrée, cliquez sur l'onglet Type de données.
6. Dans la liste déroulante Sélectionnez un type de données, choisissez Jeu d'entités. Dans la zone Importer la structure et la symbologie depuis, entrez le chemin d'accès ou accédez à la classe d'entités points Points que vous avez créée au cours des étapes précédentes.
7. Cliquez sur OK. La variable Entités en entrée est maintenant une couleur bleue.
8. Cliquez avec le bouton droit sur Zone tampon, pointez sur Générer une variable > Paramètre de départ, puis cliquez sur Distance [valeur ou champ]. Une nouvelle variable de modèle est créée.
9. Vous serez peut-être amené à cliquer sur la variable et à la faire glisser pour éviter qu'elle ne chevauche la variable Entités en entrée et à la redimensionner de manière à afficher son nom en entier.
10. Cliquez avec le bouton droit sur la variable Distance [valeur ou champ] et cliquez sur Renommer. Renommez la variable en Distance.
11. Cliquez avec le bouton droit sur Distance, puis cliquez sur Propriétés. Dans la boîte de dialogue Propriétés de la distance, cliquez sur l'onglet Type de données.
12. Dans la liste déroulante Sélectionnez un type de données, sélectionnez Unité linéaire.
13. Cliquez sur OK.
14. Double-cliquez sur Distance (ou cliquez avec le bouton droit dessus, puis cliquez sur Ouvrir). Définissez la distance sur 1000 mètres. La variable Distance est maintenant une couleur bleue et la variable Classe d'entités en sortie est une couleur verte. Cela signifie que toutes les entrées requises dans Zone tampon ont été fournies.
15. Cliquez avec le bouton droit sur la variable Classe d'entités en sortie (la sortie de Zone tampon) et cliquez sur Renommer. Renommez la variable en Polygones en sortie.
16. Double-cliquez sur Polygones en sortie et entrez %scratchworkspace%\BufferedPoints.shp.
17. Cliquez sur OK
18. Cliquez avec le bouton droit sur Entités en entrée et cliquez sur Paramètre du modèle. P (comme paramètre) s'affiche à côté de la variable.
19. Cliquez avec le bouton droit sur Distance et cliquez sur Paramètre du modèle. P s'affiche à côté de la variable.
20. Cliquez avec le bouton droit sur Polygones en sortie et cliquez sur Paramètre du modèle. P s'affiche à côté de la variable.

    Le modèle doit maintenant ressembler à l'illustration ci-dessous :

21. Dans le menu principal de ModelBuilder, cliquez sur Modèle, puis sur Propriétés du modèle :
    1. Définissez Nom sur BufferPoints.
    2. Définissez Etiquette sur Bufferiser des points.
    3. Cochez l'option Enregistrer les chemins relatifs.

    Ces paramètres sont indiqués dans l'illustration ci-dessous :

22. Cliquez sur OK.
23. Dans le menu principal de ModelBuilder, cliquez sur Modèle, puis sur Enregistrer. Recliquez ensuite sur Modèle, puis cliquez sur Fermer.

Test du modèle

La prochaine série d'étapes vous permet de tester votre modèle à l'aide d'ArcMap, ce qui est toujours judicieuse avant de publier un service.

Etapes :

1. Démarrez ArcMap et ajoutez des données pour créer une carte ou ouvrez une carte existante.
2. Dans ArcMap, utilisez le menu Géotraitement pour ouvrir les boîtes de dialogue Options de géotraitement et Paramètres d'environnement.
3. Configurez les éléments suivants :
   • Options de géotraitement : cochez la case Remplacer les résultats des opérations de géotraitement.
   • Options de géotraitement : cochez la case Ajouter les résultats du géotraitement à l'affichage.
   • Paramètres d'environnement : développez la catégorie Espace de travail et définissez l'espace de travail temporaire sur BufferPoints\Scratch (le dossier que vous avez créé ci-dessus).

   Ces paramètres sont illustrés ci-dessous :

4. Dans la fenêtre Catalogue d'ArcMap, accéder à votre dossier Toolshare et choisissez la boîte à outils BufferService que vous avez créée ci-dessus.
5. Double-cliquez sur Bufferiser des points. (Vous pouvez également cliquer avec le bouton droit sur Bufferiser des points et cliquez sur Ouvrir). La boîte de dialogue de l'outil Bufferiser des points illustrée ci-dessous s'ouvre.
6. Cliquez sur Ajouter une entité pour ajouter une entité ponctuelle dans la zone tampon. Vous pouvez ajouter plusieurs entités.

   Pour en savoir plus sur l'ajout d'entités à l'aide du contrôle de jeux d'entités

7. Vous pouvez également modifier le paramètre Distance.
8. Cliquez sur OK.

   L'exécution de l'outil commence. Une fois l'exécution de l'outil terminée, une nouvelle couche nommée BufferedPoints est ajoutée à la table des matières d'ArcMap.

9. Quittez ArcMap. Vous n'avez pas besoin d'enregistrer vos modifications.

Publier le service

Pour publier une boîte à outils dans ArcGIS Server, vous devez disposez d'un accès administrateur à ArcGIS Server. Pour vous connecter à un serveur, développez l'entrée Serveurs SIG dans l'arborescence du catalogue, puis cliquez sur Ajouter un serveur ArcGIS. Votre administrateur de serveur, la personne en charge de la configuration et de la gestion des comptes de votre installation ArcGIS Server, est responsable de la configuration de votre compte et de l'octroi de privilèges d'administrateur.

Une fois que vous avez établi une connexion administrateur à ArcGIS Server, vous pouvez publier votre boîte à outils.

Etapes :

1. Dans ArcCatalog, cliquez avec le bouton droit sur la boîte à outils BufferService et cliquez sur Publier sur un serveur ArcGIS.
2. Dans la boîte de dialogue Publier sur un serveur ArcGIS, choisissez le serveur sur lequel vous souhaitez effectuer la publication. Nommez le service BufferService (il s'agit du nom par défaut, le même que celui de la boîte à outils).
3. Cliquez sur Suivant.
4. Cliquez sur Terminer.

Pour en savoir plus sur la publication de services de géotraitement

Utiliser le service

Dans la procédure ci-dessous, vous allez utiliser votre service de géotraitement dans ArcMap.

Etapes :

1. Ouvrez ArcMap et ajoutez les données de votre choix ou ouvrez une carte existante.
2. Dans la fenêtre Catalogue d'ArcMap, accédez à votre connexion au serveur sous Serveurs SIG.
3. Recherchez le service de géotraitement BufferService sous le serveur et développez BufferService pour en afficher le contenu (la tâche Bufferiser des points).
4. Double-cliquez sur la tâche Bufferiser des points. (Vous pouvez également cliquer avec le bouton droit sur Bufferiser des points et cliquez sur Ouvrir). La boîte de dialogue de la tâche Bufferiser des points s'ouvre. Contrairement à la boîte de dialogue de l'outil Bufferiser des points (représentée ci-dessus), cette boîte de dialogue n'affiche pas le paramètre Polygones en sortie lorsque vous avez testé votre modèle. Cela s'explique par le fait qu'ArcGIS Server écrit les polygones en sortie à un emplacement sur le serveur (défini par %scratchworkspace%) et qu'il n'est pas nécessaire de spécifier un emplacement en sortie.
5. Cliquez sur Ajouter une entité () pour ajouter une entité ponctuelle à la zone tampon. Vous pouvez ajouter plusieurs entités.

   Pour en savoir plus sur l'ajout d'entités à l'aide du contrôle de jeux d'entités

6. Vous pouvez également modifier le paramètre Distance.
7. Veillez à désactiver le processus en arrière-plan pour que la boîte de dialogue du processus s'affiche. Pour ce faire, procédez comme suit :
   1. Cliquez sur Géotraitement dans ArcMap.
   2. Sélectionnez Options de géotraitement
   3. Si la case à cocher Activer correspondant à Traitement en arrière-plan est cochée, décochez-la. Sinon, laissez-la telle quelle.

   Pour en savoir plus sur le traitement au premier plan et en arrière-plan

8. Cliquez sur OK.
9. Cliquez sur Géotraitement > Résultats, développez Session en cours, puis développez l'entrée BufferPoints. Notez comment vous pouvez afficher les sorties, les entrées, les environnements et les messages pour l'exécution de la tâche. Chaque fois que vous exécutez un outil de géotraitement, le résultat est inscrit dans la fenêtre Résultats.

   Pour en savoir plus sur l'utilisation des résultats

   L'exécution de la tâche prend quelques instants. Une nouvelle couche est ajoutée à la table des matières d'ArcMap. Cette couche se nomme Polygones en sortie [<heure>_<date>], comme illustré ci-dessous.

Dans la procédure ci-dessous, vous allez modifier les propriétés BufferService et réexécuter la tâche Bufferiser des points pour voir l'effet de la modification de ses propriétés. Par conséquent, vous ne devez pas quitter ArcMap.

Modification de propriétés du service

La modification des propriétés de service affecte l'exécution des tâches.

Etapes :

1. Dans la fenêtre Catalogue, accédez au serveur qui contient le service de géotraitement BufferService.
2. Cliquez avec le bouton droit sur BufferService et cliquez sur Arrêter. Les services de géotraitement doivent être arrêtés pour que leurs propriétés puissent être modifiées.
3. Cliquez avec le bouton droit sur BufferService et cliquez sur Propriétés du service.
4. Cliquez sur l'onglet Paramètres.

Vous pouvez modifier trois paramètres de base qui affectent l'exécution de la tâche. Modifiez ces paramètres comme indiqué ci-dessous, cliquez sur OK, puis démarrez le service (cliquez avec le bouton droit sur BufferService et cliquez sur Démarrer). Puis réexécutez la tâche dans ArcMap pour constater son effet.

Type d'exécution

Synchrone signifie que le client attend la fin de l'exécution de la tâche par le serveur. Asynchrone signifie que le client peut effectuer d'autres travaux pendant que le serveur exécute la tâche. Vous devez sélectionner synchrone uniquement pour les tâches qui s'exécutent rapidement.

BufferService a une tâche, Bufferisation de points, qui s'exécute rapidement. Remplacez le type d'exécution par synchrone, relancez le service, puis réexécutez Bufferisation de points. Lors d'une exécution synchrone, la boîte de dialogue de progression reste ouverte jusqu'à ce que l'exécution de la tâche soit terminée.

Nombre maximal d'enregistrements retournés par le serveur

Le nombre que vous entrez est le nombre maximal d'enregistrements ou entités transférables du serveur au client. Une valeur de 0 signifie qu'aucun enregistrement ne peut être transféré. La valeur par défaut est 1000. Après avoir arrêté le service, définissez la valeur sur 0, relancez le service et réexécutez la tâche Bufferiser des points. La tâche s'exécute et une couche est créée. Comme le nombre maximal est défini sur 0, il n'y a toutefois pas d'entité. Si vous consultez le résultat dans la fenêtre Résultats, <Limite de transfert des données> est indiqué pour Polygones en sortie.

Afficher les messages

Les modèles de géotraitement écrivent des messages pendant l'exécution des processus de modèle. Il peut s'agir de messages d'avertissement, d'erreur et d'information. Ils peuvent contenir des chemins d'accès aux données résidant sur votre serveur ou réseau local, que vous ne souhaitez pas divulguer aux utilisateurs. Par défaut, les messages ne sont pas affichés.

Cochez la case Afficher les messages, redémarrez le service, puis réexécutez Bufferiser des points. Un nombre plus élevé de messages devrait s'afficher dans la boîte de dialogue de progression (si le service s'exécute de façon synchrone) et dans le résultat.

Lorsque vous développez et testez des services, vous préférez en général afficher des messages.