Formatguide. Migreringsformater. Engrosdata filtyper og dataformater. 21. december 2015 XSTJ. Projekt Version Dato Forfatter

Transkript

1 Formatguide Migreringsformater Engrosdata filtyper og dataformater 21. december 2015 XSTJ Projekt Version Dato Forfatter Migreringsformater draft draft XSTJ XSTJ XSTJ XSTJ XSTJ XSTJ XSTJ XSTJ XSTJ Version 0.5 udskilt af hovedmigreringsdokument Dok.: 13/ /101

2 Ændringslog Version Afsnit Kommentar og 2. tabel ændret , Tabel ændret 3.3.1, Tabel ændret 3.4.1, Tabel ændret og 3. tabel ændret Format og feltrækkefølge ændret 3.5.1, Tabel ændret og 2. og 3. tabel ændret Format og feltrækkefølge ændret Tabel ændret Format og feltrækkefølge ændret Draft 3.7 Filtype 0 tabel fjernet (findes allerede i migreringsguide) versættelsestabel fjernet Tabel ændret Format og feltrækkefølge ændret 5.5.1, 5.5.2, 5.5.3, Street_code ændret fra til , 5.6.3, Tabel ændret 5.7.2, 5.7.3, Tabel ændret 6.1 Tabel ændret Version Afsnit Kommentar Hele dokumentet Alle datoer ændret til Tabel ændret 3. Type 0 tilføjet + tabel ændret med ftp filnavn Tabel ændret + tabel (yderligere regler) + bemærk boks ValidFromDate ændret Tabel ændret - Valid_From 3.4 Tekster Tabel ændret Tabel - ESTIMATED_ANNUAL_VLUME Ny tabel Tabel ændret Tabel - ESTIMATED_ANNUAL_VLUME Tabel ændret Draft Tabel ændret 3.7 Ændret og ny tekst + ny tabel Tabel ændret , Ny tabel Ændret og ny tekst 5.3.1, Tabel værdi Y ændret til M Tabel værdi Y ændret til M + TYPE_F_METERING_PINT 5.3.4, Tabel værdi Y ændret til M 5.4.1, 5.4.2, 5.4.3, Tabel værdi Y ændret til M 5.5.1, 5.5.3, Tabel værdi Y ændret til M Tabel værdi Y ændret til M + CNTACT_NAME1 ændret til optional Tabel værdi Y ændret til M 5.6.2, 5.6.3, Tabel værdi Y ændret til M + Dok. 13/ /101

3 METERREADING_CCURENCE + METER_CNVERSIN_FACTR + ESTIMATED_ANNUAL_VLUME Tabel værdi Y ændret til M 5.7.2, 5.7.3, Tabel værdi Y ændret til M + METER_CNVERSIN_FACTR + ESTIMATED_ANNUAL_VLUME + MP_CNNECTIN_TYPE + DISCNNECTIN_TYPE + MP_ADDRESS_WASH_INSTRUCTINS Dobbelt række for METERREADING_TYPE slettet Version Afsnit Kommentar 3.7 Tabel ændret Tabel ændret + boks Vigtigt Tabel ændret + boks Vigtigt boks Vigtigt 4.1 Tip boks Format udvidet med LAST_CHANGE_DATE Format udvidet med LAST_CHANGE_DATE Version Afsnit Kommentar 2.3 Tabel ændret 3.0 Ændret filnavn for fil type 0 (tabel ændret) Street_code mandatory fjernet 3.7 Præcisering ny Vigtigt box Filnavn udvides med pristype Yderligere funktionelle valideringer (ny tabel) Format for filnavn, samt exportfil tabel 5.1 Tabel ændret for logfiler 1 ny type tilføjet Tabel opdateret Nyt afsnit Logfil for slettede målepunkter Vigtig information Alle datoer nævnt i dokumentet er baseret på nuværende og godkendt tidsplan. Der vil udkomme en ny version når replanlægningen er tilendebragt og der foreligger en ny godkendt tidsplan. Dok. 13/ /101

4 Indhold 1. Indledning Forord Læsevejledning Datamigrering verordnede begreber Kategorier af data til migrering Datamigrering og historik Migreringsfiler og formater Type 1 - Pristilknytninger Data Valideringsregler Filformat Type 2 - Elvarme Data Valideringsregler Filformat Type 3 - Kontaktinformationer Data Valideringsregler Filformat Type 4 prettelse af nye målepunktstyper Data Valideringsregler Filformat Type 5 Ændring af eksisterende målepunkter Data Valideringsregler Filformat Type 6 Hent målepunktsstamdata for nye og eksisterende målepunkter Data Valideringsregler Filformat Type 0 pret og hent komplet prisliste Data Valideringsregler Filformat Dok. 13/ /101

5 4. Eksport af migreringsdata utput filformater Type 0 Priselementer (prisliste) Type 1 Pristilknytninger Type 3 Kontaktinformationer Type 6 Målepunktsstamdata Systemleverandør Netvirksomhed Elleverandør Migreringslogfiler Logfilsformater Logfiler FILTYPE 1 logfiler Import Validering Manglende målepunkter Delta opdatering Delta afvisning FILTYPE 2 logfiler Import Validering Delta opdatering Delta afvisning FILTYPE 3 logfiler Import Validering Delta opdatering Delta afvisning FILTYPE 4 logfiler Import Validering Delta opdatering Delta afvisning Slettede målepunkter FILTYPE 5 logfiler Import Validering Delta opdatering Delta afvisning Dok. 13/ /101

6 6. Fejlkoder og statusmeddelelser Fejlkoder Statusmeddelelser templates Testdata Dok. 13/ /101

7 Formatguide 1. Indledning 1.1 Forord Dette dokument indeholder alle nødvendige informationer, der skal bruges til danne migreringsfiler. Dokumentet indeholder informationer til alle aktører, og det er muligt at få indblik i hinandens migreringsfiler og udvekslingsformater, hvis dette ønskes. Dokumentet er primært henvendt til netvirksomheder, der skal migrere pris- og stamdata i mængder, der ikke kan opdateres via markedsportalen. Dette dokument er et af flere, der beskriver hele migreringsprocessen, og som skal understøtte implementeringen af Engrosmodellen. Følgende dokumenter er pt. planlagt til at understøtte aktøren under migreringen: Migreringsguide (hoveddokument) Migreringsformater FTP- guide Testcases Spørgsmål og svar 1.2 Læsevejledning Dokumentet er opbygget på en sådan måde, at relevante emner i videst muligt omfang er samlet i selvstændige kapitler for de enkelte aktørtyper. Generelt er størsteparten af teksten mest relevant for netvirksomheder, men visse dele kan have interesse for elleverandør i forbindelse med modtagelse af migreringsdata i postmigreringsperioden. En del af tabellerne der definerer filformater, loginformationer og fejlkoder i dokumentet er på engelsk, da disse ofte skal udveksles med Energinet.dk s systemleverandør, når der ændres i fx BRS- og RSM- guides. Det er blevet vurderet, at der ikke vil være et problem i dette, da det oftest er it- tekniske personer, der varetager datamigreringen. Kapitel 2. indeholder koncept og overordnede begreber for datamigreringen. Kapitel 3. indeholder beskrivelser af de forskellige migreringsfiler, samt fysiske filformater og valideringsregler. Kapitel 4. indeholder filformater og udvekslingsregler for elleverandører i postmigreringsperioden. Kapitel 5. og 6. indeholder logfilsformater, fejlkoder og statusmeddelelser som sendes til aktøren, der har initieret migreringen. Tip! Dokumentet anvender denne boks, hvis noget information ønskes specielt fremhævet. De kan indeholde informationer som er essentielle i den givne kontekst eller som kan gøre det lettere at håndtere migreringsprocessen. Vigtigt! Dokumentet anvender denne boks, hvis et vigtigt udsagn ønskes fremhævet. Benyttes specielt i situationer, hvor utilsigtede hændelser kan fremprovokere migreringsfejl. Dok.: 13/ /101

