Primus-integraatio

Movitin Primus integraation käyttöönotto ja ohjeistus

Alustus

Tässä dokumentissa kuvataan asiakasorganisaation, yleisesti kunnan käytössä olevan Primus‑järjestelmän, sekä meidän eli Intoit Oy:n Movit‑järjestelmän välisen integraation käyttöönottoa ja käyttöä.

Primus on Visman ylläpitämä järjestelmä, jota käytetään laajasti kouluissa ja kunnissa. Järjestelmässä ylläpidetään muun muassa oppilaskortteja. Kouluissa käytössä oleva Wilma-järjestelmä toimii Primuksen päällä.

Movitissa käytössä oleva Primus-integraatio mahdollistaa tiedon siirtämisen Primuksen ja Movitin välillä. Integraation avulla tietoa voidaan siirtää joko Primuksesta Movittiin tai molempiin suuntiin kunnan tarpeiden mukaan.

Integraation tarkoituksena on helpottaa tiedon ylläpitämistä sekä varmistaa tiedon oikeellisuus ja ajantasaisuus sekä Primuksessa että Movitissa.

HUOM. Integraatiota ja siihen liittyvää käyttöliittymää kehitetään jatkuvasti. Tämän vuoksi on mahdollista, että tässä dokumentissa kuvatut toiminnot tai näkymät poikkeavat osittain järjestelmän nykyisestä versiosta.

Käyttöönotto ja määritykset

Jokainen Primus integraatio on yksilöllinen, riippunen miten ja missä laajuudessa kunta sitä käyttää. Seuraavassa käydään läpi mitä kaikkea tarvitaan toimivan ja pitää ottaa huomioon integraation käyttöönottoon.

Mahdolliset ongelmatilanteet on myös käyty jäljempänä läpi.

Integraation käyttöönotto

Integraatio ei ole oletusarvoisesti Movit-instanssissa käytössä, vaan se on erillinen feature flag, joka aktivoidaan Intoit-käyttäjätunnuksilla Movit hallintavalikon kautta. Aktivoinnin jälkeen integraatiota varten tehdään vielä erilliset määritykset (osoite ja portti) kehittäjän toimesta.

Kunnalta tarvitsemme seuraavat tiedot yhteyden muodostamista varten.

-          Primus-palvelimen verkko-osoite (esim. leppavirta.inschool.fi)

-          Käytettävä portti (esim. 1222, jos poikkeaa oletusarvosta 443)

Vain kunnalla on pääsy Primukseen, joten kaikki muutokset ja tarkistukset Primukseen täytyy tehdä kunnan työntekijän toimesta.

HUOM. Jos kunnan Primus-palvelimen verkko-osoite ja/tai Käytettävä portti muuttuu. On huomioitava, että PrimusQueryConnectionStringin host-arvoa käytetään suoraan Movitissa ulkoisen järjestelmän tunnisteena (ID). Pelkkä portin ja osoitteen muuttaminen ei ole riittävä toimenpide, mikäli Movittiin on jo aiemmin tuotu matkustajia Primus-integraation kautta, jolloin tulee kyseisten matkustajien osalta päivittää tietokantaan ulkoisen järjestelmän tunniste (ID), muuten ne tuodaan uusina ja syntyy duplikaatteja.

Mikäli tätä ei tehdä, järjestelmä tulkitsee samat matkustajat uusiksi tietueiksi ja luo niistä uudet profiilit, mikä johtaa duplikaattien syntymiseen.

Primukseen tulee luoda erillinen testi-käyttäjätunnus Movit-integraatiota varten. Yleensä vain kunnan Primus pääkäyttäjällä on tähän tarvittavat oikeudet. Tämä tunnus on vain testaus- ja koulutuskäyttöä varten, jota käytetään tiedonsiirron testaukseen Primuksen ja Movitin välillä sekä asiakkaan koulusta varten. Tunnus voidaan kunnan näin halutessa poistaa, kun integraatio on otettu onnistuneesti käyttöön, mutta poistaminen voi hidastaa mahdollisia häiriöiden selvittämistä tulevaisuudessa. Normaalissa arkikäytössä käytetään aina kunnan käyttäjien omia Primus tunnuksia.

