Partager des mises en page personnalisées pour les imprimer à partir de ArcGIS Pro

Si vous avez besoin d’utiliser dans ArcGIS Enterprise des fonctionnalités d’impression qui ne relèvent pas du service PrintingTools par défaut, vous pouvez créer des mises en page personnalisées à vos propres fins dans ArcGIS Pro. Vous pouvez partager ces mises en page sur votre portail en tant qu’outil Web ou les publier sur votre site ArcGIS Server autonome (si vous en utilisez un) en tant que service de géotraitement. Les services de géotraitement qui activent l’impression sont appelés services d’impression.

Vous ne devez pas mettre à jour les mises en page disponibles avec le service PrintingTools par défaut, ni ajouter de nouvelles mises en page et republier ce service. Vous devez plutôt exécuter l’outil de script Exporter la carte web dans ArcGIS Pro et partager le résultat de cette exécution, à utiliser comme une ressource supplémentaire pour l’impression de cartes web.

Si vous partagez un outil Web sur le portail, le résultat de ce didacticiel est partagé sur le portail ArcGIS Enterprise où vous êtes connecté, et le service d’impression qui sert de base à l’outil Web est enregistré sur le serveur ArcGIS Server fédéré de votre choix.

Si vous utilisez un site de serveur autonome, ce didacticiel a pour résultat un service d’impression basé sur les outils Exporter la carte Web et Obtenir des informations sur les modèles de mise en page que vous exécutez dans ArcGIS Pro.

Cette rubrique partage des similitudes avec la rubrique Publier un service d’impression avec des mises en page personnalisées depuis ArcMap. Toutefois, cette rubrique utilise ArcMap pour publier un service d’impression sur votre serveur, qu’il s’agisse d’un service autonome ou d’un service fédéré auprès d’un portail. Cette rubrique utilise ArcGIS Pro pour partager un outil Web avec votre portail ou publier un service d’impression sur votre serveur autonome.

Création d'une mise en page personnalisée

Si vous souhaitez créer un modèle de mise en page personnalisé, vous pouvez le faire dans ArcGIS Pro. Pour plus d’informations, reportez-vous à la rubrique Mises en page dans ArcGIS Pro. Enregistrez votre nouvelle mise en page dans un dossier. Pour cela, sur l’onglet Share (Partager), dans le groupe Save As (Enregistrer sous), cliquez sur Layout File (Fichier de mise en page). Vous pouvez également cliquer avec le bouton droit de la souris sur la mise en page, dans la fenêtre Catalog (Catalogue), et sélectionner Save As Layout File (Enregistrer comme un fichier de mise en page).

Points à prendre en compte lors de la préparation des mises en page

Vous pouvez appliquer plusieurs pratiques conseillées lorsque vous créez dans ArcGIS Pro des mises en page qui seront utilisées dans un portail ArcGIS Enterprise :

• Si votre mise en page comporte plusieurs fenêtres cartographiques, choisissez celle que l’outil web doit utiliser et nommez-la WEBMAP_MAP_FRAME (en respectant la casse). Le service d’impression utilisera la fenêtre cartographique ainsi nommée.
• Insérez un texte dynamique (titre, nom de l’auteur, etc.). Pour en savoir plus sur le texte dynamique, reportez-vous à la rubrique Qu’est-ce qu’un texte dynamique ? dans la documentation de ArcGIS Pro. Pour ce faire, procédez comme suit :
  1. Dans l’onglet Insert (Insérer) du ruban, sélectionnez la commande Text (Texte) du groupe Text (Texte).
  2. Cliquez sur un emplacement de la mise en page pour y positionner le nouvel élément de texte.
  3. Ouvrez la page Property (Propriété) de l’élément de texte.
  4. Insérez une des balises suivantes dans la propriété Text (Texte) de l’élément sélectionné :

     titleText	<dyn type="layout" property="metadata" attribute="title" emptyStr=""/>
     authorText	<dyn type="layout" property="metadata" attribute="contactname" emptyStr=""/>
     copyrightText	<dyn type="layout" property="metadata" attribute="credits" emptyStr=""/>

     Remarque :

     Vous ne pouvez ajouter qu’une seule balise de texte dynamique par élément de texte.

