des Données et Référentiels sur l'eau

Transcription

1 SERVICES WEB Service d'administration Nationale des Données et Référentiels sur l'eau Consultation des données d assainissement Description des services Version : 0.1

2 Création du document en version 0.1 Les conditions d utilisation de ce document Sandre sont décrites dans le document «Conditions générales d utilisation des spécifications Sandre» disponible sur le site Internet du Sandre. Chaque document Sandre est décrit par un ensemble de métadonnées issues du Dublin Core ( ). Titre Description des services web des données d assainissement Créateur Système d Information sur l Eau / Sandre Sujet Système d Information Assainissement Description Spécifications des services web SIA Editeur Ministère de l Ecologie et du Développement Durable Contributeur Sandre Date / Création 28/06/2006 Date / Modification 01/03/2007 Date / Validation Type Text Format Microsoft Word Identifiant Langue Fr Relation / Est remplacé par Relation / Remplace Relation / Référence Couverture France Droits Sandre Version 0.1 SANDRE / Services de consultation des données assainissement 2/89

3 I. AVANT PROPOS Le domaine de l'eau est vaste, puisqu'il comprend notamment les eaux de surface, les eaux météoriques, les eaux du littoral et les eaux souterraines, et qu'il touche au milieu naturel, à la vie aquatique, aux pollutions et aux usages. Il est caractérisé par le grand nombre d'acteurs qui sont impliqués dans la réglementation, la gestion et l'utilisation des eaux : ministères avec leurs services déconcentrés, établissements publics comme les agences de l'eau, collectivités locales, entreprises publiques et privées, associations,... Tous ces acteurs produisent des données pour leurs propres besoins. La mise en commun de ces gisements d'information est une nécessité forte, mais elle se heurte à l'absence de règles claires qui permettraient d'assurer la comparabilité des données et leur échange. A. Le Système d Information sur l Eau Le Système d Information sur l'eau (SIE) est formé par un ensemble cohérent de dispositifs, processus et flux d information, par lesquels les données relatives à l eau sont acquises, collectées, conservées, organisées, traitées et publiées de façon systématique. Sa mise en œuvre résulte de la coopération de multiples partenaires, administrations, établissements publics, entreprises et associations, qui se sont engagés à respecter des règles communes définies par voie réglementaire et contractuelle. Elle nécessite la coordination de projets thématiques nationaux, de projets transverses (Sandre, Référentiels cartographiques, ) et des projets territoriaux. L'organisation du Système d'information sur l'eau, mis en place depuis 1992, est l'objet de la circulaire n du 26 mars 2002 qui répartit les rôles entre les différents acteurs publics, Etats et organismes ayant une mission de service public dans le domaine de l'eau. Le «protocole du Système d Information Eau», ou «protocole SIE», signé en juin 2003, étend aux processus de production des données le «protocole du Réseau National des Données sur l Eau» (RNDE), qui date de Il règle par voie conventionnelle les obligations des acteurs de l eau qui ont déclaré y adhérer, en matière de production, de conservation et de mise à disposition des données. La mise en place d'un langage commun pour les données sur l'eau est l une des composantes indispensables du SIE, et constitue la raison d'être du Sandre, Service d'administration Nationale des Données et des Référentiels sur l'eau. SANDRE / Services de consultation des données assainissement 3/89

4 B. Le Sandre Le Sandre est chargé : d'élaborer les dictionnaires des données, d'administrer les nomenclatures communes au niveau national, d'établir les formats d'échanges informatiques de données, de définir des scénarios d échanges et de standardiser des services WEB, de publier les documents normatifs après une procédure de validation par les administrateurs de données Sandre et d approbation par le groupe Coordination du Système d Information sur l Eau. d émettre des avis sur la compatibilité au regard des spécifications B.1. Les dictionnaires de données Les dictionnaires de données sont les recueils des définitions qui décrivent et précisent la terminologie et les données disponibles pour un domaine en particulier. Plusieurs aspects de la donnée y sont traités : sa signification ; les règles indispensables à sa rédaction ou à sa codification ; la liste des valeurs qu'elle peut prendre ; la ou les personnes ou organismes qui ont le droit de la créer, de la consulter, de la modifier ou de la supprimer... A ce titre, il rassemble les éléments du langage des acteurs d'un domaine en particulier. Le Sandre a ainsi élaboré des dictionnaires de données qui visent à être le langage commun entres les différents acteurs du monde de l'eau. B.2. Les listes de référence communes L'échange de données entre plusieurs organismes pose le problème de l'identification et du partage des données qui leur sont communes. Il s'agit des paramètres, des méthodes, des supports, des intervenants mais aussi des stations de mesure, des zonages réglementaires,... qui doivent pouvoir être identifiés de façon unique quel que soit le contexte. Si deux producteurs codifient différemment leurs paramètres, il leur sera plus difficile d'échanger des résultats. C'est pour ces raisons que le Sandre s'est vu confier l'administration et la diffusion du référentiel commun sur l eau afin de mettre à disposition des acteurs du monde de l'eau une codification unique, support de référence des échanges de données sur l'eau. B.3. Les formats d'échange informatiques Les formats d'échange élaborés par le Sandre visent à réduire le nombre d'interfaces des systèmes d'information que doivent mettre en œuvre les acteurs du monde de l'eau pour échanger des données. SANDRE / Services de consultation des données assainissement 4/89

