Elhub - Milepæl 2 Uttrekk av grunndata til DAM Versjon 1.0 28.08.2015
Innhold Figurer... 1 Endringslogg... 2 1. Bakgrunn... 3 2. Hvordan sende inn data... 3 2.1 Før man lager uttrekk... 3 2.2 Hvordan laste opp uttrekk... 3 3. Brukerveiledning for DAM... 4 3.1 Pålogging... 4 3.2 Opplasting... 4 3.3 Rapportside... 6 3.4 Feilsøking... 8 3.4.1 Opplasting tar veldig lang tid... 8 3.4.2 Antallet rapporterte feil stemmer ikke overens med antallet faktiske feil... 8 3.4.3 Formatsjekk starter aldri, eller det står at formatsjekk har startet, men ingen rapport er tilgjengelig... 8 Elhub - Milepæl 2 Innhold
Figurer Figur 1 Innloggingsbilde DAM... 4 Figur 2 Opplastingsside - filvelger... 4 Figur 3 Opplastingsside - filer valgt... 5 Figur 4 Rapportside - Før prosessering... 6 Figur 5 Rapportside etter prosessering... 7 Figur 6 Rapport med delvis avvist fil... 7 Figur 7 Dialog med detaljert feilmelding... 8 Elhub - Milepæl 2 Innhold
Endringslogg Dato Versjon Endring 27.08.2015 0.9 Første versjon 28.08.2015 1.0 Publisert versjon Elhub - Milepæl 2 Innhold
1. Bakgrunn Milepæl M2 innebærer at alle aktører i kraftmarkedet skal gjøre uttrekk fra sine systemer og sende disse inn til Elhub via migreringsverktøyet DAM (Data Analysis and Migration tool). Formålet med uttrekket er tredelt: - Sikre at alle aktørene har mulighet til å gjøre uttrekk - Skaffe en bedre oversikt over mengden data Elhub skal migrere - Få opp infrastrukturen påkrevd for migrering Hva skal sendes inn: - Alle aktive målepunkter, kunder og kontrakter på alle GLN tilhørende aktøren du representerer - Historikk som angitt i spesifikasjonen er valgfritt i dette uttrekket Kvalitet på dette uttrekket vil ikke måles. Elhub vil lage statistikk for bruk internt og distribusjon på elhub.no, men da kun på overordnet nivå for hele bransjen. 2. Hvordan sende inn data 2.1 Før man lager uttrekk Det er viktig å ha i bakhodet at dataene som skal sendes inn er å anse som sensitive. De inneholder både personopplysninger og informasjon om markedet. Elhub tar hånd om dataene på en sikker måte så snart de er lastet opp, men viktig at de ikke kommer på avveie før dette skjer. Format på uttrekket er definert i filspesifikasjonene som er publisert på Elhub.no, http://elhub.no/nb/pages/50-filformater-og-prosedyrer. Hvordan man gjør uttrekkene må avtales med egen systemleverandør. Det er verdt å merke seg at dersom man skal laste opp uttrekk for mer enn én aktør, eller en aktør med flere GLN, må disse deles opp i én GLN pr. fil. 2.2 Hvordan laste opp uttrekk Når uttrekket er gjort kan dette lastes opp. I versjon 1 gjøres dette via applikasjonen tilgjengeliggjort på https://dam.elhub.no. Brukernavnet her er epost-adressen som ble oppgitt i datakvalitetsundersøkelsen utført tidligere i år, og passord vil bli distribuert til telefonnummeret oppgitt i samme. I neste versjon av DAM vil pålogging utføres ved hjelp av ID-portalen som krever fødselsnummer for autentisering. Vi vil derfor hente inn dette før neste versjon av DAM. Det er også en brannmur her som hindrer at uvedkommende skal ha tilgang. Dersom denne siden ikke laster er det fordi din IP-adresse ikke er lagt inn i brannmuren. Derfor viktig at man svarer på Elhub - Milepæl 2 side 3
mailen som er sendt ut med informasjon om innsending av egen IP-adresse så fort som mulig. Egen ekstern IP-adresse kan finnes ved å besøke f.eks. http://minip.no. Dette må gjøres fra samme lokasjon som man skal laste opp filer fra. Dersom man ikke har mottatt passord eller siden ikke laster fordi brannmuren ikke er åpen, ta kontakt på migrering@elhub.no. For detaljer om hvordan man bruker DAM-verktøyet, se neste kapittel. 3. Brukerveiledning for DAM 3.1 Pålogging Det første man må gjøre er å logge inn. Brukernavnet er eposten som ble oppført i datakvalitetsundersøkelsen, og passordet vil bli distribuert på SMS. Figur 1 Innloggingsbilde DAM 3.2 Opplasting Etter vellykket innlogging vil man bli presentert med følgende bilde. Her kan man velge å benytte filvelgeren, ved å trykket på knappen markert i «Figur 2 Opplastingsside - filvelgerfeil! Fant ikke Figur 2 Opplastingsside - filvelger Elhub - Milepæl 2 side 4
referansekilden.». Et alternativ til dette er å «dra» filene inn fra Explorer og «droppe» disse i samme område. Når filene som skal lastes opp er lagt til, trykker man på knappen i «Figur 3 Opplastingsside - filer valgt» for å gjennomføre opplastingen. Avhengig av filstørrelse kan dette ta fra noen sekunder til Figur 3 Opplastingsside - filer valgt flere minutter. Mens man laster opp vil man få en «framdriftsindikator» som viser hvordan opplastingen går. Når en fil er lastet opp, det være seg enten vellykket eller dersom noe er feil i filnavn eller lignende, vil det dukke opp et lite sprettoppvindu oppe i høyre hjørne som indikerer hvordan opplastningen gikk. Elhub - Milepæl 2 side 5
Figur 4 Rapportside - Før prosessering 3.3 Rapportside Etter en opplasting er det også mulig å navigere til rapportsiden. Den vil vise fremdriften på de individuelle filene og hvordan det har gått med formatsjekk om den er kjørt. I «Figur 4 Rapportside - Før prosessering» ser man hvordan rapportsiden vil se ut før formatsjekk er kjørt på en fil. Det er verdt å merke seg at formatsjekken ikke starter umiddelbart etter opplasting. Den vil bli prosessert ved neste batchkjøring, og status på filen vil ikke være tilgjengelig før dette er gjort. Elhub - Milepæl 2 side 6
Figur 5 Rapportside etter prosessering Når batchen er kjørt, og formatsjekken er gjennomført på en fil vil bildet ved neste lasting se ut som i «Figur 5 Rapportside etter prosessering». De to kolonnene som er relevante i denne versjonen av DAM er henholdsvis «Filsjekk» og «Formatsjekk». Dersom hele innholdet i filen er OK, og ingen av linjene inneholder feil, vil fargen på de to kolonnene være grønn. Dersom én eller flere av linjene i en fil er feil, vil «Formatsjekk»-kolonnen indikere hvor Figur 6 Rapport med delvis avvist fil mange prosent av linjene i filen som er korrekte, og «Filsjekk»-kolonnen vil også bli gul, som i «Figur 6 Rapport med delvis avvist fil». For detaljer om hva som er feil i filen er det mulig å klikke på lenken «Klikk her for detaljer». Når man gjør dette vil man få opp en dialog som i «Figur 7 Dialog med Elhub - Milepæl 2 side 7
detaljert feilmelding». Denne dialogen er gruppert på feilkode, og angir antall og hvilke linjer som er feil. 3.4 Feilsøking Figur 7 Dialog med detaljert feilmelding I slike uttrekk er det utallige feilsituasjoner som kan oppstå. For å gjøre arbeidet med å finne årsaken til feil som oppstår er det publisert en liste med feilkoder på elhub.no (http://elhub.no/nb/pages/50- Filformater-og-prosedyrer). Feilkoden det refereres til i «Figur 7 Dialog med detaljert feilmelding» vil gjenfinnes i dette dokumentet, med en forklaring på hva som er årsaken til feilen. 3.4.1 Opplasting tar veldig lang tid Dersom filene som lastes opp er veldig store, så vil det ta lang tid å laste opp, avhengig av hastigheten på egen internettforbindelse og hvor mange andre som laster opp filer i øyeblikket. Dersom filene ikke er store, og det allikevel tar veldig lang tid kan man prøve å logge ut av DAM, logge inn igjen og forsøke på nytt. 3.4.2 Antallet rapporterte feil stemmer ikke overens med antallet faktiske feil Dette oppstår gjerne om det er noe systematisk feil i uttrekket og alle linjene i en fil inneholder samme feil. Årsaken til dette er at dersom det er for mange kritiske feil i en fil, vil prosesseringen avbrytes, og antallet feil vil da ikke nødvendigvis stemme overens med tallet som rapporteres. 3.4.3 Formatsjekk starter aldri, eller det står at formatsjekk har startet, men ingen rapport er tilgjengelig Rapporter på formatsjekk kjøres jevnlig, så dersom det går mer enn 30 minutter, og ingen rapport på filen er tilgjengelig, ta kontakt på migrering@elhub.no. Dersom det står at formatsjekk har startet, men det tar uforholdsmessig lang tid å prosessere filen (over 10 minutter) er det et tegn på at noe har gått galt i DAM. Ta kontakt på migrering@elhub.no. Elhub - Milepæl 2 side 8
3.4.4 Kontraktfilen gir følgende feilmelding: «Field GridAccessProvider/BalanceSupplierUsed in file CONTRACT has illegal reference for this user or market party» Dersom man laster opp en fil som refererer til en GLN du ikke har fått tilgang til vil DAM-verktøyet rapportere om dette. Dersom du skal ha tilgang til denne GLNen, ta kontakt på migrering@elhub.no. Elhub - Milepæl 2 side 9