Configurer ArcGIS Maritime

ArcGIS Maritime utilise une extension d’objet serveur (SOE). Vous devez ajouter l’extension à un service de carte sur le site ArcGIS pour pouvoir activer la fonctionnalité Maritime Chart Service pour le service de carte.

Remarque :

Avant de configurer le service, passez en revue les exigences système suivantes :

• Il est déconseillé d’utiliser des lecteurs réseau mappés pour la propriété workspaceDirectories car cela peut entraîner des problèmes de performance. Il est préférable que les fichiers .senc soient stockés sur le serveur physique.
• La fonctionnalité Maritime Chart Service ne peut être activée que sur un type d’instance dédiée. Les groupes d’instances partagées ne sont pas pris en charge.
• Si vous utilisez des paramètres d’affichage dans la requête GET, la longueur maximale de l’URL (2 048 caractères) est dépassée. POST n’est pas pris en charge dans toutes les applications tierces. Si vous ne pouvez pas prendre en charge POST dans les applications, il est conseillé d’augmenter la longueur d’URL autorisée à l’aide d’un fichier web.config.xml.
• Pour le déploiement de Custom Chart Builder (CCB), vous devez utiliser web.config.xml pour augmenter la longueur d’URL par défaut.
• Il est conseillé d’augmenter la valeur javaHeapSize du service de carte de 128 Mo (valeur par défaut) à 2 048 Mo ou plus, en fonction des ressources du système et du nombre de jeux de données du service. L’opération queryDataset et les exportations Custom Chart Builder (CCB) peuvent dépasser cette limite par défaut.

Activer Maritime Chart Service

Pour activer la fonctionnalité Maritime Chart Service, procédez comme suit :

1. Créez un dossier nommé maritimeserver sur le site ArcGIS Server dans <ArcGIS Server installation drive>\arcgisserver\directories.

   Remarque :

   Si cet emplacement n’existe pas, vérifiez que le site ArcGIS Server a été créé.

   En savoir plus sur la création d’un site

2. Copiez le dossier maritimechartservice depuis <ArcGIS Server Installation Directory>\MaritimeServer\Server<version> vers le dossier maritimeserver.
3. Connectez-vous à ArcGIS Server Manager.
4. Cliquez sur l’onglet Site.
5. Dans la fenêtre GIS Server (Serveur SIG), cliquez sur Extensions.
6. Cliquez sur Add Extension (Ajouter une extension).
7. Cliquez sur Browse (Parcourir) et accédez à <ArcGIS Install Directory>\MaritimeServer\Server<version>\Bin.
8. Cliquez sur MaritimeServer.soe.
9. Cliquez sur Ajouter.

   MaritimeServer.soe est ajouté au service de carte.

10. Cliquez sur l’onglet Services.
11. Cliquez sur le service de carte.
12. Dans la fenêtre Map Services (Services de carte), cliquez sur Capabilities (Fonctionnalités).
13. Cochez la case Maritime Chart Service (Service de cartes maritimes).
14. Vérifiez toutes les propriétés.

    Remarque :

    Le fichier MaritimeServer.soe utilise le dossier maritimechartservice pour alimenter automatiquement les propriétés de la fonctionnalité Maritime Chart Service.

15. Cliquez sur Save and Restart (Enregistrer et redémarrer) dans ArcGIS Server Manager pour redémarrer le service de carte.

    La fonctionnalité Maritime Chart Service est désormais activée.

16. Vous pouvez maintenant charger les jeux de données S-57 et S-63 dans le service de carte.

    Remarque :

    Vous pouvez modifier les paramètres de configuration par défaut.

Remarque :

Si vous avez installé la fonctionnalité Maritime Chart Service dans une grappe, elle ne doit être activée que sur une des machines de la grappe. Les changements de configuration sont appliqués automatiquement aux autres machines de la grappe.

En savoir plus sur la création d’un paquetage de tuiles Maritime Chart Service à l’aide des jeux de données S-57 et S-63

Déployer Custom Chart Builder (CCB)

ArcGIS Maritime vous permet de déployer une application Web pour générer des produits d’informations cartographiques en temps réel, ainsi que de créer tout produit à l’échelle de votre choix.

Copier le dossier customchartbuilder

Copiez le dossier customchartbuilder depuis l’emplacement d’installation de Custom Chart Builder (CCB) vers l’emplacement de déploiement. Les fichiers de l’emplacement d’installation peuvent être considérés comme une sauvegarde, tandis que ceux de l’emplacement de déploiement peuvent être modifiés selon les besoins. Copiez le dossier dans <ArcGIS Server installation drive>\arcgisserver\directories\ maritimeserver de sorte que les dossiers de CCB et de Maritime Server se trouvent sous le même dossier.