8 2. Datamigrering 2.1 verordnede begreber Engrosmodellens datamodel er allerede implementeret i den kørende DataHub og datamigreringen skal sikre at migrerede data valideres og oprettes i den eksisterende Datahub. Dette sikres gennem indsendelse migreringsfiler fra 1. marts 2015 og frem til start på cut-over. For at migreringssystemet kan læse og forstå de indsendte data er der en del krav der skal være opfyldt omkring filformater og valideringsregler. For den fulde forståelse af denne formatguide refereres der også til migreringsguidedokumentet, der indeholder alle nødvendige beskrivelser af migreringskoncept og metode. 2.2 Kategorier af data til migrering 1. Pris informationer Netvirksomhedernes og Energinet.dk s prislister for abonnementer, tariffer og gebyrer 2. Tilknytning af tariffer og abonnementer til et målepunkt 3. Stamdata indikator for kunder med elvarme 4. Målepunktsstamdata - Nye målepunkter/stamdata for nye målepunktstyper - Nye målepunktsstamdata for eksisterende målepunkter 5. Kontaktinformationer Det er vigtigt pointere, at denne guide ikke indeholder generelle regler for udveksling og håndtering af engrosdata men kun berører specielle forhold, der har en relevans for korrekt migrering af nye engrosdata. Der henvises til eksisterende materiale i BRS- og RSM- guides, samt i de relevante forskrifter hvis der ønskes mere detaljeret viden om engrosdata og deres indbyrdes relationer. Dok. 13/ /101

9 2.3 Datamigrering og historik Engrosmodel datamigrering understøtter ikke migrering af historiske data, men der er visse situationer, hvor det er nødvendigt at håndtere påkrævede historiske stamdata i migreringssammenhæng. Nedenstående tabel indeholder datoer for, hvornår migreringsdata er gældende fra: Filtype Indeholder Fra/Til dato 0 Priselementer Priselement gælder fra Tidligste dato der kan angives i migrering Seneste dato der kan angives i migrering 1 Pristilknytning Pristilknytningen gælder fra Tidligste dato der kan angives i migrering Seneste dato der kan angives i migrering Pristilknytninger på nye tekniske målepunkter oprettet gennem filtype 4 kan ikke have en startdato før cut-over, da det underliggende målepunkt først er aktivt fra Elvarme eller senere 3 Kontaktadresser Kontaktdata gældende per den Ny målepunkter prettet målepunkt sættes aktivt per den Nye stamdata Målepunktsstamdata gælder fra Alle stamdata Ændrede målepunktsstamdata, samt nye Engrosmodel stamdata gælder fra Alle nye tekniske målepunkter (filtype 4) gælder fra For filtype 5 gælder der særlige regler, da overgangen til Engrosmodellen betyder, at visse nye målepunktsstamdata ikke kan være blanke for historiske data. Hvis et fysisk målepunkt (D01) mangler data i nedenstående 5 nye stamdatafelter: - METER_ID - METER_NR_F_DIGITS - METER_CNVERSIN_FACTR - METERREADING_UNIT - METERREADING_TYPE vil målepunktet blive sat til virtuelt (D02) for data af cut-over processerne, der ligger før 1. april Efter Go-live vil det være muligt for netvirksomheden at opdatere målepunktet med de påkrævede stamdata og sætte målepunktet tilbage til et fysisk målepunkt. Nye og opdaterede målepunktsstamdata fra netvirksomhederne bliver gemt i DataHub med en effektueringsdato, der er den samme som Go-live datoen for Engrosmodelsystemet. Denne dato er foreløbigt fastsat til den 1. april Dok. 13/ /101

10 3. Migreringsfiler og formater Datamigrering vil foregå via kommaseparerede filer (separationstegn er ), der indsendes til Energinet.dk s migreringsplatform. Aktørerne vil ikke direkte skulle interagere med migreringssystemet, udover nævnte filupload til en DataHub FTP- server. Al styring, fejlhåndtering og schedulering varetages af Energinet.dk datateam for at sikre en succesfuld migrering. Netvirksomheden skal sikre, at alle priser er oprettet via GUI (Markedsportalen) eller via filtype 0 (Datamigreringsløsning), for at pristilknytningerne vil fungere efterfølgende. Migreringsdata uploades via følgende 6 filtyper: Type 0: skal altid være en komplet liste dvs. alle priselementer (komplet prisliste) skal indgå i listen Type 1: skal altid være en komplet liste dvs. tilknytninger for alle netvirksomhedens målepunkter skal indgå i listen Type 2: skal være en positiv liste dvs. kun målepunkter der har elvarme skal indgå i listen Type 3: skal være en positiv liste dvs. kun målepunkter med kontakt navn og adresse forskellig fra målepunktsadressen skal indgå i listen Type 4: skal være en komplet liste dvs. alle nye målepunkter baseret på de nye målepunktstyper fra D04 til D12 skal indgå i listen Type 5: skal være en opdateringsliste dvs. kun eksisterende målepunkter der skal have tilføjet nye Engrosmodel stamdata, parent målepunkt og/eller målepunktstype konvertering skal indgå i listen Liste over filtyper og filnavne Nedenstående liste indeholder alle de migreringsfiler, der er mulighed for at sende til egen FTPfolder. Hver netvirksomhed har sin egen root- folder på FTP- serveren. Folderens navn er netvirksomhedens GLN nummer og rolle. Bemærk, at navnet på root- folder en aldrig vil være synlig for den indsendende part. Eksempel: <gln nummer>_<rolle> _DDM Netvirksomheder vil have postfix <_DDM> og elleverandører vil have postfix <_DDQ>. Der findes yderligere informationer om folderstrukturen i FTP- guiden. Der er mulighed for eget postfix <FID> på migreringsfilen. Den samlede længde på migreringsfilen, inklusiv eget id, er på maksimalt 50 karakterer. Root- folderen for de indsendte filer kan kun indeholde følgende filtyper med de specificerede filnavne. Kun <FID> kan navngives efter eget valg. Dok. 13/ /101

