Import av FS-data i Cerebrum

2.1   Personopplysninger

Et typisk datastruktur i merged_persons.xml kan se slik ut:

<person fodselsdato="…" personnr="…">
    <opptak … />
    <emnestud …/>
    <fagperson …/>
    <aktiv studentnr_tildelt="…" studieprogramkode="…" emnekode="…"… />
    <eksamen studieprogramkode="…" emnekode="…" … />
    <nettpubl akseptansetypekode="NETTPUBL" status_svar="…" … />
</person>

Enkelte elementer i denne datastrukturen vil typisk inneholde personinformasjon. opptak, emnestud og fagperson er typiske elementer som inneholder personinformasjon. Dette inkluderer studentnummer, adresse og mobilnummer.

Ved import, vil vi hente fødselsnummer fra person-elementet, og videre benytte dette for å matche person med allerede importerte personer i Cerebrum.

I tillegg vil følgende registreres:

Kjønn

Hentes fra fødselsnummer

Fødselsdato

Hentes fra fødselsnummer

Navn

Hentes fra et av elementene:

• fagperson
• opptak
• tilbud
• evu
• privatist_emne
• privatist_studieprogram
• alumni
• emnestud

Studentnummer

Hentes fra et vilkårlig element i person-datastrukturen med verdien studentnr_tildelt.

Adresse

Hentes fra ulike element, avhengig av type. En person kan få flere adresser fra FS.

Mobilnummer

Hentes fra et hvilket som helst element med verdien telfonnr_mobil, men lagres kun i Cerebrum dersom samtlige elementer i datastrukturen er lik.

2.2   Tilknytninger

I tillegg til å hente personinformasjon, som navn og kontaktadresse, benyttes FS-importen til å gi personer tilknytning til ulike steder i OU-strukturen i Cerebrum. Disse tilknytningene kan senere benyttes til å finne ut hvilke personer som skal få provisjonert en brukerkonto.

3.1   Profiler

Studentautomatikken benytter en konfigurasjonsfil, hvor man kan tilpasse provisjonering av brukerkonto.

Man kan lage ulike profiler for ulike fagmiljøer (f.eks. alle realfagsstudenter), og man kan ha ulike profiler på ulike studentgrupper (f.eks. alle doktorgradsstudenter, alle enkeltemnestudenter på HF).

En profil består av:

Utplukk

Matching av personer fra FS-data og Cerberum-data, hvilke personer gjelder profilen for?

Vekting

Hvordan skal profilen prioriteres dersom en person matcher flere brukerprofiler?

Byggekriterier

• Skal det lages brukerkonto?
• Skal brukerkonto ha hjemmeområder?

Karantener

Skal brukeren settes i karantene?

Spreads

• Hvilke systemer skal brukeren være synlig i?
• Hvilke systemer skal persondata være synlig i?

Grupper

Skal brukeren meldes inn i noen grupper?

Annet

• Hvilken disk skal hjemmeområde plasseres på?
• Hvor mye diskplass skal brukeren kunne benytte?
• Hvor mye diskplass skal brukeren disponere til e-post?
• Hvilken brevmal skal benyttes for passordbrev?

3.2   Prosessering av FS-data

Scriptet benytter Cerebrum.modules.no.uio.AutoStud for å gå gjennom samtlige personer i merged_persons.xml.

For hver person i importfil gjøres følgende vurdering:

1. avbryt prosessering hvis person ikke finnes i Cerebrum (ikke importert i import_FS.py)

2. avbryt prosessering hvis person alt har blitt prosessert (for å forhindre dobbel-prosessering av personer som finnes i både FS og Cerebrum).

3. finn profil fra konfigurasjon (studconfig.xml), avbryt hvis ingen profil finnes for person.

4. Finn brukere for person, og finn passende handling:

   • Kjør oppdatering av konto hvis personen allerede har en studentkonto (inkludert reservert konto og deaktivert konto)
   • Kjør oppretting av konto hvis personen ikke har konto.
   • Avbryt hvis personen har brukerkonto, men som ikke lar seg benytte som studentbrukerkonto.

3.3   Prosessering av Cerebrum-data

Vi vil også forsøke å gjøre vedlikehold av brukerkonti for personer som ikke er med i utplukket fra FS. Scriptet benytter Cerebrum.modules.no.uio.AutoStud for å gå gjennom samtlige personer i Cerebrum som har blitt tildelt et fødselsnummer fra FS.

For hver person gjøres følgende vurdering:

1. Avbryt prosessering dersom person ikke har en studentbrukerkonto
2. Kjør samme rutine som prosessering av FS-data

3.4   Oppretting av konto

Studentbrukerkonto opprettes ved å:

1. Lage brukerkonto
2. Generere passord
3. Merke brukerkonto med trait trait_student_new

I tillegg kjøres oppdatering av konto.

3.5   Oppdatering av konto

Brukerkonto som oppdateres får følgende endringer:

1. Gjør konto om til posix-konto, dersom profil angir posix-spread
2. Sett standard filgruppe, dersom profil angir posix-spread, og bruker ikke alt har standard filgruppe.
3. Legg til spreads angitt i profil.
4. Sørg for at brukerkonto er medlem av standard filgruppe, dersom posix-bruker
5. Forsøk å tildele hjemmeområde, dersom profil angir at brukerkonto skal ha et disk spread og bruker ikke alt har hjemmeområde for dette.
6. Fjern karantene auto_inaktiv og auto_emailonly
7. Hvis brukerkonto var deaktivert:
   1. Fjern gamle hjemmeområder?
   2. Merk brukerkonto med trait trait_student_new
   3. Generer nytt passord
8. Oppdater ac_type slik at studentbrukerkonto har STUDENT-tilknytning fra person. Dette benyttes bl.a. til å skille studentbrukerkonto fra andre brukerkontoer.
9. Legg på karantener fra profil (unntatt karantener med scope=student_disk og brukerkonto ikke har hjemmeområde)
10. Hvis bruker har hjemmeområder, oppdater kvote.
11. Oppdater studentgrupper med gruppemedlemsskap fra profil.