Exécutez la procédure ci-dessous pour déployer Custom Chart Builder (CCB) sur le site ArcGIS Server.

Remarque :

Pour effectuer les étapes de déploiement ci-dessous pour Custom Chart Builder (CCB), vous devez disposer d’un service de carte avec la fonctionnalité Maritime Chart Service activée.

1. Si nécessaire, créez un dossier nommé maritimeserver sur le site ArcGIS Server dans <ArcGIS Server installation drive>\arcgisserver\directories.

   Remarque :

   Si cet emplacement n’existe pas, vérifiez que le site ArcGIS Server a été créé et que la fonctionnalité Maritime Chart Service a été activée.

2. Copiez le dossier customchartbuilder depuis <ArcGIS Server Installation Directory>\MaritimeServer\Server<version> vers le dossier maritimeserver.
3. Configurez le compte ArcGIS Server.

Configurer le partage et les autorisations

Partagez et ajoutez des autorisations au dossier <ArcGIS Server installation drive>\arcgisserver en exécutant la procédure suivante pour fournir à l’utilisateur du compte ArcGIS Server un contrôle total sur ce dossier :

Remarque :

Le traitement d’exportation du produit Custom Chart Builder (CCB) écrit ou modifie les fichiers requis dans ce dossier.

1. Cliquez avec le bouton droit de la souris sur le dossier arcgisserver et sélectionnez Properties (Propriétés).
2. Cliquez sur l’onglet Share (Partage).
3. Cliquez sur Advanced Sharing (Partage avancé).
4. Cochez la case Share this folder (Partager ce dossier).
5. Cliquez sur Permissions (Autorisations).
6. Cliquez sur Add (Ajouter) dans l’onglet Share Permissions (Autorisations de partage).
7. Ajoutez le compte ArcGIS Server.

   Remarque :

   Vous pouvez spécifier les paramètres régionaux de votre compte ArcGIS Server. Par défaut, cet utilisateur est généralement ArcGIS.

8. Une fois le compte ArcGIS Server ajouté, cliquez sur OK pour fermer la boîte de dialogue Select Users or Groups (Sélectionner des utilisateurs ou des groupes).
9. Sélectionnez le compte ArcGIS Server que vous venez d’ajouter dans la fenêtre Group or user names (Noms des groupes ou des utilisateurs) de l’onglet Share Permissions (Autorisations de partage) et cochez la case Allow (Autoriser) en regard de Full control (Contrôle total).
10. Cliquez sur OK.
11. Cliquez de nouveau sur OK pour fermer la boîte de dialogue Advanced Sharing (Partage avancé).
12. Cliquez sur Fermer.
13. Cliquez sur OK pour fermer la boîte de dialogue Propriétés.

Publier les fichiers de définition de service

Publiez les deux fichiers de définition de service dans ArcGIS Server pour que Custom Chart Builder (CCB) calcule l’étendue de la zone d’intérêt lorsque vous créez une étendue sur la carte pour exporter un graphique PDF.

1. Connectez-vous à ArcGIS Server Manager.

   Remarque :

   Publiez les fichiers de définition de service à l’aide de ArcGIS Server Manager. Pour faciliter le déploiement, il est conseillé de créer un dossier dans ArcGIS Server Manager et de le nommer CCB pour organiser les services liés à CCB.

2. Cliquez sur Services > Manage Services (Gérer les services), sélectionnez le dossier CCB, puis cliquez sur Publish Service (Publier un service).
3. Cliquez sur Choose File (Sélectionner un fichier) pour accéder à la définition du service à publier ou spécifiez le chemin d’accès au fichier.

   L’emplacement par défaut est <ArcGIS Server installation drive>\arcgisserver\directories\maritimeserver\customchartbuilder\ServiceDefinitionFiles.

4. Sélectionnez Calculators.sd et cliquez sur Open (Ouvrir).

   Attention :

   Ne modifiez pas le nom du service. Si vous le modifiez, l’application Web ne peut pas fonctionner.

   Par défaut, la définition du service est publiée dans le dossier du serveur spécifié dans la configuration de la définition du service. Pour changer le dossier dans lequel la définition de service est publiée, sélectionnez un dossier dans la liste déroulante ou cliquez sur New (Nouveau).

   Remarque :

   Toutes les définitions de service Custom Chart Builder (CCB) doivent se trouver dans le même dossier pour que Custom Chart Builder (CCB) puisse être déployé correctement. Il est conseillé de créer un dossier pour organiser les services liés à CCB. Le nom recommandé pour ce dossier est CCB.

