Ristiinopiskelupalveluun liittyvissä Pepissä tai Sisussa havaituissa vioissa tulisi olla yhteydessä ensin kyseisen järjestelmän tukeen tai sovellusylläpitoon. Tällä tavalla voidaan määrittää se, onko vika perusjärjestelmässä itsessään vai Ristiinopiskelupalvelussa. Mikäli todetaan, että vika mahdolisesti on Ristiinopiskelupalvelussa, ilmoituksen siitä voi lähettää sähköpostilla osoitteeseen ristiinopiskelupalvelu@postit.csc.fi. Sovellusylläpitäjä voi auttaa yksityiskohtaisten teknisten tietojen hankkimisessa, joita tarvitaan vian määrityksessä Ripassa.

Perusjärjestelmillä on myös omaa dokumentaatiota vianselvityksestä sekä käyttöohjeita

Lisäksi kannattaa tarkistaa näiden vikaseuranta sekä myös Ripan tunnistetut viat tai ongelmat Ristiinopiskelupalvelun Jirasta

Kannatta myös tarkistaa sivulta Korkeakoulujen järjestelmien huoltokatkot, onko vastapään korkeakoulussa mahdollisesti huoltokatko, minkä takia ilmoittautumiset tai suoritusmerkinnät eivät ehkä siirry sinne. Ristiinopiskelupalvelun omat säännölliset Huoltokatkot ovat joka kuun ensimmäinen tiistai kello 9:00 - 12:00. 

Toisinaan vian syynä on jokin puuttuva tieto perusjärjestelmässä. Vaikka virhe saattaa tuntua niin sanotulta käyttäjän virheeltä, niin kannattaa miettiä, että olisiko virheilmoituksia kuitenkin hyvä parantaa, jotta virheen syy olisi heti nähtävillä käyttäjälle. Puutteellinen virheilmoitus itsessään on myös vika, josta voi tehdä vikailmoituksen.

Korkeakoulujen yhteystiedot, mihin voi olla yhteydessä ristiinopiskeluun liittyvissä ongelmissa esim. verkostossa olevien korkeakoulujen osalta (taulukossa oikealla):https://wiki.eduuni.fi/x/epIgC

Tunnettuja yleisiä ongelmia

OngelmaVirheRatkaisu
Suoritusmerkintä ei siirry kohdekorkeakoulusta takaisin

FAILED to send message CREATE_STUDYRECORD_REQUEST and got response DEFAULT_RESPONSE message text: Failed to process message with type CREATE_STUDYRECORD_REQUEST, error: No valid registrations found for completedCreditTarget [id=xxxxx, organizingOrganisationId=yyyyy, type=REALISATION]

Näissä useimmiten on syynä Ripan palveluväylän ongelma, joka satunnaisesti tulee vastaan silloin tällöin.

Korjaus voidaan tehdä Ripan tietokantaan, minkä jälkeen suoritusmerkinnän siirtäminen onnistuu. Ole yhteydessä Ripan palveluosoitteeseen ristiinopiskelupalvelu@postit.csc.fi. Vian korjaamiseksi tarvitaan tieto ainakin toteutuksesta, jota ongelma koskee (vieressä olevan virheviestin id, tai toteutuksen koodi Pepissä) sekä opiskelijan opiskelijanumero tai opinto-oikeuden tunniste. Opiskelijan nimeä ei tarvita eikä se yksinään riitäkään virheen paikallistamiseen. 

Toinen mahdollinen syy virheelle on, että opiskelijan ilmoittautumista ei ikinä ole hyväksytty tai se ei ole kirjautunut Ripaan hyväksyttynä. Taikka ilmoittautuminen on saatettu peruuttaa tai hylätä. Näissä tapauksissa tilanne saattaa ratketa siten, että ilmoittautuminen hyväksytään uudelleen kohdekorkeakoulussa.

