Alla olevaan taulukkoon on koottu lisätietoa rajapinnan tietosisältöön liittyen. Lisäksi kyselyiden sisältöön kannattaa tutustua yhdessä oman organisaation Arvo-vastuukäyttäjän kanssa.
Myös seuraavat linkit saattavat antaa vastauksia kysymyksiin tietosisältöön liittyen:
- Keskeisiä käsitteitä
- Eri kyselyiden sisältö (mm. kysymykset, rakenne ja muutokset)
Tarkennuksia ArvoAPI v. 1.0 -rajapintojen tietosisältöön:
| Rajapinta | Käytössä kyselytyypeillä (tiedonkeruissa) | Käyttötarkoitus | Siirtyvä tieto | Sivutus | Parametrit | Tarkennuksia |
|---|---|---|---|---|---|---|
| kyselykerrat | AVOP | Kyselykerrat ovat kansioita vastauksille. Kyselykerrat rajapinta tarjoaa kyselyiden ja niihin liittyvien kansioiden (kyselykertojen) voimassaolo- ja tilatietoa sekä tiedon käytetystä kyselypohjasta (kansallisesta kysymyspatteristosta). | kyselykerran tiedot:
kyselyn tiedot:
käytetyn kyselypohjan tiedot:
| ei | ei | tyyppi *) itsearviointi = digikyvykkyyden itsearviointi kyselypohja_tarkenne **) poistuneet tiedonkeruusta 1.1.2021 alkaen kysely_tila voimassaolo tarkoittaa alkamispäivää ja päättymispäivää kyselypohjan tiedoissa nimi siirretään vain suomeksi |
| kysely_kysymysryhmä | AVOP | Rajapinta tarjoaa kyselyiden ja kysymysryhmien suhteet eli mitkä kysymysryhmät kyselyyn sisältyy ja mikä on niiden järjestys kyselyssä. Raportoinnin kannalta oleellisin data on järjestys, jos tämä ei ole koulutuksen järjestäjän raportoinnissa mukana, tätä rajapintaa ei ole tarpeen kutsua. | kyselyn tiedot:
kysymysryhmän tiedot:
| ei | kyselyid | Kyselyiden sisältöön kannattaa tutustua yhdessä oman organisaation Arvo-vastuukäyttäjän kanssa. Kaikkien kyselyiden sisällöstä löytyy tietoa myös wikistä. Huomioithan muutokset eri tiedonkeruuvuosien välillä! Järjestys antaa järjestysnumeron. |
| kysymykset | Korkeakoulut: | Kysymykset rajapinnan kautta saa kyselyissä käytetyt kysymysryhmät (kyselyn otsikkotaso) ja kysymykset kieliversioineen sekä kysymysten järjestys ja keskinäiset suhteet (jatkokysymykset). Saatavilla myös tieto rahoitusmalliin sisältyvistä kysymyksistä. | kysymysryhmän tiedot:
kysymyksen tiedot (esim):
| ei | kyselyid | kysymysryhmä tarkoittaa kysymysryhmän nimeä suomi, ruotsi, englanti kysymys tarkoittaa kysymystekstiä suomeksi, ruotsiksi ja englanniksi järjestys kysymysryhmän sisällä vastaustyyppi ***) ja_eos -tyyppiset asteikot ovat vaikeimmin tulkittavia ja siksi poistumassa. Vastaukset saavat arvoja kuten: :arvosana4-ja-eos taustakysymyksen tyyppi string-muotoinen kenttä, jonka avulla on helppo poimia kyselylomakkeella olleita kysymyksiä taustatiedoiksi raportoinnissa. Voi saada esim. arvoja: 'sukupuoli', 'ika', 'aidinkieli', 'tietojen luovutus', 'tietojen yhdistäminen', 'teema' HUOM! AVOP, KANDIPALAUTE Huomioithan vastaajan antaman suostumuksen luovuttaessasi aineistoa tutkimuskäyttöön! Taustakysymyksiin annetut vastaukset löydät taustakysymyksen tyypin perusteella: 'tietojen_luovutus', 'tietojen_yhdistaminen' jatkokysymys koostuu kahdesta tiedosta: jatkokysymys (kyllä/ei) ja jatkokysymys_kysymysid kategoria valtakunnallinen rahoitusmallikysymys teema koodisto |
| monivalintavaihtoehdot | AVOP | Rajapinta tarjoaa vastausvaihtoehdot monivalinta-tyyppisiin kysymyksiin. Yhdessä edellisten rajapintojen kanssa, monivalintavaihtoehtoja on mahdollista hyödyntää jo ennen tiedonkeruun alkua ja luoda raporttipohja valmiiksi vastausaineistoa varten. | kysymyksen tiedot:
| ei | kyselyid | |
| vastaukset | AVOP | Vastaukset rajapinnan kautta saa kysymyksiin annetut vastaukset ja niihin liittyvä vastaaja- ja vastaajatunnustieto. |
| kyllä | alkupvm | vastausaika ilmoittaa päivämäärän koulutustoimija monivalintavastausvaihtoehto |
| vastaajat | AVOP TYÖELÄMÄPALAUTE DIGIKYVYKKYYS MOVE! *) vain AMK | Rajapinnan kautta saa vastaajat ja niihin liittyvien vastaajatunnusten tarkemmat tiedot. | kyselykerran tiedot:
vastaajatunnuksen tiedot:
| kyllä | since | vastaajatunnusid yksilöi vastaustapahtuman vastaajatunnus vastaaja-id tunnuksen voimassaolo ilmoittaa alkamispäivämäärän ja päättymispäivämäärän taustatiedot Taustatiedot vaihtelevat kyselytyypin mukaan. nayta_vastaamattomat -parametria voi hyödyntää kaikkien luotujen tunnusten hakuun. Tietoja voi käyttää kohdejoukon koon tarkasteluun tai esim. katoanalyyseihin. |
| opiskeluoikeudet | AVOP KANDIPALAUTE | Rajapinnan kautta on mahdollista hakea vastaajatunnuksen ja Virran opiskeluoikeuden suhteet. | vastaajatunnuksen tiedot:
vastaajan tiedot:
| ei | Vain HAKA-kirjautumisen ja kyselyynohjauksen kautta vastanneista tallentuu opiskeluoikeustieto. HUOM! Opiskeluoikeustiedon hyödyntämistä varten kannattaa tutustua korkeakoulujen toimittamiin ohjeisiin henkilötiedonkäsittelystä (AMK ohjeet, YO ohjeet) sekä tarkistaa mitä oma korkeakoulu (tietosuojailmoitus ja tarkentavat tiedot: AVOP, Kandipalaute) on kertonut vastaajalle tietojen yhdistämisestä rekisteritietoihin. Huomioithan myös vastaajan antaman suostumuksen luovuttaessasi aineistoa tutkimuskäyttöön! (kts. kysymykset-rajapinta) | |
| luodut_tunnukset | AMISPALAUTE | Rajapinta tarjoaa koosteen kuukausittain luoduista tunnuksista kyselykertaa kohden. Samat tiedot saa kohteet-rajapinnasta ja nämä tiedot voi ryhmitellä koulutuksen järjestäjälle parhaalla tavalla. | kyselykerran tiedot:
| ei | kyselyid | kuukausi sisältää vuosiluvun ja kuukauden (yyyymm) tunnusten määrä ilmoittaa lukumäärän vastauskertojen määrä ilmoittaa kaikkien tunnusten vastauskertojen lukumäärän |
| kohteet | AVOP TYÖELÄMÄPALAUTE DIGIKYVYKKYYS MOVE! *) vain AMK | Rajapinnan kautta saa vastaajatunnukset ja niihin liittyvät tarkemmat tiedot. | kyselykerran tiedot:
vastaajatunnuksen tiedot:
| kyllä | since | vastaajatunnus taustatiedot Taustatiedot vaihtelevat kyselytyypin mukaan. nayta_vastaamattomat -parametria voi hyödyntää kaikkien luotujen tunnusten hakuun. Tietoja voi käyttää kohdejoukon koon tarkasteluun tai esim. katoanalyyseihin. Kohteet-rajapinnassa kyselyid on pakollinen parametri. |