EDIELtest testiportaalin käyttöohje

testiportaalin käyttöohje Versio Kuvaus Laatija V1.0 22.9.2008 Alkuperäinen T.Tervo V1.1 3.10.2008 Asiakkaan nimen (NAD+UV, NAD+ IV) saa kirjoittaa T.Tervo joko etunimi tai sukunimi ensin V1.2 7.10.2008 Päivitetty kpl 2.5 taulukot ja näyttökopiot kappaleisiin T.Tervo 5.4 ja 6 V1.3 29.10.2008 Korjattu ohjeistusta kappaleeseen 8.5 Testattavan T.Tervo järjestelmän yhteystiedot V1.4 20.05.2014 Päivitetty ohjeita J Riihiluoma V1.5 17.6.2014 Päivitetty ohjeita M Arffman

2 (34) Sisällysluettelo EDIELtest testiportaalin käyttöohje... 1 1 Johdanto... 4 1.1 Dokumentin sisältö... 4 1.2 Testauksen tarkoitus... 4 1.3 Testauksen perusteet... 5 1.4 Dokumentissa käytetty terminologia... 6 2 Yleistä testauksesta... 7 2.1 Testattavien roolit (JHTM, JHTJ, OHTM, OHTJ)... 7 2.1.1 Järjestelmän hyväksyntä (JHTM, JHTJ)... 7 2.1.2 Osapuolen hyväksyntä (OHTM, OHTJ)... 8 2.2 Testauksen tietoliikenne... 8 2.3 Aikaleimojen tulkinta testauksessa... 8 2.4 Hyväksyntäkriteerit... 9 2.5 Hyväksyntään vaadittavat testitapaukset... 10 2.5.1 Sähkön myyjä... 10 2.5.2 Jakeluverkon haltija... 11 2.6 Testausjärjestelmän toiminnasta... 11 2.7 Käyttötapausten ja testitapausten numerointi... 12 2.8 Testauspalvelun osoitetiedot... 13 3 Testauksen kulku... 14 3.1 Testauksen aloittaminen... 14 3.2 Testien suorittaminen... 15 3.3 Testien tulosten seuraaminen ja hyväksyntä... 15 4 Järjestelmään kirjautuminen... 16 4.1 Kirjautuminen EDIELtest portaaliin... 16 5 Testiportaalin näytöt... 17 5.1 Pääsivu... 17 5.1.1 Testaajan rooli... 18 5.2 Järjestelmän hyväksyntä... 19 5.3 Osapuolen hyväksyntä... 20 5.4 Sanomaloki... 23 5.5 Yksittäisen sanoman testaaminen... 28 6 Yhteenveto testien hyväksyntänäytöistä... 29 6.1 Järjestelmän hyväksyntä / Myyjän testaus (JHTM)... 29

3 (34) 6.2 Järjestelmän hyväksyntä / Jakeluverkon haltijan testaus (JHTJ)... 29 6.3 Osapuolen hyväksyntä / myyjä (OHTM)... 30 6.4 Osapuolen hyväksyntä / Jakeluverkon haltijan testaus (OHTJ)... 30 7 Dokumentaatio... 31 8 Asetukset... 32 8.1 Käyttäjätiedot... 33 8.2 Yhtiön tiedot... 33 8.3 Yhteyshenkilö... 33 8.4 Testattavan järjestelmän tiedot... 33 8.5 Testattavan järjestelmän yhteystiedot... 33

4 (34) 1 Johdanto 1.1 Dokumentin sisältö Tämä dokumentti sisältää kuvauksen Suomessa PRODAT sanomaliikenteen sertifiointitestaukseen käytettävän testauskäytännön toiminnasta ja testausjärjestelmän käyttöohjeen. Testien yksityiskohtainen kulku ja niiden tietosisältö on esitetty sähkön myyjän testien osalta testausohjeessa (erillinen dokumentti): PRODAT testaus- ja sertifiointipalvelu: JÄRJESTELMÄN HYVÄKSYNTÄTESTI / SÄHKÖN MYYJÄ SÄHKÖMARKKINAOSAPUOLEN HYVÄKSYNTÄTESTI / SÄHKÖN MYYJÄ ja jakeluverkon haltijan testien osalta testausohjeessa (erillinen dokumentti): PRODAT testaus- ja sertifiointipalvelu: JÄRJESTELMÄN HYVÄKSYNTÄTESTI / JAKELUVERKON HALTIJA SÄHKÖMARKKINAOSAPUOLEN HYVÄKSYNTÄTESTI / JAKELUVERKON HALTIJA. Sertifiointitestauksessa määritellyt sanomaketjut ovat käyttäjien käytettävissä myös sertifioinnin jälkeen. Käyttäjä voi siis testata sanomaprosessiensa toimivuutta myös myöhemmin esim. järjestelmäpäivityksen jälkeen. Portaalissa voi testata myös yksittäisiä PRODAT -sanomia. Ohjeet yksittäisen sanomien testaamiseen löytyvät kappaleesta 5.5. 1.2 Testauksen tarkoitus Testaus- ja sertifiointipalvelun tarkoituksena on varmistaa, että markkinaosapuolten järjestelmät toimivat sovitusti ja niiden lähettämät PRODAT -sanomat ovat muodoltaan oikeita ja sovitun standardin mukaisia. Keskeisenä tavoitteena on poistaa merkittävä osa sanomaliikenteen järjestelmiin liittyvistä tulkinta- ja yhteensopimattomuusvirheistä ja sitä kautta säästää kaikkien sähkömarkkinaosapuolien rahaa ja aikaa. Testaus- ja sertifiointipalvelu toteutetaan osapalveluina seuraavasti: 1. Järjestelmätoimittajan tuotteen testaus ja sertifiointi - käytössä olevan tietojärjestelmän toimivuuden testaaminen Sanomaliikenteen menettelyohjeen mukaisesti - uuden, markkinoille tulevan järjestelmän toiminnan testaaminen menettelyohjeen mukaisesti

