Partager un outil web de service d’impression avec des mises en page personnalisées depuis 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 dans ArcGIS Pro et les partager sur votre portail sous la forme d’un outil web.

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 en tant qu’outil web, à utiliser comme une ressource supplémentaire pour l’impression de cartes web.

Comme pour chaque outil web, le résultat de ce didacticiel est partagé sur le portail ArcGIS Enterprise où vous êtes connecté, et le service de géotraitement qui sert de base à l’outil web est enregistré sur le serveur ArcGIS Server fédéré de votre choix.

Cette rubrique partage des similitudes avec la rubrique Publier des services supplémentaires pour l’impression dans ArcMap. Toutefois, cette rubrique-là utilise ArcMap pour publier un service de géotraitement sur votre serveur, tandis que cette rubrique-ci utilise ArcGIS Pro pour partager un outil web avec votre portail.

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 des mises en page dans ArcGIS Pro 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 sous-jacent de l’outil web 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 aux rubriques Qu'est-ce qu'un texte dynamique ? de la documentation 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=""/>

• 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}.

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 du dossier de modèles de mise en page auprès de ArcGIS Server

Pour que vous puissiez créer et partager l’outil web avec ArcGIS Enterprise, le dossier contenant vos modèles de mise en page doit être accessible à ArcGIS Server. Si c’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 l’outil web.

Pour en savoir plus, reportez-vous à la rubrique Gérer les Data Stores inscrits dans l’aide de ArcGIS Pro.

Préparation et partage de l’outil web

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. Puis, partagez les résultats sous la forme d’un outil web.

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 Web AppBuilder for ArcGIS 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 (Obtenir des informations sur les modèles de mise en page) 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.
10. 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.

11. Utilisez l’option Analyze (Analyse) pour déceler des problèmes éventuels.
12. 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.
13. 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.
14. 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.

15. Cliquez sur Share (Partager) pour partager l’outil web.
16. 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 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).

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 la publication (reportez-vous à la section « Inscription du dossier de modèles de mise 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 la publication, 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 de l’outil web 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 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, 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, vous souhaitez ajouter un nouveau modèle de mise en page au dossier et le mettre à la disposition de vos utilisateurs.