-          testikäyttäjälle tulee aina antaa vähintään seuraavat käyttöoikeudet:

o   koulut – koulutiedot (vähintään testikoulut)

o   lk – luokkarekisteri (vähintään testikoulujen luokat)

o   opphenk – oppilastiedot (vähintään testioppilaat)

o   kuljetus – kuljetusmuotojen haku (koulukuljetusoppilaiden tunnistaminen)

o   liikenne – liikennöitsijät ja autot (reittitiedot, mikäli käytössä)

Kaikilla kunnilla ei ole Primuksessa määriteltynä kuljetusmuotoja. Jos näin on, sovimme erikseen, miten koulukuljetusoppilaat rajataan Movitiin siirrettäväksi.

Mikäli liikennerekisterin tiedot (liikennöitsijät, autot) ovat Primuksessa ajan tasalla, voimme hyödyntää myös näitä tietoja Primusintegraation käytössä. 

Määritykset

Kunnat käyttävät Primus-järjestelmää eri tavoilla, eikä sen käyttöön ole olemassa yhtä yhtenäistä toimintamallia. Tästä syystä käyttöön liittyviä variaatioita on yhtä paljon kuin käyttäviä kuntiakin.

Saatavilla on alustava listaus tiedoista, joita Movit hakee integraation kautta sekä tieto siitä, mistä järjestelmän osista tiedot lähtökohtaisesti noudetaan. Tästä huolimatta jokainen integraatio määritellään ja toteutetaan tapauskohtaisesti tällä hetkellä.

Kartoitusvaiheessa käydään kunnan kanssa läpi, mitä tietoja integraation kautta siirretään ja mihin ne kohdistuvat. Tämän jälkeen määritellään, mistä Primuksen kentistä tiedot haetaan ja missä muodossa ne tuodaan Movit-järjestelmään.

Primuksessa oleva kenttäkoodi muodostetaan muodossa K + kentän numero (esim. K1234).

Yllä näkymä Primuksen käyttöliittymästä. Hakasuluissa oleva numero on primuksen kentän numero (K-numero). Tässä esimerkissä on Kivelän koulu Leppävirran kunnassa. Koulun nimi tulee kentästä K2.

Jos kunta ei käytä lukukaudessa jaksoja, Primukseen on määritettävä vähintään yksi jakso, jotta integraatio voidaan ottaa käyttöön ja se toimii oikein.

Määrityksessä on hyvä tarkistaa, että oppilastyypeissä löytyy kaikki mitä kyseisessä kunnassa on käytössä sekä löytyykö kaikki olemassa olevat koulut ja luokat.

Mikäli kunnalla on Primukseen määritetty apuvälineet, voidaan ne siirtää integraation avulla Movittiin, mutta tämä tulee aina tehdä erikseen kehittäjän kanssa, joka määrittää mistä kentästä tieto tuodaan Movittiin.

Esim.   Primuksessa kentässä (K12236, opphenk) Oppilas tarvitsee vastaanottajan kotona Tuodaan meillä täppä kohtaan Vastaanottaja Movitin matkustaprofiiin kohtaan Apuvälineet.

Kaksisuuntainen Integraatio

Mikäli halutaan, että Movit voi myös siirtää tietoja takaisin Primukseen (esimerkiksi

koulumatkojen etäisyydet tai hakuajat), tulee Primukseen määrittää PrimusQuery-siirto alla olevin määrityksin.

-          Lisätään uusi määritys PrimusQuery-siirrot-rekisteriin

-          Nimi: movit-import

-          Kanta: opphenk

-          Määritys: Intoit:n toimittama määritystiedosto (listaus dokumentin lopussa).

Määritystiedosto määrittää ne kentät, joihin Movit saa kirjoittaa tietoja Primuksessa.

Kenttälistaus löytyy Primuksesta osoitteesta: https://update.service.inschool.fi/cgibin/kantacgi?opphenk&english

Mahdolliset Ongelmatilanteet