5. Cliquez sur Next (Suivant).

   Vous devez spécifier les propriétés du nouveau service. Aucune fonctionnalité supplémentaire n’est requise.

6. Cliquez sur Back (Précédent) ou Next (Suivant) si nécessaire.
7. Cliquez sur Publish (Publier).
8. Répétez ces étapes pour ExportWebmap.sd.

Mettre à jour le fichier Utilities.py

Mettez à jour le fichier Utilities.py après avoir publié les fichiers de définition de service Custom Chart Builder (CCB) de sorte que les services de géotraitement Calculators et ExportWebmap utilisent le fichier mis à jour.

1. Dans File Explorer, accédez au fichier Utilities.py et modifiez-le.

   L’emplacement par défaut est <ArcGIS Server installation drive>\arcgisserver\directories\maritimeserver\customchartbuilder\Tools.

2. Mettez à jour les variables suivantes :
   • shared_products_path et output_directory - Indiquez le nom de la machine et le domaine et mettez à jour le chemin d’accès si vous n’avez pas utilisé les paramètres par défaut.
   • output_url - localhost est utilisé uniquement pour les tests locaux. Sinon, indiquez le nom de la machine et le domaine et mettez à jour le chemin d’accès si vous n’avez pas utilisé les paramètres par défaut.
3. Enregistrez les modifications apportées à Utilities.py et fermez le fichier.
4. Copiez le fichier Utilities.py mis à jour dans l’emplacement arcgisinput des services Custom Chart Builder (CCB) Calculators et ExportWebmap que vous venez de publier.
5. Accédez à l’emplacement arcgisinput de Custom Chart Builder (CCB). L’emplacement par défaut est <ArcGIS Server installation drive>\arcgisserver\directories\arcgissystem\arcgisinput\CCB.
   • Copiez le fichier Utilities.py mis à jour localisé à l’étape 1 dans <ArcGIS Server installation drive>\arcgisserver\directories\arcgissystem\arcgisinput\CCB\Calculators.GPServer\extracted\p20\tools.
   • Copiez le fichier Utilities.py mis à jour localisé à l’étape 1 dans <ArcGIS Server installation drive>\arcgisserver\directories\arcgissystem\arcgisinput\CCB\ExportWebmap.GPServer\extracted\p20\tools.
6. Dans ArcGIS Server Manager, cliquez sur Services > Manage Services (Gérer les services).
7. Cliquez sur Folders (Dossiers) > CCB.
8. Redémarrez les services de géotraitement Calculators et ExportWebmap.

Activer une symbologie personnalisée

Le fichier ServerConfiguration.xml fournit un commutateur vrai/faux permettant d’activer ou de désactiver l’affichage d’une symbologie personnalisée qui remplace la bibliothèque de présentation S-52. Lorsque l’affichage est activé, la fonctionnalité Maritime Chart Service fait référence à des règles de CustomSymbolMap.XML, à des symboles SVG (Scalable Vector Graphics) et à des scripts Lua pour fournir une vue des données S-57 semblable à une carte papier.

Après avoir activé la symbologie personnalisée, vous devez recréer les fichiers .senc pour que les symboles apparaissent dans votre service.

Dans la fonctionnalité Maritime Chart Service, les scripts Lua peuvent :

• Faire référence à des fichiers SVG pour remplacer des symboles ponctuels ou des modèles linéaires complexes.
• Remplacer des instructions relatives aux symboles, telles que la couleur, le remplissage ou la transparence.
• Accéder à des groupes de vues ou des propriétés d’affichage.
• Fournir des instructions pour modifier le nom, la taille, la graisse, la couleur et le décalage de la police d’un groupe de texte.

Mettre à jour des notes activées géographiquement

Les notes activées géographiquement permettent de générer des notes textuelles pour les sorties Custom Chart Builder (CCB) en fonction de l’emplacement géographique du produit.

Ces notes sont stockées dans une classe d’entités ponctuelles, linéaires ou surfaciques multi-parties, où chaque enregistrement possède un champ de texte qui contient la note. Lorsqu’une nouvelle zone d’intérêt est insérée, elle est intersectée par les couches de notes activées géographiquement, et une feuille A4 distincte est ajoutée à l’exportation. S’il existe plusieurs pages de notes, une deuxième page est générée, et ainsi de suite.

