Spécifications du service web des référentiels alphanumériques du Sandre

Le Sandre a élaboré le scénario technique * (accessible dans chapitre ci-dessous intitulé 'Documents de spécification associés - Accès aux documents') pour l'exploitation et la diffusion des jeux de données de référence alphanumériques par des services web . Notons que ces données sont également accessibles soit :

- en téléchargeant le fichier complet de chaque référentiel * (cf. chapitre ci-dessous 'Associés à ce document - Jeux de données de référence * '),

- en utilisant un moteur de recherche (cf. chapitre ci-dessous intitulé 'Données de référence - Rechercher une donnée d'un jeu').

Fonctionnalités

Le service web * des référentiels * du Sandre permet :

- de rechercher et télécharger les jeux de données * de référence,

- de télécharger un jeu de données de référence * tel qu'il était a une date donnée.

Les données diffusées par ce service web * sont conforme aux scénario d'échange Référentiel en version 2.

- getCapabillities : permet de découvrir quelles sont les opérations disponibles sur ce service web * ;

- updatedReferences : permet de savoir, à partir d'une date, quel est le nombre de mises à jour effectuées sur un ou plusieurs référentiels * ;

- getUpdatedReferences : permet de télécharger les données de référence * mises à jour depuis une date donnée ;

- getReferenceElements : permet de télécharger le contenu d'un référentiel * : des filtres permettent de ne récupérer qu'un sous-ensemble du référentiel * ;

- getReferenceHistory : cette nouvelle opération permet de lister les dates auxquelles un référentiel * a été mis à jour ;

- getReferenceRevision : cette nouvelle opération permet de télécharger une révision d'un référentiel tel qu'il était à une date donnée.

Différents outils pour accéder service web référentiel

Le générateur de requête

Le Sandre a mis en place un générateur de requêtes au service web * référentiel. Cet outil vous permet de générer des requêtes conforme aux attentes du service web * référentiel. Les requêtes ainsi générées sont des URL, contenant tout les critères que vous avez choisi, ce qui vous permet de les enregistrer dans vos favoris par exemple ou de les intégrer dans vos différent scripts.

Le générateur est ici: http://services.sandre.eaufrance.fr/References/1.3.0/

En PHP

Le Sandre a rédigé le script d'exemple ci-dessous en PHP pour interroger en SOAP le service web * référentiel. Il retourne la description du paramètre "1234". Attention, il nécessite obligatoirement l'installation de la bibliothèque phpsoap .

En VBA pour Excel

Le Sandre a élaboré une feuille sous Excel , en langage informatique VBA, chargée de consulter ce service web du Sandre. Attention, elle nécessite obligatoirement l'installation des bibliothèques msxml et soapsdk.