Yleistä

AihealueKysymysVastaus
Verkostokohtaista sopimista vaativat tietojen kuvaukset ennen palveluun liittymistä

Minkä tietojen osalta tarvitaan korkeakouluilta yhteistä sopimista?

Ristiinopiskelupalvelu välittää korkeakoulujen välillä myös sellaisia tietoja, joiden sisältöön palvelu ei ota kantaa, eikä tee tarkistuksia.

Viestien mukana on esimerkiksi mahdollisuus välittää kuvaustietoja yleisen keywords-kentän avulla. Tätä kenttää käytettäessä tulee määritellä sanastolle tunniste ja yksikäsitteinen nimi (kielistettynä). Sanastoon kuuluvien sallittujen arvojen määrittely tapahtuu ristiinopiskelupalvelun ulkopuolella. Jos käytetään valmista sanastoa (esim. eurooppalainen ESCO-luokitus), korkeakoulut käyttävät tietoja omissa järjestelmissään ESCO:n määrittelyjen mukaisesti ja ottaessaan vastaan esco-luokittelun mukaisen arvon, osaavat tulkita sen oikein. On myös tapauksia, joissa korkeakouluilla on yhteiden määrittely tiedon tyypistä (esim. koulutusohjelman tieto, jota vastaa myös käyttäjähallinnan määrittelyissä funetEduPersonProgram), mutta sanaston arvot ovat korkeakoulukohtaisia. Tällöin tulee sopia tietoja välitettäessä siitä, että mukana on myös tieto, minkä organisaation arvosta on kyse. Esim. jos kahdessa korkeakoulussa on samanniminen koulutusohjelma, pitää välitettävän tiedon perusteella pystyä erottamaan, mikä näistä kuuluu kullekin korkeakoululle.

Kun palvelua aletaan käyttää ja sovitaan tietojen soveltamisesta, on tarpeen koota tieto sovituista käytännöistä yhteen paikkaan. Tälle sivulle listataan käyttöönottovaiheessa korkeakoulujen sopimat käyttötavat.


Palveluun liittyminenJava-client antaa palveluun yhteyttä otettaessa virheilmoituksen "PKIX path building failed"

JMS:

Korkeakoulun client-sertifikaatin luomiseen käytetty privaattiavain/client-sertifikaattipari tulee löytyä Javan keystoresta. Lisäksi ristiinopiskelupalvelun CA-sertifikaatti (ks. ylempää kohta "Palveluiden osoitteet testissä") tulee löytyä Javan truststoresta.

REST:

Korkeakoulun client-sertifikaatin luomiseen käytetty privaattiavain/client-sertifikaattipari tulee löytyä Javan keystoresta. Ristiinopiskelupalvelun CA-sertifikaattia ei tarvita truststoreen.

Huomaa, että truststoren määrittäminen ohjelmallisesti ohittaa Javan käyttöjärjestelmätason CA-truststoren, jolloin julkisten CA-palvelinten allekirjoittamat sertifikaatitkaan eivät toimi.

Materiaalia:


Palveluun liittyminenPalvelu ei satunnaisesti tunnu vastaavan kuittausviestillä lähetettyihin pyyntöihin

Lähtökohtaisesti viestiliikenne ristiinopiskelupalvelun kanssa olisi hyvä toteuttaa asynkronisesti.

Tarkista, että clientin timeout on asetettu tarpeeksi pitkäksi. Mikäli client ehtii sulkemaan väliaikaisen jonon johon vastausta odotetaan, vastaus jää saamatta.

Esimerkiksi Springin JmsTemplatelle timeoutin voi asettaa metodilla .setReceiveTimeout(...).


Palvelun kehittäminenMistä löydän palvelussa käytetyt koodistotKoodistot löytyvät skeemasta.



  • No labels