Yleistä
Aihealue | Kysymys | Vastaus | |
---|---|---|---|
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 liittyminen | Java-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 liittyminen | Palvelu 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äminen | Mistä löydän palvelussa käytetyt koodistot | Koodistot löytyvät skeemasta. |