Didacticiel : Publication des services supplémentaires pour l'impression

Complexité : Intermédiaires Exigences en matière de données : Utiliser vos propres données

Dans certains cas, vous devrez publier des services supplémentaires pour l'impression Web, sans passer par le service PrintingTools inclus avec ArcGIS for Server. Par exemple, vous pouvez créer un service et le configurer de manière à ce qu'il pointe sur votre propre dossier de mises en page de cartes. Vous pouvez également publier un service disponible gratuitement tout en mettant à disposition un service plus avancé moyennant une contribution financière.

Pour créer votre propre service pour l'impression, vous devez publier un service de géotraitement avec l'outil Exporter Web Map. Ce didacticiel vous guide dans le processus.

Inscription de votre dossier de modèles de mises en page avec ArcGIS for Server

Au cours de ce didacticiel, vous allez utiliser un dossier de documents ArcMap (MXD) que vous avez préparés avec diverses mises en page à utiliser pour l'impression de cartes Web. Il s'agit de votre dossier de modèles de mises en page.

Si votre dossier de modèles de mises en page se trouve sur le serveur ou s'il est accessible par le serveur, vous devez l'inscrire auprès d'ArcGIS for Server. Reportez-vous à la rubrique Inscription de vos données auprès d'ArcGIS Server à l'aide d'ArcGIS for Desktop pour savoir comment inscrire un dossier avec le serveur.

Si vous ne parvenez pas à obtenir votre dossier de modèles de mises en page sur le serveur ou dans un emplacement accessible par le serveur, ne faites rien. Le dossier de modèles de mises en page sera copié sur le serveur au moment de la publication de vos services, ce qui garantit que le serveur peut voir le dossier. Même si cette option est plus facile à configurer, davantage d'étapes seront nécessaires pour mettre à jour vos modèles de mises en page à l'avenir.

Préparation et publication du service

La première étape de l'impression est l'exécution de l'outil Exporter Web Map avec les valeurs par défaut souhaitées pour votre service. Vous publierez ensuite le résultat de l'outil en tant que service de géotraitement.

Etapes :

1. Dans ArcCatalog ou la fenêtre Catalogue d'ArcMap, naviguez vers Boîtes à outils > Boîtes à outils système > Outils de serveur > Impression.
2. Double-cliquez sur l'outil Exporter Web Map pour l'ouvrir.
3. Ne définissez pas les paramètres Carte Web au format JSON.

   Pour obtenir des images à imprimer, les utilisateurs de ce service enverront leur propre carte Web au format JSON pour ce paramètre. Les widgets d'impression des API Web d'ArcGIS génèrent ce format JSON en coulisses.

4. Laissez la valeur par défaut pour le paramètre Fichier en sortie. Lorsque vous avez publié cet outil sur le serveur, la sortie est placée dans le répertoire des tâches du serveur.
5. Renseignez le paramètre Dossier de modèles de mise en page en cliquant sur le bouton de navigation et en localisant le dossier dans lequel sont enregistrées les mises en page.
   Astuce:

   Si vous souhaitez simplement référencer les mises en page basiques installées avec ArcGIS for Server, laissez ce paramètre vierge.

6. Vous pouvez, si vous le souhaitez, définir le paramètre Modèle de mise en page en sélectionnant l'une des mises en page dans la liste déroulante. Cette mise en page sera utilisée par défaut lorsque des utilisateurs exécuteront votre service.
7. Cliquez sur OK pour exécuter l'outil.
8. Cliquez sur Géotraitement > Résultats pour afficher la fenêtre Résultats.
9. Développez Session en cours, cliquez avec le bouton droit sur le résultat Exporter Web Map que vous avez obtenu, puis cliquez sur Partager en tant que > Service de géotraitement.
10. Sélectionnez Publier un service et cliquez sur Suivant.
11. Choisissez une connexion à ArcGIS for Server (ou cliquez sur le bouton pour en ajouter un) et donnez un nom à votre service. Cliquez ensuite sur Suivant.
12. Choisissez le dossier dans lequel le service sera hébergé. Vous ne pouvez pas effectuer de publication dans les dossiers Système ou Utilitaires existants. Vous devez utiliser votre propre dossier ou le dossier racine.

    Lorsque vous avez terminé de sélectionner un dossier, cliquez sur Continuer.

    Vous consultez maintenant l'Editeur de services, dans lequel vous pouvez faire du travail de préparation avant la publication, comme définir les paramètres disponibles pour votre service.

