Définir les propriétés d’un service WFS

Cette rubrique présente les propriétés disponibles lors de l’utilisation d’un fichier de fonctions généré par le système pour des services WFS. Reportez-vous à la rubrique Utilisation des fichiers de fonctionnalités externes avec les services WFS pour en savoir plus sur la définition de métadonnées WFS à l’aide d’un fichier de fonctionnalités externe.

Accéder aux propriétés d’un service WFS

Vous pouvez accéder aux propriétés d’un service WFS à l’aide d’ArcGIS Server Manager ou lorsque vous configurez une couche web dans ArcGIS Pro.

Accéder aux propriétés d’un service WFS dans Manager

Vous pouvez spécifier ou modifier les propriétés d’un service WFS dans ArcGIS Server Manager. Pour ce faire, procédez comme suit :

1. Ouvrez le gestionnaire et connectez-vous. Si vous avez besoin d’aide pour cette étape, reportez-vous à la rubrique Connexion à 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 (racine).

4. Dans le module d’édition, cliquez sur Fonctionnalités.
5. Dans la liste des fonctionnalités, cliquez sur WFS et vérifiez que WFS est activé.
6. Dans la liste WFS Configuration (Configuration WFS), 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 WFS.
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 WFS

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

Propriété	Description
Nom	Nom du service de carte ayant été utilisé pour créer le service WFS. Cette propriété est automatiquement spécifiée par ArcGIS Server et peut être modifiée.
Titre	Titre facile à lire permettant d’identifier rapidement le service WFS, par exemple : Eagle nesting locations in Marion County
Résumé	Description qui fournit davantage d’informations sur le service WFS, par exemple : WFS service maintained by Acme Corporation. Contact : [e-mail]. Carte de qualité montrant les nids et les emplacements de nidification possibles.
Mots-clés	Liste de mots-clés ou d’expressions clés décrivant le service WFS qui facilitent les recherches dans le catalogue, par exemple : carte, oiseau, aigle, nid, site
ServiceType	Type de service OGC, par exemple : WFS
ServiceTypeVersion	Version du type de service OGC, par exemple : 1.1.0
Frais	Texte décrivant les frais appliqués pour l’accès au service WFS, par exemple : aucun
Contraintes d’accès	Texte décrivant les restrictions et les conditions légales préalables à l’accès et à l’utilisation du service WFS, par exemple : Pour utilisation en interne uniquement. Ne pas distribuer.
ProviderName	Nom du fournisseur du service WFS, par exemple : NASA
ProviderSite	Lien vers un site contenant des informations sur le fournisseur du service WFS, par exemple : https://www.noaa.gov
IndividualName	Personne principale à contacter pour le service WFS, par exemple : John Smith
PositionName	Fonction de la personne principale à contacter pour le service WFS, par exemple : Analyste informatique
Phone	Numéro de téléphone auquel la personne principale à contacter pour le service WFS peut être jointe, par exemple : [phone]
Facsimile	Numéro de télécopie auquel la personne principale à contacter pour le service WFS peut être jointe, par exemple : [phone]
DeliveryPoint	Adresse du fournisseur du service WFS, par exemple : 21 rue des Capucins
Ville	Ville dans laquelle réside le fournisseur du service WFS, par exemple : Redlands
AdministrativeArea	Zone administrative dans laquelle réside le fournisseur du service WFS, par exemple : Californie
PostalCode	Code postal de la ville dans laquelle réside le fournisseur du service WFS, par exemple : 92373
Pays	Pays dans lequel réside le fournisseur du service WFS, par exemple : États-Unis
ElectronicMailAddress	Adresse e-mail de la personne principale à contacter pour le service WFS, par exemple : [e-mail]
Ressource en ligne	La propriété OnlineResource indique l’URL du service WFS. Un client WFS doit pouvoir communiquer correctement avec votre service WFS. Cette propriété est automatiquement spécifiée par ArcGIS Server et ne doit pas être modifiée.
HoursOfService	Heures auxquelles le contact principal est disponible pour répondre à des requêtes, par exemple : 24/7
ContactInstructions	Instructions spécifiques à prendre en compte avant de contacter la personne principale affectée au service WFS, par exemple : Envoyer un courrier électronique à John pour les demandes standard, téléphonez à John pour les demandes urgentes.
Rôle	Fonction assumée par la personne responsable du service WFS, par exemple : PointOfContact
Espace de noms	La propriété d’espace de noms WFS permet de faire la distinction entre le vocabulaire XML et tout autre vocabulaire. Cette propriété est automatiquement spécifiée par ArcGIS Server mais peut être modifiée.
Préfixe	Le préfixe d’espace de noms WFS est une propriété unique qui est utilisée en réponse à la requête GetFeatureRequest WFS. Cette propriété est automatiquement spécifiée par ArcGIS Server et peut être modifiée. Certains mots-clés sont réservés et ne peuvent pas être utilisés comme préfixe car ils entrent en conflit avec d’autres espaces de noms définis dans le service WFS. Les mots-clés réservés qui ne doivent pas être employés comme préfixe sont les suivants : wfs, ogc, fes, gml, ows, xs, xsi, gml32, xlink, xsi et schemaLocation.
Chemin ou URL vers le fichier de requêtes stockées	Un fichier de requêtes stockées est un fichier XML qui gère une liste de requêtes stockées créées par l’éditeur et pertinentes pour un service donné. Placez le fichier de requêtes stockées dans un dossier accessible sur le Web. Indiquez ensuite l’emplacement du fichier dans ArcGIS Server Manager ou ArcGIS Pro. Pour des instructions complètes, reportez-vous à la rubrique Configuration d’un service WFS pour utiliser des requêtes stockées.
Activer les transactions	La case à cocher Enable Transactions (Activer les transactions) permet d’autoriser l’application de mises à jour par l’intermédiaire d’un service WFS-T. Pour plus d’informations, consultez la rubrique Mise à jour web à l’aide de services WFS.
Activer le verrouillage des entités	Lorsqu’un client WFS se connecte à un service WFS qui a été publié alors que des transactions sont activées, vous pouvez verrouiller sur le serveur les entités et les lignes mises à jour en sélectionnant la propriété Activer le verrouillage des entités. Remarque : Cette propriété n’est plus applicable aux services WFS ultérieurs à ArcGIS Server 10.5.1.
Activer le nombre maximum d’entités	Cette propriété vous permet de limiter le nombre d’entités renvoyées par le serveur à un client WFS pour toute opération de requête donnée. Lorsque cette option n’est pas sélectionnée, toutes les entités sont renvoyées.
Nombre maximum d’entités	Lorsque la propriété Enable maximum number of features (Activer le nombre maximum d’entités) est cochée, vous pouvez utiliser cette propriété pour indiquer le nombre maximum d’entités à renvoyer. Par défaut, la valeur est définie sur 1000. N’oubliez pas qu’en spécifiant un nombre important d’entités à renvoyer par le serveur, vous risquez de limiter les performances des applications client et de votre serveur SIG.
Échanger l’ordre des axes	Les entités renvoyées dans certains systèmes de coordonnées géographiques (WGS 84, par exemple) suivent l’ordre des axes latitude, longitude (y,x) par défaut. Ceci est conforme aux spécifications WFS 1.0.0, 1.1.0 et 2.0.0. Certains clients WFS s’attendent à ce que les coordonnées renvoyées suivent l’ordre des axes x,y. Si vous souhaitez utiliser ces clients, vous pouvez inverser l’ordre des axes du service WFS en sélectionnant l’option Swap (Échanger) dans la liste déroulante. Par défaut, l’ordre des axes n’est pas inversé. Remarque : Cette propriété a été introduite dans ArcGIS Server 10.7.

