Meddelandespecifikation Avbrottsrapportering

Transkript

1 Meddelandespecifikation Avbrottsrapportering [XML-meddelande till Avbrottsinrapportering]] Energimarknadsinspektionen Revision Bilagor XML-Schema för avbrottsrapportering (Filnamn: InterruptionXML1.0.xsd)

2 2 (18) Ändringshistorik Revision Datum Utfärdad av Ändringar/tillägg Roland Forsberg Första utgåva Thomas Westergaard I huvudsak ändrade referenser till föreskrifter Roland Forsberg Ändrat beskrivning av nenergy på sid. 12. Tagit bort felaktiga referenser till föreskrifter.

3 3 (18) Innehåll 1. Inledning Refererande dokument Meddelandebeskrivning Extrakt från XML-Schema Meddelandestruktur Tillämpning av segment och ID-begrepp Meddelandetillämpning Kommentarer kring XML-notationen Segmentbeskrivningar InfoMsg Extrakt från XML-Schema HEADER Redovisningsenhet och period Extrakt från XML-Schema GENERALS - Allmänna uppgifter Extrakt från XML-Schema SUBSCRIBERS Alla uttagspunkter Extrakt från XML-Schema LSP Den enskilda uttagspunkten (lågspänning) Extrakt från XML-Schema HSP Den enskilda uttagspunkten (högspänning) Extrakt från XML-Schema CONCESSIONS Alla koncessioner CONCESSION Den enskilda koncessionen Extrakt från XML-Schema TRANSFORMERS Alla transformatorer TRANSFORMER Den enskilda transformatorn Extrakt från XML-Schema... 18

4 4 (18) 1. Inledning Detta dokument utgör specifikation för det XML-meddelande som ska användas för inrapportering av uppgifter till Energimarknadsinspektionen avseende elnätsföretagens leveranskvalitet. Dokumentet är främst tillägnat systemutvecklare, programmerare, systemadministratörer och andra som kan vara involverade i att ta fram en systemlösning som skapar eller ska tolka meddelandet InterruptionXML. Detta dokument ger inte vägledning om vilken information som ska skickas in till myndigheten eller vilka krav myndigheten ställer avseende informationens innehåll. Detta dokument beskriver endast den struktur och det format informationen ska hålla för att myndigheten ska kunna tolka informationen på ett korrekt sätt. För vägledning om informationens innehåll hänvisas till gällande föreskrifter. 1.1 Refererande dokument Ref Dokumentnamn Rev Utgivare Ellagen 1997:857 Elförordningen 1994:1250 EIFS 2010:5 Statens energimyndighets föreskrifter och allmänna råd om skyldighet att rapportera elavbrott för bedömning av leveranskvaliteten i elnäten Extensive Markup Language (XML) (Second edition) Energimarknadsinspektionen W3C XML Schema Part 0: Primer W3C

5 5 (18) 2. Meddelandebeskrivning Meddelandet är ett XML-meddelande av XML version 1.0. För att validera rapporten och för att kunna beskriva den exakt används ett så kallat XML-schema. Till beskrivningen finns även denna meddelandespecifikation i vilken det redovisas extrakt från XMLschemat i anknytning till respektive segment av filen. Nedan följer ett exempel på det. Extraktet ur XML-schemat visar dess deklaration Extrakt från XML-Schema <?xml version="1.0" encoding="utf-8"?> <!-- InterruptionXML-meddelande, Energimarknadsinspektionen > <xs:schema xmlns:xs=" elementformdefault="qualified" attributeformdefault="unqualified"> <xs:element name="interruptionxml"> <xs:group name="lsp"> <xs:group name="hsp"> <xs:simpletype name="interruptcount"> <xs:simpletype name="interruptduration"> </xs:schema> 2.2 Meddelandestruktur Själva meddelandet InterruptionXML, består av ett huvudsegment (HEADER) som har fyra subsegment (GENERALS, SUBSCRIBERS, CONCESSIONS och TRANSFORMERS) som vardera förekommer en gång. SUBSCRIBERS innehåller data för samtliga uttagspunkter i element (LSP alternativt HSP) för varje uttagspunkt finns data oberoende av spänningsnivå. På motsvarande sätt är CONCESSIONS uppbyggd för koncessioner och TRANSFORMERS uppbyggd för transformatorer. Utöver dessa segment inleds meddelandet med ett segment (InfoMsg) som innehåller systeminformation om själva meddelandet. Segmentens inbördes hierarki och sekvens är av betydelse vilket framgår av XML-schemat. <InterruptionXML> InfoMsg ID: - HEADER ID: nredid </InterruptionXML> 1 1 GENERALS ID: - SUBSCRIBERS ID: - CONCESSIONS ID: - TRANSFORMERS ID: LSP ID: ninstid HSP ID: ninstid CONCESSION ID: nconcid TRANSFORMER ID: ntransid

