KIHO-yhteys tuo yhdistettyjen ajoneuvojen ja laitteiden sijainnin sekä kertyneet käyttötunnit KIHOsta Spotillan Spoteille. Asetukset tehdään selaimessa. Tarvitset pääkäyttäjän oikeudet, organisaatiolle käyttöön otetun KIHO-integraation, KIHO-tunnistetiedot sekä muokkausoikeuden kytkettävään Spottiin.

KIHO-tunnusten pitää antaa pääsy oikean ajoneuvon sijaintiin ja käyttötunteihin. Myös laitteena kytkettävällä KIHO-kohteella pitää olla KIHOssa ajoneuvoyhteys: sijainti ja tunnit haetaan siihen liittyvältä ajoneuvolta. Pelkkä laitteen löytyminen valintaluettelosta ei takaa, että tietojen siirto onnistuu.

Tallenna tunnistetiedot ja testaa yhteys

  1. Avaa Asetukset → Integraatiot → KIHO ja sen Tunnistautuminen-välilehti.
  2. Valitse Ympäristö ja Tunnistautumistapa: API-avain, Käyttäjänimi ja salasana, Henkilötunnus ja PIN-koodi tai Asiakastunnus ja tagi. Oletusvalinnat ovat Tuotanto ja API-avain.
  3. Täytä valitun tavan tunnistetiedot. Asiakastunnuksen pariksi annetaan Asiakastagi. Jos yhteydelle on annettu erillinen osoite, täytä Perus-URL; muuten käytetään oletusosoitetta.
  4. Valitse Tallenna ja sen jälkeen Testaa yhteys. Testi käyttää tallennettuja tietoja.

Tuotanto ja Sandbox käyttävät samaa oletusosoitetta. Sandbox-valinta ei siis yksin erota yhteyttä tuotantotiedoista. Erillisen perusosoitteen pitää olla HTTPS-osoite kiho.fi-verkkotunnuksessa tai sen aliverkkotunnuksessa.

Onnistuneen testin jälkeen näet yhteyden vahvistusajan. Testi tarkistaa tunnistautumisen ja yhteyden; Spottien tietojen siirto edellyttää lisäksi paikkakytkentöjä ja synkronoinnin käyttöönottoa.

Aiemmin tallennettu salainen tieto näkyy peitettynä. Tyhjän tai peitetyn tunnistekentän tallentaminen säilyttää aiemman arvon. Käytä tunnistetietojen poistamiseen erillistä tyhjennyspainiketta.

Kytke KIHO-kohde Spottiin

Avaa KIHO-yhteyden Asetukset-välilehti ja kohta Telemetriasynkronointi. Käyttöliittymä kutsuu Spottien ja KIHO-kohteiden liitoksia paikkakytkennöiksi.

  1. Valitse Kytke paikka.
  2. Valitse Spotillan Spotti.
  3. Hae ja valitse vastaava KIHO-kohde, esimerkiksi nimellä tai tunnisteella. Kohdetyyppi täyttyy valinnan perusteella.
  4. Tarkista, että valitsit oikean laitteen tai ajoneuvon, ja valitse lomakkeesta Kytke paikka.

Nykyiset liitokset näet saman kohdan painikkeesta Hallinnoi paikkakytkentöjä. Luettelossa näkyvät Spotti, KIHO-kohde, Ulkoinen ID, kohdetyyppi ja Käyttötunnit. Luettelon käyttötunnit ovat kytkentään tallennettu aiempi vertailulukema, eivät uusi reaaliaikainen haku KIHOsta.

Yhdellä Spotilla voi olla yksi KIHO-kytkentä. Uuden kohteen kytkeminen jo kytkettyyn Spottiin korvaa sen aiemman kytkennän. Samaa KIHO-kohdetta ei voi yhdistää useaan Spottiin, ja jo kytketyt kohteet jätetään pois hakutuloksista. Jos siirrät kohteen toiselle Spotille, poista vanha kytkentä ensin.

Esikatsele ja käynnistä tietojen siirto

  1. Valitse Telemetriasynkronointi-kohdasta Esikatsele spottien telemetriasynkronointi. Esikatselu ei muuta Spottien tietoja, kytkentöjen vertailuarvoja tai lukutapahtumia eikä käynnistä huoltoja. Se ei edellytä Käytössä-valintaa.
  2. Odota esikatselun valmistumista ja valitse sen yhteyteen ilmestyvä Näytä tulokset.
  3. Tarkista riveiltä Toiminto, Vanha sijainti, Uusi sijainti, Vanhat tunnit, Uudet tunnit, Tagiluku ja Syy. Selvitä virheet ennen käyttöönottoa.
  4. Valitse Telemetriasynkronointi-kohdan Käytössä ja tallenna asetukset.
  5. Jos haluat käynnistää siirron heti, valitse Suorita spottien telemetriasynkronointi. Ilmoitus jonoon lisäämisestä tarkoittaa, että työ suoritetaan taustalla.