5 (34) 1.3 Testauksen perusteet - testaus kattaa sähkömarkkinaosapuolten eri roolit, voidaan suorittaa erikseen sähkön myyjälle ja verkonhaltijalle vaikka kyseessä sama järjestelmä. 2. Järjestelmätoimittajan sertifioidun tuotteen uusintatestaus ja sertifiointi - kun järjestelmätoimittaja julkaisee uuden version järjestelmästä tai - järjestelmään on tehty sanomaliikenteeseen vaikuttavia toiminnallisia muutoksia. 3. Sähkömarkkinatoimijan järjestelmän ja testaus ja sertifiointi - edellytyksenä testaukselle on, että sähkömarkkinatoimijan käyttämällä järjestelmällä on kohdan 1 tai 2 mukainen järjestelmätoimittajan hankkima PRODAT -sertifiointi - testataan sähkömarkkinaosapuolen sanomaliikenteen toimivuus sen normaalissa toimintaympäristössä - testataan markkinaosapuolen tietojen oikeellisuus, kuten osapuolitunnukset, sanomien siirtotavat. Testit perustuvat säädöksiin, Energiateollisuus ry:n (ET) ja Fingrid Oyj:n (FG) julkaisemiin ohjeisiin sähkön vähittäismarkkinoilla käytävästä sanomaliikenteestä. Testausjärjestelmä simuloi testeissä testattavan osapuolen (esim. myyjä) vastakkaista osapuolta sanomaliikenteessä (esim. jakeluverkonhaltija). Testauksen toteutus perustuu seuraaviin dokumentteihin: - TEM: Työ- ja elinkeinoministeriön asetus sähköntoimitusten selvitykseen liittyvästä tiedonvaihdosta (809/2008) - ET: Sanomaliikenteen menettelyohje, Prodat ja Aperak, V1.4 (21.9.2007) - FG: Prodat inhouse määritykset ja syykoodit (päiv. 14.3.2013) - ET: Sähkömarkkinoiden käytännön menettelyohje III (21.9.2007) - ET: Ediel sanomavälityksen yleiset sovellusohjeet, V2.0 (19.10.2007) - Message handbook for Ediel: Functional Description, version 2.4A. - Message handbook for Ediel: Implementation guide for Product data message, version 2.4F. - Message handbook for Ediel: Implementation guide for Application error and Acknowledgement message, version 2.4B.

6 (34) 1.4 Dokumentissa käytetty terminologia Lyhenne tai määritelmä Käyttötapaus Testitapaus Testi JHTM OHTM JHTJ OHTJ EDIFACT Selite Asiakkaaseen kohdistuva toiminto, joka aiheuttaa PRODAT sanomaliikennettä kahden tai useamman sähkömarkkinaosapuolen välillä (esim. myyjän vaihto, mittarin luku tms.). Käyttötapaukseen liittyvät asiakasta koskevat tiedot määritellään testattavaan asiakasjärjestelmään. Yhtä käyttötapausta käytetään yhteen tai useampaan testitapaukseen. Käyttötapaukset on nimetty tyyliin KT_xx, jossa xx on käyttötapauksen yksilöivä numero. Käyttötapaukseen liittyvä PRODAT sanomaliikenne kahden sähkömarkkinaosapuolen välillä (esim. uusi myyjä / JVH). Testitapaukset on nimetty tyyliin Mxx (myyjän testitapaukset) tai JVHxx (jakeluverkon haltijan testitapaukset), jossa xx on testitapauksen yksilöivä numero. Yhden PRODAT sanoman ja sen kuittaussanoman käsittävä sanomaliikenne. Testitapauksien ryhmä joka sisältää järjestelmän hyväksyntätestejä sähkön myyjälle. Testitapauksien ryhmä joka sisältää osapuolen hyväksyntätestejä sähkön myyjälle. Testitapauksien ryhmä joka sisältää järjestelmän hyväksyntätestejä jakeluverkon haltijalle. Testitapauksien ryhmä joka sisältää osapuolen hyväksyntätestejä jakeluverkon haltijalle. EDIFACT -standardin mukainen sanomarakenne, jota käytetään energiatietojen siirtoon pohjoismaissa.

7 (34) Lyhenne tai määritelmä JVH Myyjä Testiportaali Selite Jakeluverkon haltija (sähkömarkkinaosapuoli) Sähkön myyjä (sähkömarkkinaosapuoli) EDIELtest portaali jonka kautta testaaja ohjaa testien suorittamista ja johon testien tulokset kirjautuvat. 2 Yleistä testauksesta 2.1 Testattavien roolit (JHTM, JHTJ, OHTM, OHTJ) Testaus jakautuu neljään erilliseen testikokonaisuuteen (rooliin), jotka testataan ja sertifioidaan itsenäisinä testikokonaisuuksina. Testaava taho valitsee sertifiointisopimusta tehtäessä minkä testikokonaisuuden hän haluaa suorittaa. Mahdolliset vaihtoehdot ovat: - järjestelmän hyväksyntä / myyjä (JHTM) - järjestelmän hyväksyntä / jakeluverkon haltija (JHTJ) - osapuolen hyväksyntä / myyjä (OHTM) - osapuolen hyväksyntä / jakeluverkon haltija (OHTJ) 2.1.1 Järjestelmän hyväksyntä (JHTM, JHTJ) Testaa järjestelmätoimittajan tuotteen sanomaliikenteen toimivuuden tarkasti sekä tiedonsiirron että sanomien sisällön osalta. Järjestelmän hyväksyntätestien testausohjeet on esitetty erillisessä dokumentissa (ks. kpl 1.1). Testaus kattaa: - Sanomien välittämisen (tiedonsiirto, osapuolitiedot, kuittaussanomat) - Sanomien rakenteen oikeellisuuden - Sanomien tietosisällön oikeellisuuden Testeissä käytetään etukäteen kiinteästi määriteltyjä käyttötapauksia (asiakastiedot, mittarilukemat jne.). Testit on rakennettu niin, että testattava saa testit suoritettua syöttämällä testeihin määriteltyjen käyttötapausten tiedot järjestelmäänsä ja