Jos yhteyttä ei saa luotua vaan tulee virheilmoitus login failed on yleensä syy seuraavissa.

-          Osoite tai portti väärin

o   Primuksesta pitää tarkistaa tietojen oikeellisuus

-          PrimusQuery ei ole päällä.

o   Tämä ei ole oletuksena päällä Primuksessa vaan pitää erikseen käydä aktivoimassa laittamalla täppä oikeaan kohtaan Primuksen asetuksista, jos kunta ei ole sitä aikaisemmin käyttänyt muuhun tarkoitukseen.

-          Kaksivaiheinen tunnistus Primukseen

o   Integraatio ei tällä hetkellä tue kaksivaiheista tunnistautumista ja tähän ainoa ratkaisu on kunnan tehdä erilliset tunnukset Movitin käyttöön ilman kaksivaiheista tunnistautumista. Kaksivaiheinen tunnistautuminen ei yleisesti ole vielä käytössä, mutta yleistyy todennäköisesti lisääntyvien tietoturvavaatimusten myötä.

-          Palomuuri estää yhteyden

o   Tarvitaan palomuuriin avauksia Visman suuntaan, jolloin kunta on yhteydessä toimittajaan ja pyytää avaamaan kehittäjän ilmoittamat IP-osoitteet.

o   Joissakin harvinaisissa tapauksissa syy voi olla internet-protokollan versiossa. Yleisesti käytössä on IPv6 (Internet Protocol version 6) mitä myös Movit käyttää. Jos kunnalla on käytössä IPv4 tarvitaan väliin erillinen yhteyspalvelin, joka käyttää IPv4 standardia.

Jos kirjautuminen onnistuu, mutta järjestelmä antaa virheilmoituksen, syy on yleensä mappauksessa. Tällöin kysely menee teknisesti läpi, mutta paluuviesti on puutteellinen tai virheellinen.

-          Jokin kenttä, josta Movit hakee tietoa ei ole käytössä kunnalla tai on tyhjä

o   Jos Movit saa tekemäänsä kyselyyn tyhjän tuloksen (null), näytetään virheilmoitus

Esim.  Error: Primus-listaus ei sisällä yhtään liikennöitsijää

§  Ratkaisu on ohjata kysely käyttämään toista kenttää, jos mahdollista tai kunta ottaa kyseisen kentän käyttöön.

-          Tunnuksella, jota käytetään ei ole tarpeeksi oikeuksia

o   Primuksessa annetaan tunnukselle tarpeeksi oikeuksia.

-          Tunnus on luotu puutteellisesti.

o   Tunnuksen voi kopioida jo olemassa olevasta toimivasta tunnuksesta, jos tunnuksen kanssa on haasteita.

Jos kirjautuminen onnistuu eikä järjestelmä anna virheilmoitusta, mutta haku ei tuota yhtään tulosta, syynä voi olla edellä mainittu virheellinen mappaus tai käyttäjätunnukseen liittyvä ongelma.

Tilanteessa, jossa haku ei tuota tuloksia tai on vajanainen, mahdollisena syynä voi olla myös Primus-asetuksessa asetettu suodatus, joka tulee tarkistaa kehittäjän toimesta.

Ohjeistus integraation käyttöön

Kirjautuminen

Primus integraatio löytyy yläpalkin lisätoimintojen alta

Integraatioon kirjaudutaan käyttäjän omilla Primus-käyttäjätunnuksilla. Intoit:llä on yleensä käytössä testi-käyttäjätunnus (löytyy salasananhallintajärjestelmästä), joilla voidaan testata yhteyden toimivuus.

Kirjautumisen yhteydessä valitaan Primus-järjestelmä, johon yhteys muodostetaan. Valinta on käytettävissä vain, jos samassa Movit-instanssissa on integraatio useampaan Primus-järjestelmään, muussa tapauksessa kenttä on harmaana eikä valittavissa.

Tämän jälkeen syötetään Primus-käyttäjätunnus ja kyseiseen tunnukseen liittyvä salasana, minkä jälkeen siirrytään seuraavaan vaiheeseen. Yhteyden muodostaminen voi kestää hetken. On huomioitava, että Primus-käyttäjätunnus on eri kuin Movit-käyttäjätunnus.

