Opintopolku/SOTELI-integraation rajapintamääritykset http://soteli.metropolia.fi/ "Keväällä 2016 ammattikorkeakoulujen sosiaali-, terveys- ja liikunta-alalla käytetään esivalintakoetta, jonka perusteella osa hakijoista kutsutaan varsinaiseen valintakokeeseen." Esivalintakokeen tunniste on "sotelikoe2016k". Opintopolun palveluita integroidaan valintakokeeseen: 1. 2. Valintalaskentakoostepalvelu tarjoaa rajapinnan joka palauttaa listan henkilöistä jotka ovat hakeneet SOTELI-hakukohteisiin ja ovat ensimmäisessä valinnan vaiheessa (eli hakija on täyttänyt hakemuksen ja jälkikäsittely hakemukselle on tehty) Valintalaskentakoostepalvelu tarjoaa rajapinnan koepisteiden tallentamiseen hakemukselle Taskit 1. Käyttäjän ja organisaation luominen 1. Tehdään uusi käyttöoikeusryhmä("rooli") johon käyttöoikeudet (hakemuspalvelu+read ja valinta+crud). a. Asetetaan myöntörajoitteeksi korkeakoulut (eli, oikeuden voi myöntää vain yliopisto tai AMK -tyyppiseen oppilaitokseen) b. Nimetään käyttöoikeusryhmä esim. soteli-rooliksi 2. Luodaan uusi palvelukäyttäjä "soteliintegraatio" (OPH, henkilöpalvelu) 3. Luodaan uusi organisaatioryhmä: "soteli" (OPH, organisaationpalvelu) 4. Lisätään palvelukäyttäjälle soteli-organisaatioryhmä ja käyttöoikeusryhmä (soteli-rooli) (OPH, henkilöpalvelu) 5. Linkitetään Soteliin kuuluvat hakukohteet soteli-organisaatioryhmään. (AMK:t, tarjonta) (Vastaavasti yliopistojen yhteisvalinnassa) 2. Hakijoiden tietojen hakeminen Toteutetaan uusi rajapinta CAS-autentikaatio kuten muissakin opintopolun palveluissa. Rajapintaan on tulossa lähitulevaisuudessa pakollisia headereita (esim. tietoturvaan liittyviä). Näihin kannattaa varautua. Rajapinta palauttaa hakemuksia, joiden sisältä voidaan poimia hakijan ja hakukohteen tiedot hakijoista rajataan ne joilla on hakukohderyhmään kuuluva hakutoive ja joihin käyttäjällä on katseluoikeus. (Tässä tapauksessa
kaikki hakemukset joissa hakukohde joka kuuluu SOTELI-organisaatioryhmään) GET https://virkailija.opintopolku.fi/valintalaskentakoostepalvelu/resources/hakemukset/valinnanvaihe?hakuoid=123.123.123&valinnan vaiheoid=456 hakuoid=haun uniikki tunniste valinnanvaiheoid=valinnan vaiheen tunniste, SOTELI:n tapauksessa valinnan vaihe on aina sama. Tarvittava valinnan vaiheen oid löytyy siitä valintaryhmästä jolle kyseinen vaihe luotu (ja sitä kautta periytynyt alivalintaryhmille ja hakukohteille) Vastaus HTTP 200. (500 sisäisissä virhetilanteissa, 403 jos käyttäjällä ei oikeuksia ja jos käyttäjä ei ole kirjautunut ei tule 401 vaan 302 redirect CAS-kirjautumiseen). Response body [ "hakemusoid":"12316.7.7.74", "henkilooid":"123.124.55.1", "etunimet":"teppo Daniel", "sukunimi":"testaaja", "kutsumanimi":"teppo", "sahkoposti":"hakija@abc.fi", "katuosoite":"mannerheimintie 1", "postinumero":"00100", "postitoimipaikka":"helsinki", "hakukohteet": [ "hakukohdeoid":"12.44.58.8", "tunniste":"1123", "tunniste":"2412", "hakukohdeoid":"12.92.44.8908", "tunniste":"1123", "tunniste":"2412", "hakemusoid":"12316.7.7.999", "henkilooid":"1243.984.595.19", "etunimet":"esko", "sukunimi":"esimerkki", "kutsumanimi":"esko", "sahkoposti":"foo@bar.com",
"katuosoite":"eerikinkatu 2", "postinumero":"00180", "postitoimipaikka":"helsinki", "hakukohteet": [ "hakukohdeoid":"161.44.58.8513", "tunniste":"1123", "tunniste":"2412"
hakemusoid=hakemuksen id henkilooid=oppijan id sahkoposti=oppijan hakemukselle täyttämä sähköpostiosoite. Yhteishaussa pakollinen kenttä. Kentän muoto on perusvalidoitu. katuosoite,postiosoite,postinumero=oppijan hakemukselle täyttämä postiosoite. Yhteishaussa pakollinen kenttä. hakukohteet=lista (SOTELI) hakukohteita ja niihin liittyvä valintakoetunnisteet. (SOTELI:n tapauksessa koetunnisteita on vain yksi). Valintakoetunnisteet syntyvät mallinnettaessa koetta. 3. Koepisteiden tallennus Toteutetaan uusi rajapinta. CAS-autentikaatio kuten muissakin opintopolun palveluissa. Rajapintaan on tulossa lähitulevaisuudessa pakollisia headereita (esim. tietoturvaan liittyviä). Näihin kannattaa varautua. Rajapinta tarkistaa palvelukäyttäjän organisaatioryhmän ja siihen kuuluvien hakukohteiden pohjalta voiko hakemukseen tallentaa koepistetuloksia. POST https://virkailija.opintopolku.fi/valintalaskentakoostepalvelu/resources/pistesyotto/ulkoinen? hakuoid =1234.123.455&valinnanvaih eoid=456 hakuoid=haun uniikki tunniste.
Request body [ "hakemusoid":"12316.7.7.74", "henkilooid":"1.2.4124.41214", "tunniste":"1234", "osallistuminen":"osallistui", "pisteet":"5.18", "tunniste":"1235", "osallistuminen": "EI_OSALLISTUNUT", "hakemusoid":"12316.7.7.998", "henkilooid":"1.2.4124.83219", "tunniste":"1234", "osallistuminen":"osallistui", "pisteet":"8.34", "hakemusoid":"12316.7.7.999", "henkilooid":"1.2.4124.83220", "tunniste":"1234", "osallistuminen":"osallistui", "pisteet":"8.34" hakemusoid = Hakemuksen oid henkilooid = Henkilön oid valintakokeet = Lista hakemukseen liittyviä valintakoetuloksia: Koetuloksen tunniste, osallistuiko hakija kokeeseen ja koepisteet. Jos hakija ei ole osallistunut niin pisteitä ei saa lähettää. Tunniste syntyy mallinnettaessa koetta. (SOTELI:n tapauksessa valintakokeita on vain 1/hakemus) osallistuminen = Enumeraatio: OSALLISTUI, EI_OSALLISTUNUT (muut valintapalvelun tukemat arvot eivät ole sallittuja tässä rajapinnassa) pisteet = formaatti määräytyy sen mukaan miten valintaperusteissa on mallinnettu. Vastaus HTTP 200 (500 sisäisissä virhetilanteissa, 403 jos käyttäjällä ei oikeuksia ja jos käyttäjä ei ole kirjautunut ei tule 401 vaan 302 redirect CAS-kirjautumiseen)
Response body "kasiteltyok":56, "virheet": [ "hakemusoid":"12316.7.7.998", "virhe":"hakemus on passivoitu", "hakemusoid":"12316.7.7.333", "virhe":"pisteitä ei voi tallentaa koska hakijaa ei ole kutsuttu kokeeseen"