8 (34) suorittamalla tämän jälkeen normaalit markkinaohjeistuksen mukaiset toimenpiteet. 2.1.2 Osapuolen hyväksyntä (OHTM, OHTJ) 2.2 Testauksen tietoliikenne 2.3 Aikaleimojen tulkinta testauksessa Testaa sähkömarkkinaosapuolen sanomaliikenteen toimivuuden sen normaalissa toimintaympäristössään. Osapuolen hyväksyntätestien testausohjeet on esitetty erillisessä dokumentissa (ks. kpl 1.1). Sertifiointiin vaadittavat testit ovat osajoukko vastaavista järjestelmän hyväksyntätesteistä. Ne ovat siis teknisesti samoja testejä, myös sanomien tietosisällön tarkistamisen osalta. Sertifikaatin saamiseksi vaaditaan kuitenkin ainoastaan TEM:n asetuksessa Työ- ja elinkeinoministeriön asetus sähköntoimitusten selvitykseen liittyvästä tiedonvaihdosta (809/2008) mainittuihin toimintoihin liittyvän sanomaliikenteen testaaminen. Muilta osin testit ovat vapaaehtoisia, eivätkä vaikuta sertifikaatin saamiseen. Edellä mainittu dokumentti löytyy mm. EDIELtest portaalin dokumentaatiosta. Käyttötapauksissa vaihdettava tieto vastaa järjestelmän hyväksyntätesteissä käytettäviä tietoja. Testaus tapahtuu tavallisella säännösten mukaisella sanomaliikenteellä FTP -tiedonsiirtoa käyttäen. Jos asiakas käyttää virallista osapuolitunnustaan, lähetetään vastaussanomat vastaavaan viralliseen osoitteeseen. Jos vastaussanomat halutaan johonkin muuhun osoitteeseen, ei virallista osapuolitunnusta voi käyttää testauksessa. Kukin osapuoli vastaa itse omista yhteys- ja suojausmäärittelyistä FTP yhteyden saamiseksi testausjärjestelmään. FTP käyttäjätunnus ja salasana sovitaan tapauskohtaisesti. Ne osapuolet, jotka käyttävät sanomien välitykseen jonkun teleoperaattorin palvelua, voivat käyttää sitä myös sanomien testaukseen. Sanomissa esiintyvien alkamis- ja päättymisaikojen tulkinta tehdään dokumentin Ediel sanomaliikenteen yleiset sovellusohjeet liitteen 2 mukaisesti, josta ote seuraavassa kursiivilla. Sanomien sisältämissä alkamista tai voimaan tulemista kuvaavissa aikaleimoissa ilmoitetaan se ajanhetki, jonka alusta tapahtuma (toimitus, luentaväli tms.) alkaa tai tulee voimaan. Alkuhetki sisältyy tapahtumaan tai toimitukseen.

9 (34) 2.4 Hyväksyntäkriteerit Päättymistä kuvaavissa aikaleimoissa ilmoitetaan se ajanhetki, jonka alussa tapahtuma tai sen voimassaolo päättyy. Loppuhetki ei enää sisälly tapahtumaan tai toimitukseen. Näin ollen sopimuksen päättymisajankohta on samalla ensimmäinen hetki, jolloin uusi sopimus voi alkaa. Esimerkiksi jos sopimuksen irtisanomisaika on 14 vuorokautta ja sopimus irtisanotaan (eli testaus suoritetaan) 1.4.2014, niin sopimus päättyy 14 päivän päästä, eli 15.4.2014, ja näin ollen ensimmäinen ajanhetki, jolloin sopimus ei ole voimassa (tämä näkyy sanomassa päättymisajan aikaleimana) on 16.4.2014 00:00. Tässä tapauksessa uusi sopimus voi siis alkaa 15 päivän kuluttua, eli sanomassa alkamisajan aikaleimana on 16.4.2014 00:00, joka on sama ajanhetki kuin päättymisen ajanhetki. Jos testitapauksen kuvauksessa määritellään, että sopimus alkaa 14 päivän päästä ja testaus suoritetaan 1.4.2014, niin sopimus alkaa 15.4.2014 ja näin ollen sanomassa on alkamisajan aikaleimana 15.4.2014 00:00. Testien sisältö, vaadittava sanomasisältö ja testausohjeet on laadittu yhteistoimintana ET:n Sähkömarkkinoiden menettelytapojen kehitysryhmän, ET;n Teknisen käyttäjäryhmän ja Fingridin tiedonvaihtopalveluiden kanssa, perustuen alan ohjeistukseen. Testausjärjestelmä on käytettävissä testaukseen koko sen ajan, joka on määritelty asiakkaan kanssa tehdyssä sertifiointisopimuksessa. Vapaa sähkökauppa asettaa kuitenkin ajallisia rajoitteita sanomaliikenteelle. Tästä johtuen myös sertifioinnin hyväksymisen edellytyksenä on, että sertifiointiin vaadittavat testit on suoritettu tiettyjen määräaikojen sisällä. Lisäksi testausjärjestelmän tapa käsitellä alkamis- ja päättymisaikoja aiheuttaa, että yhteen testitapaukseen liittyvän sanomaliikenteen pitää tapahtua saman vuorokauden kuluessa. Hyväksyntään vaadittavat määräajat on esitetty seuraavassa kappaleessa. Hyväksyntäkriteerit täyttyvät, kun: - kyseessä olevan roolin sertifiointiin vaadittavat testit on suoritettu hyväksytysti - yhteen testitapaukseen liittyvien sanomien vaihto on tapahtunut kokonaisuudessaan yhden vuorokauden sisällä. - kaikkiin testitapauksiin liittyvien sanomien vaihto on tapahtunut 7 vrk:n sisällä

