Linkit koulutuskalenteriin ja valmiit valintakorit

Linkkejä voi lisätä esim. verkkosivujen koulutusilmoituksiin. Oletuksena linkki vie koulutustarjonnan pääsivulle. Linkkiin voi kuitenkin lisätä määritteitä, joiden avulla käyttäjän ruudulle saadaan avattua tietyt koulutukset: tietyn yksikön koulutustarjonta, tietyn paikkakunnan tarjonta tai vaikkapa tietyn koulutusalan tarjonta.

Linkkien avulla voi myös helpottaa koulutusten keräämistä valintakoriin. Linkissä voi olla valmiina yksi tai useampia koulutuksia, jolloin ilmoittautujan ei tarvitse itse etsiä niitä listauksesta.

Linkkien teko

Linkit voi tehdä tekstieditorissa, Primuksen memokentissä tai automatisoiduilla ohjelmalla tai scriptillä. Ohjeen lopussa on esimerkkejä linkeistä.

Primuksessa

Wilman kirjautumissivulle haluttavat linkit tehdään Primuksessa. Koulun tiedot -rekisterin Kirjautumissivun sisältö suomeksi -kenttään täytetään etusivulle haluttu teksti sekä koulutuskalenterin linkit. Lisäksi voi täyttää kentän Kirjautumissivun otsikko suomeksi sekä vastaavat kentät ruotsiksi ja/tai englanniksi.

Tiedot täytetään oletuskoulun kortille. Oletuskoulu on yleensä se rekisterikortti, jonka numero on 1.

JSON selkokielisessä muodossa

Jos JSONin haluaa selkokielisessä muodossa, jossa on rivivaihdot ja sisennykset, niin täytyy linkkiin lisätä parametri ReadableJson ilman arvoa.

Koulutuskalenterin linkeissä voi käyttää UTF-8- tai Windows-1252-enkoodausta . Esim. parametrin arvo 'ä' voi olla %C3%A4 tai %E4. Lähinnä tarvitaan search-phrase-parametrissä, jolla tehdään valmis suodatus.

Rivien tiedot

• tarvittavat parametrit
• [[Primukseen kirjattava linkki]]
• HTML-linkki, ulkopuolisilta sivuilta Wilmaan johtava linkki. Poista linkin aloitustagista ylimääräinen välilyönti merkkien < ja a välistä. Sen tehtävä on ainostaan estää koodia muuttumasta linkiksi tässä ohjeessa.
• lisätietoja

Linkki toiminnon pääsivulle

