Oktober 2013 HLG/XIGA Opstartsvejledning ATS Engros 1/12
1. ATS Engros vejledning for aktører Formålet med dette dokument er at beskrive, hvordan du kommer i gang med at anvende ATS til test af certifikat og til systemtest af XML meddelelser. 1.1 ATS og ATS Engros Vi har to versioner af ATS. ATS som bruges til Datahub som den er i dag og ATS Engros som bruges til at teste meddelelser til den kommende Engros model. ATS Engros er en opdateret version af ATS og indeholder nye stamdata der er specifikke for Engros udvidelsen samt nye testcases og beskeder der skal bruges til at teste de nye forretningsgange. ATS Engros består af et website, hvor du kan se egne data, klargøre tests og se resultatet af testene. Ud over websitet er der en service til at kommunikere med dit system under de enkelte tests dit system skal pege på: ATS Engros: https://datahub-ats.energinet.dk/datahubatsengros/datahubats.svc 1.2 Information om certifikater For at komme i gang, er det en forudsætning, at du har et klientcertifikat. For yderligere information om certifikater, se venligst under tekniske specifikationer (nederst til højre) på: http://energinet.dk/da/el/datahub/sider/datahub.aspx 1.3 Oprettelse af bruger inkl. certifikat OBS: Hvis du er oprettet som bruger i dag på ATS vil I automatisk være oprettet på ATS Engros med samme bruger og certifikat. Hvis du er ny bruger eller du ønsker at anvende et andet certifikat, skal klientcertifikatet 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... Du skal endvidere angive ønsket brugernavn, e-mail adresse og telefonnummer. Energinet.dk opretter dig herefter som bruger i ATS Engros med basisinformation og adgang til default sæt af testdata. Du får efterfølgende tilsendt oplysninger om brugeradgang og password. 1.4 Test af certifikat Det er muligt for den enkelte aktør at teste om ATS-systemet accepterer dit certifikat ved hjælp af en browser (Internet Explorer, Firefox, Chrome) ved at åbne: ATS Engros: https://datahub-ats.energinet.dk/datahubatsengros/ Ved brug af Microsoft Internet Explorer vil der vises nedenstående dialog, hvor du kan vælge imellem de certifikater, som er installeret for din aktuelle bruger: Dok. 13/81169-2 2/12
Hvis det valgte certifikat accepteres af ATS-serveren, vises denne side: Alternativt får du 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 Engros Det tilsvarende rodcertifikat er ikke installeret på klientens maskine Dok. 13/81169-2 3/12
2. ATS Engros Arkitektur ATS Engros udstiller det samme webservice interface som DataHub, og via dette tillades udveksling af foruddefinerede beskeder jævnfør testbeskrivelserne. Dokument med testbeskrivelser vil blive lagt under FAQ sektionen i ATS. 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. 13/81169-2 4/12
3. ATS Engros website 3.1 Home fanebladet Du logger ind på ATS Engros (https://datahub-ats.energinet.dk/datahubatswebengros). På home kan du finde information om, hvilke testcases der aktuelt er klar til test, hvornår systemet er tilgængeligt og link til yderligere information. Dok. 13/81169-2 5/12
3.2 Player info Punktet Player info giver mulighed for at oprette/tilrette egne oplysninger som f.eks. kontaktoplysninger, 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 du skal teste som IT-leverandør (vendor) eller som aktør (player). Valget afgør, hvilke testcases der stilles til rådighed for din test. Du kan desuden afkrydse hvilken rolle du ønsker at teste som elleverandør, netselskab eller balanceansvarlig. Dok. 13/81169-2 6/12
Aktuel status på de testcases, du har gennemført, fås ved at klikke på linket status on testcases under faktaboksen. Status vises for de enkelte roller, du kan teste som. Du skal derfor ikke have grønt lys hele vejen ned, men kun i den rolle du aktuelt tester (f.eks. Net company Player ). Dok. 13/81169-2 7/12
3.3 Upload testdata Under Upload testdata kan I bestemme, om du vil anvende de standardtestdata, vi stiller til rådighed, eller du vil uploade jeres egne testdata. Testdata omfatter stamdata for målepunkt, adresser, angivelse af abonnementer, tariffer og gebyrer. Stamdata skal defineres i excel skabelon. Vejledning til udfyldelse af dette står på første fane i excel arket som kan downloades ved at trykke på linket nederst ved Download testdata template file Dok. 13/81169-2 8/12
3.4 Prepare test Du starter en testkørsel ved at angive testcase nummer og evt. målepunkt. Du kan se, om der er testcases, som ikke virker. Det vil i givet fald være beskrevet under statusangivelsen. Alle testcases starter med P eller N. Når du starter med at taste i testcase feltet, vil en dropdown med de mulige testcases vises. Værdilisten med de mulige testcases afpasses dynamisk efter hvilken rolle, du 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. 13/81169-2 9/12
3.5 Latest runs Under dette punkt vises resultatet for senest kørte test pr testcase. Du har mulighed for at se den seneste status for hver enkelt gennemført test. Der er mulighed for filtrering på status, kategori (netselskab/balanceansvarlig/ ). Klik på Get for at få hentet aktuel status. Dok. 13/81169-2 10/12
Ved klik på Show testrun, vises de detaljerede oplysninger om den enkelte kørsel. Du kan så bruge linkene til at se detaljer om kørslen og de gennemførte steps, se indhold i meddelelserne mv. Hvis du får status Failed på testcasen, kan det skyldes en række forskellige ting. Det kan for eksempel være dine testdata, det kan være manglende målepunkt eller fejl i dit IT-system. Hvis du ikke umiddelbart kan afgøre, hvilken type fejl der er tale om, bør du kontakte jeres ITleverandør/systemadministrator for en yderligere detaljering af fejlen og besked om, hvordan du kan undgå den (fejl i testdata eller lignende). Dok. 13/81169-2 11/12
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 du finde tidligere gennemførte kørsler og har også her mulighed for at klikke videre ned i detaljen for de enkelte testcase kørsler. 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, du kan bruge. Dok. 13/81169-2 12/12