13. Cliquez sur Paramètres et vérifiez que leMode d'exécution du service est défini sur Synchrone. Vous pouvez également sélectionner Asynchronesi vous vous attendez à ce que les requêtes prennent plus de quelques secondes.
14. Dans l'Editeur de services, localisez le volet de gauche dans lequel chaque paramètre d'outil est répertorié (Carte Web au format JSON, Fichier en sortie, Format, Dossier de modèles de mise en page et Modèle de mise en page). Cliquez sur chacun de ces paramètres et examinez les valeurs par défaut qui sont définies. Pour changer les valeurs par défaut, vous devez retourner à la boîte de dialogue de l'outil Exporter Web Map et y définir les valeurs, comme vous l'avez fait précédemment dans ce didacticiel. Vous pouvez masquer un paramètre aux yeux des utilisateurs et les obliger à utiliser la valeur par défaut en définissant le Mode en entrée sur Valeur constante.
    Attention :

    En raison d'une limitation connue de l'outil Exporter Web Map, vous ne pouvez pas filtrer les choix de paramètres mis à disposition des utilisateurs.

15. Utilisez l'Editeur de services pour définir les propriétés du service ; par exemple, le nombre minimum et maximum d'instances qui peuvent s'exécuter par ordinateur.
16. Cliquez sur Publier pour publier le service.

    Si vous recevez un avertissement concernant les données en cours de copie sur le serveur, cliquez sur OK. Cela a simplement pour effet de copier l'image en sortie par défaut, ce qui ne représente pas une quantité importante de données.

17. Vérifiez que votre service a été publié correctement en naviguant vers ce service dans le Gestionnaire ou le Répertoire de services.

Votre nouveau service peut maintenant être référencé dans les widgets d'impression offerts pas les API Web d'ArcGIS.

Mise à jour de modèles de mise en page

Pour mettre à jour les mises en page dans votre dossier de modèles de mise en page, le workflow adéquat est déterminé par le fait que vous ayez ou non inscrit le dossier de modèles de mise en page auprès du serveur avant la publication (reportez-vous à la section précédente "Inscription du dossier de modèles de mises en page avec ArcGIS for Server").

Mise à jour du dossier de modèles de mises en page si vous l'avez inscrit avec ArcGIS for Server

Si vous avez inscrit votre dossier de modèles de mises en page avec le serveur, cela signifie que le serveur peut voir vos mises en pages. Si vous effectuez les mises à jour des MXD dans le dossier, vos mises en page modifiées seront disponibles immédiatement. Si vous ajoutez une nouvelle mise en page au dossier de modèles, vous devez redémarrer le service d'impression pour pouvoir accéder à la mise en page et l'utiliser.

Mise à jour du dossier de modèles de mises en page si vous ne l'avez pas inscrit avec ArcGIS for Server

Si vous n'avez pas inscrit votre dossier de modèles de mises en page avec le serveur, les mises en page ont été copiées sur le serveur au moment de la publication. Vous devez écraser un service afin de mettre à niveau les modèles sur le serveur. Pour écraser un service, procédez comme suit :

Etapes :

1. Dans ArcMap, ouvrez l'outil Exporter Web Map et exécutez-le avec vos valeurs par défaut, comme décrit à la section précédente.
2. Cliquez avec le bouton droit sur le résultat du géotraitement et sélectionnez Partager en tant que > Service de géotraitement.
3. Sélectionnez l'option Ecraser un service existant, puis cliquez sur Suivant.
4. Cliquez sur le nom du service à écraser, puis sur Continuer.
5. Dans l'Editeur de services vérifiez que toutes les propriétés du service sont définies selon vos souhaits (elle doivent être par défaut les propriétés que vous avez sélectionnées lors de la première publication du service). Cliquez ensuite sur le bouton Publier

Les options que vous avez sélectionnées écrasent toutes les options définies lors de la première publication. Le dossier de modèles de mises en page (avec vos mises à niveau) est copié sur le serveur et remplace le dossier de modèles de mises en page placé au moment de la première publication du service.