Päivitettäisiin tarkoittaa, että sijainti tai käyttötunnit muuttuisivat. Ei muutoksia tarkoittaa, ettei päivitysehto täyty. Spotti puuttuu, Virheellinen telemetria ja Virhe vaativat syyn tarkistamisen. Esikatselun valmistuminen ei yksin tarkoita, että kaikki kohteet voidaan päivittää.

Vanhat tunnit näyttää Spotin lukeman ja kytkennän vertailulukeman suuremman arvon. Uudet tunnit näyttää KIHOsta saadun lukeman; pienempi arvo voi näkyä tässä sarakkeessa, vaikka sitä ei tallennettaisi. Tagiluku kertoo, syntyisikö siirrossa automaattinen lukutapahtuma.

Kun synkronointi on käytössä, tietoja haetaan automaattisesti noin kymmenen minuutin välein. Siirron suunta on KIHOsta Spotillaan. Myös käsin käynnistettävä siirto edellyttää tallennettua Käytössä-valintaa. Jos työ on jo jonossa tai käynnissä, odota sen valmistumista.

Miten sijainti ja käyttötunnit päivittyvät?

Sijainti

Sijaintihaku tarkastelee viimeisten 15 minuutin tietoja ja valitsee niistä uusimman aikaleiman mukaisen sijainnin. Kelvollinen sijainti tallennetaan Spotille, kun se eroaa kytkentään aiemmin tallennetusta sijainnista. Koordinaattien pitää olla maantieteellisesti sallituissa rajoissa; pelkkää nollakoordinaattiparia ei hyväksytä.

Päivitys käyttää samoja Spotin koordinaatteja kuin käsin asetettu kiinteä sijainti. KIHO-päivitys voi siten korvata käsin asetetun sijainnin. Muutoksen vertailukohta on kytkennän aiempi sijainti: käsin muutettua Spotin sijaintia ei palauteta KIHO-arvoon, jos KIHO-sijainti ei ole muuttunut kytkennän vertailuarvosta.

Käyttötunnit

Käyttötunnit ovat laitteen kumulatiivinen mittarilukema, eivät edellisen siirron jälkeen kertyneet tunnit tai työntekijän työaika. KIHO-lukema korvaa Spotin lukeman vain, kun se on suurempi kuin sekä Spotin nykyinen lukema että kytkentään tallennettu aiempi lukema. Yhtä suuri tai pienempi arvo ei muuta Spotin tunteja.

Esimerkiksi jos Spotin lukema on korjattu 1 500 tunnista 1 200 tuntiin mutta kytkentään on tallennettu 1 500, KIHO-lukema 1 300 ei päivity Spotille. Lukema 1 510 päivittää Spotin arvoksi 1 510. Pelkkä Spotin lukeman korjaaminen alaspäin ei nollaa KIHO-kytkennän vertailulukemaa.

Tunnit voidaan päivittää, vaikka onnistunut sijaintihaku palauttaisi tyhjän tuloksen tai kelvottomat koordinaatit. Jos itse sijaintipyyntö epäonnistuu, kyseisen kohteen käyttötunteja ei haeta. Jos tuntitietojen haku epäonnistuu mutta sijainti on kelvollinen ja muuttunut, sijainti voi silti päivittyä.

Lukema voi päivittyä, vaikka Spotin käyttötuntitoiminto ei olisi käytössä. Kun toiminto on käytössä, muuttunut lukema tallentuu tuntihistoriaan, ellei viimeisin historiarivi jo sisällä samaa arvoa. Lisäksi Spotille liitetyt tuntiperusteiset huoltopohjat tarkistetaan. Huoltorajan täyttyminen voi luoda tehtävän ja lähettää ilmoituksen pohjan asetusten mukaan. Ennakko, edellisen huollon lukema ja avoimet huoltotehtävät vaikuttavat tähän. Tarkista pohjat ennen automaattisen siirron käyttöönottoa; katso tuntiperusteisen huoltopohjan määrittäminen.

Automaattinen lukutapahtuma

Kun päivitettävän kohteen sijainti on siirtynyt yli 50 metriä kytkentään edellisessä päivityksessä tallennetusta sijainnista, siirto luo lukutapahtuman. Ensimmäinen sijainti ei yksin synnytä tapahtumaa. Raja koskee kahden sijainnin välistä etäisyyttä, ei kertynyttä ajomatkaa.