11 Filtype Filnavn Beskrivelse 0 PRICINGINFRMATIN_<T>_<FID>.dat Alle priselementer fra netvirksomheden (komplet prisliste) 1 LINKS_<FID>.dat 2 ELECTRICAL_HEATING_<FID>.dat 3 CNTACTS_<FID>.dat 4 NEW_MP_<FID>.dat 5 UPDATE_MP_<FID>.dat Tariffer og abonnementer for alle netvirksomhedens målepunkter Netvirksomhedens målepunkter der skal registreres til at have elvarme Kontaktadresser (D01-D04) for et specifikt målepunkt der adskiller sig fra målepunktsadressen Nye tekniske målepunkter, baseret på nye Engrosmodel målepunktstyper (D04-D14), der skal oprettes Eksisterende målepunkter der skal have opdateret nye Engrosmodel målepunktsstamdata. Målepunkter fra filtype 4 er ikke tilladt i denne fil. T = Pristype (D01=Abonnement) og (D03=Tarif) FID = Unik migreringsfil id (Netvirksomhedens selvvalgte id) Filnavnet i listen skal bruges ved upload til FTP- server. Alle filnavne forskellige fra ovenstående bliver afvist af migreringssystemet. Eksempel: LINKS_migr003.dat Postfixet <FID> kan kun indeholde hele tal og bogstaver (a-z, A-Z og 0-9). Specialkarakterer er ikke tilladt ud over underscore <_> der adskiller filnavn fra eget id. Bemærk: Filtyperne 2, 4, og 5 indeholder yderligere 1 underscore i filnavn, hvilket er tilladt. Restriktioner: <FID> er påkrævet og skal overholde ovenstående regler Alle filer der ikke overholder navnestandard bliver ignoreret Hvis en fil indsendes med samme navn som tidligere, vil filen blive flyttet til arkiv, og der vil ikke blive udført yderligere operationer på filen. Hver af de fem filtyper som bruges til migrering, har sit eget filformat. I de efterfølgende formattabeller bruges følgende notation for en felt: NUMBER(x) Kun numeriske værdier (heltal) NUMBER(x,y) Kun numeriske værdier (tal) kan indeholde decimaltal VARCHAR2(x) Alfanumeriske værdier (tal, bogstaver og specialtegn), dog ikke Dok. 13/ /101

12 DATE Kun valide dato værdier Talværdi efter bogstav (x) er længden på feltet, dvs. at NUMBER(5) betyder, at feltet kan indeholde alle værdier mellem 0 og Type 1 - Pristilknytninger Filtype 1 bruges til at danne alle pristilknytninger der skal være til stede i Engrosmodellen for, at elleverandøren kan fakturere sine kunder. Der migreres kun tilknytninger for abonnementer og tariffer. Det er ikke muligt at oprette en pristilknytning hvis priselementet mangler eller har en anden gyldighedsperiode end pristilknytningen Data Field-Name Data Type Mandatory / ptional Constraint METERING_PINT_ID VARCHAR2(18) M EAN-18 VALID_FRM DATE M YYYY-MM-DD VALID_T DATE YYYY-MM-DD CHARGE_TYPE M D01 or D03 ( D02 er gebyr og ikke forventet her) CHARGE_TYPE_CDE VARCHAR2(10) M CHARGE_TYPE_WNER NUMBER(13) M EAN-13 / EIC QUANTITY NUMBER(9) M [0-9] * LAST_CHANGE_DATE DATE YYYY-MM-DD *) Feltet findes kun i exportfil Metering_Point_Id Målepunktsid der eksisterer i DataHub en og som tilhører den netvirksomhed der har uploadet migreringsfilen. Valid_From Tarif eller abonnement er aktiv fra dato. Dato er fra og med dato. Fx: Hvis ValidFromDate fx er sat til , ses dette af systemet som start :00:00. Valid_To Tarif eller abonnement er aktiv til dato Dato er til dato. Dok. 13/ /101

13 Fx: Hvis ValidToDate er sat til ses dette af systemet som slut < :00:00. (defacto :59:59:999) Dvs. hvis en tarif skal gælde et helt år skal ValidFromDate sættes til og ValidToDate sættes til Charge_Type Priselementstype for følgende 3 slags opkrævninger: - D01 = Abonnement - D02 = Gebyr (*) - D03 = Tarif (*) Bemærk at gebyr ikke er en del af migreringen, da gebyrer ikke kan sættes frem i tid. Charge_Type_Code Netvirksomhedens egen nøgle/id relateret til priselementet. Den entydige nøgle mellem fx en tariftilknytning og priselementet er repræsenteret ved: ValidFromDate + ChargeType + ChargeTypeCode + ChargeTypewner Charge_Type_wner GLN nummeret for den netvirksomhed der ejer og har oprettet tarif eller abonnement. Quantity Antal gange et abonnement skal beregnes. Hvis ChargeType er abonnement (D01), skal antal være mellem 1 og Hvis ChargeType er tarif (D03), kan antal kun være 1. Alle andre værdier vil blive afvist. Feltet LAST_CHANGE_DATE kan ikke indsendes. Feltet eksisterer kun i exportfilen. Dato feltet kan indeholde en dato eller være tomt. Hvis feltet er tomt, betyder det at der ikke har været nogen ændringer til pristilknytningen siden den blev oprettet. Hvis feltet indeholder en dato er datoen den dag der senest blev rettet i pristilknytningen Dok. 13/ /101

14 3.1.2 Valideringsregler Der findes en række regler for hvert enkelt felt i migreringsfilen. Disse skal sikre, at kun korrekte data migrereres ind i DataHub produktionsdatabasen. I afsnit seks findes en liste over fejlmeddelelser, som systemet returnererr, hvis et eller flere felter ikke overholder syntaks. De enkelte valideringsregler kontrolleres for respektive attributter i migreringsfilen. I nogle tilfælde afvises migreringsfilen automatisk af systemet, hvor det i andre beror på en vurdering fra supportmedarbejderen Tekniske valideringer Attribute Validation Availability check (is mandatory attribute) METERING_PINT_ID Data Type check (must contain only number values) Length check (length must be 18) VALID_FRM VALID_T CHARGE_TYPE CHARGE_TYPE_CDE Availability check (is mandatory attribute) Data Type check (must be Date format YYYY-MM-DD ) Data Type check (must be Date format YYYY-MM-DD ) Availability check (is mandatory attribute) Length check (length must be 3) Availability check (is mandatory attribute) Length check (min. length must be 1 and max 10) Availability check (is mandatory attribute) CHARGE_TYPE_WNER Data Type check (must contain only number values) Length check (length must be 13) Availability check (is mandatory attribute) QUANTITY Data Type check (must contain only numeric values) Length check (length must be max 9) Dok. 13/ /101

