Recenser les services web géographiques¶

La première étape de la démarche de documentation des services consiste à les recenser.

Fonctionnement de la pré-documentation automatique des services¶

Les capacités des services géographiques sont automatiquement analysées pour documenter la fiche de métadonnées. Il s'agit donc seulement de soumettre l'URL GetCapabilities à Isogeo, qui se charge alors d'extraire toutes les informations utiles.

Prérequis¶

• l'option "Autoriser la création manuelle de fiches de métadonnées" doit être activée ;
• disposer des URLs GetCapabilities (ou équivalents ESRI) de services compatibles et disponibles.

Dans l'idéal, les services sont accessibles publiquement ou du moins par les domaines *.isogeo.com en mode SaaS.

Recenser un service accessible par Isogeo¶

Pour l'exemple, les services WMS et WFS des données Corine Land Cover sont utilisés.

Aperçus de GetCapabilities
WMS
WFS

1. Dans l'inventaire, cliquer le bouton + Créer ;
2. Dans le formulaire, choisir d'une fiche relative à un service;

3. Coller l'URL GetCapabilities du service à scanner (voir les syntaxes des URL) : si l'URL est correctement formatée et le service joignable, son format est automatiquement proposé ;

   

4. En cliquant sur Créer, le service est donc "scanné" :

Métadonnées récupérées
Titre, Résumé, Mots-clés, Format
Contact (si adresse email présente)
Format, version et opérations disponibles (onglet Avancé)
Couches disponibles (onglet Ressources)

Le service est désormais documenté. Il est désormais temps d'associer les couches listées avec les jeux de données inventoriés.

Recenser un service privé ¶

Les capacités des services géographiques ne sont ni plus ni moins des fichiers normalisés (XML pour les service OGC, JSON pour ceux d'Esri). Il est donc possible de les importer depuis l'interface.

1. Télécharger le fichier des capacités depuis son URL. Par exemple pour les services Esri :

   1. Sur la page du service, faire un clic droit sur le lien JSON

      

   2. Sauvegarder en tant que JSON (selon votre navigateur, bien vérifier que l'extension ne soit pas forcée en .txt)

      

2. Créer la fiche de service en donannt l'URL de base et le format : cliquer sur Créer sans tenir compte du message rouge indiquant que le service n'est pas joignable ;

3. Une fois la fiche crée, cliquer Modifier puis sur Importer les capacités ;
4. Sélectionner le fichier des capacités et cliquer sur Importer;
5. Fermer la modale de confirmation et recharger la page : les métadonnées du service désormais disponibles dans Isogeo.

Noter que cette démarche doit être reconduite à chaque mise à jour du service

Voici la procédure résumée en images :

Recensement manuel des couches d'un service ¶

Si vous souhaitez documenter un service ne correspondant pas aux prérequis, il est possible de renseigner la fiche manuellement. Après avoir crée la fiche, il suffit de cliquer sur + Ajouter une couche et d'entrer son identifiant (obligatoire) et un titre (facultatif).

Attribuer des identifiants uniques aux couches de vos services Esri ¶

Pour faciliter les mises à jour de vos fiches de service Esri, nous vous conseillons de fixer les identifiants des couches dans le projet avec lequel vous publiez le service. Cela évite que les identifiants des couches soit modifiés lorsque vous inversez l'ordre des couches dans votre projet.

Ainsi, vous n'aurez pas à refaire les associations avec les données dans vos fiches de services si une nouvelle couche est ajoutée au projet car elle ne prendra pas un identifiant d'une couche existante. Cela vous permet aussi de mettre à jour facilement la fiche de service en ajoutant la nouvelle couche manuellement.

Pour ce faire, il suffit de cocher la case Autoriser l’attribution d’ID numériques uniques pour le partage de couches web dans les propriétés de la carte du projet (cf. Documentation Esri).