HUOM, kun liikutaan käyttöliittymässä, käytetään alareunassa olevia edellinen vaihe ja seuraava vaihe painikkeilla. Tai vaihtoehtoisesti yläreunassa olevia välilehtiä, mutta ei käytetä selaimen eteen ja taakse -painikkeita.

Tietojen lataus

Seuraavaksi tulee tietojen lataus -välilehti, jossa määritetään mitä tietoa halutaan käsitellä ja hakea Primuksesta. Käyttöliittymässä voidaan käsitellä tietoa isommissa ryhmissä tai vain yksittäistä oppilasta.

Oppilastyyppejä on kunnilla yleensä useita, joista osaa ei tarvita kuljetussuunnittelussa, joten oppilaslajin perässä olevasta suppilosta painamalla saa auki alla näkyvän ikkunan, josta voi määrittää näkymässä näkyvät oppilastyypit. Tämä valinta pysyy muistissa tunnuksella eikä tarvitse erikseen joka kerta tehdä.

Valitaan ensin oppilastyyppi esim. peruskoulu oppilas.

Tämä määrittää mitä oppilaita primuksesta ja valittuna voi olla vain yksi kerrallaan (kunnasta riippuen tämä tieto haetaan kentästä oppilastyyppi tai oppilaslaji).

HUOM. Koulusuodatus näyttää kaikki koulut, esimerkiksi mikäli oppilaslajina on valittuna esikoulu, mutta suodatuksessa on valittuna koulu, joka ei sisällä esikoulua, ei haku tuota yhtään tulosta.

Tämän jälkeen, jos valittuna on koulut/luokat tehdään seuraavat suodatukset.

-          Suodata matkaoikeudella (hakee ne, joihin kyseisellä tunnuksella oikeudet)

o   ei suodatusta

o   Hae vain oppilaat, joilla ei ole kuljetusoikeutta Primuksessa

o   Hae vain oppilaat, joilla on kuljetusoikeus primuksessa 

-          Suodata kuljetustyypillä (tarvittaessa, jos käytössä)

o   Juna (K3644)

o   Bussi (K3645)

o   Taksi (K3646)

o   Erillinen (K3647)

o   Tilausbussi (K3648)

o   Muu (K3649)

-          Koulut

o   Listaa kaikki kunnan koulut

§  Valitaan koulu tai koulut, joista tietoa halutaan hakea.

-          Luokat

o   Listaa kaikki luokat, joita valituissa kouluissa löytyy

§  pitää valita vähintään yksi, jos ei haluta rajata valitaan kaikki.

§  Jos jollakin luokalla ei ole määritetty yhtään oppilasta näkyy se harmaana

Kun haetaan vain yhden oppilaan tietoja, tarvitaan mistä sitä haetaan eli oppilastyyppi esim. peruskoulu oppilas.

Sukunimi ja etunimi kentät ovat molemmat pakollisia, mutta siihen voi kirjoittaa joko kokonimen tai nimen alkuosat Erkki Esimerkki -> es er.

Jos haku tuottaa tuloksen tai useita tuloksia, ne esitetään näkymässä hakutoiminnon alapuolella. Jos useampi tulos, valitse oikea tällä kertaa käsiteltävä oppilas.

Koulukuljetusoikeudet

Koulukuljetusoikeudet välilehdellä näkyy oppilaskortilta tulevat tiedot, jotka Primukseen on merkitty sekä tarvittavat Movit tiedot.

-          Primus ID

o   Primuksessa oleva oppilaan tunniste

-          Movit ID

o   Movitissa olevan matkustajan tunniste, jos oppilas löytyy jo Movitista.

Jos sarake on tyhjä ei oppilasta ole vielä Movittiin luotu ja tallennuksen jälkeen oppilas luodaan (riippuen ollaanko tuomassa tietoa Movittiin).

-          Matkustaja