Héritage :

Dans les versions 10.0 et antérieures, vous pouviez définir une propriété devant contenir le type de nom complet des services WFS définis à partir de géodatabases d’entreprise. Par exemple, le nom type d’une classe d’entités appelée bob.buildings devrait être buildings par défaut. Dans les versions 10.1 et ultérieures, les services WFS incluent toujours le type de nom complet.

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;

Configurer un service WFS pour utiliser des requêtes stockées

Les requêtes stockées permettent le stockage de requêtes de filtre complexes par WFS (Web Feature Service) 2.0 et leur exécution via une requête de base. La configuration de requêtes stockées offre de nombreux avantages qui élargit l’utilisation de WFS 2.0 dans les applications :

• Des requêtes complexes peuvent être rationalisées afin de pouvoir être exécutées en tant que requêtes GET HTTP.
• Un WFS peut être implémenté de façon à prendre en charge uniquement les requêtes stockées afin que l’administrateur puisse contrôler la façon dont les utilisateurs accèdent aux données.
• Les requêtes stockées peuvent réduire les coûts de développement des applications, car elles peuvent être configurées pour prendre en charge des requêtes spécifiques au lieu de requêtes ad hoc complexes et d’expressions XPath.
• Des interfaces RESTful peuvent être définies, outre le WFS, avec HTTP GET/POST et SOAP afin de permettre l’utilisation du WFS dans des applications client légères.