Tapahtuma syntyy automaattisesti KIHO-tietojen perusteella. Se ei tarkoita, että joku olisi lukenut fyysisen NFC- tai QR-tagin. Tapahtumalle kohdistetaan Spotin viimeisimmän käyttäjällisen lukutapahtuman käyttäjä tai tämän puuttuessa ensimmäinen aktiivinen mobiilikäyttäjä. Kohdistus ei osoita kyseisen henkilön olleen laitteen luona. Jos kohdistettavaa käyttäjää ei löydy, kyseinen päivitys epäonnistuu.

Tarkista siirron tulos ja selvitä poikkeamat

Avaa KIHO-yhteyden Integraatioloki-välilehti. Rajaa rivejä Aika-sarakkeesta ja tarkista Tila sekä Viesti. Tarkista sekä koko siirron yhteenveto että kohdekohtaiset virheet. Yhteenvetoviestissä kerrotaan muun muassa haetut ja päivitetyt kohteet, virheet sekä mahdollinen keskeytyssyy ja käsittelemättä jääneiden kytkentöjen määrä.

Siirto voi onnistua vain osittain. Tunnistautumisvirhe, KIHO-palvelun pyyntörajan ylitys tai kolme peräkkäistä tilapäistä virhettä saman tyyppisessä haussa keskeyttää jäljellä olevien kytkentöjen käsittelyn. Jo onnistuneet päivitykset säilyvät. Virheellinen yhteenveto ei siis tarkoita, ettei mitään olisi tallennettu.

Varmista lopputulos myös Spotilta. Avaa selaimessa Kohteet, laitteet, kalusto → Taulukkonäkymä, hae Spotti ja avaa sen tiedot. Tarkista Käyttötuntimittarin lukema ja tarvittaessa otsikon vieressä olevan historiakuvakkeen kautta tallennettu lukema. Lisäohje on käyttötuntimittarin lukeman tarkistaminen. Tarkista myös huoltopohjien mahdollisesti luomat tehtävät.

Android- ja iOS-sovelluksissa sama lukema näkyy Spotin tiedoissa Konetunnit-kohdassa, kun Spotin käyttötuntitoiminto on käytössä. Avaa Spotin tiedot uudelleen tarkistaaksesi ajantasaisen arvon. Katso tarvittaessa Spotin avaaminen mobiilisovelluksessa.

Jos kohteita ei löydy, tarkista KIHO-tunnusten pääsy oikeisiin ajoneuvoihin tai laitteisiin sekä mahdollinen aiempi kytkentä. Hakutuloksia palautetaan enintään 200, joten tarkenna hakua. Jos siirto ei päivity, tarkista esikatselusta ajoneuvoyhteys, sijaintihaun onnistuminen ja tuntien vertailuarvot. Jos tunnistautuminen on estynyt, korjaa ja tallenna tunnistetiedot uudelleen sekä testaa yhteys.

Poista kytkentä tai pysäytä synkronointi

Poista yksittäinen liitos avaamalla Telemetriasynkronointi → Hallinnoi paikkakytkentöjä, painamalla rivin roskakorikuvaketta ja vahvistamalla poisto. Spotti ei tämän jälkeen vastaanota tietoja kyseisestä KIHO-kohteesta. Poisto poistaa kytkennän ja sen vertailuarvot, mutta säilyttää Spotin, siihen jo tallennetut sijainti- ja tuntitiedot sekä historian.

Spotin poistaminen poistaa myös sen KIHO-kytkennän. Pelkkä Spotin muuttaminen muuhun kuin poistettuun tilaan ei pysäytä KIHO-siirtoa. Käytä kytkennän poistamista tai synkronoinnin asetusta, kun haluat lopettaa tietojen tuonnin.

Pysäytä koko KIHO-telemetriasynkronointi poistamalla Käytössä-valinta ja tallentamalla asetukset. Tämä säilyttää paikkakytkennät, niiden vertailuarvot, yhteystunnukset ja aiemmin tallennetut tiedot. Synkronoinnin pysäyttäminen ei poista jo syntyneitä huoltotehtäviä.

Poista tallennetut tunnistetiedot tarvittaessa Tunnistautuminen-välilehden painikkeella Tyhjennä tallennetut tunnistetiedot ja vahvista tyhjennys. Se poistaa myös yhteyden käyttöoikeustunnuksen ja vahvistusajan, mutta säilyttää paikkakytkennät ja synkronoinnin asetukset. Tietojen siirto tarvitsee tämän jälkeen uudet toimivat tunnistetiedot.