Ostatnio modyfikowane 2025/11/19 14:32 przez Jan Slezák

Pokaż ostatnich autorów
1 Zalecamy następujące praktyki synchronizacji użytkowników z zewnętrznego źródła do Tritia. Zalecenia te powstały w oparciu o doświadczenia związane z rzeczywistymi problemami, a ich stosowanie pozwoli uniknąć wielu problemów, których niepotrzebnie nie trzeba powtarzać.
2
3 Przez źródło zewnętrzne rozumie się zewnętrzną bazę danych użytkowników, którą zarządza operator systemu bibliotecznego – np. LDAP, system uniwersytecki, system ekonomiczny organizacji itp.
4
5 Ogólne zalecenia:
6
7 * Należy odpowiednio dobrać dane parujące, za pomocą których użytkownik w Tritiu zostanie jednoznacznie sparowany z użytkownikiem z zewnętrznego źródła. Za najbardziej odpowiednie uważamy wykorzystanie nazwy użytkownika lub zewnętrznego identyfikatora użytkownika Tritia.
8 * Synchronizacja użytkowników odbywa się regularnie (1 raz dziennie w nocy) w jedną stronę, z zewnętrznego źródła do Tritia – tzn. zakłada się, że użytkownik już istnieje w Tritiu i może w ograniczonym zakresie korzystać z jego usług po zalogowaniu, nawet jeśli nie był jeszcze w bibliotece.
9 * Synchronizacja obejmuje zarówno czytelników, jak i obsługę biblioteki. Przydzielanie uprawnień dla obsługi jest jednak łatwiejsze do wykonania ręcznie w Tritia.
10 * Zasady archiwizacji użytkowników lub ponownego wyciągania ich z archiwum mogą być bardzo indywidualne i należy je dokładnie rozważyć dla każdego przypadku.
11
12
13
14 Procedura synchronizacji:
15
16 1. Sprawdź listę wszystkich użytkowników z zewnętrznego źródła (sprawdzone dane są rejestrowane na wypadek ewentualnego wyszukiwania błędów).
17 11. Użytkownicy, którzy nie mają wypełnionych danych parowania, są usuwani z listy do dalszej synchronizacji.
18 11. Lista użytkowników musi zwracać więcej niż 0 wyników, w przeciwnym razie zakłada się błąd synchronizacji i lepiej ją zakończyć.
19 1. //Opcjonalnie//: Archiwizuj użytkowników (zasady są indywidualne, na przykład ci, którzy zostali wcześniej przeniesieni ze źródła zewnętrznego i obecnie już w nim nie istnieją).
20 11. Nazwy użytkowników zarchiwizowanych użytkowników są zmieniane, aby w razie potrzeby można je było ponownie wykorzystać (zalecany format zarchiwizowanej nazwy użytkownika = „ARCHIVE_<TRITIUS_USER_ID>”).
21 11. Krok ten należy wykonać przed samą synchronizacją, aby w razie potrzeby zwolnić nazwy użytkowników, którzy są archiwizowani, dla nowych użytkowników.
22 1. Lista użytkowników ze źródła zewnętrznego jest przeglądana i przeprowadzana jest synchronizacja z Tritiem, dokładniej dla każdego użytkownika:
23 11. Wyszukiwany jest użytkownik w Tritiu na podstawie danych parowania
24 111. Jeśli nie zostanie znaleziony (nie istnieje) — sprawdzana jest obecność innego użytkownika o tej samej nazwie użytkownika
25 1111. Nazwa użytkownika już istnieje — rejestrowany jest błąd, rekord nie jest tworzony (stan błędu, zduplikowani użytkownicy)
26 1111. Nazwa użytkownika nie istnieje — tworzony jest nowy użytkownik (patrz Tworzenie nowego użytkownika)
27 111. Jeśli zostanie znaleziony (istnieje) – sprawdzana jest jeszcze zgodność daty urodzenia w obu systemach (zabezpieczenie przed błędnym sparowaniem użytkowników, zakłada się, że powinna być zgodna w obu systemach).
28 1111. Data urodzenia jest różna – rejestrowany jest błąd, rekord nie jest aktualizowany.
29 1111. Data urodzenia jest zgodna – przeprowadzana jest aktualizacja użytkownika (patrz Aktualizacja istniejącego użytkownika).
30 11111. //Opcjonalnie//: Jeśli użytkownik jest zarchiwizowany, jest automatycznie przenoszony z archiwum z powrotem do domyślnego działu biblioteki (ponownie zależy to od konkretnych potrzeb biblioteki, użytkownicy z archiwum nie muszą być przenoszeni).
31
32 **Tworzenie nowego użytkownika**
33
34 Podczas tworzenia nowego użytkownika zalecamy przeniesienie:
35
36 * danych parujących (jeśli nie jest to nazwa logowania) jako External ID,
37 * nazwy logowania,
38 * imienia i nazwiska,
39 * adresu kontaktowego – ulicy, miasta, kodu pocztowego, kraju,
40 * adresu stałego zamieszkania – ulicy, miasta, kodu pocztowego, kraju,
41 * numeru telefonu, adresu e-mail.
42
43 Jako numer czytelnika – przypisać kolejny w kolejności.
44
45 Jako domyślną grupę użytkownika i domyślną grupę czytelników – ustawić domyślną grupę czytelników w systemie.
46
47 Jako domyślny dział użytkownika – ustawić wybrany dział w bibliotece, który nie jest typem archiwum.
48
49
50 **Aktualizacja istniejącego użytkownika**
51
52 Podczas aktualizacji wszystkie dane są aktualizowane tak samo jak podczas tworzenia nowego użytkownika.
53
54 Zalecamy aktualizację adresu tylko wtedy, gdy nie jest on pusty w systemie zewnętrznym (jeśli ktoś wypełni go w Tritiu), aby nie został nadpisany pustą wartością z systemu zewnętrznego.
55
56 Rozważ aktualizację pozycji telefon i e-mail – jeśli bibliotekarze aktywnie je poprawiają w Tritiu, aktualizacja może być korzystna tylko wtedy, gdy w Tritiu nadal pozostają one nieuzupełnione (i dlatego należy preferować wartość w Tritiu).