Sama virhe on myös tullut tilanteessa, jossa ristiinopiskeluopinto-oikeudelle on siirretty muita suorituksia, jolloin Peppi yrittää lähettää näitä Ripan palveluväylään. Tämä ei onnistu, koska näille ei ole ilmoittautumista Ripassa lainkaan.

Suoritusmerkintä ei siirry kohdekorkeakoulusta takkaisinPepisslä virhekoodi 69 ja viesti "Peppi internal error, stack trace: com.eduix.esp.common.core.exception.PermissionDeniedException: Permission denied to method StudyAccomplishment.queryStudyAccomplishments for identity null"

Syy tähän edelleen epäselvä. Joka tapauksessa Pepin sisäinen virhe, jota pitäiisi selvittaä Pepin ylläpitäjän ja mahdollisesti konsortion kautta.

Tätä on esiintynyt eri korkeakouluilla silloin tällöin, mutta syy ei ole selvinnyt. Jotain viitteitä siitä, että saattaisi ehkä liittyä useamman virheen kerralla uudelleen lähettämiseen. Voi siis kokeillä lähettää uudelleen pelkästään tätä virhettä ilman, että valitsee muita samalla kertaa.

Ilmoittautuminen ei siirry kohdekorkeakouluun

FAILED to send message CREATE_REGISTRATION_REQUEST and got response DEFAULT_RESPONSE message text: Failed to process message with type CREATE_REGISTRATION_REQUEST, error: Could not find valid network with given network id: c84917a0-b46d-4bee-8d2f-2a2fdb0a901

Todennäköinen syy on, että verkosto, jota yritetään käyttää ilmoittautumiseen on vanhentunut. Kyseessä on virheellinen toiminta Pepissä, sen tulisi valita aktiivinen verkosto eikä vanhentunutta.

Virhe voidaan kiertää siten, että opiskelijalta poistetaan kohdennus vanhentuneeseen verkostoon. Tällöin Peppi valitsee toisen verkoston ilmoittautumiseen ja ilmoittautumisen pitäisi toimia.

Ilmoittautuminen antaa Pepin sisäisen virheen

CREATE studyEnrollment 123456789|C-012345-AB12345-1001 internal JMS event handling failed, when creating message to cross study server, exception message: null, stack trace: java.lang.NumberFormatException: null

Tässä useimmiten opiskelijalta puuttuu jokin Ripan kannalta pakollinen tieto. Yleinen tilanne on, että sukupuoli ei ole määritelty.

Ilmoittautuminen odottaa kotikorkeakoulussa hyväksyntää, eikä näy kohdekorkeakoulussa

Ei näkyvää virheilmoitusta Pepissä. Kotikorkeakoulussa ilmoittautuminen on "odottaa hyväksyntää" tilassa. Kohdekorkeakoulussa ilmoittautumista ei näy lainkaan.

Tässä syynä on yleensä se, että opiskelijalle on äidinkieleksi asetettu "ei virallinen kieli" (98). Kohdekorkeakoulun Peppi ei bugista johtuen pysty käsittelemään tätä eikä ilmoittautuminen tule sinne näkyviin lainkaan. Kun kotikorkeakoulussa opiskelijan kieleksi vaihdetaan jokin oikea kieli tai "tuntematon" (99) niin ongelma yleensä ratkeaa. Ilmoittautuminen on vielä sen jälkeen lähetettävä uudelleen.

Ilmoittautuminen ei onnistu testiympäristössäFAILED to send message CREATE_REGISTRATION_REQUEST and got response DEFAULT_RESPONSE message text: Failed to process message with type CREATE_REGISTRATION_REQUEST, error: Only test persons are allowed in this environment

Testiympäristössä voidaan käyttää testihenkilöinä vain sellaisia, joilla henkilötunnus ja oppijanumero ovat selvästi testimuotoisia. Tämä tarkoittaa, henkilötunnuksessa sitä, että sen loppuosa alkaa numerolla 9. Oppijanumerossa testi numerot alkavat 1.2.246.562.98. Virheviesti sanoo, että on käytetty henkilöä, jonka henkilötunnus tai oppijanumero eivät ole tämän muotoisia ja siksi Ripa ei ota ilmoittautumista vastaan.

