Opstartsvejledning ATS aktørudgave 7. september 2012 XHLG/NLJ 1/13
1. ATS vejledning for aktører Formålet med dette dokument er at beskrive, hvordan I kommer i gang med at anvende ATS til test af certifikat og til systemtest af XML og/eller EDIFACT meddelelser. For at komme i gang, er det en forudsætning, at I har et klientcertifikat. For yderligere information om certifikater, se venligst under tekniske specifikationer på: http://energinet.dk/da/el/datahub/sider/tekniske-specifikationer.aspx Når I har et klientcertifikat, skal det sendes til mailto:datahub@energinet.dk?subject=ats testsystem. Formatet skal være en base64 kodet.cer fil. Du skal ikke eksportere din private nøgle i den fil, som du sender til os. Du skal give filen et andet navn, så den f.eks. ender på.txt, da den ellers kan forsvinde i vores spamfilter eksempelvis mitcertifikat.cer.txt... I skal endvidere angive ønsket brugernavn, e-mail adresse og telefonnummer. Energinet.dk opretter jer herefter som bruger i ATS med basisinformation og adgang til default sæt af testdata. I får efterfølgende tilsendt oplysninger om brugeradgang og password. ATS består af et website, hvor I kan se egne data, klargøre tests og se resultatet af testene. Ud over websitet er der en service til at kommunikere med jeres system under de enkelte tests jeres system skal pege på denne adresse: https://datahub-ats.energinet.dk/datahubats/datahubats.svc Det er muligt for den enkelte aktør at teste om ATS-systemet accepterer ens certifikat ved hjælp af en browser (Internet Explorer, Firefox, Chrome) ved at åbne denne side: https://datahub-ats.energinet.dk/datahubats/ Ved brug af Microsoft Internet Explorer vil der vises nedenstående dialog, hvor man kan vælge imellem de certifikater, som er installeret for den aktuelle bruger: Dok. 88271-12_v1, Sag 10/3365 2/13
Hvis det valgte certifikat accepteres af ATS-serveren, vises denne side: Alternativt får man en fejlmeddelelse: De hyppigste årsager, til at et certifikat ikke accepteres, er: Blokering i proxy server på aktørens netværk Manglende privat nøgle i certifikat Certifikatets rodcertifikat er ikke kendt af ATS Det tilsvarende rodcertifikat er ikke installeret på klientens maskine Dok. 88271-12_v1, Sag 10/3365 3/13
2. ATS Arkitektur ATS udstiller det samme webservice interface som DataHub, og via dette tillades udveksling af foruddefinerede beskeder jævnfør testbeskrivelserne i dokumentet Testcases til Systemtest - for it-leverandører i det danske elmarked. Nedenstående illustration viser, hvorledes et IT-system (til venstre i billedet) kan kommunikere med ATS via Webservice grænsefladen, som defineret i Forskrift F1. Aktører identificerer sig overfor ATS ved hjælp af deres klientcertifikat. Før en test påbegyndes, skal aktøren sørge for, at der findes stamdata for de målepunkter, som skal benyttes i testen i begge systemer. Hvis aktøren ønsker at benytte egne data, kan disse indlæses i ATS ved hjælp af funktionen Upload TestData. Dernæst skal aktøren vælge, hvilken test som skal udføres, så ATS-systemet kan opsætte de korrekte valideringer af indkommende beskeder og på samme måde generere udgående meddelelser med de rigtige data. Figuren viser systemets opbygning Dok. 88271-12_v1, Sag 10/3365 4/13
3. ATS website 3.1 Home fanebladet I logger ind på ATS (https://datahub-ats.energinet.dk/datahubatsweb ). På home kan I finde information om, hvilke testcases der aktuelt er klar til test, hvornår systemet er tilgængeligt og link til yderligere information. Dok. 88271-12_v1, Sag 10/3365 5/13
3.2 Player info Punktet Player info giver mulighed for at oprette/tilrette egne oplysninger som f.eks. kontaktoplysninger, om man ønsker at teste XML eller EDIFACT (kan skiftes dynamisk), netområde, leverandør id, balanceansvarlig etc. Øverst er der en faktaboks med kort introduktion til funktionaliteten. Klik på More information for mere forklaring. Nederst er der en markering af, om I skal teste som IT-leverandør (vendor) eller som aktør (player). Valget afgør, hvilke testcases der stilles til rådighed for jeres test. I kan desuden afkrydse hvilken rolle I ønsker at teste som elleverandør, netselskab eller balanceansvarlig. Dok. 88271-12_v1, Sag 10/3365 6/13
Aktuel status på de testcases, I har gennemført, fås ved at klikke på linket status on testcases under faktaboksen. Status vises for de enkelte roller, man kan teste som. I skal derfor ikke have grønt lys hele vejen ned, men kun i den rolle I aktuelt tester (f.eks. Net company Player ). Dok. 88271-12_v1, Sag 10/3365 7/13
3.3 Upload testdata Under Upload testdata kan I bestemme, om I vil anvende de standardtestdata, vi stiller til rådighed, eller I vil uploade jeres egne testdata. I kan se standardtestdatasættet under linket: Download testdata template file. Upload af egne data sker via Gennemse knappen, find testdata sættet og klik OK-knappen. I kan se egne testdata under linket: Own metering point data. Brug More information i faktaboksen for yderligere detaljer! Dok. 88271-12_v1, Sag 10/3365 8/13
3.4 Prepare test I starter en testkørsel ved at angive testcase nummer og målepunkt (hvis et målepunkt er nødvendigt for testen). I kan se, om der er testcases, som ikke virker. Det vil i givet fald være beskrevet under henholdsvis XML og EDIFACT statusangivelserne. Alle testcases starter med P eller N. Når I starter med at taste i testcasefeltet, vil en dropdown med de mulige testcases vises. Værdilisten med de mulige testcases afpasses dynamisk efter hvilken rolle, I har afkrydset under player info. For Metering points felterne vil dropdown listen indeholde de målepunkter, der er i de aktuelle testdata. Når de nødvendige felter for testcasen er udfyldt, klikkes på Prepare test knappen, og meddelelser udveksles mellem ATS og aktørens system jævnfør testcase. Dok. 88271-12_v1, Sag 10/3365 9/13
3.5 Latest runs Under dette punkt vises resultatet for senest kørte test pr testcase. I har mulighed for at se den seneste status for hver enkelt gennemført test. Der er mulighed for filtrering på status, kategori (netselskab/balanceansvarlig/ ) og format (XML/EDIFACT/begge). Klik på Get for at få hentet aktuel status. Dok. 88271-12_v1, Sag 10/3365 10/13
Ved klik på Show testrun, vises de detaljerede oplysninger om den enkelte kørsel. I kan så bruge linkene til at se detaljer om kørslen og de gennemførte steps, se indhold i meddelelserne mv. Hvis I får status Failed på testcasen, kan det skyldes en række forskellige ting. Det kan for eksempel være jeres testdata, det kan være manglende målepunkt eller fejl i jeres IT-system. Hvis I ikke umiddelbart kan afgøre, hvilken type fejl der er tale om, bør I kontakte jeres IT-leverandør for en yderligere detaljering af fejlen og besked om, hvordan I kan undgå den (fejl i testdata eller lignende). Dok. 88271-12_v1, Sag 10/3365 11/13
3.6 Test run list Her er en tilsvarende søgefunktionalitet som i Latest runs, men alle resultater vises. Der er mulighed for at begrænse til givent dato og tidsinterval og en specifik testcase. Her kan I finde tidligere gennemførte kørsler og har også her mulighed for at klikke videre ned i detaljen for de enkelte testcasekørsler. Dok. 88271-12_v1, Sag 10/3365 12/13
3.7 FAQ sektion Under FAQ sektionen er der links til forskellige vejledninger og til de hyppigst forekommende supportspørgsmål. Siden udbygges løbende, når der udarbejdes ny dokumentation / præciseringer, så klik ind på den for at se, om der er information, I kan bruge. Dok. 88271-12_v1, Sag 10/3365 13/13