Utiliser les propriétés de service WMS disponibles

Cette rubrique présente les propriétés disponibles lors de l’utilisation d’un fichier de fonctionnalités généré par le système pour des services WMS.

Accéder aux propriétés du service WMS dans le gestionnaire

Vous pouvez renseigner ou modifier les propriétés d’un service WMS dans ArcGIS Server Manager. Pour cela, procédez comme suit :

1. Ouvrez le gestionnaire et connectez-vous. Si vous avez besoin d'aide pour cette étape, reportez-vous à la rubrique Se connecter au gestionnaire.
2. Cliquez sur Services > Gérer des services.
3. Dans le module Gérer des services, repérez le service désiré et cliquez sur Mettre à jour. Si votre service n’apparaît pas dans la liste, recherchez-le dans un sous-dossier du dossier Site (root).
4. Dans le module d'édition, cliquez sur Fonctionnalités.
5. Dans la liste des fonctionnalités, cliquez sur WMS et vérifiez que WMS est activé.
6. Dans la liste WMS Configuration (Configuration WMS), sélectionnez Enter service properties below (Saisir les propriétés du service ci-dessous).
7. Renseignez ou modifiez les propriétés du service WMS.
8. Cliquez sur Save and Restart (Enregistrer et redémarrer). Les modifications apportées au service sont appliquées sur-le-champ.

Propriétés du service WMS

Le tableau suivant répertorie les propriétés disponibles pour les services WMS et propose une brève description de chacune d'entre elles :

