Dokument ID - Document ID Utgåva - Issue Status - Status Sida - Page fi2mediasypplymessage_0_6 0 Arb.material 1 (11)

Transkript

1 fi2mediasypplymessage_0_6 0 Arb.material 1 (11) MediaSupplyMessage Meddelandet används för att utbyta mätdata, förbrukningsvärden och prognosvärden för flöden, primärt för flöden av energimedia från leverantör till kund. Meddelandets struktur Meddelandet definieras i filen fi2mediasupplymessage.xsd. Meddelandehuvudets struktur hämtas från schemat fi2basestructures.xsd, och några av elementen i schemat hämtas från schemat fi2base.xsd. Metadata om meddelandet sparas i meddelandehuvudet, noden fi2messageheader. Meddelandehuvudet följer strukturen fi2messageheadertype som definieras i schemat fi2basestructures.xsd. Meddelandets innehåll sparas i noden fi2messagedata. Meddelandehuvud Strukturen definieras i filen fi2basestructures.xsd och finns närmare beskriven i dokumentationen för meddelandet fi2propertymessage. De viktigaste elementen beskrivs nedan.

2 fi2mediasypplymessage_0_6 0 Arb.material 2 (11) Avsändare Referens Systemidentitet Version Meddelandeversion Meddelande-id fi2sender Information om avsändaren. fi2sender > fi2reference Ett eller flera referensvärden. Referensvärden refererar till värdelista VA000_004_001. fi2sender > fi2systemidentity Obligatoriskt element som identifierar leverantör av det system som genererat meddelandet. fi2version Versionsnummer för den version av Fi2xml som meddelandet är baserat på. fi2messageversion Aktuellt versionsnummer för meddelandet. fi2messageid Obligatorisk identitet (guid) för detta meddelande.

3 fi2mediasypplymessage_0_6 0 Arb.material 3 (11) Sessions-id Syfte fi2sessionidentity Obligatorisk identitet (guid) för den meddelandesession som meddelandet ingår i. Denna identitet skall skapas av det meddelande som inleder en session. fi2messagetask Beskriver meddelandets syfte; Anges som verb (fi2verb) och substantiv (fi2noun) enlig definierade klasslistor. Meddelande Meddelandets rotelement är leveranspunkt (fi2supplynode) som motsvarar en fysisk leveranspunkt i en byggnad eller fastighet. Minst en leveranspunkt ska anges.

4 fi2mediasypplymessage_0_6 0 Arb.material 4 (11) Leveranspunkt Anläggnings-id fi2supplynode En fysisk leveranspunkt i ett specificerat system. Systemet kan namnges med attributet supplyingsystem. fi2nodeidentity Anläggnings-id eller annan unik identitet för leveranspunkten. Flera identiteter kan anges. För varje identitet bör attributen usage, owner och origin användas för att specificera det system som definierar identiteten.

5 fi2mediasypplymessage_0_6 0 Arb.material 5 (11) Köpekontrakt Leveranspunktadress Betjänad area Betjänat system fi2node_class av leveranspunkten. Minst en klasstillhörighet ska anges. Här specificeras vilken typ av media leveranspunkten hanterar enligt klasslistan CA000_012_001 (sid 11). fi2purchcontract Det kontrakt som reglerar handel mellan aktuell leverantör och kund för det system leveranspunkten tillhör. Kontraktet anges med strukturen fi2purchcontract som definieras i schemat fi2base.xsd. fi2nodeaddress Den fysiska gatuadress där leveranspunkten nås. Anges med strukturen fi2address_type som definieras i schemat fi2base.xsd. fi2supportedzone Den area som leveranspunkten betjänar uttryckt med ett eller flera objekt hämtade från fastighetsmodellen; fastigheter, infrastrukturella enheter, byggnader, utrymmessystem eller utrymmen. fi2supportedsystem Delarna i det fysiska system som leveranspunkten tillhör. Uttrycks som ett eller flera objekt hämtade från fastighetsmodellen; byggdelar, byggdelskomponenter eller utrustning. Data för leveranspunkten kan anges som mätvärden, förbrukningsvärden och/eller prognosvärden. Mätvärde fi2measurement fi2measurement_class av mätvärdet.

6 fi2mediasypplymessage_0_6 0 Arb.material 6 (11) Värde Mätaridentitet Tidpunkt Kvantitet fi2measurement_value Övriga beskrivande värden för mätvärdet. Själva mätvärdet anges i noden fi2measurement_quantity. fi2measurement_meter_identity Mätpunktens identitet enligt givet system. Systemet kan specificeras med attributen owner, usage och origin. Minst en identitet ska anges, flera identiteter kan anges. fi2measurement_timestamp Tidpunkten för mätningen. Datumtypen kan innehålla information om datumzon. Obligatorisk uppgift. fi2measurement_quantity Mätvärde angivet enligt strukturen fi2quantity_type (sid 9). Flera mätvärden kan anges för specificerad tidpunkt. Förbrukningsvärde fi2mediaconsumption Värde fi2mediaconsumption_class Eventuell klassificering av förbrukningsvärdet. fi2mediaconsumption_value Övriga beskrivande värden för förbrukningsvärdet. Själva förbrukningsvärdet anges i noden fi2mediaconsumption_quantity/series.

