Datakonsistenstjek (v2) Beskrivelse af snitflader

Til
Danske netvirksomheder og elleverandører
Datakonsistenstjek (v2)
Beskrivelse af snitflader mellem
Energinet.dk og
netvirksomheder/elleverandører
21. oktober 2015
XPBE/XMSH/
Version 1.0
Dok. 13/100809-26
1/17
Indholdsfortegnelse
1.
Overblik og formål ........................................................................... 3
2.
Kommunikation og principper for filudveksling mellem aktør og
Energinet.dk ................................................................................... 4
3.
4.
Serviceportal og opsætning af parametre for datasammenligning .......... 6
3.1
Opsætning af parametre på serviceportal ................................ 6
3.2
Tilvalg af yderligere felter til konsistenstjek (de valgfrie) ........... 7
Kørsel af import og dataanalyse ........................................................ 8
4.1
Formatbeskrivelse af dataeksport fra ekstern aktørs system ...... 8
4.1.1
Placering af filer på FTPS-server ................................ 8
4.1.2
Fil for Metadata ....................................................... 8
4.1.3
Snitflade for sammenligning af Masterdata (MASTERDATA
fællessnitflade for både El og Net) ............................ 10
4.1.4
Snitflade for sammenligning af kontaktadresser
(CONTACT fællessnitflade for både El og Net) ............ 13
4.1.5
Snitflade for sammenligning af Abonnementer og tariffer
(LINKS fællessnitflade for både El og Net) ................. 13
5.
Resultat af datasammenligning (formater) ......................................... 14
5.1
5.2
Målepunktsuoverenstemmelser ............................................. 14
5.1.1
Formatet for MP_ uoverensstemmelser_LINKS.csv...... 15
5.1.2
Formatet for MP_ uoverensstemmelser_CONTACT.csv . 15
Format for resultatfil ............................................................ 16
5.2.1
Format af resultatfil for stamdatasammenligning
(MASTERDATA fællessnitflade for både El og Net) ....... 16
5.2.2
Format af resultatfil for kontaktadressesammenligning
(CONTACT fællessnitflade for både El og Net) ............ 17
5.2.3
Format af resultatfil for abonnement- og
tarifsammenligning (LINKS fællessnitflade for både El og
Net) ...................................................................... 17
Dok. 13/100809-26
2/17
1. Overblik og formål
Energinet.dk tilbyder i dag aktørerne i markedet (elleverandører og netvirksomheder) en løsning for kontrol af datakonsistens mellem registreringer i aktørens
system og registreringer i DataHub. Dette sker ved at aktøren indsender en fil til
Energinet.dk, som herefter gennemfører en sammenligning; denne løsning betegnes som ’Datakonsistenstjek (v1)’. Energinet.dk fremsender resultatet af
eventuelle afvigelser til aktøren, hvorefter det er aktørens ansvar at behandle
disse. Datakonsistenstjek (v1) udfører alene kontrol på afregningsrelevante
stamdatafelter, varierende efter om aktøren har rolle som netvirksomhed eller
elleverandør. Datakonsistenstjek (v1) kan alene anvendes frem til 31. marts
2016.
Med indførsel af Engrosmodellen 1. april 2016 sker der en betydelig udvidelse af
stamdataoplysninger i DataHub og der tilføjes en række nye afregningsrelevante
data. Denne berigelse er netvirksomhederne pt. godt i gang med gennem datamigreringen.
Med Engrosmodellen er der behov for en konsistensløsning, hvor man kan gennemføre konsistenstjek på de nye felter, herunder ikke mindst priser og pristilknytninger. Løsningen betegnes som ’Datakonsistenstjek (v2)’. Da Datakonsistenstjek (v2) allerede nu kan anvendes til kontrol af migrerede data, vil Energinet.dk fra oktober 2015 stille denne løsning til rådighed for aktørerne. Datakonsistenstjek (v2) vil uden ændringer kunne anvendes efter 1.april 2016, hvor
Datakonsistenstjek (v1) udgår.
Datakonsistenstjek (v2) er i relation til stamdata opbygget som en udvidelse af
antallet af felter i Datakonsistenstjek (v1). Herudover vil det i Datakonsistenstjek (v2) være muligt at tjekke konsistensen på samtlige stamdatafelter - altså
ikke kun de afregningsrelevante, som det er tilfældet i Datakonsistenstjek (v1).
I Datakonsistenstjek (v2) kan aktøren også udføre konsistenstjek af prislinks
(obligatorisk efter 1. april 2016) samt konsistenstjek af kontaktoplysninger. Tjek
af prislinks og kontakter sker ved indsendelse af særskilte filer – se mere afsnit
2, 4 og 5.
BEMÆRK
Et Datakonsistenstjek giver ingen garanti for datakvalitet - konsistens er
alene sikkerhed for, at indholdet er lige godt eller dårligt i såvel aktørsystemet som DataHub. Aktøren skal derfor på anden vis sikre sig at kvaliteten
af data er i orden.
Dok. 13/100809-26
3/17
2. Kommunikation og principper for filudveksling
mellem aktør og Energinet.dk
Datakonsistenstjekket er baseret på, at aktøren indsender data ved hjælp af filer
til et selvstændigt datakonsistenssystem. Udveksling af filer vedrørende datakonsistens sker via den almindelige FTPS-server på adressen:
ftps.energinet.dk
Når aktøren ønsker at anvende det nye datakonsistenssystem fremsender Energinet.dk brugernavn og login.
Henvendelser eller spørgsmål vedrørende datakonsistens sker på:
[email protected]
Der udføres alene konsistenstjek på aktuelle data – dvs. den indsendte fil er et
øjebliksbillede til kontrol mod registreringer i DataHub. Energinet.dk danner
udtræk fra DataHub fra samme tidspunkt dog mindst 24 timer senere. Når
Energinet.dk venter 24 timer er det for at sikre, at eventuelle aktørbeskeder
afsendt op til dannelsen af filen er modtaget og registreret i DataHub. Ud over
denne tidsforskydning vil afvikling af konsistenstjek desuden alene ske uden for
normal arbejdstid. For aktøren vil et flow derfor se således ud:
Energinet. dk
modtager fil med
angivelse af udtræk
sket tirsdag kl.
17:00
Tidligst onsdag kl.
17:00 danner
Energinet.dk fil
med data i Datahub
tirsdag kl. 17.00.
Onsdag kl. 24.00
Afvikling af
sammenligning
Torsdag morgen:
Svarfiler klar til
aktør
Figur 1: Tidsforskydning ved udtræk af filer
BEMÆRK
Energinet.dk anbefaler, at aktøren trækker fil til datakonsistens umiddelbart
efter afsendelse af stamdatabeskeder til Datahub.
Energinet.dk indlæser løbende de modtagne filer og gør disse klar til behandling,
jf. ovenstående figur. Efter indlæsning modtager aktøren en kvitteringsmail,
alternativt en fejlbesked hvis filen ikke kan indlæses.
Datoer fra før 2013-01-01 kan af historiske årsager ikke forventes at være konsistente mellem de eksterne aktørers systemer og DataHub. Derfor vil afvigelser
blive ignoreret i de tilfælde, hvor både datoen fra aktørsystemet og datoen fra
DataHub er ældre end 2013-01-01. Dette sker for at undgå store mængder af
afvigelser på ”gamle” datoer.
Følgende filer udveksles mellem Energinet.dk og de eksterne aktører:

