Kod źródłowy Wiki Synchronizace uživatelů z externího zdroje - best practices
Ostatnio modyfikowane 2025/11/19 14:32 przez Jan Slezák
Pokaż ostatnich autorów
| author | version | line-number | content |
|---|---|---|---|
| 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). |