Propriété	Description
Nom	Type du service OGC. Cette propriété est automatiquement spécifiée par ArcGIS Server et ne doit pas être modifiée.
Titre	Nom du service de carte ou d’imagerie utilisé pour créer le service WMS. Cette propriété est automatiquement spécifiée par ArcGIS Server et ne doit pas être modifiée.
Résumé	Description qui fournit davantage d’informations sur le service WMS. Par exemple : WMS service maintained by Acme Corporation. Contact: [e-mail]. High-quality map showing eagle nests and possible nesting locations.
Mots-clés	Liste de mots-clés ou d’expressions clés décrivant le service WMS qui facilitent les recherches dans le catalogue. Par exemple : map, bird, eagle, nest, site
Ressource en ligne	La propriété OnlineResource indique l’URL du service WMS. Un client WMS doit pouvoir communiquer correctement avec votre service WMS. Cette propriété est automatiquement spécifiée par ArcGIS Server et ne doit pas être modifiée.
Personne à contacter	Personne principale à contacter pour le service WMS. Par exemple : John Smith
Fonction du contact	Fonction de la personne principale à contacter pour le service WMS. Par exemple : IT Analyst
Contact de l´organisation	Nom de l’organisation ayant créé le service WMS. Par exemple : NASA
Type d’adresse	Type d’adresse utilisé par l’organisation ayant créé le service WMS. Par exemple : postal
Adresse	Adresse de l’organisation ayant créé le service WMS. Par exemple : 380 New York Street
Ville	Ville dans laquelle se trouve l’organisation qui a créé le service WMS. Par exemple : Redlands
Département ou région	État dans lequel se trouve l’organisation qui a créé le service WMS. Par exemple : California
PostCode	Code postal de la ville dans laquelle se trouve l’organisation qui a créé le service WMS. Par exemple : 92373
Pays	Pays dans lequel se trouve l’organisation qui a créé le service WMS. Par exemple : USA
ContactVoiceTelephone	Numéro de téléphone auquel la personne principale à contacter pour le service WMS peut être jointe. Par exemple : [phone]
ContactFacsimileTelephone	Numéro de télécopie auquel la personne principale à contacter pour le service WMS peut être jointe. Par exemple : [phone]
ContactElectronicMailAddress	Adresse e-mail de la personne principale à contacter pour le service WMS. Par exemple : [e-mail]
Frais	Texte décrivant les frais appliqués pour accéder au service WMS. Par exemple : none
Contraintes d’accès	Texte décrivant les restrictions et les conditions légales préalables à l'accès et à l'utilisation du service WMS. For internal use only. Do not distribute.
Chemin SLD ou URL	Les SLD vous permettent de publier plusieurs styles pour chaque couche WMS. Si vous liez un fichier SLD au service WMS actif, vous devez indiquer le chemin d’accès SLD ou l’URL sur l’URL, le chemin d’accès UNC ou l’emplacement physique d’un fichier XML SLD. Le compte ArcGIS Server doit pouvoir accéder à l’emplacement pour que ArcGIS Server puisse lire le fichier XML SLD. Pour en savoir plus sur les descripteurs SLD, reportez-vous à la rubrique Utilisation de descripteurs SLD avec les services WMS.
Systèmes de référence spatiale supplémentaires	Cette propriété permet d’ajouter des systèmes de référence spatiale aux services WMS. Par défaut, les services WMS ne répertorient que deux systèmes de référence spatiale : EPSG:4326 (ou CSR:84 pour WMS 1.3.0) et la référence spatiale du service de carte dans lequel WMS est activé. Pour répertorier davantage de systèmes de référence spatiale, séparez les systèmes de référence spatiale par une virgule (,). Par exemple, EPSG:4267,EPSG:4269,EPSG:102113. L’espace de noms EPSG (par exemple, EPSG) et l’ID EPSG (par exemple, 4267) doivent être séparés par un signe deux-points (:), sinon la référence spatiale sera ignorée par le serveur.
Systèmes de référence spatiale personnalisés	La propriété listCustomCRS vous permet de définir une projection personnalisée ou la représentation textuelle connue d’une projection dans un service WMS. Cela signifie que les éditeurs et les utilisateurs du WMS peuvent : attribuer des identifiants aux projections personnalisées et les annoncer via le fichier de fonctionnalités WMS ; remplacer une projection existante par une chaîne WKT ; demander une carte dans une projection en particulier en spécifiant directement la représentation textuelle connue.
Tolérance d’identification (pixels)	Cette propriété vous permet de définir la tolérance (en pixels) avec laquelle l’opération GetFeatureInfo renverra des informations sur les entités au client lorsqu’il clique sur l’écran. Par exemple, si vous définissez une tolérance de 10 pixels pour votre WMS, les informations sont renvoyées au client tant qu'il clique à 10 pixels ou moins de l'entité sur l'écran.
Utiliser les noms de couche du document ArcMap	Par défaut, cette option est désactivée, ce qui signifie que les couches du service WMS sont représentées par des nombres entiers basés sur zéro, ce qui indique leur position dans la table des matières (du haut vers le bas). Depuis la version 10.8, aucune restriction ne s’applique aux caractères pouvant être utilisés dans un nom de couche, et le serveur WMS génère un identifiant unique pour le nom si nécessaire. Remarque : Le nom affecté au serveur n’a pas d’incidence sur le titre. Le serveur WMS affecte un nom unique en substituant les caractères (il remplace les caractères par un trait de soulignement) et en ajoutant un suffixe numérique. Tel est le cas dans les instances suivantes : Une carte contient au moins deux couches du même nom. Un nom de couche commence par un chiffre. Un nom de couche contient des espaces ou des caractères spéciaux, notamment ?,&,=,+,`,#,%,^,{},[],<>,,,|," Remarque : Le suffixe numérique est une valeur calculée en fonction de la chaîne originale et n’est pas aléatoire. Ainsi, il reste identique tant que le nom de couche n’est pas modifié. Par exemple, si deux couches sont nommées Couche "1" et Couche [1], les deux noms deviennent Couche__1_. Pour les différencier, un nombre unique est ajouté en tant que suffixe à la chaîne modifiée. Dans cet exemple, les noms de couche modifiés seraient Couche__1_1234 et Couche__1_1256 respectivement.
Forcer le changement des dimensions de la carte en fonction de la largeur et de la hauteur	Cette propriété détermine si les dimensions de la carte sont modifiées. Par défaut, cette option n'est pas activée, ce qui signifie que les pixels représentant la zone de la carte sont étirées pour présenter la hauteur et la largeur exigées par les clients WMS. Si cette option est sélectionnée, la proportion de la hauteur et de la largeur des pixels reste inchangée. Lorsque la vue générale d'une carte doit être affichée, il est possible qu'elle ne tienne pas dans la surface d'affichage entière.
Attribuer un identifiant de nom à une couche	Par défaut, les services WMS n’attribuent pas de propriété <Name> aux groupes de couches. La propriété namedLayersMode vous permet de contrôler comment les identifiants de nom sont attribués aux couches dans un service WMS. Si la propriété est définie sur allLayers, des identifiants de nom sont attribués aux groupes de couches et à leurs sous-couches. Si elle est définie sur subLayers ou n’est pas spécifiée, des identifiants de nom sont attribués uniquement aux sous-couches d’un groupe de couches. Cela signifie que les clients ne peuvent pas inclure de groupe de couches dans une demande GetMap, mais doivent spécifier chaque sous-couche individuellement à l’intérieur du groupe de couches.

Définir des propriétés dans le répertoire administrateur

La plupart des propriétés peuvent être configurées à l’aide de ArcGIS Server Manager. Si une propriété ne peut pas être modifiée à l’aide de Manager, elle peut être modifiée ou ajoutée à l’aide du répertoire administrateur de ArcGIS Server.

Pour mettre à jour des propriétés à l’aide du répertoire, procédez comme suit :

1. Ouvrez le répertoire d’administrateur dans un navigateur et connectez-vous. Généralement, l’URL du répertoire est https://gisserver.domain.com:6443/arcgis/admin/.
2. Cliquez sur Services.
3. Sur la page Folder (Dossier), cliquez sur le nom du service de carte WMS à mettre à jour. Si votre service n’apparaît pas dans la liste, recherchez-le dans les sous-dossiers du dossier racine.
4. Sur la page du service, faites défiler l’affichage vers le bas et cliquez sur edit (modifier).
5. Dans la boîte de dialogue Service Properties (Propriétés du service), recherchez la section "typeName": "WMSServer".
6. Dans la section properties, ajoutez les propriétés et spécifiez les paramètres de votre choix, par exemple :

   "properties": {
      "name": "SampleWorldCities",
      "title": "WMS",
      "abstract": "",
      "keyword": "",
      "onlineResource": "",
      "contactPerson": "",
      "contactPosition": "",
      "contactOrganization": "",
      "address": "",
      "addressType": "",
      "city": "",
      "stateOrProvince": "",
      "postCode": "",
      "country": "",
      "contactVoiceTelephone": "",
      "contactFacsimileTelephone": "",
      "contactElectronicMailAddress": "",
      "fees": "",
      "accessConstraints": "",
   
      "customGetCapabilities": "false",
      "pathToCustomGetCapabilitiesFiles": "",
   
      "pathToCustomSLDFile": "",
      "listSupportedCRS": "",
      "listCustomCRS": "",
      "identifyToleranceInPixel": "10",
      "inheritLayerNames": "false",
      "reaspect": "true",
      "namedLayersMode": "subLayers",
   }

7. Cliquez sur Enregistrer les mises à jour.

Les propriétés sont ajoutées à votre service WMS.

Caractères spéciaux dans les propriétés du service

Les propriétés du service ne peuvent contenir aucun des caractères suivants : &, <, >, ", '. Si vous devez utiliser l’un de ces caractères, vous devez appliquer la séquence d’échappement appropriée du tableau ci-dessous :

Caractère	Caractère en remplacement
&	&
<	&lt;
>	&gt;
"	&quot;
’	&apos;

Utiliser des fichiers de fonctionnalités externes avec les services WMS

Chaque service WMS expose des métadonnées au niveau du service par l'intermédiaire de son fichier de fonctionnalités. Ce fichier est la réponse XML que les clients reçoivent lorsqu’ils envoient une requête GetCapabilities sur le service. La configuration de fichiers de fonctionnalités externes vous permet d'effectuer les opérations suivantes :

• Ajouter des métadonnées concernant le service
• Ajouter des métadonnées concernant chaque couche
• Personnaliser des informations de légende pour chaque couche

Pour utiliser des fichiers de fonctionnalités externes avec des services WMS, vous devez créer les fichiers et les configurer afin de les utiliser avec vos services WMS. Pour ce faire, reportez-vous aux sections ci-dessous.

Remarque :

Si vous utilisez des fichiers de fonctionnalités externes pour votre service WMS, vous êtes tenu de valider les fichiers de fonctionnalités conformément à la structure DTD ou XML définie par l'OGC. Vous devez également vérifier toutes les synchronisations entre vos fichiers de fonctionnalités et la carte à partir de laquelle le service WMS est publié.

Créer des fichiers de fonctionnalités externes

Pour configurer un service WMS en vue d'utiliser des fichiers de fonctionnalités externes, vous devez préparer au moins un fichier de fonctionnalités WMS. Vous pouvez créer le fichier à partir de zéro, mais il est souvent plus facile d'utiliser un fichier de fonctionnalités générées par le système comme modèle.

Par défaut, des fichiers de fonctionnalités générés par le système sont créés automatiquement à chaque fois que vous envoyez une demande GetCapabilities WMS au service. Pour utiliser un fichier de fonctionnalités généré par le système en tant que modèle, vous devez envoyer manuellement la demande GetCapabilities et enregistrer la réponse au format XML. Si vous souhaitez que votre service WMS prenne en charge différentes versions du protocole WMS (1.0.0, 1.1.0, 1.1.1 et 1.3.0, par exemple), vous devez disposer d'un fichier de fonctionnalités pour chaque version de WMS à prendre en charge.

Procédez comme suit pour créer des fichiers de fonctionnalités externes pour votre service WMS :

1. Si tel n'est pas encore le cas, publiez un service de carte ou d'imagerie et activez la fonctionnalité WMS. Pour plus d'informations, reportez-vous à la rubrique Services WMS.
2. Dans un navigateur web, saisissez l’URL de votre service WMS. L’URL est au format suivant :

   https://gisserver.domain.com:6443/arcgis/services/folder/service/service type(can be MapServer or ImageServer)/WMSServer

3. Ajoutez ?service=wms&request=GetCapabilities&version=1.0.0 à la fin de l'URL du service et appuyez sur Entrée. Le XML affiché dans le navigateur correspond au fichier de fonctionnalités WMS de version 1.0.0 de votre service.
4. Enregistrez les résultats en tant que fichier .xml. Le nom de fichier doit respecter le format <préfixe><version WMS>xml. Par exemple, lorsque vous enregistrez le fichier .xml obtenu suite à une demande GetCapabilities WMS version 1.0.0, le fichier doit utiliser un préfixe commun (par exemple Roads), suivi du numéro de version WMS à trois chiffres (100). Le fichier obtenu s'appelle Roads100.xml.
5. Répétez les étapes 3 et 4 pour chaque version WMS que vous souhaitez prendre en charge, par exemple, 1.1.0, 1.1.1 et 1.3.0.
6. Configurez et personnalisez les informations de métadonnées des couches WMS dans chaque fichier de fonctionnalités.
7. Déplacez tous les fichiers de fonctionnalités dans un dossier commun, accessible via HTTP. Il s'agit généralement d'un répertoire virtuel sur le serveur Web de votre organisation.

Configurer un service WMS pour utiliser des fichiers de fonctionnalités externes dans ArcGIS Server Manager

Pour configurer votre service WMS afin d’utiliser des fichiers de fonctionnalités externes, vous devez mettre à jour le service WMS pour qu’il référence l’URL de vos fichiers de fonctionnalités dans ArcGIS Server Manager.

1. Démarrez ArcGIS Server Manager et connectez-vous en tant qu’administrateur de ArcGIS Server. Si vous avez besoin d’aide pour cette étape, reportez-vous à la rubrique Se connecter à ArcGIS Server Manager.
2. Cliquez sur Services > Gérer des services.
3. Dans le module Gérer des services, repérez le service désiré et cliquez sur Mettre à jour. Si votre service n’apparaît pas dans la liste, recherchez-le dans un sous-dossier du dossier Site (root).
4. Dans le module d'édition, cliquez sur Fonctionnalités.
5. Dans la liste des fonctionnalités, cliquez sur WMS.
6. Dans la liste WMS configuration, sélectionnez Utiliser les fichiers de fonctionnalités externes.
7. Dans la zone de texte Specify the location and prefix (Spécifier l’emplacement et le préfixe), indiquez l’URL du dossier dans lequel vous avez placé vos fichiers de fonctionnalités, sans oublier le préfixe commun que vous avez utilisé pour les fichiers. Par exemple, si l’URL d’accès au dossier contenant vos fichiers est https://webserver.domain.com/arcgis/WMS/services et que le préfixe commun que vous avez utilisé est Roads, l’URL à indiquer dans la zone de texte Specify the location and prefix (Spécifier l’emplacement et le préfixe) est https://webserver.domain.com/arcgis/WMS/services/Roads.
8. Cliquez sur Save and Restart (Enregistrer et redémarrer).