o   Primuksessa oleva oppilaan nimi. Yleensä etunimi tulee Primuksen kentästä (K3) jossa hänen kaikki etunimet. Jos oppilaat ovat jo Movitissa, nimen tulee täsmätä Primuksesta tuotavaan nimeen, muuten Movittiin syntyy uusi matkustaja uudella nimellä. Movitin asetuksiin on myös kehittäjän mahdollista määritellä integraatioon tuomaan etunimi Primuksen kutsumanimikentästä (K4).

-          Koulu

o   Oppilaalle Primuksessa määritetty koulu.

Jos oppilaalta puuttuu koulu ei suodatukset löydä oppilasta.

§  HUOM. Tällä hetkellä, jos oppilas löytyy Movitista, yliajaa Movitissa oleva koulu Primuksen koulun.

-          Luokka/Ryhmä

o   Oppilaan Primuksessa ylläpidetty luokka. Jos oppilaalle jo määritetty seuraavan lukukauden luokka, näkyy se suluissa alempana.

-          Kävelymatkan yläraja

o   Vetovalikko, jossa vaihtoehtoina ovat 3 km ja 5 km. Kävelymatkan yläraja määräytyy luokka-asteen mukaan siten, että 1.ja 2. luokkalaisille käytetään 3 km:n rajaa ja tätä ylemmille luokka-asteille 5 km:n rajaa. Tiedon syöttävä henkilö voi kuitenkin tarvittaessa muuttaa valintaa, mikäli katsoo sen tarpeelliseksi.

HUOM, Movit ei tällä hetkellä osaa erottaa peruskoulun ja lukion 1–2 luokan oppilaita, joten järjestelmä antaa oletuksena myös lukio oppilaille 3 km ylärajan.

-          Kotiosoite

o   Oppilaan Primuksessa määritetty kotiosoite.

§  HUOM. Tällä hetkellä, jos oppilas löytyy Movitista, yliajaa Movitissa oleva osoite Primuksen osoitteen.

-          Kävelymatka (km)

o   Movit laskee kotiosoitteen ja koulun välisen matkan. Oletuksena on lyhin reitti, mutta sen voi välilehden ylävalikosta vaihtaa suositelluksi reitiksi.

Jos Primuksessa oleva matka poikkeaa Movitin laskemasta näkyy se alempana harmaana tekstinä, joka ylivedetty.

-           Reitti

o   Sarakkeessa lukee ”Näytä kartta” josta aukeaa alla oleva ponnahdusikkuna

o   Karttanäkymään piirretään reitti valinnan mukaisesti joko suositeltuna reittinä tai lyhimpänä reittinä, jota on mahdollista muuttaa tarvittaessa kohdasta, hae lyhin reitti tai vaihtoehtoisesti hae suositeltu reitti, riippuen kumpi on tällä hetkellä valittuna.

o   Ponnahdusikkunassa esitetään lisäksi reittiin liittyvät tiedot, kuten:

§  oppilaan nimi

§  kotiosoite

§  Koulumatkan pituus (kävellen)

§  mahdolliset Primukseen kirjatut lisätiedot kuljetussuunnittelijalle

o   Ponnahdusikkunassa voidaan myös tehdä koulukuljetuspäätös (Koulukuljetuksessa). Koulukuljetuspäätös on mahdollista tehdä vaihtoehtoisesti jo edellisessä vaiheessa ilman karttanäkymän avaamista.

o   Näkymään voi saada myös seuraavat optiot kunnan näin tilatessa, jotka aktivoidaan kartan yläreunan painikkeilla.

§  Julkisen liikenteen pysäkit.

Riippuen missä kunnan aikataulut on ylläpidetty, voidaan tehdä integraatio joko Digitransitiin tai Digiroadiin tai molemmat kunnan näin halutessaan (Digitransit on korvaamassa Digiroadin, joten ensisijaisesti kannattaa suosia Digitransitia).

§  Vaaralliset tiet (koululiitu.fi)

Tätä varten tarvitaan koululiidusta kunnan geojson-tiedosto.

Movit ei osaa käyttää tätä tietoa, kun laskee koulumatkaa vaan kyseessä on graaffinen lisäys, joka auttaa hahmottamaan mahdollisia vaarallisia tieosuuksia.

