Monet oppilaitokset synkronoivat itslearningin tiedot opiskelijahallintojärjestelmästä, kuten Primus tai StudentaPlus. Pääkäyttäjä saa silloin sähköpostiinsa lyhyen raportin jokaisesta importista. Mitä tuo raportti sisältää?
Kaikkein tärkeimmän tiedon luet jo lokiviestin otsikosta: onko import onnistunut vai ei.
- Import finished with status Failed: jostain syystä import epäonnistui
- Import finished with status Completed: import onnistui
Molemmissa tapauksissa näet yhteenvedon ja lisätietoja lokiviestin sisällöstä.
Miksi import voi epäonnistua?
Tavallisin syy importin epäonnistumiseen on se, että tiedosto sisältää liian paljon muutoksia edelliseen importiin verrattuna. Tällöin lokiviestin lopussa voi lukea jotain tämänlaista:
06:03 To many group changes. Aborting import .
06:03 Import got exception To many group inserts: 48%. Max allowed: 20%.
Lukuvuoden alussa tämä on täysin normaalia. Silloin voit pyytää tukeamme poistamaan oletuksena kaikissa importeissa olevan 20% -suojausfiltterin. Kesken lukuvuottakin on mahdollista, että muutoksia tulee enemmän. Suojausfiltteri on kuitenkin hyvä pitää muuten päällä, siltä varalta, että tiedosto lähtisi itslearningiin vahingossa puutteellisena. Koska kyse on synkronoinnista, poistaa import itslearningistä kaikki käyttäjät, hierarkiat ja kurssit, joita tiedosto ei enää sisällä.
Toinen melko tavallinen syy importin epäonnistumiseen on se, että XML-tiedosto ei ole ehjä. Yksi tapa tarkistaa XML-tiedosto on avata se tiedostona selaimessa. Selain antaa virheilmoituksen, jos tiedosto on jollakin tavalla rikki. Linux-ympäristössä tiedoston voi tarkistaa mm. xmllint-ohjelmalla.
Jos importin epäonnistumiseksi annetaan lokissa jokin muu syy, ole yhteydessä tukeemme.
Lokiviestin sisältö
Onnistuneen importin tapauksessa loki kuvaa ensin importin eri vaiheet, kertoo importoitavien tiedostojen lukumäärän ja nimet.
Seuraavaksi loki antaa yhteenvedon importin sisällöstä, esim:
07:01 Summary of changes to data:
Before this import there was 29165 persons, 16998 groups, 189614 memberships and 0 relationships.
After this import are there 29483 persons, 24447 groups, 552444 memberships and 0 relationships.
Positive person changes: 1%
Positive group changes: 44%
Positive membership changes: 192%
Positive relationship changes: 0%
Negative person changes: 0%
Negative group changes: 0%
Negative membership changes: 1%
Negative relationship changes: 0%
Total person changes: 1%
Total group changes: 43%
Total membership changes: 191%
Total relationship changes: 0%
Tästä näet numeeriset ja prosentuaaliset muutokset edelliseen importiin verrattuna. Jos suojausfiltteri on pois päältä, voivat muutokset olla suuriakin.
Seuraavaksi import kertoo tarkemmin, mitä operaatioita se tekee, ja miten ne onnistuvat. Ensimmäinen numerosarja on kellonaika – jos importoitava datamäärä on suuri, voi importissakin kestää hetki.
07:01 Total person updates: 49.
07:01 Total person inserts: 443.
07:01 Total person deletes: 125.
07:01 Total relationship updates: 0.
07:01 Total relationship inserts: 0.
07:01 Total relationship deletes: 0.
07:01 Total groups update: 12432.
07:01 Total group inserts: 7512.
07:01 Total group deletes: 63.
07:01 Total membership update: 3107.
07:03 Total membership inserts: 365407.
07:03 Total membership deletes: 2577.
07:03 End filtering data and adding to queue .
07:34 Items completed ok: 389476.
07:34 Items completed with warning: 2229.
07:34 Items completed with error: 10.
07:34 Persons completed ok: 528.
07:34 Persons completed with warning: 88.
07:34 Persons completed with error: 1.
07:34 Relationships completed ok: 0.
07:34 Relationships completed with warning: 0.
07:34 Relationships completed with error: 0.
07:34 Groups completed ok: 20005.
07:34 Groups completed with warning: 0.
07:34 Groups completed with error: 2.
07:34 Memberships completed ok: 368943.
07:34 Memberships completed with warning: 2141.
07:34 Memberships completed with error: 7.
07:34 Mentor memberships completed ok: 0.
07:34 Mentor memberships completed with warning: 0.
07:34 Mentor memberships completed with error: 0.
07:34 Import ended
Tässä osassa kannattaa kiinnittää huomiota lähinnä virheiden (error) määrään. Yllä olevassa esimerkissä virheitä esiintyi yhden käyttäjän tiedoissa, kahden ryhmän, ja seitsemän jäsenyyden. (Jäsenyyksiin liittyvät virheet johtuvat yleensä joko ko. käyttäjän tai ryhmän virheistä.) Tarkemman virhelokin saat tuestamme tarvittaessa.
Hyödyllinen juttu 🙂