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 > Quelques précisons > Accès") 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 > Données de référence * ),
- en utilisant un moteur de recherche (cf. chapitre ci-dessous intitulé Services associés > Consulter une donnée d'un jeu).
Fonctionnalités
Le service web * des référentiels * du Sandre permet :
- de rechercher et récupérer les jeux de données * de référence,
- d'être averti des mises à jour ou de demander si une nouvelle mise à jour est disponible,
- de récupérer les mises à jour des jeux de données de référence * .
A titre d'exemple, vous pouvez utiliser cette adresse qui sollicite nos services web * en mode REST. Après quelques secondes, une fenêtre s'ouvrira vous invitant à télécharger le fichier compressé. Cette adresse vous permet de télécharger les occurrences mises à jour du référentiel * Paramètres à partir du 01/01/2010. Vous pouvez changer la valeur de la variable DerniereDateDeMAJ de cette adresse pour remplacer la date de mise à jour par une autre.
Accessibilité
Le service web * des référentiels * du Sandre est accessible à l'adresse :
- References.wsdl (pour l'accès en SOAP),
- References.php (pour l'accès en REST).
Exemple d'implémentation pour l'utilisation du service web
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 .
En PHP pour Apache
Le Sandre a rédigé le script ci-dessous, en langage informatique PHP, chargé de consulter ce service web * du Sandre. Il retourne la description du paramètre "1234". Attention, il nécessite obligatoirement l'installation de la bibliothèque phpsoap .
$client = new SoapClient("http://services.sandre.eaufrance.fr/References/1.1.0/References.wsdl");
$params->outputFormat = 'text/xml';
$params->outputSchema = 'http://xml.sandre.eaufrance.fr/scenario/referentiel/2/sandre_sc_referentiel.xsd';
$params->CdReferentiel = 'PAR'; $params->Filter->CdSandre = "1234";
try { $obj = $client->getReferenceElements($params); echo "&lgt;pre>";
echo $obj->Result; echo "";
}
catch (SoapFault $exception) { echo $exception; }
?>