Pour personnaliser les notes activées géographiquement, procédez comme suit :

1. Décompressez Notes.zip dans <ArcGIS Server installation drive>\arcgisserver\directories\maritimeserver\customchartbuilder\LayoutTemplates\Notes.gdb.

   Conseil :

   Un exemple de géodatabase de notes se trouve dans le fichier Notes.zip.

2. Ajoutez des entités surfaciques multi-parties à la classe d’entités FeatureClassForNotes située dans le dossier Notes.gdb.

   Conseil :

   • Des exemples de notes se trouvent dans la classe d’entités FeatureClassForNotes_Sample dans le dossier Notes.gdb.
   • Les polygones multi-parties vous permettent de disposer de plusieurs emplacements géographiques qui partagent le même texte de note sans redondance.
3. Modifiez les champs de la classe d’entités FeatureClassForNotes comme suit :

Remarques	Titre	Couleur	minScale	maxScale
Ce champ est obligatoire. Texte de note ou corps du paragraphe.	Il s'agit d'un champ facultatif. Nom de la note qui s’affiche au-dessus du paragraphe de note.	Il s'agit d'un champ facultatif. Valeur RVB du paragraphe et du titre de la note. Séparez les valeurs par une virgule. Le texte de la note s’affiche en noir si ce champ est vide, nul ou qu’il contient des valeurs non valides. Remarque : Ce champ ne prend pas en charge le mode CMJN.	Il s'agit d'un champ facultatif. Spécifiez l’échelle maximale de carte pour l’affichage de la note. Par exemple, si une note doit apparaître sur les cartes dont l’échelle est comprise entre 1:40000 et 1:90000, entrez 40000 dans ce champ.	Il s'agit d'un champ facultatif. Spécifiez l’échelle minimale de carte pour l’affichage de la note. Par exemple, si une note doit apparaître sur les cartes dont l’échelle est comprise entre 1:40000 et 1:90000, entrez 90000 dans ce champ.

Personnaliser les modèles de mise en page

Vous pouvez personnaliser les modèles de mise en page comme décrit ci-dessous.

Éléments cartographiques

Custom Chart Builder (CCB) fournit plusieurs modèles de mise en page pour diverses tailles de page et orientations. Chaque mise en page contient des éléments cartographiques, tels que des barres d’échelle, des flèches d’orientation vers le nord et des légendes, ainsi que des logos, du texte ou d’autres graphiques créés spécifiquement pour la carte. Les éléments de mise en page peuvent également être des fenêtres cartographiques.

Dans la dernière version de la fonctionnalité Maritime Chart Service, des notes de carte communes sont ajoutées aux tailles de page A0 et ANSI E. Vous pouvez modifier ces notes en fonction des besoins locaux. Si vous ne souhaitez pas créer des cartes au format A0 ou ANSI E avec des notes, vous pouvez supprimer ces modèles de la configuration et les remplacer par leurs versions précédentes, qui ont été renommées avec le suffixe _withoutnotes.

Conseil :

Renommez les modèles A0 et ANSI E, en ajoutant par exemple le suffixe _withnotes à leur nom. Supprimez le suffixe _withoutnotes des modèles A0 et ANSI E de sauvegarde. Le système reconnaît les modèles A0 et ANSI E qui ne contiennent plus de notes communes.

Par défaut, la police du modèle de mise en page est Arial.

Gérer les éléments

Lors de la création d’un produit, les éléments cartographiques sont mis à jour dynamiquement en fonction des modifications apportées à la carte, par exemple l’échelle, l’étendue géographique et la date de génération. Custom Chart Builder (CCB) utilise les noms des éléments pour gérer et identifier ceux qui doivent être modifiés par le script d’automatisation. Les noms des éléments cartographiques ne doivent pas être modifiés. Si les noms sont modifiés, les éléments ne peuvent plus être gérés à l’aide du script d’automatisation. Si nécessaire, vous pouvez accéder au nom en cliquant sur Element Name (Nom de l’élément) dans l’onglet Size and Position (Taille et position) de la boîte de dialogue Properties (Propriétés).

Fenêtre cartographique

La zone d’intérêt générée dans l’application Web Custom Chart Builder (CCB) est obtenue à partir des fenêtres cartographiques du modèle de mise en page. Un calculateur recherche l’angle inférieur gauche du bloc de données, puis il recherche les arêtes de gauche et du bas. La modification de la taille de fenêtre cartographique a un impact sur la taille de la zone d’intérêt.