5 Afin de ne plus avoir des formats d'échange spécifiques à chaque interlocuteur, le Sandre propose des formats uniques utilisables par tous les partenaires. B.4. Les scénarios d échanges Un scénario d échanges décrit les modalités d échanges dans un contexte spécifique. En s appuyant sur l un des formats d échanges du Sandre, le document détaille la sémantique échangée, décrit les données échangées (obligatoires et facultatives), la syntaxe du ou des fichiers d échanges et les modalités techniques et organisationnelles de l échange. B.5. Les services d échanges Dans le cadre de la mise en œuvre de l Architecture du Système d Information sur l Eau (ASIE), le Sandre est chargé de définir et de standardiser les services WEB qui rendent les outils et systèmes d information interopérables entre eux. B.6. Organisation du Sandre Le Sandre est animé par une équipe basée à l'office International de l Eau à Limoges qui s'appuie, pour répondre à ces missions, sur les administrateurs de données des organismes signataires du protocole SIE ainsi que sur des experts de ces mêmes organismes ou d'organismes extérieurs au protocole : Institut Pasteur de Lille, Ecole Nationale de la Santé Publique, Météo-France, IFREMER, B.R.G.M., Universités, Distributeurs d'eau,... Pour de plus amples renseignements sur le Sandre, vous pouvez consulter le site Internet du Sandre : ou vous adresser à l'adresse suivante : Sandre - Office International de l Eau 15 rue Edouard Chamberland LIMOGES Cedex Tél. : Fax : SANDRE / Services de consultation des données assainissement 5/89

