PROCEDURE D'APPEL DU WEBSERVICE PERMETTANT DE CONTROLER LES FICHIERS XML-SANDRE Version 4

of 6
97 views
PDF
All materials on our website are shared by users. If you have any questions about copyright issues, please report us to resolve them. We are always happy to assist you.
Document Description
PRCEDURE D'APPEL DU WEBSERVICE PERMETTANT DE CNTRLER LES ICHIERS XML-SANDRE Version 4 Titre : PRCEDURE D'APPEL DU WEBSERVICE DU PARSEUR V4 PERMETTANT DE CNTRLER LES ICHIERS XML-SANDRE Créateur : Système
Document Share
Document Transcript
PRCEDURE D'APPEL DU WEBSERVICE PERMETTANT DE CNTRLER LES ICHIERS XML-SANDRE Version 4 Titre : PRCEDURE D'APPEL DU WEBSERVICE DU PARSEUR V4 PERMETTANT DE CNTRLER LES ICHIERS XML-SANDRE Créateur : Système d information sur l eau Sujet : utils du SIE Résumé : Éditeur : République française. ffice National de l'eau et des Milieux Aquatiques Contributeurs : ffice international de l eau Date : Version : 4.0 Type : Texte ormat : DT Identifiant :urn:sandre:procedure:parseur::4.0 Langue : fra Couverture spatiale : rance métropolitaine Couverture temporelle : Droits d usage : 1 / 6 Table des matières 1.Contexte Création de la requête Attribution d un jeton Certificat au format HTML in du traitement Contexte Le service de contrôle syntaxique est accessible à distance via la mise en place d un webservice, selon l architecture REST et la méthode HTTP PST. Pour rappel, Le service de validation en ligne permet actuellement de détecter les types d'erreurs suivants: Erreurs syntaxiques liées au non respect des recommandations du format XML proprement dit Erreurs structurelles liées au non respect des spécifications XML SANDRE pour un scénario d'échange donné, y compris les nomenclatures de valeurs possibles Erreurs liées au non respect des jeux de données de référence (codes SANDRE de paramètres, méthodes,...) br/ br/ Les erreurs relatives au non respect de règles métiers (exemple: une date de début doit être inférieure ou égale à une date de fin), ne sont pas actuellement prises en compte. Depuis cette version 4, l'utilisateur a également la possibilité de demander un format de restitution du fichier XML à tester, les formats disponibles étant fonction des feuilles de transformation développées et mis en ligne sur l'interface web. Pour ce faire, l'utilisateur doit mentionner dans sa requête le numéro de la feuille de transformation qu'il souhaite utiliser (cf tableau des paramètres de requête). Les transformations possibles sont : fichier XML en fichier XML fichier XML en fichier PD fichier XML en fichier CSV ou TXT fichier XML en fichier HTML Attention, la restitution demandée ne sera exécutée que si le fichier à tester est conforme. Pour faire appel au contrôleur syntaxique et service de transformation de vos fichiers directement depuis votre application, voici le mode opératoire. 2. Création de la requête Les paramètres suivants doivent être inclus dans un champ de type multipart/form-data et envoyé à l'adresse suivante selon le protocole HTTP et la méthode PST: 2 / 6 Nom des paramètres de requêtes XML Exemple Resultatsanalyses.x ml XSD «LAB_DEST;1» ou «CM_LAB ;1» Type / html type Cardinalité Note Caractère obligatoire / facultatif ile 1 Le fichier à tester (compressé au format zip ou non) Texte 1 Code du scenario d échange+ ; + Version du scenario d échange NomSI «Logiciel version 1» Texte 1 Nom du système d information à tester VersionSI «4.3» Texte 1 Version du système d information à tester NomIntervenant «LDA31» Texte 0 à 1 Nom de l'intervenant CdIntervenant Texte 0 à 1 Code de l'intervenant schemeagencyid SIRET Texte 0 à 1 rigine du code de l'intervenant Texte 0 à 1 Courriel de l'intervenant nom «Dupont» Texte 0 à 1 Nom du contact prenom «Jean» Texte 0 à 1 Prénom du contact NomService «Service assainissement» Texte 0 à 1 Nom du service Transformation 1 Texte 0 à N Numéro de la feuille de transformation Aucun ordre d apparition des paramètres dans la requête n est requis. Il est en revanche BLIGATIRE de renvoyer au minimum les paramètres suivants : «XML» «XSD» «NomSI» «VersionSI» Pour obtenir plusieurs formats de restitution, il faut mentionner dans la requête autant de paramètre «Transformation» que de format de restitution souhaité. 3 / 6 3. Attribution d un jeton et des liens vers le certificat de conformité Dès lors que votre fichier est pris en charge par notre service, un jeton sous forme d une chaîne de caractère alphanumérique vous est attribué. Il vous est automatiquement renvoyé un fichier structuré de la manière suivante : token /token Deux liens vous sont adressés en plus via les balises LienAcquittement et LienCertificat . La balise LienAcquittement contient le lien vers le certificat de conformité au format XML, respectant le scénario suivant : La balise LienCertificat contient quant à elle le lien vers le certificat de conformité au format HTML 4. Certificat au format XML Vous pouvez alors à tout moment, manuellement ou de manière automatisée vous rendre à l adresse URL exacte de ce message d acquittement pour suivre l avancement et consulter le résultat final du traitement : Adresse URL du message d'acquittement au format XML : «http://sandre.eaufrance.fr/ps/acquittement?jeton=» + [jeton] exemple, 5. Certificat au format HTML Le message d acquittement est également accessible au format HTML, sous la forme d un certificat de conformité (ou de non-conformité). Il existe donc un certificat par fichier testé. L adresse URL du certificat est : «http://sandre.eaufrance.fr/parseur/getcertificat.php?jeton=» + [jeton] exemple, 6. in du traitement Tant que le traitement n est pas terminé, la balise XML Acceptation du message d acquittement prendra pour valeur «0» signifiant «en cours de traitement». 4 / 6 Dès lors que le traitement sera terminé, cette balise prendra pour valeur «1» si le fichier est conforme, et «2» si celui-ci est non conforme. La liste des erreurs détectées est transmise via un ensemble de balises XML Error , telle que définie dans la structure du message d acquittement. Au sein du certificat (format HTML), les erreurs apparaissent en bas au sein d un tableau. A noter que les erreurs sont codées. 7. Exemple de la structure d'un certificat au format XML ACQ Scenario CodeScenario ACQ /CodeScenario VersionScenario 2 /VersionScenario NomScenario Messaged'acquittement /NomScenario DateCreationichier /DateCreationichier Emetteur CdIntervenant schemeagencyid= sandre 1470 /cdintervenant NomIntervenant Service d'administration Nationale des Données et Référentiels sur l'eau /nomintervenant Service NomService SANDRE /NomService /Service Contact NomContact MREN /NomContact PrenomContact Yohann /PrenomContact /Contact SI NomSI ParseurSANDRE /NomSI VersionSI 3 /VersionSI AdresseIP/ /SI /Emetteur Destinataire CdIntervenant schemeagencyid= 1470 /cdintervenant NomIntervenant Service d'administration Nationale des Donnà es et Rà fã rentiels sur l'eau /nomintervenant Service NomService Sandre /NomService /Service Contact NomContact Crespin /NomContact PrenomContact Louis /PrenomContact /Contact 5 / 6 SI NomSI MDM sandre /nomsi VersionSI 1.0 /VersionSI AdresseIP /AdresseIP /SI /Destinataire /Scenario AccuseReception Acceptation 1 /Acceptation CodeScenario RE /CodeScenario VersionScenario 2 /VersionScenario NomScenario Diffusion des données du référentiel SANDRE /NomScenario DateCreationichier /DateCreationichier ReferenceichierEnvoi AN.xml /ReferenceichierEnvoi CleSecuichierEnvoi 75 6B E5 C0 6 A B C8 7B 70 2E B3 B /CleSecuichierEnvoi Tailleichier Ko /Tailleichier DateMAJSchemaXML /DateMAJSchemaXML DateMAJSchematronReferentiel/ DateMAJSchematronReglesMetier /DateMAJSchematronReglesMetier TempsEtape0 1 Sec /TempsEtape0 TempsEtape1 1 Sec /TempsEtape1 TempsEtape3 1 Sec /TempsEtape3 TempsEtape4 1 Sec /TempsEtape4 Transformation Id 1 /Id ormat csv /ormat Resultat 1 /Resultat /Transformation /AccuseReception /ACQ 6 / 6
Similar documents
View more...
Search Related
We Need Your Support
Thank you for visiting our website and your interest in our free products and services. We are nonprofit website to share and download documents. To the running of this website, we need your help to support us.

Thanks to everyone for your continued support.

No, Thanks
SAVE OUR EARTH

We need your sign to support Project to invent "SMART AND CONTROLLABLE REFLECTIVE BALLOONS" to cover the Sun and Save Our Earth.

More details...

Sign Now!

We are very appreciated for your Prompt Action!

x