15 Funktionelle valideringer Attribute Validation Metering Point owner is the Grid perator from the Flat File Metering Point exists in the DataHub METERING_PINT_ID Metering Point is NT of the type E20, D13 or D99 Metering Point must not have the status Closed Down (PhysicalStatusfMP!= D02 ) Metering Point is Active on or after Go-Live Date VALID_FRM VALID_T CHARGE_TYPE >= 1 st of January 2014 and not later than the 1 st of ctober 2018 and not earlier than the earliest valid_from of the Metering Point Should be after the VALID_FRM and after the cut over1 date. Constraint check (D01 or D03) D01=Subscription/D03=Tariff (D02=Fee, which is NT expected) CHARGE_TYPE_CDE CHARGE_TYPE_WNER If CHARGE_TYPE = D01 (Subscription) then check if the code exists and is active for the time-period in the ISCHANGE Fee Domain (feecode attribute) otherwise if the CHARGE_TYPE_CDE = D03 (Tariff) then check if the code exists and is active for the time-period in the ISCHANGE Tariff Domain (tariffcode attribute) Should be the rganisation ID of the Grid perator (wner of the Flat File) or the system operator of ENDK (' ') QUANTITY Must be 1 if CHARGE_TYPE = D03 otherwise must be >=1 Da filtype 1 skal indeholde tilknytninger og abonnementer for alle netvirksomhedens målepunkter, gælder der yderligere følgende regler: Attributes Validation CHARGE_TYPE, CHARGE_TYPE_CDE, CHARGE_TYPE_WNER. The to be linked Tariff or Subscription exists and is active for the given time period. VALID_FRM, VALID_T METERING_PINT_ID The difference between the number of Metering Points within the DataHub and the Flat File are bigger than the defined threshold for non-technical Metering Points. (Select on E17/E18 Metering Point type only) METERING_PINT_ID The difference between the number of Metering Points within the DataHub and the Flat File are bigger than the defined threshold for technical Metering Points. (Select on D01-D14 except D13 Metering Point type only) Dok. 13/ /101

16 METERING_PINT_ID, CHARGE_TYPE, CHARGE_TYPE_CDE, Duplicate Metering Point data available in the Flat File CHARGE_TYPE_WNER VALID_FRM, VALID_T* (If available) CHARGE_TYPE, CHARGE_TYPE_CDE, CHARGE_TYPE_WNER The valid_from date must be before the valid_to date The Sys, Net and Balance tariffs are NT allowed: CHARGE_TYPE= D03 AND CHARGE_TYPE_CDE= R R R R AND CHARGE_TYPE_WNER= For yderligere information om datafelter henvises der til Forskift I, Stamdata, måledata og aktørstamdata, kapitel 4. Links for System og Net, samt balance og indfødningstariffer skal ikke leveres af netvirksomheden. For disse specifikke links der er valideringsregler der resulterer i valideringsfejl, hvis disse findes i LINKS filen fra netvirksomheden. Men de af Energinet.dk oprettede links vil dog være tilgængelig i DataHub'en, da de vil blive skabt under cut-over. (se cut-over guide for dato for oprettelse). Datamigreringsløsningen vil ignorere disse links i delta beregninger og initialiseringsprocesser. Dok. 13/ /101

17 3.1.3 Filformat Der anvendes en CSV- fil til migreringen af tilknytningsdata. Det anvendte separatorsymbol er en lodret streg ( ). Det er vigtigt at pointere, at migreringsfilen er en ASCII- tekstfil, dvs. den må ikke indeholde nogen former for kontrolkoder ud over de to godkendte. Hver linje (record) afsluttes med en carrige return + line feed (CRLF). Data for et målpunkt skal være sammenhængende, dvs. data må ikke strække sig over flere linjer. Filen skal som minimum indeholde en linje. Der er intet max antal linjer. Migreringsfil er en fuld liste, hvilket betyder, at alle netvirksomhedens forbrugs- og produktionsmålepunkter af typerne E17 og E18, skal være indeholdt i migreringsfilen. Der må ikke sendes halve filer, da det vil betyde, at de manglende målepunkter vil få slettet alle pristilknytninger. Format: Felt1 felt2 felt3 felt4 felt5 felt6 felt7crlf Feltrækkefølge: <METERING_PINT_ID> <VALID_FRM> <VALID_T> <CHARGE_TYPE> <CHARGE_TYPE_CDE> <CHARG E_TYPE_WNER> <QUANTITY>CRLF Eksempel: D03 457TP D01 210SP D03 210SP D03 457TP Adskillelsessymbol for felterne er pipe-symbolet (7C) Et pipe-symbol inden i et felt er ikke tilladt Ingen specielle start/slut rækker og ingen kolonneoverskrift Linjer (records) skal afsluttes af CR/LF, (0D0A). Windows-kompatibel Udover CR/LF ved linjeslut, må migreringsfilen ikke indeholde linjeskift-symbolet (0A) Det anvendte tegnsæt skal være UTF-8 Hvis et felt er tomt, skal adskillelsessymbol stadig være til stede Dok. 13/ /101

18 3.2 Type 2 - Elvarme Filtype 2 bruges til at sætte elvarmeindikatoren på målepunktets stamdata, dvs. alle kunder der er registreret med elvarme, skal være indeholdt migreringsfilen Data Field-Name Data Type Mandatory / ptional Constraint METRING_PINT_ID VARCHAR2(18) M EAN-18 VALID_FRM DATE M YYYY-MM-DD MeteringPointId Målepunktsid der eksisterer i DataHub en og som tilhører den netvirksomhed der har uploadet migreringsfilen. ValidFromDate Tarif eller abonnement er aktiv fra dato. Dato er fra og med dato. ValidFromDate skal være den dato hvor elvarmeregistreringen fandt sted. Årstallet er ikke væsentligt, men dag og måned er. Hvis dato for elvarmeregistreringen ikke er kendt, angives årsafregningsdato. Fx Hvis ValidFromDate fx er sat til , ses dette af systemet som start :00: Valideringsregler Der findes en række regler for hvert enkelt felt i migreringsfilen. Disse skal sikre, at kun korrekte data migrereres ind idatahub produktionsdatabasen i DataHub. I afsnit 6 findes en liste over fejlmeddelelser, som systemet returnerer, hvis et eller flere felter ikke overholder syntaks Tekniske valideringer Attribute Validation Availability check (is mandatory attribute) METERING_PINT_ID Data Type check (must contain only number values) Length check (length must be 18) VALID_FRM Availability check (is mandatory attribute) Data Type check (must be Date format YYYY-MM-DD ) Dok. 13/ /101

19 Length check (length must be 10) Validity check, Date must be valid Funktionelle valideringer Attribute Validation Metering Point owner is the Grid perator from the Flat File METERING_PINT_ID Metering Point exists in the DataHub Metering Point is a Consumption(E17) type Metering Point must not have the status Closed Down (PhysicalStatusfMP!= D02 ) VALID_FRM If the VALID_FRM date is a leap year (29-02-xxxx), date is converted into xxxx For filtype 2 gælder yderligere at: Attributes METERING_PINT_ID Validation Duplicate Metering Point data available in the Flat File For yderligere information om datafelter henvises til Forskift I, Stamdata, måledata og aktørstamdata, kapitel 4. Dok. 13/ /101