-          Koulukuljetuksessa

o   Onko oppilas oikeutettu koulukuljetukseen (kyllä/ei) ja mikä mahdollinen kuljetuksen muoto Primukseen on määritetty.

Lukujärjestys

Lukujärjestyksessä tuodaan oppilaiden primuksessa ylläpidetyt oppilaiden kouluajat (aloitus ja lopetusaika).

Huom. Lukujärjestys näkymään siirtyy vain ne oppilaat, joilla oli edellisessä näkymässä määritetty koulukuljetusoikeus.

Ylhäältä valitaan vetovalikosta oikea jakso.

Jos tämä on Primuksessa väärin ylläpidetty tuo integraatio väärät lukujärjestykset tai ei tuo ollenkaan. Jakso tuodaan kentistä K110 ja K111.

Huom. Kunnat ylläpitävät lukujärjestyksiä Kurre-järjestelmässä.

-          Lukujärjestykset pitää siirtää Kurresta manuaalisesti Primukseen jaksoittain, jotta lukujärjestykset näkyvät Movitissa oikein.

Näkymässä on oppilaan nimi, koulu, luokka sekä viikon koulupäivän aloitus- ja lopetus ajat (meno ja paluu).

Kyseisessä näkymässä voi myös muokata aikoja manuaalisesti tarpeen vaatiessa.

Primuksesta tuotu lukujärjestys tulee näkyviin matkustajan profiiliin matkojen alapuolelle.

Yllä esimerkki Movitin matkustajaprofiilissa olevasta lukujärjestyksestä.

HUOM. Mikäli Primukseen ei ole määritetty tulevaa lukujärjestystä (esimerkiksi keväällä syksyn suunnittelua tehtäessä), massasyötön Hae aikataulut ‑toiminto ei löydä lukujärjestyksiä.

Koulumatkat

Koulumatkat ja matkatyyppi -välilehdellä määritetään millä mahdollisella matkatyypillä (julkinen/kuljetus) oppilas kulkee koulumatkat.

Määritykset voi tehdä päiväkohtaisesti sekä matkakohtaisesti. Valitsemalla yksittäisten päivien kohdalla tai oikeasta sivusta voi valita kaikki päivät.

Esim. oppilas kulkee julkisilla, mutta keskiviikkona loppuu myöhemmin, jolloin julkiset ei enää kulje, joten hänelle myönnetty keskiviikko iltapäivälle taksikuljetus. Tällöin hänellä on keskiviikon paluumatkaa lukuun ottamatta julkinen liikenne.

Jos käyttöliittymään on tehty integraatio julkisen liikenteen aikatauluihin (Digiroad tai Digitransit) saadaan arvioitu matka-aika julkisilla näkyviin koulumatkat -välilehdelle painamalla ”Hae julkisen liikenteen aikataulut” painiketta.

Tällöin Movit laskee aikataulujen perusteella mahdollisen matka-ajan.

HUOM. Vaikka matkoja voi käyttöliittymässä katsoa viikkokohtaisesti ei Tällä hetkellä voi käyttöliittymässä tehdä muutoksia viikkokohtaisesto vaan muutokset tapahtuvat aina kaikkiin päiviin tulevaisuuteen tästä hetkestä alkaen.

Tarvittaessa päivä ja viikkokohtaiset muutokset tehdään suoraan Movitin matkustajaprofiiliin.

Tietojen tallennus

Jotta tieto tallennetaan pitää lopuksi määrittää mitä tietoa ja minne tallennetaan.

Näkymässä valitaan tiedon siirtosuunta, jos kunnassa käytetään, kaksisuuntaista tiedonsiirtoa.  Muussa tapauksessa integraatio on vain Primuksesta Movittiin.

Yhteenvedossa näkyy mitä tietoa ollaan tallentamassa sekä tässä näkymässä voi vielä valita mitä tietoja tallennetaan.

Yllä olevassa esimerkissä ylimmän oppilaan matkustajaprofiili on jo olemassa Movit-järjestelmässä, minkä vuoksi sillä on valmiiksi Movit ID. Tässä tapauksessa uutta tunnusta ei luoda, vaan ainoana muutoksena päivitetään lukujärjestys.