Pour utiliser des requêtes stockées avec WFS 2.0, configurez le service pour référencer l’URL de votre fichier de requêtes stockées. Vous pouvez le faire dans ArcGIS Server Manager ou ArcGIS Pro. Pour apprendre à créer des fichiers de requêtes stockées, reportez-vous à la rubrique Communication avec un service WFS dans un navigateur Web.

Remarque :

Les requêtes stockées sont uniquement prises en charge par l’implémentation de WFS 2.0, elles ne sont pas prise en charge par WFS 1.0.0 ou 1.1.0.

Effectuer la configuration dans ArcGIS Server Manager

Procédez comme suit pour effectuer la configuration dans ArcGIS Server Manager :

1. Démarrez ArcGIS Server Manager et connectez-vous. Si vous avez besoin d’aide pour cette étape, reportez-vous à la rubrique Se connecter à 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 WFS.
6. Dans la zone de texte Path or URL to stored query file (WFS 2.0) (Chemin ou URL vers le fichier de requête stocké [WFS 2.0]), saisissez le chemin du fichier ou l’URL vers le fichier de requêtes stockées, par exemple
   • Chemin d’accès au fichier : C:\WFS_Testing\WFSStoredQueryFile.xml ou \\share\WFS_Testing\WFSStoredQueryFile.xml
   • URL : http://myserver.domain.com/WFSStoredQueryFile.xml
7. Cliquez sur Save and Restart (Enregistrer et redémarrer).

Effectuer la configuration dans ArcGIS Pro

Procédez comme suit pour effectuer la configuration dans ArcGIS Pro :

1. Lorsque vous configurez une couche d’entités web dans ArcGIS Pro, sous Additional Layers (Couches supplémentaires), cochez la case WFS pour activer la fonctionnalité WFS.
2. En regard de la case WFS cochée, cliquez sur le bouton Configure Web Layer Properties (Configurer les propriétés de la couche web).

   Une boîte de dialogue s’ouvre dans laquelle vous pouvez définir les propriétés WFS du service.

3. Dans la zone de texte Path or URL to stored query file (WFS 2.0) (Chemin ou URL vers le fichier de requête stocké (WFS 2.0)), saisissez le chemin du fichier ou l’URL vers le fichier de requêtes stockées ; par exemple :
   • Chemin d’accès au fichier : C:\WFS_Testing\WFSStoredQueryFile.xml ou \\share\WFS_Testing\WFSStoredQueryFile.xml
   • URL : http://myserver.domain.com/WFSStoredQueryFile.xml

   Lorsque la couche d’entités web est partagée, le service WFS utilise le fichier de requête stocké spécifié.

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

Chaque service WFS 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 informations de métadonnées au niveau du service aux fichiers de fonctionnalités WFS,
• ajouter des informations de métadonnées au niveau des entités aux fichiers de fonctionnalités WFS,
• Ajoutez des systèmes de références spatiales prédéfinis supplémentaires à partir de la liste des projections prédéfinies d’ArcGIS Server.
• améliorer les performances lorsque vous vous connectez à votre service WFS, et particulièrement lorsque votre service comprend de nombreux noms de types.

Pour utiliser des fichiers de fonctionnalités externes avec des services WFS, créez les fichiers, puis configurez-les afin de les utiliser avec vos services WFS. Pour ce faire, reportez-vous aux sections ci-dessous.

Remarque :

Si vous utilisez des fichiers de fonctionnalités externes pour votre service WFS, 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 assurer la synchronisation de vos fichiers de fonctionnalités et du document ArcMap source ou de la géodatabase à partir desquels le service WFS est publié.

Créer des fichiers de fonctionnalités externes

Pour configurer un service WFS en vue d’utiliser des fichiers de fonctionnalités externes, préparez trois fichiers de fonctionnalités WFS : un pour la version 1.0.0, un pour la version 1.1.0 et un pour la version 2.0. Vous pouvez créer les fichiers de A à Z, mais il est souvent plus facile d’utiliser les fichiers de fonctionnalités générés par le système comme modèles.

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 requête GetCapabilities WFS au service. Pour utiliser les fichiers de fonctionnalités générés par le système en tant que modèles, envoyez manuellement les requêtes GetCapabilities et enregistrez les réponses au format XML.

