Enregistrer une définition de service pour un outil Web

Avec ArcGIS Pro, vous pouvez enregistrer les définitions de service pour les outils Web afin de les partager ultérieurement sur votre portail. Un fichier de définition de service (.sd) contient les informations indiquant comment l’outil Web est publié et configuré dans ArcGIS Enterprise. Consultez Introduction à l’enregistrement des définitions de service pour en savoir plus sur la manière d’utiliser les définitions de service dans le partage des processus de votre organisation. Comme lors de la publication d’un outil Web, vous devez exécuter l’outil au moins une fois pour obtenir le résultat correct avant de l’enregistrer en tant que définition de service. Vous devez également posséder un rôle Administration ou Publication personnalisé pour enregistrer une définition de service.

Enregistrer une définition de service connecté pour un outil Web

Une définition de service connecté est configurée pour une connexion spécifique au serveur. L’option d’enregistrement d’une définition de service est disponible dans la fenêtre Share As Web Tool (Partager en tant qu’outil Web) lorsque vous êtes connecté à ArcGIS Enterprise. Vous pouvez enregistrer un fichier de définition de service pour publier un nouvel outil Web ou remplacer un outil Web préexistant.

Afin d’enregistrer une définition de service connecté pour la publication ou le remplacement d’un outil Web, procédez comme suit :

1. Effectuez l’une des opérations suivantes :
   • Procédez à l’enregistrement à partir de l’onglet Share (Partager).
     • Pour la publication d’un outil Web, sous l’onglet Share (Partager), dans le groupe Share As (Partager en tant que), cliquez sur la flèche de la liste déroulante Web Tool (Outil Web) et sélectionnez Share Web Tool (Partager un outil Web) pour ouvrir la fenêtre Select Tool To Share (Sélectionner l’outil à partager). Sélectionnez l’élément et cliquez sur OK.
     • Pour le remplacement d’un outil Web, sous l’onglet Share (Partager), dans le groupe Share As (Partager en tant que), cliquez sur la flèche de la liste déroulante Web Tool (Outil Web) et sélectionnez Overwrite Web Tool (Remplacer un outil Web) pour ouvrir la fenêtre Select the Web Tool to Overwrite (Sélectionner l’outil Web à remplacer). Sélectionnez l’élément de substitution, puis cliquez sur OK pour ouvrir la fenêtre Select Tool To Share (Sélectionner l’outil à partager). Sélectionnez le résultat de l’analyse de l’outil à remplacer, puis cliquez sur OK.
   • Procédez à l’enregistrement à partir de la fenêtre History (Historique).
     • Pour la publication d’un outil Web, sous l’onglet Analysis (Analyse), dans le groupe Geoprocessing (Géotraitement), cliquez sur History (Historique) pour ouvrir la fenêtre History (Historique). Dans l’onglet Geoprocessing (Géotraitement) de la fenêtre, cliquez avec le bouton droit sur l’élément à enregistrer, pointez sur Share As (Partager en tant que) et cliquez sur Share Web Tool (Partager l’outil Web).
     • Pour le remplacement d’un outil Web, sous l’onglet Analysis (Analyse), dans le groupe Geoprocessing (Géotraitement), cliquez sur History (Historique) pour ouvrir la fenêtre History (Historique). Dans l’onglet Geoprocessing (Géotraitement) de la fenêtre, cliquez avec le bouton droit sur l’élément à enregistrer, pointez sur Share As (Partager en tant que) et cliquez sur Overwrite Web Tool (Remplacer un outil Web).

   La fenêtre Share As Web Tool (Partager en tant qu’outil Web) ou Overwrite Web Tool (Remplacer un outil Web) s’affiche.

2. Configurez tous les paramètres à modifier dans la fenêtre Share As Web Tool (Partager en tant qu’outil Web) ou Overwrite Web Tool (Remplacer un outil Web).
3. Sous Finish Sharing (Terminer le partage), cliquez sur Analyze (Analyser) pour rechercher les problèmes éventuels.

   Des erreurs et des avertissements figurent dans l’onglet Messages. Cliquez avec le bouton sur un message pour ouvrir la rubrique d’aide associée ou prendre la mesure corrective dans le logiciel. Toutes les erreurs doivent être corrigées avant de pouvoir publier le service. La résolution des avertissements est recommandée, mais nullement obligatoire.

   En savoir plus sur l’analyse des ressources SIG

4. Après avoir résolu les problèmes à l’origine des erreurs et éventuellement les problèmes à l’origine des avertissements, cliquez sur la flèche de la liste déroulante Publish (Publier) et sur Save As SD (Enregistrer en tant que définition de service).

   La boîte de dialogue Save As Service Definition File (Enregistrer comme fichier de définition de service) s’affiche.

5. Dans la boîte de dialogue, précisez l’emplacement et le nom pour le fichier de définition de service et cliquez sur Save (Enregistrer).
6. Éventuellement, cliquez sur Jobs (Tâches)  pour surveiller l’état de la tâche.
7. Une fois que la définition de service a été transférée avec succès, cliquez sur le lien Manage the service definition (Gérer la définition de service) en bas de la fenêtre pour ouvrir l’emplacement du fichier de définition de service.