• Vous pouvez également ajouter l’élément de texte dynamique Current Time (Heure actuelle) à partir de la catégorie System (Système) du menu déroulant Dynamic Text (Texte dynamique). Il se trouve également dans le groupe Text (Texte) du ruban Insert (Insérer).
• Si vous souhaitez insérer un élément de texte personnalisé, ajoutez un élément de texte et faites figurer son nom entre accolades (par exemple {parcel-id}).
• Si vous insérez une barre d’échelle, il est vous est recommandé de sélectionner l’option Compute at center (Calculer au centre), qui calcule l’échelle cartographique à l’aide du centre de la fenêtre cartographique plutôt qu’un emplacement le long de l’équateur. Cette option n’est pas recommandée pour le texte de votre échelle (par exemple, 1:3,000).

Attention :

N’insérez pas le texte dynamique User (Utilisateur) dans la mise en page. Ce texte dynamique fournit des informations confidentielles sur le service d'impression.

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

Le dossier contenant vos modèles de mise en page doit être accessible à ArcGIS Server (un serveur fédéré auprès de votre portail ou un serveur autonome). Si cela est le cas, vous pouvez inscrire le dossier auprès du serveur ; sinon, vous devez copier le contenu du dossier sur le serveur depuis ArcGIS Pro lorsque vous partagez votre outil Web ou publiez votre service d’impression.

Reportez-vous aux instructions de la rubrique Gérer les répertoires de données inscrits dans l’aide de ArcGIS Pro.

Préparer vos outils personnalisés

Lorsque vous êtes prêt, exécutez l’outil de script Exporter la carte web en utilisant le dossier qui contient vos modèles de mise en page personnalisés. Ensuite, exécutez l’outil de script Obtenir des informations sur les modèles de mise en page, en utilisant le même dossier.

1. Dans la fenêtre Geoprocessing (Géotraitement), accédez à Toolboxes (Boîtes à outils) > Server Tools (Outils de serveur) > Printing (Impression).
2. Double-cliquez sur l’outil Exporter la carte web pour l’ouvrir.
3. Laissez le paramètre Web Map as JSON (Carte web au format JSON) sous la forme #.

   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 ArcGIS, les modèles d’application ArcGIS Enterprise et ArcGIS Web AppBuilder génèrent ce format JSON.

4. Laissez le paramètre Output File (Fichier en sortie) en l’état.

   Lorsque vous avez publié cet outil sur le serveur, la sortie est placée dans le répertoire des tâches du serveur.

5. S’agissant du paramètre Layout Templates Folder (Dossier de modèles de mise en page), cliquez sur le bouton de navigation et accédez au dossier dans lequel sont enregistrées vos mises en page.

   Astuce :

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

6. Choisissez éventuellement une mise en page dans la liste déroulante Layout Template (Modèle de mise en page).

   Cette mise en page sera utilisée par défaut lorsque des utilisateurs exécuteront votre service.

7. Cliquez sur Run (Exécuter) pour exécuter l’outil.
8. Accédez à Toolboxes (Boîtes à outils) > Server Tools (Outils de serveur) > Printing (Impression) et double-cliquez sur l’outil de script Get Layout Templates Info pour l’ouvrir.

L’outil de script Get Layout Templates Info (Obtenir des informations sur les modèles de mise en page) vous permet d’ajouter la tâche éponyme aux services d’impression. Cette tâche fournit la taille de la mise en page et la taille d’une fenêtre cartographique. 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. Cliquez sur Run (Exécuter) pour exécuter le script.

Maintenant que vous avez exécuté les deux outils de géotraitement avec vos mises en page personnalisées, vous pouvez partager les résultats de ces exécutions sur ArcGIS Enterprise. Le processus suivant à exécuter diffère selon que vous utilisez un portail ArcGIS Enterprise (avec un ou plusieurs sites de serveur fédéré) ou un site de serveur autonome.

