Kort beskrivelse af datapostkontoret

Datapostkontoret fungerer som generel datamodtager hvilket betyder at alle der ønsker at levere data, til Min Bolig, Se Elforbrug eller andre tilsvarende systemer, via Elsparefondes webservice til datamodtagelse, skal levere data hertil.

De data man typisk vil sende til datapostkontoret vil bestå af måleværdier for et døgn eller mere (tidsserier), så som elforbrug per kvarter (kW), temperatur per kvarter (grader celsius) osv. Tidsopløsningen kan selvfølgelig antage andre værdier end et kvarter, bare det er samme tidsopløsning man anvender hele tiden for den samme tidsserie.

For at kunne sende data til datapostkontoret skal man benytte en webservice i hvilken selve datastrengen (med måleværdier), nogle leverandøroplysninger samt et referencenummer skal være angivet.

Referencenummeret er et nummer som brugeren skal have oplyst, enten direkte via en label på den hardware enhed som måler og sender data, eller på den hjemmeside hvor man fremsætter ønsket om at få data sendt til dataposthuset.
Det er dette nummer brugeren skal anvende på den hjemmeside hvor data i sidste ende skal havne.

Referencenummeret skal være unikt hvilket betyder at firmaet der genererer det, skal sammensætte det fx bestående af landekode-CVR nummer-HouseControlId fx DNK-21318671-1234567890.

På hjemmesiden hvor data skal anvendes vil der være et punkt der beskriver, at hvis man har bestilt data fra en dataleverandør, skal man her angive sit referencenummer og trykke på ”hent”. Herefter vil alle måleserier med dette referencenummer blive knyttet til denne aktuelle bruger og hjemmeside. Hver nat vil alle data, med dette referencenummer, automatisk blive hentet fra datapostkontoret. Man kan uden problemer tilmelde data med et referencenummer til flere hjemmesider hvis dette måtte ønskes.

Speciel VIGTIG information i forbindelse med integration med Min Bolig
Som beskrevet indsendes data via webservicen med følgende parametre: data_str, ThreeDigitProducerCountryCode, ProducerRegistrationNumber_CVR, HouseControlID, UniqueReferenceNumber, ThreeDigitDataSenderCountryCode

Det er vigtigt at HouseControlID er ID’et for den master der levere data. Dette master ID er et unikt ID og er det samme MasterID der anvendes til at identificere masterne på Min Bolig på siden for Styring.

For at sikre forbindelsen imellem enhederne i Styringsdelen på Min Bolig og forbrugsgraferne er det vigtigt også at følge nedenstående regler.

• Noden <LoggerDevice_ID> skal udfyldes med den fysiske enheds ID som det står i enhedsliste der sendes fra Masteren til Min Bolig Styring. Som fx <LoggerDevice_ID>2</LoggerDevice_ID>
• Noden <LoggerUnit_ID> skal udfyldes med log ID fra den enkelte log-enhed i den fysiske enhed som i enhedslisten, der sendes fra master til Min Bolig. En fysisk enhed kan indeholde mere end en datalogger, som fx en kontakt, der både logger temperatur og strømforbrug, eller en stikkontakt, der logger for flere strømudtag. Eksempel <LoggerUnit_ID>zwave_11</ LoggerUnit_ID>.

Beskrivelse af webservice
De webservices der skal anvendes for at sende data til datapostkontoret findes her:

Den første som returnerer adressen til hvor man skal sende data (gør systemet skalerbart)
http://www.webservice.sparel.dk/getdatapostofficeip_webservice_V1/getdatapostofficeip_webservice.asmx

Den indeholder følgende funktion:
ReturnString = getuploadip(””) (parameteren i funktionen, der er af typen string, skal bare være ””)

ReturnString der returneres fra funktionen er adressen til den webservice der skal gemme data.

ReturnString =
http://www.webservice.sparel.dk/datapostoffice_webservice_V1/datapostoffice_webservice.asmx

med følgende function:
ReturnString =
senddata(ByVal data_str As String,
ByVal ThreeDigitProducerCountryCode As String,
ByVal ProducerRegistrationNumber_CVR As String,
ByVal HouseControlID As String,
ByVal UniqueReferenceNumber As String,
ByVal ThreeDigitDataSenderCountryCode As String) As String

Retur strengen fra funktionen senddata kan indeholde følgende:

For mere information om dataformatet henvises til beskrivelse af datapostkontoret

Data format example for version 3

<Format_version>3</Format_version>
<NewDataset>
<Logger_ID>600000034</Logger_ID><IsHeadmeter>?</IsHeadmeter>
<LoggerDevice_ID>2</LoggerDevice_ID><LoggerUnit_ID> zwave_11</LoggerUnit_ID>
<Logger_Producer>Producer Name</Logger_Producer><Logger_Model>Model xyz 10</Logger_Model>
<Logger_Version>ver 1.2</Logger_Version>
<DataDeliveredVia>-1</DataDeliveredVia>
<C-factor>1.0</C-factor>
<Room_ID>4</Room_ID><Device_ID>2</Device_ID>
<Date_time_format_string>dd-MM-yyyy HH:mm:ss</Date_time_format_string>
<DateAndTimeStamp_Indicator>0</DateAndTimeStamp_Indicator>
<RegistrationType>1</RegistrationType>
<MeteringType>1</MeteringType><Decade_prefix>1</Decade_prefix><Unit>1</Unit>
<Free_text_string>This is the first test</Free_text_string>
<IsInstantaneousValues>No</IsInstantaneousValues>
<Integration_period_in_minutes>15</Integration_period_in_minutes>
<MeterValues>
<DateAndTime>01-05-2007 09:00:00</DateAndTime><Value>28.2</Value>
<DateAndTime>01-05-2007 09:15:00</DateAndTime><Value>28.2</Value>
<DateAndTime>01-05-2007 09:30:00</DateAndTime><Value>28.2</Value>
<DateAndTime>01-05-2007 09:45:00</DateAndTime><Value>28.2</Value>
<DateAndTime>01-05-2007 10:00:00</DateAndTime><Value>28.3</Value>
<DateAndTime>01-05-2007 10:15:00</DateAndTime><Value>29.4</Value>
<DateAndTime>01-05-2007 10:30:00</DateAndTime><Value>28.2</Value>
</MeterValues>
</NewDataset>
<NewDataset>
<Logger ID>600000035</Logger_ID><IsHeadmeter>?</IsHeadmeter>
<DataDeliveredVia>-1</DataDeliveredVia>
<C-factor>1.0</C-factor>
<Room_ID>4</Room_ID><Device_ID>3</Device_ID>
<Date_time_format_string>dd-MM-yyyy HH:mm:ss</Date_time_format_string>
<RegistrationType>1</RegistrationType>
<MeteringType>1</MeteringType><Decade_prefix>1</Decade_prefix><Unit>1</Unit>
<Free_text_string>This is the second test</Free_text_string>
<Integration_period_in_minutes>15</Integration_period_in_minutes>
<MeterValues>
<DateAndTime>01-05-2007 10:00:00</DateAndTime><Value>26.2</Value>
<DateAndTime>01-05-2007 10:15:00</DateAndTime><Value>26.3</Value>
<DateAndTime>01-05-2007 10:30:00</DateAndTime><Value>27.1</Value>
<DateAndTime>01-05-2007 10:45:00</DateAndTime><Value>28.2</Value>
</MeterValues>
</NewDataset>