10 (34) 2.5 Hyväksyntään vaadittavat testitapaukset 2.5.1 Sähkön myyjä Seuraavissa kappaleissa olevien taulukoiden sarakeotsikoissa olevat termit on määritelty kappaleessa 1.4. Käyttötapausten numerointi on muotoa KT_xx, jossa xx on käyttötapauksen yksilöivä numero. Testitapausten numerointi on myyjän testeille muotoa Mxx ja jakeluverkon haltijan testeille JVHxx, jossa xx on testitapauksen yksilöivä numero. Alla olevassa taulukossa on esitetty mitkä testit vaaditaan sähkön myyjältä järjestelmän toimittajan hyväksyntään (JHTM) ja vastaavasti sähkömarkkinaosapuolen hyväksyntään (OHTM). Järjestelmän ja osapuolen hyväksyntään vaadittavat testit Käyttötapaus Testitapaus Järjestelmän hyväksyntä Osapuolen hyväksyntä KT_01 M01 kyllä kyllä KT_01 M02 kyllä kyllä KT_02 M03 kyllä kyllä KT_02 M04 kyllä kyllä KT_03 M05 kyllä kyllä KT_03 M06 kyllä kyllä KT_06 M10 kyllä ei KT_09 M15 kyllä ei KT_10 M16 kyllä ei KT_11 M17 kyllä ei KT_12 M18 kyllä ei KT_13 M19 kyllä ei KT_14 M20 kyllä ei KT_02 M21 kyllä ei

11 (34) 2.5.2 Jakeluverkon haltija Alla olevassa taulukossa on esitetty mitkä testit vaaditaan jakeluverkon haltijalta järjestelmän toimittajan hyväksyntään (JHTJ) ja vastaavasti sähkömarkkinaosapuolen hyväksyntään (OHTJ). 2.6 Testausjärjestelmän toiminnasta Järjestelmän ja osapuolen hyväksyntään vaadittavat testit Käyttötapaus Testitapaus Järjestelmän hyväksyntä Osapuolen hyväksyntä KT_01 JVH01 kyllä kyllä KT_02 JVH02 kyllä kyllä KT_03 JVH03 kyllä kyllä KT_03 JVH04 kyllä kyllä KT_09 JVH12 kyllä ei KT_10 JVH13 kyllä ei KT_11 JVH14 kyllä ei KT_12 JVH15 kyllä kyllä KT_13 JVH16 kyllä ei KT_14 JVH17 kyllä ei KT_15 JVH18 kyllä ei Testausjärjestelmä on määritelty tunnistamaan tarkalleen etukäteen määriteltyjä testitapauksia, jotka saadaan aikaiseksi, kun testattavaan järjestelmään määritellään testeihin liitettyjen käyttötapausten tiedot. Testausjärjestelmässä saattaa esiintyä muutamien minuuttien viiveitä ennen kuin järjestelmä lähettää vastaussanoman tai kirjoittaa lokiviestin tapahtumasta testiportaaliin. Tämä kannattaa huomioida testauksessa varsinkin testiportaalista käynnistettävien testitapausten kohdalla. Testausjärjestelmään tulevien sanomien tunnistaminen tiettyyn testitapaukseen kuuluvaksi tapahtuu pääosin sanomatyypin (Zxx) ja syykoodin perusteella. Tällä ei saada kuitenkaan tunnistettua kaikkia testitapauksia, koska osassa testeistä esiintyy samoja sanomia. Tällaiset testit erotetaan toisistaan sanoman tietosisällön perusteella. Edellä mainitusta johtuen, mikäli käyttötapauksiin liittyvät tiedot on määritelty väärin testattavaan järjestelmään, tai mikäli testattava sanoma rakennetaan väärin, voi testausjärjestelmä epäonnistua tulkinnassa, mihin testitapaukseen ko. sanoma kuuluu, tai joissakin tapauksissa liittää testin eri testitapaukseen kuin, mitä sanoman lähettäjä on tarkoittanut. Tämä saattaa aiheuttaa sekaannusta testausjärjestelmän kirjoittaman sanomalokin ymmärtämisessä. Puuttuvia lokiviestejä voi yrittää etsiä tulostamalla

12 (34) kaikkien testitapausten lokiviestit halutulta aikaväliltä ja etsimällä kaivattua lokiviestiä sen aikaleiman perusteella. Testausjärjestelmä edellyttää, että sanomissa käytetään osapuolten tunnuksille koodilistaa SLY sekä UNB että NAD segmenteissä. Koodilista on pakollinen tieto. Testausjärjestelmä edellyttää, että kaksiaikamittauksille CCI ja RFF segmentit on sijoitettu sanomissa jälkimmäisen LIN-segmentin jälkeen. Tämä on teknisen ryhmän suosittelema tapa ja testausjärjestelmä siis tukee ainoastaan sitä. Asiakkaan nimen (NAD+UV, NAD+ IV) voi kirjoittaa joko muodossa etunimi sukunimi tai sukunimi etunimi. 2.7 Käyttötapausten ja testitapausten numerointi Käyttötapaus kattaa jonkun sähkönmyyntisopimukseen liittyvän tapahtuman. Käyttötapausten sanalliset selostukset on esitelty testausohjeissa (ks. kpl 1.1) niihin liittyvien testitapausten selostusten yhteydessä. Käyttötapausten (KT_01 KT_14) ja niihin liittyvien testitapausten (M01 M21) numerointi on epäjatkuva. Tämä johtuu siitä, että edellä mainitut numeroinnit kattavat kaiken Sähkömarkkinoiden käytännön menettelyohje III:een määriteltyjen tapahtumien mukaisen sanomaliikenteen, mutta vaadittavista testeistä on poistettu sellaiset, joissa sanomaliikenne esiintyy samanlaisena jonkun aiemmin testatun tapahtuman sanomavaihdon kanssa.