6 6 (18) 2.3 Tillämpning av segment och ID-begrepp Nedan följder en uppräkning av de segment som ingår i meddelandet InterruptionXML. Indenteringen visar meddelandets hierarkiska struktur. Meddelandet utnyttjar XMLelementens ID-attribut för att sätta elementens unika ID. Namnen på olika ID varierar från segment till segment. För vissa segment saknas ID-begrepp då de endast förekommer en gång per fil (alternativt per överordnat segment) och inte behöver särskiljas. Segment Beskrivning ID-begrepp Förekomst i fil alt. överordnat segment InfoMsg XML- och meddelandespecifik information - 1 HEADER -GENERALS -SUBSCRIBERS Parent, endast uppgifter om vilken redovisningsenhet, årtal och period de inlämnade uppgifterna avser. Allmänna, ekonomiska och tekniska uppgifter, samt avbrottsstatistik. Samlingssegment för samtliga uttagspunkter (LSP och HSP) med avbrottsdata nredid LSP Ett element per uttagspunkt, lågspänning ninstid HSP Ett element per uttagspunkt, högspänning ninstid 1 - -CONCESSIONS Samlingssegment för samtliga koncessioner 1 --CONCESSION Ett element per koncession nconcid 1 - -TRANSFORMERS Samlingssegment för samtliga transformatorstation 1 --TRANSFORMER Ett element per transformatorstation ntransid Meddelandetillämpning Meddelandet ska tillämpas av de innehavare av nätkoncession för område och linje som i gällande föreskrifter ålagts en skyldighet att årligen rapportera in uppgifter som ska användas avseende bedömning av elnätsföretagens leveranskvalitet och nättariffer. 2.5 Kommentarer kring XML-notationen Ett XML-schema är känsligt för skillnaden mellan versaler och gemener (sk Casesensitive). Det innebär att elementens namn, som anges i XML-schemat, måste vara identiska avseende stora och små bokstäver. XML-schemat accepterar de svenska tecknen (åå ää öö), varför det är tillåtet att använda dem i fältens (elementens) värden. Meddelandet har ett element i det första segmentet (InfoMsg) som heter EncTest, som alltid ska innehålla en fördefinierad sträng tecken (éé åå ää öö) och därmed användas för att verifiera att överföringen inte ändrat de svenska tecknen. Notera att för element som är Optional och inte behöver skickas med i filen gäller att om elementet inte skickats med i filen tolkas dess värde som okänt. Om avsändaren av meddelandet vill ange ett elements värde till 0 ska det värdet anges även om elementet är Optional enligt denna meddelandespecifikation. Notera att detta är högst väsentligt då vissa element i denna meddelandespecifikation och dess motsvarande