6 C. Processus d élaboration et de publication d un document Sandre Un document élaboré et estampie Sandre est issu d un processus d élaboration et de validation formalisé dans le document [Politique générale du Sandre] disponible sur le site Internet du Sandre ( Issu d un travail d experts du domaine, d administrateurs de données et d informaticiens, ce document est publié dans une version à un instant donné (stable ou provisoire selon son avancement). A tout moment, le lecteur peut reporter des anomalies ou faire des propositions d amendement qui seront discutées lors d une révision du document. Ces remarques sont à réaliser auprès de la cellule d animation du Sandre ou sur le site Internet. D. Notations dans le document D.1. Termes de référence Les termes DOIT, NE DOIT PAS, DEVRAIT, NE DEVRAIT PAS, PEUT, OBLIGATOIRE, RECOMMANDE, OPTIONNEL ont un sens précis. Ils correspondent à la traduction française de la norme RFC2119 (RFC2119) des termes respectifs MUST, MUST NOT, SHOULD, SHOULD NOT, MAY, REQUIRED, RECOMMENDED et OPTIONAL. D.2. Notation UML [TODO] D.3. Gestion des versions Chaque document publié par le Sandre présente une version correspondant au nombre de révision du document. Si cet indice est composé uniquement d un entier 1, 2, - alors le document est une version approuvée par le Sandre. Si cet indice est composé de plusieurs entiers 0.4, 1.3, - alors le document est une version pré-validée par le Sandre mais qui pourra subir encore quelques modifications après retour des premières implémentations. Ce document sera donc ré-édité en version définitive dans les mois suivants. Le document actuel est la version 0.1 et constitue un document provisoire p SANDRE / Services de consultation des données assainissement 6/89

7 II. INTRODUCTION A. Objet Ce document est destiné à l ensemble des producteurs de données souhaitant mettre à disposition leurs données d assainissement sur le portail internet SIA (Système d Information Assainissement) par des services web. Ces services web sont standardisés ; ils sont réutilisables par les applications conformes aux spécifications du Système d Information sur l Eau. Ce document décrit les interfaces des services web à mettre en œuvre entre le fournisseur de données (producteurs de données d assainissement) et le consommateur de données (portail Internet) pour permettre les échanges de données. Ces données échangées sont principalement : - les descriptifs des ouvrages d assainissement (systèmes de traitement, systèmes de collecte, ouvrages de rejets) ; - les descriptifs des agglomérations d assainissement ; - les données d autosurveillance d assainissement collectif ; - les données réglementaires relatives notamment à la directive ERU ; - les indicateurs de fonctionnement. Le lecteur devra se référer au document «Spécifications techniques ASIE Version 1» pour implémenter les services web spécifiés dans ce document. B. Références Le présent document s appuie et fait référence aux documents produits par des instances de normalisation internationale reconnues et utilisées par le Sandre. Il s agit : des spécifications techniques ASIE version 1 des spécifications de modélisation des services web Sandre version 1 SANDRE / Services de consultation des données assainissement 7/89

8 Et des formats d échanges XML-Sandre version 1 : Données de fonctionnement : Données indicateurs : Données réglementaires : Données de description : Dans le domaine de l assainissement, les données métiers échangées par les services web s appuient sur les dictionnaires SANDRE suivants : Dictionnaire des données du Système d'information sur l'assainissement version 1.0 Le document présente toutes les données relatives au Système d Information sur l Assainissement. Dictionnaire de données sur la mesure au sein d'un ouvrage d'assainissement version Le document spécifie les modalités d organisation des données pour les mesures qualitatives et quantitatives acquises sur un ouvrage d assainissement. Il s agit généralement d une mesure sur l eau usée, les boues ou les sous-produits. La mesure peut être acquise dans le cadre d un contrôle autosurveillance, d un bilan 24 heures,... Dictionnaire de données sur l'ouvrage de rejet version Le dictionnaire présente les concepts et attributs relatifs à la description d un ouvrage de rejet qu il soit en aval d une station d épuration (rejet "indirect") ou à l aval d un site industriel ("rejet direct") Dictionnaire de données sur le site industriel version Le dictionnaire décrit l organisation des données afin de décrire un site industriel que ce soit dans une approche "pollution" qu une approche "Connaissance des activités". Dictionnaire de données sur l'ouvrage de dépollution version Le document décrit toutes les notions pour identifier et caractériser une station d épuration ou une unité de traitement des sous-produits. Le dictionnaire présente plusieurs visions de l ouvrage : approche générale avec les types de traitement,... et une approche descriptive détaillée avec les notions de files, filières et d équipements. Dictionnaire de données Suivi des flux polluants version Le document présente tous les ouvrages relatifs à l assainissement et décrit les flux possibles entre ces ouvrages que ce soit de l eau usée ou des boues. SANDRE / Services de consultation des données assainissement 8/89

9 III. PRESENTATION GENERALE A. Description des cas d utilisation des services web A.1. UC1 - Recherche d ouvrage(s) à partir d un portail Le terme «Ouvrage» regroupe les différents types d ouvrages d assainissement, i.e. : - les systèmes de traitement ou stations d épuration ou Steps, - les systèmes de collecte, - les ouvrages de rejets. Fournisseur de données assainissement 1 Rechercher des ouvrages Portail thématique assainissement Consulter la fiche ouvrage Fournisseur de données assainissement 2 Description : Le portail SIA affiche les ouvrages d assainissement à partir de critères comme la commune. Pour afficher le résultat de la recherche, le portail SIA interroge les fournisseurs de données, récupère les données puis les affiche sur le portail SIA. Le portail SIA peut donc afficher une fiche descriptive d un ouvrage d assainissement demandée par l utilisateur. Le terme ouvrage est générique, il peut s agir d un système de traitement des eaux urbaines, d un système de collecte ou d un ouvrage de rejet. SANDRE / Services de consultation des données assainissement 9/89

10 Le diagramme de séquence est le suivant : Agrégateur Portail Service Web fournisseur 1 Service web fournisseur 2 Portail thématique assainissement FournitCriteresOuvrages Précondition : Connaissance des services à appeler Liste des ouvrages(criteres) Retour 1 : liste des ouvrages répondant aux critères ou erreur Liste des ouvrages(criteres) Retour 2 : liste des ouvrages répondant aux critères ou erreur retourne résultat agrégation des réponses Choix du service à appeler choix d'un ouvrage Informations sur l'ouvrage (identifiant ouvrage) Retour des informations sur l'ouvrage Retour : description ouvrage Le terme «Agrégateur Portail» est un composant du portail SIA qui est responsable : de l appel des services web des différents fournisseurs, de la réception des données provenant des différentes sources (fournisseurs), de l agrégation des différents flux de données réceptionnés (réponses). A.1.a Critères de recherche des ouvrages L agrégateur du portail interroge le service web du fournisseur pour obtenir la liste des ouvrages. Les critères de recherche des ouvrages sont : Thématiques / Compartiments Critères [Multiplicité] Systèmes de traitement Critères spatiaux : Code de la commune [1], code du département [1], code de la région [1] Sélection géographique : Rectangle englobant [1] Critères descriptifs : Code ou partie du code de la station [1] Libellé ou partie du libellé de la station [1] Capacité nominale (minimale [ET] maximale) SANDRE / Services de consultation des données assainissement 10/89

11 Code de l agglomération d assainissement [1] Tailles de l agglomération d assainissement [N] Types de traitement [N] Destinations des sous produits [N] Types de filières (eau, boue) [N] Critères réglementaires : Agglomération d assainissement : Année de la recherche [1] Conformité du traitement (oui/non) [1] Conformité de la collecte (oui/non) [1] Système de traitement : Année de la recherche [1] Conformité en équipement (oui/non) [1] Existence d un dispositif d autosurveillance [1] Validation du dispositif d autosurveillance [1] Ouvrages de rejet Critères spatiaux : Sélection géographique : Rectangle englobant Bassin et région hydrographique Code de la zone sensible [1] Code du bassin DCE [1] Code de la masse d eau Catégorie de la masse d eau Critères descriptifs : Altitude > 1500 m? O / N Les règles de gestion suivantes s appliquent lors de cette recherche : - recherche entre critères différents, la recherche est de type ET. Par exemple, recherche des ouvrages dans une commune X ET sur le réseau Y. - recherche entre critères identiques, la recherche est de type OU. Par exemple, recherche des ouvrages dans une commune X ou Y. Par exemple, si le portail propose une recherche des ouvrages dans un réseau A ET dans un réseau B, il doit appeler le service web une première fois sur le critère «Réseau A», puis une seconde fois avec le critère «Réseau B», puis effectuer l intersection des deux réponses. Le traitement d intersection des deux réponses s effectue au niveau du portail par l agrégateur de portail. Le cas d utilisation s applique uniquement pour un et un seul type d ouvrage (systèmes de traitement, ouvrages de rejet ou systèmes de collecte). SANDRE / Services de consultation des données assainissement 11/89

12 A.1.b Réponse à la recherche de la fiche ouvrage Le service web de chaque producteur retourne une réponse contenant : - le nombre d ouvrages répondant aux critères. Si la recherche est infructueuse, le nombre d ouvrages est égal à «0». - la description des ouvrages avec les informations suivantes : Thématiques / Compartiments Système de traitement Réponse Code du système de traitement (description générale) Nom du système de traitement (description générale) Coordonnée X de l ouvrage (description générale) Coordonnée Y de l ouvrage (description générale) Système de projection (description générale) Date de mise en service (description générale) Date de mise hors service (description générale) Code de la commune d implantation (description générale) Nom de la commune d implantation (description générale) Agglomération d assainissement associée au système de traitement : Code national de l agglomération (description générale) Nom de l agglomération (description générale) Nom du Service de police suivant l agglomération (description générale) Commune principale de l agglomération (description générale) Liste des communes constituant l agglomération (description générale) Date de l arrêté préfectoral de mise en demeure (réglementaire) Type d échéance européenne pour la mise en conformité (réglementaire) Date d échéance européenne pour la mise en conformité (réglementaire) Date de mise en conformité (réglementaire) Commentaires relatifs à l agglomération Code du département de la commune d implantation (description générale) Nom du département de la commune d implantation (description générale) Nom du service instructeur (description générale) Nom du maître d ouvrage (description générale) Nom de l exploitant (description générale) Filières eau (description technique) Filières boue (description technique) SANDRE / Services de consultation des données assainissement 12/89

13 Capacité nominale (description technique) Débit de référence (description technique) Code Sandre du point de mesure (description technique) Nom du point de mesure (description technique) Localisation du point de mesure (description technique) Gestionnaire du point de mesure (description technique) Commentaires liés au point de mesure (description technique) Existence d'un dispositif d'autosurveillance (oui/non) (description technique) Dispositif d'autosurveillance validé (oui/non) (description technique) Régime dont relève le système de traitement (réglementaire) Type d'arrêté national concernant le système de traitement (réglementaire) Date de l'arrêté ou du récépissé (réglementaire) Date de fin de validité de l'arrêté ou du récépissé (réglementaire) Existence d'un plan d'épandage réglementaire (réglementaire) Niveau de traitement actuel (réglementaire) Paramètres actuels concernés par un traitement plus rigoureux (réglementaire) Paramètres requis par le préfet dans le cas d'un traitement plus rigoureux (réglementaire) Paramètres requis par la directive dans le cas d'un traitement plus rigoureux (réglementaire) Type d'échéance pour la conformité en équipement Niveau de traitement requis par la DCE (réglementaire) Date d'échéances pour la mise en conformité en équipement (réglementaire) Date de mise en conformité en équipement (réglementaire) Code du rapportage Libellé du rapportage Obligations européennes : Code paramètre (réglementaire) Date de début (réglementaire) Date de fin (réglementaire) Rendement (réglementaire) Concentration maximale en sortie (réglementaire) Valeur rédhibitoire (réglementaire) Nombre de mesures requises (réglementaire) Commentaires (réglementaire) Obligations locales : Code paramètre (réglementaire) Date de début (réglementaire) Date de fin (réglementaire) Rendement d élimination minimum (réglementaire) SANDRE / Services de consultation des données assainissement 13/89

14 Système de collecte Ouvrage de rejet Concentration maximale en sortie (réglementaire) Flux maximum en sortie (réglementaire) Valeur rédhibitoire (réglementaire) Méthode d évaluation de la conformité (réglementaire) Nombre de mesures requises (réglementaire) Commentaires (réglementaire) Commentaires sur le système de traitement (description générale) Code national du système de collecte (description générale) Nom du système de collecte (description générale) Existence de l autosurveillance sur le réseau (description générale) Validation de l' autosurveillance sur le réseau (description générale) Nombre de DO de 120 à 600 kg DBO5 /j (description générale) Nombre de DO > 600 kg DBO5 /j (description générale) Code SANDRE du point de mesures (description générale) Nom du point de mesures (description générale) Localisation du point de mesures (description générale) Gestionnaire du point de mesures (description générale) Commentaires liés au point de mesures (description générale) Commentaires sur le système de collecte (description générale) Code de l ouvrage de rejet (description générale) Nom de l ouvrage de rejet (description générale) Type de milieu récepteur du rejet (description générale) Coordonnées X du point de rejet (description générale) Coordonnées Y du point de rejet (description générale) Système de projection (description générale) Nom Zone hydrographique du rejet (description générale) Code zone hydrographique du rejet (description générale) Nom entité hydrographique du rejet (description générale) Code entité hydrographique du rejet (description générale) Nom Masse d'eau du point de rejet (description générale) Code Masse d'eau du point de rejet (description générale) Nom zone sensible du rejet (description générale) Code zone sensible du rejet (description générale) A titre indicatif, les coordonnées X et Y permettent de représenter les ouvrages de manière cartographique (dans la projection spécifiée) dans le portail SIA (cf. cas d utilisation ci-après). Le service web du fournisseur retourne alors UN ET UN SEUL descriptif complet de l ouvrage sous forme de données structurées selon les modèles de données Sandre et contenues dans un fichier XML-Sandre. SANDRE / Services de consultation des données assainissement 14/89

15 A.2. UC2 - Visualiser un ensemble de données élémentaires La recherche s effectue par les critères ci-dessous qui peuvent être mixés : - localisation, lieu d implantation du système de traitement ou lieu de rejet (référentiel géographique) ; - temps (référentiel temporel) ; - paramètres, supports (référentiel analytique) ; - intervenant (référentiel des intervenants) ; - niveau de qualité de l information (qualification, statut). Fournisseur de données assainissement 1 Portail thématique assainissement Recherche de donnnées élémentaires Fournisseur de données assainissement 2 Le service web retourne un ensemble de données élémentaires affichées dans le portail SIA. La recherche se déroule comme ceci : 1. le portail SIA recherche les ouvrages répondant aux critères. Le service web répond par une liste d ouvrages telle que décrite dans le cas d utilisation précédent. 2. (optionnel), le portail obtient les informations synthétiques sur les mesures (nombre de mesures, paramètres disponibles) et sur d autres critères associés. 3. le portail SIA affiche les données élémentaires pour les ouvrages identifiés et sélectionnés (étape 1) en filtrant éventuellement avec les autres critères de l utilisateur du portail. SANDRE / Services de consultation des données assainissement 15/89

16 Le diagramme de séquence est le suivant : Agrégateur Portail Service Web fournisseur 1 Service web fournisseur 2 Portail thématique assainissement FournitCriteresDonnees(codes ouvrages, autres criteres) Précondition : pas de code ouvrage => Utilisation des critères cf scénario Rechercher Ouvrages Liste des ouvrages(criteres) Liste des ouvrages(criteres) Précondition : la liste des codes ouvrages est connue lors d'une précédente recherche obtenir informations de synthèse(codes ouvrages, autres criteres) Retour 1 : données disponibles obtenir informations de synthèse(codes ouvrages, autres criteres) Retour 2 : données disponibles agrégation synthèse visualisation éventuelle En mode "Synthèse" : le descriptif des données disponibles est retourné pour visualisation récupérer données élémentaires(codes ouvrages, autres criteres) Retour 1 avec données élémentaires récupérer données élémentaires(codes ouvrages, autres criteres) Retour 2 avec données élémentaires agrégation visualisation En mode "Données" : les données sont agrégées pour visualisation ou export Les paramètres d appel de l étape 1 se limitent aux critères géographiques ou à une sélection déterminée d ouvrages. Ils permettent d obtenir les ouvrages répondant aux critères demandés. Ce cas d utilisation est similaire à celui décrit précédemment. SANDRE / Services de consultation des données assainissement 16/89

17 A.2.a Critères de recherche de l étape 2 et 3 Référentiel de recherche Critères [Mulitplicité] Codes ouvrages Code(s) des ouvrages [N] Données temporelles Date de début Date de fin Référentiel analytique Familles de paramètres [N] Points de mesure [N] Référentiel des intervenants Rôle de l intervenant de type producteur uniquement Code de l intervenant [1] Finalités Finalités [N] Validation des données Qualification [0,1] Statut [0,1] Type de retour Uniquement une synthèse A.2.b Réponse à la recherche de l étape 2 et 3 Deux informations différentes peuvent être obtenues : - Type de retour «Synthèse», un fichier décrivant le nombre de mesures par ouvrage et par année demandée selon l organisation suivante : Nombre d ouvrages répondant aux critères Ouvrage(s) Code de l ouvrage Année Nombre de mesures - Type de retour «Données», l ensemble des données de résultats sous la forme XML Sandre Autosurveillance V3. A.3. UC3 - Télécharger un ensemble de données élémentaires en différé Ce cas d utilisation se traite comme la visualisation d un ensemble de données élémentaires (cf. UC2). Les données élémentaires sont téléchargeables sur le portail SIA sous la forme d un fichier au format XML Autosurveillance version 3 ou CSV. Le portail SIA est chargé de transformer le format XML en CSV. A.4. UC4 - Visualiser les ouvrages sur une interface cartographique Ce cas d utilisation est dérivé du cas d utilisation UC1 mais il consiste à visualiser les ouvrages sur une interface cartographique. SANDRE / Services de consultation des données assainissement 17/89

18 Ce cas est traité selon deux approches différentes selon l usage du portail : Cas d utilisation Comportement du service fournisseur Comportement du portail Visualisation de l ensemble Le fournisseur fournit un service Le portail affiche l information dans des ouvrages d un fournisseur ou sur un territoire donné cartographique fournissant au moins une image (service web OGC WMS) et une interface cartographique ou sur une image. un vecteur (service web OGC WFS). Coordonnées X et Y des ouvrages recherchés. Visualisation des ouvrages Le diffuseur fournit un service Le portail est chargé de créer une après une recherche sur des critères alphanumériques (tels que décrits dans le premier cas d utilisation) retournant un fichier contenant les coordonnées des ouvrages répondant aux critères. couche cartographique à partir des éléments alphanumériques fournis par le(s) service(s). Il affiche ensuite cette couche d informations. A.5. UC5 Dénombrer les ouvrages et mesures répondant à un critère Ce cas consiste à visualiser un nombre d ouvrages répondant à des critères donnés selon une clé de répartition fournie, puis à connaître le nombre de mesures par année sur cet ouvrage. Ce cas est décomposé en deux étapes : 1. Le portail interroge les services web des fournisseurs afin de connaître les ouvrages répondant aux critères saisis par l utilisateur ; 2. Le portail interroge les services web des fournisseurs afin de connaître le nombre de mesures pour les ouvrages identifiés. SANDRE / Services de consultation des données assainissement 18/89

19 Le diagramme de séquence est le suivant : Agrégateur Portail Service Web fournisseur 1 Service web fournisseur 2 Portail thématique assainissement Précondition : Connaissance des services à appeler FournitCriteresOuvrages Recherche des ouvrages(criteres) Retour 1 : liste des ouvrages répondant aux critères ou erreur Recherche des ouvrages(criteres) Retour 2 : liste des ouvrages répondant aux critères ou erreur Nombre de prélèvements et analyses(ouvrages) Retour des informations agrégation des réponses retourne résultat Le premier appel est traité de manière similaire au cas d utilisation 1. Le second consiste à obtenir le nombre de prélèvements et le nombre d analyses pour tous les ouvrages interrogés par an. En retour, un fichier décrivant le nombre de prélèvements et le nombre d analyses par ouvrage et par année (pour toutes les années disponibles) est envoyé selon l organisation suivante : Nb de ouvrages Ouvrage(s) Code de l ouvrage Année Nombre de prélèvements Nombre d analyses Notons qu il est conseillé que les fournisseurs de données disposent des données calculées pour éviter des calculs temps réels consommateurs d énergie et de temps au niveau du Portail SIA. SANDRE / Services de consultation des données assainissement 19/89

20 A.6. UC6 Visualiser un paramètre calculé (indicateur) Ce cas consiste à obtenir un à plusieurs paramètres calculés et fournis par le producteur de données. Tous les indicateurs mono-stations sont fournis par les producteurs. Ce cas d utilisation prend en entrée une liste des indicateurs demandés par l utilisateur du Portail. Si un indicateur n est pas calculé par un producteur (détectable par l appel du GetCapabilities ou GetAvailableWasteWaterData), une exception doit être générée par le producteur. A.7. UC7 Consulter les données réglementaires de systèmes de traitement Ce cas d utilisation répond au besoin de consultation des données réglementaires de la part des autorités publiques et du grand public par le biais du portail national du SIA. A.7.a Critères en entrée Référentiel de recherche Référentiel géographique Donnée temporelle Donnée analytique Référentiel réglementaire Référentiel des intervenants Type de retour Critères [Mulitplicité] Zone / entité administrative ou hydrographique [1] Code(s) des ouvrages [N] Aucune Aucune Dates - Echéances ERU Rôle de l intervenant de type service instructeur Code de l intervenant [1] Les données réglementaires En retour, un fichier contenant l ensemble des données réglementaires sous la forme d un fichier XML Sandre compressé de la structure suivante : Nb d ouvrages répondant aux critères Ouvrage(s) Code de l ouvrage Régime dont relève le système de traitement Type d'arrêté national concernant le système de traitement Date de l'arrêté ou du récépissé Date de fin de validité de l'arrêté ou du récépissé Existence d'un plan d'épandage réglementaire Niveau de traitement actuel Code du système de collecte qui alimente le système de traitement Paramètres actuels concernés par un traitement plus rigoureux Paramètres requis par le préfet dans le cas d'un traitement plus rigoureux Paramètres requis par la directive dans le cas d'un traitement plus rigoureux Rapportages Européens SANDRE / Services de consultation des données assainissement 20/89

21 Code du rapportage Libellé du rapportage Echéances ERU Type d'échéance pour la conformité en équipement Niveau de traitement requis par la DCE Dates d'échéance pour la mise en conformité en équipement Date de mise en conformité en équipement Obligations ERU Code paramètre Date de début Date de fin Rendement Concentration maximale en sortie Valeur rédhibitoire Nombre de mesures requises Commentaires Obligations locales Code paramètre Date de début Date de fin Rendement d élimination minimum Concentration maximale en sortie Flux maximum en sortie Valeur rédhibitoire Méthode d évaluation de la conformité Nombre de mesures requises Commentaires A.8. Consulter les données réglementaires de systèmes de collecte Ce cas d utilisation répond au besoin de consultation des données réglementaires de la part des autorités publiques et du grand public par le biais du portail SIA. Critères en entrée : Référentiel de recherche Référentiel géographique Donnée temporelle Référentiel analytique Référentiel réglementaire Critères [Mulitplicité] Zone / entité administrative ou hydrographique [1] Code(s) des systèmes[n] SANDRE / Services de consultation des données assainissement 21/89

22 Référentiel des intervenants Type de retour Rôle de l intervenant de type producteur uniquement Code de l intervenant [1] > Service instructeur Les données En retour, un fichier contenant l ensemble des données réglementaires sous la forme d un fichier XML Sandre compressé de la structure suivante : Nb d ouvrages répondant aux critères Ouvrage(s) Code de l ouvrage Existence d une AS réglementaire sur le réseau Validation de l AS sur le réseau Date de mise en service du système de collecte conforme Date d échéance européenne de mise en conformité du système de collecte Commentaires sur la conformité du système de collecte Existence de rejets directs et/ou de déversements significatifs par temps sec Code du système de traitement sur lequel est raccordé le système de collecte Conformité annuelle du système de collecte Conformité annuelle (oui/non/sans objet) Année de la conformité A.9. UC9 Consulter les données réglementaires d agglomérations d assainissement Ce cas d utilisation répond au besoin de consultation des données réglementaires de la part des autorités publiques et du grand public par le biais du portail national du SIA. Critères en entrée : Référentiel de recherche Référentiel géographique Donnée temporelle Référentiel analytique Référentiel réglementaire Critères [Mulitplicité] Zone / entité administrative ou hydrographique [1] Code(s) des agglomérations [N] Référentiel des intervenants Type de retour Rôle de l intervenant de type producteur uniquement Code de l intervenant [1] > Service instructeur Les données SANDRE / Services de consultation des données assainissement 22/89

23 En retour, un fichier contenant l ensemble des données réglementaires sous la forme d un fichier XML Sandre compressé de la structure suivante : Nombre d agglomérations répondant aux critères Agglomeration d assainissement(s) Code de l agglomération Nom de l agglomération Date de l arrêté préfectoral de mise en demeure Commentaires relatifs à l agglomération Etat de la conformité Type d échéance européenne pour la mise en conformité Date d échéance européenne pour la mise en conformité Date de mise en conformité en équipement Conformité en performance Conformité en performance (oui/non Année de la conformité Charge brute de pollution organique produite par l agglomération d assainissement en E.H Méthode de calcul de la charge brute de pollution organique produite par l agglomération Somme des capacités nominales des systèmes de traitement de l agglomération Somme des charges maximales en entrée des systèmes de traitement de l agglomération SANDRE / Services de consultation des données assainissement 23/89

24 B. Services définis par le Sandre pour la consultation des données d assainissement Le service web de consultation des données d assainissement se décompose en 7 opérations suivantes : Opération Définition Utilisation GetCapabilities Permet d identifier les caractéristiques du service web du fournisseur de données. Cette interface permet au consommateur du service de proposer uniquement les recherches et visualisations possibles pour l utilisateur final. GetWasteWaterFacilities GetDescriptionWasteWaterFacility GetAvailableDataWasteWaterFacility GetDataWasteWaterFacility Permet de rechercher un ou plusieurs ouvrages en appelant un ou plusieurs critères. Retourne une liste des ouvrages avec quelques informations indispensables (métadonnées sur l ouvrage). Permet d obtenir les informations invariantes d un ouvrage particulier. En entrée, le code de l ouvrage et en retour un fichier XML contenant l ensemble des descripteurs Sandre de l ouvrage (en fonction du type d ouvrage) Permet d obtenir les informations sur le nombre de prélèvements et le nombre d analyses sur un ou plusieurs ouvrages pour toutes les années disponibles. En entrée, le ou les codes d ouvrages et en retour les informations synthétiques. Permet d obtenir les données ou les informations sur les prélèvements/analyses ou le nombre de prélèvements / d analyses pour un ensemble de sites de mesures selon un ou plusieurs critères. En entrée, le ou les codes des ouvrages et les critères. En retour soit les données élémentaires, soit les Cette opération répond aux besoins de la plupart des cas d utilisation décrits précédemment, notamment UC-1, UC-2 et UC-5 Cette opération répond au cas d utilisation 1 sur la fiche descriptive d un ouvrage. Cette opération répond au cas d utilisation UC-5 Cette opération répond au cas d utilisation UC-2 et ceux qui en dépendent. SANDRE / Services de consultation des données assainissement 24/89

25 GetDataIndicatorWasteWaterFacility GetDataLawfulWasteWaterFacility informations synthétiques Permet d obtenir des données indicateurs sur les systèmes de traitements. Permet d obtenir les données réglementaires sur les stations ou agglomérations d assainissement L ensemble des opérations décrites précédemment est OBLIGATOIRE afin de respecter la spécification du Sandre. De plus, ce service web DOIT être complété par le service suivant : - Géoservice OGC WMS permettant la transmission d une image des ouvrages proposés par le fournisseur ; Il est aussi RECOMMANDE de disposer du service suivant : - Géoservice OGC WFS permettant la transmission d une couche vectorielle des ouvrages proposés par le fournisseur. Ces deux services permettent de traiter une partie du cas d utilisation UC-4. SANDRE / Services de consultation des données assainissement 25/89

26 IV. DESCRIPTION DES SERVICES A. Service WasteWaterData A.1. Opération GetCapabilities A.1.a Objet Cette opération permet d identifier les caractéristiques du service web du producteur de données. Cette opération est RECOMMANDEE. A.1.b Description Définition Permet à un client de disposer des caractéristiques du service Input Aucun Output Un fichier XML contenant les listes des services web. Exceptions Opération non supportée Version inconnue Pré-conditions Aucune Postconditions Aucune Emetteur2:Meta Data GetMetaData2:Meta Data GetCapabilities( ) Response [Exception 1]: OperationNotSupported [Exception 2]: UnknownVersion SANDRE / Services de consultation des données assainissement 26/89

27 A.1.c Paramètres de la requête Nom Définition Type et valeurs autorisées Cardinalité service Identifiant du service Chaîne de caractère précisant le service. DOIT prendre la valeur 1,1 (OBLIGATOIRE) «SANDRE:WasteWaterData» request Opération appelée Chaîne de caractère précisant l opération appelée. DOIT prendre la valeur GetCapabilities 1,1 (OBLIGATOIRE) version Version du service Paramètre, correspond au 1,1 (OBLIGATOIRE) attendue numéro de version du Web Service en question. Dans l'état actuel, seule la version est supportée. A.1.d Détail des paramètres IV.A.1.d.1 Service Le service est toujours SANDRE:WasteWaterData. Si un autre service est demandé, le service retourne une erreur de «UnknownService». IV.A.1.d.2 Request Pour récupérer la description du service, la requête est GetCapabilities. Si une autre requête est demandée que celle-ci, le service retourne une erreur de «OperationNotSupported». IV.A.1.d.3 Version La version est toujours Si une autre version est demandée, le service retourne une erreur de «UnknownVersion». A.1.e Réponse GetCapabilities La réponse à la requête GetCapabilities est un document XML. Le fichier XML DOIT respecter le schéma représenté ci-après. SANDRE / Services de consultation des données assainissement 27/89

28 - - <<Attribute>> <<Attribute>> GetCapabilitiesResponse version updatesequence : xsd:string : xsd:string Service 1..1 Capability Service Capability : Name Title Abstract AccessConstraints Fees OnlineResource : xsd:string : xsd:string : xsd:string : xsd:string : xsd:string : xlink:simplelink KeywordList - Keyword : Keyword[] 0..1 KeywordList 0..1 ContactInformation ContactInformation - ContactPosition - ContactVoiceTelephone - ContactFacsimileTelephone - ContactElectronicMailAddress : xsd:string : xsd:string : xsd:string : xsd:string - - <<Attribute>> Keyword Keyword vocabulary : xsd:string : xsd:string ContactPersonPrimary - ContactPerson - ContactOrganization 0..1 ContactPersonPrimary : xsd:string : xsd:string 0..1 ContactAddress ContactAddress AddressType Address City StateOrProvince PostCode Country : xsd:string : xsd:string : xsd:string : xsd:string : xsd:string : xsd:string SANDRE / Services de consultation des données assainissement 28/89

29 Capability : Request 1..1 Exception 0..1 Exception - Format : xsd:string[] REQUEST GetAvailableDataWasteWaterFacility GetDescriptionWasteWaterFacility 1..1 OperationType GetDataWasteWaterFacility 1..1 getcapabilities - Format : xsd:string GetDataIndicatorWasteWaterFacility GetDataLawfulWasteWaterFacility GetWasteWaterFacilities 1..* DCPType DCPType HTTP 0..* HTTP * SOAP POST 0..1 GET 0..1 SOAP - OnlineResource : xlink:simplelink GET - OnlineResource : xlink:simplelink POST - OnlineResource : xlink:simplelink Dans la rubrique <Requests>, il est précisé les opérations que le service implémente, i.e. : - GetCapabilities - GetWasteWaterFacilities - GetDescriptionWasteWaterFacilities - GetAvailableDataWasteWaterFacility - GetDataWasteWaterFacility - GetDataIndicatorWaterFacility - GetDataLawfulWasteWaterFacility Le schéma détaillé est décrit en annexe de ce document. SANDRE / Services de consultation des données assainissement 29/89

30 A.1.f Exceptions Le service DOIT générer les erreurs suivantes lorsqu un paramètre est erroné ou inapplicable pour l implémentation de ce service. Erreur (Code / Libellé) Définition / Règle de gestion Complément OperationNotSupported Le paramètre Request utilise une opération non supportée par le serveur. Il est précisé dans la balise <message> le paramètre non supporté UnknownVersion le paramètre Request utilise une version non connue. A.1.g Description en REST En REST, les paramètres DOIVENT être appelés en mode GET selon les paramètres suivants pour le service GetCapabilities Nom et exemple Cardinalité Définition et format Service=SANDRE:WasteWaterData Obligatoire Texte request=getcapabilities Obligatoire Nom de l opération en texte Version=1.0.0 Obligatoire Version en texte La restitution est un fichier XML conforme au schéma de la réponse GetCapabilities décrit dans le paragraphe «Réponse GetCapabilities» et fournit en annexe. A.1.h Description en SOAP La description en SOAP est décrite dans le fichier WSDL. A.2. Opération GetWasteWaterFacilities A.2.a Objet Cette opération permet de rechercher un ensemble d ouvrages/entités d assainissement et de disposer des informations descriptives sommaires sur ceux-ci. Cette opération est OBLIGATOIRE. SANDRE / Services de consultation des données assainissement 30/89

31 A.2.b Description L opération GetWasteWaterFacilities est décrite dans le tableau ci-après : Définition Permet à un client d identifier le ou les ouvrages disponibles chez un fournisseur de données répondant à des critères de recherche fournis par le consommateur. L ouvrage relève aussi bien d un système de traitement, d un ouvrage de rejet, d un système de collecte ou d une agglomération d assainissement. Input Ensemble de paramètres sur les critères de recherche et les options (version, ) ainsi que la thématique concernée (système de traitement, ouvrage de rejet, système de collecte). Output Un fichier contenant les informations exigées des objets sélectionnées. Ce fichier XML est transmis avec ou sans compression. Exceptions Cf. A.2.f Pre-conditions Vérifier l existence de cette opération via GetCapabilities Postconditions Aucune SANDRE:WasteWaterData Consommateur du service GetWasteWaterFacilities Response [Exception]: OperationNotSupported [Exception]: UnknownVersion [Exception]: FacilityTypeNotSupported [Exception]: InvalidBbox Exception: InvalidSRS [Exception]: InvalidSpatialSchema [Exception]: InvalidThematicConstraintsSchema [Exception]: OutputFormatNotSupported [Exception]: UnknownValueParameter [Exception]: InvalidOutpuSchema SANDRE / Services de consultation des données assainissement 31/89

32 A.2.c Paramètres de la requête Une requête envoyée à l opération GetWasteWaterFacilities DOIT inclure les paramètres décrits et définis dans le tableau suivant. Le tableau spécifie le typage des données, la cardinalité de chacun et les listes de valeurs autorisées. Nom Définition Type et valeurs autorisées Cardinalité Service Identifiant du service Chaîne de caractère précisant le service. DOIT prendre la valeur 1,1 (OBLIGATOIRE) «SANDRE:WasteWaterData» Request Opération appelée Chaîne de caractère précisant l opération appelée. DOIT prendre la valeur GetWasteWaterFacilities 1,1 (OBLIGATOIRE) Version Version du service Paramètre, correspond au 1,1 (OBLIGATOIRE) attendue numéro de version du service web en question. Dans l'état actuel, seule la version est supportée. FacilityType Thématique concernée Précise si la recherche porte 1,1 (OBLIGATOIRE) par l opération sur des systèmes de traitement, ou des systèmes de collecte ou des ouvrages de rejet. La recherche ne porte que sur un seul domaine. SpatialConstrai Ensemble des critères Ensemble des contraintes 0,1 (FACULTATIF) nts de recherche de type possibles que le consommateur spatiale du service peut appeler pour limiter sa recherche des ouvrages. ThematicConstr Ensemble des critères Ensemble des contraintes sur 0,1 (FACULTATIF) aints spécifiques aux entités les ouvrages de dépollution, les de la thématique agglomérations d assainissement, les ouvrages de rejet, les systèmes de collecte outputschema Scénario de réponse à Le schéma est décrit par un 1,1 (OBLIGATOIRE) l opération. namespace référençant le schéma attendu dans la réponse. outputformat Format de restitution Type MIME décrivant le format. 0,1 (FACULTATIF) SANDRE / Services de consultation des données assainissement 32/89

33 de la réponse. Deux valeurs sont possibles : text/xml ou multipart/x-gzip. Par défaut, text/xml A.2.d Détail des paramètres IV.A.2.d.1 Service Le service est toujours SANDRE:WasteWaterData. Si un autre service est demandé, le service retourne une erreur de «UnknownService». IV.A.2.d.2 Request Pour récupérer la liste des sites, l opération est GetWasteWaterFacilities. Si une autre opération est demandée, le service retourne une erreur de «OperationNotSupported». IV.A.2.d.3 Version La version est toujours Si une autre version est demandée, le service retourne une erreur de «UnknownVersion». IV.A.2.d.4 FacilityType L attribut FacilityType précise le type d informations recherché. Une seule valeur est autorisée. Cette valeur DOIT respecter la nomenclature suivante [Tirée des nomenclatures Sandre intitulée type de l ouvrage de connexion (CXN) ; Code Sandre Libellé 3 Système de collecte 4 Système de traitement 6 Ouvrage de rejet Seul le code DOIT être échangé. Si une autre valeur ou la valeur n est pas gérée, le service retourne une erreur de «DomainNotSupported». IV.A.2.d.5 SpatialConstraints Le paramètre SpatialConstraints précise les critères spatiaux de recherche. Cet attribut DOIT être un fichier XML conforme au schéma décrit dans la partie «Schémas» et représenté ci-après. SANDRE / Services de consultation des données assainissement 33/89

34 SPATIAL FILTER Numéro de la commune Numéro du département Numéro de la région Numéro de la circonscription du bassin Code national de la masse d'eau Code du secteur hydrographique Code du sous secteur hydrographique Code de la zone hydrographique Code générique de l'entité hydrographique Code de l'entité hydrogéologique Code de la zone sensible Bassin DCE Type de masse d'eau : IdentifierType : CodeType : CodeType : CodeType : IdentifierType : IdentifierType : IdentifierType : IdentifierType : IdentifierType : IdentifierType : CodeType : CodeType : CodeType 0..1 BBOX 1..1 gml:enveloppe - - gml:lowercorner gml:uppercorner gml:enveloppe : gml:directpositiontype : gml:directpositiontype Le schéma DOIT débuter par une balise racine <SpatialFilter>. Cette balise regroupe ensuite tous les critères spatiaux décrits dans le tableau ci-après : Balise Critère Multiplicité Commentaires <CdCommune> Code INSEE de la 0..1 commune <CdDepartement> Code INSEE du 0..1 département <CdRegion> Code INSEE de la 0..1 région <BBOX> Rectangle englobant 0..1 <NumCircAdminBassin> Code national du bassin 0..1 <CdBassinDCE> Code national du district 0..1 <CdZoneHydro> Code national de la zone 0..1 hydrographique <CdMasseDEau> Code de la masse d eau DCE 0..1 SANDRE / Services de consultation des données assainissement 34/89