Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Käytössä kyselytyypeillä

...

Tarkennuksia ArvoAPI v. 1.0 -

...

rajapintojen tietosisältöön:

RajapintaKäytössä
kyselytyypeillä (tiedonkeruissa)
KäyttötarkoitusSiirtyvä tietoSivutusParametritTarkennuksia
kyselykerrat

Status
titleAVOP

Status
titleKandipalaute

Status
titleRekrykysely

Status
titleUraseuranta

Status
colourBlue
titleAmispalaute

Status
colourBlue
titleTyöelämäpalaute

Status
colourGreen
titleDigikyvykkyys

Status
colourGreen
titleMove!

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:

  • kyselykertaid
  • nimi
  • kyselyvuosi

kyselyn tiedot:

  • kyselyid
  • nimi
  • tyyppi
  • tila
  • voimassaolo

käytetyn kyselypohjan tiedot:

  • kyselypohjaid
  • tarkenne
  • nimi
eiei

tyyppi
string-muotoinen kenttä, joka kertoo mistä tiedonkeruusta on kyse. Voi saada arvoja:
'avop', 'kandipalaute', 'rekrykysely', 'amk-uraseuranta', 'yo-uraseuranta', 'amispalaute', 'tyoelamapalaute', 'tyopaikkakysely'  'itsearviointi'*, 'move'

*) itsearviointi = digikyvykkyyden itsearviointi

kyselypohja_tarkenne
string-muotoinen kenttä, joka voi saada arvoja:

Status
titleKandipalaute
:
ekonomit, laakarit, tek **
Status
titleAVOP
:
amk, yamk
Status
colourBlue
titleAmispalaute
:
aloittaneet, tutkinnon_osia_suorittaneet, tutkinnon_suorittaneet

**) poistuneet tiedonkeruusta 1.1.2021 alkaen

kysely_tila
string-muotoinen kenttä, joka voi saada arvoja:
'julkaistu', 'suljettu', 'luonnos'

voimassaolo tarkoittaa alkamispäivää ja päättymispäivää

kyselypohjan tiedoissa nimi siirretään vain suomeksi

kysely_kysymysryhmä

Status
titleAVOP

Status
titleKandipalaute

Status
titleUraseuranta

Status
colourBlue
titleAmispalaute

Status
colourBlue
titleTyöelämäpalaute

Status
colourGreen
titleDigikyvykkyys

Status
colourGreen
titleMove!

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:

  • kyselyid

kysymysryhmän tiedot:

  • kysymysryhmäid
  • järjestys
eikyselyid

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:

Status
titleAVOP

Status
titleKandipalaute

Status
titleUraseuranta


Ammatillisen
koulutuksen
järjestäjät:
Status
colourBlue
titleAmispalaute

Status
colourBlue
titleTyöelämäpalaute


Muu raportointi:
Status
colourGreen
titleDigikyvykkyys

Status
colourGreen
titleMove!

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:

  • kysymysryhmä
  • kysymysryhmäid

kysymyksen tiedot (esim):

  • kysymys
  • järjestys kysymysryhmässä
  • taustakysymyksen tyyppi
  • jatkokysymys
  • valtakunnallinen
  • rahoitusmalli
  • koodisto
  • vastaustyyppi
eikyselyid

kysymysryhmä tarkoittaa kysymysryhmän nimeä suomi, ruotsi, englanti

kysymys tarkoittaa kysymystekstiä suomeksi, ruotsiksi ja englanniksi

järjestys kysymysryhmän sisällä

vastaustyyppi
string-muotoinen kenttä, joka kertoo missä muodossa vastauksia on ollut mahdollista antaa. Voi saada arvoja:
'arvosana4_ja_eos'***, 'arvosana7', 'nps', 'arvosana6', 'arvosana6_ja_eos'***, 'arvosana', 'likert_asteikko', 'monivalinta', 'kylla_ei_valinta', 'asteikko5_1', 'valiotsikko', 'luku', 'alasvetovalikko', 'vapaateksti'