13 (34) 2.8 Testauspalvelun osoitetiedot Testausjärjestelmässä käytetään seuraavia kiinteästi määriteltyjä osoitetietoja. Sähkön myyjän testauksessa käytettävät osoitetiedot TCP/IP osoite 193.143.114.56 Osapuolen tunnus, nykyisen tai uuden käyttöpaikan jakeluverkon haltija Osapuolen tunnus, vanhan käyttöpaikan jakeluverkon haltija Palvelun tarjoaja Alijärjestelmä / JHTM -testit Alijärjestelmä / OHTM -testit ETST00 ETST20 ETST JHTM OHTM Jakeluverkon haltijan testauksessa käytettävät osoitetiedot TCP/IP osoite 193.143.114.56 Osapuolen tunnus; nykyinen myyjä Osapuolen tunnus; uusi myyjä Palvelun tarjoaja Alijärjestelmä / JHTJ -testit Alijärjestelmä / OHTJ -testit EDTST1 EDTST2 ETST JHTJ OHTJ

14 (34) 3 Testauksen kulku 3.1 Testauksen aloittaminen Halukkuudesta sertifiointiin ilmoittaudutaan sähköpostilla tiedonvaihto@fingrid.fi -osoitteeseen, jonka jälkeen tapahtuu seuraavaa: - Fingrid tekee asiakkaan kanssa sopimuksen sertifioinnista ja veloittaa sertifiointimaksun. - Sertifiointisopimuksen perusteella Empower avaa asiakkaalle käyttäjätunnuksen testiportaaliin ja toimittaa kyseisen tunnuksen ja salasanan asiakkaan testauksesta vastaavalle yhteyshenkilölle. - Asiakas syöttää testiportaalin välilehdelle Asetukset (ks. kpl 9, Asetukset) - omat yhteystietonsa - tiedot sertifioitavasta järjestelmästä. Sertifiointi todistus kirjoitetaan näiden annettujen tietojen mukaan. - sanomaliikenteessä tarvittavat osapuolen tunnistetiedot. - Empower avaa sanomaliikenneyhteyden testiportaalista asiakkaalta saatujen yhteystietojen mukaan - Kun asiakas on suorittanut kaikki tarvittavat sertifiointitestit onnistuneesti hän ilmoittaa tästä Empowerille ja Fingridille. - Empower tarkistaa testitilanteen ja lähettää Fingridille tiedon hyväksytystä testisuorituksesta. - Fingrid toimittaa hyväksytystä suorituksesta sertifointi todistuksen asiakkaan testauksesta vastaavalle yhteyshenkilölle. - Testausjärjestelmä on hyväksytyn sertifiointi testauksen jälkeen edelleen asiakkaan omatoimisesti käytettävissä (epävirallista) jatkotestausta varten sertifiointisopimuksessa määritellyn ajanjakson. - Järjestelmäsertifioinnissa asiakas syöttää nimen testattavana olevalle järjestelmälleen sellaisena kuin haluaa sen sertifikaattiin kirjattavan (järjestelmätoimittaja vastaa itse versiovaihdoksissa sertifioinnin mukaisuuden säilymisestä)

15 (34) 3.2 Testien suorittaminen Asiakas ajaa testitapaukset läpi haluamassaan järjestyksessä. Testitapaukset, joissa asiakkaan järjestelmä aloittaa sanomavaihdon, käynnistyvät automaattisesti sanoman lähetyksestä. Testitapaukset, joissa testijärjestelmä aloittaa sanomavaihdon, käynnistetään testiportaalin kautta. Kun testitapaus käynnistetään testiportaalista, avautuu ennen testin käynnistymistä ikkuna jonka kautta syötetään testin tarvitsema lähtötieto, jonka testattava määrää itse. Annettu tieto jää oletusarvoksi ko. testitapaukselle. Myyjän testeissä tarvittava parametri on sopimusnumero, jakeluverkon haltijan testeissä käyttöpaikan numero. 3.3 Testien tulosten seuraaminen ja hyväksyntä Testauksen etenemistä seurataan testiportaalista, jonne tallennetaan seuraavat tiedot sanomaliikenteestä: - Aikaleimattu sanomaloki kaikista vaihdetuista sanomista. Loki sisältää sanomakohtaisen testituloksen (ok tai virheitä havaittu) - Alkuperäiset sanomat arkistoituna - Tietokenttäkohtaiset tarkastustulokset sanomista - Mahdollinen sanomakohtainen virheselostus tyypillisille virheille Kun asiakas on suorittanut kaikki tarvittavat sertifiointitestit onnistuneesti hän ilmoittaa tästä Empowerille ja Fingridille. Empowerin henkilöstö tarkastaa suoritettujen testisekvenssien tulokset ja päivittää sertifioinnin tilan tuloksia vastaavaksi testiportaaliin. Sertifikaatin saaminen päättää ko. asiakkaan osalta testauksen ja siihen liittyvän testauspalvelun. Testausjärjestelmä on kuitenkin edelleen asiakkaan omatoimisesti käytettävissä (epävirallista) jatkotestausta varten sertifiointisopimuksessa määritellyn ajanjakson. Ajanjakson alkaminen lasketaan sertifikaatin saamisesta.

