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

Complexité : IntermédiaireConditions requises pour les données Utiliser vos propres données

Dans certains cas, vous devez 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 d'impression, vous devez publier un service de géotraitement avec l'outil Exporter la carte Web. Ce didacticiel vous guide dans ce processus.

Inscription de votre dossier de modèles de mises en page auprès d'ArcGIS for Server

Au cours de ce didacticiel, vous allez utiliser un dossier de documents ArcMap (MXD) que vous avez préparés et qui contiennent diverses mises en page destinées à 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 auprès du 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 la carte Web avec les valeurs par défaut souhaitées pour votre service. Vous allez ensuite exécuter l'outil de script Obtenir des informations sur les modèles de mise en page. Vous allez ensuite publier les résultats en tant que service de géotraitement.

1. Dans ArcCatalog ou la fenêtre Catalogue d'ArcMap, accédez à Boîtes à outils > Boîtes à outils système > Outils de serveur > Impression.
2. Double-cliquez sur l'outil Exporter la carte Web pour l'ouvrir.
3. Ne renseignez pas le paramètre 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, les modèles d'application Portal for ArcGIS et Web AppBuilder for ArcGIS génèrent ce format JSON en arrière-plan.

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. Dans Boîtes à outils > Boîtes à outils système > Outils de serveur > Impression, accédez à l'outil de script Obtenir des informations sur les modèles de mise en page et ouvrez-le.

L'outil de script Obtenir des informations sur les modèles de mise en page est disponible depuis la version 10.4. L'outil de script vous permet d'ajouter la tâche Obtenir des informations sur les modèles de mise en page aux services d'impression. La tâche fournit la taille de la mise en page et la taille du bloc de données actif. Elle indique également si les éléments de mise en page suivants sont disponibles :

• Légende
• Texte du titre 
• Texte de copyright
• Texte d'auteur
• Eléments de texte personnalisés

9. Choisissez le dossier de modèles de mise en page que vous avez spécifié lors de l'exécution de l'outil Exporter la carte Web à l'étape 5, puis cliquez sur OK pour exécuter le script.
10. Cliquez sur Géotraitement > Résultats pour afficher la fenêtre Résultats.
11. Développez Session en cours, cliquez avec le bouton droit sur le résultat Exporter Web Map, puis sélectionnez Partager en tant que > Service de géotraitement.
12. Sélectionnez Publier un service et cliquez sur Suivant.
13. Choisissez une connexion à ArcGIS Server (ou cliquez sur le bouton pour en ajouter une), donnez un nom à votre service, puis cliquez sur Suivant.
14. 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.

15. 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. Les services d'impression à utiliser avec Portal for ArcGIS doivent être synchrones.
16. Dans l'éditeur de services, recherchez 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 modifier les valeurs par défaut, vous devez retourner dans la boîte de dialogue de l'outil Exporter la carte Web et 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 la carte Web, vous ne pouvez pas filtrer les choix de paramètres mis à disposition des utilisateurs.

17. Dans l'éditeur de services, cliquez sur Ajouter le résultat et ajoutez le résultat Obtenir des informations sur les modèles de mise en page depuis l'outil de script en cours d'exécution.
18. Utilisez l'éditeur de services pour définir d'autres propriétés du service, par exemple, le nombre minimum et maximum d'instances qui peuvent s'exécuter par machine.
19. 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.

20. 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. L'URL du service d'impression se trouve dans votre répertoire des services ArcGIS.

Pour utiliser le service d'impression personnalisé avec Portal for ArcGIS, copiez cette URL, y compris la tâche Exporter la carte Web, puis collez-la dans la boîte de dialogue Services utilitaires dans Impression. Notez que le portail accepte uniquement les URL qui utilisent HTTPS pour son service utilitaire d'impression.

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 "Inscription du dossier de modèles de mises en page avec ArcGIS 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 :

1. Dans ArcMap, ouvrez l'outil Exporter la carte Web 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'éditeur de services vérifiez que toutes les propriétés du service sont définies selon vos souhaits (il doit s'agir par défaut des propriétés que vous avez sélectionnées lors de la première publication du service), puis cliquez sur 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.

Considérations relatives aux services d'impression utilisés dans Portal for ArcGIS

Si vous comptez utiliser votre service d'impression dans Portal for ArcGIS, inscrivez votre dossier de modèles de mises en page auprès du serveur pour que les mises en page du service d'impression puissent être rapidement mises à jour. Lorsqu'une mise en page est mise à jour, redémarrez le service d'impression afin de répercuter les modifications sur le portail.

Si vous avez ajouté ou supprimé une mise en page du dossier de modèles de mises en page, vous devez redémarrer le service d'impression. Une fois le service redémarré, accédez à Mon organisation > Utilitaires sur le portail et cliquez sur Rafraîchir pour le service d'impression du portail. Reportez-vous à la rubrique Configurer le portail pour imprimer des cartes dans le guide de l'administrateur Portal for ArcGIS pour plus d'informations.

Vous pouvez suivre plusieurs pratiques conseillées lorsque vous créez des mises en page dans ArcMap qui seront utilisées dans un portail :

• Ancrez l'angle supérieur gauche de la légende dans la mise en page afin qu'elle demeure positionnée à cet emplacement lors de l'impression dans le portail.
• Insérez un titre et laissez le texte du titre vierge pour que le nom des cartes Web de votre portail soit renseigné dans la zone de texte du titre au cours de l'impression. Une carte Web qui n'est pas enregistrée s'imprime avec le titre Ma carte.
• Insérez le texte dynamique Auteur pour imprimer le nom complet de l'utilisateur connecté au portail.
• Insérez le texte dynamique Date actuelle pour afficher la date d'impression de la carte.
• Insérez le texte dynamique Heure actuelle pour afficher l'heure d'impression de la carte.
• Le texte dynamique Date d'enregistrement afficher également l'heure d'impression de la carte.

Attention :

N'insérez pas le texte dynamique Nom d'utilisateur dans la mise en page. Ce texte dynamique fournit des informations confidentielles sur le service d'impression.

Reportez-vous à Présentation rapide des mises en page dans l'aide d'ArcGIS for Desktop pour en savoir plus sur la création de mises en page efficaces.