***) ja_eos -tyyppiset asteikot ovat vaikeimmin tulkittavia ja siksi poistumassa. Vastaukset saavat arvoja arvoja kuten: 

:arvosana4-ja-eos
{1 "En pysty arvioimaan"
2 "2"
3 "3"
4 "4"
5 "5"}

:arvosana6-ja-eos
{0 "0"
1 "1"
2 "2"
3 "3"
4 "4"
5 "5"
6 "En pysty arvioimaan"}

taustakysymyksen 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!

Status
titleAVOP
,
Status
titleKandipalaute
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
Kysymyksen metatiedot. Voi sisältää ainakin muut täällä olevat kentät.

valtakunnallinen
Kysymykseen liitetty metatieto, jonka avulla tunnistaa tiedonkeruussa mukana olevat kansallisesti yhtenäiset kysymykset. Muut kysymykset ovat organisaationne omia lisäkysymyksiä.

rahoitusmallikysymys
Kysymykseen liitetty metatieto, jonka avulla löytää helposti tiedonkeuussa mukana olevat rahoitukseen vaikuttavat kysymykset. Vastausvaihtoehtojen pisteytys kannattaa tarkistaa tiedonkeruuseen liittyvästä asetuksesta.

teema
Kysymykseen liitetty metatieto, jonka avulla voi hyödyntää tiedonkeuussa mukana olevia teemoja. Teemat käytössä tiedonkeruussa:

Status
titleKandipalaute

koodisto
Koodiston nimi josta vastausten selitteet löytyvät. Tällä hetkellä tuetaan vain opintopolusta löytyviä numeroarvollisia koodistoja.

monivalintavaihtoehdot

Status
titleAVOP

Status
titleKandipalaute

Status
titleUraseuranta

Status
colourBlue
titleAmispalaute

Status
colourBlue
titleTyöelämäpalaute

Status
colourGreen
titleDigikyvykkyys

Status
colourGreen
titleMove!

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:

  • kysymysid
  • järjestys
  • kieliversiot
eikyselyid
vastaukset

Status
titleAVOP

Status
titleKandipalaute

Status
titleUraseuranta
*
Status
colourBlue
titleAmispalaute

Status
colourBlue
titleTyöelämäpalaute

Status
colourGreen
titleDigikyvykkyys

Status
colourGreen
titleMove!

*) vain AMK

Vastaukset rajapinnan kautta saa kysymyksiin annetut vastaukset ja niihin liittyvä vastaaja- ja vastaajatunnustieto.

  • vastausid
  • kyselykertaid
  • kyselyid
  • kysymysid
  • vastaajatunnusid
  • vastausaika
  • numerovalinta
  • vapaateksti
  • vaihtoehto
  • koulutustoimija
  • monivalintavaihtoehto
kyllä

alkupvm
loppupvm
since
limit
kyselyid

vastausaika ilmoittaa päivämäärän

koulutustoimija
Ilmoitetaan y-tunnuksella.

monivalintavastausvaihtoehto
Saa arvoikseen monivalinta-vaihtoehdoista ne, joihin on annettu vastauksia. HUOM! Kaikki vaihtoehdot saa ladattua rajapinnasta: monivalintavaihtoehdot.


vastaajat

Status
titleAVOP

Status
titleKandipalaute

Status
titleUraseuranta
*

Status
colourBlue
titleAmispalaute

Status
colourBlue
titleTyöelämäpalaute

Status
colourGreen
titleDigikyvykkyys

Status
colourGreen
titleMove!

*) vain AMK

Rajapinnan kautta saa vastaajat ja niihin liittyvien vastaajatunnusten tarkemmat tiedot.

kyselykerran tiedot:

  • kyselykertaid