16 (34) 4 Järjestelmään kirjautuminen 4.1 Kirjautuminen EDIELtest portaaliin Portaaliin kirjaudutaan selaimella Osoitteeseen http://www.edieltest.fi. Näytölle avautuu kirjautumissivu johon käyttäjä syöttää käyttäjätunnuksen ja salasanan. Käyttäjätunnuksen ja salasanan testaaja saa EDIEL testausjärjestelmän ylläpitäjältä. Kirjautumisen jälkeen testaajan tulee syöttää portaaliin perustiedot testattavasta järjestelmästä. Perustietojen syöttö on ohjeistettu kappaleessa 8. Asetukset.

17 (34) 5 Testiportaalin näytöt 5.1 Pääsivu Kirjautumisen jälkeen avautuu pääsivu, jonka vasemmassa laidassa on valintapainikkeet: Valinta painikkeista valitaan haluttu toiminto.

18 (34) 5.1.1 Testaajan rooli Testaajan roolista riippuen joko Järjestelmän hyväksyntä tai Osapuolen hyväksyntä valintapainikkeen alta avautuu kaksi uutta valintaa; testaus ja sanomaloki. Järjestelmän hyväksyntää tekevälle testaajalle uudet valinnat avautuvat Järjestelmän hyväksyntä painikkeen alle ja osapuolen hyväksyntää tekevälle testaajalle Osapuolen hyväksyntä painikkeen alle. Tästä tasosta lähtien testaaja näkee vain itseään koskevia tietoja.

19 (34) 5.2 Järjestelmän hyväksyntä Järjestelmän hyväksyntänäytöltä näkyvät kaikki järjestelmän hyväksyntätestejä tekevät ja sertifikaatin saaneet yhtiöt. Näytön sarakkeet: Yhtiö Testausta suorittavan yhtiön nimi JVH, Myyjä Testauksen tila JVH:n / Myyjän sertifionnille. Tila on joku seuraavista: tyhjä = yhtiö ei suorita JVH:n/ Myyjän sertifiointia Test = sertifiointitestaus on käynnissä OK = sertifiointitestit on suoritettu hyväksytysti Järjestelmä

20 (34) Linkistä Avaa saa näkyviin testattavan tietojärjestelmän ja sanomamuuntimen tiedot. Yhteystiedot Yhtiön yhteystietoja ei ylläpidetä portaaliin vaan kyseiset ajan tasalla olevat yhtiökohtaiset tiedot löytyvät linkistä http://www.fingrid.fi/fi/asiakkaat/tiedonvaihtopalvelut/siv ut/default.aspx. 5.3 Osapuolen hyväksyntä Osapuolen hyväksyntänäytöltä näkyvät kaikki sähkömarkkinaosapuolen hyväksyntätestejä tekevät ja sertifioidut osapuolet. Näyttö on toiminnaltaan identtinen Järjestelmän hyväksyntänäytön kanssa.

21 (34) Testaus Testausnäytöissä avataan käyttäjän omaa profiilia (roolia) vastaava testitapausnäyttö. Näyttö on samanmuotoinen ja toiminnoiltaan samanlainen kaikilla eri rooleilla (JHTM, JHTJ, OHTM ja OHTJ). Seuraavassa käytetään esimerkkinä näyttöä jolla testataan järjestelmän osapuolitestejä sähkön myyjän osalta (rooli = OHTM). Näytön sarakkeet Testitapaus Testitapauksen yksilöivä tunnus. Testitapausten selostukset löytyvät testiportaalin dokumentaatio valikon linkeistä Sertifiointitestit / Sähkönmyyjä ja Sertifiointitestit / Jakeluverkon haltija avautuvista dokumenteista.

22 (34) Tila Testauksen mahdolliset tilat on esitetty seuraavassa taulukossa. Tila Ok Fail Waiting APERAK Selitys Testi on suoritettu onnistuneesti Testin suorituksessa on havaittu virhe Jokin testisanoma odottaa kuittausta Testiä ei ole vielä aloitettu tai testin suoritus on kesken. Pakollinen Käyttötapaus Käynnistys Sanomaloki Kertoo onko testin suoritus pakollinen ko. roolissa. Pakollisuus näkyy myös testien taustavärissä. Käyttötapauksen nimi. Käyttötapauksen sanallinen selostus on esitetty testausohjeessa testitapauksen ohjeen yhteydessä. Testitapausten selostukset löytyvät testiportaalin dokumentaatio valikon linkeistä Sertifiointitestit / Sähkönmyyjä ja Sertifiointitestit / Jakeluverkon haltija avautuvista dokumenteista.. Testitapauksissa, joissa testausjärjestelmä aloittaa sanoman lähetyksen, on Käynnistys sarakkeessa Käynnistä linkki. Sanoman lähetys testijärjestelmästä käynnistetään klikkaamalla ko. linkkiä. Jokaisen testin kohdalla on Sanomaloki sarakkeessa linkki Avaa, joka avaa kyseisen testitapauksen sanomalokinäytön kahden viimeisen päivän ajalta. Sanomalokinäytöllä testaaja voi myös käsin asettaa eri aikajaksoja joita haluaa nähdä sanomaliikenteen tilanteen. Excel-painonapilla saadaan siirrettyä haetut sanomien tiedot exceltiedostoon mahdollista jatkotarkastelua varten.

