Wiki source code of Synchronizace uživatelů z externího zdroje - best practices
Last modified by Martin Mahr on 2024/10/21 22:21
Show last authors
| author | version | line-number | content |
|---|---|---|---|
| 1 | Doporučujeme následující praktiky synchronizace uživatelů z externího zdroje do Tritia. Tato doporučení vznikla na základě zkušeností s reálnými problémy a jejich uplatněním se vyhnete mnohým problémům, které je zbytečné opakovat. | ||
| 2 | |||
| 3 | Externím zdrojem je myšlena externí databáze uživatelů, kterou spravuje provozovatel knihovního systému - např. LDAP, univerzitní systém, ekonomický systém organizace, ... | ||
| 4 | |||
| 5 | Obecná doporučení: | ||
| 6 | |||
| 7 | * Je třeba vhodně vybrat párovací údaj, přes který se bude jednoznačně párovat uživatel v Tritiu s uživatelem z externího zdroje. Za nejvhodnější považujeme využít uživatelské jméno, případně položku externí id uživatele Tritia. | ||
| 8 | * Synchronizace uživatelů se provádí pravidelně (1x denně v noci) jednosměrně z externího zdroje do Tritia - tzn. počítá se s tím, že uživatel už bude v Tritiu existovat a může omezeně využívat její služby po přihlášení, i když v knihovně ještě nebyl. | ||
| 9 | * Synchronizace zahrnuje čtenáře i obsluhu knihovny. Nicméně přidělování práv pro obluhu je snadnější zařídit ručně v Tritiu. | ||
| 10 | * Pravidla pro archivaci uživatelů či jejich opětovné vytažení z archviu mohou být velmi individuální a je třeba pečlivě zvážit pro každý provoz. | ||
| 11 | |||
| 12 | Postup synchronizace: | ||
| 13 | |||
| 14 | 1. Zjistit seznam všech uživatelů z externího zdroje (zjištěná data se logují pro případné hledání chyb). | ||
| 15 | 11. Uživatelé, kteří nemají vyplněný párovací údaj, jsou vyřazeni ze seznamu pro další synchronizaci. | ||
| 16 | 11. Seznam uživatelů musí vracet více než 0 výsledků, jinak se předpokládá chyba synchronizace a je lepší ji ukončit. | ||
| 17 | 1. //Volitelně~:// Archivovat uživatele (pravidla jsou individuální, například ty, kteří byli dříve z externího zdroje přeneseni a nyní již v něm neexistují) | ||
| 18 | 11. Uživatelská jména archivovaných uživatelů jsou změněna, aby byla uvolněna pro recyklaci, je-li to třeba (doporučený formát archivovaného uživatelského jména = "ARCHIVE_<TRITIUS_USER_ID>"). | ||
| 19 | 11. Tento krok je třeba provádět před vlastní synchronizací, aby se případně uvolnila pro nové uživatele uživatelská jména uživatelů, kteří jsou archivováni. | ||
| 20 | 1. Seznam uživatelů z externího zdroje se prochází a provádí se synchronizace s Tritiem, přesněji pro každého uživatele: | ||
| 21 | 11. Hledá se uživatel v Tritiu podle párovacího údaje | ||
| 22 | 111. Pokud není nalezen (neexistuje) - kontroluje se existence jiného uživatele se stejným uživatelským jménem | ||
| 23 | 1111. Uživatelské jméno již existuje - zaloguje se chyba, záznam není vytvořen (chybový stav, duplicitní uživatelé) | ||
| 24 | 1111. Uživatelské jméno neexistuje - je vytvořen nový uživatel //(viz Vytvoření nového uživatele)// | ||
| 25 | 111. Pokud je nalezen (existuje) - kontroluje se ještě shoda datum narození záznamů z obou systémů (pojistka proti špatnému párování uživatelů, předpokládá se, že by mělo sedět v obou systémech) | ||
| 26 | 1111. Datum narození je různé - zaloguje se chyba, záznam není aktualizován | ||
| 27 | 1111. Datum narození je shodné - provede se aktualizace uživatele (viz //Aktualizace existujícího uživatele//) | ||
| 28 | 11111. //Volitelně~:// Pokud je uživatel archivován, je automaticky vytažen z archivu zpět na výchozí oddělení knihovny (opět záleží na konkrétních potřebách knihovny, uživatelé z archivu nemusejí být vytahování). | ||
| 29 | |||
| 30 | **Vytvoření nového uživatele** | ||
| 31 | |||
| 32 | Při vytváření nového uživatele dopuručujeme přenášet: | ||
| 33 | |||
| 34 | * párovací údaj (pokud to není přihlašovací jméno) jako External ID, | ||
| 35 | * přihlašovací jméno, | ||
| 36 | * jméno a příjmení, | ||
| 37 | * kontaktní adresa - ulice, město, psč, stát, | ||
| 38 | * trvalá adresa - ulice, město, psč, stát, | ||
| 39 | * telefon, email. | ||
| 40 | |||
| 41 | Jako čtenářské číslo - přiřadit další v pořadí. | ||
| 42 | |||
| 43 | Jako uživatelovu výchozí uživatelská skupinu i výchozí čtenářskou skupinu - nastavit výchozí čtenářskou skupinu v systému. | ||
| 44 | |||
| 45 | Jako výchozí oddělení uživatele - nastavit vybrané oddělení v knihovně, které není typu archiv. | ||
| 46 | |||
| 47 | |||
| 48 | **Aktualizace existujícího uživatele** | ||
| 49 | |||
| 50 | Při aktualizaci se aktualizují všechny údaje jako při vytváření nového uživatele. | ||
| 51 | |||
| 52 | Adresu doporučujeme aktualizovat jen pokud je v externím systému neprázdná (pokud ji někdo v Tritiu vyplní), aby se nepřepsala z externího systému prázdnou hodnotou. | ||
| 53 | |||
| 54 | Zvážit aktualizaci položek telefon a email - pokud jej knihovnice v Tritiu aktivně opravují, může být výhodné aktualizovat jen pokud je v Tritiu stále nevyplněný (a preferovat tedy hodnotu v Tritiu). | ||
| 55 | |||
| 56 |