vastaajatunnuksen tiedot:

  • vastaajatunnusid
  • vastaajatunnus
  • vastaaja-id
  • tunnuksen voimassaolo
  • oppilaitos
  • taustatiedot
kyllä

since
limit
kyselyid
nayta_vastaamattomat
voimassa_alkupvm

vastaajatunnusid yksilöi vastaustapahtuman

vastaajatunnus
string-muotoinen kenttä, jonka merkkimäärä voi vaihdella 5-7 merkin välillä riippuen tiedonkeruusta. Vastaajatunnus sisältää 1 tai useamman vastausmahdollisuuden eli vastaajatunnus voi toistua aineistossa.

vastaaja-id
integer-muotoinen kenttä, joka yksilöi vastaajan.

tunnuksen voimassaolo ilmoittaa alkamispäivämäärän ja päättymispäivämäärän

taustatiedot
Vastaajat-rajapinnan kautta haettavat taustatiedot ovat vastaajatunnuksen luomisvaiheessa tunnukselle asetettuja taustatietoja. Joko virkailija syöttää ne tunnusta luodessaan käyttöliittymän kautta tai ne haetaan tietovarastosta järjestelmän kautta luotaville tunnuksille. Eivät sisällä vastaajan antamia taustatietoja.

Taustatiedot vaihtelevat kyselytyypin mukaan.

nayta_vastaamattomat -parametria voi hyödyntää kaikkien luotujen tunnusten hakuun. Tietoja voi käyttää kohdejoukon koon tarkasteluun tai esim. katoanalyyseihin.
HUOM! Kaikissa kyselyissä koko kohdejoukolle ei ole olemassa tunnuksia.

opiskeluoikeudet

Status
titleAVOP

Status
titleKandipalaute

Rajapinnan kautta on mahdollista hakea vastaajatunnuksen ja Virran opiskeluoikeuden suhteet.

vastaajatunnuksen tiedot:

  • vastaajatunnus

vastaajan tiedot:

  • opiskeluoikeus
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

Status
colourBlue
titleAmispalaute

Status
colourBlue
titleTyöelämäpalaute

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:

  • kyselykertaid

  • oppilaitoskoodi

  • tutkintotunnus

  • kuukausi

  • tunnusten määrä

  • vastauskertojen määrä

eikyselyid

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

Status
titleAVOP

Status
titleKandipalaute

Status
titleUraseuranta
*

Status
colourBlue
titleAmispalaute

Status
colourBlue
titleTyöelämäpalaute

Status
colourGreen
titleDigikyvykkyys

Status
colourGreen
titleMove!

*) vain AMK
Rajapinnan kautta saa vastaajatunnukset ja niihin liittyvät tarkemmat tiedot.

kyselykerran tiedot:

  • kyselykertaid

vastaajatunnuksen tiedot:

  • vastaajatunnusid
  • vastaajatunnus
  • vastaaja-id
  • tunnuksen voimassaolo
  • oppilaitos
  • taustatiedot


kyllä

since
limit
kyselyid (pakollinen)
nayta_vastaamattomat
voimassa_alkupvm

vastaajatunnus
string-muotoinen kenttä, jonka merkkimäärä voi vaihdella 5-7 merkin välillä riippuen tiedonkeruusta. Vastaajatunnus sisältää 1 tai useamman vastausmahdollisuuden eli vastaajatunnus voi toistua aineistossa.

taustatiedot
Vastaajat-rajapinnan kautta haettavat taustatiedot ovat vastaajatunnuksen luomisvaiheessa tunnukselle asetettuja taustatietoja. Joko virkailija syöttää ne tunnusta luodessaan käyttöliittymän kautta tai ne haetaan tietovarastosta järjestelmän kautta luotaville tunnuksille. Eivät sisällä vastaajan antamia taustatietoja.

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.
HUOM! Kaikissa kyselyissä koko kohdejoukolle ei ole olemassa tunnuksia.

...