Filer ind (til Energinet.dk fra ekstern aktør)
Dok. 13/100809-26
4/17

o Metadata-fil (oplysning om tidspunkt for udtræk)
o Aktørens udtræk af stamdata på målepunkter
o Aktørens udtræk af prislinks på målepunkter
o Evt. aktørens udtræk af kontakter på målepunkter
Filer ud (fra Energinet.dk til ekstern aktør) – disse kommer i op til tre typer for
hver konsistenssammenligning
o MP_ uoverensstemmelser_<FILTYPE>.csv med konstaterede uoverensstemmelser mellem målepunktsnumre indeholdt i aktørens fil og
målepunktsnumre tilhørende aktøren i DataHub.
o Sammenligning_<FILTYPE>.csv med fundne datadifferencer i stamdata
o Fejl (error.txt) Hvis indlæsning af den leverede fil fra den eksterne aktør er fejlet (fx grundet uoverensstemmelse i filformat) genereres en
fil med oplysninger om fejlen (Err01). Denne vil være at finde på FTPS
-server i samme folder, hvori importfilen oprindeligt blev placeret af
den eksterne aktør. Der vil tillige i dette tilfælde blive fremsendt email med oplysning om, at der er sket en fejl.
Udvekslingsfilerne skal gemmes i UTF8 semikolonsepareret format. Det er derfor
vigtigt at eventuelle semikolontegn, som indgår som data, slettes inden fremsendelse til konsistenstjek.
Det samme gør sig gældende for linjeskift og cursor retur ( \r \n (0x0A og
0x0D)). Såfremt disse ikke slettes, kan det medføre flere fejl, herunder at indlæsningen af den fremsendte fil fejler. Som eventuel decimaltalsseparator anvendes "." Format for filer og mappestruktur er nærmere beskrevet under afsnit
4 og 5, ligesom den gældende formatbeskrivelse kan findes på hjemmesiden
eller ved at klikke her.
Efter endt sammenligning af data vil der blive fremsendt en e-mail til den eksterne aktør med overordnet status på sammenligningen. På serviceportalen er
det muligt at angive kontakt-e-mail for notifikationsmail. Herom mere i afsnit
3.1. Fortrolige detaljer vil ikke blive fremsendt via e-mail.
Gennem serviceportalen vil det for den enkelte aktør være muligt dels at definere opsætning, dels at se information om de individuelle kørsler. Endelig er der
adgang til analyse/status over de seneste kørsler.
Figur 2: Snitflader mellem Energinet.dk og ekstern aktør
Dok. 13/100809-26
5/17
3. Serviceportal og opsætning af parametre for datasammenligning
Den eksterne aktør gives via websitet https://services.datahub.dk mulighed for
at ændre konfigurationen for datakonsistenssammenligningen via en parameteropsætning. I det følgende beskrives de enkelte muligheder og deres konsekvens
for datasammenligningen.
3.1
Opsætning af parametre på serviceportal
I udgangspunktet er datakonsistenstjekket en hård 1:1 sammenligning mellem
data i den indsendte fil og produktionsdata i DataHub på samme dato, som indsendelsesfilen er trukket. Er der forskel i registrerede værdier, vil dette resultere
i at værktøjet giver en konsistensfejl. Via menuen ’Indstilling’ (se skærmbillede
nedenfor) har aktøren mulighed for at justere ”hårdheden” af datasammenligningen på nogle parametre, ligesom det er muligt at vælge nogle af de nye felter til.
Figur 3: Skærmbillede over menu i datasammenligning
Forskellig fortolkning af slut- og starttidspunkt, anvendelse eller manglende anvendelse af UTC-tid m.m. er desværre en væsentlig kilde til forskelle i tidsangivelser. Ved at afkrydse feltet Ignorer dataforskelle på +/- 24 timer, resulterer differencer, som ligger inden for dette tidsrum, ikke i en konsistensfejl.
Afkrydses feltet Accepter %-afvigelse på ”Estimeret årsforbrug”, er det
muligt at angive en procent i intervallet 5 – 25%. Feltet er en mulighed for at
acceptere mindre afvigelser i det estimerede årsforbrug uden at dette giver konsistensfejl.
Anvendelse af ovenstående optioner øger dog samtidig risikoen for at reelle konsistensfejl overses, og brugen heraf bør derfor nøje vurderes.
Ved at afkrydse feltet Anvend engelske kolonnenavne i output filer vil de
modtagne resultatfiler have engelske kolonnebetegnelser.
Dok. 13/100809-26
6/17
Feltet Generér læsevenlig resultatfil har alene betydning for Datakonsistenstjek (v1). I Datakonsistenstjek (v2) modtager aktøren altid værdier for samtlige
felter, hvis der er inkonsistens på et af de obligatoriske felter eller ved tilvalg af
valgfrie felter til konsistenskontrol.
I feltet Anvendt emailadresse for notifikationer har du mulighed for at angive de emailadresser, som notifikationer fremsendes til i relation til datakonsistens. Der kan angives mere end én mailadresse – disse skal i så fald være adskilt med et semikolon.
Opsætningen gemmes og vil således være gældende indtil aktøren evt. måtte
ændre i parameteropsætningen.
3.2
Tilvalg af yderligere felter til konsistenstjek (de valgfrie)
I Datakonsistenstjek (v2) kan der gennemføres konsistenstjek på næsten alle
felter (se screen dump nedenfor). Obligatoriske felter skal indsendes og vil altid
blive konsistenstjekket. For Links er alle felter obligatoriske, mens det for såvel
filtyperne Masterdata og Contact er muligt at vælge de valgfrie felter til for konsistenstjek.
Figur 4: Skærmbillede over valgfrie felter i konsistenstjek
Først vælges snitflade; dvs. enten Masterdata eller Contact.
For hvert af de valgfrie felter er det muligt at afkrydse dette for konsistenstjek.
Det er endvidere muligt at vælge, at hvis indholdet af et felt er enten 0, null
eller blankt, så skal konsistenstjekket opfatte disse som ens værdier. Kun valgfrie felter, der er afkrydset, kommer med i resultatfil.
Dok. 13/100809-26
7/17
4. Kørsel af import og dataanalyse
4.1
Formatbeskrivelse af dataeksport fra ekstern aktørs system
I forbindelse med indsendelse af data fra de eksterne aktører fremsendes altid
mindst to filer (og maks. fem filer) til Energinet.dk. På Energinet.dk’s FTPSserver opretter aktøren en folder med dato for udtræk, som beskrevet herunder.
De fremsendte filer placeres i den netop oprettede folder.
For at sikre datakvaliteten er det i forbindelse med udtræk af data fra det eksterne aktørsystem vigtigt at sikre, at udtrækket indeholder alle aktive målepunkter for udtrækstidspunktet. Ligeledes er det af afgørende betydning, at
udtrækstidspunktet stemples korrekt i metadatafilen.
Den samlede leverance fra den eksterne aktør til Energinet.dk vil således bestå
af en metadatafil og en .csv-fil (pr. sammenligningstype), som rummer det
egentlige dataindhold. I de følgende afsnit herunder er de respektive filtyper
beskrevet mere i detaljer.
4.1.1 Placering af filer på FTPS-server
Den eksterne aktør vil via sit login til FTPS-serveren få adgang til en undermappe, der beskriver aktørens identitet. Hvis aktør X således logger på FTPSserveren, kommer aktøren ind i en folderstruktur, der hedder: GLN-DDQ / DDM.
Herunder opretter aktøren en mappe med tidsstempling for dataudtrækket –
den fulde folderstruktur kommer derfor til at se ud som angivet nedenfor, selv
om de eksterne aktører kun vil kunne se fra folderens rolle (DDQ,DDM) og nedefter.
Foldestruktur:
<Org id(GLN nr)-rolle(DDQ,DDM)-D> (denne folder er givet af aktørens
login, og kan ikke modificeres)
<dato-tid(yyyy-mm-dd-hh-mi-ss)> (denne folder skal aktøren oprette)
<csv-fil>
<meta data fil>
4.1.2 Fil for Metadata
Uagtet om der fremsendes data til sammenligning i snitfladerne før eller efter
Engrosmodellen, skal der altid fremsendes en metadatafil. Metadatafilen skal
rumme følgende oplysninger, som ligger fast:
kolonne nr
Feltnavn i fil
Information
Format
Obligatorisk
Eksempel
1
ExportTimeStart
Udtrækstidspunkt start
yyyymm-dd
hh:mi:ss
x
2014-10-20
14:28:00
2
Role
Rolle
3 (AN)
x
”DDQ”
(elleverandør),
eller
”DDM”
(Netvirksomhed)
3
ExecutedBy
Udført af
40 (AN)
”Finn
Jensen”
eller
”ExportJob”
Tabel 1: Oplysninger i metadatafil
Dok. 13/100809-26
8/17
Metadatafilen er en semikolonsepareret fil.
På hjemmesiden findes et eksempel på filformatet. Eksemplet hedder
570000000015-DDM_metadata.csv. Eksempelfiler findes under mappen ’Eksempelfilen til Datakonsistenstjek (v2) vejledning’ – klik her.
Metadatafilen skal navngives således:
<orgid>-<rolle(DDQ/DDM)>_metadata.csv
eksempel på navngivning: 5700000000085-DDQ _metadata.csv
Da det til Datakonsistenstjek er muligt at indsende flere filtyper til sammenligning på samme tid, kan der være behov for at angive forskellige tidspunkter for
udtræk. Dette er muligt ved at tilføje en ekstra kolonne per aktuel filtype, som
vist nedenfor:

specifikt udtrækstidspunkt for MASTERDATA
Hvis specifikt udtrækstidspunkt ønskes opgivet for filen MASTERDATA tilføjes
en kolonne ved navn

MASTERDATAEXPORTTIME
Det er ikke afgørende om denne kolonne ligger som nr. 4, 5 eller 6.
Tidspunktet angives i formatet ’yyyy-mm-dd hh:mi:ss’

specifikt udtrækstidspunkt for CONTACT
Hvis specifikt udtrækstidspunkt ønskes opgivet for filen CONTACT tilføjes en
kolonne ved navn

CONTACTEXPORTTIME
Det er ikke afgørende om denne kolonne ligger som nr. 4, 5 eller 6.
Tidspunktet angives i formatet ’yyyy-mm-dd hh:mi:ss’

specifikt udtrækstidspunkt for LINKS
Hvis specifikt udtrækstidspunkt ønskes opgivet for filen LINKS tilføjes en kolonne ved navn

LINKSEXPORTTIME
Det er ikke afgørende om denne kolonne ligger som nr. 4, 5 eller 6.
Tidspunktet angives i formatet ’yyyy-mm-dd hh:mi:ss’
Dok. 13/100809-26
9/17
Kolonne
nr.
Feltnavn i fil
Information
Format
Obligatorisk
Eksempel
1
ExportTimeStart
Udtrækstidspunkt start
yyyymm-dd
hh:mi:
ss
X
2014-10-20
ell
2014-10-20
12:24:03
2
Role
Rolle
3 (AN)
X
”DDQ”
(elleverandør),
eller
”DDM”
(Netvirksomhed)
3
ExecutedBy
Udført af
40
(AN)
”Finn Jensen”
eller
”ExportJob”
4
MASTERDATAEXPORT
TIME
Udtrækstidspunkt start for
MASTERDATA
yyyymm-dd
hh:mi:
ss
2014-10-20
ell
2014-10-20
14:28:00
5
CONTACTEXPORTTIM
E
Udtrækstidspunkt start for
CONTACT
yyyymm-dd
hh:mi:
ss
2014-10-20
ell
2014-10-20
15:52:25
6
LINKSEXPORTTIME
Udtrækstidspunkt start for
LINKS
yyyymm-dd
hh:mi:
ss
2014-10-20
ell
2014-10-20
16:05:46
Tabel 2: Eksempel på format for metadatafil med flere tidsangivelser
Såfremt der ikke specifikt opgives et tidspunkt for den aktuelle filtype, vil værdien i første kolonne (ExportTimeStart) blive anvendt i stedet.
På hjemmesiden findes et eksempel på det udvidede filformat. Eksemplet hedder 5790002240447-DDQ_metadata.csv. Eksempelfiler findes under mappen
’Eksempelfilen til Datakonsistenstjek (v2) vejledning’ – klik her.
4.1.3 Snitflade for sammenligning af Masterdata (MASTERDATA
fællessnitflade for både El og Net)
I forbindelse med indførelse af Engrosmodellen kommer der en række nye
stamdatafelter. I den forbindelse er der udarbejdet en ny udvidet snitflade til
fremsendelse af disse felter, og herved kan der også udføres konsistenstjek af
nye felter. Masterdatafilen består af 75 felter, som skal medsendes – evt. som
blanke. Se eksempel nedenfor.
Dok. 13/100809-26
10/17
Felt
nr.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
Feltnavn
Målepunkt ID
Målepunkttype
Tilslutningsstatus
Netområde nr.
Netvirksomhed
Fysisk målepunkt
Nettoafregningsgruppe
DE branchekode
Enhed
Produkt
Afregningsform
Aflæsningsfrekvens
Forventet årsforbrug
Aflæsningsform
Forbrug over grænse tilladt
Indsendelsesfrekvens
Vejkode
Vejnavn
Husnummer
Etage
Dørbetegnelse
By
Postnummer
Postdistrikt
Kommunekode
Land
Disponent 1
Fødselsdato 1
Disponent 2
Fødselsdato 2
CVR
Fra net
Til net
VærksGSRN
Brændselsart
PSO-fritaget
Målepunktsart
Planlagt måleraflæsningsdato 1
Planlagt måleraflæsningsdato 2
Planlagt måleraflæsningsdato 3
Planlagt måleraflæsningsdato 4
Planlagt måleraflæsningsdato 5
Planlagt måleraflæsningsdato 6
Planlagt måleraflæsningsdato 7
Planlagt måleraflæsningsdato 8
Planlagt måleraflæsningsdato 9
Planlagt måleraflæsningsdato 10
Planlagt måleraflæsningsdato 11
Planlagt måleraflæsningsdato 12
Webadgangskode
Elleverandør GLN
Elleverandør startdato
Dok. 13/100809-26
Datatype
number(18)
string(3)
string(3)
string(3)
number(16)
string(1)
number(1)
string(6)
string (3)
string(13)
string(3)
string (5)
number(18)
string (3)
number(1)
number(3)
string(4)
string(40)
string(6)
string(2)
string(4)
string(25)
string(10)
string(25)
string(3)
string(2)
string(132)
string(10)
string(132)
string(10)
string(8)
string(3)
string(3)
Eksempel
571313113161134029
E17
E22
023
5790001089030
1
1
1244
KWH
1234567890123
E01
PT15M
13200
D02
1
30
0004
Aalborgvej
14
2
th
Stenrøgel
8620
Kjellerup
740
DK
Finn Jensen
1936-10-18
Anna Jensen
1937-09-05
12345678
023
032
number(18)
string(1)
string(1)
string (2)
string(4)
string(4)
string(4)
string(4)
string(4)
string(4)
string(4)
string(4)
string(4)
string(4)
string(4)
string(4)
string(35)
string(16)
571313113131313131
Date
(yyyy-mm-dd)
2015-02-01
0
1
M1
0131
0228
0331
0430
0531
0630
0731
0831
0930
1031
1130
1231
123X4K445
5790001406530
Obligatorisk (O) / Valgfri (V)
om tjek skal udføres
Netvirksomhed Elleverandør
O
O
O
O
O
V
O
O
V
V
V
V
O
O
V
V
V
V
V
V
O
O
V
V
O
O
V
V
V
V
V
V
V
V
V
V
V
V
V
V
V
V
V
V
V
V
V
V
V
V
V
V
V
V
V
V
V
V
V
V
V
V
O
V
O
V
V
V
V
V
V
V
V
V
V
V
V
V
V
V
V
V
V
V
V
V
V
V
V
V
V
V
V
V
V
V
V
V
Ikke Relevant
V
Ikke Relevant
V
Ikke Relevant
O
11/17
Felt
nr.
Feltnavn
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
Balanceansvarlig Aktør Part GLN
Afbrydelsesart
Tilslutningstype
Effektgrænse Ampere
Effektgrænse kW
Anlægskapacitet
Parent målepunkts ID
TimeData
Aftagepligt
Målepunktskommentar
Målepunktsart - engrosmodel
Målercifre
Måleromregningsfaktor
Målerenhed
Målernummer
Målertype
Dataadgangs CVRnr.
Elvarme
Elvarmeafgiftsstartdato
72
73
74
75
Vaskeanvisning
Tom Felt
Tom Felt
Fremtidig målepunkttype engrosmodel. Udgår og erstattes af
felt 2 1. april 2016
Datatype
string(16)
string (3)
string (3)
number(3)
number(6)
string(8)
number(18)
string(1)
string(1)
string(60)
string(3)
number(8,4)
number(12,4)
string(3)
string(15)
string(3)
string(8)
string(1)
Date
(yyyy-mm-dd)
string (3)
Blank
Blank
string(3)
Eksempel
5790001406530
D01
D01
350
3500
6
571313113161134030
0
1
Bygning nr. 2
D01
5.2
1.03
KWH
303039
D01
22668845
1
Obligatorisk (O) / Valgfri (V)
om tjek skal udføres
Netvirksomhed Elleverandør
Ikke Relevant
O
V
V
V
V
V
V
V
V
V
V
O
O
V
V
Ikke Relevant
V
V
V
O
O
V
V
V
V
V
V
O
O
V
V
V
V
O
O
2015-02-01
O
O
V
V
Ikke Relevant
V
D01
D05
Figur 5: Felter i masterdatafil
Felter markeret med O er obligatorisk at indsende for den respektive aktør. Et V
angiver at feltet er valgfrit og kan vælges til under opsætning i serviceportalen.
Såfremt et felt ikke er obligatorisk, og man ikke ønsker at udføre kontrol af feltet, indsendes dette felt blankt (tomt). Indsendes der værdier for valgfrie felter
som ikke er valgt til, vil sammenligningsværktøjet ignorere feltet.
Felter, som er skraveret med gråt, er ikke relevante fra 1.april 2016. Det er i
den forbindelse vigtigt at understrege, at felternes manglende relevans ikke har
nogen konsekvens for format af filen. Efter 1. april 2016 vil format fortsat bestå
af 75 felter – felter skraveret med gråt skal så blot indsendes uden værdi.
BEMÆRK
Hver record skal altså bestå af samtlige 75 felter semikolonsepareret.
Felterne, der er markeret obligatorisk orange, er obligatoriske i Datakonsistenstjek (v2) efter 1. april 2016. Frem til 1. april 2016 er de orange felter valgfrie
men skal med, hvis man ønsker at gennemføre et tjek af migrerede data. Ønskes de orange felter konsistenstjekket inden 1. april 2016, skal dette markeres
under opsætning i serviceportal.
Dataudtrækket fremsendes i CSV fil med følgende navngivning:
<orgid>-<rolle>_MASTERDATA.csv
Eksempel:
5700000000085-DDQ_MASTERDATA.csv
Dok. 13/100809-26
12/17
4.1.4 Snitflade for sammenligning af kontaktadresser (CONTACT
fællessnitflade for både El og Net)
Med indførsel af Engrosmodellen bliver det muligt at tilknytte fire kontaktadresser til et målepunkt. I den forbindelse er der udarbejdet en ny snitflade til fremsendelse af disse til konsistenstjek; nemlig Contact-filen, som består af 18 felter.
Felt
nr.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
Feltnavn
Målepunkt ID
Adressetype
Kontakt navn 1
Kontakt navn 2
Identisk med MP Adresse
Vejkode
Vejnavn
Husnummer
Etage
Dør
Postnr
Postdistrikt
Supplerende bynavn
Kommunekode
Landekode
Email
Tlf
Mobil
Datatype
number(18)
string(3)
string(132)
string(132)
number(1)
string(4)
string(40)
string(6)
string(2)
string(4)
string(10)
string(25)
string(25)
string(3)
string(2)
string(60)
string(20)
string(20)
Eksempel
Obligatorisk (O) / Valgfri (V)
om tjek skal udføres
579150000000000029
D01
Anders Jensen
Pia Jensen
1
2335
Haydnsvej
22
St
C
7500
Holstebro
Mejdal
661
DK
[email protected]
12345678
87654321
O
O
V
V
V
V
V
V
V
V
V
V
V
V
V
V
V
V
Tabel 3: Felter i Contact-fil
Basalt er det valgfrit, hvorvidt aktøren ønsker at gennemføre konsistenstjek på
kontaktadresser, men ønskes der gennemført konsistenstjek er felt 1 og 2 obligatorisk.
Dataudtrækket fremsendes i CSV-fil med følgende navngivning:
<orgid>-<rolle>_CONTACT.csv
Eksempel:
5700000000085-DDQ_CONTACT.csv
4.1.5 Snitflade for sammenligning af Abonnementer og tariffer
(LINKS fællessnitflade for både El og Net)
Foruden kontaktadresser er det i Engrosmodellen muligt at tilknytte tariffer,
abonnementer og gebyrer på et målepunkt. I den forbindelse er der udarbejdet
en ny snitflade til fremsendelse af disse til konsistenstjek.
Filen til konsistenstjek af Links indeholder fem felter. Samtlige felter i denne
snitflade er obligatoriske, ligesom det er obligatorisk at udføre konsistenstjek på
links.
Dok. 13/100809-26
13/17
Felt
nr.
1
2
3
4
5
Feltnavn
Målepunkt ID
PrisTypeID
Antal
Aktør
Pristype
Datatype
number(18)
string(10)
number(9)
string(16)
string(3)
Eksempel
Obligatorisk (O) / Valgfri (V)
om tjek skal udføres
579150000000000029
B1-udveksl
1
5790001100520
D03
O
O
O
O
O
Tabel 4: Fil til konsistenstjek af Links
Dataudtrækket fremsendes i CSV fil med følgende navngivning:
<orgid>-<rolle>_LINKS.csv
Eksempel:
5700000000085-DDQ_LINKS.csv
5. Resultat af datasammenligning (formater)
Når en aktør fremsender data til sammenligning, tager sammenligningsværktøjet på samme dato, som fremgår af den indsendte fil, et øjebliksbillede af DataHub.
Alle de målepunkter som både er fremsendt af aktøren og findes i DataHub med
tilknytning til pågældende aktør (den grønne fællesmængde i billedet herunder),
vil blive sammenlignet. For hver filtype dannes en resultatfil, som har navnet
Sammenligning_<Filtype>.csv.
Figur 6: Sammenligning af data
Ud over selve sammenligningen genereres også en fil, som viser hvilke målepunkter der ikke kunne sammenlignes. Det sker hvis målepunktet ikke kan findes i begge systemer. Dvs. at målepunkter som i figuren enten er i det blå eller
gule medtages i en fil kaldet MP_uoverensstemmelser_<filtype>.csv.
5.1
Målepunktsuoverenstemmelser
Formatet af denne fil vil være en semikolonsepareret.csv- fil.
Filens navn:
MP_uoverensstemmelser.csv
(for snitfladen for Engrosmodellen vil filens navn være)
MP_ uoverensstemmelser_MASTERDATA.csv
Dok. 13/100809-26
14/17
Efter endt sammenligning kan filen findes i den samme folder, som blev oprettet
til kørslen (tidspunkt for dataudtræk fremgår her af mappenavnet).
I filen vil identifikationsid’et og årsagen til at målepunktet er med i filen fremgå.
Nedenstående tre årsager kan findes:
”1”: Målepunktet er ikke oprettet i DataHub.
”2”: Målepunktet findes i DataHub, men er registreret under en anden aktør.
”3”: Målepunktet står registreret i DataHub under den rette aktør, men målepunktet fremgår ikke af det fremsendte dataudtræk fra aktøren.
Figur 7: Eksempel på resultatfil med uoverensstemmelser i målepunktregistrering
BEMÆRK
Der findes også en fil med uoverensstemmelser for Links og Kontaktadresser,
som viser hvilke data, der ikke har kunnet sammenlignes. Princippet er for disse
sammenligningstyper identisk, men eftersom målepunktsid’et i disse tilfælde
ikke alene udgør den unikke nøgle, ser formatet en smule anderledes ud.
5.1.1 Formatet for MP_ uoverensstemmelser_LINKS.csv
Filen vil indeholde målepunktsid, PristypeId, Aktør og Pristype for pågældende
element. Herudover vil årsagskode og årsagsbeskrivelse tillige fremgå.
Nedenstående to årsager kan findes:
”1”: Linket blev ikke fundet i DataHub
”2”: Linket blev ikke fundet i den fremsendte liste, men findes i DataHub
Figur 8: Eksempel på resultatfil med uoverensstemmelser i målepunktsregistrering - links
5.1.2 Formatet for MP_ uoverensstemmelser_CONTACT.csv
I filen vil målepunktsid’et og adressekoden for det manglende element fremgå.
Herudover vil årsagskode og årsagsbeskrivelse tillige være at finde.
Nedenstående to mulige årsager kan findes:
”1”: Adressen blev ikke fundet i DataHub
”2”: Adressen blev ikke fundet i den fremsendte liste, men findes i DataHub.
Dok. 13/100809-26
15/17
Figur 9: Eksempel på resultatfil med uoverensstemmelser i målepunktsregistrering - contact
5.2
Format for resultatfil
Formatet af denne fil vil være en semikolonsepareret.csv-fil.
Resultatfilen placeres i den mappe på FTPS-serveren, som den eksterne aktør
oprettede og placerede sit dataudtræk på.
Resultatfilens navn:
Sammenligning_<Filtype>.csv
Formatet tilpasses i forhold til, om aktøren er en netvirksomhed eller elleverandør.
5.2.1 Format af resultatfil for stamdatasammenligning
(MASTERDATA fællessnitflade for både El og Net)
I resultatfilen vises alle målepunkter, hvorpå der er konstateret forskelle i data.
For hver kolonne i den fremsendte Masterdatafil, findes der 3 kolonner i resultatfilen.
Først vises hvilken værdi den eksterne aktør har fremsendt på målepunktet,
herefter vises hvilken værdi der står i DataHub, og endelig findes en kolonne
som angiver, om de to kolonner er identiske.
BEMÆRK
Alle felter, der ikke er udført sammenligning på, er tomme i resultatfilen. Dette
er for at gøre filen mere overskuelig.
Resultatfilens navn vil være følgende:
Sammenligning_MASTERDATA.csv
Se et eksempel på resultatfil med navnet Sammenligning_MASTERDATA.csv på
hjemmesiden ved at klikke her. I dette eksempel er ikke alle felter blevet sammenlignet, hvorfor der ikke står data i alle felter.
Dok. 13/100809-26
16/17
5.2.2 Format af resultatfil for kontaktadressesammenligning
(CONTACT fællessnitflade for både El og Net)
I resultatfilen vises alle målepunkter, hvorpå der er konstateret forskelle i data.
For hver kolonne i den fremsendte CONTACT-fil, findes der tre kolonner i resultatfilen.
Først vises hvilken værdi den eksterne aktør har fremsendt på målepunktet,
herefter vises hvilken værdi der står i DataHub, og endelig findes en kolonne
som angiver, om de to kolonner er identiske.
BEMÆRK
Alle felter, der ikke er udført sammenligning på, er tomme i resultatfilen. Dette
er for at gøre filen mere overskuelig.
Resultatfilens navn vil være følgende:
Sammenligning_CONTACT.csv
Eksempel på en resultatfil for kontakter hedder Sammenligning_CONTACT.csv.
5.2.3 Format af resultatfil for abonnement- og tarifsammenligning
(LINKS fællessnitflade for både El og Net)
I resultatfilen vises alle målepunkter, hvorpå der er konstateret forskelle i data.
For hver kolonne i den fremsendte LINKS-fil, findes der tre kolonner i resultatfilen. Først vises hvilken værdi den eksterne aktør har fremsendt på målepunktet,
herefter vises hvilken værdi der står i DataHub, og endelig findes en kolonne
som angiver, om de to kolonner er identiske.
Resultatfilens navn vil være følgende:
Sammenligning_LINKS.csv
Eksempel på en resultatfil for abonnement- og tarifsammenligning hedder Sammenligning_LINKS.csv.
Dok. 13/100809-26
17/17