20 3.2.3 Filformat Der anvendes en CSV- fil til migreringen af elvarmeindikator. Det anvendte separator symbol er en lodret streg ( ). Det er vigtigt at pointere, at migreringsfilen er en ASCII- tekstfil, dvs. den må ikke indeholde nogen former for kontrolkoder ud over de to godkendte. Hver linje (record) afsluttes med en carrige return + line feed (CRLF). Data for et målpunkt skal være sammenhængende, dvs. data må ikke strække sig over flere linjer. Filen skal som minimum indeholde en linje. Der er intet max. antal linjer. Migreringsfil er en positiv liste, hvilket betyder, at kun netvirksomhedens forbrugsmålepunkter, der er registreret med elvarme, skal være indeholdt i migreringsfilen. Alle målepunkter der ikke findes i migreringsfilen, vil blive sat til ikke at have elvarme. Format: Felt1 felt2crlf Feltrækkefølge: <METERING_PINT_ID> <VALID_FRM>CRLF Eksempel: Adskillelsessymbol for felterne er pipe-symbolet (7C) Et pipe-symbol inden i et felt er ikke tilladt Ingen specielle start/slut rækker og ingen kolonneoverskrift Linjer (records) skal afsluttes af CR/LF, (0D0A). Windows-kompatibel Udover CR/LF ved linjeslut, må migreringsfilen ikke indeholde linjeskift-symbolet (0A) Det anvendte tegnsæt skal være UTF-8 Hvis et felt er tomt, skal adskillelsessymbol stadig være til stede Dok. 13/ /101

21 3.3 Type 3 - Kontaktinformationer Filtype 3 bruges til at sætte kontaktinformationer pr. målepunkt for de 4 typer afbryderkort, aflæsningskort, valgkort og adresse 4. Der kan sættes kontaktnavn alene, eller der kan sættes både kontaktnavn og kontaktadresse, hvis disse er forskellige fra det, der er registreret via målepunktets stamdata. Migreringsfilen skal kun indeholde navn/adresse for målepunkter, der adskiller sig fra målepunktets stamdata og som ønskes oprettet under de specifikke adressetyper Data Field-Name Data Type Mandatory / ptional Constraint METERING_PINT_ID VARCHAR2(18) M EAN-18 ADDRESS_CDE M CNTACT_NAME1 VARCHAR2(132) CNTACT_NAME2 VARCHAR2(132) Maximum: 3 D01 or D02 or D03 or D04 Minimal: 0, Maximum: 132 Minimal: 0, Maximum: 132 SAME_AS_MP_ADDRESS NUMBER(1) M 1=true (YES) 0=false (N) STREET_CDE VARCHAR2(4) Minimal: 4, Maximum: 4 4 digits 0001 to 9999 PS: Varchar2 because Leading zero s STREET_NAME VARCHAR2(40) BUILDING_NUMBER VARCHAR2(6) FLR_ID VARCHAR2(2) RM_ID VARCHAR2(4) PSTCDE VARCHAR2(10) Minimal: 0, Maximum: 40 Minimal: 0, Maximum: 6 Minimal: 0, Maximum: 2 Minimal: 0, Maximum: 4 Minimal: 0, Maximum: 10 Dok. 13/ /101

22 CITY_NAME VARCHAR2(25) CITY_SUBDIVISIN_NAME VARCHAR2(25) MUNICIPALITY_CDE CUNTRY_CDE VARCHAR2(2) _ADDRESS VARCHAR2(60) PHNE_NUMBER VARCHAR2(20) MBILE_NUMBER VARCHAR2(20) Minimal: 0, Maximum: 25 Minimal: 0, Maximum: 25 Minimal: 3, Maximum: 3 Alpha Minimal: 2, Maximum: 2 Minimal: 0, Maximum: 60 Minimal: 0, Maximum: 20 Minimal: 0, Maximum: 20 * LAST_CHANGE_DATE DATE M YYYY-MM-DD *) Feltet findes kun i exportfil MeteringPointId Målepunktsid der eksisterer i DataHub en og som tilhører den netvirksomhed der har uploadet migreringsfilen. AddressType Målepunktsid D01 = Afbryderkort D02 = Aflæsningskort D03 = Valgkort D04 = Adresse 4 ContactName1 Kontaktnavn1 på adressen*. Navnet skal angives pr. adressetype. * Adresse: er målepunktsadresse hvis SameAsMPAddress er sat, ellers er adresse den, der er sat i kontaktinformationer. Fx Jens Hansen ContactName2 Kontaktnavn2 angives, hvis der er to navne på kontaktadressen. Fx Jytte Hansen Dok. 13/ /101

23 SameAsMPAddress Flag der bruges til at angive om selve adressen er identisk med målepunktsadressen. Det er kun selve adressen som kan være identisk. Navn, telefonnumre og skal stadig angives for kontaktadresser. Hvis der vælges 0, skal alle ikke adressefelter være udfyldt, samt relevante adressefelter skal være udfyldte. Hvis der vælges 1, betyder det kun, at adressen automatisk sættes til den adresse, der er registreret på målepunktet. Adressefelterne er identificeret ved felterne 6-15 (StreetCode til Country- Code) StreetCode Skal angives, hvis muligt. Vejkoden udgør sammen med kommunekoden en entydig identifikation af den navngivne vej. Vejkode skal altid bestå af 4 cifre, og disse skal være i intervallet StreetName Skal angives. Hvis vejnavn ikke er kendt, angives Ukendt. BuildingNumber Husnummer skal angives, hvis muligt. Fx 45, 45a FloorId Etage skal angives, hvis relevant (fx ved etagebyggeri). Fx 3 RoomId Dørbetegnelse skal angives, hvis relevant (fx ved etagebyggeri). Fx Th, Tv PostCode Postnummer skal angives. Fx 7000 CityName Bynavn skal angives i overensstemmelse med postnummeret. Fx Fredericia CitySubDivisionName Stednavn kan angives. Lokalområde under et postnummer eller en by. MunicipalityCode Kommunekode skal være i overensstemmelse med kommunekoderne fra BBR, hvis den angives. Fx 607 CountryCode Landekode skal består af en 2-tegns-kode efter IS-3166 standarden, hvis den angives. Fx DK Dok. 13/ /101

24 Address Elektronisk postadresse skal overholde standarden for adresse. PhoneNumber Fastnet telefonnummer. MobileNumber Mobiltelefonnummer. Feltet LAST_CHANGE_DATE kan ikke indsendes. Feltet eksisterer kun i exportfilen. Dato feltet vil indeholde en dato. Hvis feltet indeholder en dato er datoen den dag der senest blev rettet i kontaktperson Dok. 13/ /101

25 3.3.2 Valideringsregler Der findes en række regler for hvert enkelt felt i migreringsfilen. Disse skal sikre, at kun korrekte data migrereres ind i produktionsdatabasen i DataHub. I afsnit 6 findes en liste over fejlmeddelelser, som systemet returnerer, hvis et eller flere felter ikke overholder syntaks Tekniske valideringer Attribute Validation Availability check (is mandatory attribute) METRING_PINT_ID Data Type check (must contain only number values) Length check (length must be 18) ADDRESS_CDE Availability check (is mandatory attribute) Length check (length must be 3) CNTACT_NAME1 Length check (length must be max 132) CNTACT_NAME2 Length check (length must be max 132) Availability check (is mandatory attribute) SAME_AS_MP_ADDRESS Length check (length must be 1) Data Type check (must contain only number values) Constraint check, must be 0 or 1 ) STREET_CDE Length check (length must be 4) Data Type check (must contain only number values) STREET_NAME When available, Length check (length must be max 40) BUILDING_NUMBER When available, Length check (length must be max 6) FLR_ID When available, Length check (length must be max 2) RM_ID When available, Length check (length must be max 4) PSTCDE When available, Length check (length must be max 10) CITY_NAME When available, Length check (length must be max 25) CITY_SUBDIVISIN_NAME When available, Length check (length must be max 25) MUNICIPALITY_CDE When available, Length check (length must be 3) Data Type check (must contain only number values) CUNTRY_CDE When available, Length check (length must be 2) _ADDRESS When available, Length check (length must be max 60) PHNE_NUMBER When available, Length check (length must be max 20) Dok. 13/ /101