Configurer l’application Web

Une fois que vous avez publié les fichiers de définition de service, mis à jour les modèles de mise en page, publié un service de carte avec la fonctionnalité Maritime Chart Service activée, et que vous avez mis à jour le fichier Utilities.py, vous pouvez configurer et déployer l’application Web Custom Chart Builder (CCB).

1. Accédez à <ArcGIS Server Installation Directory>\MaritimeServer\Server<version>\WebApplications et copiez le dossier CCB. Par exemple, accédez à C:\inetpub\wwwroot si vous utilisez Internet Information Server (IIS) pour déployer l’application Web.

   Remarque :

   Vous pouvez renommer le dossier CCB. Il s’agit du nom de l’application à laquelle vous accédez sur le Web.

2. Inscrivez l’application Web et obtenez l’ID d’application. Reportez-vous à la section Ajouter des applications pour plus d’informations.

   Vous pouvez également inscrire l’application Web à partir du portail.

3. Mettez à jour le fichier ccbconfig.js situé sous ccb\js.
   • Mettez à jour serviceURL en fonction de l’emplacement créé à l’étape 2 de la section Publication de fichiers de définition de service. Si les valeurs par défaut ont été utilisées, le chemin est https://gisserver.domain.com/arcgis/rest/services/CCB.
   • Mettez à jour MCSURL en indiquant le service de carte pour lequel la fonctionnalité Maritime Chart Service est activée. Si vous avez activé Maritime Chart Service pour SampleWorldCities, le chemin est https://gisserver.domain.com/arcgis/rest/services/SampleWorldCities/MapServer/exts/MaritimeChartService/MapServer.

     Remarque :

     L’application utilise le fond de carte des océans Esri par défaut. Vous pouvez sélectionner un autre fond de carte en modifiant la variable de fond de carte.

   • Mettez à jour l’ID de l’application en indiquant l’ID créé à l’étape 2. Vous pouvez ainsi vous connecter à ArcGIS Online ou à votre compte de portail.
4. Enregistrez les modifications apportées au fichier ccbconfig.js.

Vous pouvez à présent utiliser l’application Custom Chart Builder (CCB).

Inscrire l’application Web à partir du portail

Pour inscrire l’application Web à partir du portail, procédez comme suit :

1. Accédez au dossier CCB situé dans le dossier racine Web. Par exemple, accédez à C:\inetpub\wwwroot\ccb si vous utilisez Internet Information Server (IIS) pour déployer l’application Web.
2. Dans le dossier widgets\AddData, ouvrez Widget.js.
3. Mettez à jour la variable portalUrl en https://portalserver.domain.com/arcgis.
4. Cliquez sur Enregistrer.
5. Dans le dossier widgets\LayerList, ouvrez Widget.js.
6. Dans la section appConfig, mettez à jour portalUrl en https://portalserver.domain.com/arcgis.
7. Cliquez sur Enregistrer.
8. Dans le dossier js, ouvrez SignInButton.js
9. Annulez la mise en commentaire de // portalUrl: "https://portalserver.domain.com/arcgis", et mettez à jour le paramètre portalUrl.
10. Cliquez sur Enregistrer.

Dépanner les problèmes de configuration de Maritime

Pourquoi les données de la fonctionnalité Maritime Chart Service ne s’affichent-elles pas dans l’application Custom Chart Builder (CCB) ?

Vérifiez que le chemin MCSURL défini à l’étape 3 de la section Configuration de l’application Web est accessible pour l’utilisateur qui accède à l’application.

Pourquoi un message indiquant que l’opération ne peut pas être exécutée s’affiche-t-il ?

Ajoutez Configurer le compte ArcGIS Server au répertoire d’installation si l’erreur Unable to complete Operation. Error Executing tool. CalculateExtent. (Impossible d’exécuter l’opération. Erreur lors de l’exécution de l’outil. CalculateExtent.) se produit.

Que faire si la fonctionnalité Maritime Chart Service ne s’affiche pas ou disparaît après la modification des propriétés d’affichage ?

Déterminez si la longueur maximale de l’URL du serveur (2 048 caractères) a été dépassée lors de l’utilisation des paramètres d’affichage. Si tel est le cas, augmentez la taille maximale autorisée de l’URL à l’aide d’un fichier web.config.xml.

Que faire si une erreur liée à l’échec de l’activation de HTTPS sur le serveur Web se produit ?

Vérifiez que vous avez activé HTTPS sur le serveur Web.