23 (34) 5.4 Sanomaloki Sanomalokiin talletetaan tiedot kaikista vaihdetuista sanomista ja sanomalokinäytöllä voidaan selata ja tarkastella lähemmin vaihdettuja sanomia. Sanomaloki näyttö on samanmuotoinen kaikilla eri testitapauksilla (JHTM, JHTJ, OHTM ja OHTJ). Sanomalokinäytön voi avata vasemman reunan valikosta tai testausnäytön kautta. Avautuvassa näytössä määritellään aikaväli, jolta sanomalokia halutaan katsoa. Haettavia viestejä voi halutessa rajata koskemaan vain yksittäisen testitapauksen sanomaliikennettä. Aikajakso alkaen: Aikajakso päättyen: Testitapaus: Hae Excel Alkuaika, josta lähtien lokitulostuksia näytetään Loppuaika, johon asti lokitulostuksia näytetään Alasvetovalikko, josta voi valita yksilöidyn testitapauksen tai vaihtoehtoisesti kaikki testitapaukset. Painonappi suorittaa lokien haun annetuilla hakuehdoilla. Painonapilla saadaan siirrettyä haetut sanomien tiedot exceltiedostoon mahdollista jatkotarkastelua varten. Huom. jos testattavassa sanomassa on sellainen vika, että testausjärjestelmä ei osaa liittää sanomaa mihinkään testitapaukseen, näyttää sanomaloki ko. vikatiedon vain jos on valittu näytettäväksi kaikki testitapaukset. Lisätietoa viasta on tällöin Info sarakkeessa.

24 (34) Sanomalokinäytön sarakkeet Tila Aika Sanoma Näyttää testisanoman tilan. Tila on joko Ok tai Fail. Tila määräytyy sen mukaan onko sanoman sisältö testausjärjestelmän mielestä kunnossa vai ei. Näyttää testisanoman lähetys- tai vastaanottoajan. Sanomalokin hakuehdoissa annettava aika käyttää tätä aikaa hakuehtona. Sanomalokinäytön Sanoma sarakkeen Avaa linkki avaa EDI-sanoman sellaisena kuin se lähetetään tai vastaanotetaan. Sanomaan on lisätty kuitenkin rivinvaihdot heittomerkkien jälkeen, vaikka niitä ei olisi alkuperäisessä sanomassa. Esimerkkinä yllä oleva sanoma on negatiivinen APERAK kuittaussanoma (ks. segmentti BGM+++27, positiivinen kuittaus on BGM+++29 ).

25 (34) Analyysi Analyysi sarakkeessa on linkki vain siinä tapauksessa, että testaaja on lähettänyt sanoman testausjärjestelmälle. Linkistä avautuvassa analyysissä verrataan vastaavatko testattavan sanoman tiedot testitapauksen ohjeessa annettuja tietoja. Analyysinäytön Status sarakkeessa on tarkastettavan sanoman tietokenttäkohtaiset vertailutulokset (OK / NOK). Jos sanomassa olevien tietojen ja vertailutietojen välillä on eroja, tulee testin tilaksi sanomalokinäytössä Fail. Lisäksi Selaamalla sanoman analyysinäytön segmenttikenttiä, ainakin yhden kentän arvo on tällöin NOK. Kun sanomat saadaan vastaamaan toisiaan sanomalokin tila ja analyysitiedoston statukset vaihtuvat Ok:ksi.. Sanoman tyyppi Sanoman tyyppi on PRODAT tai APERAK. PRODAT on varsinainen datasanoma, jolle lähetään kuittaus APERAK sanomalla.

26 (34) Tapahtumalaji Sanomalokinäytön sarakkeeseen tapahtumalaji on yhdistetty sanoman tyyppi ja tapahtumalaji (esim. Z03_1), jotka yhdessä kertovat sanoman käyttötarkoituksen (ks. seuraava taulukko).. Asiakas-, käyttöpaikka- ja sopimustietojen vaihtoon liittyvät EDIELsanomat: PRODAT Tapahtuma Tyyppi Syykoodi 1 Uuden myyjän ilmoitus uudesta sopimuksesta Aloitusilmoitus Z03 1 Sisäänmuuttoilmoitus Z03 14 Myyjänvaihdon peruutus ennen toimituksen alkua Z03 C 2 Verkonhaltijan vahvistus uudesta sopimuksesta uudelle myyjälle Positiivinen kuittaus Z04 1 Negatiivinen kuittaus Z04 N 3 Verkonhaltijan ilmoitus nykyiselle myyjälle Ehdotus uuden myyntisopimuksen alkamiseksi Z05 1 Ilmoitus asiakkaan poismuutosta nykyiselle myyjälle Z05 14 Peruutetaan ilmoitus uudesta myyntisopimuksesta Z05 C 4 Käyttöpaikan tietojen muutokset JVH ilmoitus laskutustavan muutoksesta Z06 11 Aikavyöhykejaon tunnus (muutos) Z06 10 Sulaketieto (muutos) Z06 13 5 Myyjän ilmoitus sopimuksen päättymisestä Positiivinen kuittaus (myynnin päättymisilmoitus) Z08 1 Negatiivinen kuittaus Z08 N Uuden myyjän ilmoitus asiakkaan poismuutosta Z08 14 Katkaisupyynnön vahvistus Z08 9 Takaisinkytkentäpyynnön vahvistus Z08 2 6 Myyjän ilmoitus verkkoyhtiölle Myyjän ilmoitus laskutustavan muutoksesta Z09 1 7 Mittarin vaihtoa koskevat tiedot Mittarinvaihto ja alkulukema Z10 12 Mittarinvaihto (toimituksen aikana) Z10 7 8 Mittaustiedot Alkulukema Toimituksen aloittaminen Z11 1 Loppulukema Z11 3 Laskustuslukema lukemat, käyttö ja ennusteet Z11 5 Välilukema lukemat ja käyttö Z11 6 Katkaisun lukemat Z11 9 Takaisinkytkentälukemat Z11 2

