PrimusQueryn käyttöönotto

PrimusQuery

Päivitetty viimeksi: 20.6.2022

PrimusQuery on Primuksen apuohjelma, jonka avulla voidaan tehdä automatisoituja kyselyitä Primukseen. Kyselyt voi ajastaa esimerkiksi käyttöjärjestelmän ajastustoiminnoilla suoritettavaksi vaikkapa kerran vuorokaudessa tai tunneittain - käyttötarpeen mukaan.

PrimusQueryn avulla voidaan myös tehdä käyttäjälle helpompi tapa suorittaa ei-ajastettuja tiedonsiirtoja. Tällöin käyttäjän ei tarvitse kirjautua Primukseen ja osata tehdä manuaalista tiedonsiirtoa. Käyttäjälle tehdään yksinkertaisesti työpöydälle kuvake, josta tiedonsiirron voi käynnistää.

Ohjeen lopussa on liitteenä PrimusQuery-manuaali PDF-muotoisena.

Lisäksi lopussa on liitteenä PDF-muotoinen dokumentti, jossa on esitelty PrimusQueryn lukuisat hyödyt ja käyttömahdollisuudet. Tekstissä on käytännön esimerkkejä siitä, miten PrimusQueryn avulla saa Primuksen osaksi kunnan tietojärjestelmäarkkitehtuuria.

Ajastettuja tiedonsiirtoja käytetään mm.:

  • tiedonsiirroissa oppimisympäristöihin
  • tiedonsiirroissa AD-työkaluja varten

Ei-ajastettujen tiedonsiirtojen käyttökohteita ovat mm:

  • vuosittainen opettajatietojen tiedonsiirto henkilöstö- ja palkkajärjestelmiin
  • kuukausittainen iltapäivätoiminnan laskutustietojen siirto laskutusjärjestelmään

PrimusQueryn avulla voidaan luoda Primuksen tiedoista esim. CSV-tiedostoja tai HTML-sivuja. HTML-sivujen avulla voidaan helposti luoda ajantasalla olevia web-sivuja Primuksen tiedoista.

PrimusQueryllä voi myös tallentaa XML-muotoista tietoa Primukseen. Viennin avulla voidaan luoda ja poistaa rekisterikortteja sekä muuttaa kenttien tietoja.

PrimusQuery ladataan ohjelmapäivityspalvelusta. Se päivittyy automaattisesti uusimpaan versioon aina, kun siihen tulee muutoksia.

PrimusQueryn käyttö edellyttää käyttäjätunnuskortin liittämistä henkilökorttiin, ks. lisätietoa.

Varmistakaa myös, että palomuurissanne sallitaan PrimusQuerylle ulospäin seuraava yhteys:

  • Osoite: https://primushub.service.inschool.fi
  • Portti: 443

Yhteyttä tarvitaan mm. yhteysasetusten vuoksi. PrimusQueryn käytössä tulee yhteysvirhe, jos yhteyttä ei ole sallittu.

Jos käytätte PrimusQuerya Windows-ympäristössä, se tarvitsee hakemistoonsa 64-bittiset libeay32.dll- ja ssleay32.dll -tiedostot. Jos taas käytätte PrimusQuerya Linux-ympäristössä, se tarvitsee libgoutils.so-tiedoston.

Saat tiedostot tarvittaessa tämän ohjeen lopusta Tiedostot-otsikon alta.

PrimusQuery päivittyy automaattisesti uusimpaan versioon, kun se on tarpeellista. PrimusQuerya ei ole siis tarpeen päivittää manuaalisesti, mutta jos PrimusQueryn version haluaa aina vastaavan Primuksen versiota, sen voi päivittää manuaalisesti samaan versioon Primuksen kanssa. Tästä on tarkempi ohje PrimusQueryn manuaalissa.

PrimusQuery-siirtoja voi tehdä Primuksen Käyttäjätunnukset-rekisterissä olevilla käyttäjätunnuksilla. Tunnuksella, jolla tiedonsiirtoja ajetaan, tulee olla henkilölinkitys, jotta tietoa voi viedä/tuoda henkilörekistereiden osalta. Alla linkitetyssä ohjeessa on tarkempaa tietoa henkilölinkityksen vaikutuksista.

PrimusQuery-siirroissa huomioidaan myös Käyttäjätunnukset-rekisterin Kotikoulu-kenttä. Jos tunnukselle on merkitty kenttään jokin koulu, tunnuksella ei voi siirtää tietoa muiden kuin oman koulun korteille/korteilta. Tämä koskee kaikkea tietoa korteilla, eli ei voi siirtää edes oman koulun korteille esim. suorituksia opiskelijalle toisten koulujen kursseihin tai linkkikenttiin viittauksia toisten koulujen kortteihin.

Tiedostot