Partager un outil Web d’impression sur le portail ArcGIS Enterprise

Si vous utilisez un portail ArcGIS Enterprise, procédez comme suit pour partager les résultats de l’outil de géotraitement sur le portail en tant qu’outil web :

1. Dans l’onglet Analysis (Analyse) du ruban, cliquez sur History (Historique), ou cliquez sur l’onglet History (Historique) dans la fenêtre Catalog (Catalogue). Cliquez avec le bouton droit de la souris sur le résultat Export Web Map (Exporter la carte web), puis sélectionnez Share As (Partager en tant que) > Web Tool (Outil web).

   La boîte de dialogue Share As A Web Tool (Partager en tant qu’outil web) s’affiche.

2. Utilisez l’option Analyze (Analyse) pour déceler des problèmes éventuels.
3. Dans l’onglet General (Général) de la boîte de dialogue, remplacez les données par défaut de la zone Item Details (Détails des éléments) (nom, résumé, balises) comme il convient. Si vous avez inscrit le dossier de modèles de mise en page auprès du serveur comme indiqué plus haut, sélectionnez l’option Reference registered data (Référencer les données enregistrées) ; sinon, sélectionnez l’option Copy all data (Copier toutes les données). Indiquez le dossier du portail dans lequel enregistrer l’outil Web, ainsi que le site ArcGIS Server fédéré et le dossier du serveur où enregistrer son service de géotraitement sous-jacent. Ensuite, définissez les options de partage de cet outil web.
4. Affichez l’onglet Configuration. Sélectionnez un paramètre Execution Mode (Mode d’exécution) pour l’outil dans la section Parameters (Paramètres). Dans la plupart des cas, il convient d’opter pour le mode Synchronous (Synchrone). Sélectionnez le paramètre Asynchronous (Asynchrone) si vous vous attendez à ce que les requêtes adressées à l’outil prennent plus de quelques secondes (par exemple, lors de l’impression d’une grande carte détaillée). Ensuite, définissez un paramètre de consignation Message Level (Niveau du message) pour l’outil.

   Remarque :

   Les services d’impression comportant un mode d’exécution (Execution Mode) asynchrone (Asynchronous) ne peuvent pas être utilisés dans les applications ArcGIS Web AppBuilder.

5. Affichez l’onglet Content (Contenu). Cliquez sur Add Tool (Ajouter un outil), puis ajoutez le résultat Get Layout Templates Info (Obtenir des informations sur les modèles de mise en page) .

   Les deux outils que vous avez exécutés sont maintenant incorporés dans cet outil web.

6. Cliquez sur Share (Partager) pour partager l’outil web.
7. Vérifiez que votre outil Web a été publié correctement. Il doit être disponible dans votre portail ArcGIS Enterprise, et son service de géotraitement sous-jacent doit être disponible dans ArcGIS Server Manager.

Votre nouvel outil web peut maintenant être référencé dans les widgets d’impression proposés par les API web ArcGIS, ainsi que dans la Map Viewer du portail. L’URL de l’outil Web est disponible à partir de la page de son élément, dans le portail ArcGIS Enterprise.

L’outil Web est optimisé par un service d’impression personnalisé de votre ArcGIS Server fédéré. Vous pouvez désigner ce service comme service d’impression de votre portail ArcGIS Enterprise. Ouvrez ArcGIS Server Manager et localisez le service, puis copiez son URL, y compris la tâche Exporter la carte web, et collez-la dans la boîte de dialogue Utility Services (Services utilitaires) pour le paramètre Printing (Impression).

Publier un service d’impression sur le serveur autonome.

Si vous utilisez un site ArcGIS Server autonome de version 10.6 ou ultérieure, vous pouvez publier un service d’impression de ArcGIS Pro sur le serveur en procédant comme suit.