27 (34) Suunta Testitapaus Lähettäjä Sarakkeessa määritellään testisanoman suunta: Lähtevä tai Tuleva. Suunta on katsottu testausjärjestelmän kannalta. Sarakkeessa määritellään sanoman testitapaus: Mxx myyjäntesti tai JVHxx jakeluverkon haltijan testitapaukset. (Katso kohta 2.5). Sarakkeessa on testisanoman lähettäjän (NAD+FR) tunnus. Lähettäjän alijärjestelmä Sarakkeessa on testisanoman lähettäjän alijärjestelmän tunnus. Alijärjestelmätunnusta käytetään sanoman sisäiseen reititykseen. Vastaanottaja Sarakkeessa on testisanoman vastaanottajan (NAD+DO) tunnus. Vastaanottajan alijärjestelmä. Sarakkeessa on testisanoman vastaanottajan alijärjestelmän tunnus. Alijärjestelmätunnusta käytetään sanoman sisäiseen reititykseen. Info Sarakkeessa annetaan lisä infot testitapaukseen. Yleensä tämä on virheilmoitus, kun testijärjestelmä ei ole pystynyt käsittelemään sanomaa. Esim. kun sanomassa on rakenteellinen virhe.

28 (34) 5.5 Yksittäisen sanoman testaaminen Portaalissa voidaan testata myös yksittäisiä PRODAT-sanomia. Sähkömarkkinaosapuoli lähettää omasta asiakasjärjestelmästään teknisesti testattavan sanoman portaaliin. Sanoman vastaanottajan tunnus on ETST ja kyseisellä sanomalla ei saa olla alijärjestelmätunnusta jotta sanoma ei ohjaudu sertifiointi testeihin. Testauksessa ei oteta kantaa varsinaiseen tietosisältöön vaan tarkastelu tehdään sanoman rakenne tasolla esim. kenttien pituudet ja pakollisuudet tarkistetaan. Lähetetyn sanoman testauksen tuloksen voi käydä katsomassa portaalista omilla tunnuksilla YKSITTÄISEN SANOMAN TESTAUS -näkymän kautta. Tila sarakkeesta nähdään heti suoraan oliko sanoman kaikki rivit kunnossa. Sanoma sarakkeesta aukeaa alkuperäinen edi-sanomaformaatti. Analyysi sarakkeesta aukeaa puolestaan rivikohtainen analyysitiedosto josta voi tarkastella tarkemmin sanoman rakennetta ja tehdyn analyysin onnistumista.

29 (34) 6 Yhteenveto testien hyväksyntänäytöistä Tässä kappaleessa esitettyjen näyttöjen toiminnallisuus on selostettu kappaleessa 5. 6.1 Järjestelmän hyväksyntä / Myyjän testaus (JHTM) 6.2 Järjestelmän hyväksyntä / Jakeluverkon haltijan testaus (JHTJ)

30 (34) 6.3 Osapuolen hyväksyntä / myyjä (OHTM) 6.4 Osapuolen hyväksyntä / Jakeluverkon haltijan testaus (OHTJ)

31 (34) 7 Dokumentaatio Dokumentaatio valinnasta avautuu linkkilista testauspalvelun ohjeistukseen sekä Ediel sanomaliikenteen ohjeisiin ja määräyksiin liittyvään dokumentaatioon.

32 (34) 8 Asetukset Asetukset valinnasta testaaja määrittelee omat käyttäjätietonsa ja tiedot testattavasta järjestelmästä.

33 (34) 8.1 Käyttäjätiedot Käyttäjätunnus Käyttäjätunnus on tunnus jolla asiakas kirjautuu testiportaaliin. Käyttäjätunnus on asetettu valmiiksi, eikä asiakas voi muuttaa sitä. Nimi Testauksesta vastaavan henkilön nimi. Sähköpostiosoite Testauksesta vastaavan henkilön sähköpostisoite. Salasana Napin alta avautuu ikkuna, josta käyttäjä voi muuttaa salasanansa. 8.2 Yhtiön tiedot 8.3 Yhteyshenkilö Otsakkeen alla oleviin kenttiin syötetään yhtiön yhteystiedot. Nämä tiedot näkyvät kaikille käyttäjille joko Järjestelmän hyväksyntä tai Osapuolen hyväksyntä sivulta avautuvasta linkistä, riippuen siitä kumpaan ryhmään käyttäjä kuuluu. Otsakkeen alla oleviin kenttiin syötetään yhteystiedot henkilöstä joka vastaa testattavasta järjestelmästä. 8.4 Testattavan järjestelmän tiedot Otsakkeen alla oleviin kenttiin syötetään testattavan tietojärjestelmän ja sanomamuuntimen tyyppi ja versio. Nämä tiedot näkyvät kaikille käyttäjille joko Järjestelmän hyväksyntä tai Osapuolen hyväksyntä sivulta avautuvasta linkistä, riippuen siitä kumpaan ryhmään käyttäjä kuuluu. 8.5 Testattavan järjestelmän yhteystiedot Otsakkeen alla oleviin kenttiin syötetään sanomaliikenteen testauksessa käytettävät testattavan osapuolen yhteystiedot. TCP/IP osoite tai teleoperaattori Osapuoli Jos sanomaliikenne tapahtuu suoraan testattavan järjestelmän ja testausjärjestelmän välillä, kirjoitetaan tähän kenttään testattavan järjestelmän TCP/IP osoite. Jos sanomaliikenne tapahtuu teleoperaattorin välityspalvelun kautta, kirjoitetaan kenttään välityspalvelua tarjoavan teleoperaattorin nimi.

34 (34) Alijärjestelmä Palveluntarjoaja Sähkömarkkinaosapuolen tunniste, jota käytetään sanomaliikenteessä testattavan osapuolen tunnuksena. Testattavan osapuolen alijärjestelmän tunnus. Käytetään tarvittaessa testisanomien sanoman sisäiseen reitittämiseen. Jätetään tyhjäksi, jos testattava järjestelmä ei käytä sisäistä reititystä. Sen sähkömarkkinaosapuolen tunniste, joka vastaa sanomien lähettämisestä ja vastaanottamisesta (EDI palvelun toimittaja). Jätetään tyhjäksi jos testattava osapuoli vastaa itse sanomien lähettämisestä ja vastaanottamisesta.