Mapon-integraatio

Muokattu Wed, 02 Aug 2023 klo 01:52 PM

Hillavaan voidaan tuoda Maponista ajopäiväkirjamerkintöjä. Ajot yhdistetään Hillavassa automaattisesti oikeaan tehtävään kulunseurantaa tai läpilaskutusta varten kun kuljettajalla on tehtävä suorituksessa mobiilissa. Jos mitään tehtävää ei ole suorituksessa, ei ajo yhdisty tehtävälle automaattisesti. Ajo tulee kuitenkin aina tiedoksi Hillavaan ja sitä voidaan pääkäyttöliittymässä jälkikäteen kohdistaa tehtävälle, johon ajo liittyy. Lisätietoja miten ajot käyttäytyvät Hillavassa löydät täältä

Käyttöönotto

Tässä on ohje Hillava-Mapon-integraation käyttöönottoon.

Mapon API-avaimen luominen

  1. Mene Maponissa näkymään Asetukset - API-koodit.
  2. Valitse Luo API-koodi.
  3. Valitse haluamasi asetukset ja tallenna koodi. 
  4. Toimita koodi Hillava-yhteyshenkilöllesi.

Maponin ja Hillavan käyttäjien yhdistäminen

Maponin ajoneuvon tiedoista löytyy myös tieto kuljettajasta. Jotta ajo voi kohdistua tehtävän suorituksen alettua automaattisesti haluttuun tehtävään, on tehtävää suorittavan resurssin oltava merkittynä ajoneuvon kuljettajana (sekä Hillavassa että Maponissa).


Jos kuljettajaa ei löydy Maponista tai saamme ajotiedon haun aikana virheen, reitti tuodaan ilman kuljettajaa eikä se kohdistu millekään tehtävälle. Kuljettaja synkronoidaan aina, kun ajo tuodaan Maponista. Jos kuljettajaa ei löydy Hillavasta, se luodaan ajon tuonnin yhteydessä. Kuljettaja yhdistetään resurssin Hillavan resurssiin Resurssinro-arvolla. Toimi näin:

  1. Mene Maponissa näkymään Kuljettajien hallinta - Kuljettajaprofiilit.
  2. Valitse oikeasta reunasta Asetukset.
  3. Valitse Mukautetut kentät.
  4. Lisää uusi kenttä.
  5. Anna kentälle nimerksi Resurssinro, tyyppi on teksti. Tallenna kenttä ja tallenna muokkaus.
  6. Luo Maponiin kuljettajat ja anna Maponin kuljettajan Resurssinro kenttään ko. käyttäjän Hillavan resurssinumero. Jos resurssinumeroita ei ole vielä käytössä, voit vapaasti määrittää numerot, joita käytätte. 

Ajoneuvotyypin lisääminen Hillavaan

Ajoneuvot yhdistetään Maponista löytyvän ajoneuvon ID:n avulla. 

  1. Mene Maponissa näkymään Kalusto
  2. Ota ajoneuvo "auton numero" kentästä lähempään tarkasteluun. 
  3. Ota selaimen URL-kentästä ID talteen. ID on URLin lopussa oleva numerosarja. 
    1. Esim https://www.mapon.com/pro/maintenance/car/000000 Tässä ID on loppuosassa oleva "000000" tieto.
  4. Avaa Hillava ja mene Resurssit-valikkoon Resurssit-välilehdelle
  5. Luo tai muokkaa ajoneuvoa, syötä Ajoneuvotiedot-välilehdelle kenttään "GPS-laitteen IMEI-koodi" Maponista ottamasi ID
  6. Tallenna

Ajoneuvo synkronoidaan aina, kun saamme eventin eli ajon Maponista. Jos ajoneuvoa ei löydy Hillavasta, se luodaan ajon tuonnin yhteydessä. 

Hillavassa ajoneuvon resurssityypillä pitää olla tunniste VEHICLE. Toimi näin:

  1. Mene Hillavassa Asetukset - Tehtävä ja resursointi - Resurssityypit -näkymään.
  2. Luo Ajoneuvo-resurssityyppi (tai muokkaa olemassa olevaa).
  3. Anna ajoneuvo-resurssityypille tunniste VEHICLE ja valitse "Näytä ajoneuvotiedot" ja "Sijainti ja reittiseuranta käytössä". Tallenna.