WCFService Balanse. Didde Christensen. Beskrivelse av datauttrekk fra balanseavregningen. C r a y o n A S

Transkript

1 WCFService Balanse Didde Christensen Beskrivelse av datauttrekk fra balanseavregningen C r a y o n A S

2 Contents Funksjonell beskrivelse av integrasjon... 2 Metode... 2 Sikkerhet... 2 WCF-service s web.config... 2 Feilmeldingshåndtering... 2 Beskrivelse av metodene i WCFService... 3 Kall for komponentkoder... 3 Kall for produksjonsplan... 5 Kall for priser... 7 Kall for reguleringer... 9 Kall for balanserapporten... 11

3 Funksjonell beskrivelse av integrasjon Dette dokumentet er utarbeidet av Crayon på oppdrag fra Statnett. Dokumentet ser på hvordan avregningsdata fra balanseavregningen kan tilgjengeliggjøres for våre kunder. For å sikre at Statnett skal være i stand til å kommunisere med alle har Crayon analysert mulige løsninger og utarbeidet dette dokumentet som et forslag for anbefalt løsning. Metode Det vil lages en WCF (Windows Communication Foundation) service som trekker ut de aktuelle data fra balanseavregningen sitt datavarehus. Denne servicen vil kjøre på en https server. De data som WCF Servicen tilgjengeliggjør, henter aktørene ut i sine systemer ved å gjøre kall mot WCF Servicen. I kallene er kobling til WCF Service definert, samt hvilke data som skal hentes ut. Dette dokumentet beskriver webservicen for uttrekk av data fra balanseavregningen med spesifikasjon på hvordan datauthentingen skal gjøres og hvordan dette blir presentert. Sikkerhet Aktøren det kan hentes data for bestemmes ut i fra brukeren som logger på. En bruker kan kun hente data for en aktør. De som administrerer flere aktører må således ha en bruker for hver aktør. Statnett vil opprette de nye brukerne i en database som allerede brukes på BalanseWeb og gjenbruke DLL komponenten som brukes her for å ivareta sikkerheten. Aktørene sender inn brukernavn og passord i SOAP headeren. Webservicen bruker DLL for å autentisere brukere. Statnett sin DLL baserer seg på den sikkerhetsarkitekturen det er lagt til rette for i rammeverket for ASP.NET 2.0. og er bygget på en provider-modell. DLL for autentisering Klient hos kunde WCF (Web Service) Paramatere Brukerdatabase Data for autentiserte brukere LibraMart WCF-service s web.config WCF Service benytter en egen web.config. ConnectionString må settes til riktig url. ConnectionString blir spesifisert senere i forbindelse med produksjonssetting av løsningen. Feilmeldingshåndtering Tre feilsituasjoner kan oppstå for en bruker: 1. Feil ved autentisering av brukere, WCFService returnerer xml som inneholder: <error>ugyldig brukernavn/passord</error> 2. Feil ved prosessering, WCFService returnerer xml som inneholder: <error>feil ved prosessering av datasett</error> 3. Feil ved mangel på data, WCFService returnerer xml som inneholder: <error>finnes ingen data med disse parametere</error>