26 MBILE_NUMBER When available, Length check (length must be max 20) Funktionelle valideringer Attribute Validation Metering Point owner is the Grid perator from the Flat File METRING_PINT_ID Metering Point exists in the DataHub Metering Point is a Consumption(E17) or Production(E18) type Metering Point must not have the status Closed Down (PhysicalStatusfMP!= D02 ) ADDRESS_CDE Constraint check, must be D01 or D02 or D03 or D04 CNTACT_NAME1 CNTACT_NAME2 SAME_AS_MP_ADDRESS STREET_CDE Availability check (if value of SAME_AS_MP_ADDRESS is 1 then attribute should be empty If available: value must be between 0001 and 9999 STREET_NAME Availability check (if value of SAME_AS_MP_ADDRESS is 1 then attribute should be empty BUILDING_NUMBER FLR_ID RM_ID PSTCDE Availability check (if value of SAME_AS_MP_ADDRESS is 1 then attribute should be empty Availability check (if value of SAME_AS_MP_ADDRESS is 1 then attribute should be empty Availability check (if value of SAME_AS_MP_ADDRESS is 1 then attribute should be empty Availability check (if value of SAME_AS_MP_ADDRESS is 1 then attribute should be empty CITY_NAME Availability check (if value of SAME_AS_MP_ADDRESS is 1 then attribute should be empty CITY_SUBDIVISIN_NAME MUNICIPALITY_CDE Availability check (if value of SAME_AS_MP_ADDRESS is 1 then attribute must be empty) Availability check (if value of SAME_AS_MP_ADDRESS is 1 then attribute must be empty) Dok. 13/ /101

27 Constraint check, value must be between 100 and 999 CUNTRY_CDE Availability check (if value of SAME_AS_MP_ADDRESS is 1 then attribute must be empty) If value of SAME_AS_MP_ADDRESS is 0, then Constraint check: must be valid country code (check against IS list in the DataHub) _ADDRESS PHNE_NUMBER MBILE_NUMBER For filtype 3 gælder yderligere at: Attributes METERING_PINT_ID, ADDRESS_CDE, CNTACT_NAME1 Validation Duplicate Metering Point data available in the Flat File For yderligere information om datafelter henvises til Forskift I, Stamdata, måledata og aktørstamdata, kapitel 4. Det skal bemærkes, at det faktisk er muligt og accepteret at oprette en kontaktadresse uden navn og/eller adresse information i den nuværende datamodel. Det kan ikke anbefales at oprette den slags adressereferencer, da det kan give et uhensigtmæssigt resultat ved senere brug af adressen. Dok. 13/ /101

28 3.3.3 Filformat Der anvendes en CSV- fil til migreringen af kontaktinformationer. Det anvendte separatorsymbol er en lodret streg ( ). Det er vigtigt at pointere, at migreringsfilen er en ASCII- tekstfil, dvs. den må ikke indeholde nogen former for kontrolkoder ud over de to godkendte. Hver linje (record) afsluttes med en carrige return + line feed (CRLF). Data for et målpunkt skal være sammenhængende, dvs. data må ikke strække sig over flere linjer. Filen skal som minimum indeholde en linje. Der er intet max. antal linjer. Migreringsfil er en positiv liste, hvilket betyder, at kun målepunkter hvor der ønskes oprettet en kontaktadresse forskellig fra målepunktsadressen, skal være indeholdt i migreringsfilen. Alle målepunkter der ikke findes i migreringsfilen, vil for hver adressetype blive sat til at have samme adresse som adressen registreret på målepunktet. Yderligere vil kontaktnavn1 blive sat til disponentnavn på målepunktet. For filtype 3 findes der to forskellige måder at håndtere migreringsfilen på, alt afhængig af om aktøren ønsker at sætte både navn og adresse på kontaktpersonen (SameAsMPAddress=0) eller, om det kun ønskes at sætte kontaktpersonens navn, adresse og telefonnumre anderledes end målepunktets kontaktdata (SameAsMPAddress=1). Format: Felt1 felt2 felt3 felt4 felt5 felt6 felt7 felt8 felt9 felt10 felt11 felt12 felt13 felt14 felt15 felt16 felt17 felt18 CRLF Feltrækkefølge: <METERING_PINT_ID> <ADDRESS_CDE> <CNTACT_NAME1> <CNTACT_NAME2> <SAME_AS_MP_AD DRESS> <STREET_CDE> <STREET_NAME> <BUILDING_NUMBER> <FLR_ID> <RM_ID> <PSTCD E> <CITY_NAME> <CITY_SUB_DIV_NAME> <MUNICIPALITY_CDE> <CUNTRY_CDE> < _ADDRESS > <PHNE_NUMBER> <MBILE_NUMBER>CRLF Eksempel hvis SameAsMPAddress=0: D01 Jens Jensen 0 Engadeibyen Fredericia DK Jens.jensen@domain.dk D02 Hans Hansen 0 Ukendt D03 Jens Jensen D01 Jens Jensen Gurli Jensen 0 Jens.jensen@domain.dk Eksempel hvis SameAsMPAddress=1: D01 Jens Jensen 1 Jens.jensen@etvaliddomain.dk D02 Hans Hansen D03 Jens Jensen D04 1 Bemærk, at selvom eksemplerne på format visuelt strækker sig over flere linjer, betyder det ikke, at den fysiske record kan være over flere linjer. Dok. 13/ /101

29 Adskillelsessymbol for felterne er pipe-symbolet (7C) Et pipe-symbol inden i et felt er ikke tilladt Ingen specielle start/slut rækker og ingen kolonneoverskrift Linjer (records) skal afsluttes af CR/LF, (0D0A). Windows-kompatibel Udover CR/LF ved linjeslut, må migreringsfilen ikke indeholde linjeskift-symbolet (0A) Det anvendte tegnsæt skal være UTF-8 Hvis et felt er tomt, skal adskillelsessymbol stadig være til stede Dok. 13/ /101

30 3.4 Type 4 prettelse af nye målepunktstyper Filtype 4 bruges til at oprette nye målepunkter. Der er kun tale om tekniske målepunkter og alle skal være baseret på de i Engrosmodellen specificerede nye målepunktstyper der løber fra D04 til og med D12. Ingen af de oprettede målepunkter vil være synlige i Datahub før efter G-live. Dette skyldes at alle type 4 målepunkter sættes til inaktiv under migreringsload. De nye målepunkter er fysisk oprettet i Datahub og man kan derfor ikke benytte et type 4 målepunktsid i Datahub. (det er fx ikke muligt at oprette et ny målepunkt med samme id som allerede findes i filtype 4) Målepunkter fra filtype 4 vil ikke efter de er oprettet, skulle opdateres via filtype 5. Nye type 4 målepunkter, der i en tidligere migreringskørsel allerede er oprettet i Datahub, kan kun slettes og opdateres gennem brug af filtype 4. VIGTIGT Alle tidligere oprettede målepunkter der måtte mangle i en fremtidig version af den indsendte type 4 fil, vil blive slettet fra Datahub. Derved går de berørte målepunktsid er tabt og kan ikke genbruges i en senere migreringsfil til genoprettelse af målepunkter. I release 3 (forventes idriftsat uge 31) af datamigreringsløsningen indføres der en mulighed for at genbruge tidligere slettede målepunktsid er ifm. filtype 4 migreringer. Bemærk at nuværende regel gælder indtil migreringsløsningen er opdateret. De nye målepunktsstamdata fra netvirksomheden vil blive gemt i DataHub'en med en effectuation date, som er den samme dato som Go-Live datoen for DataHub Engrosmodellen (1. april 2016) Data Field-Name Data Type Mandatory / ptional Constraint METERING_PINT_ID VARCHAR2(18) M EAN-18 M Maximum: 3 E22 or E23 PHYSICAL_STATUS_F_METERING_PINT or D03 M Maximum: 3 D04 or D05 or D06 or D07 or D08 or D09 or D10 or D11 or D12 TYPE_F_METERING_PINT or D14 SUB_TYPE_F_METERING_PINT M Maximum: 3 D01 or D02 or D03 METERREADING_CCURENCE VARCHAR2(5) M : PT15M or PT1H or P1M Dok. 13/ /101

31 (VR.285) MAX_CURRENT NUMBER(3) Minimal: 0, Maximum: 3 MAX_PWER NUMBER(6) Minimal: 0, Maximum: 6 GRID_AREA_ID VARCHAR2(35) M Minimal: 1, Maximum: 35 LCATIN_DESCRIPTIN VARCHAR2(60) Minimal: 0, Maximum: 60 Minimal: 1, Maximum: or VARCHAR2(13) M or or or or PRDUCT M Minimal: 1, Maximum:3 K3 or KWH or KWT or MAW or MWH or TNE or UNIT_TYPE Z03 or Z14 MP_STREETNAME VARCHAR2(40) Minimal: 0, Maximum: 40 Minimal: 4, Maximum: 4 VARCHAR2(4) 4 digits 0001 to 9999 PS: Varchar2 because MP_STREETCDE Leading zero s MP_BUILDINGNR VARCHAR2(6) Minimal: 0, Maximum: 6 MP_FLR_ID VARCHAR2(2) Minimal: 0, Maximum: 2 MP_RM_ID VARCHAR2(4) Minimal: 0, Maximum: 4 MP_CITYSUBDIVISIN VARCHAR2(25) Dok. 13/ /101

32 Minimal: 0, Maximum: 25 Minimal: 4, Maximum: 4 VARCHAR2(4) 4 digits 0000 to 9999 PS: Varchar2 because Lead- MP_PSTCDE ing zero s MP_CITYNAME VARCHAR2(25) Minimal: 0, Maximum: 25 Minimal: 3, Maximum: 3 MP_MUNICIPALITY_CDE 3 digits 000 to 999 Alpha VARCHAR2(2) Minimal: 2, Maximum: 2 MP_CUNTRY_CDE DK PARENT_METERING_PINT_ID VARCHAR2(18) EAN-18 METER_ID VARCHAR2(15) Minimal: 0, Maximum: 15 METER_NR_F_DIGITS VARCHAR2(5) Minimal: 0, Maximum: 5 METER_CNVERSIN_FACTR *) NUMBER(12,4) Maximum: 3 KWH or METERREADING_UNIT MWH METERREADING_TYPE Maximum: 3 D01 or D02 ESTIMATED_ANNUAL_VLUME NUMBER(18) (positive >=0) MP_CAPACITY NUMBER (8) PWERPLANT_GSRN VARCHAR2(18) EAN-18 *) Feltet er 12 cifre langt med mulighed for 4 cifre efter komma separator (.) Valideringsregler Dok. 13/ /101

33 Tekniske valideringer Attribute Validation Availability check (is mandatory attribute) METERING_PINT_ID Data Type check (must contain only number values) Length check (length must be 18) PHYSICAL_STATUS_F_METERING_PINT TYPE_F_METERING_PINT SUB_TYPE_F_METERING_PINT METERREADING_CCURENCE Availability check (is mandatory attribute) Availability check (is mandatory attribute) Availability check (is mandatory attribute) Availability check (is mandatory attribute) MAX_CURRENT MAX_PWER GRID_AREA_ID Availability check (is mandatory attribute) LCATIN_DESCRIPTIN PRDUCT UNIT_TYPE Availability check (is mandatory attribute) Availability check (is mandatory attribute) MP_STREETNAME MP_STREETCDE MP_BUILDINGNR MP_FLR_ID MP_RM_ID MP_CITYSUBDIVISIN MP_PSTCDE Length check (length must be 4) MP_CITYNAME MP_MUNICIPALITY_CDE Constraint check, value must be between 100 and 999 MP_CUNTRY_CDE If available: Data Type check (must contain only number values) PARENT_METERING_PINT_ID METER_ID METER_NR_F_DIGITS If available: Length check (length must be 18) Availability check if SUB_TYPE_F_METERING_PINT = D01 (Physical) Availability check if SUB_TYPE_F_METERING_PINT = D01 Dok. 13/ /101

34 (Physical) Can contain the values 0-9 and. Length including. <= 5 Value >= 1 (0.99 not allowed) nly 1. allowed METER_CNVERSIN_FACTR METERREADING_UNIT METERREADING_TYPE Availability check if SUB_TYPE_F_METERING_PINT = D01 (Physical) Availability check if SUB_TYPE_F_METERING_PINT = D01 (Physical) Availability check if SUB_TYPE_F_METERING_PINT = D01 (Physical) Value must be positive >= 0 ESTIMATED_ANNUAL_VLUME MP_CAPACITY If available: Data Type check (must contain only number values) PWERPLANT_GSRN If available: Length check (length must be 18) Funktionelle valideringer Attribute Validation Metering Point is valid. METERING_PINT_ID 1) MeteringPoint doesn t exists in the staging area and doesn t exists in DataHub. 2) MeteringPoint exists in the staging area and has the identification that it is created from a new file(flat File 4) and exists in DataHub. MeteringPoint starts with digits 57 PHYSICAL_STATUS_F_METERING_PINT E22 or E23 or D03 TYPE_F_METERING_PINT SUB_TYPE_F_METERING_PINT METERREADING_CCURENCE Delivered value is one of the next values: (D04,D05,D06,D07,D08,D09,D10,D11,D12,D14) D01 or D02 or D03 (There are no restrictions between Type of MP and Sub type of MP) PT15M or PT1H or P1M MAX_CURRENT MAX_PWER Dok. 13/ /101

35 GRID_AREA_ID Must exists and Grid perator is registered as owner for this Grid Area LCATIN_DESCRIPTIN PRDUCT UNIT_TYPE or or or or or K3 or KWH or KWT or MAW or MWH or TNE or Z03 or Z14 MP_STREETNAME MP_STREETCDE Value between 0001 and 9999 MP_BUILDINGNR MP_FLR_ID MP_RM_ID MP_CITYSUBDIVISIN MP_PSTCDE Value between 0000 and 9999 MP_CITYNAME MP_MUNICIPALITY_CDE Value between 100 to 999 MP_CUNTRY_CDE DK Metering Point owner is the Grid perator from the Flat File PARENT_METERING_PINT_ID Metering Point exists in the DataHub Metering Point must not have the status Closed Down (PhysicalStatusfMP!= D02 ) (CCP227) METER_ID Can contain the values 0-9 and. Length including. <= 5 METER_NR_F_DIGITS Value > 1 (0.99 or 1.0 not allowed) METER_CNVERSIN_FACTR METERREADING_UNIT METERREADING_TYPE KWH or MWH D01 or D02 ESTIMATED_ANNUAL_VLUME MP_CAPACITY Attribute not allowed if TYPE_F_METERING_PINT = D04 or D14 PWERPLANT_GSRN Attribute not allowed if TYPE_F_METERING_PINT = Dok. 13/ /101

36 D04, D08, D09, D10, D11, D12, D14 For filtype 4 gælder yderligere at: Attribute Validation The PARENT_METERING_PINT_ID has the same GRID_AREA_ID PARENT_METERING_PINT_ID(if available) METERING_PINT_ID, PHYSICAL_STATUS_F_METERING_PINT The PARENT_METERING_PINT_ID has the TYPE_F_MP E17 or E18 MeteringPoint from Grid perator exists in the staging area and has the identification that it is created from a new file(flat File 4) and exists in DataHub and PHYSICAL_STATUS_F_METERING_PINT in DataHub is NT D02, but is not delivered in the current Flat File. This will result in a validation warning: Metering Point <METERING_PINT_ID> will be functional deleted and can t be used anymore. METERING_PINT_ID, PHYSICAL_STATUS_F_METERING_PINT MeteringPoint from Grid perator exists in the staging area and has the identification that it is created from a new file(flat File 4) and exists in DataHub and PHYSICAL_STATUS_F_METERING_PINT in DataHub is D02, and is delivered in the current Flat File This will result in a validation error: Metering Point <METERING_PINT_ID> is functional deleted in the DataHub and can t be delivered again. Følgende attributter skal som minimum være tilstede ved oprettelse af de nye målepunktstyper: New MeteringPoint Type Mandatory Attribute METERING_PINT_ID, PHYSICAL_STATUS_F_METERING_PINT, TYPE_F_METERING_PINT, SUB_TYPE_F_METERING_PINT, METERREADING_CCURENCE, GRID_AREA_ID, PRDUCT, UNIT_TYPE D04,D05,D06,D07,D08,D09,D10,D11,D12, D14 IF SUB_TYPE_F_METERING_PINT=D01(Physical) then also METER_ID, METER_NR_F_DIGITS, METER_CNVERSIN_FACTR, METERREADING_UNIT and METERREADING_TYPE are Mandatory IF SUB_TYPE_F_METERING_PINT!= D01(Physical) the attributes METER_ID, METER_NR_F_DIGITS, METER_CNVERSIN_FACTR, METERREADING_UNIT and METERREADING_TYPE must be EMPTY. Dok. 13/ /101

37 Mapning for nye målepunktstyper prettes midlertidigt med målepunktstype (Målepunkter kan ikke ses før efter cut-over) Målepunktstype angivet i migreringsfil (Denne sættes under cut-over) Beskrivelse D02 D04 Surplus production group 6 D03 D05 Net production D03 D06 Supply to grid D03 D07 Consumption from grid D02 D08 Wholesale services / information D02 D09 wn production D02 D10 Net from grid D02 D11 Net to grid D02 D12 Total consumption D02 D14 Electrical heating Filformat Der anvendes en CSV- fil til migreringen af tilknytningsdata. Det anvendte separatorsymbol er en lodret streg ( ). Det er vigtigt at pointere, at migreringsfilen er en ASCII- tekstfil, dvs. den må ikke indeholde nogen former for kontrolkoder ud over de to godkendte. Hver linje (record) afsluttes med en carrige return + line feed (CRLF). Data for et målpunkt skal være sammenhængende, dvs. data må ikke strække sig over flere linjer. Filen skal som minimum indeholde en linje. Der er intet max. antal linjer. Migreringsfil er en fuld liste, hvilket betyder, at alle netvirksomhedens tekniske målepunkter af typerne D04 til D14 (D13 undtaget), der ønskes oprettet inden Go-live af Engrosmodellen, skal være indeholdt i migreringsfilen. Hvis der sendes migreringsfiler med færre målepunkter end ved tidligere migreringer, vil de manglende målepunkter blive slettet. Det er altid seneste migreringsfil der bestemmer, hvilke tekniske målepunkter der findes i DataHub, når migreringen afsluttes inden cut-over. Format: Dok. 13/ /101

38 Felt1 felt2 felt3 felt4 felt5 felt6 felt7 felt8 felt9 felt10 felt11 felt12 felt13 felt14 felt15 felt16 felt17 felt18 felt19 felt20 felt21 felt22 felt23 felt24 felt25 felt26 felt27 felt28 felt29 felt30crlf Feltrækkefølge: <METERING_PINT_ID> <PHYSICAL_STATUS_F_METERING_PINT> <TYPE_F_METERING_PINT> <SUB _TYPE_F_METERING_PINT> <METERREADING_CCURENCE> <MAX_CURRENT> <MAX_PWER> <GRID_ AREA_ID> <LCATIN_DESCRIPTIN> <PRDUCT> <UNIT_TYPE> <MP_STREETNAME> <MP_STREETCDE > <MP_BUILDINGNR> <MP_FLR_ID> <MP_RM_ID> <MP_CITYSUBDIVISIN> <MP_PSTCDE> <MP _CITYNAME> <MP_MUNICIPALITY_CDE> <MP_CUNTRY_CDE> <PARENT_METERING_PINT_ID> <METE R_ID> <METER_NR_F_DIGITS> <METER_CNVERSIN_FACTR> <METERREADING_UNIT> <METERREADI NG_TYPE> < ESTIMATED_ANNUAL_VLUME > <MP_CAPACITY> <PWERPLANT_GSRN>CRLF Eksempel: Adskillelsessymbol for felterne er pipe-symbolet (7C) Et pipe-symbol inden i et felt er ikke tilladt Ingen specielle start/slut rækker og ingen kolonneoverskrift Linjer (records) skal afsluttes af CR/LF, (0D0A). Windows-kompatibel Udover CR/LF ved linjeslut, må migreringsfilen ikke indeholde linjeskift-symbolet (0A) Det anvendte tegnsæt skal være UTF-8 Hvis et felt er tomt, skal adskillelsessymbol stadig være til stede Dok. 13/ /101