1. Ajoutez une connexion administrateur au site ArcGIS Server. La connexion doit être une connexion administrateur en vue de la publication des services de géotraitement vers le serveur autonome.
2. Dans la fenêtre Catalog (Catalogue), cliquez avec le bouton droit sur la connexion de serveur et choisissez Publish (Publier). Utilisez l’option Geoprocessing Service (Service de géotraitement) pour lancer la fenêtre Selected History Item(s) (Élément(s) de l’historique sélectionné(s)). Sélectionnez l’option Export Web Map (Exporter la carte web) dans la liste pour lancer la fenêtre Publish Geoprocessing Service (Publier le service de géotraitement).
3. Utilisez l’option Analyze (Analyse) pour déceler des problèmes éventuels.
4. Dans l’onglet General (Général) de la boîte de dialogue, remplacez les données par défaut de la zone Item Details (Détails des éléments) (nom, résumé, balises) comme il convient. Si vous avez inscrit le dossier de modèles de mise en page auprès du serveur comme indiqué plus haut, sélectionnez l’option Reference registered data (Référencer les données enregistrées) ; sinon, sélectionnez l’option Copy all data (Copier toutes les données). Indiquez le dossier de serveur dans lequel le service de géotraitement sous-jacent doit être enregistré. Ensuite, définissez les options de partage de cet outil web.
5. Affichez l’onglet Configuration. Sélectionnez un paramètre Execution Mode (Mode d’exécution) pour l’outil dans la section Parameters (Paramètres). Dans la plupart des cas, il convient d’opter pour le mode Synchronous (Synchrone). Sélectionnez le paramètre Asynchronous (Asynchrone) si vous vous attendez à ce que les demandes adressées au service d’impression prennent plus de quelques secondes (par exemple, lors de l’impression d’une grande carte détaillée). Ensuite, définissez un paramètre de consignation Message Level (Niveau du message) pour l’outil.
6. Affichez l’onglet Content (Contenu). Cliquez sur Add Tool (Ajouter un outil), puis ajoutez le résultat Get Layout Templates Info (Obtenir des informations sur les modèles de mise en page) .

   Les deux outils que vous avez exécutés sont maintenant incorporés dans ce service d’impression.

7. Cliquez sur Publish (Publier) pour commencer à publier le service d’impression.
8. Vérifiez que votre service d’impression a été correctement publié. Il est normalement disponible dans ArcGIS Server Manager.

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 inscrire le service d’impression personnalisé auprès d’un portail ArcGIS Enterprise, copiez cette URL, y compris la tâche Exporter la carte Web, puis collez-la dans la boîte de dialogue Utility Services (Services utilitaires) du paramètre Printing (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 situées dans votre dossier de modèles de mise en page, le processus adéquat diffère selon que vous avez ou non inscrit le dossier de modèles de mise en page auprès du serveur avant le partage (reportez-vous à la section « Inscription de votre dossier de modèles de mises en page auprès de ArcGIS Server » ci-dessus). Il importe également de savoir si vous souhaitez ajouter une nouvelle mise en page au dossier ou simplement mettre à jour une mise en page existante. En effet, la tâche de géotraitement que vous avez créée conserve la liste des mises à jour que contenait votre dossier de modèles de mise en page au moment de l’exécution.

Si vous avez inscrit votre dossier de modèles de mise en page auprès du serveur avant le partage, cela signifie que le serveur peut voir vos mises en page. Si vous mettez à jour des fichiers de mise en page (.pagx) dans le dossier, vos mises en page modifiées sont disponibles immédiatement. Toutefois, les nouvelles mises en page ajoutées après le partage ne sont pas visibles par le serveur.

C’est pourquoi, dans l’un des cas suivants, vous devez recommencer le processus ci-dessus et partager un nouvel outil Web ou un nouveau service d’impression pour que vos modifications soient accessibles à vos utilisateurs ArcGIS Server :

• Vous n’avez pas inscrit votre dossier de modèles de mise en page auprès du serveur avant de partager l’outil web ou le service d’impression, ce qui signifie que les mises en page ont été copiées sur le serveur au moment de la publication.
• Après avoir partagé l’outil web ou le service d’impression, vous souhaitez ajouter un nouveau modèle de mise en page au dossier et le mettre à la disposition de vos utilisateurs.