Energinet.dk data migration User manual

Brugermanual - Datamigrering

Energinet.dk

1 3 . oktoberapril 2012

DataHub support:

Brugermanual – Datamigrering

Version 1.0.

54

Dato 1 3 . oktoberapril 2012

Indhold

1

2

3

4

5

6

7

Introduktion .................................................................................................. 5

1.1

Formål ................................................................................................. 5

1.2

Ændringer i DataMigering 2 (DM-2) .......................................................... 5

1.3

Læse vejledning .................................................................................... 5

1.4

Dokument historie ................................................................................. 5

Migreringsproces ........................................................................................... 7

2.1

Overordnet beskrivelse ........................................................................... 7

2.2

Elleverandørernes opgave ....................................................................... 8

2.3

Migreringskørsel .................................................................................... 8

2.4

Migreringsværktøjer ............................................................................... 9

Fil overførsel ................................................................................................ 10

3.1

Fil overførelse via FileZilla ...................................................................... 10

3.2

Konfigurering af Firewall ........................................................................ 10

3.3

Download af FileZilla ............................................................................. 10

3.4

Opsætning af FTP ................................................................................. 11

3.5

Åben et Websted .................................................................................. 13

3.6

Mappe med overførsler .......................................................................... 15

3.7

Upload af data ...................................................................................... 16

3.8

Timeout i FileZilla ................................................................................. 17

Datamigrering .............................................................................................. 18

4.1

DataHub .............................................................................................. 18

4.1.1

4.1.2

4.1.3

4.1.4

4.1.5

Login 18

Start side ............................................................................. 20

Skift sprog ........................................................................... 21

Log af .................................................................................. 21

Navigation ........................................................................... 22

4.2

Datamigrering - List Migreringskørsler ..................................................... 24

4.3

Datamigrering – Opret kørsel ................................................................. 26

4.4

Datamigrering - Status for datamigrering ................................................ 29

4.5

Datamigrering - Se rapporter ................................................................. 31

4.6

Datamigrering - Slet alle data ................................................................ 33

Rapporter .................................................................................................... 35

5.1

Rapporter kørt under en datamigrering .................................................... 35

5.2

Rapporter kørt af bruger ........................................................................ 36

5.2.1

Kørsel af stamdatarapport ...................................................... 38

Filformater ................................................................................................... 51

6.1

Navngivning af filer ............................................................................... 52

6.2

Syntaks for header linjen ....................................................................... 52

6.3

Syntaks for datalinjer ............................................................................ 53

6.4

Syntaks for footer linjen ........................................................................ 53

6.5

Eksempler på filer ................................................................................. 54

Feltbeskrivelse til filer ................................................................................... 55

7.1

Felter i Header linjen (HDR) ................................................................... 55

7.2

Felter i Data linjer (DATA) ...................................................................... 56

7.3

Felter i Footer linjen (FTR) ..................................................................... 61

side 2 af 75


Version 1.0.

54


Appendix A – Fejlkoder ved validering, DM .............................................................. 63

Appendix B – Fejlkoder ved validering, VAL ............................................................. 68

1

2

Introduktion .................................................................................................. 4

1.1

Formål ................................................................................................. 4

1.2

Læse vejledning .................................................................................... 4

1.3

Dokument historie ................................................................................. 4

Migreringsproces ........................................................................................... 6

3

4

2.1

Overordnet beskrivelse ........................................................................... 6

2.2

Elleverandørernes opgave ....................................................................... 7

2.3

Migreringskørsel .................................................................................... 7

2.4

Migreringsværktøjer ............................................................................... 8

Fil overførsel ................................................................................................. 9

3.1

Fil overførelse via FileZilla ....................................................................... 9

3.2

Konfigurering af Firewall ......................................................................... 9

3.3

Download af FileZilla .............................................................................. 9

3.4

Opsætning af FTP ................................................................................. 10

3.5

Åben et Websted .................................................................................. 12

3.6

Mappe med overførsler .......................................................................... 14

3.7

Upload af data ...................................................................................... 15

3.8

Timeout i FileZilla ................................................................................. 16

Datamigrering .............................................................................................. 17

5

4.1

DataHub .............................................................................................. 17

4.1.1

4.1.2

4.1.3

4.1.4

4.1.5

Login 17

Start side ............................................................................. 18

Skift sprog ........................................................................... 18

Log af .................................................................................. 19

Navigation ........................................................................... 19

4.2

Datamigrering - List Migreringskørsler ..................................................... 20

4.3

Datamigrering - Start migrering ............................................................. 21

4.4

Datamigrering - Status for datamigrering ................................................ 23

4.5

Datamigrering - Se rapporter ................................................................. 24

4.6

Datamigrering - Slet alle data ................................................................ 25

Rapporter .................................................................................................... 27

6

7

5.1

Rapporter kørt under en datamigrering .................................................... 27

5.2

Rapporter kørt af bruger ........................................................................ 28

5.2.1

5.2.2

5.2.3

5.2.4

Rapport igangsætning ........................................................... 29

Kørsel af Stamdata rapport (Master Data Report) ...................... 29

Opsætning af kørsel til afvikling i baggrund .............................. 34

De færdige rapporter ............................................................. 36

Filformater ................................................................................................... 37

6.1

Navngivning af filer ............................................................................... 38

6.2

Syntaks for header linjen ....................................................................... 38

6.3

Syntaks for datalinjer ............................................................................ 39

6.4

Syntaks for footer linjen ........................................................................ 39

6.5

Eksempler på filer ................................................................................. 40

Feltbeskrivelse til filer ................................................................................... 41

7.1

Felter i Header linjen (HDR) ................................................................... 41

7.2

Felter i Data linjer (DATA) ...................................................................... 42

7.3

Felter i Footer linjen (FTR) ..................................................................... 47

Appendix A – Fejlkoder ved validering, DM .............................................................. 49 side 3 af 75

Formateret

Formateret

Formateret

Formateret

Formateret

Formateret

Formateret

Formateret

Formateret

Formateret

Formateret

Formateret

Formateret

Formateret

Formateret

Formateret

Formateret

Formateret

Formateret

Formateret

Formateret

Formateret

Formateret

Formateret

Formateret

Formateret

Formateret

Formateret

Formateret

Formateret

Formateret

Formateret

Formateret

Formateret

Formateret

Formateret

Formateret

Formateret

Formateret

Formateret

Formateret

Formateret

Formateret

Formateret

Formateret

Formateret

Formateret

Formateret

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...


Version 1.0.

54


Appendix B – Fejlkoder ved validering, VAL ............................................................. 53

Formateret: Standardskrifttype i afsnit side 4 af 75

1 Introduktion


Version 1.0.

54


1.1 Formål

Denne brugervejledning udarbejdet til brug for de aktører, som skal foretage datamigreringer. Applikationen er udviklet til Windows 7 og Internet Explorer 8 (Der er benyttet Excel 2007 i de skærmbilleder hvor vi viser import via Excel, men de fleste Excel versioner kan importere en CSV fil).

Data (til datamigrering) er logisk inddelt i:

Data

ALL_CONNECTION

MASTERDATA

METERDATA

Beskrivelse

Indeholder alle GLN numre pr. netområde.

Indeholder masterdata i kronologisk orden for hvert målepunkt.

Indeholder aflæsningsdata for hvert målepunkt.

DELETE_CONNECTION Indeholder GLN numre pr. netområde, som ønskes slettet.

1.2 Ændringer i DataMigering 2 (DM-2)

 I version 2 af migreringssystemet (DM-2) er der sket ændringer på login og

 menustruktur, idet systemet nu er bygget ind i den (næsten) endelige version af

DataHub menustrukturen.

