Serviceoperationer Puls Udtraek Miljøportalsekretariatet Punktkildeprojektet Den 4. marts 2015 Indholdsfortegnelse GENERELT FOR ALLE METODER I WEBSERVICEN 2 UDTRAEK.ISALIVE 3 UDTRAEK. HENTUDTRAEK 5 UDTRAEK. GEMUDVALGSLISTE 6 UDTRAEK. FINDUDVALGSLISTE 9 UDTRAEK. DEAKTIVERUDVALGSLISTE 11
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: 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/stancode.wsdl Demo: http://services.puls.demo.miljoeportal.dk/miljoeportal.surfacewater.pointsources.1.0.0/wsdl/stancode.wsdl Prod: http://services.puls.miljoeportal.dk/miljoeportal.surfacewater.pointsources.1.0.1/stancode.svc Demo: http://services.puls.demo.miljoeportal.dk/miljoeportal.surfacewater.pointsources.1.0.1/stancode.svc Prod: http://services.puls.miljoeportal.dk/miljoeportal.surfacewater.pointsources.1.0.1/nemid/stancode.svc Demo: http://services.puls.demo.miljoeportal.dk/miljoeportal.surfacewater.pointsources.1.0.1/nemid/stancode.svc B 3.1a PULS Serviceoperationer - Udtraek.docx 2
Udtraek.IsAlive Indenfor Udtraek Service beskrives et antal operationer, hver med sin definition herunder. Revisionshistorik Dato Rev. af Version Revision 2015-01-19 SMu 0.4 Opdateret versions-info 2012-02-22 Christian Kullmann 2012-02-22 Morten Høybye Frederiksen 0.3 Diverse tilretninger. 0.2 Diverse tilretninger. 2012-02-02 Søren Munk 0.1 Dokument oprettet Styringsdata Navn Version Status Dato for frigivelse Udtraek.svc#IsAlive Forretningsmæssig kontekst Formål /beskrivelse Service operations diagram Operationen tester forbindelse til servicen og den bagvedliggende database. Data som udveksles (input/output) 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> Fejlhåndteringsreturdata 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"> B 3.1a PULS Serviceoperationer - Udtraek.docx 3
<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/">- 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> Følgende fejltyper er defineret: -1: Repository check failed (Der kunne ikke opnås forbindelse til databasen) Fejlhåndtering Sikkerhed Anvendt / udbudt Servicekvalitet Responstid Kalde-effekt kategori Noter Use Cases Forretningsobjekter 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. Der henvises til beskrivelse af udarbejdede user stories for PULS-projektet. B 3.1a PULS Serviceoperationer - Udtraek.docx 4
Udtraek. HentUdtraek Revisionshistorik Dato Rev. af Version Revision 2015-01-19 SMu 0.7 Opdateret versions-info 2014-12-10 MHF 0.6 Opdateret udtrækstype-liste 2014-09-02 SMu 0.5 Opdateret udtrækstype-liste 2014-01-09 SMu 0.4 Opdateret request/response 2012-02-24 BC-HRJ 0.3 Diverse tilretninger. 2012-02-22 Christian Kullmann 0.2 Diverse tilretninger. 2012-02-22 Søren Munk 0.1 Dokument oprettet Styringsdata Navn Version Status Dato for frigivelse Udtraek.svc#HentUdtraek Forretningsmæssig kontekst Formål /beskrivelse Service operations diagram Operationen henter data fra tabeller i den bagvedliggende database på baggrund af søgeparametre. Foresørgsel valid? Ja Dan søgekriterier for punktkilder Udfør søgning Tilrettelæg resultat Data som udveksles (input / output) Inputdata: <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:hentudtraekrequest> <urn:udtraektype></urn:udtraektype> <!--Optional:--> <urn:aar></urn:aar> <!--1 or more repetitions:--> <urn:punktkildeidentifikator></urn:punktkildeidentifikator> </urn:hentudtraekrequest> </soap:body> </soap:envelope> Elementet <urn:udtraektype> skal indeholde en af følgende værdier (øvrige udtræk er erstattet af bruger-rapporter): dublettervedlaasning Outputdata: <s:envelope xmlns:s="http://www.w3.org/2003/05/soap-envelope"> <s:header> <ActivityId CorrelationId="20b58cc1-0fde-470b-bf48-115e7cea2b0b" xmlns="http://schemas.microsoft.com/2004/09/servicemodel/diagnostics">da60763d-fd3d- 471a-9136-2d225659271d</ActivityId> </s:header> <s:body xmlns:xsi="http://www.w3.org/2001/xmlschema-instance" xmlns:xsd="http://www.w3.org/2001/xmlschema"> <HentUdtraekResponse xmlns="urn:oio:miljoeportal:surfacewater:pointsources:1.0.0"> <UdtraeksraekkeStruktur> <UdtraeksfeltStruktur> <Navn></Navn> <VaerdiTekst></VaerdiTekst> B 3.1a PULS Serviceoperationer - Udtraek.docx 5
</UdtraeksfeltStruktur> </UdtraeksraekkeStruktur> </HentUdtraekResponse> 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 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/dispatch er">a:internalservicefault</s:value> </s:subcode> </s:code> <s:reason> <s:text xml:lang="en-us">hentudtraek er fejlet</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"> <InnerException> <InnerException i:nil="true"/> <Message>'ukendt udtraek' er ikke en gyldig udtrækstype</message> at UdtraekBackend.Udtraek.Danudtraek(FindPunktkildeGruppe findpunktkilde- Gruppe, String udtraektype)... <Type>System.Exception</Type> </InnerException> <Message>HentUdtraek er fejlet</message> at WebserviceWebrolle.UdtraekService.Udtraek.HentUdtraek(HentUdtraekRequest request) in... <Type>System.Exception</Type> </ExceptionDetail> </s:detail> </s:fault> Fejl bliver returneret som SOAP-fault med information om fejlen TBD: Roller Operationen er udviklet for DMP og påtænkes anvendt til udtræk af data. Afsendt besked vil som regel nå modtageren én gang. Under 20 sekunder. Servicen er idempotent. Der henvises til beskrivelse af udarbejdede user stories for PULS-projektet. Alle kald af operationen returnerer data i en generaliseret struktur, som er målrettet visning i tabelform eller eksport til for eksempel Excel. Udtraek. GemUdvalgsliste 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-12-17 Søren Munk 0.1 Dokument oprettet B 3.1a PULS Serviceoperationer - Udtraek.docx 6
Styringsdata Navn Version Status Dato for frigivelse Udtraek.svc#GemUdvalgsliste Forretningsmæssig kontekst Formål /beskrivelse Service operations diagram Operationen indsætter og opdaterer data fra tabeller i den bagvedliggende database på baggrund af parametre. Gentag for hver udvalgsliste Forespørgsel valid? Findes liste i forvejen? Nej Opret liste Ja Nej Opdater liste Gentag for hvert punktkildeudvalg Deaktiver tidligere Fejl Gentag for hvert punktkildeudvalg Opret punktkildeudvalg Alle lister behandlet Tilrettelæg resultat Data som udveksles (input / output) Inputdata: <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:gemudvalgslisterequest> <!--1 or more repetitions:--> <urn:udvalgslistestruktur> <urn:navn></urn:navn> <!--Optional:--> <urn:bemaerkningtekst></urn:bemaerkningtekst> <!--Optional:--> <urn:udvalgslisteidentifikator></urn:udvalgslisteidentifikator> <!--Optional:--> <urn:opdateretdatotid></urn:opdateretdatotid> B 3.1a PULS Serviceoperationer - Udtraek.docx 7
<!--Zero or more repetitions:--> <urn:punktkildeidentifikator></urn:punktkildeidentifikator> </urn:udvalgslistestruktur> </urn:gemudvalgslisterequest> </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/windowscommunication foundation/dispatcher">a:internalservicefault</s:value> </s:subcode> </s:code> <s:reason> <s:text xml:lang="da-dk">guid should contain 32 digits with 4 dashes (xxxxxxxxxxxx-xxxx-xxxx-xxxxxxxxxxxx).</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"> <InnerException> <InnerException i:nil="true"/> <Message>Guid should contain 32 digits with 4 dashes (xxxxxxxx-xxxx-xxxxxxxx-xxxxxxxxxxxx).</message> at System.Guid.GuidResult.SetFailure(ParseFailureKind failure, String failu remessage- ID, Object failuremessageformatargument, String failureargumentname, Exception innerexcep tion) at System.Guid.TryParseGuidWithDashes(String guidstring, GuidResult& re sult) at System.Guid.TryParseGuid(String g, GuidStyles flags, GuidResult& res ult) at System.Guid.Parse(String input) at WebserviceWebrolle.UdtraekService.UdtraekMapping.FraXMLTilDatabase(Udval gslistestrukturtype ny) in C:\MainNew\Backend\WebserviceWebrolle\miljoeportal.surfacewater.pointsources.1. 0.0\UdtraekMapping.cs:line 36 at WebserviceWebrolle.UdtraekService.Udtraek.GemUdvalgsliste(GemUdvalgslist erequest request) in C:\MainNew\Backend\WebserviceWebrolle\miljoeportal.surfacewater.poin tsources.1.0.0\udtraek.svc.cs:line 166 <Type>System.FormatException</Type> </InnerException> <Message>Guid should contain 32 digits with 4 dashes (xxxxxxxx-xxxx-xxxx-xxxxxxxxxxxxxxxx).</message> <![CDATA[at Ekstra.Webservicewrapper.Epilog(Boolean throwexception, String& R esultcode, String& ResultReason, String& ResultDetail, String& ResultActor, String metode ) in C:\MainNew\Backend\Ekstra\Webservicewrapper.cs:line 115 at Ekstra.Webservicewrapper.Epilog() in C:\MainNew\Backend\Ekstra\Webservicewrapper.cs :line 57 at WebserviceWebrolle.UdtraekService.Udtraek.GemUdvalgsliste(GemUdvalgslisteRequest re quest) in C:\MainNew\Backend\WebserviceWebrolle\miljoeportal.surfacewater.pointsources.1. 0.0\Udtraek.svc.cs:line 182 at SyncInvokeGemUdvalgsliste(Object, Object[], Object[] ) at System.ServiceModel.Dispatcher.SyncMethodInvoker.Invoke(Object instance, Object[] i nputs, Object[]& outputs) at System.ServiceModel.Dispatcher.DispatchOperationRuntime.InvokeBegin(MessageRpc& rpc ) at System.ServiceModel.Dispatcher.ImmutableDispatchRuntime.ProcessMessage5(MessageRpc& rpc) at System.ServiceModel.Dispatcher.ImmutableDispatchRuntime.ProcessMessage31(MessageRpc & rpc) at System.ServiceModel.Dispatcher.MessageRpc.Process(Boolean isoperationcontextset)]]> <Type>System.Exception</Type> </ExceptionDetail> </s:detail> </s:fault> B 3.1a PULS Serviceoperationer - Udtraek.docx 8
Fejlhåndtering Sikkerhed Anvendt / udbudt Servicekvalitet Responstid Kalde-effekt kategori Noter Use Cases Forretningsobjekter Fejl bliver returneret som SOAP-fault med information om fejlen TBD: Roller Operationen er udviklet for DMP og påtænkes anvendt til indsættelse og opdatering af data. Afsendt besked vil som regel nå modtageren én gang. Under 20 sekunder. Afsendt besked vil som regel nå modtageren én gang. Der henvises til beskrivelse af udarbejdede user stories for PULS-projektet. Udtraek. FindUdvalgsliste 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-12-17 Søren Munk 0.1 Dokument oprettet Styringsdata Navn Version Status Dato for frigivelse Udtraek.svc#FindUdvalgsliste Forretningsmæssig kontekst Formål /beskrivelse Service operations diagram Operationen henter data fra tabeller i den bagvedliggende database på baggrund af søgeparametre. Foresørgsel valid? Ja Dan søgekriterier for punktkilder Udfør søgning Tilrettelæg resultat Data som udveksles (input / output) Inputdata: <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:findudvalgslisterequest> <!--Zero or more repetitions:--> <urn:navn></urn:navn> <!--Zero or more repetitions:--> <urn:udvalgslisteidentifikator></urn:udvalgslisteidentifikator> </urn:findudvalgslisterequest> </soap:body> </soap:envelope> Outputdata (eksempel): <s:envelope xmlns:s="http://www.w3.org/2003/05/soap-envelope"> <s:header> <ActivityId CorrelationId="97269be1-598d-4842-b7a2-b5008d3bc07c" xmlns="http://schemas.microsoft.com/2004/09/servicemodel/diagnostics">e8c898e2-ee86- B 3.1a PULS Serviceoperationer - Udtraek.docx 9
4401-b4cd-9f8cf72a8421</ActivityId> </s:header> <s:body xmlns:xsi="http://www.w3.org/2001/xmlschema-instance" xmlns:xsd="http://www.w3.org/2001/xmlschema"> <FindUdvalgslisteResponse xmlns="urn:oio:miljoeportal:surfacewater:pointsources:1.0.0"> <UdvalgslisteStruktur> <Navn>Tom liste</navn> <BemaerkningTekst>soap UI, gem tom liste</bemaerkningtekst> <UdvalgslisteIdentifikator>7c10ac53-7d3b-41f0-a2cba710321dc6c1</UdvalgslisteIdentifikator> <OpdateretDatoTid>2014-01-09T11:00:46Z</OpdateretDatoTid> </UdvalgslisteStruktur> <UdvalgslisteStruktur> <Navn>Liste med id</navn> <BemaerkningTekst>soap UI, gem liste med id</bemaerkningtekst> <UdvalgslisteIdentifikator>9defd275-688a-46cf-ade2-3789d6d3087d</UdvalgslisteIdentifikator> <OpdateretDatoTid>2014-01-09T13:18:45Z</OpdateretDatoTid> <PunktkildeIdentifikator>763fdc17-7c5c-4f3c-b403- c1adc330705a</punktkildeidentifikator> </UdvalgslisteStruktur> <UdvalgslisteStruktur> <Navn>Tom liste</navn> <BemaerkningTekst>soap UI, gem tom liste</bemaerkningtekst> <UdvalgslisteIdentifikator>3a2e1bc5-d557-4878-97a7- a25d163bb2a8</udvalgslisteidentifikator> <OpdateretDatoTid>2014-01-09T13:18:44Z</OpdateretDatoTid> </UdvalgslisteStruktur> </FindUdvalgslisteResponse> 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/windowscommunicationfoundat ion/dispatcher">a:internalservicefault</s:value> </s:subcode> </s:code> <s:reason> <s:text xml:lang="da-dk">guid should contain 32 digits with 4 dashes (xxxxxxxx-xxxxxxxx-xxxx-xxxxxxxxxxxx).</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"> <InnerException> <InnerException i:nil="true"/> <Message>Guid should contain 32 digits with 4 dashes (xxxxxxxx-xxxx-xxxxxxxx-xxxxxxxxxxxx).</message> at System.Guid.GuidResult.SetFailure(ParseFailureKind failure, String failu remessage- ID, Object failuremessageformatargument, String failureargumentname, Exception innerexcep tion) at System.Guid.TryParseGuidWithNoStyle(String guidstring, GuidResult& r esult) at System.Guid.TryParseGuid(String g, GuidStyles flags, GuidResult& res ult) at System.Guid.Parse(String input) at WebserviceWebrolle.UdtraekService.Udtraek.FindUdvalgsliste(FindUdvalgsli sterequest request) in C:\MainNew\Backend\WebserviceWebrolle\miljoeportal.surfacewater.po intsources.1.0.0\udtraek.svc.cs:line 121 <Type>System.FormatException</Type> </InnerException> <Message>Guid should contain 32 digits with 4 dashes (xxxxxxxx-xxxx-xxxx-xxxxxxxxxxxxxxxx).</message> <![CDATA[at Ekstra.Webservicewrapper.Epilog(Boolean throwexception, String& R esultcode, String& ResultReason, String& ResultDetail, String& ResultActor, String metode ) in C:\MainNew\Backend\Ekstra\Webservicewrapper.cs:line 115 B 3.1a PULS Serviceoperationer - Udtraek.docx 10
at Ekstra.Webservicewrapper.Epilog() in C:\MainNew\Backend\Ekstra\Webservicewrapper.cs :line 57 at WebserviceWebrolle.UdtraekService.Udtraek.FindUdvalgsliste(FindUdvalgslisteRequest request) in C:\MainNew\Backend\WebserviceWebrolle\miljoeportal.surfacewater.pointsources.1. 0.0\Udtraek.svc.cs:line 146 at SyncInvokeFindUdvalgsliste(Object, Object[], Object[] ) at System.ServiceModel.Dispatcher.SyncMethodInvoker.Invoke(Object instance, Object[] i nputs, Object[]& outputs) at System.ServiceModel.Dispatcher.DispatchOperationRuntime.InvokeBegin(MessageRpc& rpc ) at System.ServiceModel.Dispatcher.ImmutableDispatchRuntime.ProcessMessage5(MessageRpc& rpc) at System.ServiceModel.Dispatcher.ImmutableDispatchRuntime.ProcessMessage31(MessageRpc & rpc) at System.ServiceModel.Dispatcher.MessageRpc.Process(Boolean isoperationcontextset)]]> <Type>System.Exception</Type> </ExceptionDetail> </s:detail> </s:fault> Fejlhåndtering Sikkerhed Anvendt / udbudt Servicekvalitet Responstid Kalde-effekt kategori Noter Use Cases Forretningsobjekter Fejl bliver returneret som SOAP-fault med information om fejlen TBD: Roller Operationen er udviklet for DMP og påtænkes anvendt til indsættelse og opdatering af data. Afsendt besked vil som regel nå modtageren én gang. Under 20 sekunder. Operationen er idempotent. Der henvises til beskrivelse af udarbejdede user stories for PULS-projektet. Udtraek. DeaktiverUdvalgsliste 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-12-17 Søren Munk 0.1 Dokument oprettet Styringsdata Navn Version Status Dato for frigivelse Udtraek.svc#DeaktiverUdvalgsliste B 3.1a PULS Serviceoperationer - Udtraek.docx 11
Forretningsmæssig kontekst Formål /beskrivelse Service operations diagram Operationen opdaterer data fra tabeller i den bagvedliggende database på baggrund af parametre. Gentag for hver udvalgsliste Forespørgsel valid? Gentag for hvert punktkildeudvalg Nej Deaktiver tidligere Fejl Deaktiver liste Alle lister behandlet Tilrettelæg resultat Data som udveksles (input / output) Inputdata: <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:deaktiverudvalgslisterequest> <!--Zero or more repetitions:--> <urn:udvalgslisteidentifikator></urn:udvalgslisteidentifikator> </urn:deaktiverudvalgslisterequest> </soap:body> </soap:envelope> Outputdata: <s:envelope xmlns:s="http://www.w3.org/2003/05/soap-envelope"> <s:header> <ActivityId CorrelationId="bf4c88f8-2006-4e9b-b9fa-0d72338ed63b" xmlns="http://schemas.microsoft.com/2004/09/servicemodel/diagnostics">817c2866-7f7a- 4ebf-9958-658b9b602bdb</ActivityId> </s:header> <s:body xmlns:xsi="http://www.w3.org/2001/xmlschema-instance" xmlns:xsd="http://www.w3.org/2001/xmlschema"> <DeaktiverUdvalgslisteResponse xmlns="urn:oio:miljoeportal:surfacewater:pointsources:1.0.0"> <UdvalgslisteStruktur> <Navn>Liste med id</navn> <BemaerkningTekst>soap UI, gem liste med id</bemaerkningtekst> <UdvalgslisteIdentifikator>9defd275-688a-46cf-ade2-3789d6d3087d</UdvalgslisteIdentifikator> <OpdateretDatoTid>2014-01-09T13:27:24Z</OpdateretDatoTid> </UdvalgslisteStruktur> </DeaktiverUdvalgslisteResponse> Bemærk, at det kun er udvalgslistens data, der returneres, ikke evt. punktkildereferencer. B 3.1a PULS Serviceoperationer - Udtraek.docx 12
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/windowscommunicationfoundat ion/dispatcher">a:internalservicefault</s:value> </s:subcode> </s:code> <s:reason> <s:text xml:lang="da-dk">udvalgsliste findes og er deaktiveret.</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"> <InnerException> <InnerException i:nil="true"/> <Message>Udvalgsliste findes og er deaktiveret.</message> at DatabaseMapping.Repository.DeaktiverUdvalgsliste(Guid udvalgslisteidenti fikator) in C:\MainNew\Backend\DatabaseMapping\Repository.cs:line 6222 at UdtraekBackend.Udtraek.DeaktiverUdvalgsliste(UdvalgslisteGruppe[] deakti ver) in C:\MainNew\Backend\UdtraekBackend\Udtraek.cs:line 224 at WebserviceWebrolle.UdtraekService.Udtraek.DeaktiverUdvalgsliste(Deaktive rudvalgsliste- Request request) in C:\MainNew\Backend\WebserviceWebrolle\miljoeportal.surfacewater.point sources.1.0.0\udtraek.svc.cs:line 203 <Type>System.ArgumentException</Type> </InnerException> <Message>Udvalgsliste findes og er deaktiveret.</message> <![CDATA[at Ekstra.Webservicewrapper.Epilog(Boolean throwexception, String& R esultcode, String& ResultReason, String& ResultDetail, String& ResultActor, String metode ) in C:\MainNew\Backend\Ekstra\Webservicewrapper.cs:line 115 at Ekstra.Webservicewrapper.Epilog() in C:\MainNew\Backend\Ekstra\Webservicewrapper.cs :line 57 at WebserviceWebrolle.UdtraekService.Udtraek.DeaktiverUdvalgsliste(DeaktiverUdvalgslis tere- Request request) in C:\MainNew\Backend\WebserviceWebrolle\miljoeportal.surfacewater.pointso urces.1.0.0\udtraek.svc.cs:line 214 at SyncInvokeDeaktiverUdvalgsliste(Object, Object[], Object[] ) at System.ServiceModel.Dispatcher.SyncMethodInvoker.Invoke(Object instance, Object[] i nputs, Object[]& outputs) at System.ServiceModel.Dispatcher.DispatchOperationRuntime.InvokeBegin(MessageRpc& rpc ) at System.ServiceModel.Dispatcher.ImmutableDispatchRuntime.ProcessMessage5(MessageRpc& rpc) at System.ServiceModel.Dispatcher.ImmutableDispatchRuntime.ProcessMessage31(MessageRpc & rpc) at System.ServiceModel.Dispatcher.MessageRpc.Process(Boolean isoperationcontextset)]]> <Type>System.Exception</Type> </ExceptionDetail> </s:detail> </s:fault> Herover har man forsøgt at deaktivere den samme liste to gange; det resulterer i en fejl. Fejlhåndtering Sikkerhed Anvendt / udbudt Servicekvalitet Responstid Kalde-effekt kategori Noter Fejl bliver returneret som SOAP-fault med information om fejlen TBD: Roller Operationen er udviklet for DMP og påtænkes anvendt til opdatering af data. Afsendt besked vil som regel nå modtageren én gang. Under 20 sekunder. Afsendt besked vil som regel nå modtageren én gang. Man kan kun deaktivere en liste med evt. tilhørende punktkildereferencer én gang. B 3.1a PULS Serviceoperationer - Udtraek.docx 13
Use Cases Forretningsobjekter Der henvises til beskrivelse af udarbejdede user stories for PULS-projektet. B 3.1a PULS Serviceoperationer - Udtraek.docx 14