Enregistrer une définition de service hors connexion pour un outil Web

Une définition de service hors connexion se distingue par une absence de connexion ; elle n’est pas configurée pour une connexion spécifique au serveur. Vous pouvez enregistrer le fichier de définition de service hors connexion et le publier sur un portail ArcGIS Enterprise ou remplacer un outil Web existant. Il est inutile de se connecter à ArcGIS Enterprise pour l’enregistrement du fichier ; il n’y a aucune option relative aux informations de ArcGIS Enterprise dans la fenêtre d’enregistrement.

Si vous enregistrez la définition de service hors connexion à partir de ArcGIS Pro 3.0 ou version ultérieure, veillez à choisir la version appropriée de ArcGIS Enterprise sur laquelle vous effectuez le partage. En effet, plusieurs outils se comportent différemment selon que vous publiez sur 10.9.1 ou une version antérieure.

Si vous référencez les données à l’aide d’un data store serveur lors de l’enregistrement du fichier de définition de service hors connexion, prenez garde aux points suivants :

• Les données sont soit toutes copiées, soit référencées lors de la publication du fichier de définition de service hors connexion. Si certaines données doivent être copiées et d’autres référencées, enregistrez plutôt le fichier comme un fichier de définition de service connecté.
• Avant de publier le fichier sur un portail ArcGIS Enterprise, assurez-vous que son serveur accède à la base de données ou au chemin du dossier des données référencées, puis inscrivez les données côté publication et côté serveur du Data Store du serveur.

Afin d’enregistrer une définition de service hors connexion pour la publication ou le remplacement d’un outil Web, procédez comme suit :

1. Effectuez l’une des opérations suivantes :
   • Procédez à l’enregistrement à partir de l’onglet Share (Partager).
     • Sous l’onglet Share (Partager), dans le groupe Share As (Partager en tant que), cliquez sur la flèche de la liste déroulante Web Tool (Outil Web) et sur Save As Offline Service Definition (Enregistrer comme définition de service hors connexion) pour ouvrir la boîte de dialogue Select Tool To Share (Sélectionner l’outil à partager). Sélectionnez l’élément et cliquez sur OK.
   • Procédez à l’enregistrement à partir de la fenêtre History (Historique).
     • Sous l’onglet Analysis (Analyse), dans le groupe Geoprocessing (Géotraitement), cliquez sur History (Historique) pour ouvrir la fenêtre History (Historique). Dans l’onglet Geoprocessing (Géotraitement) de la fenêtre, cliquez avec le bouton droit sur l’élément à enregistrer et cliquez sur Share As (Partager en tant que) > Save As Offline SD (Enregistrer comme définition de service hors connexion) > Web Tool on Portal (Outil Web sur le portail).

   Le volet Save As Offline Service Definition (Enregistrer comme définition de service hors connexion) s’affiche.

2. Configurez tous les paramètres que vous souhaitez modifier dans la fenêtre Save As Offline Service Definition (Enregistrer comme définition de service hors connexion). Veillez à sélectionner la version appropriée de ArcGIS Enterprise si vous utilisez ArcGIS Pro 3.0 ou une version ultérieure.
3. Si vous voulez utiliser le fichier de définition de service enregistré pour remplacer un outil Web préexistant, sélectionnez la case à cocher située en regard de Save as Overwrite (Enregistrer en tant que remplacement) sous Overwrite (Remplacer) dans la fenêtre General (Général).
4. Sous Finish Staging (Terminer la gestion intermédiaire), cliquez sur Analyze (Analyser) pour rechercher les problèmes éventuels.

   Des erreurs et des avertissements figurent dans l’onglet Messages. Cliquez avec le bouton sur un message pour ouvrir la rubrique d’aide associée ou prendre la mesure corrective dans le logiciel. Toutes les erreurs doivent être corrigées avant de pouvoir publier le service. La résolution des avertissements est recommandée, mais nullement obligatoire.

   En savoir plus sur l’analyse des ressources SIG

5. Une fois que vous avez résolu les erreurs, et éventuellement les avertissements, cliquez sur Save (Enregistrer).

   La boîte de dialogue Save As Service Definition File (Enregistrer comme fichier de définition de service) s’affiche.

6. Dans la boîte de dialogue, précisez la localisation et le nom du fichier de définition de service et cliquez sur Save (Enregistrer).
7. Éventuellement, cliquez sur Jobs (Tâches)  pour surveiller l’état de la tâche.
8. Une fois que la définition de service a été transférée avec succès, cliquez sur le lien Manage the service definition (Gérer la définition de service) en bas de la fenêtre pour ouvrir l’emplacement du fichier de définition de service.

Enregistrer une définition de service à l’aide de Python

Pour enregistrer une définition de service connectée, reportez-vous aux exemples de code provenant de la classe GeoprocessingSharingDraft du module de partage ou de la fonction de publication CreateGPSDDraft.

Pour enregistrer une définition de service hors connexion, servez-vous de la classe GeoprocessingSharingDraft du module de partage en utilisant les paramètres offline et offlineTarget.

Lorsque vous êtes prêt à publier un outil Web sur un portail ArcGIS Enterprise, reportez-vous à la rubrique Publier une définition de service.