4 Når bruker velger inputverdier som ikke matcher hverandre blir feilmelding 3 også returnert. Dette basert på at bruker har valgt ugyldige kriterier som inn parametere som ikke gir noe resultat tilbake. Det kreves ikke at ønsket datasett har verdier i hele tidsintervallet aktøren har valgt. Datasettet vil inneholde de verdiene som eksisterer og ikke angi noen feilmelding for data som ikke finnes. Unntaket er for reguleringer. Her vil det etter ønske fra aktørene returneres 0 i de timer hvor det ikke er aktivert regulering. Beskrivelse av metodene i WCFService Kallene er bygget opp slik at noe input er valgfri og noe er obligatorisk. Hver input leses som en begrensende faktor. Valgfri parameter som ikke er utfylt håndteres som Alle. F.eks dersom komponentkodetype ikke fylles ut så returneres alle komponentkodetyper. Tidsangivelsen i XML vil være standard ISO 8601; YYYY-MM-DD Mer info om ISO 8601 på: Input tid er obligatorisk i alle kall og angis som f.o.m - t.o.m dato. Ved overgang til vintertid vil verdiene for søndag time 3 bli repetert. Det vil være mulig å hente ut data f.o.m Dette er oppstartsdato for den balanseavregningsapplikasjonen som benyttes i dag. Avregningsunderlag er ikke endelig før perioden er fakturert. Kall for komponentkoder Datagrunnlaget for komponentkoder vil oppdateres ca 30 min etter passert time og inneholde alle data mottatt frem til oppdateringstidspunktet. Fortegnet på verdiene vil være slik det er rapportert til balanseavregningen av oppgavegiver. Kallet bygger på fire tilgjengelige felter for input. Komponentkodetype (en eller alle) Komponentkode (en eller alle) Dato f.o.m Dato t.o.m Komponentkodetype og komponentkode er valgfri, dato feltene er obligatorisk. Se tabell Komponentkode under for struktur. Tabell Komponentkode Navn Input Output Krav til input Beskrivelse ComponentCode ComponentType Optional Komponentkodetype ComponentCode Optional Komponentkode FromDate Mandatory F.o.m dato ToDate Mandatory T.o.m dato ComponentCode Komponentkode Area Prisområde Date Dato Hour 24 verdier per dato CustomerEnergyQuantity Volum, en verdi per time ID for input komponentkodetype ComponentType B L C H R N P K Beskrivelse Bilateral handel Felleseid kraftverk Forbruk, sluttbruker; C og F-koder Utveksling sentralnett Utveksling regional/distribusjonsnett Nominasjon (NorNed) Produksjon Pumpekraft

5 Eksempelverdier ComponentCode Area Date Hour CustomerEnergyQuantity C1000 NO , , , , , , , , , , , , , , , , , , , , , , , ,003 WSDL Komponentkode <message name="componentcoderequest"> <part name="componenttype" type="xs:string"/> <part name="fromdate" type="xs:date"/> <part name="todate" type="xs:date"/> <part name="componentcode" type="xs:string"/> <message name="componentcoderesponse"> <part name="componentcode" type="xs:string"/> <part name="area" type="xs:string"/> <part name="date" type="xs:date"/> <message name="componentcoderesponsehour"> <part name="hour" type="xs:string"/> <part name="customerenergyquantity" type="xs:string"/> <porttype name="componentcode"> <operation name="getcomponentcode"> <input message="componentcoderequest"/> <output message="componentcoderesponse"/> </operation> </porttype> </definitions>

6 Kall for produksjonsplan Datagrunnlaget for produksjonsplaner vil oppdateres ca 30 min etter passert time og inneholde alle data mottatt frem til oppdateringstidspunktet. Kallet bygger på tre tilgjengelige felter for input. Stasjonsgruppekode (en eller alle) Dato f.o.m, Dato t.o.m Stasjonsgruppekode er valgfri, dato feltene er obligatorisk. Stasjonsgruppekode refererer til den NOKG01234-serien som benyttes ved rapportering av produksjonsplaner til landssentralen Tabell Navn Input Output Krav til input Beskrivelse ProductionPlan StationGroup Optional Stasjonsgruppekode FromDate Mandatory F.o.m dato ToDate Mandatory T.o.m dato StationGroup Stasjonsgruppekode Area Prisområde Date Dato Hour 24 verdier per dato ProductionPlanQuantity Volum, en verdi per time Eksempelverdier StationGroup Area Date Hour ProductionPlanQuantity NOKG01234 NO , , , , , , , , , , , , , , , , , , , , , , , ,000

7 WSDL Produksjonsplan <definitions> <message name="productionplanrequest"> <part name=" StationGroup " type="xs:string"/> <part name="fromdate" type="xs:date"/> <part name="todate" type="xs:date"/> <message name="productionplanresponse"> <part name=" StationGroup " type="xs:string"/> <part name="area" type="xs:string"/> <part name="date" type="xs:date"/> <message name="productionplanresponsehour"> <part name="hour" type="xs:string"/> <part name="productionplanquantity" type="xs:string"/> <porttype name="productionplan"> <operation name="get ProductionPlan "> <input message=" ProductionPlanRequest"/> <output message=" ProductionPlanResponse"/> </operation> </porttype> </definitions>