Menustrukturen til DataHub er endnu ikke færdigtestet og godkendt, og der er derfor flere kendte fejl i den del af brugergrænsefladen der ikke vedrører datamigreringen – der mangler bl.a. danske oversættelser til flere tekster (kan identificeres ved at teksten indeholder ”#”).

Brugergrænsefladen til de essentielle migreringsfunktioner er uændret. 

 Brugergrænsefladen til rapporter er ændret, idet der nu ikke startes en ny browser til rapporter, men rapporterne vises i samme browser som migreringsapplikationen.

 Der er implementeret flere nye valideringer af stamdata.

1.21.3

Læse vejledning

Kapitel 1: Omhandler generelle informationer omkring denne brugervejledning.

Kapitel 2. Beskriver den overordnede migreringsproces

Kapitel 3: Beskriver hvordan filer overføres via FTP

Kapitel 4: Beskriver hvordan datamigreringen foregår

Kapitel 5: Beskriver rapportgeneratoren samt de rapporter der kan dannes.

Kapitel 6. Beskriver filformaterne

Kapitel 7: Beskriver felter i filerne

App. A: Fejlkoder ved validering (DM-koder)

App. B: Fejlkoder ved validering (VAL-koder)

1.31.4

Dokument historie

side 5 af 75

Formateret: Listeafsnit, Punkttegn +

Niveau: 1 + Justeret: 0,63 cm +

Indrykning: 1,27 cm


Version 1.0.

54


Version Status Dato

0.1

1.0

Beskrivelse

Udkast 18-11-2011 Dette dokument er en kopi af

“010.080.020.001 - 0.4 - User Manual

Datamigration - UK”.

Oversat til dansk. (HUD)

Endelig 09-01-2012 Udvidet og tilpasset til forretningsbrug

Forfatter

Logica

1.0.1 Rettet 10-01-2012 Tilføjet fejlkoder DM-207 - DM-224 og manglende VAL fejlkoder

ENDK

ENDK

1.0.2 Rettet 19-01-2012 Ændret vejnavn til mandatory (kap.7)

Kap. 4.4 flyttet til 4.7 (logisk rækkefølge)

ENDK

1.0.3 Rettet 31-01-2012 Tilføjet præcisering vedr. skift af BA i kap. 6 ENDK

1.0.4 Rettet 13-04-2012 Flere ændringer, efter ny release af migreringsapplikation 2012-04-11.

Ændringerne er konsekvens af ændringer i

RSM-dokumentet (”Forretningsprocesser for det danske elmarked, version 2.0”)

3.8 – Nyt afsnit

7.2 – Datatyper og validering ændret for felterne: Etage, Kommune og aflæsningsfrekvens, så de stemmer overens med RSM-dokumentet

Appendix A

DM-001 – ændret

DM-118, DM-207, DM-222 – fjernet

DM-226 – Ny (ændret udgave af DM-118)

VAL-084 – VAL-098 – Nye valideringer

1.0.5 Rettet 01-10-2012 Rettet udgave til DataMigrering version 2

(DM-2)

ENDK

ENDK side 6 af 75


Version 1.0.

54


2 Migreringsproces

2.1 Overordnet beskrivelse

Netvirksomhederne danner udtræk af stamdata og måledata fra egne systemer.

Udtrækkene sker til tre simple csv-filer, der indlæses i Migreringssystemet.

Data vil her blive valideret og hvis data opfylder valideringskriterierne, læses data ind i migreringssystemet. Netvirksomhederne kan løbende danne rapporter, der viser status på indlæsningerne - hvor mange er ok, hvor mange er fejlet - og hvorfor er de fejlet.

Netvirksomhederne kan selv styre migreringsprocessen via web-interface og migreringen kan udføres successivt.

Gridoperators

ENDK

Create extract Import Validate Reporting

Clearing

Errors

Elleverandørerne kan løbende i processen udtrække en rapport (csv-fil) der viser stamdata for de målepunkter elleverandøren er registreret som leverandør på. Denne rapport skal elleverandøren anvende til validering af de migrerede data. Hvis elleverandøren finder uoverensstemmelser i data, udredes dette bilateralt mellem elleverandøren og netvirksomheden i migreringsforløbet.

Systemmæssigt vil Migreringssystemet være en del af DataHub løsningen, med egne funktioner og egne skærmbilleder (web). Systemet vil kun være aktivt i migreringsperioden og vil blive lukket ved go-live af DataHub.

Datafilerne afleveres fra netvirksomhederne til Migreringssystemet via SFTP. side 7 af 75


Version 1.0.

54


2.2 Elleverandørernes opgave

Elleverandørerne skal i migreringssystemet udtrække en rapport (csv-fil) der viser alle stamdata for alle de målepunkter, som er tilknyttet den pågældende elleverandør,

Elleverandørerne skal kontrollere at stamdata for målepunkterne er i overensstemmelse med elleverandørens oplysninger. Ved evt. uoverensstemmelse skal elleverandøren udrede dette bilateralt med netvirksomheden.

2.3 Migreringskørsel

Nedenstående figur illustrerer forløbet ved en migreringskørsel i migreringssystemet:

Netselskabet danner filer til migrering og filerne overføres til migreringssystemet via ftp.

Når filerne er placeret på migreringssystemets ftp-server kan migreringskørslen startes efter indlogning til systemet.

Migreringen udføres i tre step:

1. Import - filen indlæses i systemet og der kontrolleres om:

- filformatet er korrekt

- alle felter overholder formaterne som specificeret

- alle tvungne felter er til stede

- checksum (og antal linjer i filen) er korrekt.

Hvis der konstateres fejl i dette step, noteres fejlene i rapporten

"Failures_File_Import_<migr.nr>_<netnr>.csv - og fejlene vil alle være i nummerserien DM-1xx. (se appendix A).

Hvis der konstateres fejl i import steppet afvises filen og der migreres intet. side 8 af 75


Version 1.0.

54


2. Validate - der foretages nu en mere forretningsmæssig validering af data.

F.eks.: Er målepunktet allerede indlæst? Hvis målepunktet er et skabelonafregnet målepunkt, skal der også angives aflæsningsdato o.s.v.

Hvis der konstateres fejl, noteres disse i rapporten:

"Failures_Validation_Stage_<migr.nr>_<netnr>.csv - og fejlene vil være i nummerserien DM-2xx eller VAL-xxx (se appendix A og B).

Hvis der konstateres fejl ved data på et målepunkt, afvises alle data for dette målepunkt.

3. Reporting - Der dannes en oversigtsrapport for migreringskørslen, der viser hvor mange linjer, som er migreret/fejlet.

Når migreringskørslen er afsluttet, vil der altid være dannet de tre ovenstående filer og disse kan ses i systemet.

Man behøver ikke være logget på systemet, mens migreringkørslen udføres. Man kan starte migreringen, og senere kontrollere rapporterne for at se forløbet for kørslen.

2.4 Migreringsværktøjer

I forbindelse med migreringen, vil man møde tre forskellige værktøjer:

1. FTP-klient - Til overførsel af filer til Migreringssystemet. Dette er beskrevet i kapitel 3

2. Migreringssystemet - Afvikles i en almindelig Internet browser. Dette er beskrevet i kapitel 4.

3. Rapporteringssystemet (JasperSoft) - Er en del af migreringssystemet, men afvikles i et selvstændigt browservindue. Man kan ikke logge ud fra rapportsystemet, så vinduet lukkes når man er færdig med rapporten.

FTP – f.eks. FileZilla

Migreringssystem (browser)

Rapporteringssystem (browser)

side 9 af 75


Version 1.0.

54


3 Fil overførsel

Filerne skal overføres via FTP til Migreringssystemet. Der er i denne vejledning valgt at beskrive denne proces via brug af værktøjet FileZilla. Bemærk at andre FTP programmer også kan anvendes.

3.1 Fil overførelse via FileZilla

Dette kapitel beskriver upload af filer. FTP-værktøjet er FileZilla.

3.2 Konfigurering af Firewall

Hvis ftp-serveren tilgås via en firewall, skal nedenstående porte være åbne i denne:

TCP: 20, 21, 500, 501, 989, 990 og 2000-2500

3.3 Download af FileZilla

FileZilla kan downloades gratis fra http://sourceforge.net/projects/filezilla eller lignende sites. Versionen vi har benyttet er 3.5.2 til Windows 32 bit.

Dette skærmbillede vil blive vist ved start af FileZilla.

Skærmbillede: FileZilla

Under værktøjslinjen og ”Lyntilslut”, vises meddelelser så som overførselslog og tilslutnings relaterede meddelelser. Nedenfor kan fileoversigten findes. side 10 af 75


Version 1.0.

54


Den venstre kolonne ”Lokalt sted” viser de lokale filer og mapper. Den højre kolonne

”Fjernsted” viser de filer og mapper på den fjern-server der er forbundet til.

Begge kolonner har en mappe struktur i toppen og en detaljeret liste over den aktuelt valgte mappes indhold i bunden.

Der kan nemt navigeres via mappe strukturen og lister ved at klikke, som i enhver anden stifinder.

Nederst i vinduet, vises filer i overførselskøen, der er delt i ”Filer i kø”, ”Mislykkede overførsler” og ”Gennemførte overførsler”.

3.4 Opsætning af FTP

En ny FTP forbindelse laves via funktionen ”Websted Manager” i FileZilla.

I dette afsnit er indsat information således der oprettes en forbindelse til

Migreringssystemet.

Åben 'Websted Manager' ved hjælp af knappen "Åben Websted Manager"- i øverste venstre hjørne.

Denne knap bruges også til at logge på med fremover.

Skærmbillede: FileZilla - Her åbnes Websted Manager side 11 af 75


Version 1.0.

54


Ved tryk på "Nyt Websted", skal der angives et navn og de følgende indstillinger.

 Navn kunne være ”Migrering_FTP”

Tab

Generelt

Generelt

Generelt

Generelt

Generelt

Generelt

Overførsels- indstillinger

Felt

Vært

Protokol

Kryptering

Logontype

Bruger

Kodeord

Overførselstilstand

Værd ftp.datamigrering.datahub.dk

FTP - File Transfer Protocol

Forlang eksplicit FTP over TLS

Normal

<dit brugernavn>

<din adgangskode>

Passiv

Skærmbillede: FileZilla - Websted Manager side 12 af 75


Version 1.0.

54


3.5 Åben et Websted

Alle sites vil blive vist, når der klikkes på pilen i øverste venstre hjørne.

Skærmbillede: FileZilla - Vælg Websted

Ved klik på ”TST-031”(i dette eksempel) oprettes forbindelse til serveren, efter at have etableret forbindelsen vil følgende blive vist. Hvis der ligger filer på fjernserveren vil disse også blive vist. side 13 af 75


Version 1.0.

54


Skærmbillede – FileZilla – Vis Website side 14 af 75

3.6 Mappe med overførsler

Naviger til den mappe hvor filerne til upload findes.


Version 1.0.

54


Skærmbillede: FileZilla - Data til overførsel

I dette eksempel er der 3 data overførsler tilgængelig:

 ALL_CONNECTION_031_00200.dat: Indeholder målepunkter for netområde 031.





MASTERDATA_031_00200.dat: Indeholder stamdata for netområde 031.

METERDATA_031_00200.dat: Indeholder måledata for netområde 031. side 15 af 75


Version 1.0.

54


3.7 Upload af data

Der kan uploades filer på 2 måder:

 Dobbeltklik på et filnavn for at uploade data (i den venstre rude: ”Lokalt sted”).

 Lav drag & drop (træk fil fra venstre side til højre side).

I dette eksempel er det filen ”All_CONNECTION_031_00200.dat” der er flyttet.

Skærmbillede: FileZilla - Upload data

Ovenstående figur viser at filen "ALL_CONNECTION_031_00200.dat" er tilgængelig på datamigrerings serveren(ruden "Fjernsted”).

Det vil nu være muligt at udføre en migrering af de data, der er overført til serveren. side 16 af 75


Version 1.0.

54


3.8 Timeout i FileZilla

Hvis man oplever, at FileZilla laver ”TimeOut” i forbindelse med upload af data, kan dette løses ved at ændre en parameter i FileZilla. Vælg menupunktet ”Edit -> Settings”:

Under det første punkt (Connection) kan Timeout sættes til den ønskede værdi, eller ”0” for at disable timeout. side 17 af 75


Version 1.0.

54


4 Datamigrering

I dette kapitel beskrives hvordan DataHub anvendes til datamigrering.

4.1 DataHub

4.1.1 Login

Klik på nedenstående link eller tilføj det i Internet browser: https://www.datamigrering.datahub.dk/sites/CEMS/ https://www.datamigrering.datahub.dk/sites/GenericContentEnerginetDKSC

Indtast brugernavn og adgangskode for at logge ind, denne information er tilsendt i brev fra Energinet.dk.

Feltkode ændret

Formateret: Dansk

Formateret: Dansk

Skærmbillede: DataHub - Login

Ved login kan vælges, om man ønsker at anvende sproget dansk eller engelsk.

Hvis der ikke kan logges ind, så tjek: side 18 af 75


Version 1.0.

54


 Er <Brugernavn> skrevet korrekt.

 Er <Password> skrevet korrekt.

 At "Caps Lock" ikke er aktiveret.

Det er ikke muligt at skifte password i migreringssystemet.

Der tildeles kun ét brugernavn til hver netvirksomhed og elleverandør. Det er muligt for flere brugere at anvende dette brugernavn samtidig, men det er dog kun tilladt at have en migreringskørsel aktiv pr. brugernavn. side 19 af 75


Version 1.0.

54


4.1.2 Start side

Efter login vises følgende skærmbillede, som er DataHub startbillede.

Skærmbillede: DataHub - Home

På startsiden er der funktioner til at

 Skifte sprog

 Logge af side 20 af 75


Version 1.0.

54


4.1.3 Skift sprog

For at skifte sprog på DataHub, klikkes på brugernavn i øverste højre hjørne. Vælg i menuen Visningssprog.

Skærmbillede: DataHub - Sprogindstillinger

4.1.4 Log af

Der logges ud ved at klikke på brugernavnet”Log ud” (i øverste højre hjørne) og vælg menupunktet Log udherefter bekræfte at man ønsker at logge ud . side 21 af 75


Version 1.0.

54


Skærmbillede: DataHub - Log af

4.1.5 Navigation

Navigationen i DataHub er browser funktionalitet. Ved klik på menupunktet på menulinjen, foldes menuen ud : og der kan navigeres direkte til undermenuer. side 22 af 75


Version 1.0.

54


Ved klik på en undermenu (her: #Runs) – vises denne undermenu som et nyt menu punkt på linjen, og man kan i denne menu nu vælge funktionen (#Create run)

Skærmbillede: DataHub - Navigation side 23 af 75


Version 1.0.

54


4.2 Datamigrering - List Migreringskørsler

Her kan en ny datamigrering startes, slettes data og se rapporter for de aktuelle datamigreringer listet på siden.

Der vises alle kørsler, som er afviklet af brugeren, sorteret efter migreringsnummeret

(faldende).

Skærmbillede: List Migreringskørsler

Navigation: DataHub

( Portalhome )

> Datamigrering > #Runs > # List Migreringskørslerruns side 24 af 75


Version 1.0.

54


Følgende handlinger kan udføres:



Migreringsnummer Kørselssnummer

Ved klik på migreringsnummeret kørselsnummeret mens en migrering foregår,

 kan man se den aktuelle status på migreringen. Når en migrering er kørt færdig, vil dette link ikke længere have nogen funktion.

Start migreringOpret kørsel

Ved klik på knap ” Start migreringOpret kørsel ” åbnes et skærmbillede, hvor man kan indtaste detaljer omkring den enkelte migrering.

[se afsnit 4.3]

Slet alle dataReset



Ved klik på knap ” Slet alle dataReset ”, vil man få mulighed at slette alle data for egen netvirksomhed.

[se afsnit 4.4]



VisSe rapporter

Ved klik på knap ” VisSe rapporter” gives der adgang til at se de rapporter, som er dannet under datamigreringen.

[se afsnit 4.6] side 25 af 75


Version 1.0.

54


4.3 Datamigrering -– Start migreringOpret kørsel

Her kan en ny kørsel startes.

Skærmbillede: Start migrering

Navigation: DataHub

(home)

> Datamigrering > List Migreringskørsler > knap

Start migrering


Migreringsnummer skal indtastes med 5 cifre. side 26 af 75


Version 1.0.

54


Netområdenummer (DE nummer) skal indtastes med 3 cifre.



Start

Ved klik på denne knap bliver en ny kørsel igangsat. For at overvåge denne

 proces blive skærmbilledet "Vis resultater" åbnet. Under afvikling er det ikke muligt at udføre en nulstilling.

[se afsnit 4.5]

A nnulerfbryd

Ved klik på denne knap vil skærmbillede "List Migreringskørsler" vil blive vist.


Fejlmeddelelser vises i en rød boks – og ser sådan ud.


Version 1.0.

54


Skærmbillede: Start migrering, fejlmeddelse

Navigation: DataHub

(home)


Start migrering side 28 af 75

4.4 Datamigrering - Status for datamigrering


Version 1.0.

54


Når en migrering er startet, kan forløbet for datamigreringen overvåges.

Der vises følgende oplysninger om en datamigrering:

 Status (viser løbende status under kørslen).





Samlet (Antal linjer, der er læst ind).

Nye (Antal linjer som er indlæst ok og venter på at blive valideret).

 Valideret (Antal linjer som er valideret ok).

 Fejl (Antal linjer, som er fejlet under valideringen).

Summen af typerne Valideret og Fejl, vil ikke nødvendigvis stemme med Samlet, når kørslen er afsluttet. Dette skyldes, at relaterede linjer til Fejlede ikke tælles med. Disse kan ses i kørselsrapporten for den givne kørsel.

Dette skærmbillede vil blive opdateret (automatisk) hvert minut eller når der opdateringer. Der kan også trykkes F5 for manuel opdatering.

side 29 af 75


Version 1.0.

54


Skærmbillede: Se Oversigt

Navigation: DataHub

(home)


Start migrering > knap

Start

Følgende kan udføres:



Vis Migreringskørsler

Ved tryk på knap vises skærmbillede "List Migreringskørsler"



Version 1.0.

54


4.5 Datamigrering - Se rapporter

Formålet med dette skærmbillede er at vise en oversigt over de rapporter, der er oprettet under afviklingen af kørslerne.

Skærmbillede: Se rapporter

Navigation: DataHub

(home)


Se Rapporter




Vis rapporter

side 31 af 75


Version 1.0.

54




Tryk på link ”Vis rapporter”. Dette link åbner "JasperSoft Rapporter. skabt under

Kørsel" i et nyt vindue .

[se afsnit 5.1]

List migreringer

Ved tryk på knap bliver skærmbillede "List Migreringskørsler" vist.



Version 1.0.

54


4.6 Datamigrering - Slet alle data

Her kan sættes en kørsel i gang, der sletter alle stam- og måledata for det angivne netområde.

Skærmbillede: Slet data

Navigation: DataHub

(home)


Slet alle dataReset

Når der er indtastet netområdenummer og trykket på knappen "Start" bliver alle stam- og målerdata for netområdet fjernet. Før den faktiske nulstilling vil der blive åbnet en dialogboks, hvor man skal bekræfte, at man ønsker at slette.

side 33 af 75


Version 1.0.

54


Skærmbillede: Slet alle dataReset - Bekræftelse

Navigation: DataHub

(home)


Slet alle data

Ved at trykke på knappen "OK" bliver nulstillingen startet. Under fjernelsen er det ikke muligt at oprette nye kørsler. Ved afslutning af kørsel forsvinder dialogboksen og man kommer tilbage til forrige skærmbillede. Skærmen opdateres ikke automatisk, så tryk F5 for opdatering af browseren. side 34 af 75


Version 1.0.

54


5 Rapporter

I dette afsnit beskrives rapportgeneratoren samt de rapporter, der kan dannes.

Rapportgeneratoren der anvendes hedder JasperSoft (skærmbilleder med blå baggrund) .

Rapporterne, som bliver dannet i forbindelse med en DataMigrering, vil være tilgængelige via portalen 2 steder.

Rapporter som dannes under en kørsel, vil kunne hentes via datamigrering skærmbilledet

[afsnit 4.6]. Rapporter som ikke relaterer direkte til en kørsel, kan dannes via menuen.

Nedenstående tabel viser alle rapporter og hvor de findes.

Rapport

Failure Details Report File Import

Rapportresultater - findes via skærmbilledet

"Se rapporter" [4.6]

X

Rapportdefinitioner findes via

JasperSoft [5.2]

Failure Details Report Validation Stage X

Details Migration Run Report

Stamdatarapport

X

X

Manglende måledata rapport X

De første tre rapporter bliver oprettet under en datamigrering, mens de 2 sidste vil blive oprettet efter anmodning.

Der skelnes mellem rapportdefinitioner og rapportresultater. Ved rapportdefinitioner skal rapporten køres, for at se et rapportresultat.

5.1 Rapporter kørt under en datamigrering

Følgende rapporter vises ved tryk på link ”Vis rapporter” i skærmbillede "Se rapporter".

Disse rapporter er alle dannet under en datamigrering.

side 35 af 75


Version 1.0.

54


Skærmbillede: Report outputs

Navigation: DataHub

(home)


Se Rapporter > link

Vis rapporter

Ved tryk på link (tekst i blå mørkerød farve) åbnes rapportresultat - i enten Adobe

Reader (pdf-filer) eller Excel (csv-filer).

Hvordan filen åbnes (om filen åbnes i nyt browservindue eller starter Excel) er afhængig af pc'ens lokale opsætning i browseren.

Rapporten ”Accounting_report_for_run_xxx” er p.t. tom og skal ikke anvendes i den nuværende version.

Man kommer tilbage til Migreringsapplikationen ved at anvende browserens ”Tilbage”knap.

5.2 Rapporter kørt af bruger

Via menuen er en rækkefølgende rapporter tilgængelige , men kun én rapport er .relevant i den nuværende version:

 Stamdatarapport (Master Data Report)

 Manglende måledata rapport (Report On Missing Meter Data)

Formateret: Indrykning: Venstre:

1,27 cm, Ingen punkttegn eller nummerering side 36 af 75


Version 1.0.

54


Skærmbillede: Rapporter

Navigation: DataHub

(home)

> Datamigrering > Rapporter side 37 af 75

5.2.1 Rapport igangsætningKørsel af stamdatarapport


Version 1.0.

54


Efter valg af rapporten "Master Data Report" vil følgende skærmbillede blive vist.

På listen med rapporter, klikkes på linket ”Planlagte opgaver” udfor ”Stamdata rapport”:

Hvorefter følgende vises:

Og her klikkes der på knappen ”Kør nu” side 38 af 75


Version 1.0.

54


I det nedenstående skærmbillede skal GLN nummeret nu indtastes som parameter til rapporten. GLN nummeret der skal indtastes kan ses i linjen der vises lige over feltet

(markeret med grønt på skærmbilledet herunder): side 39 af 75


Version 1.0.

54


Når GLN nummeret er indtastet klikkes der på knappen: ”Næste”.

Der vises nu følgende skærmbillede, hvor der skal krydses af i ”Overskriv fil”: side 40 af 75


Version 1.0.

54


Der trykkes på ”Send” – og rapporten startes nu i baggrunden, hvilket kan ses i statusskærmbilledet der nu vises:

Efter nogen tid, kan man se om der er dannet et resultat, ved at klikke på linket

”Resultat” ud for ”Stamdata rapport”: side 41 af 75


Version 1.0.

54


Og når rapporten er færdig, kan man se rapporten ved at klikke på de mørkerøde link:

Skærmbillede: Migreringsstatus, Reports

Navigation: DataHub

(home)

> Datamigrering > Rapporter > Master Data Report side 42 af 75


Version 1.0.

54


Her ses rapportdefinitionen til Master Data Report. Ved at dobbeltklikke på rapportdefinitionen startes rapporten, eller man højreklikke på rapportdefinitionen og får hermed vist en menu med følgende valg:



Run

Ved valg af ”Run” åbnes rapporten på skærmen når denne er dannet. Når rapporten er indlæst, er det er muligt at eksportere rapporten manuelt. "Run" svarer til at dobbeltklikke på rapportdefinitionen.



Run in Background

Ved valg af ”Run in Background” er det muligt at køre rapporten i baggrunden.

Hvis man vælger denne metode, vil resultatet blive vist når man klikker på

 menupunktet ”Reports output” i menuen i venstre side.

[se afsnit 5.2.2]

Schedule

Ved valg af ”Schedule”, laves der et job med gentagelser til afvikling af en rapport i baggrund. - dette er ikke relevant i denne sammenhæng.

5.2.2 Kørsel af Stamdata rapport (Master Data Report)

Efter dobbeltklik på rapportdefinitionen (master_data_report), spørges der om GLN nummeret for virksomheden. Dette er defineret på forhånd, så værdien skal blot vælges fra rullelisten "Use saves values":

Herved udfyldes parameteren med det korrekte GLN nummer, der kan trykkes på "OK" knappen og rapporten startes: side 43 af 75


Version 1.0.

54


Mens rapporten afvikles, vises denne boks på skærmen:

Når rapporten er afsluttet, vises resultatet på skærmen:

Data kan exporteres til csv-format, ved valg af "Export": side 44 af 75


Version 1.0.

54


Man vil blive spurgt, om filen skal åbnes - eller gemmes (standard Windows). Det anbefales, at man gemmer filen på sit lokale drev, idet en "Åbn" - vil resultere i en forkert konvertering af "æøå" i filen:

Hvis man vælger "Åbn" - vil filen se således ud i Excel:

Hvis man i stedet gemmer filen lokalt, og anvender importfunktionen.

Excel 2003:

Her vælges: Data -> Importer eksterne data:

Excel 2010: side 45 af 75


Version 1.0.

54


Her vælges Data -> Fra tekst"

Kan man i "Filoprindelse" angive at filen er i UTF-8:

Hermed tolker Excel koderne for "æøå" korrekt:

Der skal angives at "Afgrænsere" er Semikolon: side 46 af 75


Version 1.0.

54


Tryk Udfør - og data vil nu blive vist korrekt i Excel: side 47 af 75


Version 1.0.

54


5.2.3 Opsætning af kørsel til afvikling i baggrund

Hvis man har behov for at afvikle rapporter i baggrunden, er dette muligt.

Her kan indtastes alle output indstillinger såsom filnavn og output sti. Det vil kun være muligt at vælge CSV format (og i enkelte rapporter også PDF).

Højreklik på rapportdefintionen og vælg "Run in Background…"

Her vælges GLN nummeret - på samme måde som ved kørsel til skærm og der trykkes på "Next" side 48 af 75


Version 1.0.

54


Ved at trykke på knappen "Browse…" vil den følgende dialog blive vist. side 49 af 75


Version 1.0.

54


I dette skærmbillede vælges der den ønskede fil placering i Jaspersoft og man kan med almindelig filhåndtering vælge hvilken mappe resultatfilen skal placeres i.

Ved tryk på knap "Submit" i skærmbillede "Output Settings", vil der starte et job, som danner en rapport på den valgte output placering.

5.2.4 De færdige rapporter

Er der valgt at køre en rapport i baggrunden, vil man finde resultatet her.

Ved valg af "Reports output" i JasperServer vises de dannede rapporter. side 50 af 75


Version 1.0.

54


6 Filformater

Dette kapitel beskriver overordnede regler for filformaterne der skal migreres

Der findes fire type af filer, der alle afleveres til migreringssystemet via FTP.

1. ALL_CONNECTION

 Indeholder en liste af målepunkt ID for alle målepunkter i et netområde

 Listen bør være så komplet som muligt, da denne anvendes til rapportering af fremdrift for migreringen for det enkelte netområde

2. MASTERDATA:

 Indeholder stamdata for målepunkter, og ændringer over tid på disse.

 Ændringerne på stamdata skal placeres i kronologisk orden i filen.

3. METERDATA:

 Indeholder måledata for hvert målepunkt

 Måledata skal angives kronologisk orden i filen (pr. målepunkt)

4. DELETE_CONNECTION:

 Indeholder en liste over målepunkter der ønskes slettet i migreringssystemet, der slettes bade stamdata og målinger for disse målepunkter.

Filtyperne 1, 2 og 3 kan migreres samtidig (i samme kørsel), men filtype 4 (DELETE_CONNECTION) kan kun migreres selvstændig (ingen andre filtyper til stede).

For at sikre entydighed, gælder følgende regler:

1. I ALL_CONNECTION og DELETE_CONNECTION skal målepunkt ID være entydig i filen

2. I MASTERDATA skal kombinationen målepunkt ID og gyldig-fra være entydig

3. I METERDATA skal kombinationen målepunkt ID og start-tid være entydig, og målepunkt

ID og slut-tid skal være entydig. Det er ikke tilladt med overlap mellem måleperioder.

4. MASTERDATA og METERDATA må kun indeholder målepunkt ID der allerede er migreret med ALL_CONNECTION

5. Det er kun muligt at opdatere den sidste periode for stamdata for et målepunkt

(MASTERDATA). En opdatering af stamdata vil ske ved at migrere målepunktet med præcis samme gyldig-fra, som den sidste periode angiver.

Det er ikke muligt at opdatere mellemliggende perioder i stamdata, da der sker en validering af tilladte statusændringer fra én periode til næste periode. Hvis stamdata til en mellemliggende periode ønskes ændret betyder dette, at målepunktet skal slettes

(DELETE_CONNECTION) og migreres igen.

6. Opdatering af måledata (METERDATA) er muligt ved at angive samme målepunkt ID, startid og sluttid på målingen der ønskes opdateret.

Øvrige regler for migreringsdata:

1. Ved skift af balanceansvarlig på et målepunkt (uden samtidig skift af elleverandør) skal dette i migreringen angives med årsagskode E32 (opdatering af stamdata). side 51 af 75


Version 1.0.

54


6.1 Navngivning af filer

Filnavnene skal have følgende opbygning:

ALL_CONNECTION_<netområde>_<migr.nr>.dat

MASTERDATA_<netområde>_<migr.nr>.dat

METERDATA_<netområde>_<migr.nr>.dat

DELETE_CONNECTION_<netområde>_<migr.nr>.dat

Filnavnet skal være uppercase, og fil-extension (".dat") skal være lowercase.

Felt Beskrivelse Type

Netområde

Migr.nr

Netområdenummer. Skal angives med 3 cifre (eks. 023) String(3)

Migreringsnummer.

Nummeret skal angives med 5 cifre (eks. 00001).

Hver migrering skal have et entydigt migreringsnummer.

String(5)

Kombinationen af <netområde> og <migr.nr> skal være entydig.

Et eksempel på gyldige filnavne:

ALL_CONNECTION_023_00001.dat

MASTERDATA_023_00001.dat

METERDATA_023_00001.dat

DELETE_CONNECTION_023_00002.dat

Øvrige regler for filformat er:

1. Filens første linje skal være en header record. Syntaks beskrevet i 6.1.1

2. Filens sidste linje skal være en footer record. Syntaks er beskrevet i 6.1.3

3. Filens øvrige linjer er afhængig af filtypen, og er beskrevet i afsnit nedenfor.

4. Skilletegn mellem felter er tegnet "|" (pipe - Unicode 007C).

5. Linjer skal afsluttes med carriagereturn/linefeed (CR/LF - Unicode 0D0A)

6. Data i felter må ikke indeholde skilletegnet ("|") eller linefeed (0D0A)

7. Tegnsættet skal være UTF-8

8. Filen må ikke indeholde BOM markering

(Bemærk, at kravet i punkt 8 (BOM) vil blive fjernet, da dette har voldt problemer for visse systemer at kunne honorere. Der vil blive orienteret på DataHub hjemmesiden om tidspunkt for implementering af denne ændring. 2012-01-06/JGr)

6.2 Syntaks for header linjen

Den første linje i hver fil skal overholde nedenstående format. Linjen identificeres med "HDR" i første felt. I appendiks A ses en beskrivelse af de enkelte felter.

ALL_CONNECTION filen:

HDR|ALL_CONNECTION|<Netområde>|<Tid for dataudtræk>|<Migr.nr>|<Tekst> side 52 af 75


Version 1.0.

54


MASTERDATA filen:

HDR|MASTERDATA|<Netområde>|<Tid for dataudtræk>|<Migr.nr>|<Tekst>

METERDATA filen:

HDR|METERDATA|<Netområde>|<Tid for dataudtræk>|<Migr.nr>|<Tekst>


HDR|DELETE_CONNECTION|<Netområde>|<Tid for dataudtræk>|<Migr.nr>|<Tekst>

6.3 Syntaks for datalinjer

Datalinjerne i hver fil skal overholde nedenstående format. Linjerne identificeres med "DATA" i første felt. I appendiks B ses en beskrivelse af de enkelte felter.


DATA|<Målepunkt ID>


DATA|<Målepunkt ID>|<Netområde nr.>|<Gyldighedsdato>|<Årsagskode>|

<Målepunktstype>|<Tilslutningsstatus>|<Vejkode>|<Vejnavn>|<Husnummer>|<Etage>|

<Dørbetegnelse>|<Bynavn>|<Postnummer>|<Postdistrikt>|<Kommune>|

<Elleverandør ID>|<Start leverance (ellev)>|<Balanceansvarlig ID>|

<Start leverance (bal.ansv.)>|<Disponent 1>|<Fødselsdato 1>|<CVR>|

<Disponent 2>|<Fødselsdato 3>|<Årsforbrug>|<DE branchekode>|

<Afregningsform>|<Aflæsningsform>|<Aflæsningsdag 1>|

<Aflæsningsdag 2>|<Aflæsningsdag 3>|<Aflæsningsdag 4>|



<Aflæsningsdag 11>|<Aflæsningsdag 12>|<Forbrug over grænse tilladt>|

<Indsendelses-frekvens>|<Aflæsnings-frekvens>|<Fra netområde (udv)>|

<Til netområde (udv)>|<Nettoafregnings-gruppe>|<Målepunktsart>|

<Brændselsart>|<PSO-fritaget>|<VærkGSRN>|<Produkt>|<Enhed>


DATA|<Målepunkt ID>|<Start-tid>|<Slut-tid>|<Statuskode>|<Værdi>

DELETE_CONNECTION filen:

DATA|<Målepunkt ID>

6.4 Syntaks for footer linjen

Den sidste linje i hver fil skal overholde nedenstående format. Linjen identificeres med "FTR" i første felt. I appendiks C ses en beskrivelse af de enkelte felter.


FTR|<AntalDataLinjer>|<Sum MP ID>


FTR|< AntalDataLinjer >|<SumPostnumre>


FTR|< AntalDataLinjer >|<SumVærdi>

DELETE_CONNECTION filen:

FTR|< AntalDataLinjer >|<Sum MP ID> side 53 af 75


Version 1.0.

54


6.5 Eksempler på filer

ALL_CONNECTION:

HDR|ALL_CONNECTION|023|2011-11-07T15:43Z|00327|Test for 7 målepunkter

DATA|571313153100018072

DATA|570715000000061806

DATA|570715000000061813

DATA|570715000000061820

DATA|570715000000061837

DATA|570715000000061844

DATA|570715000000061851

FTR|7|5043

MASTERDATA:

HDR|MASTERDATA |023|2011-11-07T15:43Z|00327|Test indlæsning af stamdata

DATA|571313153100018072|023|2011-03-01|E32|E17|E22|8693|Tonne Kjærsvej|65A|…etc

DATA|570715000000061806|023|2011-03-01|E32|E17|E22|8693|Tonne Kjærsvej|1|…etc



FTR|4|34772

METERDATA:

HDR|METERDATA|023|2011-11-07T15:43Z|00327|Test indlæsningen af målinger

DATA|571313153100018072|2011-03-21T16:00Z|2011-03-21T17:00Z|E01|243.324

DATA|571313153100018072|2011-03-21T17:00Z|2011-03-21T18:00Z|E01|223.438

DATA|570715000000061806|2011-03-21T16:00Z|2011-03-21T17:00Z|E01|115.323

DATA|570715000000061806|2011-03-21T17:00Z|2011-03-21T18:00Z|E01|173.839

DATA|570715000000061806|2011-03-21T18:00Z|2011-03-21T19:00Z|E01|242.321

FTR|5|998.245

DELETE_CONNECTION:

HDR|DELETE_CONNECTION|023|2011-11-07T15:43Z|00327|Slet målepunkter

DATA|571313153100018072

DATA|570715000000061806

DATA|570715000000061813

DATA|570715000000061820

DATA|570715000000061837

DATA|570715000000061844

DATA|570715000000061851

FTR|7|5043 side 54 af 75

7 Feltbeskrivelse til filer

7.1 Felter i Header linjen (HDR)

Felt definition for header linje i ALL_CONNECTION / MASTERDATA / METERDATA / DELETE_CONNECTION:

Felt

Nr.

1

2

Felt Beskrivelse/validering Type Mandatory/

Optional

M

M

Eksempel

HDR

ALL_CONNECTION

3

4

5

6

Linjeidentifikation Skal være "HDR"

FilType Filtype. Værdier:

- ALL_CONNECTION

- MASTERDATA

- METERDATA

- DELETE_CONNECTION

Netområde

Tidspunkt for dataudtræk

Migr.nr

String(3)

String(17)

Netområdenummer (DE nummer)

Skal angives med evt. foranstillede nuller

String(3)

Tidspunkt for dataudtræk

Format: YYYY-MM-DDTHH:MMZ.

String(17)

Migreringsnummer.

Skal angives med 5 cifre (med foranstillede nuller), og skal være entydig for netområdet.

String(5)

Tekst Frit tekstfelt. Kan anvendes frit af netvirksomheden.

Teksten migreres ikke, men er kun tiltænkt som intern hjælp for netvirksomheden.

String(50)

M

M

M

O

023

2011-11-07T15:43Z

00001

Test data for migration


Version 1.0.4

Dato 13. april 2012

7.2 Felter i Data linjer (DATA)

Felt definition for DATA linjer i ALL_CONNECTION / DELETE_CONNECTION:

Felt

Nr.

1

2


Optional

Linjeidentifikation Skal være "DATA"

Målepunkt ID GSRN nummer til målepunktets identifikation.

Der foretages modulus kontrol på

GSRN nummeret.

String(4) M

Number(18) M

Eksempel

DATA

571313113161134029

Felt definition for DATA linjer i MASTERDATA:

Linjeid

1

Målepunkt

2

3

Felt nr Felt

4

5

6

Beskrivelse/validering Type


Målepunkt ID

Netområde nr.

Gyldighedsdato

Årsagskode

Målepunktstype

Målepunktsidentiifikation (GSRN nr)

String(4)

Number(18)

DE nummer på netområde, 3 cifre - med evt. foranstillet nul

Startdato for gyldighed af stamdata.

Format: yyyy-mm-dd.

String(3)

String(10)

Årsagskode for stamdataændring:

- E01 Flytning (Move)

- E02 Nyt målepunkt (New met. point)

- E03 Leverandørskifte (Chg. of bal. sup.)

- E32 Opd. af stamdata (Upd. mast. data)

- E75 Ændr.afr.form (Chg. met. method)

- E79 Ændr.tilsl.status(Chg. of conn. stat)

String(3)

Målepunktstype:

- E17 Forbrug (Consumption)

- E18 Produktion (Production)

String(3)

Forbrug (E17)

Skabelon (E01) Time

(E02)

Fjrn.afl

(D01)

Manuel

(D02)

M M M

M

M

M

M

M

M

Prod.

(E18)

Migreres af ENDK

Udv.

(E20)

Analyse

(D01,

D02,

D03)

Migreres af

ENDK

M M M DATA

Eksempel

M

M

M

M

M

M

571313113161134029

023

M

M

M

M

M

M

M

M

M

M

M

M

M

M

M

M

M

M

2011-03-01

E32

E17 side 56 af 75

Felt nr Felt

7

Målepunkt

Adresse

8

9

10

11

12

13

14

15

16

Marked

17

18

19

20

Kunde

21

22

23


- E20 Udveksling (Exchange)

- D01 (VE production) - kun Energinet.dk

- D02 (Technical) - kun Energinet.dk

- D03 (Own production) - kun Energinet

Tilslutningsstatus Status for målepunktet:

- E22 Tilsluttet (Connected)

- E23 Afbrudt (Disconnected)

- D01 Inaktivt (Inactive)

- D02 Nedlagt (Closed down)

- D03 Nyoprettet (New)

Vejkode Vejkode, 4 cifre: 000 10 - 9999.

Vejnavn Vejnavn – kan evt. angives til ”Ukendt”

String(3)

Number(4)

String(35)

Husnummer

Etage

Dørbetegnelse

Bynavn

Husnummer, evt. med bogstav

Etage. f.eks: st, 1., 2.

Dørbetegnelse, f.eks. th, tv, mf.

Angives, hvis forskellig fra postdistrikt

String(6)

String(2)

String(4)

String(25)

Postnummer

Postdistrikt

Kommune

Elleverandør ID

Postnummer 4 cifre: 0000 - 9999.

Postdistrikt - svarende til postnummer

Kommunenummer. 10 0 - 999.

GLN nummer på elleverandør

Start leverance

(ellev)

Start på leverance fra elleverandør

Format: yyyy-mm-dd.

Balanceansvarlig ID GLN nummer på balanceansvarlig

Start leverance

(bal.ansv.)

Disponent 1

Fødselsdato 1

CVR

Start på leverance fra balanceansvarlig

Format: yyyy-mm-dd.

Navn på primær disponent

Fødselsdato på disponent 1.

NULL hvis der er angivet CVR nummer.

Format: yyyy-mm-dd.

CVR nummer på disponent.

Number(4)

String(25)

Number(3)

String(13)

String(10)

String(13)

String(10)

String(35)

String(10)

String(8)

M

M

M

O

O

M

O

O

O

O

M

M

O

M

M


Version 1.0.4

Dato 13. april 2012

Eksempel Forbrug (E17)


(E02)

Fjrn.afl

(D01)

Manuel

(D02)

Prod.

(E18)

Migreres af ENDK

Udv.

(E20)

Analyse

(D01,

D02,

D03)

Migreres af

ENDK

M

O

M

M

M

M

O

O

M

O

O

O

O

M

M

O

M

M

O

M

M

M

M

O

O

M

O

O

O

O

M

M

O

M

M

O

M

M

M

M

O

O

M

O

O

O

O

M

M

O

M

M

O

M

O

M

O

O

O

O

M

M

O

M E22

O

M

O

O

O

O

M

M

O

8693

Tonne Kjærsvej

65A st th

Erritsø

7000

Fredericia

607

5790000013296

2011-02-01

5790001406530

2011-02-01

Energinet.dk

1967-06-17

28980671 side 57 af 75

Forbrug

Felt nr Felt

24

25

26

27

28

29

30

31

32

33

34

35


Disponent 2

Fødselsdato 3

Årsforbrug

DE branchekode

Afregningsform

Aflæsningsform

Aflæsningsdag 1

Aflæsningsdag 2

Aflæsningsdag 3

Aflæsningsdag 4

Aflæsningsdag 5

Aflæsningsdag 6

NULL hvis der er angivet fødselsdato.

8 digits: 10000000 - 99999999.

Navn på sekundær disponent

Fødselsdato på disponent 2.

NULL hvis der er angivet CVR nummer.

Format: yyyy-mm-dd.

String(35)

String(10)

Forventet årsforbrug i kWh, uden decimaler.

Værdi skal >= 0

DE branchekode.

Værdi: 0 - 999999.

Skabelon eller timeafregnet:

- E01 Skabelonafregnet (Profiled)

- E02 Timeafregnet (Non profiled)

Number(18)

Number(6)

String(3)

Fjernaflæst eller manuelt aflæst:

- D01 Fjernaflæst (Autom. meter reading)

- D02 Manuelt (Manual meter reading)

String(3)

Op til 12 datoer, hvor netvirksomheden vil foretage periodiske aflæsning til brug for afregning af kunden. Format: mmdd.

String(4)


String(4)


String(4)


String(4)


String(4)

Op til 12 datoer, hvor netvirksomheden vil String(4)


Version 1.0.4

Dato 13. april 2012



(E02)

Fjrn.afl

(D01)

Manuel

(D02)

Prod.

(E18)

Migreres af ENDK

Udv.

(E20)

Analyse

(D01,

D02,

D03)

Migreres af

ENDK

O

O

M

O

M

M

M

O

O

O

O

O

O

O

M

O

M

M

M

O

O

O

O

O

O

O

M

O

M

O

O

Åge Pedersen

1967-06-17

13200

211

E01

D02

0115

0215

0315

0415

0515

0615 side 58 af 75

Aflæsning

Felt nr Felt

36

37

38

39

40

41

42

43

44



Version 1.0.4

Dato 13. april 2012



(E02)

Fjrn.afl

(D01)

Manuel

(D02)

Prod.

(E18)

Migreres af ENDK

Udv.

(E20)

Analyse

(D01,

D02,

D03)

Migreres af

ENDK

Aflæsningsdag 7

Aflæsningsdag 8

Aflæsningsdag 9 foretage periodiske aflæsning til brug for afregning af kunden. Format: mmdd.


String(4)


String(4)

Op til 12 datoer, hvor netvirksomheden vil String(4) foretage periodiske aflæsning til brug for afregning af kunden. Format: mmdd.

Aflæsningsdag 10 Op til 12 datoer, hvor netvirksomheden vil foretage periodiske aflæsning til brug for afregning af kunden. Format: mmdd..

String(4)

Aflæsningsdag 11 Op til 12 datoer, hvor netvirksomheden vil foretage periodiske aflæsning til brug for afregning af kunden. Format: mmdd.

String(4)

Aflæsningsdag 12 Op til 12 datoer, hvor netvirksomheden vil foretage periodiske aflæsning til brug for afregning af kunden. Format: mmdd.

String(4)

Forbrug over grænse tilladt

Indsendelsesfrekvens

Angiver om forbrug må være over den obligatoriske grænse for timeafregning uden at ændre afregningsform:

- 1 (Ja)

- 0 (Nej)

Antal kalenderdage efter driftsdøgn, hvor aflæsninger indsendes til DataHub'en for det pågældende driftsdøgn.

Værdi: >= 0 og < 365.

Number(1)

Number(3)

Aflæsningsfrekvens

Den tidsopløsning hvormed målepunktet aflæses.

- PT15M (Kvarter)

- PT1H (Time)

- P1M (Måned) - kun Energinet

String(5)

O

O

O

O

O

O

M

M

O

O

O

O

O

O

M

0715

0815

0915

1015

1115

1215

0

30

M

P1M,

PT1H,

ANDET

M

ANDET

M

PT1H

M

PT1H,

PT15M

M

PT1H,

PT15M

M

PT1H,

PT15M

PT1H

Formateret: Skrifttype: Kursiv

Formateret: Skrifttype: Kursiv,

Skriftfarve: Automatisk







Formateret: Skrifttype: Kursiv side 59 af 75


Version 1.0.4

Dato 13. april 2012

Felt nr Felt Beskrivelse/validering Type Forbrug (E17)


(E02)

Fjrn.afl

(D01)

Manuel

(D02)

Prod.

(E18)

Migreres af ENDK

Udv.

(E20)

Analyse

(D01,

D02,

D03)

Migreres af

ENDK

Udveksling

45

46

Fra netområde

(udv)

Til netområde

(udv)

Nettoafregningsgruppe

- Andet

Netområde hvorfra udvekslingen sker

Netområde hvortil udvekslingen sker

String(3)

String(3)

M

M

Nettoafregnet

47

Produktion

48

49

Målepunktsart

Brændselsart

Nettoafregningsgruppe

Værdi: 0 - 6

For nettoafregnede anlæg angives målepunktstypen. Værdier:

- M0

- M1

- M2

- M3

Anvender værket miljøvenlig brændsel

- 0 (Nej)

- 1 (Ja)

Number(1)

String(2)

Number(1)

M M M M

Måleenhed

50

51

52

53

PSO-fritaget

VærkGSRN

Produkt

Enhed

Er værkets egenproduktion fritaget for

PSO afgift.

- 0 (Nej)

- 1 (Ja)

Energiprodukt kode.

- 8716867000030 (Aktiv energi)

- 8716867000047 (Reaktiv energi)

Number(1)

Produktionsmåling. Værkets/møllens

GSRN nr. som angivet i stamdataregistret.

Number(18)

Number(13)

Måleenhed:

- KWH (kWh)

K3 (kVArh)

String(3)

M

M

M

M

M

M

M

M

M

En mere detaljeret beskrivelse af indholdet i de enkelte felter, kan ses I "Pseudo-Forskrift I" - der kan findes på DataHub portalen.

M

M

023

032

0

D03: MO M0

D03: MO 0

D03: MO 0

D03: MO 570715000000088667

M

M KWH

Eksempel

8716867000030 side 60 af 75

Felt definition for DATA linjer i METERDATA:

Felt

Nr.

1

2

3

4

5

6

Felt Beskrivelse/validering


Målepunkt ID Målepunkt ID (GSRN nr)

Start-tid

Slut-tid

Statuskode

Værdi

Starttidspunkt for måling, angivet i UTC+0.


Sluttidspunkt for måling, angivet i UTC+0.


Statuskode for måleværdi.

Værdier:

- 56 (Estimeret)

- E01 (Registreret/Målt)

Målt værdi.

Decimaltal angives med "." som decimalseparator, og uden tusindeadskillelse

Værdi skal >= 0.

Type

String(4)

Number(18)

String(17)

String(17)

String(3)

Mandatory/

Optional

M

M

M

M

M

Number(10,3) M

Eksempel

DATA

571313113161134029

2011-03-21T16:00Z

2011-03-21T17:00Z

E01

72234.328

7.3 Felter i Footer linjen (FTR)

Felt definition for FTR linjer i ALL_CONNECTION / DELETE_CONNECTION file:

Felt

Nr.

1

2

3

Felt Beskrivelse/validering Type

Linjeidentifikation Skal være "FTR"

AntalDataLinjer

Sum MP ID

Antal datalinjer i filen ("DATA")

Sum af de sidste 3 cifre i alle

GSRN numer (målepunkt ID)

String(3)

Number(7) M

Number(20) M

Mandatory/

Optional

M

Eksempel

FTR

7

5043


Version 1.0.4

Dato 13. april 2012 side 61 af 75

Felt

Nr.

1

2

3

Felt definition for FTR linjer i MASTERDATA:

Felt

Nr.

1

2

3

Felt Beskrivelse/validering

Felt definition for FTR linjer i METERDATA:

Type Mandatory/

Optional


AntalDataLinjer

SumPostnumre


Sum af alle postnumre,

String(3)

Number(7)

Number(20)

M

M

M

Eksempel

FTR

4

34772


Optional


AntalDataLinjer

SumVærdi


Sum af alle værdier

String(3)

Number(7)

M

M

Number(25,3) M

Eksempel

FTR

4

998.245


Version 1.0.4

Dato 13. april 2012 side 62 af 75


Version 1.0.4

Dato 13. april 2012

Appendix A – Fejlkoder ved validering, DM

Error Code

DM-001

DM-002

DM-101

DM-102

DM-103

DM-104

DM-105

DM-106

DM-107

DM-108

DM-109

DM-110

DM-111

DM-112

Validation File Type

Check whether all the files are in UTF-8.

Check whether the records are ended with the correct delimiter.

There is one header record present.

The header record is not in the right format.

ALL_CONNECTION,

MASTERDATA, METERDATA,

DELETE_CONNECTION

ALL_CONNECTION,


DELETE_CONNECTION

ALL_CONNECTION,


DELETE_CONNECTION

ALL_CONNECTION,


DELETE_CONNECTION

There is no data record present.

There is one footer record present.

ALL_CONNECTION,


DELETE_CONNECTION

ALL_CONNECTION,


DELETE_CONNECTION

The footer record is not in the right format. ALL_CONNECTION,


DELETE_CONNECTION

The grid area in the header is different from the grid area in the file name.

ALL_CONNECTION,


DELETE_CONNECTION

The grid area in the body is different from the grid area in the file name.

MASTERDATA

The run number in the header is different from the run number in the file name.

The number of records in the footer is not the same as the actual number of records in the file.

The sum of the last three numbers of the

GSRN’s is not the same as the checksum for the sum in the footer of the file.

The sum of the postal codes is not the same as the checksum for postal codes in the footer of the file.

The sum of the quantities is not the same

ALL_CONNECTION,


DELETE_CONNECTION

ALL_CONNECTION,


DELETE_CONNECTION

ALL_CONNECTION,

DELETE_CONNECTION

MASTERDATA

METERDATA

Error Message

File <filename> is not UTF-8.

File <filename> has records that are not ended with a carriage return / linefeed (CR / LF).

There is no or more than one header record present.

The header record is not in the right format.

There is no data record present.

There is no or more than one footer record present.

The footer record in file is not in the right format.

The grid area <header.MeteringGridAreaIdentification> in the header is not the same as the grid area <METERING_GRID_AREA_IDENTIFICATION> in the file name.

The grid area <body.MeteringGridAreaIdentification> in the body is not the same as the grid area <METERING_GRID_AREA_IDENTIFICATION> in the file name.

The run number <header.RunNr> in the header is not the same as the run number <RUNNR> in the file name.

In file the number of records <footer.NumberOfRecords> in the footer is not the same as the actual number of records <file.NumberOfRecords> in the file.

The sum of the last three numbers of the GSRN’s <sum of all GSRNs> is not the same as the checksum for GSRN’s <footer.SumMeteringPointIds> in the footer of the file.

The sum of the postal codes <sum of all postcodes> is not the same as the checksum for postal codes <footer.SumPostcodes> in the footer of the file.

The sum of the quantities <sum of all quantities> is not the same as the side 63 af 75

DM-123

DM-201

DM-202

DM-203

DM-205

DM-206

DM-116

DM-117

DM-119

DM-120

DM-121

DM-122

Error Code

DM-113

DM-114

DM-115

Validation as the checksum for quantities in the footer of the file.

The length of an attribute in the file is longer than the maximum length specified in the file definition for the body.

The type of an attribute in the file is not conforming to the type specified in the file definition for the body.

The metering point ID holds 18 digits, the last digit contains the checksum of the preceding 17 digits, i.e. sum(odd x 3, even x 1) mod 10.

The start or end time of a meter data record is not conform format YYYY-MM-

DDTHH:MMZ.

The metering point ID in the file has to be unique.

The combination of metering point ID and start time has to be unique.

The combination of metering point ID and end time has to be unique.

An attribute in the file is mandatory in the file definition for the body.

File Type

ALL_CONNECTION,


DELETE_CONNECTION

ALL_CONNECTION,


DELETE_CONNECTION

ALL_CONNECTION

METERDATA

ALL_CONNECTION,

DELETE_CONNECTION

METERDATA

METERDATA

There must be files present to process.

The combination of a

DELETE_CONNECTION file and one or more of the other files is not allowed.

Metering point is imported by the same grid operator as before.

Metering point is imported by another grid operator as well.

Metering point in the MASTERDATA file has not been delivered in ALL_CONNECTION file yet (or has been deleted in the past).

Type of metering point in the MASTERDATA file should not be changed.

The occurrence of the new connection state of a metering point in the MASTERDATA file should not be before the occurrences of the already present connection states in the

ALL_CONNECTION,


DELETE_CONNECTION

ALL_CONNECTION,


DELETE_CONNECTION

DELETE_CONNECTION

ALL_CONNECTION

ALL_CONNECTION

MASTERDATA

MASTERDATA

MASTERDATA


Version 1.0.4

Dato 13. april 2012

Error Message checksum for quantities <footer.SumQuantities> in the footer of the file.

The length of attribute <attribute name> is longer than the maximum length specified in the file definition for the body.

The type of the attribute <attribute name> is different from the type of the of the attribute specified in the file definition for the body.

The metering point ID <MeteringPointId> specified is not a valid GSRN /

EAN18 code (wrong checksum).

The attribute <attribute name> of metering point ID <MeteringPointId> is not in format YYYY-MM-DDTHH:MMZ.

The metering point ID <MeteringPointId> is not unique in the file.

The metering point ID <MeteringPointId> and start time <StartTime> is not unique in the file.

The metering point ID <MeteringPointId> and end time <EndTime> is not unique in the file.

The attribute <attribute name> is mandatory in the file definition for the body.*

There are no files present for run number <RUNNR> and grid area

<METERING_GRID_AREA_IDENTIFICATION> to process.**

In a run a combination of a DELETE_CONNECTION file and one or more of the other files is not allowed.**

Metering point <MeteringPointId> in ALL_CONNECTION has already been delivered by the same grid operator.

Metering point <MeteringPointId> in ALL_CONNECTION has already been delivered by grid operator <GridOperatorId>.

Metering point <MeteringPointId> in the MASTERDATA file has not been delivered in ALL_CONNECTION file or has been deleted. The records for this metering point will be rejected.

The type of metering point <TypeOfMP> of metering point

<MeteringPointId> in the MASTERDATA file must not be changed.

The occurrence <Occurrence> of the new connection state of metering point <MeteringPointId> in the MASTERDATA file may not be before the occurrence <Occurrence>* of the already present connections states in the migration area. side 64 af 75

Error Code

DM-208

DM-209

DM-211

DM-213

DM-214

DM-216

DM-217

DM-218

DM-219

DM-220

DM-221

DM-223

DM-224

Validation File Type migration area.

Metering point in the METERDATA file has not been delivered in ALL_CONNECTION file yet (or has been deleted in the past).

No MASTERDATA available for this metering point between start and end date of meter data.

Metering point is not yet present, therefore it cannot be deleted.

The metering grid area of a metering point must belong to the correct grid operator.

METERDATA

METERDATA

DELETE_CONNECTION

DELETE_CONNECTION

The metering point has been delivered by another grid operator.

DELETE_CONNECTION

The start time for meter data is mandatory. METERDATA

The end time for meter data is mandatory.

The meterdata number of values for a time serie doesn't match the meter reading occurrence of the master data mentioned for a Non Profiled Consumption, Production,

Exchange and Analyse Meteringpoints where MeterReadingOccurrence is PT1H or

PT15M.The meter data number of values for a time serie doesn't match the meter reading occurrence of the master data

The quantity status for meter data is mandatory.

The quantity status for meter data has domain values 56 (Estimated), E01

(Registered).

The energy quantity for meter data is mandatory.

METERDATA

METERDATAMETERDATA

METERDATA

METERDATA

METERDATA

Overlap in meter data periods is not allowed METERDATA

The end time for meter data cannot be in the future.

METERDATA

Error Message

Metering point <MeteringPointId> in the METERDATA file has not been delivered in ALL_CONNECTION file or has been deleted. The records for this metering point will be rejected.

No MASTERDATA available for <MeteringPointId> between start and end date of meter data. The records delivered in the METERDATA file for this metering point will be rejected.**

Metering point <MeteringPointId> is not yet present, therefore it cannot be deleted.

Metering grid area <MeteringGridAreaIdentification> for metering point

<MeteringPointId> doesn't belong to grid operator <GridOperatorId>.***

The metering point <MeteringPointId> has been delivered by another grid operator <GridOperatorId>.


Version 1.0.4

Dato 13. april 2012

Meter data start time is missing for metering point <MeteringPointId>.

Meter data end time is missing for metering point <MeteringPointId>.

The meter data number of values for a time series doesn't match the meter reading occurrence for metering point <MeteringPointId> with

MeterReadingOccurrence <MeterReadingOccurrence>The meter data number of values for a time series doesn't match the meter reading occurrence for metering point <MeteringPointId>.

Meter data quantity status is missing for metering point <MeteringPointId>.

Meter data quantity status <QuantityStatus> for metering point

<MeteringPointId> has wrong value (outside domain).

Meter data energy quantity is missing for metering point

<MeteringPointId>.

Meter data record for MeteringPoint <MeteringPointId> and <StartTime> is rejected. There is already a record present with an overlapping period.

The end time for meter data record for MeteringPoint <MeteringPointId> and start time <StartTime> is rejected. The end time <EndTime> is in the future. side 65 af 75

Error Code

DM-226

DM-227

DM-228

DM-229

DM-230

DM-231

DM-232

DM-233

DM-234

DM-235

DM-236

DM-237

DM-301

DM-302

DM-303

Validation

The combination of metering point ID, occurrence and EnergyBusinessProcess has to be unique

The minimal meterdata period between

Starttime and Endtime for a profiled consumption must be 1 day

No Meterdata expected for a VE Production or Technical meteringpoint with

MeterReadingOccurrence P1M

The energy quantity must not be a negative number

No Meterdata expected for a Meteringpoint

State which has a physical status 'New' or

'Closed Down'

The meterdata StartTime should be 22:00 or 23:00

The meterdata EndTime should be 22:00 or

23:00

Meterdata for a profiled consumption meteringpoint must not contain decimals

File Type

MASTERDATA

METERDATA

METERDATA

METERDATA

METERDATA

METERDATA

METERDATA

METERDATA

Meterdata for a profiled consumption meteringpoint must be plausible (i.e. value less than 10.000.000)

Meterdata for a non-profiled consumption meteringpoint must be plausible (i.e. value less than 10.000)

Meterdata for a production or exchange meteringpoint must be plausible (i.e. value less than 1.000.000)

The delivered Meterdata has a period which will not be migrated to DataHub, because the limit of historical data is max 1,5 year

METERDATA

METERDATA

METERDATA

METERDATA


Version 1.0.4

Dato 13. april 2012

Error Message

The combination of meteringpoint ID, occurrence and

EnergyBusinessProcess has to be unique

The meterdata period is not at least 1 day for meteringpoint

<MeteringPointID> with starttime <StartTime> and endtime <EndTime>

Unexpected meterdata available for meteringpoint ID <MeteringPointID> with type: <TypeOfMP>.

Meteringpoint <MeteringPointId> with start time <StartTime> has a negative EnergyQuantity: <EnergyQuantity>.

Unexpected Meterdata for meteringpoint <MeteringPointId> with occurrence <Occurrence> and PhysicalStatusOfMP <PhysicalStatusOfMP>.

The Meterdata start time <StartTime> is not 22:00 or 23:00 for metering point <MeteringPointId> with type <TypeOfMP>.

The Meterdata end time <EndTime> is not 22:00 or 23:00 for metering point <MeteringPointId> with type <TypeOfMP>.

Meterdata with start time <StartTime> and end time <EndTime> for metering point <MeteringPointId> has a EnergyQuantity value with decimals

The EnergyQuantity <EnergyQuantity> is not less than 10.000.000 for meteringpoint <MeteringPointID> with starttime <StartTime>

The EnergyQuantity <EnergyQuantity> is not less than 10.000 for meteringpoint <MeteringPointID> with starttime <StartTime>

The EnergyQuantity <EnergyQuantity> is not less than 1.000.000 for meteringpoint <MeteringPointID> with starttime <StartTime>

The following meterdata period will not be migrated to DatHub, <<starttime>> - <<end-time>> and will have a status 'Not Used'

The combination of run number <Run Number> and grid area <Grid Area> must be unique for the grid operator.

There are no files present for run number <Run Number> and grid area

<Grid Area> to process.

In a run a combination of a DELETE_CONNECTION file and one or more of the other files is not allowed. side 66 af 75

Error Code

DM-304

DM-305

DM-307

DM-308

DM-310

DM-311

DM-312

Validation File Type


Version 1.0.4

Dato 13. april 2012

Error Message

There is already a run being processed for grid area <Grid Area>*.

The grid area doesn’t belong to the grid operator.

The grid area doesn’t belong to the grid operator.

The grid area has been delivered by another grid operator.

The migration period has ended. It is not allowed to start a new run.

The migration period has ended, it is not allowed to do a reset.

The given run number must contain in total 5 digits. side 67 af 75

Appendix B – Fejlkoder ved validering, VAL

Rule

Number

Rule Description Attribute

VAL-001 The identification of a metering point is mandatory

MeteringPointId

VAL-002 The identification of a metering point is a valid

GSRN/EAN18 code (checksum) that starts with digits '57'

MeteringPointId

VAL-003 The identification of a metering point is unique within CCR (also historically)

MeteringPointId

MeteringGridAreaId VAL-004 The metering grid area of a metering point is mandatory

VAL-005 The metering grid area of a metering point must be an existing metering grid area

MeteringGridAreaId

VAL-006 The metering grid area of a metering point must belong to the correct grid operator

VAL-007 The occurrence of a metering point is mandatory

MeteringGridAreaId

GridOperatorId

Occurrence

VAL-008 The occurrence of a metering point has format

YYYY-MM-DD

Occurrence

VAL-009 The energy business process of a metering point is mandatory

EnergyBusinessProcess

VAL-010 The energy business process of a metering point has domain values E01 (Move), E02

(New metering point), E03 (Change of balance supplier), E32 (Update of master data), E75

(Change of metering method), E79 (Change of connection status)

EnergyBusinessProcess

VAL-011 The type of a metering point is mandatory TypeOfMP

TypeOfMP VAL-012 The type of a metering point has domain values E17 (Consumption), E18 (Production),

E20 (Exchange), D01 (VE production), D02

(Technical), D03 (Own production)

VAL-013 The physical status of a metering point is mandatory

VAL-014 The physical status of a metering point has domain values D01 (Inactive), D02 (Closed

PhysicalStatusOfMP

PhysicalStatusOfMP

Rule Type

Obligation

Calculation

Reference

Obligation

Reference

Reference

Obligation

Format

Obligation

Domain

Obligation

Domain

Obligation

Domain

Explanation


Version 1.0.4

Dato 13. april 2012

A metering point cannot be registered in CCR without a valid identification

A GSRN code holds 18 digits, the first 2 digits are '57', the last digit contains the checksum of the preceeding 17 digits, i.e. sum(odd x 3, even x 1) mod 10

Two distinct metering points never have (or had) the same identification, even if one of them already has been closed down in or removed (archived) from CCR

A metering point cannot be registered in CCR without a valid metering grid area

Only registered metering grid areas are allowed

Metering grid areas are owned by (assigned to) a specific grid operator.

A metering point cannot be registered in CCR without a valid occurrence

Date format is '<year (4 digits)>-<month (2 digits)>-<day (2 digits)>', so length is restricted to 10

A metering point cannot be registered in CCR without a valid energy business process

Only specific domain values are allowed

A metering point cannot be registered in CCR without a valid metering point type


A metering point cannot be registered in CCR without a valid physical status

Only specific domain values are allowed side 68 af 75

Rule

Number


down), D03 (New), E22 (Connected), E23

(Disconnected)

VAL-015 The street code of a metering point consists of exactly 4 digits (if available)

StreetCode

StreetName VAL-016 The street name of a metering point consists of maximal 35 characters (if available)

VAL-017 The building number of a metering point consists of maximal 6 characters (if available)

BuildingNumber

VAL-018 The floor identification of a metering point consists of maximal 24 characters (if available)

FloorId

RoomId VAL-019 The room identification of a metering point consists of maximal 4 characters (if available)

VAL-020 The city name of a metering point is mandatory

CityName

VAL-021 The city name of a metering point consists of maximal 25 characters

CityName

VAL-022 The post code of a metering point is mandatory

VAL-023 The post code of a metering point consists of exactly 4 digits

VAL-024 The city sub division name of a metering point consists of maximal 25 characters (if different from city name)

PostCode

PostCode

CitySubDivisionName

VAL-025 The post office box of a metering point consists of exactly 4 digits

VAL-026 The municipality code of a metering point consists of maximal 4 digits (if available)

VAL-027 The country name of a metering point is mandatory

VAL-028 The country name of a metering point has domain values DK (Denmark)

PostOfficeBox

MunicipalityCode

CountryName

CountryName

VAL-029 The grid operator of a metering point is mandatory

GridOperatorId

VAL-030 The grid operator of a metering point is a valid

GLN/EAN13 code (checksum)

GridOperatorId

VAL-031 The grid operator of a metering point must be GridOperatorId

Rule Type Explanation


Version 1.0.4

Dato 13. april 2012

Format

Format

Format

Format

Format

Obligation

Format

Obligation

Format

Format

Only digits are allowed, length is restricted to 4

All characters are allowed, length is restricted to 35

Only digits and letters are allowed, length is restricted to 6



A metering point cannot be registered in CCR without a valid city name


A metering point cannot be registered in CCR without a valid post code



Format

Obligation

Domain

Obligation

Calculation

Reference



A metering point cannot be registered in CCR without a valid country name


A metering point cannot be registered in CCR without a valid grid operator

A GLN code holds 13 digits, the last digit contains the checksum of the preceeding 12 digits, i.e. sum(odd x 1, even x 3) mod 10

Only registered and active grid operators are allowed side 69 af 75


Version 1.0.4

Dato 13. april 2012

Rule

Number

Rule Description Attribute Rule Type Explanation

an existing and active market party (company)

VAL-032 The supplier of a metering point is mandatory BalanceSupplierId

TypeOfMP

VAL-033 The supplier of a metering point is a valid

GLN/EAN13 code (checksum)

BalanceSupplierId

VAL-034 The supplier of a metering point must be an existing and active market party (company) on the effectuation date

BalanceSupplierId

Occurrence

VAL-035 The supply start of a metering point is mandatory

VAL-036 The supply start of a metering point has format YYYY-MM-DD

VAL-037 The balance responsible party of a metering point is mandatory

VAL-038 The balance responsible party of a metering point is a valid GLN/EAN13 code (checksum)

SupplyStart

TypeOfMP

SupplyStart

BalanceResponsiblePartyId

TypeOfMP

Obligation

Dependancy

Calculation

Reference

Obligation

Format

Obligation

Dependancy

BalanceResponsiblePartyId Calculation

A metering point cannot be registered in CCR without a valid balance supplier


Only registered and active balance suppliers are allowed

A metering point cannot be registered in CCR without a valid supply start


A metering point cannot be registered in CCR without a valid balance responsible party

VAL-039 The balance responsible party of a metering point must be an existing and active market party (company) on the effectuation date

BalanceResponsiblePartyId Reference

VAL-040 The supply start balance responsible party of a metering point is mandatory

SupplyStartBalanceRespon sibleParty

TypeOfMP

VAL-041 The supply start balance responsible party of a metering point has format YYYY-MM-DD

SupplyStartBalanceRespon sibleParty

Obligation

Format

VAL-042 The first consumer party name is mandatory for a new, connected or disconnected metering point

FirstConsumerPartyName

TypeOfMP

PhysicalStatus

Obligation

Dependancy

FirstConsumerPartyName Format VAL-043 The first consumer party name of a metering point consists of maximal 35 characters

VAL-044 The first consumer party reference of a metering point has format YYYY-MM-DD (if available)

FirstConsumerPartyReferen ce

Format


Only registered and active balance responsible parties are allowed

A metering point cannot be registered in CCR without a valid supply start balance responsible party


A metering point cannot be registered in CCR without a valid first consumer party name



VAL-045 The first consumer party reference of a metering point is empty if the consumer CVR is available


ConsumerCVR

VAL-046 The consumer CVR of a metering point consists of exactly 8 digits in the range

ConsumerCVR

Dependancy Only one of the three attributes is required

Format Only digits are allowed, length is restricted to 8 side 70 af 75


Version 1.0.4

Dato 13. april 2012

Rule

Number


10000000..99999999 (if available)

VAL-047 The consumer CVR of a metering point is empty if the first consumer party reference or the second consumer party reference is available

VAL-048 The second consumer party name of a metering point consists of maximal 35 characters (if available)

ConsumerCVR


SecondConsumerPartyNam e

VAL-049 The second consumer party reference of a metering point has format YYYY-MM-DD (if available)

SecondConsumerPartyRefe rence

VAL-050 The second consumer party reference of a metering point is empty if the consumer CVR is available


ConsumerCVR

VAL-051 The estimated annual volume of a metering point is mandatory

VAL-052 The estimated annual volume of a metering point consists of maximal 18 digits

EstimatedAnnualVolume

TypeOfMP

EstimatedAnnualVolume

VAL-053 The consumer category of a metering point consists of maximal 4 digits (if available)

VAL-054 The settlement method of a metering point is mandatory

ConsumerCategory

SettlementMethod

TypeOfMP

VAL-055 The settlement method of a metering point has domain values E01 (Profiled), E02 (Non profiled)

SettlementMethod


Format

Format

Obligation

Dependancy

Domain



Obligation

Dependancy

Format

Format


A metering point cannot be registered in CCR without a valid estimated annual volume



A metering point cannot be registered in CCR without a valid settlement method


VAL-056 The reading characteristics of a metering point is mandatory for a profiled metering point

MPReadingCharacteristics

SettlementMethod*

Obligation

Dependancy

VAL-057 The reading characteristics of a metering point has domain values D01 (Automatic), D02

(Manual)

MPReadingCharacteristics Domain

VAL-058 The first scheduled meter reading date of a metering point is mandatory for a profiled metering point

VAL-059 The scheduled meter reading date of a metering point has format MMDD

ScheduledMeterReadingDat e1

SettlementMethod*


…

ScheduledMeterReadingDat

Obligation

Dependancy

Format

A profiled metering point cannot be registered in CCR without valid reading characteristics


A profiled metering point cannot be registered in CCR without any valid scheduled meter reading date

Date format is '<month (2 digits)><day (2 digits)>', so length is restricted to 4 side 71 af 75


Version 1.0.4

Dato 13. april 2012

Rule

Number

Rule Description Attribute Rule Type

VAL-060 The consumption overrun allowed of a metering point is mandatory for a profiled metering point

VAL-061 The consumption overrun allowed of a metering point has domain values 1 (Yes), 0

(No)

VAL-062 The submission delay of a metering point is mandatory for an automatic metering point

VAL-063 The submission delay of a metering point has format DDD

VAL-064 The meter reading occurrence of a metering point is mandatory for a non consumption metering point

VAL-065 The meter reading occurrence of a metering point is mandatory for an automatic consumption metering point

VAL-066 The meter reading occurrence of a metering point has domain values PT15M (Every 15 minutes), PT1H (Every hour), P1M (Every month), P1Y (Every year), ANDET (Other)

VAL-067 The source metering grid area of a metering point is mandatory

VAL-068 The source grid area of a metering point must be an existing metering grid area e12

ConsumptionOverrunAllowe d

SettlementMethod*

ConsumptionOverrunAllowe d

SubmissionDelay

MPReadingCharacteristics*

SubmissionDelay

MeterReadingOccurrence

TypeOfMP


MPReadingCharacteristics*


FromGridAreaId

TypeOfMP

FromGridArea

VAL-069 The target metering grid area of a metering point is mandatory

VAL-070 The target grid area of a metering point must be an existing metering grid area

VAL-071 The net settlement group of a metering point is mandatory

VAL-072 The net settlement group of a metering point has domain values 0, 1, 2, 3, 4, 5, 6

ToGridAreaId

TypeOfMP

ToGridAreaId

NetSettlementGroup

TypeOfMP

NetSettlementGroup

VAL-073 The power plant of a metering point is mandatory

PowerPlantGSRN

TypeOfMP

VAL-074 The power plant of a metering point is a valid

GSRN/EAN18 code (checksum) that starts with

PowerPlantGSRN

Obligation

Dependancy

Domain

Obligation

Dependancy

Format

Obligation

Dependancy

Obligation

Dependancy

Domain

Obligation

Dependancy

Reference

Obligation

Dependancy

Reference

Obligation

Dependancy

Domain

Obligation

Dependancy

Calculation

Explanation

A profiled metering point cannot be registered in CCR without a valid consumption overrun allowed


An automatic metering point cannot be registered in CCR without a valid submission delay

Delay format is '<day (3 digits)>', so length is restricted to maximal 3

A non consumption metering point cannot be registered in CCR without a valid meter reading occurrence

An automatic consumption metering point cannot be registered in CCR without a valid meter reading occurrence


An exchange metering point cannot be registered in CCR without a valid source metering grid area

Only registered from grid areas are allowed

An exchange metering point cannot be registered in CCR without a valid target metering grid area

Only registered to grid areas are allowed

A metering point cannot be registered in CCR without a valid net settlement group


A metering point cannot be registered in CCR without a valid power plant

A GSRN code holds 18 digits, the first 2 digits are '57', the last digit contains the checksum of the preceeding 17 digits, i.e. sum(odd x 3, even x 1) mod 10 side 72 af 75


Version 1.0.4

Dato 13. april 2012

Rule

Number


digits ´57´

VAL-075 The physical indication of a metering point is mandatory

PhysicalMeteringPoint

VAL-076 The physical indication of a metering point has domain values 1 (Yes), 0 (No)

PhysicalMeteringPoint

VAL-077 The product of a metering point is mandatory Product

VAL-078 The product of a metering point has domain values 8716867000030 (Active energy),

8716867000047 (Reactive energy)

Product

FuelType VAL-079 The fuel type of a metering point has domain values 1 (Environmentally friendly), 0 (Not environmentally friendly)

VAL-080 The PSO exempt of a metering point has domain values 1 Yes), 0 (No)

PSOExempt

VAL-081 The sub type of a metering point has domain values M0 (Consumption), M1 (Net generation), M2 (Supply from grid), M3

(Supply to grid)

MeteringPointSubType

Obligation

Domain

Obligation

Domain

Domain

Domain

Domain

A metering point cannot be registered in CCR without a valid physical indication


A metering point cannot be registered in CCR without a valid product





VAL-082 The energy time series measure unit of a metering point is mandatory

VAL-084 The street name of a metering point is mandatory

EnergyTimeSeriesMeasureU nit

Obligation

VAL-083 The energy time series measure unit of a metering point has domain values KWH (kWh),

K3 (kVArh)


Domain

StreetName Obligation

VAL-085 The first consumer party reference of a metering point is empty if the first consumer party name is not available



A metering point cannot be registered in CCR without a valid energy time series measure unit


A metering point cannot be registered in CCR without a valid street name

Dependency Consumer reference cannot exist without consumer name

VAL-086 The second consumer party name of a metering point is empty if the first consumer party name is not available



Dependency Second consumer cannot exist without first consumer

VAL-087 The second consumer party reference of a metering point is empty if the second consumer party name is not available


SecondConsumerPartyNam

Dependency Consumer reference cannot exist without consumer name side 73 af 75


Version 1.0.4

Dato 13. april 2012

Rule

Number


e

VAL-089 Only a profiled metering point can have up to

12 scheduled meter reading dates ScheduledMeterReadingDat e1..12

TypeOfMP/SettlementMeth od

Obligation

Dependency


TypeOfMP/MPReadingChara cteristics/

SettlementMethod

Domain

Dependency

Value only allowed when additional condition(s) met, i.e. metering points that are not profiled (or not consumption) do not have any scheduled meter reading dates at all

VAL-090 The 2nd to 12th scheduled meter reading dates of a metering point are empty if the first scheduled meter reading date is not available


ScheduledMeterReadingDat e2..12

VAL-091 The meter reading occurrence of an hourly settled (consumption) metering point must be

PT1H (Every hour)


TypeOfMP/SettlementMeth od

Dependency Value only allowed when additional condition(s) met, i.e. multiple scheduled meter reading dates may only occur when the first reading date is available

Domain

Dependency

Only a subset of the available domain values is allowed

VAL-092 The meter reading occurrence of a manual profile settled (consumption) metering point must be ANDET (Other)

Only a subset of the available domain values is allowed

VAL-093 The physical indication of a newly established metering point has default value 1 (Yes) PhysicalMeteringPoint

PhysicalStatusOfMP

Default Default value to be used for new metering point (not available in RSM-007)

VAL-094 The product of a newly established metering point has default value 8716867000030

(Active energy)

VAL-096 The energy time series measure unit of a newly established metering point has default value KWH (kWh)

Product

PhysicalStatusOfMP

Default


Domain

VAL-098

The second consumer party name of a metering point is empty if the consumer CVR is available


ConsumerCVR

VAL-101 The start date time for meter data is mandatory

StartDatetime

VAL-102 The start date time for meter data has format

YYYY-MM-DDTHH:MMZ

StartDatetime

Dependency

-

Obligation

Format

Default value to be used for new metering point (not available in RSM-007)


Only allowed if no consumer CVR available

Meter data cannot be registered in CCR without a valid start date time

Time format is '<year (4 digits)>-<month (2 digits)>-<day (2 digits)>T<hour (2 digits)>:<minutes (2 digits)>Z', so length is restricted to 17 side 74 af 75

Rule

Number


VAL-103 The end date time for meter data is mandatory EndDatetime

VAL-104 The end date time for meter data has format

YYYY-MM-DDTHH:MMZ

VAL-105 The number of values for a meter data time series doesn't match the meter reading occurrence of the master data

VAL-106 The energy quantity for meter data is mandatory

EndDatetime

StartDatetime

EndDatetime


EnergyQuantity

VAL-107 The energy quantity for meter data consists of maximal 10 digits

EnergyQuantity

Rule Type

Obligation

Format

Reference

Obligation

Format

Obligation

Domain

VAL-108 The quantity quality for meter data is mandatory

VAL-240

QuantityQuality

VAL-109 The quantity quality for meter data has domain values 56 (Estimated), E01 (Measured)

QuantityQuality

The measure unit of a profiled consumption data reading must be KWH (kWh)

Forbrug (E17)

VAL-283

VAL-284

VAL-285

The meter reading occurrence of an automatic profile settled metering point must be P1Y,

P1M, PT1H or ANDET

The meter reading occurrence of a metering point must be PT1H or PT15M

Forbrug (E17)

Produktion (E18)

Udveksling (E20)

Netto (D03)

The meter reading occurrence of a metering point must be P1M, PT1H or PT15M

Teknisk (D02)

VE (D01)

The fuel type of a metering point is mandatory Netto (D03)

VAL-286

VAL-287

The PSO exempt of a metering point is mandatory

Netto (D03)

The sub type of a metering point is mandatory Netto (D03)

VAL-288

Formateret


Version 1.0.4

Dato 13. april 2012

Formateret

Formateret

Formateret

Formateret

Explanation

Formateret

Meter data cannot be registered in CCR without a valid end date time

Formateret

Time format is '<year (4 digits)>-<month (2 digits)>-<day (2 digits)>T<hour (2 digits)>:<minutes (2 digits)>Z', so length is restricted to 17

Formateret

Formateret

E.g. for a normal day 1 day will typically contain 24 values when the meter reading occurrence equals 1 hour (note daylight savings shifts must be taken into acount)

Formateret

Formateret

Meter data cannot be registered in CCR without a valid energy quantity

Formateret

Formateret

Only digits, decimal separator indicated by "." (without thousands of separation), 3 digits after the decimal separator and positive values are allowed, length is restricted to 10

Formateret

Formateret

Meter data cannot be registered in CCR without a valid quantity quality

Formateret


Formateret

Formateret

Measure unit <1> not allowed: the unit of a consumption data reading for metering point <2> must be kWh

Formateret

Meter reading occurrence <1> not allowed: the reading occurrence for metering point

<2> must be Every year, Every month, Every hour or Other

Formateret


<2> must be Every hour or Every 15 minutes

Formateret

Formateret


<2> must be Every month, Every hour or Every 15 minutes

Formateret

Formateret

Fuel type is missing for metering point <1>

Formateret

Formateret

PSO exempt is missing for metering point <1>

Formateret

Sub type is missing for metering point <1>

Formateret

Formateret

Formateret

Formateret

Formateret

side 75 af 75

Formateret

Formateret

Formateret

Formateret

Formateret

Formateret

Formateret

Formateret

Formateret

Formateret

Formateret

Formateret

Formateret

Formateret

Formateret

Formateret

Formateret

Formateret

Formateret

Formateret

Formateret

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

Energinet.dk data migration User manual

Assistant Bot

Brugermanual - Datamigrering

Energinet.dk

1 3 . oktoberapril 2012

DataHub support:

Indhold

1 Introduktion

1.1 Formål

1.2 Ændringer i DataMigering 2 (DM-2)

Læse vejledning

Dokument historie

2 Migreringsproces

2.1 Overordnet beskrivelse

Gridoperators

ENDK

2.2 Elleverandørernes opgave

2.3 Migreringskørsel

2.4 Migreringsværktøjer

3 Fil overførsel

3.1 Fil overførelse via FileZilla

3.2 Konfigurering af Firewall

3.3 Download af FileZilla

3.4 Opsætning af FTP

3.5 Åben et Websted

3.6 Mappe med overførsler

3.7 Upload af data

3.8 Timeout i FileZilla

4 Datamigrering

4.1 DataHub

4.2 Datamigrering - List Migreringskørsler

4.3 Datamigrering -– Start migreringOpret kørsel

4.4 Datamigrering - Status for datamigrering

4.5 Datamigrering - Se rapporter

4.6 Datamigrering - Slet alle data

5 Rapporter

5.1 Rapporter kørt under en datamigrering

5.2 Rapporter kørt af bruger

6 Filformater

6.1 Navngivning af filer

6.2 Syntaks for header linjen

6.3 Syntaks for datalinjer

6.4 Syntaks for footer linjen

6.5 Eksempler på filer

7 Feltbeskrivelse til filer

7.1 Felter i Header linjen (HDR)

7.2 Felter i Data linjer (DATA)

7.3 Felter i Footer linjen (FTR)

Appendix A – Fejlkoder ved validering, DM

Appendix B – Fejlkoder ved validering, VAL

Key Features

Frequently Answers and Questions

What file types are supported for data migration?

How do I transfer files for data migration?

What are the validation rules for data migration?

How do I access the DataHub system?

What reports are available for data migration?

Related manuals

Energinet.dk

Data Migration

Solax

DataHub 1000

TRUSCO

FTR 65G

Predictwind

DATAHUB

SolaX Power

DATAHUB

Solax

DataHub 1000

Solax

DataHub 1000

Predictwind

DATAHUB WiFi Router

Roche

cobas Liat

Roche

cobas Liat

Dell

Data Assistant