Päivitetty viimeksi: 21.6.2021
PrimusQueryn avulla voidaan automatisoida monenlaisia hälytyksiä ja muistutuksia käyttäjien jokapäiväisen työn helpottamiseksi. Tällaisista hyödyllinen esimerkki on hälytys uudesta Primukseen muodostuneesta hakijakortista. Alla on vaiheittaiset ohjeet tällaisen hälytystoiminnon toteuttamiseen PrimusQueryn avulla.
Tästä on saatavilla ohjevideo Wilma Akatemia -koulutuspalvelussa. Tilaa Wilma Akatemia käyttöösi tästä.
1. Sähköpostiosoitteen tarkistus
Tarkista, että kaikille opettajille on tallennettu Opettajat-rekisterissä sähköpostiosoite kenttään Sähköpostiosoite. Sitä käytetään tässä esimerkissä sähköpostin lähetysosoitteena, mutta on toki mahdollista käyttää jotain toistakin kenttää (esim. Arviointi- tai Luokat-rekisterin tekstikenttä), josta sähköpostiosoite hälytyksiä varten katsotaan.
2. PrimusQuery-määritys Primukseen
Tallenna tietokoneellesi ohjeen lopusta Liite-otsikon alta PrimusQuery-määritys (hakijamuistutus_generointi.txt) ja siirrä se Primukseen PrimusQuery-siirrot-rekisterissä valitsemalla Tiedonsiirrot / Tiedonsiirto Primukseen. Valitse tiedonsiirron tyypiksi "Tiedonsiirto toisesta Primuksesta" ja rasti asetuksista "Tuo kaikki uutena".
3. Määrityksen muokkaus
Vaihda äsken tuotuun määritykseen #OUTPUT-kohtaan sellainen sijainti, johon tiedosto oikeasti voidaan tallentaa. Muokkaa määritykseen myös vähintään seuraavat tiedot:
- <LAHETTAJA>"[email protected]"</LAHETTAJA> - Vaihda tähän oman organisaatiosi sähköpostiosoite.
- <VIESTI>Käy tarkistamassa ja täydentämässä hakijan tiedot Wilmassa osoitteessa https://wilma.oppilaitos.fi/forms/123456/#DATA{V1}.</VIESTI> - Vaihda tähän joko koko viesti tai muuta vain numerosarjan "123456" tilalle sen lomakkeen korttinumero, jolla hakijan tietoja on tarkoitus Wilmassa täydentää. Jos ette täydennä hakijan tietoja Wilmassa, niin ohjeista viestin saajaa tarkastelemaan hakijan tietoja Primuksesta.
Määrityksen #SEARCH eli hakulauseke on nyt muotoa Hakuajankohta=Nykyinen päivämäärä JA Käsittelyssä=Ei JA Valittu=Ei. Tätä kannattaa muokata oppilaitoksenne prosessien ja kenttäkäytäntöjen mukaiseksi, jotta jo käsittelyyn otetuista tai valituista hakijoista ei turhaan lähetetä hälytyksiä.
4. Muistutusviesti Primukseen
Tallenna tietokoneellesi ohjeen lopusta Liite-otsikon alta PrimusQuery-määritys (muistutusviesti_lahetys.txt) ja siirrä se Primukseen PrimusQuery-siirrot-rekisterissä valitsemalla Tiedonsiirrot / Tiedonsiirto Primukseen. Valitse tiedonsiirron tyypiksi "Tiedonsiirto toisesta Primuksesta" ja rasti asetuksista "Tuo kaikki uutena".
5. Ajastus ja muokkausmahdollisuudet
Voit ajastaa esim. Windowsin komentorivin avulla seuraavat komennot:
primusquery 127.0.0.1 1222 tunnus salasana hakijamuistutus_generointi
primusquery 127.0.0.1 1222 tunnus salasana muistutusviesti_lahetys -i hakijamuistutus.xml
Korvaa yllä olevasta Primus-palvelimen osoite ja portti oikeiksi ja määritä käyttöön PrimusQuerya varten tehty käyttäjätunnus.
Huolehdi siitä, että komentojen väliin jää pari minuuttia aikaa, jotta ensimmäinen komento ehtii muodostaa XML-tiedoston, joka tuodaan takaisin jälkimmäisellä komennolla. Jos ajat ne samasta komentorivitiedostosta, niin ongelmia ei pitäisi ilmetä. Huomaa, että toisen komennon kohdalla oletetaan ensimmäisen komennon tuottaman XML-tiedoston sijaitsevan hakemistossa, josta jälkimmäinen komento ajetaan. Tarvittaessa XML-tiedoston polku voidaan vaihtaa osoittamaan muuhunkin sijaintiin.
Tässä esimerkissä on ajateltu, että viestit ajastetaan lähetettäväksi kerran päivässä esim. päivän päätteeksi. Muuten voi käydä niin, että samoista hakijoista tulee viestejä useampaan kertaan.
Yllä esiteltyä määritystä on myös mahdollista kehittää niin, ettei jokaisesta käsittelemättömästä hakijasta lähetetä omaa sähköpostimuistutusta. Tämä vaatii kuitenkin ulkoisia skriptejä, jotka ei tässä ohjeessa esitellä.
Tiedostot