8 Kall for priser Datagrunnlaget for priser vil oppdateres hver natt med data t.o.m foregående døgn. Se tabell med prisserie-id under for informasjon om hvilke priser som vil tilgengeliggjøres. Servicen er dynamisk og prisserie-id vil gjenspeile den inndelingen som gjelder i valgt tidsintervall. Kallet bygger på tre tilgjengelige felter for input. Prisserie-ID (en eller alle) Dato f.o.m Dato t.o.m Prisserie-ID er valgfri, dato feltene er obligatorisk. Tabell Navn Input Output Krav til input Beskrivelse Price PriceSerial Optional Prisserie-ID FromDate Mandatory F.o.m dato ToDate Mandatory T.o.m dato PriceSerial Prisserie-ID Area Prisområde Date Dato Hour 24 verdier per dato Price En verdi per time Prisserie-ID Priceserialuniquename Elspot - NO1 Elspot - NO2 Elspot - NO3 Elspot - NO4 Elspot - NO5 Regulérkraft Ned - NO1 Regulérkraft Ned - NO2 Regulérkraft Ned - NO3 Regulérkraft Ned - NO4 Regulérkraft Ned - NO5 Regulérkraft Opp - NO1 Regulérkraft Opp - NO2 Regulérkraft Opp - NO3 Regulérkraft Opp - NO4 Regulérkraft Opp - NO5 RK-pris i hovedretning - NO1 RK-pris i hovedretning - NO2 RK-pris i hovedretning - NO3 RK-pris i hovedretning - NO4 RK-pris i hovedretning - NO5 Priceserialname Elspot - NO1 Elspot - NO2 Elspot - NO3 Elspot - NO4 Elspot - NO5 Regulérkraft Ned - NO1 Regulérkraft Ned - NO2 Regulérkraft Ned - NO3 Regulérkraft Ned - NO4 Regulérkraft Ned - NO5 Regulérkraft Opp - NO1 Regulérkraft Opp - NO2 Regulérkraft Opp - NO3 Regulérkraft Opp - NO4 Regulérkraft Opp - NO5 RK-pris i hovedretning - NO1 RK-pris i hovedretning - NO2 RK-pris i hovedretning - NO3 RK-pris i hovedretning - NO4 RK-pris i hovedretning - NO5

9 Eksempelverdier PriceSerial Area Date Hour PriceAmount Elspot NO1 NO , , , , , , , , , , , , , , , , , , , , , , , ,00 WSDL Priser <definitions> <message name="pricerequest"> <part name="priceserial" type="xs:string"/> <part name="fromdate" type="xs:date"/> <part name="todate" type="xs:date"/> <message name="priceresponse"> <part name="priceserial" type="xs:string"/> <part name="area" type="xs:string"/> <part name="date" type="xs:date"/> <message name="priceresponsehour"> <part name="hour" type="xs:string"/> <part name="priceamount" type="xs:decimal"/> <porttype name="price"> <operation name="getpriceplan "> <input message=" PriceRequest"/> <output message=" PriceResponse"/> </operation> </porttype> </definitions>

10 Kall for reguleringer Datagrunnlaget for reguleringer vil oppdateres hver natt med data t.o.m foregående døgn. Kallet bygger på fire tilgjengelige felter for input. Reguleringstype-ID (en eller alle) Stasjonsgruppekode (en eller alle) Dato f.o.m Dato t.o.m Reguleringstype-ID og stasjonsgruppekode er valgfri, datofeltene er obligatorisk. Tabell Navn Input Output Krav til input Beskrivelse Regulation RegulationType Optional Reguleringstype-ID StastionGroup Optional Stasjonsgruppekode FromDate Mandatory F.o.m dato ToDate Mandatory T.o.m dato RegulationType Reguleringstype-ID Balance Produksjon eller forbruk StastionGroup Stasjonsgruppekode Area Prisområde Date Dato Hour En verdi per regulering UpRegQuantity En verdi per regulering DownRegQuantity En verdi per regulering PriceAmount En verdi per regulering UpRegAmount En verdi per regulering DownRegAmount En verdi per regulering Reguleringstype-ID Regulation Type F K O S Description Frekvenskorreksjon Kvartersflytting Ordinær Spesial Eksempelverdier RegulationType Balance StationGroup Area Date Hour URQ DRQ PA URA DRA S Produksjon NOKG01234 NO ,000-20, ,54 0, ,00 1 1,000 0, ,63 463,00 0,00 1 1,000 0, ,10 593,00 0,00 2 0,000 0,000 0,00 0,00 0,00 3 0,000 0,000 0,00 0,00 0,00 4 0,000 0,000 0,00 0,00 0,00 5 0,000 0,000 0,00 0,00 0,00 6 0,000 0,000 0,00 0,00 0,00 7 0,000 0,000 0,00 0,00 0,00 8 0,000 0,000 0,00 0,00 0,00 9 0,000 0,000 0,00 0,00 0, ,000 0, ,10 436,00 0, ,000 0,000 0,00 0,00 0, ,000 0,000 0,00 0,00 0, ,000 0,000 0,00 0,00 0, ,000 0,000 0,00 0,00 0, ,000-20, ,54 0, , ,000 0, ,63 463,00 0, ,000 0,000 0,00 0,00 0, ,000 0,000 0,00 0,00 0, ,000 0,000 0,00 0,00 0, ,000 0,000 0,00 0,00 0, ,000 0,000 0,00 0,00 0, ,000 0,000 0,00 0,00 0, ,000 0,000 0,00 0,00 0, ,000 0,000 0,00 0,00 0,00

