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 dans ArcGIS Pro. Vous pouvez partager ces mises en page sur votre portail en tant qu’outil Web ou les publier sur un site ArcGIS Server autonome en tant que service de géotraitement. Les services de géotraitement qui activent l’impression sont appelés services d’impression.

Ne mettez pas à jour les mises en page fournies avec le service PrintingTools par défaut, et n’ajoutez pas de nouvelles mises en page et ne republiez pas ce service. Exécutez plutôt l’outil de script Exporter la carte Web dans ArcGIS Pro et partagez 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.

Créer 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 la 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).

Remarque :

Pour prendre en charge les mises à jour personnalisées créées dans ArcGIS Pro 3.0 et des versions ultérieures, l’organisation doit utiliser ArcGIS Server version 11.0 ou ultérieure.

Préparer 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 insérer du texte dynamique, 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).
• Pour 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 vous est recommandé de sélectionner l’option Compute at center (Calculer au centre), qui calcule l’échelle de la carte à 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).
• Depuis la version 11.2, vous pouvez également ajouter des attributs et des statistiques en tant qu’éléments de texte dynamique à vos mises en page.

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.

Inscrire le dossier des modèles de mise 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 les 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.

   Conseil :

   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 même dossier pour Layout Templates Folder (Dossier de modèles de mise en page) que celui 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.

Utiliser des modèles d’impression personnalisés dans le portail ArcGIS Enterprise

Vous pouvez télécharger des modèles de mise en page (.pagx) et des modèles de rapport (.rptt) en tant qu’éléments de portail qui peuvent être transmis à des services d’impression individuels. Pour télécharger un modèle d’impression personnalisé, procédez comme suit :

1. Créer un modèle de mise en page ou de rapport dans ArcGIS Pro.
2. Enregistrez le modèle sous forme de fichier .pagx ou .rptt.
3. Connectez-vous à votre portail.
4. Cliquez sur Content (Contenu).
5. Cliquez sur New item (Nouvel élément).
6. Faites glisser et déposez le fichier modèle ou cliquez sur Your device (Votre appareil) et sélectionnez le fichier.

Le modèle peut maintenant être transmis aux services d’impression via les paramètres Layout_Item_ID et Report_Item_ID.

Pour plus d’informations, reportez-vous aux rubriques Créer un modèle de rapport personnalisé et Fichiers de mise en page.

Limitations

Lors de l’utilisation de modèles d’impression personnalisés, les limitations sont les suivantes :

• Les éléments doivent se trouver dans le portail où le serveur des services d’impression est fédéré. Par exemple, un service d’impression exécuté sur le portail A ne peut pas accéder à un élément à partir du portail B.
• Les services d’impression par défaut du service d’impression prêt à l’emploi et ArcGIS GIS Server ne prennent pas en charge cette fonctionnalité.
• Les clients Web ne prennent pas en charge cette fonctionnalité pour l’instant. À la place, vous devez écrire une API Javascript personnalisée.

Publier un service d’impression sur le portail ArcGIS Enterprise pour activer des rapports

Depuis la version 11.2, vous pouvez publier des services d’impression à partir de ArcGIS Pro 3.2 ou version ultérieure pour activer l’impression de rapports basés sur des modèles de mise en page (.pagx), des modèles de rapport (.rptx) ou les deux.

Types de rapports

Un service d’impression vous permet de générer trois types de rapports :

• Mises en page avec éléments de texte dynamique : sortie de page unique qui inclut une carte, ainsi que des attributs et statistiques affichés via des éléments de texte dynamique.
• Rapports sans cartes : sortie multipage pouvant inclure des attributs, statistiques, diagrammes et pièces jointes. Prend uniquement en charge le format PDF.
• Mises en page avec ou sans éléments de texte dynamique et rapport : sortie multipage qui inclut à la fois une mise en page et un rapport. Prend uniquement en charge le format PDF.

Publier un rapport

Pour publier un rapport, suivez les étapes ci-dessous :

1. Créez une mise en page avec des éléments de texte dynamique ou un modèle de rapport dans ArcGIS Pro.
2. Enregistrez le modèle en tant que modèle de mise en page (.pagx) ou de rapport (.rptt) dans le dossier de votre fichier de modèle.
3. Dans ArcGIS Pro, ouvrez l’outil Exporter la carte Web.
4. Définissez le paramètre Layout Templates Folder sur le dossier dans lequel vous avez enregistré votre fichier de modèle.
5. Exécutez l’outil Exporter la carte Web.
6. Accédez à Toolboxes (Boîtes à outils) > Server Tools (Outils de serveur) > Printing (Impression) et double-cliquez sur les outils de script Get Layout Templates Info ou Get Report Templates Info selon que vous publiez des mises en page, des rapports ou les deux.
7. Publiez vos modèles en tant que service d’impression.

Limitations

Lors de l’utilisation de rapports, les limitations sont les suivantes :

• Les services d’impression par défaut du service d’impression prêt à l’emploi et ArcGIS GIS Server ne prennent pas en charge cette fonctionnalité.
• Map Viewer et ArcGIS Experience Builder ne prennent pas en charge cette fonctionnalité.
• Les clients Web ne prennent pas en charge cette fonctionnalité pour l’instant. À la place, vous devez utiliser l’API Javascript pour créer une application ou un widget personnalisé.

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 une option Execution Mode (Mode d’exécution) pour l’outil dans la section Parameters (Paramètres). Dans la plupart des cas, choisissez 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 une valeur de consignation Message Level (Niveau du message) pour l’outil.
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é correctement publié.

   L’outil Web est disponible dans votre portail ArcGIS Enterprise, et son service de géotraitement sous-jacent est 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 Export Web Map (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 une option Execution Mode (Mode d’exécution) pour l’outil dans la section Parameters (Paramètres). Dans la plupart des cas, choisissez 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 une valeur 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 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 Export Web Map (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.

Mettre à jour les 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 mise en page au dossier ou 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 en page 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.