• (ei parametrejä)
• [[Sähköinen ilmoittautuminen | http://wilma.kunta.fi/browsecourses]]
• < a href="http://wilma.kunta.fi/browsecourses">Sähköinen ilmoittautuminen
• Ohjaus toiminnon pääsivulle, koulutuslistaukset avattava itse, ei suodatusta, ei valmiina valintoja korissa.

Tietyn oppilaitoksen koulutukset

• school-id=xxx
• xxx = koulun rekisterikortin numero
• [[Sähköinen ilmoittautuminen, Tekniikka ja Liikenne|http://wilma.kunta.fi/browsecourses?school-id=4]]
• < a href="http://wilma.kunta.fi/browsecourses?school-id=4">Sähköinen ilmoittautuminen, Tekniikka ja Liikenne
• Avoinna tietyn oppilaitoksen koulutukset. Ei voi hakea eri oppilaitoksiin samalla kerralla. School-id on koulun rekisterikorttinumero Primuksen Koulun tiedot -rekisterissä. Jos numeroa vastaavaa koulua ei ole, ei näytetä mitään.

Hakusanasuodatus

• search-phrase=xxx
• xxx = sanahaku esillä olevista tiedoista, esim. joensuu tai musiikki; musiikki vastaa Primuksen hakua *musiikki*
• [[Ilmoittautuminen Kuopion ja Joensuun koulutuksiin. | http://wilma.kunta.fi/browsecourses?search-phrase=joensuu,kuopio]]
• < a href="http://wilma.kunta.fi/browsecourses?search-phrase=joensuu%2Celintarvike">Ilmoittautuminen Kuopion ja Joensuun koulutuksiin
• Avaa koulutustarjonnan otsikon ja rajaa esille hakuun sopivat koulutukset. Näyttää rivit, joissa esiinty "joensuu" TAI "kuopio". Isoilla ja pienillä kirjaimilla ei ole eroa, yhtenäisyyden vuoksi suosittelemme pieniä. Wilman versioon 2.21 asti skandinaaviset merkit oli muutettava Windows-1252 -mukaisiksi: Å=C5, Ä=C4, Ö=D6. Wilma 2.21 ja sitä uudemmat versiot tekevät tarvittavat muunnokset Wilmassa automaattisesti.

Lyhytkestoiset koulutukset koriin valmiiksi

• short-term=xxx
• xxx = arviointikirjan rekisterikortin numero
• [[Ensiapu I ja II | http://wilma.kunta.fi/browsecourses?short-term=12345,12346]]
• < a href="http://wilma.kunta.fi/browsecourses?short-term=12345%2C12346">Ensiapu I ja II
• Linkinmukaiset koulutukset on valittu valmiiksi, hakija/ilmoittautuja voi edetä suoraan sähköpostivarmennukseen tai hyväksymään käyttöehtoja.

Pitkäkestoiset koulutukset koriin valmiiksi

• long-term=xxx
• xxx = luokan rekisterikortin numero
• [[Leipurin ja kondiittorin ammattitutkinnot | http://wilma.kunta.fi/browsecourses?long-term=123,124]]
• < a href="http://wilma.kunta.fi/browsecourses?long-term=123%2C124">Leipurin ja kondiittorin ammattitutkinnot
• Linkinmukaiset koulutukset on valittu valmiiksi, hakija/ilmoittautuja voi edetä suoraan sähköpostivarmennukseen tai hyväksymään käyttöehtoja.

Koulutuksen lisätiedot heti auki

• openinfo=xxx
• lyhytkestoisilla: xxx = S1234
• pitkäkestoisilla: xxx = L1234
• [[Leipurin ammattitutkinto | http://wilma.kunta.fi/browsecourses?school-id=4&openinfo=L1234]]
• < a href="http://wilma.kunta.fi/browsecourses?school-id=4&openinfo=L1234">Leipurin ammattitutkinto
• Avaa koulutuksen lisätiedot ruudulle pop-up-ikkunaan. Vain yhden koulutuksen lisätiedot voivat olla auki kerralla. S = short = lyhykestoinen, L = long = pitkäkestoinen; numerot ovat rekisterikortin numeroita, S=arviointirekisterin, L=luokkarekisterin. School-id ei ole pakollinen parametri.

Koulutuksen lisätiedot heti auki ja koulutus koriin valmiiksi

• pitkäkestoiset koulutukset: long-term=xxx&openinfo=true
• lyhytkestoiset koulutukset: short-term=xxx&openinfo=true
• lyhyt- ja pitkäkestoisilla: xxx = 1234
• [[Leipurin ammattitutkinto | http://wilma.kunta.fi/browsecourses?school-id=4&long-term=1234&openinfo=true]]
• < a href="http://wilma.kunta.fi/browsecourses?school-id=4&long-term=1234&openinfo=true">Leipurin ammattitutkinto
• Avaa koulutuksen lisätiedot ruudulle pop-up-ikkunaan ja lisää koulutuksen koriin. Vain yhden koulutuksen lisätiedot voivat olla auki kerralla. Numerot ovat rekisterikortin numeroita, short-term = arviointirekisterin, long-term = luokkarekisterin. School-id ei ole pakollinen parametri.

Suoraan varmennukseen

• checkout=true
• [[Suoraan sähköpostivarmennukseen | http://wilma.kunta.fi/browsecourses?school-id=4&short-term=12345,12346&checkout=true]]
• < a href="http://wilma.kunta.fi/browsecourses?school-id=4&short-term=12345%2C12346&checkout=true">Suoraan sähköpostivarmennukseen
• Korissa 2 lyhytkestoista koulutusta, siirrytään suoraan varmennusvaiheeseen käymättä koulutusten valintasivulla. Vaatii ainakin kolme tietoa, esim. oppilaitos, koulutus ja checkout. School-id tulee olla aina mukana. Numerot ovat arviointirekisterin korttinumeroita.

Suoraan varmennukseen, yritykset

• user-type=corporation
• [Yritykset | http://wilma.kunta.fi/browsecourses?school-id=4&short-term=12345,12346&checkout=true&user-type=corporation]]
• < a href="http://wilma.kunta.fi/browsecourses?school-id=4&long-term=12345%2C12346&user-type=corporation&checkout=true">Yritykset.
• Korissa 2 lyhytkestoista koulutusta, siirrytään suoraan varmennusvaiheeseen käymättä koulutusten valintasivulla. School-id tulee olla mukana. Numerot ovat Arviointi-rekisterin korttinumeroita. School-id tulee olla mukana. Käyttäjän katsotaan olevan yrityksen/organisaation ilmoittaja, vain jos user-type=corporation, muuten aina yksityinen hakija/ilmoittautuja.

Erikoismerkkien ja termien selitykset

• S = short = lyhykestoinen koulutus
• L = long = pitkäkestoinen koulutus
• Parametreillä kerrotaan, mitä haetaan. Parametri on hakuun liittyvä määrite, jolle annetaan jokin arvo, esim. parametri = "koulu" ja arvona "korttinumero 4" eli school-id=4
• Parametrien keskinäisellä järjestyksellä ei ole merkitystä, mutta hyvä käytäntö on järjestää ne aina samalla tavalla, esim. oppilaitos, koulutus, muut.
• ? tarkoittaa parametriosion alkua, ja se lisätään siis aina browsecourses-sanan perään.
• & käytetään parametrien erotteluun. Seuraavassa on 2 parametriä &-merkillä erotettuna: school-id=4&checkout=true
• # on tunniste, "ankkuri", joka siirtää käyttäjän sivulla haluttuun kohtaan, ts. "vie hissin paikoilleen".
• Standardissa pilkku ja muut erikoismerkit on varattu muihin tarkoituksiin, joten ulkopuolisten linkkien tekstissä ne tulee korvata erikseen määritellyllä koodilla. Esim. pilkku korvataan koodilla %2C. Pilkkuja ym. erikoismerkkejä voi olla vaikkapa oppilaitosten ja koulutusten nimissä. Primukseen kirjautuissa linkeissä voi käyttää pilkkua tai koodia.

Käyttöönoton virhetilanteet

Parametreihin voi lisätä: showerrors=true

Tämä näyttää selainruudulla käyttöönoton puutteet, esim. lomaketoiminto ei ole käytössä jollain koululla tai Primuksen tietokannasta puuttuu jokin kenttä (=vanha versio).