Tämä rajoitus on testiympäristössä, jotta voidaan varmistua siitä, että oikeita henkilötietoja ei vahingossa siirry testiympäristöön.

Sisusta tuleva opintojakso ei näy PepissäMahdollisesti virhe Pepin lokissa tietojen vastaanottamisest, mutta ei vielä tiedossa. 

Syynä voi olla se, että Sisussa henkilöviittaus (vastuuhenkilö tai vastaava) on syötetty vapaana tekstinä eikä varsinaisena henkilö-tietueena. Ripassa tämä menee henkilöviittauksen definition-kenttään. Peppi odottaa tässä kentässä tietoa henkilön roolista. Tämä todennäköisesti aiheutaa virheen Pepissä.

Tilanne voidaan ratkaista muuttamalla henkilöviittauksia Sisussa Pepille ymmärrettävään muotoon.

Vikailmoitukset Ristiinopiskelupalveluun

Vikailmoitukset Ristiinopiskelupalveluun lähetetään sähköpostilla osoitteeseen ristiinopiskelupalvelu@postit.csc.fi. Lähettäessäsi vikailmoitusta, pyri antamaan ainakin seuraavat tiedot viasta:

  • Päivä ja kellonaika, jolloin virhe on tapahtunut. Ilman tätä tapahtumaa on melkein mahdoton löytää lokitiedoista. Kellonajan saa usein lokeista tai virheilmoituksista sekuntilleen, mutta jo tunninkin tarkkuudella auttaa vian etsimistä Ripan lokeista, mikäli tarkempaa aikaa ei ole saatavilla. Mikäli samanlaisia virheitä on lukuisia niin riittää tapahtuma-aika yhdestä tai muutamasta.
  • Mitä yritettiin tehdä, mitä tapahtui tai jäi tapahtumatta. Mitkä korkeakoulut ovat osallisina.
    • Esimerkiksi, korkeakoulussa A yritettiin ilmoittautua korkeakoulun B toteutukseen, mutta ilmoittautuminen ei tullut näkyviin B:ssä. Kotikorkeakoulussa näkyy virheilmoitus.
  • Onko kyseessä testiympäristö vai tuotantoympäristö.
  • Miten tilanne näkyy kotikorkeakoulussa ja miten kohdekorkeakoulussa.
    • Esimerkiksi, ilmoittautuminen näyttää onnistuneen kotikorkeakoulussa, mutta kohdekorkeakoulussa ei näy mitään merkkiä ilmoittautumisesta.
  • Mitä virheilmoituksia on mahdollisesti tullut. Näitä kannattaa katsoa sekä koti että kohdekorkeakoulun päästä.
  • Onko perusjärjestelmän lokitiedoissa havaittu mitään poikkeavaa, mikä saattaisi auttaa vianselvityksessä.

Vältä lähettämästä henkilötietoa, mikäli asia koskee todellista henkilöä tuotantoympäristössä. Mikäli lähetät esimerkiksi viestien täydellisiä sisältöjä, näistä voi poistaa ainakin identifioivat henkilötiedot. Kuitenkin mikäli kyseessä on ongelma yksittäisten ilmoittautumisten tai suoritusmerkintöjen kanssa niin jokin tunniste opiskelijasta tarvitaan vian paikantamiseksi. Tähän riittää esimerkiksi opiskelijanumero.

Vaikka vian todettaisiin olevan perusjärjeselmässä eikä varsinaisesti Ripassa, voi siitä silti lähettää viestin yllä olevaan sähköpostiosoitteeseen, mikäli vika koskee järjestelmän käyttäjiä laajemmin. Voimme tällöin lisätä vian Ristiinopiskelupalvelun Jiraan nähtäville tiedoksi muille. Tällöin kaikki ylläolevat tiedot eivät ole aivan yhtä välttämättömiä, mutta vika olisi silti hyvä kuvata mahdollisimman yksityiskohtaisesti.

  • No labels