Tälle sivulle kootaan kysymyksiä ja vastauksia Arvon rajapintoihin liittyen. Voit lähettää oman kysymyksesi Arvon palveluosoitteeseen arvo@csc.fi.

Arvo-API v. 2.0 -käyttöön liittyviä kysymyksiin ja vastauksiin voit tutustua sivulla Arvon rajapintojen käyttöönotto ammatillisilla koulutuksen järjestäjillä

Arvo-API v. 1.0 käyttöönotto ja käyttö

Yhdessäkään Arvolla toteutetussa kyselyssä ei ole käytössä välitallennusmahdollisuutta. Kun vastaaja lähettää vastauksensa, vastaukset tallentuvat eikä kyselyyn ole enää mahdollista palata. Vastaaja ei siis voi muuttaa vastauksiaan myöhemmin.

Korkeakoulujen tiedonkeruissa vastausdata on lähtökohtaisesti muuttumatonta.

Kysymysten ei pitäisi enää muuttua sen jälkeen, kun kysely on julkaistu ja siihen on tullut vastauksia. Joskus meille tulee kuitenkin jälkikäteen pyyntöjä korjata jotain sanamuotoa tai mahdollisesti jopa poistaa jokin koulutustoimijan oma kysymys. Nämä ovat kuitenkin yksittäisiä poikkeustapauksia.

Valtakunnallisiin kysymyksiin ei pitäisi tulla muutoksia tiedonkeruun alkamisen jälkeen. Koulutustoimijat voivat lisätä omia kysymyksiään ennen tiedonkeruun alkamista.

Vastaajat ja vastaukset -rajapintojen palauttamat tulokset on järjestely vastaaja-id:n ja vastaus-id:n mukaan, joten since-parametria voi käyttää tutkimaan, löytyykö uusia vastauksia.

Luodut tunnukset yhdistetään kyselykerran, oppilaitoskoodin, tutkinnon ja vastaajatunnuksen voimassaolon kuukauden perusteella.

Kysely_kysymysryhma-rajapinnasta pitäisi löytyä aina yksi kyselykerta yhtä kyselyä kohden.

Teemat ovat saatavissa rajapinnan kautta. Teema on kysymykseen liitetty metatieto, joka on käytössä Arvon tiedonkeruissa vain Kandipalautteessa. Rajapinnan kautta on saatavissa teeman koodiarvo, ei teeman nimeä tekstimuodossa.

Teemojen koodisto löytyy osoitteesta: http://uri.suomi.fi/codelist/educ/kysymyksenteema (koodistot.suomi.fi). Koodisto on ladattavissa koodistot.suomi.fi -palvelusta esim. json-muodossa.

Tutustu ohjeistukseen sivulla Yliopistojen uraseurantojen datojen rajapintakäyttö

Arvossa on otettu käyttöön kysymyksen versiointi, mikä vaikuttaa korkeakoulujen Arvon rajapintakäyttöön. Tutustu ohjeistukseen sivulla Arvon rajapinnat kohdassa "Kysymyksen versioinnilla vaikutusta Arvo-APIn käyttöön korkeakouluissa"

Arvon virkailijakäyttöliittymästä kysymyksen version voi tarvittessa tarkistaa kyselyn muokkausnäkymästä. Kyselyn muokkausnäkymän näkeminen edellyttää Arvon vastuukäyttäjän käyttöoikeutta. 

Kysymyksen versio (alla v. 2) näkyy kysymyksen ID-numeron (alla 13620) edellä. 

Päästäksesi kyselyn muokkausnäkymään siirry uuden virkailijakäyttöliittymän Kyselyt-sivulle ja paina kyselyn nimen vieressä näkyvää nuoli-ikonia. Kyselyn sisältöä voi tarkastella muokkaustilassa myös vastausajan aikana ja sen jälkeen. 

Jatkokysymys ei versioidu automaattisesti. Jatkokysymys versioidaan erikseen, kun siihen tulee muutoksia.

Suosittelemme vastaajien hakuun kohteet-rajapintaa ja tietojen yhdistämiseen vastaajatunnusid:tä. 

  • No labels