Kahta alimmaista matkustajaprofiilia ei puolestaan ole vielä löydy Movitista, joten tallennuksen yhteydessä järjestelmä luo niille uudet matkustajaprofiilit Movitiin.

Keskimmäistä profiilia ei ole valittu tallennettavaksi, minkä vuoksi sen tietoja ei siirretä eikä tallenneta. Tämä näkyy käyttöliittymässä harmaana ja yliviivattuna.

Tiedonsiirto suositellaan suoritettavaksi hallituissa erissä, esimerkiksi luokka kerrallaan. Näin mahdolliset muutokset, poikkeamat ja virhetilanteet voidaan tunnistaa, kohdentaa ja tarkistaa tehokkaasti tuontiprosessin aikana.

Kun on varmistettu, että tehdyt muutokset ja lisäykset vastaavat toivottua lopputulosta, tiedot voidaan tallentaa valitsemalla käyttöliittymän oikeassa alakulmassa sijaitseva Tallenna-painiketta.

Järjestelmä antaa vielä kuittauksen ponnahdusikkunalla, kun tiedonsiirto on tehty.

HUOM. On hyvä tarkistaa latauksen jälkeen Movitin matkustajalistauksesta, että kaikki tieto on siirtynyt eikä esim. osoitteita puutu (voi olla ongelma kaksikielisillä alueilla).

Oppilaasta siirtyy integraation kautta seuraavat tiedot

-          Nimi

-          Puhelinnumero

o   Vain ensisijainen numero.

§  Jos oppilaan profiiliin tarvitaan enemmän numeroita voi ne lisätä manuaalisesti suoraan Movitin käyttöliittymästä tai excel importin kautta. Jos Primuksen puhelinnumero kenttään on syötetty useampi numero, jotka pilkulla erotettu osaa integraatio lukea ne kahdeksi eri numeroksi.

-          Sähköposti

o   Jos Primuksesta tämä tieto löytyy

-          Profiilitieto kuljettajalle

o   Jos Primuksesta tämä tieto löytyy

-          Muistiinpanot (ajojärjestelijälle)

o   Jos Primuksesta tämä tieto löytyy

-          Luokka

-          Pääkohde

o   Yleensä koulu

-          Kotiosoite

-          Apuvälineet

o   Jos mappaus tehty ja Primuksesta tämä tieto löytyy

Näiden lisäksi integraation kautta siirtyy aiemmin mainittu lukujärjestys sekä mahdolliset kunnan kanssa erikseen määritetyt tiedot.

Tilausten luonti

Primus-järjestelmässä ei luoda tilauksia. Primuksesta siirretään Movit-järjestelmään lukujärjestystiedot, joiden perusteella tilaukset muodostetaan Movitin Massatyökalua hyödyntäen.

Kun oppilaan tiedot on tuotu onnistuneesti Primus-järjestelmästä Movit-järjestelmään, oppilaan lukujärjestykset ovat nähtävissä matkustajaprofiilissa. Tarvittaessa lukujärjestykseen liittyviä aikoja voidaan vielä muokata tässä vaiheessa.

Tilauksien luomiseksi avataan Movit-järjestelmän Massasyöttö-toiminto ylävalikon Lisätoiminnot-osion kautta. Massasyöttö on Movitin perustoiminnallisuuksiin kuuluva ominaisuus.

Tässä vaiheessa oppilaiden matkustajaprofiileihin Primus-järjestelmästä tuodut lukujärjestystiedot haetaan Hae aikataulut ‑toiminnon avulla.

Kun lukujärjestystiedot on onnistuneesti haettu, edetään tilauksien luomisessa normaalin prosessin mukaisesti.

Primus queryn määritykset

Alla on listaus kentistä, joihin Movit-järjestelmälle tulee myöntää kirjoitusoikeudet kaksisuuntaisen integraation ollessa käytössä.

Field K480, "k480_distance_to_school"

Field K481, "k481_school_transportation"

Field K485^V1, "k485xv1_mode_of_transportation_card_id"