7 fi2mediasypplymessage_0_6 0 Arb.material 7 (11) Period fi2mediaconsumption_period Den tidsperiod som förbrukningsvärdet gäller. Perioden anges med strukturen fi2period_type (sid 8). Förbrukningsvärdet anges antingen som ett totalvärde för perioden eller som en serie förbrukningsvärden. Periodkvantitet Värdeserie fi2mediaconsumption_quantity Förbrukningen av mediet för den angivna perioden. Anges med strukturen fi2quantity_type (sid 9). fi2mediaconsumption_series Förbrukningen av angivet medium för angiven period, uppdelat i delintervall. Anges med strukturen fi2series_type (sid 10). Prognosvärde fi2consumptionprognosis Värde Period fi2consumptionprognosis_class ar av prognosvärdet. fi2consumptionprognosis_value Övriga beskrivande värden för prognosvärdet. Själva prognosvärdet anges i noden fi2consumptionprognosis_quantity/series. fi2consumptionprognosis_period Den tidsperiod som prognosen gäller. Perioden anges med strukturen fi2period_type. Prognosen anges antingen som ett totalvärde för perioden eller som en serie prognosvärden. Prognosmängd fi2consumptionprognosis_quantity Prognosens mängdvärde. Anges med strukturen fi2quantity_type.

8 fi2mediasypplymessage_0_6 0 Arb.material 8 (11) Värdeserie fi2consumptionprognosis_series Förbrukningsprognosen för det angivna mediet för angiven period, uppdelat i delintervall. Anges med strukturen fi2series_type. Datastrukturer Några datastrukturer som används i schemat finns inte sedan tidigare i schemat fi2base.xsd. Dessa definieras i fi2mediasupplymessage.xsd och beskrivs nedan. Fi2interval_type Anger ett mängdvärde för en specificerad period. Mängdvärdet lagras med strukturen fi2quantity_type och perioden med strukturen fi2period_type. Period Mängdvärde fi2interval_period Perioden uttryckt med strukturen fi2period_type. Obligatorisk. fi2interval_quantity Mängdvärdet uttryckt med strukturen fi2quantity_type. Obligatorisk. Fi2period_type Beskriver en tidsperiod antingen med en exakt start- och sluttid, eller som en sträng, exempelvis 2005 eller Maj fi2period_class av perioden. Klasslistan CA000_011_001 (sid 10), används för att specificera vilken periodtyp som avses. Ej obligatorisk.

9 fi2mediasypplymessage_0_6 0 Arb.material 9 (11) Värde fi2period_value Övriga beskrivande värden för periodangivelsen. Själva perioden anges i noden fi2period_starttime/endtime eller fi2period_period. Ej obligatorisk. Perioden anges antingen med en fast start- och sluttid, eller som en tidsperiod som kan uttryckas som en sträng. Starttid Sluttid Period fi2period_starttime Starttiden för perioden. Datumtypen kan innehålla information om datumzon. Obligatorisk om inte period anges enligt nedan. fi2period_endtime Sluttiden för perioden. Datumtypen kan innehålla information om datumzon. Obligatorisk om inte period anges enligt nedan. fi2period_period En period uttryckt som en sträng, exempelvis ett årtal, en månad eller annan period enligt i förväg överenskommet format. Obligatorisk om inte start- och sluttid anges. Fi2quantity_type Definierar ett numeriskt mängdvärde som mått för ett mätvärde, ett förbrukningsvärde eller ett prognosvärde. Värde Mängdvärde fi2quantity_class av mängdvärdet. Förbrukningsvärden kan klassificeras enligt klasslistan CA000_013_001 (sid 11). Ej obligatorisk. fi2quantity_value Övriga beskrivande värden för mängdvärdet. Själva mängdvärdet anges i noden fi2quantity_quantity. Ej obligatorisk. fi2quantity_quantity Själva mängdvärdet för observationen. Enheten kan anges i attributet unit. Obligatorisk.

10 fi2mediasypplymessage_0_6 0 Arb.material 10 (11) Fi2series_type En serie förbrukningsvärden, faktiska eller prognostiserade. Värden anges i en serie intervall. Serien kan klassificeras. Intervall fi2series_class ar av serien. Serier kan klassificeras enligt klasslistan CA000_014_001 (sid 11). fi2series_interval De intervall en förbrukningsperiod delats in i. Intervall anges med strukturen fi2interval_type (sid 7). Minst ett värde ska anges. Klasslistor Här beskrivs de klasslistor som har tillkommit för detta meddelande. Den senaste versionen av klasslistorna finns tillgänglig på föreningens hemsida, CA000_011_001 CA000_012_001 Period Klassificerar periodangivelser enligt följande: m minut h timme d dygn M månad y år i intervall (specificeras vidare i värdena starttid och sluttid) x annan periodangivelse Medium Klassificerar leveranspunkter enligt det medium de hanterar: Fjärrvärme Kraftvärme Fjärrkyla El Gas Vatten

11 fi2mediasypplymessage_0_6 0 Arb.material 11 (11) CA000_013_001 CA000_014_001 Mängdvärde Klassificerar mängdvärden enligt följande: Verklig Fördelad Normalårskorrigerad Beräknad Mätseriens storhet Klassificerar mätvärdesserier enligt storhet. Följande klasser finns: Energi Flöde