7 7 (18) valideringsschema har viss elements förekomster angivna som Optional trots att föreskriften i vissa fall kräver att uppgiften redovisas. Filen som XML-meddelandet skickas i ska använda Unicode UTF-8. För mer information om Unicode och UTF-8 hänvisas till Unicode s hemsida (

8 8 (18) 3. Segmentbeskrivningar I detta avsnitt beskrivs meddelandets specifikationer mer ingående. För varje segment ges en allmän beskrivning som följs av en förteckning över segmentets ingående element. Beskrivningen av respektive segment avslutas med ett extrakt av XML-schemat som rör det aktuella segmentet. För att hitta information rörande definitioner av de värden som elementen ska innehålla hänvisas till Föreskrifterna (ref dokument 3). 3.1 InfoMsg InfoMsg inleder meddelandet. I detta inledande segment anges viss XML- och meddelandespecifik information. Element Beskrivning Datatyp Validering Användning Revision Detta element ska ange den revision av meddelandespecifikationen som är använd för skapandet av meddelandet. Default är den nya revisionen 0.x. String [x.x] Required CDate Datum då filen är skapad. Date ÅÅÅÅ-MM-DD Required EncTest Till för att validera att de svenska tecknen kommit fram som de ska. Strängen ska alltid vara éé åå ää öö. String [éé åå ää öö] Required Extrakt från XML-Schema <xs:element name="infomsg"> <xs:complextype> <xs:element name="revision" default="1.0"> <xs:pattern value="\d{1}.\d{1}"/> <xs:element name="cdate" type="xs:date"/> <xs:element name="enctest" fixed="éé åå ää öö"> <xs:restriction base="xs:string"/> </xs:complextype>

9 9 (18) 3.2 HEADER Redovisningsenhet och period Detta segment är ett överliggande segment för det data som ska skickas och förekommer exakt en gång i meddelandet. De enda element segmentet innehåller är de som gör den redovisande enheten unik, d.v.s. redovisningsenhetens ID, det år redovisningen avser, samt den period redovisningen avser i det fall redovisningen inte avser hela kalenderåret. Element Beskrivning Definition Datatyp Validering Användning nredid Attribut: Myndighetens ID på den redovisade enheten EIFS 2010:5 kap 4:2 String [10] Required nyear Kalenderår EIFS 2010:5 kap 4:2 Integer ÅÅÅÅ Required nperiod Period (från datum till datum) EIFS 2010:5 kap 4:2 String MMDD-MMDD Optional Extrakt från XML-Schema <xs:element name="header"> <xs:complextype> <xs:element name="nyear" block="restriction"> <xs:restriction base="xs:integer"> <xs:mininclusive value="2000"/> <xs:maxinclusive value="2099"/> <xs:element name="nperiod" default=" "minoccurs="0"> <xs:pattern value="\d{4}-\d{4}"/> <xs:attribute name="nredid" use="required"> <xs:maxlength value="10"/> </xs:attribute> </xs:complextype>

10 10 (18) 3.3 GENERALS - Allmänna uppgifter Detta segment förekommer exakt en gång i meddelandet. Segmentet innehåller allmänna adress- och kontaktuppgifter. Element Beskrivning Definition Datatyp Validering Användning ncompanyid Företagets organisationsnummer EIFS 2010:5 kap 4:2 String ######-#### Required ncompanyname Företagets namn String [40] Optional naddress Postadress EIFS 2010:5 kap 4.2 String [40] Required npostcode Postnummer EIFS 2010:5 kap 4:2 String ### ## Required ncity Ort String [40] Required nceo VD String [40] Optional ncontact Kontaktperson String [40] Optional n E-post till kontaktperson String [60] Optional n company E-post till företag String [60] Optional ntele Telefonnummer till kontaktperson String [20] Optional ntelecompany Telefonnummer till växel String [20] Optional nother Övriga upplysningar String [64k] Optional Extrakt från XML-Schema <xs:element name="generals"> <xs:complextype> <xs:element name="ncompanyid"> <xs:length value="11"/> <xs:pattern value="\d{6}-\d{4}"/> <xs:element name="ncompanyname"> <xs:maxlength value="40"/> <xs:element name="naddress"> <xs:maxlength value="40"/> <xs:element name="npostcode"> <xs:length value="6"/> <xs:pattern value="\d{3}\s\d{2}"/> <xs:element name="ncity"> <xs:maxlength value="40"/> <xs:element name="nceo" minoccurs="0"> <xs:maxlength value="40"/>

11 11 (18) <xs:element name="ncontact" minoccurs="0"> <xs:maxlength value="40"/> <xs:element name="n " minoccurs="0"> <xs:maxlength value="60"/> <xs:element name="n company" minoccurs="0"> <xs:maxlength value="60"/> <xs:element name="ntele" minoccurs="0"> <xs:maxlength value="20"/> <xs:element name="ntelecompany" minoccurs="0"> <xs:maxlength value="20"/> <xs:element name="nother" minoccurs="0"> <xs:maxlength value="65000"/> </xs:complextype>

12 12 (18) 3.4 SUBSCRIBERS Alla uttagspunkter Detta segment innehåller alla uttagspunkter. Notera att alla typer av uttagspunkter anges i detta segment. Varje enskild uttagspunkt motsvaras av ett subelement i SUBSCRIBERS. Detta subelement har olika utseende beroende på om uttagspunkten är av typen lågspänning (LSP) eller av typen högspänning (HSP). Element Beskrivning Definition enl. föreskrift (ref) ninstid Attribut: Unik anläggningsidentitet för uttagspunkten Om uttagspunkten är av typen lågspänning (se kap. 3.5) Datatyp Validering enl. spec. Användning enl. spec. EIFS 2010:5 kap 4:5 String [30] Required nsubscrtypel Uttagspunktens typ String [0] Required ncapacity Abonnerad effekt (kw) EIFS 2010:5 kap 4:7 PositivInteger Optional nfuse Säkringsstorlek för säkringsabonnemang (A) Om uttagspunkten är av typen högspänning (se kap. 3.6) EIFS 2010:5 kap 4:8 PositivInteger Optional nsubscrtypeh Uttagspunktens typ String [0] Required ncapacity Abonnerad effekt (kw) EIFS 2010:5 kap 4:7 PositivInteger Required nvoltage Spänning (kv) Ska införas i EIFS 2010:5 vid nästa revidering nenergy Överförd energi (kwh). Negativ energi ska inte rapporteras avseende uttagspunkter. Om negativ (inmatad) energi har uppmätts i en uttagspunkt ska värdet 0 (noll) kwh anges. För gränspunkter ska värdet 0 (noll) anges om det uppmätts negativ energi eller om värde saknas. Decimal Required EIFS 2010:5 kap 4:6 integer Required ncustomercode SNI-kod EIFS 2010:5 kap 4:10 nonnegativeinteger Required ntransid nnointnsub ndurationnsub nnointusub ndurationusub nnointnrsub ndurationnrsub ID transformatorstation till vilken uttagspunkt är ansluten (egen litterering) Antal aviserade långa avbrott i uttagspunkt orsakade av eget nät (antal). Total avbrottstid i uttagspunkt för aviserade långa avbrott orsakade av eget nät. (minuter) Antal oaviserade långa avbrott <12 timmar i uttagspunkt orsakade av eget nät. (antal). Total avbrottstid i uttagspunkt för oaviserade långa avbrott <12 timmar orsakade av eget nät. (minuter) Antal aviserade långa avbrott i uttagspunkt orsakade av överliggande nät eller inmatningspunkt (antal) Total avbrottstid i uttagspunkt för aviserade långa avbrott orsakade av överliggande nät eller inmatningspunkt (minuter) EIFS 2010:5 kap 4:9 String[30] Required EIFS 2010:5 kap 4:18 InterruptCount Required EIFS 2010:5 kap 4:18 InterruptDuration Required EIFS 2010:5 kap 4:19 InterruptCount Required EIFS 2010:5 kap 4:19 InterruptDuration Required EIFS 2010:5 kap 4:18 InterruptCount Required EIFS 2010:5 kap 4:18 InterruptDuration Required

13 13 (18) Element Beskrivning Definition enl. föreskrift (ref) nnointursub ndurationursub nnointucsub ndurationucsub nnointurcsub ndurationurcsub nnosintusub nnosintursub ncomment Antal oaviserade långa avbrott <12 timmar i uttagspunkt orsakade av överliggande nät eller inmatningspunkt. (antal) Total avbrottstid i uttagspunkt för oaviserade långa avbrott <12 timmar orsakade av överliggande nät eller inmatningspunkt. (minuter) Antal oaviserade långa avbrott 12 timmar i uttagspunkt orsakade av eget nät. (antal). Total avbrottstid i uttagspunkt för oaviserade långa avbrott 12 timmar orsakade av eget nät. (minuter). Antal oaviserade långa avbrott 12 timmar i uttagspunkt orsakade av överliggande nät eller inmatningspunkt. (antal). Total avbrottstid i uttagspunkt för oaviserade långa avbrott 12 timmar orsakade av överliggande nät eller inmatningspunkt. (minuter). Antal korta avbrott i uttagspunkt orsakade genom snabba eller fördröjda automatiska återinkopplingar i eget nät (antal) Antal korta avbrott i uttagspunkt orsakade genom snabba eller fördröjda automatiska återinkopplingar i överliggande nät eller inmatningspunkt. (antal) Särskild kommentar gällande det specifika abonnemanget. Datatyp Validering enl. spec. Användning enl. spec. EIFS 2010:5 kap 4:19 InterruptCount Required EIFS 2010:5 kap 4:19 InterruptDuration Required EIFS 2010:5 kap 4:19 InterruptCount Required EIFS 2010:5 kap 4:19 InterruptDuration Required EIFS 2010:5 kap 4:19 InterruptCount Required EIFS 2010:5 kap 4:19 InterruptDuration Required EIFS 2010:5 kap 4:20 InterruptCount Required EIFS 2010:5 kap 4:20 InterruptCount Required String[255] Optional Extrakt från XML-Schema Observera att avbrottsinformationen ligger med i utdraget. <xs:element name="subscriber" maxoccurs="unbounded"> <xs:complextype> <xs:choice> <xs:group ref="lsp"/> <xs:group ref="hsp"/> </xs:choice> <xs:element name="nenergy" type="xs:integer"/> <xs:element name="ncustomercode" type="xs:nonnegativeinteger"/> <xs:element name="ntransid"> <xs:maxlength value="30"/> <xs:element name="nnointnsub" type="interruptcount"/> <xs:element name="ndurationnsub" type="interruptduration"/> <xs:element name="nnointusub" type="interruptcount"/> <xs:element name="ndurationusub" type="interruptduration"/> <xs:element name="nnointnrsub" type="interruptcount"/>

14 14 (18) <xs:element name="ndurationnrsub" type="interruptduration"/> <xs:element name="nnointursub" type="interruptcount"/> <xs:element name="ndurationursub" type="interruptduration"/> <xs:element name="nnointucsub" type="interruptcount"/> <xs:element name="ndurationucsub" type="interruptduration"/> <xs:element name="nnointurcsub" type="interruptcount"/> <xs:element name="ndurationurcsub" type="interruptduration"/> <xs:element name="nnosintusub" type="interruptcount"/> <xs:element name="nnosintursub" type="interruptcount"/> <xs:element name="ncomment" minoccurs="0"> <xs:maxlength value="255"/> <xs:attribute name="ninstid" use="required"> <xs:maxlength value="30"/> </xs:attribute> </xs:complextype> <xs:simpletype name="interruptcount"> <xs:restriction base="xs:nonnegativeinteger"/> <xs:simpletype name="interruptduration"> <xs:restriction base="xs:nonnegativeinteger"> <xs:maxinclusive value="527040"/>

15 15 (18) 3.5 LSP Den enskilda uttagspunkten (lågspänning) Det finns två typer av uttagspunkter, uttagspunkter för lågspänning och uttagspunkter för högspänning. För uttagspunkter av typen lågspänning används elementet LSP. Notera att enligt en kommande revidering av föreskriften STEMFS 2007:7 kan det vara obligatoriskt att ange ett värde i antingen det ena eller det andra av fälten nfuse och ncapacity som är angivna som Optional enligt denna specifikation. Element Beskrivning Definition enl. föreskrift (ref) Datatyp Validering enl. spec. Användning enl. spec. nsubscrtypel Uttagspunktens typ String [0] Required ncapacity Abonnerad effekt (kw) EIFS 2010:5 kap 4:7 PositivInteger Optional nfuse Säkringsstorlek för säkringsabonnemang (A) EIFS 2010:5 kap 4:8 PositivInteger Optional Extrakt från XML-Schema <xs:group name="lsp"> <xs:element name="nsubscrtypel"> <xs:maxlength value="0"/> <xs:element name="ncapacity" type="xs:positiveinteger" minoccurs="0"/> <xs:element name="nfuse" type="xs:positiveinteger" minoccurs="0"/> </xs:group>

16 16 (18) 3.6 HSP Den enskilda uttagspunkten (högspänning) Det finns två typer av uttagspunkter, uttagspunkter för lågspänning och uttagspunkter för högspänning. För uttagspunkter av typen högspänning används elementet HSP. Element Beskrivning Definition enl. föreskrift (ref) Datatyp Validering enl. spec. Användning enl. spec. nsubscrtypeh Uttagspunktens typ String [0] Required ncapacity Abonnerad effekt (kw) EIFS 2010:5 kap 4:7 PositivInteger Required nvoltage Spänning (kv) Kommande revidering av EIFS 2010:5 Decimal Required Extrakt från XML-Schema <xs:group name="hsp"> <xs:element name="nsubscrtypeh"> <xs:maxlength value="0"/> <xs:element name="ncapacity" type="xs:positiveinteger"/> <xs:element name="nvoltage" type="xs:decimal"/> </xs:group>

17 17 (18) 3.7 CONCESSIONS Alla koncessioner Segmentet innehåller samtliga områdes- och linjekoncessioner som ingår i redovisningsenheten. Varje enskild koncession motsvaras av ett subelement (CONCESSION). 3.8 CONCESSION Den enskilda koncessionen Elementet innehåller uppgifter om områdes- eller linjekoncessionen. Element Beskrivning Definition Datatyp Validering Användning nconcid Attribut: Koncessionsnummer EIFS 2010:5 kap 4:2 String [10] Required nconctype Koncessionstyp (Område=O, Linje=L) EIFS 2010:5 kap 4:2 String [O/L] Required Extrakt från XML-Schema <xs:element name="concessions"> <xs:complextype> <xs:element name="concession" maxoccurs="unbounded"> <xs:complextype> <xs:element name="nconctype"> <xs:length value="1"/> <xs:pattern value="[lo]"/> <xs:attribute name="nconcid" use="required"> <xs:maxlength value="10"/> </xs:attribute> </xs:complextype> </xs:complextype> 3.9 TRANSFORMERS Alla transformatorer Segmentet innehåller samtliga transformatorstationer. Varje enskild transformatorstation motsvaras av ett subelement (TRANSFORMER) TRANSFORMER Den enskilda transformatorn Elementet innehåller uppgifter om den enskilda transformatorn. Element Beskrivning Definition Datatyp Validering Användning ntransid Attribut: ID transformator-station till vilken uttagspunkt är ansluten (egen litterering) EIFS 2010:5 kap 4:9 String [30] Required nconcid Koncessionsnummer EIFS 2010:5 kap 4:2 String [10] Required

18 18 (18) Extrakt från XML-Schema <xs:element name="transformers"> <xs:complextype> <xs:element name="transformer" maxoccurs="unbounded"> <xs:complextype> <xs:element name="nconcid"> <xs:length value="10"/> <xs:attribute name="ntransid" use="required"> <xs:maxlength value="30"/> </xs:attribute> </xs:complextype> </xs:complextype>