Field K488, "k488_transportation_start_date"

Field K489, "k489_transportation_end_date"

Field K494, "k494_info_for_transportation_contractor"

Field K495, "k495_transportation_additional_info"

Field K498^V1, "k498xv1_transportation_contractor_1_card_id"

Field K499^V1, "k499xv1_transportation_contractor_2_card_id"

Field K830, "k830_mon_starts_at"

Field K831, "k831_mon_ends_at"

Field k835, "k835_tue_starts_at"

Field k836, "k836_tue_ends_at"

Field k840, "k840_wed_starts_at"

Field k841, "k841_wed_ends_at"

Field k845, "k845_thu_starts_at"

Field K846, "k846_thu_ends_at"

Field K850, "k850_fri_starts_at"

Field K851, "k851_fri_ends_at"

Field K832^V1, "k832xv1_mon_transp_1_card_id"

Field K833^V1, "k833xv1_mon_transp_2_card_id"

Field K837^V1, "k837xv1_tue_transp_1_card_id"

Field K838^V1, "k838xv1_tue_transp_2_card_id"

Field K842^V1, "k842xv1_wed_transp_1_card_id"

Field K843^V1, "k843xv1_wed_transp_2_card_id"

Field K847^V1, "k847xv1_thu_transp_1_card_id"

Field K848^V1, "k848xv1_thu_transp_2_card_id"

Field K852^V1, "k852xv1_fri_transp_1_card_id"

Field K853^V1, "k853xv1_fri_transp_2_card_id"

Field K857^V1, "k857xv1_transportation_1_card_id"

Field K858^V1, "k858xv1_transportation_2_card_id"

Field K881, "k881_mon_transport_arrives"

Field K882, "k882_mon_leaves"

Field K883, "k883_tue_transport_arrives"

Field K884, "k884_tue_leaves"

Field K885, "k885_wed_transport_arrives"

Field K886, "k886_wed_leaves"

Field K887, "k887_thu_transport_arrives"

Field K888, "k888_thu_leaves"

Field K889, "k889_fri_transport_arrives"

Field K890, "k890_fri_leaves"

Field K3604, "k3604_verified_distance_to_school"

Field K3605, "k3605_measuring_method_distance_to_school"

Field K3606, "k3606_measuring_method_details"

Field K3630, "k3630_transport_pick_up_place"

Field K3644, "k3644_train_transportation"

Field K3645, "k3645_bus_transportation"

Field K3646, "k3646_taxi_transportation"

Field K3647, "k3647_separate_transportation"

Field K3648, "k3648_chartered_bus"

Field K3649, "k3649_other_transportation"

Field K4967, "k4967_mon_afternoon_leaves"

Field K4968, "k4968_mon_afternoon_arrives"

Field K4969^V1, "k4969xv1_mon_transportation_contractor_1_card_id"

Field K4970^V1, "k4970xv1_mon_transportation_contractor_2_card_id

Field K4971, "k4971_tue_afternoon_leaves"

Field K4972, "k4972_tue_afternoon_arrives"

Field K4973^V1, "k4973xv1_tue_transportation_contractor_1_card_id"

Field K4974^V1, "k4974xv1_tue_transportation_contractor_2_card_id"

Field K4975, "k4975_wed_afternoon_leaves"

Field K4976, "k4976_wed_afternoon_arrives"

Field K4977^V1, "k4977xv1_wed_transportation_contractor_1_card_id"

Field K4978^V1, "k4978xv1_wed_transportation_contractor_2_card_id"

Field K4979, "k4979_thu_afternoon_leaves"

Field K4980, "k4980_thu_afternoon_arrives"

Field K4981^V1, "k4981xv1_thu_transportation_contractor_1_card_id"

Field K4982^V1, "k4982xv1_thu_transportation_contractor_2_card_id"

Field K4983, "k4983_fri_afternoon_leaves"

Field K4984, "k4984_fri_afternoon_arrives"

Field K4985^V1, "k4985xv1_fri_transportation_contractor_1_card_id"

Field K4986^V1, "k4986xv1_fri_transportation_contractor_2_card_id"