Serviceoperationer Puls Pointsample Miljøportalsekretariatet Punktkildeprojektet Den 4. marts 2015 Indholdsfortegnelse GENERELT FOR ALLE METODER I WEBSERVICEN 2 POINTSAMPLE.ISALIVE 3 POINTSAMPLE.GEMPOINTSAMPLE 5 POINTSAMPLE.FINDPOINTSAMPLE 12 POINTSAMPLE.DEAKTIVERPOINTSAMPLE 14
Generelt for alle metoder i webservicen Revisionshistorik Dato Rev. af Version Revision 2015-03-04 MHF 0.2 Opdateringer af endpoints mv. 2012-02-24 BC-HRJ 0.1 Dokument oprettet Alle metoder i Stamdata Webservicen er pakket ind i en struktur som ses nedenfor: Kald service Roller, CVR-nummer og GUID hentes fra SAML Token Brugerrettigheder til PULS findes Loggingservice kaldes. Valid bruger? Returner fejl Alle webservices er pakket ind i en struktur magen til denne. Dvs. omkranset af logging og brugervalidering. Loggingservice kaldes. Returner resultat Det vil sige at alle metoder, beskrevet i dette dokument, er pakket ind i denne struktur, og de kald og tjek der er beskrevet her, udføres alle før og efter metoderne der er beskrevet senere. Service Operation Definition WSDL Service NemID-service Prod: http://services.puls.miljoeportal.dk/miljoeportal.surfacewater.pointsources.1.0.0/wsdl/pointsample.wsdl Demo: http://services.puls.demo.miljoeportal.dk/miljoeportal.surfacewater.pointsources.1.0.0/wsdl/pointsample.wsdl Prod: http://services.puls.miljoeportal.dk/miljoeportal.surfacewater.pointsources.1.0.1/pointsample.svc Demo: http://services.puls.demo.miljoeportal.dk/miljoeportal.surfacewater.pointsources.1.0.1/pointsample.svc Prod: http://services.puls.miljoeportal.dk/miljoeportal.surfacewater.pointsources.1.0.1/nemid/pointsample.svc Demo: http://services.puls.demo.miljoeportal.dk/miljoeportal.surfacewater.pointsources.1.0.1/nemid/pointsample.svc B 3.1a PULS Serviceoperationer - Pointsample.docx 2
Pointsample.IsAlive Indenfor Pointsample Service beskrives et antal operationer, hver med sin definition herunder. Revisionshistorik Dato Rev. af Version Revision 2015-01-19 SMu 0.3 Opdateret versions-info 2012-02-22 Morten Høybye Frederiksen 0.2 Diverse tilretninger. 2012-02-02 BC-SMu 0.1 Dokument oprettet Styringsdata Navn Version Status Dato for frigivelse Pointsample.svc#IsAlive Forretningsmæssig kontekst Formål /beskrivelse Service operations diagram Operationen tester forbindelse til servicen og den bagvedliggende database. Opret forbindelse til database og verificer at Punktkilde-tabellen findes Er forbindelsen OK? Returner normalsvar Returner fejlsvar Data som udveksles (input/output) Fejlhåndteringsreturdata Operationen tager som input en dmp:messagetype-struktur (jf. http://rep.oio.dk/dmp.dk/xml/schemas/2009/03/01/dmpmessagepayload%20v%201.2.xsd), idet de indsendte parametre dog ignoreres. Som output leveres en dmp:resultmessagetype (jf. http://rep.oio.dk/dmp.dk/xml/schemas/2009/03/01/dmpresultmessage%20v%201.2.xsd) idet indholdet afhænger af, om svaret er positivt eller negativt: Et positivt svar kan give et svar som følgende: <s:envelope xmlns:s="http://www.w3.org/2003/05/soap-envelope"> <s:header> <ActivityId CorrelationId="6cdd5732-f4c0-4572-8699-7ba492f1c7ac" xmlns="http://schemas.microsoft.com/2004/09/servicemodel/diagnostics"> 2e7cdafc-450f-40c8-aaad-11881bf190ff </ActivityId> </s:header> <s:body xmlns:xsi="http://www.w3.org/2001/xmlschema-instance" xmlns:xsd="http://www.w3.org/2001/xmlschema"> <IsAliveResponse xmlns="urn:oio:miljoeportal:surfacewater:pointsources:1.0.0"> <ResultCode xmlns="http://rep.oio.dk/dmp.dk/xml/schemas/2009/03/01/">0</resultcode> <ResultReason xmlns="http://rep.oio.dk/dmp.dk/xml/schemas/2009/03/01/"> Completed successfully </ResultReason> <ResultDetail xmlns="http://rep.oio.dk/dmp.dk/xml/schemas/2009/03/01/"> 2012-02-22T08:12:13Z </ResultDetail> </IsAliveResponse> </s:body> </s:envelope> I tilfælde af fejl returneres en besked i samme struktur som et positivt resultat jf. ovenfor, men eksempelvis med følgende indhold: <s:envelope xmlns:s="http://www.w3.org/2003/05/soap-envelope"> <s:header> <ActivityId CorrelationId="6cdd5732-f4c0-4572-8699-7ba492f1c7ac" xmlns="http://schemas.microsoft.com/2004/09/servicemodel/diagnostics"> B 3.1a PULS Serviceoperationer - Pointsample.docx 3
2e7cdafc-450f-40c8-aaad-11881bf190ff </ActivityId> </s:header> <s:body xmlns:xsi="http://www.w3.org/2001/xmlschema-instance" xmlns:xsd="http://www.w3.org/2001/xmlschema"> <IsAliveResponse xmlns="urn:oio:miljoeportal:surfacewater:pointsources:1.0.0"> <ResultCode xmlns="http://rep.oio.dk/dmp.dk/xml/schemas/2009/03/01/">-1</resultcode> <ResultReason xmlns="http://rep.oio.dk/dmp.dk/xml/schemas/2009/03/01/"> Repository check failed </ResultReason> <ResultDetail xmlns="http://rep.oio.dk/dmp.dk/xml/schemas/2009/03/01/"> [Stack Trace] </ResultDetail> </IsAliveResponse> </s:body> </s:envelope> Følgende fejltyper er defineret: Fejlhåndtering Sikkerhed Anvendt / udbudt Servicekvalitet Responstid Kalde-effekt kategori Noter Use Cases Forretningsobjekter -1: Repository check failed (Der kunne ikke opnås forbindelse til databasen) Ingen. TBD: Roller Operationen er udviklet for DMP og påtænkes anvendt til intern monitorering. Afsendt besked vil som regel nå modtageren én gang. Under 10 sekunder. Servicen kan kaldes efter behov. Ingen. Der henvises til beskrivelse af udarbejdede user stories for PULS-projektet. Ingen. B 3.1a PULS Serviceoperationer - Pointsample.docx 4
Pointsample.GemPointsample Revisionshistorik Dato Rev. af Version Revision 2015-01-19 SMu 0.7 Opdateret versions-info 2014-02-17 SMu 0.6 Opdateret fejl-resonse 2014-01-09 SMu 0.5 Opdateret request/response 2013-05-27 SMu 0.4 Fjernet DoegnvandmaengdeMaal. 2012-09-27 Christian Kullmann 0.3 Rettelser, ændringer vedrørende aktør (rekvireret / udført af) 2012-03-18 BC-SMu 0.2 Opdateret afsnit, så det afspejler funktionaliteten. 2012-02-22 BC-SMu 0.1 Dokument oprettet Styringsdata Navn Version Status Dato for frigivelse Pointsample.svc#GemPointsample Forretningsmæssig kontekst Formål /beskrivelse Operationen indsætter og opdaterer prøvetagning, feltmåling, måleresultat, organoleptisk resultat og prøve i den bagvedliggende database. B 3.1a PULS Serviceoperationer - Pointsample.docx 5
Service operations diagram Foresørgsel valid? Gentag for hver prøvetagning Erstat tidligere? Erstat tidligere Gentag for hver prøve Erstat tidligere? Erstat tidligere Opret prøve Fejl Gentag for hvert feltmåling Erstat tidligere? Erstat tidligere Gentag for hver måleresultat / organoleptisk resultat Erstat tidligere? Erstat tidligere Opret måleresultat / organoleptisk resultat Data behandlet Tilrettelæg resultat B 3.1a PULS Serviceoperationer - Pointsample.docx 6
Data som udveksles (input / output) Inputdata: Strukturen i inputdata er denne: Request (1) Prøvetagning (0-mange) o Rekvireret af (1) o Udført af (1) o Prøve (0-mange) Feltmåling (0-mange) o Rekvireret af (1) o Udført af (1) o Måleresultat (0-mange) o Organoleptisk resultat (0-mange) Herunder et request uden indhold: <soap:envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope" xmlns:urn="urn:oio:miljoeportal:surfacewater:pointsources:1.0.0" xmlns:urn1="urn:oio:au:dmu:stancode:1.0.0" xmlns:ns="http://rep.oio.dk/cvr.dk/xml/schemas/2005/03/22/"> <soap:header/> <soap:body> <urn:gempointsamplerequest> <!--You have a CHOICE of the next 2 items at this level--> <urn:proevetagningstruktur> <urn:proevetagningidentifikator></urn:proevetagningidentifikator> <urn:erstatterproevetagningreference></urn:erstatterproevetagningreference> <urn:startdatotid></urn:startdatotid> <urn:slutdatotid></urn:slutdatotid> <urn:maalestedreference></urn:maalestedreference> <urn1:sc1006samplingequipmentcode></urn1:sc1006samplingequipmentcode> <urn1:sc1010measurementmethodcode></urn1:sc1010measurementmethodcode> <urn:sc1081undersoegelsesformaalkode></urn:sc1081undersoegelsesformaalkode> <urn:bemaerkningtekst></urn:bemaerkningtekst> <urn:rekvireretafstruktur> <urn:personnavn></urn:personnavn> <urn1:sc1025institutioncode></urn1:sc1025institutioncode> <ns:cvrnumberidentifier></ns:cvrnumberidentifier> <ns:productionunitidentifier></ns:productionunitidentifier> </urn:rekvireretafstruktur> <urn:udfoertafstruktur> <urn:personnavn></urn:personnavn> <urn1:sc1025institutioncode></urn1:sc1025institutioncode> <ns:cvrnumberidentifier></ns:cvrnumberidentifier> <ns:productionunitidentifier></ns:productionunitidentifier> </urn:udfoertafstruktur> <urn:proevestruktur> <urn:proeveidentifikator></urn:proeveidentifikator> <urn:erstatterproevereference></urn:erstatterproevereference> <urn:akkrediteretindikator></urn:akkrediteretindikator> <urn1:sc1005sampletypecode></urn1:sc1005sampletypecode> <urn:maengdemaal></urn:maengdemaal> <urn1:sc1009measurementunitcode></urn1:sc1009measurementunitcode> <urn:antaldelproeverkvantitet></urn:antaldelproeverkvantitet> B 3.1a PULS Serviceoperationer - Pointsample.docx 7
<urn:modtagetdatotid></urn:modtagetdatotid> <urn1:sc1080storagetemperaturecode></urn1:sc1080storagetemperaturecode> <urn:bemaerkningtekst></urn:bemaerkningtekst> </urn:proevestruktur> </urn:proevetagningstruktur> <urn:feltmaalingstruktur> <urn:feltmaalingidentifikator></urn:feltmaalingidentifikator> <urn:erstatterfeltmaalingreference></urn:erstatterfeltmaalingreference> <urn:startdatotid></urn:startdatotid> <urn:slutdatotid></urn:slutdatotid> <urn:maalestedreference></urn:maalestedreference> <urn1:sc1006samplingequipmentcode></urn1:sc1006samplingequipmentcode> <urn1:sc1010measurementmethodcode></urn1:sc1010measurementmethodcode> <urn:sc1081undersoegelsesformaalkode></urn:sc1081undersoegelsesformaalkode> <urn:bemaerkningtekst></urn:bemaerkningtekst> <urn:rekvireretafstruktur> <urn:personnavn></urn:personnavn> <urn1:sc1025institutioncode></urn1:sc1025institutioncode> <ns:cvrnumberidentifier></ns:cvrnumberidentifier> <ns:productionunitidentifier></ns:productionunitidentifier> </urn:rekvireretafstruktur> <urn:udfoertafstruktur> <urn:personnavn></urn:personnavn> <urn1:sc1025institutioncode></urn1:sc1025institutioncode> <ns:cvrnumberidentifier></ns:cvrnumberidentifier> <ns:productionunitidentifier></ns:productionunitidentifier> </urn:udfoertafstruktur> <urn:maaleresultatstruktur> <urn:maaleresultatidentifikator></urn:maaleresultatidentifikator> <urn:erstattermaaleresultatreference></urn:erstattermaaleresultatreference> <urn:akkrediteretindikator></urn:akkrediteretindikator> <urn1:sc1008parametercode></urn1:sc1008parametercode> <urn:resultatmaal></urn:resultatmaal> <urn1:sc1009measurementunitcode></urn1:sc1009measurementunitcode> <urn:maaltdatotid></urn:maaltdatotid> <urn:bemaerkningtekst></urn:bemaerkningtekst> </urn:maaleresultatstruktur> <urn:organoleptiskresultatstruktur> <urn:organoleptiskresultatidentifikator></urn:organoleptiskresultatidentifikator> <urn:erstatterorganoleptiskresultatreference></urn:erstatterorganoleptiskresultatrefer ence> <!--You have a CHOICE of the next 5 items at this level--> B 3.1a PULS Serviceoperationer - Pointsample.docx 8
<urn1:sc1059smellcode></urn1:sc1059smellcode> <urn:vandfasesc1060colourcode></urn:vandfasesc1060colourcode> <urn:bundfaldsc1060colourcode></urn:bundfaldsc1060colourcode> <urn1:sc1071appearancecode></urn1:sc1071appearancecode> <urn1:sc1072structurecode></urn1:sc1072structurecode> <urn:bemaerkningtekst></urn:bemaerkningtekst> </urn:organoleptiskresultatstruktur> </urn:feltmaalingstruktur> </urn:gempointsamplerequest> </soap:body> </soap:envelope> Outputdata: Samme struktur som inputdata. Fejlhåndteringsreturdata I tilfælde af fejl returneres en besked i en struktur som angivet nedenfor, eksempelvis med følgende indhold: <s:envelope xmlns:s="http://www.w3.org/2003/05/soap-envelope"> <s:body> <s:fault> <s:code> <s:value>s:receiver</s:value> <s:subcode> <s:value xmlns:a="http://schemas.microsoft.com/net/2005/12/windowscommunicationfoundation/disp atcher">a:internalservicefault</s:value> </s:subcode> </s:code> <s:reason> <s:text xml:lang="da-dk"> Feltet Sc1081UndersoegelsesformaalKode (Proevetagning) skal indeholde et heltal at Ekstra.Extension.ValiderStringSominteger(String emne, String emnenavn, String tabel Navn, Boolean obligatorisk) in C:\Main\Backend\Ekstra\Diverse.cs:line 549 at Ekstra.Extension.ValiderStringSominteger(String emne, String emnenavn, String tabel Navn) in C:\Main\Backend\Ekstra\Diverse.cs:line 524 at WebserviceWebrolle.PointsampleService.PointsampleMapping.FraXMLTilDatabase(Object[] nye) in C:\Main\Backend\WebserviceWebrolle\miljoeportal.surfacewater.pointsources.1.0.0\Po intsamplemapping.cs:line 51 at WebserviceWebrolle.PointsampleService.Pointsample.GemPointsample(GemPointsampleRequ est request) in C:\Main\Backend\WebserviceWebrolle\miljoeportal.surfacewater.pointsources.1.0.0\Pointsample.svc.cs:line 48 </s:text> </s:reason> <s:detail> <ExceptionDetail xmlns="http://schemas.datacontract.org/2004/07/system.servicemodel" xmlns:i="http://www.w3.org/2001/xmlschema-instance"> <HelpLink i:nil="true"/> <InnerException> <HelpLink i:nil="true"/> <InnerException i:nil="true"/> <Message>Feltet Sc1081UndersoegelsesformaalKode (Proevetagning) skal indeholde et heltal</message > <StackTrace> at Ekstra.Extension.ValiderStringSominteger(String emne, String emnenavn, String tab elnavn, Boolean obligatorisk) in C:\Main\Backend\Ekstra\Diverse.cs:line 549 at Ekstra.Extension.ValiderStringSominteger(String emne, String emnenavn, String tab elnavn) in C:\Main\Backend\Ekstra\Diverse.cs:line 524 at WebserviceWebrolle.PointsampleService.PointsampleMapping.FraXMLTilDatabase(Object [] nye) in C:\Main\Backend\WebserviceWebrolle\miljoeportal.surfacewater.pointsources.1.0.0\ PointsampleMapping.cs:line 51 at WebserviceWebrolle.PointsampleService.Pointsample.GemPointsample(GemPointsampleRe quest request) in C:\Main\Backend\WebserviceWebrolle\miljoeportal.surfacewater.pointsources.1.0.0\Pointsample.svc.cs:line 48 </StackTrace> <Type>System.ArgumentException</Type> B 3.1a PULS Serviceoperationer - Pointsample.docx 9
</InnerException> <Message> Feltet Sc1081UndersoegelsesformaalKode (Proevetagning) skal indeholde et heltal at Ekstra.Extension.ValiderStringSominteger(String emne, String emnenavn, String tabe lnavn, Boolean obligatorisk) in C:\Main\Backend\Ekstra\Diverse.cs:line 549 at Ekstra.Extension.ValiderStringSominteger(String emne, String emnenavn, String tabe lnavn) in C:\Main\Backend\Ekstra\Diverse.cs:line 524 at WebserviceWebrolle.PointsampleService.PointsampleMapping.FraXMLTilDatabase(Object[ ] nye) in C:\Main\Backend\WebserviceWebrolle\miljoeportal.surfacewater.pointsources.1.0.0\P ointsamplemapping.cs:line 51 at WebserviceWebrolle.PointsampleService.Pointsample.GemPointsample(GemPointsampleReq uest request) in C:\Main\Backend\WebserviceWebrolle\miljoeportal.surfacewater.pointsources. 1.0.0\Pointsample.svc.cs:line 48 </Message> <StackTrace> <![CDATA[at Ekstra.Webservicewrapper.Epilog(Boolean throwexception, String& ResultCod e, String& ResultReason, String& ResultDetail, String& ResultActor, String metode) in C:\Ma in\backend\ekstra\webservicewrapper.cs:line 120 at Ekstra.Webservicewrapper.Epilog() in C:\Main\Backend\Ekstra\Webservicewrapper.cs:line 57 at WebserviceWebrolle.PointsampleService.Pointsample.GemPointsample(GemPointsampleReques t request) in C:\Main\Backend\WebserviceWebrolle\miljoeportal.surfacewater.pointsources.1.0.0\Pointsample.svc.cs:line 64 at SyncInvokeGemPointsample(Object, Object[], Object[] ) at System.ServiceModel.Dispatcher.SyncMethodInvoker.Invoke(Object instance, Object[] inp uts, Object[]& outputs) at System.ServiceModel.Dispatcher.DispatchOperationRuntime.InvokeBegin(MessageRpc& rpc) at System.ServiceModel.Dispatcher.ImmutableDispatchRuntime.ProcessMessage5(MessageRpc& r pc) at System.ServiceModel.Dispatcher.ImmutableDispatchRuntime.ProcessMessage31(MessageRpc& rpc) at System.ServiceModel.Dispatcher.MessageRpc.Process(Boolean isoperationcontextset)]]> </StackTrace> <Type>System.Exception</Type> </ExceptionDetail> </s:detail> </s:fault> </s:body> </s:envelope> Fejlhåndtering Sikkerhed Anvendt / udbudt Servicekvalitet Responstid Kalde-effekt kategori Noter Use Cases Fejl bliver returneret som SOAP-fault med information om fejlen TBD: Roller Operationen er udviklet for DMP og påtænkes anvendt til oprettelse og opdatering af prøvetagninger og feltmålinger. Afsendt besked vil som regel nå modtageren én gang. Under 10 sekunder. Operationen kan kaldes efter behov; bemærk dog følgende. Hvis alle identifikatorer er medtaget i request, vil data fremstå som opdateret og eneste sideeffekt vil være, at en kopi af eksisterende data vil blive gemt for hvert kald. Hvis ikke alle identifikatiorer er med, vil nye gældende poster blive indsat for hvert kald. Ingen. Der henvises til beskrivelse af udarbejdede user stories for PULS-projektet. B 3.1a PULS Serviceoperationer - Pointsample.docx 10
Forretningsobjekter Aktivitet Aktør Målested Parameter 1..* Produkt Prøvetagning Feltmåling Måleresultat IkkeProdukt OrganoleptiskResultat FysiskPrøve Ændring af allerede oprettet data Der kan være flere grunde til at man ønsker at ændre i allerede oprettede data: Tilføjelse af prøver etc. Ændring af tekst eller værdier. Deaktivering af prøvetagning og feltmåling med tilhørende produkter. For at ændre, skal brugeren angive identifikator for den del af data han/hun vil ændre. Hvis en identifikator for et givet felt er udfyldt, vil systemet undersøge om en post med denne identifikator findes; hvis den findes, træder reglerne gengivet herunder i kraft. Ændring af Prøvetagning og Feltmåling Disse er begge aktiviteter på næst-øverste niveau og bliver derfor behandlet sammen her. Hvis der eksisterer et produkt (prøve, måleresultat eller organoleptisk resultat) som er resultat af aktiviteten, kan det ikke lade sig gøre at ændre. Ellers sker følgende: Den aktivitet, som skal erstattes bliver sat til inaktiv. Der oprettes en ny aktiv aktivitet ud fra data i request. Den nye aktivitet erstatter altså den gamle; brugeren skal derfor angive identifikatoren for den aktivitet, der skal erstattes. Ændring af Prøve, Måleresultat og Organoleptisk Resultat Disse er resultat af en aktivitet på niveau under aktiviteter, og fællesbetegnelsen for dem er Produkter. Et produkt bliver erstattet på samme måde som en aktivitet: Det produkt, som skal erstattes bliver sat til inaktiv. Der oprettes et nyt aktivt produkt ud fra data i request. Set i forhold til prøvetagning og feltmåling er produkter et niveau under disse. Men produkter bliver også brugt i forbindelse med analyser, og hvis det er tilfældet kan man ikke erstatte et produkt. Hvis et produkt indgår i en analyse, kan man altså ikke erstatte det. Det nye produkt erstatter altså det gamle; brugeren skal derfor angive identifikatoren for det produkt, der skal erstattes. B 3.1a PULS Serviceoperationer - Pointsample.docx 11
Pointsample.FindPointsample Revisionshistorik Dato Rev. af Version Revision 2015-01-19 SMu 0.5 Opdateret versions-info 2014-01-09 SMu 0.4 Opdateret request/response 2012-09-27 Christian Kullmann 0.3 Rettelser, ændringer vedrørende aktør (rekvireret / udført af) 2012-03-18 BC-SMu 0.2 Opdateret afsnit, så det afspejler funktionaliteten. 2012-02-22 BC-SMu 0.1 Dokument oprettet Styringsdata Navn Version Status Dato for frigivelse Pointsample.svc#FindPointsample Forretningsmæssig kontekst Formål /beskrivelse Service operations diagram Operationen finder og viser Pointsample data og tilhørende elementer (prøvetagning, feltmåling, måleresultat, organoleptisk resultat og prøve) i den bagvedliggende database på baggrund af søgekriterier. Foresørgsel valid? Dan søgekriterier for Undersøgelser Udfør søgning Tilrettelæg resultat Data som udveksles (input / output) Inputdata: Strukturen i inputdata er denne: Request (1) Prøvetagning (0-1) o Rekvireret af (0-1) o Udført af (1) o Prøve (0-1) Feltmåling (0-1) o Rekvireret af (0-1) o Udført af (0-1) o Måleresultat (0-1) o Organoleptisk resultat (0-1) Her kan en struktur altså kun gentages én gang; ethvert felt i en struktur kan gentages 0 til mange gange. Herunder et request uden indhold: <soap:envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope" xmlns:urn="urn:oio:miljoeportal:surfacewater:pointsources:1.0.0" xmlns:urn1="urn:oio:au:dmu:stancode:1.0.0" xmlns:ns="http://rep.oio.dk/cvr.dk/xml/schemas/2005/03/22/"> <soap:header/> <soap:body> <urn:findpointsamplerequest> <urn:punktkildeidentifikator></urn:punktkildeidentifikator> <urn:medtagikkeprodukterindikator></urn:medtagikkeprodukterindikator> <urn:findproevetagningstruktur> <urn:proevetagningidentifikator></urn:proevetagningidentifikator> <urn:startdatotid></urn:startdatotid> <urn:fradato></urn:fradato> B 3.1a PULS Serviceoperationer - Pointsample.docx 12
<urn:tildato></urn:tildato> <urn:maalestedreference></urn:maalestedreference> <urn:sc1081undersoegelsesformaalkode></urn:sc1081undersoegelsesformaalkode> <urn:findrekvireretafstruktur> <urn1:sc1025institutioncode></urn1:sc1025institutioncode> <ns:cvrnumberidentifier></ns:cvrnumberidentifier> <ns:productionunitidentifier></ns:productionunitidentifier> </urn:findrekvireretafstruktur> <urn:findudfoertafstruktur> <urn1:sc1025institutioncode></urn1:sc1025institutioncode> <ns:cvrnumberidentifier></ns:cvrnumberidentifier> <ns:productionunitidentifier></ns:productionunitidentifier> </urn:findudfoertafstruktur> <urn:findproevestruktur> <urn:proeveidentifikator></urn:proeveidentifikator> <urn:akkrediteretindikator></urn:akkrediteretindikator> <urn1:sc1005sampletypecode></urn1:sc1005sampletypecode> </urn:findproevestruktur> </urn:findproevetagningstruktur> <urn:findfeltmaalingstruktur> <urn:feltmaalingidentifikator></urn:feltmaalingidentifikator> <urn:startdatotid></urn:startdatotid> <urn:fradato></urn:fradato> <urn:tildato></urn:tildato> <urn:maalestedreference></urn:maalestedreference> <urn:sc1081undersoegelsesformaalkode></urn:sc1081undersoegelsesformaalkode> <urn:findrekvireretafstruktur> <urn1:sc1025institutioncode></urn1:sc1025institutioncode> <ns:cvrnumberidentifier></ns:cvrnumberidentifier> <ns:productionunitidentifier></ns:productionunitidentifier> </urn:findrekvireretafstruktur> <urn:findudfoertafstruktur> <urn1:sc1025institutioncode></urn1:sc1025institutioncode> <ns:cvrnumberidentifier></ns:cvrnumberidentifier> <ns:productionunitidentifier></ns:productionunitidentifier> </urn:findudfoertafstruktur> <urn:findmaaleresultatstruktur> <urn:maaleresultatidentifikator></urn:maaleresultatidentifikator> <urn:akkrediteretindikator></urn:akkrediteretindikator> <urn1:sc1008parametercode></urn1:sc1008parametercode> <urn:resultatmaal></urn:resultatmaal> <urn1:sc1009measurementunitcode></urn1:sc1009measurementunitcode> <urn:fradato></urn:fradato> <urn:tildato></urn:tildato> </urn:findmaaleresultatstruktur> <urn:findorganoleptiskresultatstruktur> B 3.1a PULS Serviceoperationer - Pointsample.docx 13
<urn:organoleptiskresultatidentifikator></urn:organoleptiskresultatidentifikator> </urn:findorganoleptiskresultatstruktur> </urn:findfeltmaalingstruktur> </urn:findpointsamplerequest> </soap:body> </soap:envelope> Outputdata: Samme struktur som GemPointsample outputdata. Fejlhåndteringsreturdata Fejlhåndtering Sikkerhed Anvendt / udbudt Servicekvalitet Responstid Kalde-effekt kategori Noter Use Cases Forretningsobjekter I tilfælde af fejl returneres en besked i samme struktur som angivet for GemPointsample. Fejl bliver returneret som SOAP-fault med information om fejlen TBD: Roller Operationen er udviklet for DMP og påtænkes anvendt til udsøgning af Pointsample data. Afsendt besked vil som regel nå modtageren én gang. Under 10 sekunder. Operationen er idempotent. Ingen. Der henvises til beskrivelse af udarbejdede user stories for PULS-projektet. Se under GemPointsample. Pointsample.DeaktiverPointsample Revisionshistorik Dato Rev. af Version Revision 2015-01-19 SMu 0.3 Opdateret versions-info 2014-01-09 SMu 0.2 Opdateret request/response 2012-04-30 BC-SMu 0.1 Dokument oprettet Styringsdata Navn Version Status Dato for frigivelse Pointsample.svc#DeaktiverPointsample Forretningsmæssig kontekst Formål /beskrivelse Operationen deaktiverer Pointsample data og tilhørende elementer (prøvetagning, feltmåling, måleresultat, organoleptisk resultat og prøve) i den bagvedliggende database på baggrund af søgekriterier. B 3.1a PULS Serviceoperationer - Pointsample.docx 14
Service operations diagram Gentag for hvert organoleptisk resultat Findes org. resultat? Deaktiver org. resultat Foresørgsel valid? Gentag for hvert måleresultat Findes måleresultat? Deaktiver måleresultat Gentag for hver prøve Findes prøve? Deaktiver prøve Fejl Gentag for hver feltmåling Findes feltmåling? Deaktiver feltmåling Gentag for hver prøvetagning Findes prøvetagning? Deaktiver prøvetagning Data behandlet Tilrettelæg resultat B 3.1a PULS Serviceoperationer - Pointsample.docx 15
Data som udveksles (input / output) Inputdata: Strukturen i inputdata er denne: Request (1) Prøvetagning (0- mange) Prøve (0- mange) Feltmåling (0- mange) Måleresultat (0- mange) Organoleptisk resultat (0- mange) Her kan en struktur altså kun gentages én gang; ethvert felt i en struktur kan gentages 0 til mange gange. Herunder et request uden indhold: <soap:envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope" xmlns:urn="urn:oio:miljoeportal:surfacewater:pointsources:1.0.0"> <soap:header/> <soap:body> <urn:deaktiverpointsamplerequest> <urn:proevetagningidentifikator></urn:proevetagningidentifikator> <urn:feltmaalingidentifikator></urn:feltmaalingidentifikator> <urn:proeveidentifikator></urn:proeveidentifikator> <urn:maaleresultatidentifikator></urn:maaleresultatidentifikator> <urn:organoleptiskresultatidentifikator></urn:organoleptiskresultatidentifikator> </urn:deaktiverpointsamplerequest> </soap:body> </soap:envelope> Outputdata: Samme struktur som GemPointsample outputdata. Fejlhåndteringsreturdata Fejlhåndtering Sikkerhed Anvendt / udbudt Servicekvalitet Responstid Kalde-effekt kategori Noter Use Cases Forretningsobjekter I tilfælde af fejl returneres en besked i samme struktur som angivet for GemPointsample. Fejl bliver returneret som SOAP-fault med information om fejlen TBD: Roller Operationen er udviklet for DMP og påtænkes anvendt til deaktivering af Pointsample data. Afsendt besked vil som regel nå modtageren én gang. Under 10 sekunder. Operationen kan kun afvikles én gang med succes; de efterfølgende gange vil man forsøge at deaktivere en allerede deaktiveret post og det giver fejl. Ingen. Der henvises til beskrivelse af udarbejdede user stories for PULS-projektet. Se under GemPointsample. B 3.1a PULS Serviceoperationer - Pointsample.docx 16