Fortum
Yhdistetty Fortum-asiakastili, joka raportoi oman sähkönkulutuksesi vain luku -antureina - kirjautuneena samalla Oma Fortum -käyttäjätunnuksella ja salasanalla, jota jo käytät Fortumin omalla verkkosivulla tai sovelluksessa.
Yhdistäminen
Laitteet ja palvelut > Fortum > "+ Add account" kysyy suoraan Oma Fortum -käyttäjätunnuksesi ja salasanasi - ei OAuth-suostumusnäyttöä eikä luotavia sovellustunnistetietoja, koska Fortumilla ei ole julkista rajapintaa tähän; Athena kirjautuu samalla tavalla kuin verkkosivu itse.
Entiteetit
Neljä vain luku -anturia, kilowattitunteina: today_consumption,
yesterday_consumption, month_consumption ja
daily_consumption (sama tämän päivän kokonaiskulutus uudelleen, mutta juuri se
anturi, jonka historiaan alla oleva "Täytä historiatiedot" kirjoittaa - joten sitä seuraava
Kaavio- tai Tilastokortti näyttää yhtenäisen sarjan pelkän tilin yhdistämisen jälkeen kertyneen
sijaan). Kulutus mitataan ja raportoidaan korkeintaan muutaman kerran päivässä, joten
taustasilmukka tarkistaa uudet luvut 3 tunnin välein jatkuvan kyselyn sijaan. Toimii
Ohjauspaneelin korttien,
Historian ja
Automaatioiden kanssa tarkalleen kuten mikä tahansa
muu integraatio - mitään ohjattavaa ei ole, joten se ei koskaan näy Toiminto-solmun kohteena,
vain tilalähteenä.
Historiatietojen täyttö
Tilin Kulutus-kortin valikossa on "Täytä historiatiedot" -toiminto - valitse alkupäivä (enintään
365 päivää taaksepäin), ja Athena hakee päivittäisen kulutuksesi suoraan Fortumilta koko
aikaväliltä yhdellä pyynnöllä ja lisää sen daily_consumption-anturin historiaan. Jo
olemassa olevan historian kattamat päivät ohitetaan automaattisesti, joten toiminnon
uudelleenajaminen (tai aikavälin myöhempi laajentaminen) ei koskaan laske samaa päivää kahteen
kertaan.
Uudempi ja vähemmän testattu kuin useimmat Athenan muut integraatiot. Tämä ei
ole julkinen, dokumentoitu Fortum-rajapinta - se on oikea (joskin epävirallinen)
kirjautumisvuo, joka on käänteismallinnettu Fortumin omaa suomalaista sivustoa vasten. Toisin
kuin joillekin Athenan muille kirjautumispohjaisille integraatioille, tälle ei ollut valmista
esimerkkiä seurattavaksi: ainoa löytynyt Fortum-yhteisöprojekti kattoi vain Ruotsin sivuston,
joka osoittautui käyttävän merkittävästi erilaista (ja yksinkertaisempaa) kirjautumisvuota kuin
mitä Suomen sivusto todellisuudessa tarvitsee. Suomen vuo rakennettiin testaamalla oikeita
rajapintoja suoraan, mutta aivan viimeisiä vaiheita (salasanan lähettäminen ja kirjautumisen
loppuunsaattaminen) ei voitu täysin varmistaa ilman oikeaa tiliä. Jos tilin lisääminen
epäonnistuu tai antaa epäselvän virheen, tarkista Athenan omat lokit
(fortumapi-komponentti) todellisen virheen selvittämiseksi ja kerro mitä löydät.