4
szerkesztés
Módosítások
a
→Implementációk
Az NIIF Intézet által fejlesztett szinkronizációs folyamat alkalmas arra, hogy Neptunban tárolt felhasználók (hallgatók, oktatók, dolgozók) adatait egy névtárba szinkronizálja. Természetesen lehetséges a névtárat más forrásokból is módosítani (pl. a dolgozói adatok sokhelyütt nem a Neptunban tárolódnak), ezzel a szinkronizációs program nem foglalkozik.
Az NIIF Intézet referencia implementációjának leírása [[NeptunLdapSyncImpl|itt található]]
== Feltételezések ==
* A Neptun tartalmazza az SDA által kifejlesztett szinkronizációs webservice-t (ezt jelen pillanatban az SDA-tól kérni kell)
* A Neptun ezen kívül biztosít egy olyan webservice-t is, amely ellenőrizni tud egy neptunkódhoz tartozó jelszót (információink szerint ilyet néhány helyen biztosít az SDA)
* Létezik egy vagy több - az intézmény által fejlesztett vagy üzembe állított - webes adminisztrációs alkalmazás, ahol a felhasználók a Neptun jelszavuk birtokában tudnak maguk számára
** LDAP jelszót generálni (a neptunos jelszó '''nem''' szinkronizálódik az LDAP-ba)
** LDAP jelszót megváltoztatni
** LDAP azonosítót generálni (opcionális, az intézmény algoritmikusan generált azonosítókat is alkalmazhat)
** további LDAP attribútumokat generáltatni (pl. levelezéshez, Unix bejelentkezéshez stb.)
== Felhasználó életciklusa ==
# Neptun felhasználói bejegyzés létrehozása (részletek nélkül)
| Titulus || title || pl. Dr.
|-
| Telefonszám || telephoneNumber, mobile , fax || ?A mobiltelefonszámot érdemes külön LDAP attribútumban tárolni a többi telefonszámtól. Speciális konverziós logika szükséges lehet (például az elválasztó karakterek törlése).
|-
| E-mail cím || mail ||
! Attribútum !! LDAP Attribútum !! Megjegyzés
|-
| Hallgatói státusz || eduPersonAffiliation={'student' , 'member'} || Ha van hozzá olyan képzés, aminek hallgatója
|-
| Oktatói státusz || eduPersonAffiliation={'faculty' , 'member'} || Ha az elmúlt N évben volt kurzushoz kapcsolódása
|-
| Alkalmazotti státusz || eduPersonAffiliation={'employee', 'staff', 'member'} || Ha alkalmazott
|}
! Attribútum !! LDAP Attribútum !! Megjegyzés
|-
| Szervezeti egység Kar || niifEduPersonFaculty(DN) || Képzés kar szabadszöveges megnevezése (kódja) - csak hallgatóknál|-| Szak ||niifEduPersonMajor | eduPersonOrgUnitDN |Képzés szak szabadszöveges megnevezése - csak hallgatóknál| DN, tehát az LDAP-ban a | Egyéb szervezeti fát fel kell építeni. Hallgatóknál a valaha volt képzésekhez hozzárendelt egység (ált. intézmény vagy kar). Oktatóknál, alkalmazottaknál azon egységek, amelyekhez jelenleg jogviszony fűzi (kar, || eduPersonOrgUnitDN || Pl tanszék, intézet, kollégium, ...)
|}
== Szinkronizáció ==
A Neptun és az LDAP közötti szinkronizációt az LDAP oldali szinkronizáló szkript indítja.
=== Neptun interfészek ===
A szinkronizálás a Neptun által biztosított XML Webszolgáltatáson keresztül valósul meg. A legtöbb művelet két paramétert fogad: időbélyeg illetve Neptun lista - mindkettő opcionális. Amennyiben az időbélyeg szerepel, csak a megadott időpont óta módosult rekordok kerülnek át. A Neptun lista megadása az adott bejegyzésekre szűkíti az eredményt.
Fontos, hogy pl. a személyi adatoknál az időbélyeg a Neptun-ban a teljes rekordra értelmezett, tehát nem csak a szinkronizálni kívánt adatok triggerelik a változását.
* Szervezeti struktúra
** paraméterek: nincs
** visszatérés: szervezeti egységek fastruktúrája (egységenként: kód, szerv. egység neve, típusa)
** ritka szinkronizálás (félévente)
* Neptun kódok és státuszok
** paraméterek: opc. időbélyeg, opc. Neptun lista
** visszatérés: Neptun kód, hallgatói státusz, oktatói státusz, alkalmazotti státusz
** gyakori szinkronizálás (legalább naponta)
* Személyi adatok
** paraméterek: opc. időbélyeg, opc. Neptun lista
** visszatérés: Neptun kódhoz tartozó személyi adatok
** gyakori szinkronizálás (naponta)
* Szervezeti kapcsolódás
** paraméterek: opc. időbélyeg, opc. Neptun lista
** visszatérés: Neptun kódhoz tartozó szervezeti egységek kódja
** ritka szinkronizálás (félévente)
* Oktatási adatok
** paraméterek: Neptun lista
** visszatérés: minden megadott neptun kódhoz az összes oktatási adat (nem csak a változások)
** ritka szinkronizálás (szorgalmi időszakban hetente, tárgyjelentkezési időszak kezdetétől regisztrációs hét végéig nincs szinkronizálás)
= Implementációk =* [[Kategória: CsonkokNeptunLdapSyncImpl|NIIF szinkronizáció implementáció (PHP)]]* [[NeptunWebservicePPKE|Neptun webservice szinkronizációs próbálkozások a PPKE-n]]
