You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 18 Next »

Korkeakoulujen tietovarannon ja tiedonkeruiden ohjausryhmä päätti kokouksessaan 3.12.2015 , että Virta-opintotietopalvelu liitetään Kansalliseen palveluväylään ja korkeakoulujen tutkintotiedot voidaan näyttää Kansalaisen palvelunäkymässä VIRTA-opintotietopalvelusta.

VIRTA-opintotietopalvelun tiedot ovat olleet hyödynnettävissä kansallisen palveluväylän kautta elokuusta 2016 alkaen. Kansalliseen palveluväylään toteutetun integraation tavoitteena on ollut avata tietovarantoa laajemmalle käyttäjäkunnalle ja tukea tietojen uudelleenkäyttöä niin julkisissa kuin yksityisissä sähköisissä palveluissa.

Tietovarannon tiedot

Korkeakoulujen valtakunnallisen tietovarannon VIRTA-opintotietopalvelu sisältää tiedot opintosuorituksista (ml. tutkinnot) ja niiden arvosanoista, tiedot opiskelijoista sekä näiden opiskeluoikeuksista, lukukausi-ilmoittautumisista ja kansainvälistä liikkuvuusjaksoista. Opintosuoritustiedot ovat saatavissa tietovarannosta sekä tutkintoon johtavasta että tutkintoon johtamattomasta koulutuksesta. Muu tietosisältö ei ole tutkintoon johtamattomien opiskeluoikeuksien osalta täysin kattava. Lisätietoa tietovarannon tiedoista löytyy täältä: Tietovarannon tiedot.

Käyttöehdot

VIRTA-opintotietopalvelun käyttö on maksutonta.  

Lupa tietovarannon tietojen käyttöön pyydetään CSC:n koordinoimana suoraan rekisterinpitäjiltä eli yksittäisiltä korkeakouluilta.

 

Yhteystiedot:

Hyödyntäminen, sisältö ja lupakäytänteet: virta@csc.fi

Tekninen ylläpito virtakapa@csc.fi.

 

Rajapinnan kuvaus

CSC kehittää ja ylläpitää VIRTA-opintotietopalvelua tietovarannon teknisen ylläpitäjän, opetus- ja kulttuuriministeriön valtuuttamana. Virta opintotietopalvelun tietosisällöstä ja rajapintojen kuvauksista löytyy yksityiskohtaisempaa tietoa palvelun kotisivulta http://www.csc.fi/virta

Opiskelijan tietoja voi hakea, joko kansallisella oppijanumerolla tai henkilötunnuksella. Haun voi rajata joko tiettyyn organisaatioon tai hakea kaikista. Rajapinnan käyttöoikeuksia voidaan rajata organiosaation ja palvelukutsun mukaan. Esimerkiksi jollekin palvelullle voidaan myöntää oikeus ainoastaan  Tutkintotietoihin  (Kutsu 6) joltakin yskittäiseltä korkekaoululta.

 

Web Service: OpiskelijanTiedotService

Target Namespace:
http://virta-x-road.csc.fi/luku

Protocol: SOAP
Default style: document
Transport protocol: SOAP over HTTP
Operations:
  1. LukukausiIlmoittautumiset
  2. Opintosuoritukset
  3. OpiskelijanKaikkiTiedot
  4. OpiskelijanTiedot
  5. Opiskeluoikeudet
  6. Tutkinnot
Kaikille kutsuille yhteiset parametrit
  • Hakuehdot - extension of type HakuEhdot
    • henkilotunnus type HenkilotunnusTyyppi - type string with restriction maxLength(200) pattern((0[1-9]|[12][0-9]|3[01])(0[1-9]|1[0-2])[0-9][0-9][+\-A]((00[2-9]|[0-8][1-9][0-9]|[1-8][0-9][0-9])[0-9ABCDEFHJKLMNPRSTUVWXY])?)
    • kansallinenOppijanumero type string
    • organisaatio type organisaatio

 

Rajapinnan kutsut ja vastaukset

Esimerkkikutsu

  1. LukukausiIlmoittautumiset
    Operation type:
    Request-response. The endpoint receives a message, and sends a correlated message.
    Input:
    LukukausiIlmoittautumisetRequest (soap:body, use = literal, part = client)
    LukukausiIlmoittautumisetRequest type LukukausiIlmoittautumiset
    Output:
    LukukausiIlmoittautumisetResponse (soap:body, use = literal, part = client)
    LukukausiIlmoittautumisetResponse type LukukausiIlmoittautumisetResponse
  2. Opintosuoritukset
    Operation type:
    Request-response. The endpoint receives a message, and sends a correlated message.
    Input:
    OpintosuorituksetRequest (soap:body, use = literal, part = client)
    OpintosuorituksetRequest type Opintosuoritukset
    Output:
    OpintosuorituksetResponse (soap:body, use = literal, part = client)
    OpintosuorituksetResponse type OpintosuorituksetResponse
  3. OpiskelijanKaikkiTiedot
    Operation type:
    Request-response. The endpoint receives a message, and sends a correlated message.
    Input:
    OpiskelijanKaikkiTiedotRequest (soap:body, use = literal, part = client)
    OpiskelijanKaikkiTiedotRequest type OpiskelijanKaikkiTiedot
    Output:
    OpiskelijanKaikkiTiedotResponse (soap:body, use = literal, part = client)
    OpiskelijanKaikkiTiedotResponse type OpiskelijanKaikkiTiedotResponse
  4. OpiskelijanTiedot
    Operation type:
    Request-response. The endpoint receives a message, and sends a correlated message.
    Input:
    OpiskelijanTiedotRequest (soap:body, use = literal, part = client)
    OpiskelijanTiedotRequest type OpiskelijanTiedot
    Output:
    OpiskelijanTiedotResponse (soap:body, use = literal, part = client)
    OpiskelijanTiedotResponse type OpiskelijanTiedotResponse
  5. Opiskeluoikeudet
    Operation type:
    Request-response. The endpoint receives a message, and sends a correlated message.
    Input:
    OpiskeluoikeudetRequest (soap:body, use = literal, part = client)
    OpiskeluoikeudetRequest type Opiskeluoikeudet
    Output:
    OpiskeluoikeudetResponse (soap:body, use = literal, part = client)
    OpiskeluoikeudetResponse type OpiskeluoikeudetResponse
  6. Tutkinnot
    Operation type:
    Request-response. The endpoint receives a message, and sends a correlated message.
    Input:
    TutkinnotRequest (soap:body, use = literal, part = client)
    TutkinnotRequest type Tutkinnot
    Output:
    TutkinnotResponse (soap:body, use = literal, part = client)
    TutkinnotResponse type TutkinnotResponse

 

 

 

  • No labels