31.08.2018 2 (18) Sisällysluettelo 1 Rekisteröityminen... 4 2 Kirjautuminen... 5 2.1 Unohtunut salasana... 5 3 Käyttäjätoiminnot... 6 3.1 Salasanan vaihtaminen... 6 3.2 Uloskirjautuminen... 6 3.3 Käytettävä markkinaosapuoli... 6 4 Etusivu... 7 5 Perustietojen tuonti... 8 5.1 Tuonnin keskeyttäminen... 9 5.2 Virheraportointi... 10 5.2.1 Yhteenvetoraportti... 10 5.2.2 Tarkastusraportti... 10 5.3 Vanhojen revisioiden poistaminen... 10 6 Perustietojen eheystarkastus... 11 7 Mittaustiedot (verkkoyhtiöt)... 12 7.1 SFTP-yhteys... 12 7.2 Mittaustietojen tuonti... 12 7.3 Mittaustiedostojen tarkastus... 13 8 Yhdenmukaisuustarkastus... 14 9 Toimintaloki... 15 10 Käyttäjähallinta... 16 11 Käyttäjätuki... 18
31.08.2018 3 (18) Muutoshistoria Päivämäärä Versio Muutos 28.09.2017 0.1 Ensimmäinen luonnos 05.10.2017 0.2 Lisätty kuvakaappauksia, huomioitu kommentit 25.10.2017 0.3 kuvia. Käsitteet tarkistettu. 20.11.2017 0.4 Lisätty eheystarkastuksen kappale. 04.01.2018 0.5 tiedostotarkastuksen prosessi. 05.02.2018 0.6 Siirretty rekisteröitymisen ja kirjautumisen toiminnot omaan dokumenttiinsa, päivitetty käyttävyysmuutosten mukaiseksi 20.04.2018 1.0 Ensimmäinen virallinen versio 22.05.2018 1.1 Täydennetty vanhojen revisioiden tietojen poistaminen 31.08.2018 1.2 Täydennetty mittaustietojen tarkastuksen osalta
31.08.2018 4 (18) 1 Rekisteröityminen Rekisteröityminen Tittaan tapahtuu järjestelmän lähettämän sähköpostin mukaisesti. Sähköposti sisältää linkin, jota klikkaamalla pääsee rekisteröitymissivulle. Sivulla tarkistetaan henkilötiedot ja valitaan palvelun salasana. HUOM! Varmista että puhelinnumero on oikein, sitä käytetään kirjautumisen tekstiviestivahvistuksessa. Salasanan tulee olla vähintään kahdeksan merkkiä pitkä ja sisältää iso kirjain, pieni kirjain, numero ja erikoismerkki.
31.08.2018 5 (18) 2 Kirjautuminen Palveluun kirjaudutaan sähköpostiosoitteella ja valitulla salasanalla. Palvelu lähettää tekstiviestillä vahvistuskoodin: Kirjautuminen vahvistetaan syöttämällä vahvistuskoodi käyttöliittymällä: 2.1 Unohtunut salasana Unohtunut salasana voidaan tilata kirjautumissivulla olevan salasanan uusimislinkin tilauksen kautta. Palvelu lähettää sähköpostin salasanan uusimisesta annettuun sähköpostiosoitteeseen (käyttäjätunnus). Sähköpostin linkistä pääsee valitsemaan palveluun uuden salasanan.
31.08.2018 6 (18) 3 Käyttäjätoiminnot Yläpalkin oikeassa reunassa olevaa käyttäjän nimeä klikkaamalla näytetään tietoja käyttäjästä ja osapuolesta: 3.1 Salasanan vaihtaminen Klikkaamalla yläpalkin käyttäjänimeä ja painamalla Vaihda salasana -nappia avautuu näyttö, jolla voidaan tilata salasanan uusimislinkki käyttäjän sähköpostiosoitteeseen. Sähköpostin linkin kautta päästään asettamaan uusi salasana palveluun. 3.2 Uloskirjautuminen Klikkaamalla yläpalkin käyttäjänimeä ja painamalla Kirjaudu ulos -painiketta järjestelmä kirjaa käyttäjän ulos palvelusta ja palauttaa kirjautumissivulle. 3.3 Käytettävä markkinaosapuoli Mikäli käyttäjä on liitetty vain yhteen markkinaosapuoleen, niin käytettävä osapuoli näkyy palvelun yläpalkin oikeassa reunassa käyttäjän nimen vieressä: Mikäli käyttäjä on liitetty useampaan markkinaosapuoleen, niin käytettävä osapuoli voidaan valita pudotuslistasta: HUOM! Käytettävän osapuolen vaihtaminen palauttaa käyttäjän aina palvelun etusivulle.
31.08.2018 7 (18) 4 Etusivu Palvelun etusivulla näytetään tietotyypeittäin tiedot tarkastustilanteesta: Listaus ja raportti näyttävät laatuluokat ja virheraportit kaikki tehdyt tarkastukset huomioiden. Tilatieto kertoo mikä on viimeisin tarkastus mikä tietotyypille on tehty. Raportti -sarakkeessa olevasta kuvakkeesta saadaan auki yhteenvetoraportti tietotyypin virheistä. HUOM! Raportti ei ole avattavissa, mikäli virheitä ei ole (kaikkien laatuluokkien laatu on 100%) Etusivulta päästää siirtymään haluttuun toimintoon vasemmassa reunassa sijaitsevan navigoinnin kautta.
31.08.2018 8 (18) 5 Perustietojen tuonti Perustietojen tuonti -käyttöliittymällä tuodaan palveluun uudet siirtotiedostot, seurataan tarkastuksen etenemistä ja nähdään tarkastustulokset jo tarkastetuista tiedostoista: Palveluun tuotavat siirtotiedostot valitaan Lisää tiedosto -painikkeen kautta tai raahataan tiedostoalueelle. Titta tarkistaa valittujen tiedostojen nimet ja ominaisuudet ja näyttää mahdolliset virheet värjäämällä tiedoston nimen punaiseksi ja näyttämällä virhekuvauksen oikeassa reunassa:
31.08.2018 9 (18) Tiedostot ladataan painamalla Lataa kaikki -painiketta. HUOM! Tiedostoja ei voi ladata ennen kuin virheelliset tiedostot on poistettu listalta, eli Lataa kaikki -painike muuttuu aktiiviseksi vasta kun kaikki listan tiedostot ovat ok. HUOM! Mikäli tiedostoja on valittuna listalla, mutta latausta ei ole käynnistetty, niin sivulta poistuminen poistaa valitut tiedostot. Tuotavat ja tuodut tiedostot näytetään Tuodut tiedostot listalla: Listalla näytetään tiedostojen tiedot, tieto tuonnin etenemisestä sekä tiedoston laatu laatuluokkien 1 ja 2 osalta. Tiedostojen tuonti ja tarkastus koostuu seuraavista vaiheista Tiedoston lukeminen, tilana Luetaan tiedostoa Tiedoston tallennus, tilana Tallennetaan Tiedostotarkastus, tilana Tiedostotarkastus, Tarkastus -sarakkeessa näytetään tarkastuksen eteneminen edistymispalkkina Duplikaattitarkastus, tilana Duplikaattitarkastus 5.1 Tuonnin keskeyttäminen Tiedostojen tuonti on mahdollista keskeyttää missä tahansa vaiheessa Toiminnot - sarakkeen Keskeytä -painikkeella.
31.08.2018 10 (18) 5.2 Virheraportointi 5.2.1 Yhteenvetoraportti Jo tarkastuksen ollessa menossa voidaan Raportit -sarakkeen Yhteenvetoraportti - napista avata käyttöliittymäraportti, joka näyttää laadun virheluokittain sekä yleisimmät virheet: 5.2.2 Tarkastusraportti Tarkastuksen valmistuttua saadaan Tarkastusraportti -napista generoitua Excel muotoinen tarkastusraportti, joka sisältää yksityiskohtaiset tiedot kaikista virheistä. Jokaisesta virheestä kirjoitetaan oma rivi, eli yhdestä siirtotiedoston rivistä voi tulla useampi virherivi. Tarkastusraportin alussa kerrotaan tiedot virheestä ja mahdollinen korjausehdotus ja näiden jälkeen on vielä kaikki siirtotiedoston kentät arvoineen (vanhoilla revisioilla ei näytetä kenttiä arvoineen, ks. seuraava kappale): 5.3 Vanhojen revisioiden poistaminen Käsiteltäessä uutta revisiota tietotyypistä poistetaan vanhan revision tiedot lukuun ottamatta virhetietoja. Tämä tarkoittaa sitä, että vanhoista revisioista nähdään edelleen virhetiedot, mutta varsinaiset tiedot eivät ole enää käytettävissä (virheraporteilla). Tiedot poistetaan niin, että kussakin prosessivaiheessa poistetaan aina edelliset vastaavat tiedot. Kun tuodaan uusi revisio niin poistetaan edellinen tiedostotarkastettu revisio ja kun ajetaan eheystarkastus, jossa on mukana uusi revisio niin poistetaan edellinen eheystarkastettu revisio jne.
31.08.2018 11 (18) 6 Perustietojen eheystarkastus Eheystarkastuksessa tarkistetaan, että osapuolen toimittamat tiedot ovat eheät, eli esim. kaikille sopimuksille löytyy asiakas ja kaikille asiakkaille sopimus. Eheystarkastus voidaan käynnistää, kun kaikki eheystarkastuksen kannalta pakolliset tietotyypit on toimitettu. Tietotyyppien pakollisuus on ilmaistu tähdellä (*) tietotyypin perässä. Käynniste eheystarkastus -toiminto ei ole aktiivisena, ellei kaikkia pakollisia tietoja ole toimitettu: Eheystarkastus käynnistetään Käynnistä eheystarkastus -napilla. HUOM! Mikäli eheystarkastus on käynnissä, niin uutta eheystarkastusta ei voida käynnistää. Käynnissä oleva eheystarkastus näkyy Eheystarkastukset -listalla tilalla Eheystarkastus käynnissä Kun eheystarkastus on suoritettu, niin löydettyjen virheiden määrät näytetään eheystarkastuksen rivillä ja on mahdollista ladata tarkastusraportti -painikkeella. Eheystarkastus ei ajeta uudestaan samoille revisioille (käynnistysnappi on disabloituna). Mikäli toimitetaan uusi revisio jostakin tiedostosta, voidaan eheystarkastus taas käynnistää.
31.08.2018 12 (18) 7 Mittaustiedot (verkkoyhtiöt) SAF-muotoiset mittaustiedot tuodaan Titta-palveluun zip-pakattuina sftp-yhteyttä käyttäen. Mittaustietojen tuonnin tilannetta voi seurata Titta-palvelun käyttöliittymältä. Mittaustietojen käyttöliittymä (Mittaustiedot sekä Mittaustietojen tarkastus) on näkyvissä vain verkkoyhtiöiden käyttäjille. 7.1 SFTP-yhteys Pakatut mittaustiedostot tuodaan Titta-palveluun SFTP-yhteyttä käyttäen. SFTP-yhteyttä varten osapuolen tulee luoda ssh-avainpari, jonka julkinen avain (public key) toimitetaan Titta-palvelun käyttäjätukeen avainpariksi käy myös sama avainpari, jonka verkkoyhtiö on luonut käyttöpaikkarekisterin SFTP-yhteyttä varten. Tarkempi ohje mittaustietojen SFTP-yhteydestä ja tietojen toimittamisesta on julkaistu EDIELfi-portaalissa (https://www.ediel.fi/sites/default/files/ohje%20mittaustietojen%20sftpyhteytt%c3%a4%20varten.pdf). 7.2 Mittaustietojen tuonti Mittaustiedostot tallennetaan SFTP-palvelimelle pakattuna zip-formaattiin. Tiedostot nimetään seuraavalla tavalla: osapuolitunnus-mittaustiedot-päivämäärä ja kellonaika (YYYYMMDDHHMMSS)- revisionumero.zip Esim: JVH000-Mittaustiedot-20160920191100-8.zip Tuotuja mittaustiedostoja voi tarkastella Mittaustiedot-näytöllä. Listalla näytetään SFTPpalveluun tallennetut tiedostot sekä mahdolliset tiedostonimeen liittyvät virheet, ks. kuva alla.
31.08.2018 13 (18) 7.3 Mittaustiedostojen tarkastus Mittaustiedostojen tarkastusajo käynnistetään Mittaustiedostojen tarkastus -näytöltä. Mittaustietojen tuonnin tilanne näyttää ok-tilaisten tiedostojen lukumäärän ja yhteiskoon. Tarkastuksen tilannetta voi seurata Mittaustietojen tarkastusajot -listalla. Suoritetun tarkastusajon raportin voi avata Excel-muodossa.
31.08.2018 14 (18) 8 Yhdenmukaisuustarkastus Yhdenmukaisuustarkastus tarkastaa, että eri osapuolten tiedot ovat eheät, eli esim. että myyntisopimusten käyttöpaikat löytyvät jakeluverkonhaltijoiden tiedoista. Yhdenmukaisuustarkastus käynnistetään pääkäyttäjän toimesta, kun riittävä perustietojen laatutaso on saavutettu kaikilla osapuolilla. Kun yhdenmukaisuustarkastus on suoritettu, niin laatuprosentit näytetään yhdenmukaisuustarkastuksen rivillä ja on mahdollista ladata tarkastusraportti - painikkeella.
31.08.2018 15 (18) 9 Toimintaloki Toimintalokilla nähdään kaikki markkinaosapuoleen ja käyttäjään liittyvät lokitiedot, esim. sisäänkirjautumiset ja tiedostojen tuonnit.
31.08.2018 16 (18) 10 Käyttäjähallinta Käyttäjähallinta on käytössä vain käyttäjillä, jotka on nimetty jonkun osapuolen yhteyshenkilöiksi. Yhteyshenkilöt voivat käyttäjähallinnan avulla hallita edustamiensa osapuolten käyttäjiä. Käyttäjähallinnassa näytetään Osapuolet -listassa kaikki osapuolet, joissa käyttäjä on yhteyshenkilönä. Käyttäjät -listassa näytetään näiden osapuolten käyttäjät. Lisää uusi käyttäjä -napista aukeaa sivu, jolla voidaan antaa uuden käyttäjän tiedot ja liittää käyttäjä haluttuihin osapuoliin: HUOM! Kun sähköpostiosoite on syötetty, niin sivun alaosassa voidaan lähettää käyttäjälle sähköpostiviesti, jonka kautta hän pääsee rekisteröitymään palveluun (Lähetä -painike):
31.08.2018 17 (18) Käyttäjälistauksen Muokkaa -painikkeesta päästään muokkaamaan käyttäjän tietoja sekä hallitsemaan käyttäjään liitettyjä osapuoli- ja yhteyshenkilötietoja.
31.08.2018 18 (18) 11 Käyttäjätuki Käyttäjätuesta löytyy Titan käyttöohje. Tukipyynnöt -listalla näytetään listaus osapuolen tukipyynnöistä ja niiden tiloista. Lisää uusi tukipyyntö -napilla voidaan lisätä/lähettää uusi tukipyyntö konsultointipalvelulle. Käyttäjätuesta löytyy myös listaus Datahubin datastandardissa käytetyistä koodilistoista.