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
Ukryj ostatnich autorów
| author | version | line-number | content |
|---|---|---|---|
| |
2.1 | 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ć. |
| |
1.1 | 2 | |
| |
2.1 | 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. |
| |
1.1 | 4 | |
| |
2.1 | 5 | Ogólne zalecenia: |
| |
1.1 | 6 | |
| |
2.1 | 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. | ||
| |
1.1 | 11 | |
| 12 | |||
| 13 | |||
| |
2.1 | 14 | Procedura synchronizacji: |
| |
1.1 | 15 | |
| |
2.1 | 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). | ||
| |
1.1 | 31 | |
| |
2.1 | 32 | **Tworzenie nowego użytkownika** |
| |
1.1 | 33 | |
| |
2.1 | 34 | Podczas tworzenia nowego użytkownika zalecamy przeniesienie: |
| |
1.1 | 35 | |
| |
2.1 | 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. | ||
| |
1.1 | 42 | |
| |
2.1 | 43 | Jako numer czytelnika – przypisać kolejny w kolejności. |
| |
1.1 | 44 | |
| |
2.1 | 45 | Jako domyślną grupę użytkownika i domyślną grupę czytelników – ustawić domyślną grupę czytelników w systemie. |
| |
1.1 | 46 | |
| |
2.1 | 47 | Jako domyślny dział użytkownika – ustawić wybrany dział w bibliotece, który nie jest typem archiwum. |
| |
1.1 | 48 | |
| 49 | |||
| |
2.1 | 50 | **Aktualizacja istniejącego użytkownika** |
| |
1.1 | 51 | |
| |
2.1 | 52 | Podczas aktualizacji wszystkie dane są aktualizowane tak samo jak podczas tworzenia nowego użytkownika. |
| |
1.1 | 53 | |
| |
2.1 | 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). |