11 WSDL Reguleringer <definitions> <message name="regulationrequest"> <part name="regulationtype" type="xs:string"/> <part name="stationgroup" type="xs:string"/> <part name="fromdate" type="xs:date"/> <part name="todate" type="xs:date"/> <message name="regulationresponse"> <part name="regulationtype" type="xs:string"/> <part name="balance" type="xs:string"/> <part name="stationgroup" type="xs:string"/> <part name="area" type="xs:string"/> <part name="date" type="xs:date"/> <message name="regulationresponsehour"> <part name="hour" type="xs:string"/> <part name="upregquantity" type="xs:decimal"/> <part name="downregquantity" type="xs:decimal"/> <part name="priceamount" type="xs:decimal"/> <part name="upregamount" type="xs:decimal"/> <part name="downregamount" type="xs:decimal"/> <porttype name="regulation"> <operation name="getregulations"> <input message="regulationrequest"/> <output message="regulationresponse"/> </operation> </porttype> </definitions>

12 Kall for balanserapporten Datasettet for balanserapporten vil oppdateres hver natt med data mottatt før midnatt. Det vil gi mest verdi å kjøre dette kallet i forbindelse med kontroll etter fakturering, når alle tidsseriene er komplette. Kallet bygger på to tilgjengelige felter for input, begge er obligatoriske Dato f.o.m Dato t.o.m Kallet returnerer alle tidsserier som inngår i balanserapporten i angitt tidsrom. Komponentkoder, S-koder, Elspot, Elbas, oppregulering (forbruk), nedregulering (forbruk), oppregulering (produksjon), nedregulering (produksjon), produksjonsplaner, regulerkraft forbruk og regulerkraft produksjon. For reguleringer og produksjonsplaner vil tidsserien bestå av sum pr prisområde pr time slik de inngår i balanseavregningen. Tabell Navn Input Output Krav til input Beskrivelse Balance FromDate Mandatory F.o.m dato ToDate Mandatory T.o.m dato Type Type TypeValue Verdi Area Prisområde Date Dato Hour 24 verdier per dato Quantity En verdi per time Eksempelverdier Type TypeValue Area Date Hour Quantity KomponentKode C1000 NO , , , , , , , , , , , , , , , , , , , , , , , ,003 S-kode S9999 NO , , , , , , , , , , , , ,800

13 NordPool Elspot NO Nordpool Elbas NO Produksjonsplan Produksjonsplan NO , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , ,000

14 Reguleringer Reguleringer Reguleringer Oppregulert (forbruk) Nedregulert (forbruk) Oppregulert (produksjon) NO NO NO , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , ,000

15 Reguleringer Regulerkraft Nedregulert (produksjon) Regulerkraft forbruk NO NO , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , ,000

16 Regulerkraft Regulerkraft produksjon NO , , , , , , , , , , , , , , , , , , , , , , , ,000 WSDL Balanserapport <definitions> <message name= BalanceRequest"> <part name="fromdate" type="xs:date"/> <part name="todate" type="xs:date"/> <message name=balanceresponse"> <part name="type" type="xs:string"/> <part name="typevalue" type="xs:string"/> <part name="area" type="xs:string"/> <part name="date" type="xs:date"/> <message name=balanceresponsehour"> <part name="hour" type="xs:string"/> <part name="quantity" type="xs:decimal"/> <porttype name="balance"> <operation name="getbalance"> <input message= BalanceRequest"/> <output message="balanceresponse"/> </operation> </porttype> </definitions>