Ændringslog
Overblik
Figur 1 – Use Case Diagram for Anmod om måledata på målepunkt
Anmod om måledata på et målepunkt (Request for Validated Metered Data) anvendes af elleverandør, systemansvarlig eller netvirksomhed til at forespørge om måledata på målepunktsniveau hos DataHub.
Aktivitets diagram
Figur 2 – Aktivitetsdiagram for Fremsend måledata for et målepunkt
Anmodning om måledata
Transaktionsstart
Transaktionen initieres med en Request validated measure data med MarketDocument type = E73. En meddelelse kan indeholde en eller flere transaktioner.
Beskeden kan indeholde en af følgende årsagskoder (ProcessType):
Årsagskode | Dansk navn | Engelsk navn |
---|---|---|
E23 | Periodisk opgørelse | Periodical metering |
E30 | Historisk data | Historical data |
Søge kriterier
Det er op til aktøren at sammensætte en korrekt forespørgsel. Nedenstående tabel opstiller de søgeregler der er gældende:
Årsagskode | Søge Kriterie |
---|---|
E30 | MålepunktsID |
E23 | MålepunkstID og periode for måledata |
Modtagelse i DataHub
I tilfælde af at der sker verifikationsfejl i forhold til skemaet, skal meddelelsen afvises synkront med en HTTP Error.
Derefter valideres meddelelsen i overensstemmelse med reglerne, og hvis der er fejl afvises beskeden se afvisning afsnit.
Hvis der ikke opdages fejl ved kontrol af Request validated measure data Data meddelelsen sendes de ønskede måledata til aktøren, som angivet i Notify validated measure data.
Måledata meddelelsen vil altid indeholde en reference til den oprindelige meddelelse.
Besked indhold
Request for Validated Metered Data indholder en header og en payload beskrevet herunder
Contextual Model
Assembly model
Header information
Navn | Cim Attribut | Str. | Kardi-nalitet | Beskrivelse |
---|---|---|---|---|
Meddelelses ID | MarketDocument / mRID | An..36 | 1 | Unik identifikation af besked. DataHub bruger UUID |
Meddelelsesnavn | MarketDocument / type | An..3 | 1 | type = E73 |
Forretningsårsag | MarketDocument /Process / ProcessType | An..3 | 1 | ProcessType = E23 |
Marked | MarketDocument / BusinessSector / type | An..2 | 1 | type = 23 - Electricity Supply Industry |
Afsender | MarketDocument / Sender_MarketParticipant / MarketRole / type | An..16 | 1 | Entydig identifikation af afsender. Aktøren er identificeret af et GLN-nummer eller en EIC-kode. Mulige afsender: |
Modtager | MarketDocument / Receiver_MarketParticipant / MarketRole / type | An..16 | 1 | Entydig identifikation af afsender. Aktøren er identificeret af et GLN-nummer eller en EIC-kode. Mulige modtagere: |
Meddelelsesdato | MarketDocument / createdDateTime | Date | 1 | ISO-8601 standard anvendes. Dato og tid i UTC+0. Angiver oprettelsesdato for anmodning. |
Payload - Attribut beskrivelse
Navn | Cim Attribut | længde | Kardinalitet | Beskrivelse |
---|---|---|---|---|
Transaktions ID | Series / mRID | An..36 | 1 | Afsenders unikke identifikation af transaktionen. Her bruges UUID |
Startdato | Series / Period / timeInterval : start | Datetime | 1 | Timeinterval er af typen ESMP_ DateTime-Interval, som har to attributter: Start og End |
Slutdato | Series / Period / timeInterval : end | Datetime | 0..1 | |
MålepunktsID | Series / MarketEvaluationPoint / mRID | An..18 | 1 | Entydig identifikation af et målepunkt. GSRN = 18 cifre. CodingScheme = A10 |
Afvisning af anmodning
I tilfælde af, at der konstateres en fejl i forhold til forretningsreglerne, skal meddelelsen afvises. Dette sker med en Reject request validated measure data meddelelse med MarketDocument type = ERR. Status kode sættes til A02 (Rejected) samt at årsagskode sat til den relevante kode fra forretningsreglerne. Desuden udfyldes Reasontext hvis nødvendigt.
Besked indhold
Contexual model
Assembly model
Header Information
Navn | Cim Attribut | Str. | Kardi-nalitet | Beskrivelse |
---|---|---|---|---|
Meddelelses ID | MarketDocument / mRID | An..36 | 1 | Unik identifikation af besked. DataHub bruger UUID |
Meddelelsesnavn | MarketDocument / type | An..3 | 1 | Unikt for hvert dokumenttype, her bruges |
Forretningsårsag | MarketDocument /Process / ProcessType | An..3 | 1 | ProcessType = E23 |
Marked | MarketDocument / BusinessSector / type | An..2 | 1 | type = 23 - Electricity Supply Industry |
Afsender ID | MarketDocument / Sender_MarketParticipant / mRID | An..16 | 1 | Entydig identifikation af afsender. Aktøren er identificeret af et GLN-nummer eller en EIC-kode. |
Afsender rolle | MarketDocument / Sender_MarketParticipant / MarketRole / type | An..3 | 1 | Mulige afsender: |
Modtager ID | MarketDocument / Receiver_MarketParticipant / mRID | An..16 | 1 | Entydig identifikation af afsender. Aktøren er identificeret af et GLN-nummer eller en EIC-kode. |
Modtager rolle | MarketDocument / Receiver_MarketParticipant / MarketRole / type | An..3 | 1 | Mulige modtager: |
Status Type | MarketDocument / Reason /code | An..3 | 0..1 | A02 Message fully rejected |
Payload - Attribut beskrivelse
Navn | Cim Attribut | længde | Kardinalitet | Beskrivelse |
---|---|---|---|---|
Transaktions ID | Series / mRID | An..36 | 1 | Afsenders unikke identifikation af transaktionen. Her bruges UUID |
Reference til original Transaktions ID | Series / OriginalTransactionReference_Series / mRID | An..36 | 0..1 | Entydig reference til oprindelig meddelelse. |
MålepunktsID | Series / MarketEvaluationPoint / mRID | An..18 | 1 | Entydig identifikation af et målepunkt. GSRN = 18 cifre. CodingScheme = A10 |
Afvisningsårsag | MktActivityRecord / Reason / code | An..3 | 1..* | Anvendes hvis status er lig afvist til at beskrive årsag for afvisning. Kode sættes i henhold til forretningsreglerne. |
Fejltekst | MktActivityRecord / Reason / text | STRING | 0..1 | Uddybende forklaring af afvisning. Udfyldes kun hvis der er relevante data. |