Suivez les étapes ci-dessous pour créer des fichiers de fonctionnalités externes pour votre service WFS.

1. Si vous ne l’avez pas déjà effectué, publiez une carte et activez la fonctionnalité WFS. Pour plus d’informations, reportez-vous à la rubrique Services WFS.
2. Dans un navigateur web, saisissez l’URL de votre service WFS. L’URL est au format suivant :

   https://gisserver.domain.com:6443/arcgis/services/folder/service/MapServer/WFSServer

3. Ajoutez ?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 aux fonctionnalités WFS de version 1.0.0 de votre service.

4. Enregistrez les résultats en tant que fichier XML.

   Le nom du fichier doit respecter le format <préfixe><version WFS>.xml. Par exemple, lorsque vous enregistrez le fichier XML obtenu d’une requête GetCapabilities de version WFS 1.0.0, le fichier doit utiliser un préfixe commun (par exemple Roads), suivi du numéro de version WFS à trois chiffres (100). Le fichier obtenu est Roads100.xml.

5. Répétez les étapes 3 et 4 pour créer les fichiers de fonctionnalités pour la version 1.1.0 et 2.0 de WFS.
6. Configurez et personnalisez les informations de métadonnées des couches WFS 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 WFS pour utiliser des fichiers de fonctionnalités externes

Pour configurer votre service WFS afin d’utiliser les fichiers de fonctionnalités externes, mettez à jour le service WFS pour référencer l’URL de vos fichiers de fonctionnalités. Vous pouvez le faire dans ArcGIS Server Manager ou ArcGIS Pro.

Effectuer la configuration dans ArcGIS Server Manager

Procédez comme suit pour effectuer la configuration dans ArcGIS Server Manager :

1. Ouvrez ArcGIS Server Manager et connectez-vous.
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 WFS.
6. Dans la liste WFS configuration, sélectionnez Utiliser les fichiers de fonctionnalités externes.
7. Dans la zone 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 du dossier contenant vos fichiers est https://webserver.domain.com/arcgis/WFS/services et que le préfixe commun que vous avez utilisé est Roads, l’URL à indiquer dans la zone Specify the location and prefix (Spécifier l’emplacement et le préfixe) est https://webserver.domain.com/arcgis/WFS/services/Roads.

8. Cliquez sur Save and Restart (Enregistrer et redémarrer).

Effectuer la configuration dans ArcGIS Pro

Procédez comme suit pour effectuer la configuration dans ArcGIS Pro :

1. Lorsque vous configurez une couche d’entités web dans ArcGIS Pro, sous Additional Layers (Couches supplémentaires), cochez la case WFS pour activer la fonctionnalité WFS.
2. En regard de la case WFS cochée, cliquez sur le bouton Configure Web Layer Properties (Configurer les propriétés de la couche web).

   Une boîte de dialogue s’ouvre dans laquelle vous pouvez définir les propriétés WFS du service.

3. Dans la liste WFS configuration, sélectionnez Utiliser les fichiers de fonctionnalités externes.
4. Dans la zone 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 du dossier contenant vos fichiers est https://webserver.domain.com/arcgis/WFS/services et que le préfixe commun que vous avez utilisé est Roads, l’URL à indiquer dans la zone Specify the location and prefix (Spécifier l’emplacement et le préfixe) est https://webserver.domain.com/arcgis/WFS/services/Roads.

   Lorsque la couche d’entités web est partagée, le service WFS utilise les fichiers de fonctionnalités externes spécifiés.

Contrôler le nombre d’entités renvoyées par le service

Pour contrôler le nombre maximum d’entités renvoyées par le service, définissez la propriété DefaultMaxFeatures. La propriété DefaultMaxFeatures n’est prise en charge qu’avec WFS 1.1.0. Par conséquent, si vous utilisez des fichiers de fonctionnalités externes, il vous suffit de définir cette propriété dans le fichier faisant référence aux propriétés 1.1.0.

Dans un fichier de fonctionnalités externe, la propriété DefaultMaxFeatures est définie dans la section des métadonnées du fichier WFSServer 1.1.0, comme suit :

<ows:Constraint name="DefaultMaxFeatures">
 <ows:Value>200</ows:Value>
</ows:Constraint>