Opis procesu masowego importu danych do systemu POL-on
Transkrypt
Opis procesu masowego importu danych do systemu POL-on
Dokument Utworzył: Opis procesu masowego importu danych do systemu PON-on Marek Michajłowicz Ostatnia modyfikacja: 2011-11-21 Wersja: 2.3.0 Opis procesu masowego importu danych do systemu POL-on Data utworzenia: 2011-07-20 Status: Obowiązujący Strona: 1 / 64 Dokument Utworzył: 1. 2.3.0 Cel dokumentu ................................................................................................................................ 5 Zakres dokumentu .......................................................................................................................... 5 Powiązane dokumenty ................................................................................................................... 5 Zastosowane skróty i pojęcia ........................................................................................................ 5 Aktywacja konta .............................................................................................................................. 7 Uprawnienia użytkownika w procesie importu masowego ....................................................... 7 Akceptacja struktury jednostki ...................................................................................................... 7 Bezpieczeństwo danych ................................................................................................................. 7 Ogólne założenia dotyczące importu masowego........................................................................ 8 Identyfikatory jednostek ................................................................................................................ 9 Ustalenia dotyczące edycji kodów jednostek w systemie POL-on ........................................... 9 Słowniki importu ........................................................................................................................... 10 Terminy przekazywania danych .................................................................................................. 10 Proces importu .............................................................................................................................. 11 Stany importu ................................................................................................................................ 11 Etap wstępnej walidacji plików ................................................................................................... 12 Etap importu plików ...................................................................................................................... 14 SCENARIUSZE UŻYTKOWANIA SYSTEMU ................................................................................. 15 4.5 4.6 4.7 4.8 4.9 5. Wersja: PROCES IMPORTU DANYCH DO SYSTEMU .................................................................................. 8 3.1 3.2 3.3 3.4 3.5 3.6 3.5.1 3.5.2 3.5.3 4. 2011-11-21 WARUNKI KORZYSTANIA Z SYSTEMU ......................................................................................... 7 2.1 2.2 2.3 2.4 3. Marek Michajłowicz Ostatnia modyfikacja: CEL I ZAKRES DOKUMENTU ............................................................................................................ 5 1.1 1.2 1.3 1.4 2. Opis procesu masowego importu danych do systemu PON-on Operacja pobrania słowników importu (UC_Pobierz słowniki) ............................................... 15 Przekazanie pliku importu – wstępna weryfikacja (UC_Przekaż plik importu) ..................... 16 Operacja anulowania importu (UC_Anuluj import) .................................................................. 18 Weryfikacja pliku po wykonanym imporcie (UC_Sprawdź szczegóły importu) ................... 19 Wycofanie pliku importu inicjalnego (UC_Wycofaj import inicjalny) ..................................... 21 FORMAT PRZESYŁANYCH DANYCH ............................................................................................. 23 5.5 Dane wejściowe wymagane w przypadku dodania nowego pracownika naukowodydaktycznego ............................................................................................................................................ 26 5.6 Dane wejściowe wymagane w przypadku aktualizacji danych osobowych pracownika naukowo-dydaktycznego........................................................................................................................... 26 5.7 Dane wejściowe wymagane w przypadku aktualizacji informacji o zatrudnieniu pracownika naukowo-dydaktycznego........................................................................................................................... 27 5.8 Dane wejściowe wymagane w przypadku aktualizacji oświadczenia o minimum kadrowym pracownika naukowo-dydaktycznego ..................................................................................................... 28 5.9 Dane wejściowe wymagane w przypadku aktualizacji informacji o tytułach i stopniach pracownika naukowo-dydaktycznego ..................................................................................................... 28 5.10 Dane wejściowe wymagane w przypadku aktualizacji informacji o funkcjach pracownika naukowo-dydaktycznego........................................................................................................................... 29 5.11 Dane wejściowe wymagane w przypadku aktualizacji danych dotyczących studiów ......... 30 5.12 Dane wejściowe wymagane w przypadku wyrejestrowania studenta z kierunku studiów. 30 Data utworzenia: 2011-07-20 Status: Obowiązujący Strona: 2 / 64 Dokument Utworzył: Opis procesu masowego importu danych do systemu PON-on Marek Michajłowicz Ostatnia modyfikacja: 2011-11-21 Wersja: 2.3.0 5.13 Dane wejściowe wymagane w przypadku przesyłania informacji dotyczącej aktualizacji informacji o pobieranej przez studenta pomocy materialnej ............................................................... 31 6. INFORMACJE DODATKOWE........................................................................................................... 32 7. SYTUACJE SPECYFICZNE ............................................................................................................... 33 5.1 5.2 8. Algorytm identyfikacji operacji na podstawie pliku .................................................................. 33 Algorytm identyfikacji operacji na podstawie pliku .................................................................. 34 SŁOWNIK BŁĘDÓW.......................................................................................................................... 35 Data utworzenia: 2011-07-20 Status: Obowiązujący Strona: 3 / 64 Dokument Utworzył: Opis procesu masowego importu danych do systemu PON-on Marek Michajłowicz Ostatnia modyfikacja: 2011-11-21 Wersja: 2.3.0 Metryka dokumentu Historia dokumentu Data 20.07.2011 25.07.2011 Wersja 1.0.0 1.1.0 Autor Marek Michajłowicz Marek Michajłowicz 28.07.2011 19.08.2011 26.09.2011 1.1.1 1.2.0 2.1.0 Marek Michajłowicz Marek Michajłowicz Marek Michajłowicz 4.10.2011 13.11.2011 2.2.0 2.2.1 Marek Michajłowicz Marek Michajłowicz 15.11.2011 2.3 Marek Michajłowicz Data utworzenia: 2011-07-20 Status: Opis Pierwszy draft dokumentu Pierwsza wersja dokumentu do recenzji, uwzględniająca zakres wymagany do poprawnego przeprowadzenia pilotażowego wdrożenia importu danych pracowników naukowodydaktycznych Korekta dokumentu Pierwsza wersja dokumentu Aktualizacja dokumentu po wprowadzeniu zmian do specyfikacji plików (na podstawie decyzji Komitetu Sterującego po konsultacji z GIODO) Poprawki redakcyjne Uwzględnienie zmian w zakresie edycji kodów jednostek. Aktualizacja słownika błędów. Aktualizacja słownika błędów. Obowiązujący Strona: 4 / 64 Dokument Utworzył: Opis procesu masowego importu danych do systemu PON-on Marek Michajłowicz Ostatnia modyfikacja: 2011-11-21 Wersja: 2.3.0 1. Cel i zakres dokumentu 1.1 Cel dokumentu Dokument stanowi opis obsługi masowego importu danych z plików do systemu POL-on z pozycji użytkownika posiadającego uprawnienia do wykonywania importu plików w danej jednostce. 1.2 Zakres dokumentu W zakres dokumentu nie wchodzi specyfikacja struktury oraz zakresu danych importowanych w plikach. Zostało to opisane w osobnych dokumentach. 1.3 Powiązane dokumenty Nazwa dokumentu Studenci, Absolwenci i Doktoranci. Import danych zakres Pracownicy naukowi. Import danych - zakres Konta i uprawnienia w systemie POL-on Słowniki importu Pomoc modułu importu opublikowana w formie stron wiki Pomoc w zakresie zastosowania kodów jednostek w imporcie Wersja 1.6 Miejsce przechowywania http://polon.nauka.gov.pl/instrukcjeuzytkownika 1.9 http://polon.nauka.gov.pl/instrukcjeuzytkownika n/d http://polon.nauka.gov.pl/konta-w-systemie n/d http://polon.nauka.gov.pl/instrukcjeuzytkownika http://polon.nauka.gov.pl/dokuwiki/doku.php/i mport n/d n/d http://polon.nauka.gov.pl/dokuwiki/doku.php/k ody_jednostek 1.4 Zastosowane skróty i pojęcia Nazwa Import asynchroniczny XML-Schema(XSD) Data utworzenia: 2011-07-20 Objaśnienie standard służący do definiowania struktury dokumentu XML. Dokumenty zawierające definicje XML Schema zapisuje się zwykle w plikach z rozszerzeniem .xsd (od XML Schema Definition). Status: Obowiązujący Strona: 5 / 64 Dokument Utworzył: Opis procesu masowego importu danych do systemu PON-on Marek Michajłowicz Pracownik Jednostka Data utworzenia: Ostatnia modyfikacja: 2011-11-21 Wersja: 2.3.0 Pracownik naukowo dydaktyczny Uczelnia, instytut naukowy i pomocniczy, jednostka naukowa Polskiej Akademii Nauk, instytut badawczy, państwowa jednostka organizacyjna podległa Ministrowi Sprawiedliwości 2011-07-20 Status: Obowiązujący Strona: 6 / 64 Dokument Utworzył: Opis procesu masowego importu danych do systemu PON-on Marek Michajłowicz Ostatnia modyfikacja: 2011-11-21 Wersja: 2.3.0 2. Warunki korzystania z systemu 2.1 Aktywacja konta Uprawnienia oraz sposób dostępu do systemu opisane zostały w dokumencie Konta i uprawnienia dostępnym w serwisie informacyjnym systemu na stronie http://polon.nauka.gov.pl/konta-w-systemie 2.2 Uprawnienia użytkownika w procesie importu masowego Żeby przeprowadzić import masowy danych z plików XML dla danej jednostki, użytkownik powinien dysponować rolą INST_IMPORT i być przypisany do określonej jednostki organizacyjnej. Import jest możliwy do przeprowadzenia wyłączenie w obrębie jednostki, do której przypisany został użytkownik lub jednostek jej podległych. Rola ta daje również uprawnienie pozwalające modyfikować lokalne kody jednostek i uczelni. 2.3 Akceptacja struktury jednostki Mechanizm importu plikowego dostępny jest wyłącznie dla jednostek organizacyjnych należących do Uczelni / Jednostek Naukowych, dla których potwierdzona została struktura w systemie. Akceptacja struktury Uczelni jest możliwa z poziomu administratora uczelni. Jest to czynność wymagana przed rozpoczęciem importu masowego. 2.4 Bezpieczeństwo danych Komunikacja z systemem POL-on odbywa się poprzez sieć Internet przy użyciu szyfrowanego połączenia SSL. Data utworzenia: 2011-07-20 Status: Obowiązujący Strona: 7 / 64 Dokument Utworzył: Opis procesu masowego importu danych do systemu PON-on Marek Michajłowicz Ostatnia modyfikacja: 2011-11-21 Wersja: 2.3.0 3. Proces importu danych do systemu Niniejszy rozdział zawiera opis procedury masowego importu plików w ujęciu procesowym. 3.1 Ogólne założenia dotyczące importu masowego • • • • • • • 1 Import masowy plików odbywa się w sposób asychroniczny. Proces importu podzielony jest na dwa etapy. Pierwszy etap polega na wgraniu pliku na serwer i wstępnej walidacji struktury oraz zgodności ze schematem XML-Schema. W przypadku prawidłowego przetworzenia plik dodawany jest do kolejki importu, która uruchamiana jest i przetwarzana w okresie zmniejszonej aktywności użytkowników systemu (z reguły w godzinach wieczornych danego dnia). Wynik importu jest przekazywany użytkownikowi w postaci szczegółowego zestawienia dla poszczególnych rekordów z pliku wraz z informacją o zakresie wprowadzonych do systemu zmian. Pliki importu powinny być najpierw skompresowane do formatu .zip Maksymalny rozmiar pliku importu nie powinien przekroczyć wartości zdefiniowanej parametrem systemowym. Korekta danych prawidłowo zaimportowanych do systemu jest przeprowadzana na zasadach identycznych, jak pierwsze wgranie danych. Jej wykonanie odbywa się poprzez ponowne wgranie odpowiednio poprawionego pliku. Korekta polega na zastąpieniu poprzednio wysłanych danych danymi skorygowanymi. Import ma charakter przyrostowy. System na bazie zawartości pliku rozpoznaje określony typ operacji: dodania, aktualizacji, usunięcia z rejestru informacji o studencie, doktorancie, pracowniku. W przypadku importów dokonywanych w zbliżonym okresie czasu, obejmujących ten sam zakres danych, obowiązuje reguła „ostatni wygrywa”. Kolejny plik importu nadpisuje import poprzedni. Ta reguła jest rozstrzygająca również w przypadku plików importu zgłoszonych w tej samej kolejce z różnych instytucji, odwołujących się do wspólnego obszaru danych, w szczególności podstawowych danych osobowych pracownika, doktoranta lub studenta. Plik importu wczytywany jest do systemu wyłącznie wtedy, gdy w pełnym zakresie przejdzie proces walidacji. Żaden pojedynczy rekord pliku nie może mieć błędów zdefiniowanych w systemie jako odrzucające plik1. W przypadku błędów formalnych nie powodujących zaburzenia struktury danych w systemie stosuję się kwalifikację Patrz: Słownik błędów Data utworzenia: 2011-07-20 Status: Obowiązujący Strona: 8 / 64 Dokument Utworzył: • Opis procesu masowego importu danych do systemu PON-on Marek Michajłowicz Ostatnia modyfikacja: 2011-11-21 Wersja: 2.3.0 jako ostrzeżenia i kontynuuje dalej proces importu danych. Błędy i ostrzeżenia wyodrębnione w procesie analizy opisane zostały w słowniku błędów. Ze względów bezpieczeństwa w komunikacji pomiędzy systemem POL-on a systemami uczelnianymi nie wykorzystuje się kluczy systemowych. Sposób identyfikacji jednostek w systemie opisany został szczegółowo w punkcie 3.2 Identyfikatory jednostek • • Pierwszy import danych do systemu, przeprowadzany w okresie 01.08.2011 do 01.10.2011 r oznaczany jest w systemie jako import inicjalny. Istnieje możliwość wycofania zmian wprowadzonych do systemu w ramach importu inicjalnego. Nazwa składowych plików importu powinna zawierać rozszerzenie .xml. 3.2 Identyfikatory jednostek Jednostki będą identyfikowane unikatowym kluczem (globalnym, ukrytym), ale zostanie udostępnione pole, w którym uczelnie będą mogły trzymać własny klucz lokalny (sprawdzana będzie jedynie unikatowość pola w ramach uczelni). Pozwoli to uczelniom na operowanie w plikach z danymi kluczem lokalnym bez konieczności wprowadzania do bazy uczelnianej klucza globalnego. Klucz lokalny będzie wprowadzany bezpośrednio przez interfejs webowy (pole do edycji). Identyfikatory jednostek, do których Administrator Importu posiada uprawnienia są zrzucane w ramach plików dostępnych w słownikach importu. 3.3 Ustalenia dotyczące edycji kodów jednostek w systemie POL-on 1. Zmiana kodów jednostek była dopuszczalna tylko na okres porządkowania danych migrowanych z systemu Uczelnia oraz wzajemnego dostosowania systemu POL-on i systemów wewnętrznych uczelni i jednostek naukowych 2. Po zakończeniu okresu dostosowawczego oraz poprzez zatwierdzenie struktury instytucji zablokowana zostanie możliwość zmiany raz wprowadzonego kodu jednostki 3. Kod jednostki będzie można wprowadzić tylko podczas tworzenia nowej jednostki w systemie, a jego zmiana nie będzie później możliwa - wnioski kierowane do ministerstwa i CK o utworzenie nowej jednostki podstawowej powinny zawierać kod jednostki, jeżeli go nie będzie zostanie on nadany arbitralnie przez pracownika ministerstwa/CK – nie będzie możliwości zmiany tego kodu. 4. Kody jednostek przekształconych i likwidowanych pozostają niezmienione. Data utworzenia: 2011-07-20 Status: Obowiązujący Strona: 9 / 64 Dokument Utworzył: Opis procesu masowego importu danych do systemu PON-on Marek Michajłowicz Ostatnia modyfikacja: 2011-11-21 Wersja: 2.3.0 5. Kod jednostki głównej musi być unikatowy w ramach systemu, a kod jednostki podrzędnej w ramach instytucji – dotyczy to również jednostek przekształconych/zlikwidowanych. 6. Zmiana nazwy jednostki, która nie wynika z jej przekształcenia, nie będzie powodować zmiany kodu jednostki, a o pokazywanej w systemie nazwie jednostki będzie decydować data wynikająca z kontekstu opisywanego elementu – w strukturze jednostki będzie to data dla której chcemy strukturę zobaczyć, dla nadanego stopnia będzie to data nadania stopnia itp. 7. Tymczasowe rozwiązanie „zatwierdzenie struktury instytucji” i jego „odblokowanie” zostanie usunięte z aplikacji po okresie wstępnym (najpóźniej do końca listopada 2011) i wprowadzeniu do systemu mechanizmu „przekształcenia instytucji”. 3.4 Słowniki importu Na ich podstawie odbywa się weryfikacja plików XML. Słowniki importu udostępniane użytkownikowi zalogowanemu zawierają najaktualniejszą wersję schematów XSD, pobraną bezpośrednio z serwera aplikacji. Szczegółowy opis zakresu i wykorzystania słowników importu dostępny jest w serwisie pomocy pod adresem: http://polon.nauka.gov.pl/dokuwiki/doku.php/slowniki_importu 3.5 Terminy przekazywania danych • • Do rejestru studentów: w terminie do 15 listopada i do 15 marca, stan na dzień 30 października oraz 1 marca) Do rejestru pracowników: jednostka ma 30 dni na wprowadzenie danych od dnia otrzymania kodu; minister ma 20 dni na przyznanie kodu od dnia wejścia w życie rozporządzenia ; Rozporządzenie wchodzi w życie 1 października 2011 (Par. 9). Data utworzenia: 2011-07-20 Status: Obowiązujący Strona: 10 / 64 Dokument Utworzył: Opis procesu masowego importu danych do systemu PON-on Marek Michajłowicz Ostatnia modyfikacja: 2011-11-21 Wersja: 2.3.0 3.6 Proces importu 3.5.1 Stany importu stm DST_Stany Importu pliku . [Błędny format] /Odrzuć [Poprawny format] Wstepnie w eryfikow any [Bledna Walidacj a] /Odrzuć Odrzucony [Prawidlowa wstepna walidacja] /Przekaż do i mportu Przekazany do zaimportow ania Anulow any /Anuluj /Do kolej ki importu Importow any [Wystąpił y bł ędy] Import błędny [Brak błędów] /Zakończ i mport Import popraw ny Data utworzenia: 2011-07-20 Status: Obowiązujący Strona: 11 / 64 Dokument Utworzył: Opis procesu masowego importu danych do systemu PON-on Marek Michajłowicz Stan Wstępnie weryfikowany Przekazany do zaimportowania Odrzucony Anulowany Importowany Import błędny Import poprawny Wycofany Ostatnia modyfikacja: 2011-11-21 Wersja: 2.3.0 Objaśnienie Plik prawidłowo przeszedł etap wstępnej walidacji struktury wg XML-Schema. Następnym etapem weryfikacji jest m.in. sprawdzenie zakresu zmian przekazanych w pliku pod kątem poziomu uprawnień użytkownika. Plik w pełni przeszedł proces wstępnej walidacji. Znajduje się w kolejce plików do zaimportowania, oczekując na rozpoczęcie procesu importu. Plik nie przeszedł etapu wstępnej walidacji Import anulowany na żądanie użytkownika Stan pośredni. Plik jest przetwarzany w trakcie trwającego procesu importu W trakcie procesu importu wystąpiły błędy rekordów, które spowodowały odrzucenie pliku Import zakończony wynikiem pozytywnym. Brak błędnych rekordów w pliku. Zmiany wprowadzone do systemu Import wycofany na żądanie użytkownika w ramach importu inicjalnego 3.5.2 Etap wstępnej walidacji plików Data utworzenia: 2011-07-20 Status: Obowiązujący Strona: 12 / 64 Dokument Utworzył: Opis procesu masowego importu danych do systemu PON-on Marek Michajłowicz Ostatnia modyfikacja: 2011-11-21 Wersja: 2.3.0 act Proces importu biznesow y Logow anie Kontekst instytucji [Instytucj a główna] [Instytucja podrzędna] Czy zatwierdzona struktura instytucj i? Zatw ierdź strukturę Czy zatwierdzona struktura instytucj i? [NIE] Dodaj now y plik [TAK] Pl ik XML Plik XML Lokalizuj plik Pow iadom o konieczności zmniej szenia rozmiaru pliku [rozmi ar > MAX_XML_FILE_SIZE] [rozmiar pliku < MAX_XML_FILE_SIZE] «stream» Wstępna w alidacj a Rozpakow anie pliku Weryfikacj a rozszerzenia Weryfikacj a kodow ania pliku Weryfikacj a zgodności ze schematem XML Weryfikacj a upraw nień użytkw onika do aktualizacj i danych w obrębie instytucj i Translacj a kodu instytucj i z pliku na ID z bazy Generuj kod błędu «datastor... Raport błędów Generuj błąd [Bł ąd [OK] walidacji] Pli k XML Zmień status na Odrzucony Dodaj do kolej ki Zmień stan importu pliku na Przekazany do zaimportow ania Uruchomienie importu Termin importu Data utworzenia: 2011-07-20 Status: Obowiązujący PRC02_Proces Importu Plików Strona: 13 / 64 Dokument Utworzył: Opis procesu masowego importu danych do systemu PON-on Marek Michajłowicz Ostatnia modyfikacja: 2011-11-21 Wersja: 2.3.0 3.5.3 Etap importu plików act PRC02_Proces Importu Plików Zmiana stanu pliku na Importow any «iterativ e» Przetw arzanie rekordów pliku Algorytm identyfikacj i osoby Pracownik Student Pracownik Student Identyfikuj typ operacj i i w ykonaj zmianę [Wystąpiły błędy] Zapisz kod błędu Zmień status Import błędny «datastore» Raport Błędów importu [Brak błędów] Import popraw ny Data utworzenia: 2011-07-20 Status: Obowiązujący Strona: 14 / 64 Dokument Utworzył: Opis procesu masowego importu danych do systemu PON-on Marek Michajłowicz Ostatnia modyfikacja: 2011-11-21 Wersja: 2.3.0 4. Scenariusze użytkowania systemu W niniejszym rozdziale opisano scenariusze interakcji użytkownika z systemem, mające stanowić instrukcję postępowania w określonych sytuacjach zdefiniowanych na etapie analizy (na bazie przypadków użycia). 4.5 Operacja pobrania słowników importu (UC_Pobierz słowniki) Słowniki importu opublikowane zostały w systemie w formie archiwum plików zip. Użytkownik ma możliwość pobrania archiwum prosto ze strony głównej widoku importów. Warunki początkowe: 1. Użytkownik jest zalogowany do systemu i posiada rolę INST_IMPORTY. 2. W widoku listy plików importowanych do systemu jest dostępny przycisk o nazwie pobierz słowniki importu. Warunki końcowe: 1. Słowniki wyeksportowane do pliku .zip Scenariusz Główny 1. Użytkownik klika przycisk pobierz słowniki importu 2. System generuje plik zawierający dane słowników importu 3. System kompresuje pliki do formatu .zip 4. System prosi Użytkownika o wskazanie ścieżki zapisu pliku 5. Użytkownik wskazuje lokalizację 6. System zapisuje plik we wskazanej lokalizacji Informacje dodatkowe • Słowniki są zrzucane w formie paczki .zip zawierającej pojedyncze pliki • Słownik kodów instytucji i kierunków zawiera wszystkie kody instytucji i kierunków istniejących w danej Uczelni / Instytucji Naukowej oraz Kody wszystkich jednostek dostępnych w systemie • Słowniki importu zrzucane są w formie pliku .xds • Kody jednostek i kierunków zrzucane są w formacie .csv Data utworzenia: 2011-07-20 Status: Obowiązujący Strona: 15 / 64 Dokument Utworzył: Opis procesu masowego importu danych do systemu PON-on Marek Michajłowicz Ostatnia modyfikacja: 2011-11-21 Wersja: 2.3.0 4.6 Przekazanie pliku importu – wstępna weryfikacja (UC_Przekaż plik importu) Scenariusz opisujący sposób przekazania plików importu do systemu. Wyzwalacze: • Czas przed upływem ustawowych terminów przekazania informacji o studentach zapisanych na nowy semestr studiów. • Termin do 5 dni roboczych od momentu pozyskania informacji o zatrudnieniu / zmianie danych pracownika naukowo-dydaktycznego Warunki początkowe: 1. Użytkownik jest zalogowany do systemu i posiada rolę INST_IMPORTY 2. Użytkownik może dokonywać importu danych wyłącznie w obszarze instytucji, do której jest przypisany. W przypadku przypisania do jednostki nadrzędnej użytkownik dziedziczy uprawnienia w dół, na wszystkie jednostki podrzędne. 3. Użytkownik dysponuje plikiem w formacie XML zgodnym ze schematem plików XML-Schema udostępnionym przez OPI. Plik kodowany w standardzie "UTF-8" 4. Użytkownik skompresował pliki importu do formatu .zip 5. W systemie nie jest wykonywany aktualnie proces importu danych dla instytucji, w której zalogowany jest użytkownik. Na liście importu plików przypisanych do danej instytucji nie znajduje się w danym momencie żaden plik ze statusem importowany 6. W systemie jest wprowadzona prawidłowa lista kierunków, która została potwierdzona przez Administratora Uczelni (w przypadku braku potwierdzenia struktury, patrz: scenariusz alternatywny A3 - Niezatwierdzona struktura instytucji ) 7. Użytkownik dysponuje informacją o sumie kontrolnej pliku (MD5). Informacja ta może posłużyć do prawidłowej weryfikacji pliku wgranego przez system na serwer w procesie importu. 8. Plik importu nie może przekraczać rozmiaru określonego w systemie odpowiednim parametrem systemowym. Scenariusz Główny 1. Użytkownik loguje się do systemu 2. Użytkownik wybiera pozycję Importy z menu głównego 3. System wyświetla stronę prezentującą listę plików zaimportowanych do systemu w danej instytucji. 4. Użytkownik wybiera opcję importuj plik 5. System wyświetla stronę okno do wstawienia ścieżki pliku. Okno zawiera również pole z listą instytucji, do których użytkownik posiada uprawnienia importu. Data utworzenia: 2011-07-20 Status: Obowiązujący Strona: 16 / 64 Dokument Utworzył: Opis procesu masowego importu danych do systemu PON-on Marek Michajłowicz Ostatnia modyfikacja: 2011-11-21 Wersja: 2.3.0 6. Użytkownik podaję lokalizację pliku, wypełnia opis i wskazuje instytucję, dla której przeprowadzany będzie import, a następnie zatwierdza operację 7. System pobiera plik na serwer 8. System wyświetla informację o sumie kontrolnej pobranego pliku w celu umożliwienia Administratorowi Instytucji prawidłowej identyfikacji przekazanego pliku 9. System prosi Użytkownika o potwierdzenie operacji 10. Użytkownik potwierdza operację 11. System rozpoczyna wstępną walidację 12. System zwraca użytkownikowi informację o poprawności wstępnej weryfikacji pliku. 13. System zmienia status pliku na Wstępnie weryfikowany 14. System dokonuje dalszej weryfikacji pliku 15. System po poprawnym przetworzeniu dodaje plik do kolejki importu. Następuje zmiana statusu na Przekazany do zaimportowania 16. System wysyła na adres Administratora Instytucji wiadomość o zmianie statusu 17. System dodaje pozycję importu ze statusem ‘przekazany do zaimportowania’ do listy importu. Plik oczekuje na rozpoczęcie procesu importu. Scenariusz alternatywny A1 - plik importu dla instytucji spoza zakresu uprawnień administratora • W przypadku wystąpienia w pliku odwołania do instytucji (np. kodów kierunków, uczelni lub innych jednostek) nie będących w obszarze uprawnień danego Administratora, plik importu zostanie w całości odrzucony. Przyczyna odrzucenia wraz ze wskazaniem błędnych rekordów z pliku jest dostępna w szczegółach danego importu. Scenariusz alternatywny A2 - Wykryto błędy wstępnej walidacji pliku podczas wgrywania na serwer • W wyniku wstępnej walidacji wystąpił błąd. • System wyświetla Użytkownikowi komunikat o błędzie. • System zmienia status pliku na Odrzucony • Użytkownik wybiera opcję Pokaż szczegóły dla danego pliku importu • System prezentuje szczegółowy komunikat błędu • Użytkownik wybiera opcję Zrzut do pliku i podaje lokalizację zapisu • System generuje plik z logami błędów we wskazanej przez użytkownika lokalizacji Scenariusz alternatywny A3 - Niezatwierdzona struktura instytucji • W przypadku nie zatwierdzenia w systemie struktury organizacyjnej danej jednostki, system uniemożliwia wykonanie importu. • System wyświetla komunikat informujący o braku potwierdzenia struktury jednostki. Treść komunikatu: " Nie potwierdzono prawidłowości struktury jednostki Data utworzenia: 2011-07-20 Status: Obowiązujący Strona: 17 / 64 Dokument Utworzył: Opis procesu masowego importu danych do systemu PON-on Marek Michajłowicz Ostatnia modyfikacja: 2011-11-21 Wersja: 2.3.0 w systemie. Import pliku niemożliwy do wykonania" • Użytkownik potwierdza komunikat. • Zatwierdzenia struktury może dokonać wyłącznie użytkownik, posiadający uprawniania do przeprowadzania importu masowego na poziomie Uczelni. Po potwierdzeniu przez niego struktury Uczelni, w systemie odblokowana zostanie możliwość przeprowadzenie importu. Scenariusz alternatywny A4 - Próba wgrania pliku o rozmiarze przekraczającym określony parametr systemowy • System z przyczyn wydajnościowych kontroluje rozmiar pliku po skompresowaniu i nie dopuszcza do wgrania pliku. Użytkownik jest proszony o podzielenie pliku i ponowne wgranie go na serwer. Scenariusz alternatywny A5 - Próba dodania pliku w trakcie procesu importu • Jeżeli w systemie istnieją pliki o statusie Importowany przypisane do tej samej instytucji, dla której użytkownik chce przeprowadzić import, to system uniemożliwia wprowadzenie kolejnego pliku importu do czasu zakończenia procesu importu. Scenariusz wyjątkowy A6 -Przerwanie sesji użytkownika • W przypadku przerwania sesji użytkownika w trakcie wykonywania wstępnej weryfikacji pliku, istnieje możliwość ponownego zalogowania, wyszukania pliku na liście importu i sprawdzenia wyniku operacji wraz ze statusem. Proces weryfikacji jest procesem systemowym odbywającym się niezależnie od interakcji z użytkownikiem. Informacje dodatkowe • Administrator Wydziału widzi statusy importu plików dla jednostki, do której jest przypisany. • Administrator Uczelni widzi importy jednostek podległych • Jeżeli w systemie trwa proces importu dla danej jednostki (pliki o statusie przekazany do zaimportowania, zaimportowany), to użytkownik nie ma możliwości dodawania danych z interfejsu użytkownika • Użytkownik jest powiadamiany o postępie operacji wstępnej walidacji poprzez pasek postępu. 4.7 Operacja anulowania importu (UC_Anuluj import) Przypadek użycia opisuje funkcjonalność anulowania importu pliku czekającego w kolejce do zaimportowania. Użytkownik może anulować wyłącznie pliki, dla których Data utworzenia: 2011-07-20 Status: Obowiązujący Strona: 18 / 64 Dokument Utworzył: nie Opis procesu masowego importu danych do systemu PON-on Marek Michajłowicz został jeszcze zaimportowania) uruchomiony proces importu Ostatnia modyfikacja: 2011-11-21 Wersja: 2.3.0 (status: przekazany do Warunki początkowe: • W systemie istnieje plik importu o statusie przekazany do zaimportowania. Plik znajduje się w kolejce plików do zaimportowania, która nie została jeszcze uruchomiona. • Użytkownik posiada uprawnienia do importu w obrębie jednostki, do której jest przypisany. Warunki końcowe: • Zmiana statusu importu na <<anulowany>>. Wycofanie dotychczasowych zmian. Scenariusz Główny 1. Użytkownik loguje się do systemu 2. Użytkownik wywołuje z menu głównego pozycję Importy 3. System wywołuje stronę prezentującą listę importów przypisanych do danej instytucji 4. Użytkownik wybiera na liście szczegóły pliku importu o statusie przekazany do zaimportowania 5. System udostępnia opcję Anuluj dla wskazanego pliku 6. Użytkownik wybiera opcję Anuluj 7. System wyświetla komunikat żądający od Administratora Instytucji potwierdzenia operacji wraz z polem opisowym do podania przyczyny wykonania zmian. Komunikat zawiera ostrzeżenie o nieodwracalności wykonania czynności 8. Użytkownik wypełnia opis i potwierdza operację 9. System zmienia status importu na Anulowany 10. System usuwa plik z kolejki plików przeznaczonych do importu. 4.8 Weryfikacja pliku po wykonanym imporcie (UC_Sprawdź szczegóły importu) Import pliku przeprowadzany jest poprzez mechanizm kolejkowania, bazujący na weryfikacji szacunkowego czasu przetworzenia plików w oparciu o parametr liczby plików będących aktualnie w kolejce do zaimportowania. Szacunkowa informacja o terminie zakończenia importu przekazywana jest użytkownikowi w szczegółach importu. Po przetworzeniu pliku w ramach procesu importu na adres e-mail Administratora wysyłana jest wiadomość informująca o wyniku operacji. Import może zakończyć się wynikiem pozytywnym, skutkującym zmianą stanu pliku na import poprawny, w którego wyniku zmiany wprowadzone zostają do bazy danych lub Data utworzenia: 2011-07-20 Status: Obowiązujący Strona: 19 / 64 Dokument Utworzył: Opis procesu masowego importu danych do systemu PON-on Marek Michajłowicz Ostatnia modyfikacja: 2011-11-21 Wersja: 2.3.0 wynikiem negatywnym skutkującym zmianą stanu na import błędny i nie wprowadzeniu żadnych zmian do systemu. Warunki początkowe: • Użytkownik jest zalogowany do systemu i ma rolę INS_IMPORT • W systemie istnieją pliki importu ze statusem Import poprawny lub Import błędny Warunki końcowe: • Wygenerowany raport importu opisujący szczegółowy wynik importu w postaci widoku listy pojedynczych rekordów z pliku wraz ze statusem i szczegółową informacją o wyniku importu Scenariusz Główny 1. Użytkownik loguje się do systemu 2. Użytkownik wywołuje z menu głównego Importy/Lista importów 3. System wyświetla stronę prezentującą listę plików zaimportowanych do systemu 4. Użytkownik wybiera szczegóły pliku o statusie Import poprawny 5. System wyświetla widok listy prezentującej szczegółowy wynik importu poszczególnych rekordów w ramach pliku 6. Użytkownik sortuje listę według dostępnych kolumn 7. Użytkownik ma możliwość filtrowania rekordów przy użyciu dostępnego filtru 8. Użytkownik ma możliwość zrzucenia widoku listy do pliku xls 9. Użytkownik ma możliwość szczegółowego podglądu historii przetwarzania pliku na zakładce historia importu Informacje dodatkowe • Administrator widzi statusy importu plików dla jednostki, do której jest przypisany. • Administrator jednostki głównej widzi importy jednostek podległych • Istnieje możliwość zrzutu widoku listy do pliku w formacie .xls Scenariusz alternatywnyA1- Przeglądanie szczegółów importu o statusie Import błędny 1. Użytkownik wybiera szczegóły pliku o statusie Import błędny 2. System wyświetla szczegółowy wynik importu w formie zestawienia 3. System wyświetla rekordy z pliku w porządku wg statusu - najpierw prezentowane są rekordy ze statusem błędny. Przy każdym błędnym rekordzie znajduje się kod błędu (patrz: słownik błędów) 4. System odznacza rekordy błędne kolorem czerwonym 5. Użytkownik sortuje listę wg dostępnych kolumn 6. Użytkownik odfiltrowywuje określone rekordy wg zadanych kryteriów 7. Użytkownik zrzuca widok listy do pliku Data utworzenia: 2011-07-20 Status: Obowiązujący Strona: 20 / 64 Dokument Utworzył: Opis procesu masowego importu danych do systemu PON-on Marek Michajłowicz Ostatnia modyfikacja: 2011-11-21 Wersja: 2.3.0 Wymagania dodatkowe • Administrator widzi statusy importu plików dla jednostki, do której jest przypisany. • Administrator jednostki głównej widzi importy jednostek podległych • Możliwość zrzutu widoku listy do pliku w formacie .xls 4.9 Wycofanie pliku importu inicjalnego (UC_Wycofaj import inicjalny) Operacja wycofania importu inicjalnego jest możliwa do przeprowadzenia wyłącznie w okresie pilotażu, czyli do daty 1.10.2011 r. Każdym z plików prawidłowo zaimportowanych do systemu w tym okresie może być wycofany przez użytkownika. Operacja wycofania przywraca stan bazy do momentu sprzed wykonania importu i usuwa zmiany wprowadzone do systemu. Warunki początkowe: • Użytkownik powinien być zalogowany do systemu i posiadać rolę INS_IMPORT • W systemie istnieją pliki importu ze statusem Import poprawny • Nie upłynął jeszcze termin 1.10.2011 r. – import ma flagę określającą go jako import inicjalny Warunki końcowe: • Plik wycofany z systemu. Wszystkie zmiany wprowadzone w procesie importu usunięte z systemu za wyjątkiem zmian dotyczących danych osoby, dla której istnieje relacja do jeszcze innej jednostki w systemie. Scenariusz Główny 1. Użytkownik loguje się do systemu 2. Użytkownik wywołuje z menu głównego Importy/Lista importów 3. System wyświetla stronę prezentującą listę plików zaimportowanych do systemu 4. Użytkownik wybiera opcję Wyczyść dane testowe 5. System wyświetla komunikat żądający od Administratora Instytucji potwierdzenia operacji wraz z polem opisowym do podania przyczyny wykonania zmian. Komunikat zawiera ostrzeżenie o nieodwracalności wykonania czynności 6. System usuwa wszystkie dane wprowadzone dla danej instytucji 7. System zmienia status importu na Wycofany Wymagania dodatkowe • Administrator Wydziału widzi statusy importu plików dla jednostki, do której jest przypisany i może wycofać tylko te importy, które dotyczą jego jednostki Data utworzenia: 2011-07-20 Status: Obowiązujący Strona: 21 / 64 Dokument Utworzył: Opis procesu masowego importu danych do systemu PON-on Marek Michajłowicz Ostatnia modyfikacja: 2011-11-21 Wersja: 2.3.0 • Administrator Jednostki Głównej widzi statusy importu plików dla jednostki, do której jest przypisany oraz jednostek podległych i może wycofać import każdej jednostki podległej, do której ma uprawnienia. Data utworzenia: 2011-07-20 Status: Obowiązujący Strona: 22 / 64 Dokument Utworzył: Opis procesu masowego importu danych do systemu PON-on Marek Michajłowicz Ostatnia modyfikacja: 2011-11-21 Wersja: 2.3.0 5. Format przesyłanych danych Szczegółowy zakres i format przesyłanych danych opisany został w dokumentach specyfikacji danych 2 . Poniższy rozdział stanowi instrukcję tworzenia rekordów w plikach XML , tak by przeprowadzić przy użyciu pliku importu masowego operacje określonego typu w strukturze danych systemu POL-on. W tym celu zidentyfikowano listę najczęściej występujących operacji biznesowych na strukturze danych pracowników naukowo-dydaktycznych, studentów i doktorantów, a następnie wyspecyfikowano pod tym kątem oczekiwaną zawartość plików XML. Zaproponowana struktura plików importu bazuje na założeniu przeprowadzenia częściowej replikacji danych pomiędzy systemami, a następnie potraktowanie zakresu danych w pliku jako parametrów wejściowych do wywołania określonych funkcji (metod biznesowych), np. przekazanie informacji o dacie wyrejestrowania studenta dla osoby już występującej w bazie jest interpretowane przez algorytm importu jako wywołanie operacji usunięcia studenta z określonego kierunku, co implikuje wywołanie zdefiniowanego zestawu reguł walidacyjnych wymaganych do przeprowadzenia w bazie danych systemu określonej transakcji. Struktura plików XML podzielona jest na sekcje określonego typu. Ważne by poszczególne sekcje w ramach jednego rekordu pliku występowały wspólnie, tzn. w przypadku wystąpienia w jednym imporcie danych pracownika zatrudnionego jako pracownik naukowych oraz dydaktyczny, powinien to być jeden rekord zawierający odpowiednie sekcje ze współdzielonym zakresem danych osobowych. W przypadku przesłania przez jednostkę pliku z danymi nie różniącymi się od aktualnie posiadanych w systemie, nie jest wykonywana żadna operacja, a więc rekord nie zostaje uwzględniony. Dlatego tez przesłanie pliku różniącego się od poprzedniego jedynie niektórymi wierszami powoduje wykonanie operacji aktualizacji jedynie dla tych wierszy, które niosą za sobą faktyczne zmiany. Korekta danych prawidłowo zaimportowanych do systemu jest przeprowadzana na zasadach identycznych, jak pierwsze wgranie danych. Jej wykonanie odbywa się poprzez ponowne wgranie odpowiednio poprawionego pliku. Korekta polega na zastąpieniu poprzednio wysłanych danych danymi skorygowanymi. 2 Patrz: rozdział 1.1 Powiązane dokumenty Data utworzenia: 2011-07-20 Status: Obowiązujący Strona: 23 / 64 Dokument Utworzył: Opis procesu masowego importu danych do systemu PON-on Marek Michajłowicz Ostatnia modyfikacja: 2011-11-21 Wersja: 2.3.0 Mechanizm importu danych z pliku opracowany został w zamyśle jako rozwiązanie masowego zasilenia systemu danymi o studentach i pracownikach naukowo-dydaktycznych. W przypadku zmian jednostkowych sugerowanym rozwiązaniem jest edycja danych bezpośrednio z poziomu interfejsu użytkownika. W przypadku stwierdzenia występowania informacji określonego typu w systemie (np. informacja o przypisaniu studenta do określonego kierunku studiów), wykonywana jest operacja aktualizacji już istniejących danych. Jej wynik zależy od poprawnego zidentyfikowania określonego rekordu w systemie, dla którego kluczowy jest zestaw parametrów identyfikacyjnych. Poniżej przedstawione zostały główne metody biznesowe zidentyfikowane w ramach analizy wraz z parametrami wywołującymi. Szczegółowy na bieżąco aktualizowany wykaz metod wykonywanych podczas importu znajduje się na stronach pomocy kontekstowej pod adresem: http://polon.nauka.gov.pl/dokuwiki/doku.php/operacje_wykonywane_poprzez_pliki Data utworzenia: 2011-07-20 Status: Obowiązujący Strona: 24 / 64 Dokument Utworzył: Opis procesu masowego importu danych do systemu PON-on Marek Michajłowicz Ostatnia modyfikacja: 2011-11-21 Wersja: 2.3.0 Rys. Diagram klas biznesowych przekazywanych w plikach XML. Na podstawie specyfikacji danych importowanych do systemu. Patrz: http://polon.nauka.gov.pl/instrukcje-uzytkownika class ML_SchematXML Słowniki «Dane XML» kandydaciIPrzyj eciNaStudiaDrugiegoStopnia «dictionary» Obyw atelstw o – typ «Dane XML» Osoba + + + - «Dane XML» pracow nikDydaktycznoNaukow y dataNadania: int «enum» + dziedzDyscKl asyfKod: char + dziedzi naKod: char + tytul NaukowyKod: char = {Prof} 0..* 1 + + + 1 - emeryt: boolean emerytOdKiedy: date zmarl: boolean zmarlData: date + Weryfikuj Zgodnosc() : voi d Aktual izujIstniejacyTytulNaukowy() : void DodajNowyTytulNaukowy() : void {1 nstopienNaukowyKod = 1 dyscypl inaKod} «Dane XML» Nauczyciel akademicki + «Dane XML» EN-1 - Spraw ozdanie o liczbie kandydatów i przyj ętych na studia: - «dictionary» specj alizacja: int «Dane XML» Student DodajNowyStopien() : void + + 1 1..* Aktual izujUprawni eniaDoStopni () : void Aktual izujZatrudnienieAktywne() : void Aktual izujZatrudnienieHi storyczne() : void Dodaj Zatrudnienie() : voi d Weryfi kuj PrzypisanieDoInstytucji() : void Weryfi kuj Wieloetatowość () : void ZakonczZatrudnienie() : void + + + + + + + + + dataOswiadczenia: date dataPrzypisania: date ki erunekInstancja01Id: i nt ki erunekInstancja02Id: i nt l iczbaGodzinZaj ecDydakt: int rokAkademi cki: int «dictionary» + stopienStudiow: char = {I, II, I + II, JM} + Defi ni cja kierunku instytucjaId: i nt nazwaKierunku: char nazwaUczel ni : char rokUkonczenia: char dataWyrejestrowani aStudenta: date dataZarej estrowaniaStudenta: date l iczbaWol nychPunktowEcts: i nt l imi tPunktowEcts: i nt pi erwszyKierunek: char = {T/N} sumaPunktowEcts: int + + + + + + 1..* Aktuali zuj Tytul (int, int) Dodaj Tytul(int, int) SprawdzPrzypi sani eKierunku() : bool ean SprawdzPrzypi sani eUczel ni () : boolean «Dane XM L» Kierunek + + 1 2 formaStudi ow: char kierunekId 1..* «dicti onary» specj al nosc: char 0..* DodajDoMi ni mum() : void «Dane XML» PomocMaterialna + 0..1 1 «Dane XML» pracow nik naukow y {Optional } 0..* «Dane XML» Upraw nienia do nadaw ania stopnii instytucjaId: i nt pobi eraPomocMateri al na: bool ean «dictionary» rodzajPrzyznanychSwiadczen: char + + 1..* 1 «Dicti onary XSD» nauczycielAkademickiKod - Dydaktyczny Dyplomowany bibli otekarz. DyplPracDokInfNauk Naukowo-dydaktyczny. Naukowy «Di ctionary ... funkcj aKod AktualizujPrzyznanaPomoc() : void WeryfikujPrzyznanaPomoc() : void «Di ctionary XSD» tytulZaw odow yKodTyp - Inżyni er Inżyni er architekt Inżyni er architekt kraj obrazu Inżyni er pożarni ctwa Lekarz Lekarz dentysta Lekarz weterynarii Licencjat Licencjat pielęgniarstwa Licencjat poł ożnictwa Magi ster Magi ster farmacji Magi ster inżynier Magi ster inżynier architekt Magi ster inżynier architekt krajobrazu Magi ster inżynier pożarnictwa Magi ster pi el ęgniarstwa Magi ster położnictwa Magi ster sztuki Uczelnia dataDo: date dataOd: date unsDyscyplinaKod unsDziedzDyscKlasyfKod Instytut naukow y «Dane XML» pracow nikNaukow yZatrudnienie + + + + - dataDo: date dataOd: date i nstytucjaId: int stanowiskoDataObjecia: date stanowiskoNazwa: char unsDyscypli naKod: char unsDzi edzDyscKlasyfKod: char wymiarCzasuPracyCalosc: int wymiarCzasuPracyCzesc: int + + dataDo: date dataOd: date funkcj aOpi s: char instytucjaId: i nt «di ctionary» + funkcj aKod: char funkcj aNazwa: char Status: + + + Aktuali zuj Funkcje() : voi d Dodaj DoSl owni ka() : void Dodaj Funkcje() : void Obowiązujący Podstaw ow a j ednostka organizacyj na «Dicti onary XSD» stanow iskoNA - «enum» funkcj aKierowni cza: bool ean = {T/N} «enum» podstDodMiejscePracyKod: char = {podstawowe/dod... 2011-07-20 M iędzynarodow y instytut naukow y «Dane XML» Funkcj a «di ctionary» + formaZatrKod: char + rodzajCzasUmowyKod: char stanowiskoKod: char + wymiarCzasuPracyKod: char Data utworzenia: + +Zatrudnia +Zatrudniony Czł onek Prezydium Czł onek Prezydium Honorowy Dyrektor Instytutu Dzi ekan Dzi ekan (p.o.) Kierownik Podstawowej Jednostki Organizacyj nej Kwestor Prodzi ekan Prorektor Rektor Sekretarz Naukowy Wicedyrektor instytutu Wiceprezes Zastępcy Kierowni ka Podstawowej Jednostki Organizacyjnej Aktuali zuj ECT S() : void DodajStudenta() : voi d PrzepiszNaKol ej nySemestr() : void WeryfikacjaOswiadczeniaStudenta() : void WeryfikujOdplatnoscZa2Kierunek() : void Wyrej estrujStudenta() : void JednostkaOrganizacyj na + + + «Dictionary XSD» stanow iskoPNKodTyp «Dicti onary XSD» pracow nikNaukow yZatrudnienieTyp «di ctionary» + stopi enStudi ow: char «enum» + tytulZawodowyKod: char «Dane XML» MinimumKadrow e «enum» podstDodMi ej scePracyKod: char = {podstawowe/dod... + + + + + 1..* - «Dane XML» daneDotyczaceStudiow zwol ni onyZOplatZaStudia: char «Dane XML» Tytuł zaw odow y dataDo: date dataOd: date instytucj aId: i nt stanowiskoDataObj eci a: date wymi arCzasuPracyCzesc: i nt zgodaRektDodZatrData: date ki erunek: int «enum» + formaStudi ow: char = {Stacjonarne, N... dataUzyskani aStopni a: date dataWszczeciaPrzewodu: date dyscypl inaKod: char dziedzDyscKl asyfKod: char instytucj aNadajNostrId: int instytucj aNostrZagr: char 0..* «dicti onary» + formaZatrKod: char + nauczycielAkademicki Kod: char + rodzaj CzasUmowyKod: char + stanowiskoKod: char + wymi arCzasuPracyKod: char + + + + + + + + + + + - «enum» + specj al noscKod: char + stopienNaukowyKod: char = {Dr;DrHab} + trybNadaniaKod: char 1..* «Dane XML» nauczycielAkademickiZatrudnienie + + - «Dicti onary» Dyscypliny «Dicti onary XSD» funkcj aOsobyWInstytucj i Aktuali zuj DaneOsobowe() : voi d DodajOsobe() : voi d KojarzOsobe() : void «Dane XML» Stopień naukow y 1 0..1 + + «Dane XM L» kandydaciIPrzyj eciNaPierw szyRokStudiow «enum» + pl ec: char = {K/M } «Dane XML» Tytuł naukow y + cudzozi emi ec: boolean = {T/N} dokTozsamRodzaj: char Imie: char i mie2: char Nazwisko: char PESEL: char prefixNazwi ska: char «dictionary» rodzaj PrzyznanychSw iadczen Strona: 25 / 64 Adiunkt: char AdiunktBi blioteczny: char AdiunktDokumentacj i: char Asystent: char AsystentBibli oteczny: char AsystentDokumentacji: char Docent: char Dokumentali staDyplomowany: char Instruktor: char KustoszDyplomowany: char Lektor: char ProfesorNadzwyczajny: char ProfesorWi zytujacy: char ProfesorZwyczajny: char StarszyDokumentali staDyplomowany: char StarszyKustoszDyplomowany: char Wykladowca: char Dokument Utworzył: Opis procesu masowego importu danych do systemu PON-on Marek Michajłowicz Ostatnia modyfikacja: 2011-11-21 Wersja: 2.3.0 5.5 Dane wejściowe wymagane w przypadku dodania nowego pracownika naukowo-dydaktycznego Struktura pliku XML w przypadku przekazania w pliku informacji o dodaniu nowego pracownika naukowego powinna zawierać jako niezbędne minimum sekcje: • Osoba/danePodstawowe – zakres wymagalności pól zgodny ze schematem XMLSchema • pracownikNaukowyZatrudnienie lub nauczycielAkademickiZatrudnienie – wystąpienie przynajmniej jednej z tych sekcji jest wymagane do poprawnego zarejestrowania pracownika w systemie W przypadku podania w ramach zatrudnienia nauczyciela akademickiego przypisania do minimum kadrowego wymagane jest podanie informacji którejkolwiek z sekcji: stopień naukowy, tytuł naukowy lub tytuł zawodowy. Pracownik nie może być przypisany do minimum związanego z uprawnieniem jednostki do nadawania stopnia naukowego, jeśli sam nie posiada stopnia naukowego. Pozostałe sekcje są opcjonalne w zależności od posiadania przez jednostkę odpowiedniego zakresu danych wymagalnych. 5.6 Dane wejściowe wymagane w przypadku aktualizacji danych osobowych pracownika naukowo-dydaktycznego Przesłanie pliku różniącego się od poprzedniego jedynie niektórymi wierszami powoduje wykonanie operacji aktualizacji jedynie dla tych wierszy, które niosą za sobą faktyczne zmiany. Do prawidłowego wykonania operacji aktualizacji danych osobowych pracownika naukowo-dydaktycznego wymagany jest zestaw danych umożliwiający przede wszystkim jego prawidłową identyfikację. Minimalną zgodność danych, zapewniającą aktualizacje danych osoby posługującej się numerem PESEL stanowi tenże oraz pierwsze imię. Dodatkowe kryterium weryfikacyjne stanowić będzie informacja o posiadanych tytułach zawodowych (sekcja XML: tytulZawodowy), tytule naukowym (tytulNaukowy) lub stopniu naukowym (sekcja: stopienNaukowy) oraz informacja o aktualnym zatrudnieniu. Data utworzenia: 2011-07-20 Status: Obowiązujący Strona: 26 / 64 Dokument Utworzył: Opis procesu masowego importu danych do systemu PON-on Marek Michajłowicz Ostatnia modyfikacja: 2011-11-21 Wersja: 2.3.0 5.7 Dane wejściowe wymagane w przypadku aktualizacji informacji o zatrudnieniu pracownika naukowodydaktycznego Struktura pliku XML powinna zawierać komplet danych osobowych umożliwiający prawidłową identyfikację relacji pracownika z jednostką zatrudnienia. W wymaganym zakresie danych wyróżniamy dwa typy zatrudnienia pracownika naukowo-dydaktycznego opisane w osobnych sekcjach <nauczycielAkademickiZatrudnienie> oraz <pracownikNaukowyZatrudnienie>. Wymagane jest wystąpienie co najmniej jednej formy zatrudnienia w pliku, bez względu na typ wykonywanej operacji. Rekord pracownika w pliku XML powinien zawierać pełną, aktualną informację o stanie zatrudnienia danej osoby w jednostce. Bardzo ważne jest prawidłowe zdefiniowanie okresów zatrudnienia, tak by system prawidłowo mógł zidentyfikować relację w bazie i odpowiednio zaktualizować ją w przypadku potrzeby nadpisania już posiadanych danych. Kluczem identyfikującym zatrudnienie z pliku XML w bazie systemu POL-on jest zestaw atrybutów: Identyfikator instytucji + PESEL + Data rozpoczęcia zatrudnienia. Operacja bazuje na założeniu, że pracownik uczelni może mieć zdefiniowane w danym okresie czasu wyłącznie jedno aktywne zatrudnienie w ramach określonej jednostki organizacyjnej (np. wydział). W przypadku wystąpienia w pliku pola domykającego zatrudnienie (dataDo), wykonywana jest przez system operacja zakończenia zatrudnienia pracownika w ramach jednostki. UWAGA: Atrybut dataOd zatrudnienia pracownika jest kluczem identyfikacyjnym. W związku z tym pole to nie może być elementem modyfikowanym w ramach masowego importu plików. W przypadku stwierdzenia przez uczelnię błędu w zakresie podanej daty rozpoczęcia zatrudnienia korekty należy dokonać z poziomu interfejsu użytkownika. Próba wgrania pliku z poprawioną datą zostanie zinterpretowana przez system jako próba podania nowej informacji o zatrudnieniu. Sekcje opcjonalne w przypadku aktualizowania danych o pracowniku i jego zatrudnieniu: • funkcja • tytulZawodowy Data utworzenia: 2011-07-20 Status: Obowiązujący Strona: 27 / 64 Dokument Utworzył: • stopienNaukowy • tytulNaukowy Opis procesu masowego importu danych do systemu PON-on Marek Michajłowicz Ostatnia modyfikacja: 2011-11-21 Wersja: 2.3.0 5.8 Dane wejściowe wymagane w przypadku aktualizacji oświadczenia o minimum kadrowym pracownika naukowodydaktycznego Oświadczenie o minimum kadrowym stanowi zestaw atrybutów przypisania pracownika do określonej jednostki, w której jest zatrudniony. Informacja o oświadczeniu minimum kadrowego jest za każdym razem nadpisywana wartościami przekazanymi w pliku w ramach konkretnego zatrudnienia. Oświadczenie przypisania nauczyciela akademickiego do minimum kadrowego polega na związaniu osoby (dokładniej: elementu zatrudnienia osoby) z kierunkiem prowadzonym przez jednostkę. Pod pojęciem kierunku rozumiemy w tym miejscu konkretny kierunek (instancję), a nie definicję kierunku. Pojedyncze przypisanie do minimum kadrowego wiąże się z jedną lub dwoma instancjami kierunku. Oba kierunki muszą bazować na tej samej definicji, mogą się różnić poziomem. Aktualizacja dotychczas złożonego oświadczenia zależy więc od prawidłowego zdefiniowania relacji pomiędzy pracownikiem a zatrudnieniem w charakterze nauczyciela akademickiego. 5.9 Dane wejściowe wymagane w przypadku aktualizacji informacji o tytułach i stopniach pracownika naukowodydaktycznego Do prawidłowej identyfikacji relacji pracownika i posiadanych przez niego tytułów w systemie wymagany jest pełen komplet danych wymaganych w odpowiednich sekcjach: <tytulNaukowy>, <stopienNaukowy>, <tytulZawodowy> Kluczem identyfikującym informację o tytule zawodowym z pliku XML w bazie systemu POLon jest zestaw atrybutów: Identyfikator instytucji przyznającej tytuł + PESEL + Data Nadania. Data utworzenia: 2011-07-20 Status: Obowiązujący Strona: 28 / 64 Dokument Utworzył: Opis procesu masowego importu danych do systemu PON-on Marek Michajłowicz Ostatnia modyfikacja: 2011-11-21 Wersja: 2.3.0 Kluczem identyfikującym informację o stopniu naukowym z pliku XML w bazie systemu POLon jest zestaw atrybutów: Identyfikator instytucji przyznającej tytuł + PESEL + Data Nadania Pole Identyfikator instytucji z pliku w sekcji tytułu zawodowego jest polem opcjonalnym w związku z czym nie podanie identyfikatora systemowego, lub nie odnalezienie go w systemie skutkować będzie dodaniem dodatkowej informacji o uzyskanym tytule zawodowym dla określonej osoby. Kluczem identyfikującym informację o tytule naukowym z pliku XML w bazie systemu POL-on jest zestaw atrybutów: dyscyplina kod + PESEL + Data Nadania. Aktualizacja danych bazuje na założeniu, że w danym momencie pracownik może posiadać tylko jeden tytuł naukowy w określonej dyscyplinie naukowej. UWAGA: Atrybut dataNadania w tytule zawodowym pracownika jest kluczem identyfikacyjnym. W związku z tym pole to nie może być elementem modyfikowanym w ramach masowego importu plików. W przypadku stwierdzenia przez uczelnię błędu w zakresie podanej daty rozpoczęcia zatrudnienia korekty należy dokonać z poziomu interfejsu użytkownika. Próba wgrania pliku z poprawioną datą zostanie zinterpretowana przez system jako próba podania nowej informacji o tytule zawodowym. 5.10 Dane wejściowe wymagane w przypadku aktualizacji informacji o funkcjach pracownika naukowo-dydaktycznego Kryterium identyfikacyjne w przypadku aktualizacji danych o funkcji pracownika sprawowanej w ramach danej jednostki organizacyjnej stanowi zestaw atrybutów: PESEL + instytucjaId + funkcjaKod + dataOd. Pracownik może sprawować więcej niż jedną funkcję w ramach określonej jednostki (Uczelnia) w różnych okresach czasu. W przypadku zidentyfikowania kompletu podanych wyżej atrybutów w bazie systemu POL-on, zostaną one zinterpretowane jako aktualizacja już przypisanej funkcji. UWAGA: Atrybut dataOd funkcji pracownika jest kluczem identyfikacyjnym. W związku z tym pole to nie może być elementem modyfikowanym w ramach masowego importu plików. W przypadku stwierdzenia przez uczelnię błędu w zakresie podanej daty rozpoczęcia zatrudnienia korekty należy dokonać z poziomu interfejsu użytkownika. Data utworzenia: 2011-07-20 Status: Obowiązujący Strona: 29 / 64 Dokument Utworzył: Opis procesu masowego importu danych do systemu PON-on Marek Michajłowicz Ostatnia modyfikacja: 2011-11-21 Wersja: 2.3.0 Próba wgrania pliku z poprawioną datą zostanie zinterpretowana przez system jako próba podania nowej informacji o funkcji pełnionej w ramach uczelni. 5.11 Dane wejściowe wymagane w przypadku aktualizacji danych dotyczących studiów Kluczem identyfikującym przypisanie konkretnego studenta do kierunku studiów z pliku XML w bazie systemu POL-on jest zestaw atrybutów: Identyfikator kierunku + PESEL + Data zarejestrowania studenta. Na podstawie podanego zestawu atrybutów system identyfikuje przypisanie do kierunku w systemie i dokonuje aktualizacji pól na podstawie pliku. UWAGA: Atrybut dataOd przypisania do kierunku studenta jest kluczem identyfikacyjnym. W związku z tym pole to nie może być elementem modyfikowanym w ramach masowego importu plików. W przypadku stwierdzenia przez uczelnię błędu w zakresie podanej daty przypisania do kierunku korekty należy dokonać z poziomu interfejsu użytkownika. Próba wgrania pliku z poprawioną datą zostanie zinterpretowana przez system jako próba podania nowej informacji o przypisaniu do kierunku. 5.12 Dane wejściowe wymagane w przypadku wyrejestrowania studenta z kierunku studiów Kluczem identyfikującym przypisanie konkretnego studenta do kierunku studiów z pliku XML w bazie systemu POL-on jest zestaw atrybutów: Identyfikator kierunku + PESEL + Data zarejestrowania studenta. Na podstawie podanego zestawu atrybutów system identyfikuje przypisanie do kierunku w systemie i dokonuje aktualizacji pola data wyrejestrowania na podstawie pliku. W ten sposób uczelnia przekazuje do rejestru informację o wypisaniu studenta z kierunku studiów. UWAGA: Atrybut dataOd przypisania do kierunku studenta jest kluczem identyfikacyjnym. W związku z tym pole to nie może być elementem modyfikowanym w ramach masowego importu plików. W przypadku stwierdzenia przez uczelnię błędu w zakresie podanej daty przypisania do kierunku korekty należy dokonać z poziomu interfejsu użytkownika. Próba wgrania pliku z Data utworzenia: 2011-07-20 Status: Obowiązujący Strona: 30 / 64 Dokument Utworzył: Opis procesu masowego importu danych do systemu PON-on Marek Michajłowicz Ostatnia modyfikacja: 2011-11-21 Wersja: 2.3.0 poprawioną datą zostanie zinterpretowana przez system jako próba podania nowej informacji o przypisaniu do kierunku. 5.13 Dane wejściowe wymagane w przypadku przesyłania informacji dotyczącej aktualizacji informacji o pobieranej przez studenta pomocy materialnej Pomoc materialna stanowi zestaw atrybutów przypisania studenta do określonego kierunku studiów. Informacja o stypendium jest za każdym razem nadpisywana wartościami przekazanymi w pliku. Data utworzenia: 2011-07-20 Status: Obowiązujący Strona: 31 / 64 Dokument Utworzył: Opis procesu masowego importu danych do systemu PON-on Marek Michajłowicz Ostatnia modyfikacja: 2011-11-21 Wersja: 2.3.0 6. Informacje dodatkowe • • Obowiązujące terminy i zakres danych zostaną określone przez ostateczne wersje rozporządzeń do ustawy. Oświadczenia o spełnieniu warunków do studiów bezpłatnych w uczelni publicznej po raz pierwszy będą składali studenci immatrykulowani w październiku 2012 roku. Data utworzenia: 2011-07-20 Status: Obowiązujący Strona: 32 / 64 Opis procesu masowego importu danych do systemu PON-on Dokument Utworzył: Marek Michajłowicz Ostatnia modyfikacja: 2011-11-21 Wersja: 2.3.0 7. Sytuacje specyficzne 5.1 Algorytm identyfikacji operacji na podstawie pliku act ALG_Identyfikuj typ operacji [Pracownik] Ważny walidator na weryfikację zatrudnienia w pliku... [Student] Czy nowy? Czy nowy? [TAK] [TAK] [NIE] [NIE] Czy podana data wyerejstrowania? Dodaj studenta (daneDotyczaceStudiow::DodajStudenta) [TAK] [EXISTS XML.nauczycielAkademickiZatrudnienie ] [Jest zatrudnienie w instytucji] [Brak Zatrudnienia w Instytucji] Student [Dodany] Wyrejestruj studenta (daneDotyczaceStudiow::WyrejestrujStudenta) Dodaj (nauczycielAkademickiZatrudnienie ::DodajZatrudnienie) [NIE] Student [Wyrejestrowany] AktualizujDaneStudenta Pobierz zatrudnienie z XML Pobierz Zatrudnienie z bazy [XML] [DB] Weryfikuj poprawność oświadczenia studenta (daneDotyczaceStudiow::WeryfikacjaOswiadczeniaStudenta) [XML.DataDo not exists and DB.DataDo not exists] [ELSE] AktualizujZatrudnienieAktywne (::) [(XML.DataDo > Sysdate and DB.DataDo not exists) or (XML.DataDo not exists and DB.DataDo > Sysdate) ] pobieraPomocMaterialna [Last(DB.DataOd) and XML.StanowiskoKod = DB.StanowiskoKod] [ELSE] Aktualizuj dane na kierunku (daneDotyczaceStudiow::PrzepiszNaKolejnySemestr) AktualizujPunktECTS (daneDotyczaceStudiow::AktualizujECTS) [Tak] [XML.DataDo exists and DB.DataDo not exists ] [(XML.DataOd = DB.DataOd) ] Aktualizuj przyznaną pomoc materialną (PomocMaterialna::AktualizujPrzyznanaPomoc) ZakończZatrudnienie [Nie] [ELSE] [Jest MK] [(XML.DataOd = DB.DataOd) and (XML.DataDo = DB.DataDo)] Zaktualizuj zatrudnienie historyczne Aktualizuj MK [Brak MK] [ELSE] Weryfikuj stan przyznanej pomocy materialnej (PomocMaterialna::WeryfikujPrzyznanaPomoc) Pomoc Materialna [Updatek] DodajZatrudnienie Data utworzenia: 2011-07-20 Status: Obowiązujący Strona: 33 / 64 Dokument Utworzył: Opis procesu masowego importu danych do systemu PON-on Marek Michajłowicz Ostatnia modyfikacja: 2011-11-21 Wersja: 2.3.0 5.2 Algorytm identyfikacji operacji na podstawie pliku Data utworzenia: 2011-07-20 Status: Obowiązujący Strona: 34 / 64 Dokument Utworzył: Opis procesu masowego importu danych do systemu PON-on Marek Michajłowicz Ostatnia modyfikacja: 2011-11-21 Wersja: 2.3.0 8. Słownik błędów W ramach importu wyodrębniono podane poniżej reguły walidacyjne. Występują dwa typy zdarzeń opisanych w kolumnie Typ zdarzenia: • K - błąd krytyczny, zdarzenie skutkujące odrzuceniem pliku importu. • O - ostrzeżenie, komunikat informacyjny dla użytkownika, dający możliwość wyjaśnienia sytuacji i dokonania późniejszej korekty w systemie lub w ramach procedur eksportujących dane. Ostrzeżenie nie powoduje odrzucenia pliku importu. Kod zdarz enia Typ Zdarze nia Grupa błędów 1 K Błędy wstępnej walidacji Kategoria błędu Dotyczy Etap walidacji Reguła walidacyjna Opis biznesowy (Komunikat błędu) Data utworzenia: 2011-07-20 Struktury pliku I Status: Uwagi (Instrukcja postępowania dla pracownika Uczelni) (GInterfejs użytkowni ka,I import masowy) Błąd kodowania pliku Sugerowane działanie Formatowanie pliku inne niż UTF- 8 Obowiązujący Strona: Błędne kodowanie pliku 35 / 64 Poprawa pliku XML, zmiana deklaracji kodowania w nagłówku Błąd odrzucający plik Opis procesu masowego importu danych do systemu PON-on Dokument Utworzył: Marek Michajłowicz Kod zdarz enia Typ Zdarze nia Grupa błędów Kategoria błędu Dotyczy Etap walidacji 3 K Błędy wstępnej walidacji Instytucja spoza zakresu Struktury pliku I 4 K Błąd importu Student I 6 K Błędy wstępnej walidacji Błędy wstępnej walidacji Niepoprawna wersja schematu Struktury pliku I 7 K Niepoprawny rozmiar pola Struktury pliku I 8 K Błędy wstępnej walidacji Błędy importu Dane osobowe Dane Osoby I/G 9 O Ostrzeżenia Pomoc materialna Student I/G Ostatnia modyfikacja: 2011-11-21 Wersja: 2.3.0 Reguła walidacyjna Opis biznesowy (Komunikat błędu) 2011-07-20 Status: Uwagi (Instrukcja postępowania dla pracownika Uczelni) (GInterfejs użytkowni ka,I import masowy) Data utworzenia: Sugerowane działanie Podany IdInstytucji w pliku nie występuje w bazie. Nie dotyczy pól znajdujących się w sekcji pliku XML Pracownik.TytulZawodowy W pliku XML student posiada dwa razy ten sam rodzaj pomocy materialnej (rodzajPrzyznanychSwiadczen). Parametr wersji XML-Schema niezgodny z bieżącym. Weryfikacja na podstawie sekcji nagłówka pliku. Podana wartość przekracza rozmiar pola zdefiniowany w schemacie XMLSchema Brak wartości dla pola obowiązkowego imie1 Jeśli w XML jest informacja o rodzaju przyznanych świadczeń pomocy materialnej w uczelni publicznej i niepublicznej (rodzajPrzyznanychSwiadczen) należy zweryfikować, czy student nie pobiera, już tego rodzaju pomocy na podstawie Obowiązujący Strona: Podano błędny kodInstytucji – podany <kod> nie występuje w systemie Poprawa pliku W pliku podano kilkukrotnie ten sam typ pomocy materialnej dla studenta. Niepoprawna wersja schematu XML Korekta pliku XML Podana wartość przekracza maksymalny rozmiar pola Wartość <imie1> nie może być pusta. Podanie wartości jest wymagane Student złożył oświadczenie o pobieraniu pomocy materialnej określonego typu na więcej niż jednym kierunku 36 / 64 Nie dla wszystkich pól XML ta reguła ma zastosowanie Pobierz nowy słownik importu i dokonaj korekty pliku. Korekta pliku XML <danePodstawowe><imi e1> Publikowane w raporcie importu oraz zestawieniach dla MNiSW Opis procesu masowego importu danych do systemu PON-on Dokument Utworzył: Kod zdarz enia Typ Zdarze nia Grupa błędów Marek Michajłowicz Kategoria błędu Dotyczy Etap walidacji Ostatnia modyfikacja: 2011-11-21 Wersja: 2.3.0 Reguła walidacyjna Opis biznesowy (Komunikat błędu) Sugerowane działanie Uwagi (Instrukcja postępowania dla pracownika Uczelni) (GInterfejs użytkowni ka,I import masowy) stanu bazy. Uwaga: jeżeli administrator ma uprawnienia INST_IMPORTY w ramach innych instytucji naukowych, należy dokonać weryfikacji kontekstu zalogowania 12 K Błędy importu Brak deklaracji dotyczącej podstawoweg o miejsca zatrudnienia Pracownik I/G Dotyczy pól (baza): PRN_ZATRUDNIENIE.PODST_DOD_M IEJSCE_PRACY_KOD Dotyczy pól (xml):<nauczycielAkademickiZatrudnieni e><miejscePracyKod> Zatrudnienie osoby w roli nauczyciela akademickiego wymaga podania informacji, czy dane miejsce pracy jest podstawowym, czy dodatkowym miejscem pracy. 14 K Dane osobowe Dane Osoby I/G Wartość nazwiska nie może być pusta 18 K Błędy – wstępnej walidacji Błędy wstępnej walidacji Niepoprawne rozszerzsenie pliku importu Struktury pliku I Plik importu powinien mieć rozszerzenie .xml Wartość <nazwisko> nie może być pusta. Podanie wartości jest wymagane Niepoprawne rozszerzenie pliku importu Data utworzenia: 2011-07-20 Status: Obowiązujący Strona: 37 / 64 Korekta pliku XML Dla zatrudnienia typu PN (pracownik naukowy), informacja ta jest zbędna. Opis procesu masowego importu danych do systemu PON-on Dokument Utworzył: Marek Michajłowicz Kategoria błędu Dotyczy Etap walidacji Ostatnia modyfikacja: 2011-11-21 Wersja: 2.3.0 Kod zdarz enia Typ Zdarze nia Grupa błędów Reguła walidacyjna Opis biznesowy (Komunikat błędu) 21 K Błędy importu Błąd identyfikacji osoby w pliku Dane Osoby I Niezgodność pól ImiePierwsze i Nazwisko z pliku z danymi w bazie dla osoby o tym samym numerze PESEL Dla osoby o numerze PESEL wystąpiła rozbieżność na poziomie danych podstawowych pomiędzy plikiem importu a danymi w bazie 22 K Błędy importu Błąd braku wymaganych danych osobowych dla cudzoziemca Dane Osoby I Jeżeli obywatel Polski w pliku musi być podany prawidłowy numer PESEL Nie podano numeru PESEL dla obywatela Polski (Instrukcja postępowania dla pracownika Uczelni) (GInterfejs użytkowni ka,I import masowy) Data utworzenia: 2011-07-20 Status: Sugerowane działanie Obowiązujący Strona: 38 / 64 Weryfikacja poprawności danych z pliku i ewentualna korekta. W przypadku błędnych danych w systemie, wycięcie osoby z pliku i zgłoszenie konfliktu do administratora Uwagi Opis procesu masowego importu danych do systemu PON-on Dokument Utworzył: Kod zdarz enia Typ Zdarze nia Grupa błędów 25 O Ostrzeżenia Marek Michajłowicz Kategoria błędu Dotyczy Etap walidacji Ostatnia modyfikacja: 2011-11-21 Wersja: 2.3.0 Reguła walidacyjna Opis biznesowy (Komunikat błędu) Data utworzenia: 2011-07-20 Struktury pliku I Status: Uwagi (Instrukcja postępowania dla pracownika Uczelni) (GInterfejs użytkowni ka,I import masowy) W pliku wystąpiły dwa rekordy dotyczące tej samej osoby Sugerowane działanie W ramach pliku występuje kilka sekcji<pracownikNaukowoDydaktyczny> , <student> lub <doktorant>, które dotyczą tej samej osoby Obowiązujący Strona: Redundancja danych osoby w pliku importu. W ramach pliku powtórzono informację o studencie <dane studenta> 39 / 64 Sugerowana modyfikacja mechanizmu eksportu, tak by informacje na temat osoby zostały scalone w ramach jednego rekordu Jeżeli formalnie wszystko będzie ok, to rekord powinien zostać przetworzony poprawnie. Lecz administrator powinien zostać poinformowany o konieczności wprowadzenia modyfikacji procedur eksportowych w systemie pod kątem scalenia informacji dotyczących tej samej osoby Opis procesu masowego importu danych do systemu PON-on Dokument Utworzył: Marek Michajłowicz Kod zdarz enia Typ Zdarze nia Grupa błędów Kategoria błędu Dotyczy Etap walidacji 28 K Błędy importu Podstawowe miejsce pracy może dotyczyć wyłącznie zatrudnienia Pracownik I 29 K Błędy importu Nieprawidłowy parametr daty zatrudnienia Pracownik I Ostatnia modyfikacja: 2011-11-21 Wersja: 2.3.0 Reguła walidacyjna Opis biznesowy (Komunikat błędu) 2011-07-20 Status: Uwagi (Instrukcja postępowania dla pracownika Uczelni) (GInterfejs użytkowni ka,I import masowy) Data utworzenia: Sugerowane działanie W danym momencie osoba może być zatrudniona wyłącznie w jednym podstawowym miejscu pracy. Bierzemy pod uwagę tylko aktualne zatrudnienia. Zatrudnienie aktualne to takie, które nie ma wstawionej wartości pola DATA_DO, lub takie, w którym wartość ta jest większa od daty bieżącej (przykład: zatrudnienie na czas określony, z DATA_DO za trzy miesiące Dodając nowe zatrudnienie, które jest typu NA/Podstawowe sprawdzamy, czy nie będzie dwóch aktualnych/zachodzących na siebie zatrudnień podstawowych. Weryfikacja w oparciu o stan bazy oraz strukturę pliku XML. dataOd w sekcjach dotyczących zatrudnienia pracownika jest większa od daty zakończenia stosunku pracy Obowiązujący Strona: Przekroczono limit aktualnego podstawowego zatrudnienia pracownika. Pracownik posiada już aktywne podstawowe zatrudnienie w systemie w jednostce <nazwa jednostki z zatrudnienia> na stanowisku <nazwa stanowiska> , <dataOd>. Ustalenie, czy pracownik nie złożył już informacji o zatrudnieniu w ramach podstawowego miejsca pracy na innej uczelni Błędne zdefiniowanie okresu zatrudnienia w pliku Korekta pliku 40 / 64 W poprzedniej wersji ustawy dotyczyło tylko Nauczycieli akademickich Opis procesu masowego importu danych do systemu PON-on Dokument Utworzył: Marek Michajłowicz Kod zdarz enia Typ Zdarze nia Grupa błędów Kategoria błędu Dotyczy Etap walidacji 30 K Błędy importu Brak danych identyfikatycjn ych cudzoziemca Dane Osoby I/G 33 O Ostrzeżenia Nieprawidłowa data złożenia oświadczenia do minimum kadrowego Pracownik I Ostatnia modyfikacja: 2011-11-21 Wersja: 2.3.0 Reguła walidacyjna Opis biznesowy (Komunikat błędu) 2011-07-20 Status: Uwagi (Instrukcja postępowania dla pracownika Uczelni) (GInterfejs użytkowni ka,I import masowy) Data utworzenia: Sugerowane działanie Jeśli osoba jest cudzoziemcem (tzn. podstawowe obywatelstwo inne niż PL) oraz nie ma numeru PESEL (bo cudzoziemiec może mieć PESEL), wówczas pola rodzaj i numer dokumentu tożsamości są wymagane Na podstawie pliku XML: Pole dataOswiadczenia > 30-06 dla danego roku akademickiego począwszy od roku 2012/2013. W oświadczeniu o MK podano datę złożenia oświadczenia nie mieszczącą się w wymaganym kryterium: oświadczenie powinno być złożone przed rozpoczęciem roku akademickiego (termin do 30-6). Weryfikacja na podstawie pól minimum kadrowego: rokAkademicki, dataOswiadczenia, dataPrzypisania Obowiązujący Strona: Wymagane: Rodzaj i numer dokumentu tożsamości w przypadku braku PESEL Oświadczenie o przypisaniu do minimum kadrowego danego kierunku złożono po ustawowym terminie 41 / 64 Korekta pliku Na podstawie Art. 112a p.3 Opis procesu masowego importu danych do systemu PON-on Dokument Utworzył: Marek Michajłowicz Kategoria błędu Dotyczy Etap walidacji Ostatnia modyfikacja: 2011-11-21 Wersja: 2.3.0 Kod zdarz enia Typ Zdarze nia Grupa błędów Reguła walidacyjna Opis biznesowy (Komunikat błędu) 34 O Błędy importu Data przypisania do MK wcześniejsza od daty oświadczenia Pracownik I Na podstawie pliku XML: dataOswiadczenia > dataPrzypisania Data złożenia oświadczenia późniejsza od daty przypisania do kierunku studiów 35 O Błędy importu Data przypisania do MK wcześniejsza od daty bieżącej Pracownik I Na podstawie pliku XML: dataOswiadczenia późniejsza od daty bieżącej Nieprawidłowa data złożenia oświadczenia o minimum kadrowym 36 O Błędy importu Błędne dane zatrudnienia dla profesora Pracownik I Na podstawie XML i stanu bazy: podano typ zatrudnienia <<mianowanie>> dla pracownika nie posiadającego tytułu naukowego <<profesora>> lub podano niepełny wymiar czasu pracy dla zatrudnienia <<mianowanie>> Na podstawie mianowania zatrudnia się wyłącznie nauczyciela akademickiego posiadającego tytuł naukowy profesora. Zatrudnienie na podstawie mianowania następuje w pełnym wymiarze czasu pracy 2011-07-20 Status: Uwagi (Instrukcja postępowania dla pracownika Uczelni) (GInterfejs użytkowni ka,I import masowy) Data utworzenia: Sugerowane działanie Obowiązujący Strona: 42 / 64 interpretowana jako data przekazana do systemu POL-on Na podstawie Art. 118 p.1 / Są wyjątki w rozporządzeniach Opis procesu masowego importu danych do systemu PON-on Dokument Utworzył: Marek Michajłowicz Kod zdarz enia Typ Zdarze nia Grupa błędów Kategoria błędu Dotyczy Etap walidacji 38 K Błędy importu Niespójne dane dotyczące zatrudnienia PracownikBłędy zatrudnienia I 39 K Błędy importu Nadmierna liczba uprawnień do nadawania stopni PracownikBłędy zatrudnienia I Ostatnia modyfikacja: 2011-11-21 Wersja: 2.3.0 Reguła walidacyjna Opis biznesowy (Komunikat błędu) (Instrukcja postępowania dla pracownika Uczelni) (GInterfejs użytkowni ka,I import masowy) Data utworzenia: 2011-07-20 Status: Sugerowane działanie Dla pracownika niezgodność pomiędzy polami w pliku XML: NauczycielAkademickiZatrudnienie.wymi arCzasuPracyKod a NauczycielAkademickiZatrudnienie.wymi arCzasuPracyCzesc oraz NauczycielAkademickiZatrudnienie.wymi arCzasuPracyCalosc. Np. podano informację o pełnym wymiarze czasu pracy oraz wartość ułamkową albo wymiar czasu pracy niepełny bez podania wartości ułamkowych Pracownik może mieć w danym momencie tylko jedno uprawnienie do nadawania stopni naukowych. Weryfikacja w oparciu o stan bazy oraz zawartość pliku w sekcji zatrudnienia. Obowiązujący Strona: Niespójne dane dotyczące wymiaru czasu pracy dla zatrudnienia. Np. podano informację o pełnym wymiarze czasu pracy oraz wartość ułamkową albo wymiar czasu pracy niepełny bez podania wartości ułamkowych Korekta pliku Dla pracownika <imie>, <nazwisko>, <dokument/pesel> nastąpiło naruszenie reguły przypisania uprawnienia do nadawania stopni naukowych Pracownik może mieć tylko jedno aktywne uprawnienie do nadawania stopni naukowych. Przypisane uprawnienia w ramach zatrudnienia: <instytucjaZatrudniająca> Korekta pliku. Kontakt z pracownikiem w celu wyjaśnienia sytuacji. 43 / 64 Uwagi Opis procesu masowego importu danych do systemu PON-on Dokument Utworzył: Marek Michajłowicz Kategoria błędu Dotyczy Etap walidacji Ostatnia modyfikacja: 2011-11-21 Wersja: 2.3.0 Kod zdarz enia Typ Zdarze nia Grupa błędów Reguła walidacyjna Opis biznesowy (Komunikat błędu) 40 K Błędy importu Brak danych dotyczących Funkcji praco wnika PracownikBłędy zatrudnienia I W pliku XML nie podano żadnego z pól opcjonalnych definiujących funkcję pracownika – funkcjaKod lub funkcjaNazwa W pliku XML nie podano żadnego z pól definiujących rodzaj funkcji sprawowanej przez pracownika w Jednostce Korekta pliku 41 K Błędy importu PracownikBłędy zatrudnienia I Dla pól z pliku XML: Pracownik.Funkcja.dataOd > Pracownik.Funkcja.dataDo Niespójność w zakresie dat pełnienia funkcji przez pracownika Korekta pliku 44 K Błędy importu Niespójność w zakresie dat pełnienia funkcji przez pracownika Niepoprawne przypisanie Tytułu zawodowego do jednostki PracownikBłędy przypisania I W przypadku wypełnienia opcjonalnych pól dotyczących jednostki przyznającej tytuł zawodowy z systemu (kierunekId lub instytucjaId) weryfikacja poprawności identyfikatorów Podano nieprawidłowe identyfikatory jednostek w zakresie przydzielonego tytułu zawodowego 46 K Błędy importu Niespójne daty uzyskania stopnia naukowego Pracownik I Dotyczy pól pliku XML: Data wszczęcia przewodu > Data uzyskania stopnia Niespójne daty uzyskania stopnia naukowego Korekta identyfikator instytucji lub wypełnienie pól opisowych dla instytucji nie występujących w bazie systemu POL-on Korekta pliku (Instrukcja postępowania dla pracownika Uczelni) (GInterfejs użytkowni ka,I import masowy) Data utworzenia: 2011-07-20 Status: Sugerowane działanie Obowiązujący Strona: 44 / 64 Uwagi Dokument Utworzył: Kod zdarz enia Typ Zdarze nia Grupa błędów 48 O Ostrzeżenia Opis procesu masowego importu danych do systemu PON-on Marek Michajłowicz Kategoria błędu Dotyczy Etap walidacji Ostatnia modyfikacja: 2011-11-21 Wersja: 2.3.0 Reguła walidacyjna Opis biznesowy (Komunikat błędu) (Instrukcja postępowania dla pracownika Uczelni) (GInterfejs użytkowni ka,I import masowy) Data utworzenia: Nieprawidłowa liczba godzin zajęć dydaktycznych zgłoszonych w ramach minimum kadrowego 2011-07-20 Pracownik I Status: Sugerowane działanie Nauczyciel akademicki może być wliczony do MK, jeżeli osobiście prowadzi zajęcia dydaktyczne co najmniej 30 godzin zajęć dydaktycznych, w przypadku nauczycieli akademickich posiadających tytuł naukowy profesora lub stopień naukowy doktora habilitowanego i co najmniej 60 godzin w przypadku nauczycieli akademickich posiadających stopień doktora. Dotyczy oświadczenia złożonego w okresie obowiązywania nowych rozporządzeń do Ustawy, tzn. od roku akademickiego 2012/2013 ( rokAkademicki = 2012). Obowiązujący Strona: Podano nieprawidłową liczbę godzin dydaktycznych w ramach minimum kadrowego 45 / 64 Uwagi Dokument Utworzył: Kod zdarz enia Typ Zdarze nia Grupa błędów 49 K Błędy importu 51 K 52 K Opis procesu masowego importu danych do systemu PON-on Marek Michajłowicz Kategoria błędu Dotyczy Etap walidacji Ostatnia modyfikacja: 2011-11-21 Wersja: 2.3.0 Reguła walidacyjna Opis biznesowy (Komunikat błędu) Pracownik I Na podstawie pliku XML. W przypadku podania w polu Pracownik.nauczycielAkademickiZatrudn ienie.stanowiskooKod wartości = „Profesor zwyczajny” w pliku powinna istnieć informacja o aktualnie posiadanym tytule naukowym profesora. Reguła ma zastosowanie dla osób zatrudnionych po dniu wjeścia w życie ustawy , tzn. dotyczy zatrudnienia z datą po 30-09-2011 Podano dane o zatrudnieniu pracownika na stanowisku profesora zwyczajnego bez tytułu naukowego profesora Błędy importu Struktury pliku I W pliku powtórzono dane identyfikacyjne osoby (PESEL dla obywatela Polski lub seria i numer dokumentu tożsamości dla obcokrajowca) dla różnego zestawu danych osobowych. Błędy importu Pracownik I Po wejściu w życie ustawy znika stanowisko docenta. Weryfikacja na podstawie daty zatrudnienia (dotyczy zatrudnienia z datą po 30-09-2011), stanowiskoKod w oparciu o słownik stanowiskoNA W pliku powtórzono dane identyfikacyjne osoby (PESEL dla obywatela Polski lub seria i numer dokumentu tożsamości dla obcokrajowca) dla różnego zestawu danych osobowych. Przekazano informację o zatrudnieniu pracownika na stanowisku niezgodnym z nową ustawą - po wejściu w życie ustawy znika stanowisko: docent. Data utworzenia: 2011-07-20 Status: Uwagi (Instrukcja postępowania dla pracownika Uczelni) (GInterfejs użytkowni ka,I import masowy) Zatrudnienie na stanowisku <<profesora zwyczajnego> > osoby nie posiadającej tytułu naukowego <<profesora>> Sugerowane działanie Obowiązujący Strona: 46 / 64 Dla docenta, który ma datę zatrudnienia po wejściu w życie ustawy Opis procesu masowego importu danych do systemu PON-on Dokument Utworzył: Kod zdarz enia Typ Zdarze nia Grupa błędów 54 K Błędy importu 55 O Błędy importu Marek Michajłowicz Kategoria błędu Dotyczy Etap walidacji Ostatnia modyfikacja: 2011-11-21 Wersja: 2.3.0 Reguła walidacyjna Opis biznesowy (Komunikat błędu) Data utworzenia: 2011-07-20 PracownikBłędy zatrudnienia I Podstawowe miejsce pracy może być tylko w pełnym wymiarze Podano nieprawidłowy wymiar czasu pracy dla podstawowego miejsca zatrudnienia Pracownik.B łędy minimum kadrowego I Osoba nie może mieć przypisanych więcej niż dwóch minimów kadrowych w tym samym roku akademickim. Weryfikacja na podstawie danych z pliku XML oraz stanu bazy Pracownik przypisany do więcej niż dwóch minimów kadrowych w tym samym roku akademickim Status: Uwagi (Instrukcja postępowania dla pracownika Uczelni) (GInterfejs użytkowni ka,I import masowy) Podano nieprawidłowy wymiar czasu pracy dla podstawoweg o miejsca zatrudnienia Sugerowane działanie Obowiązujący Strona: 47 / 64 Od strony pracownika (raportów, walidacji) interesuje nas to, czy osoba spełnia warunki i (przede wszystkim) nie jest przypisana do większej liczby minimów kadrowych niż przewidują przepisy. Tak więc interesuje nas przede wszystkim związek między tabelami PRN_ZATRUDNIENIE oraz PRN_MINIMUM_KADR OWE. W Dokument Utworzył: Kod zdarz enia Typ Zdarze nia Grupa błędów Opis procesu masowego importu danych do systemu PON-on Marek Michajłowicz Kategoria błędu Dotyczy Etap walidacji Ostatnia modyfikacja: 2011-11-21 Wersja: 2.3.0 Reguła walidacyjna Opis biznesowy (Komunikat błędu) Sugerowane działanie Uwagi (Instrukcja postępowania dla pracownika Uczelni) (GInterfejs użytkowni ka,I import masowy) PRN_MINIMUM_KADR OWE przede wszystkim pola STOPIEN_KOD i ROK_AKADEMICKI. Podstawowa reguła: w danym roku akademickim danej osobie nie mogą być przypisane więcej niż 2 minima kadrowe (powiązane z aktualnym zatrudnieniem). Jeśli są dwa, to co najmniej jedno musi być I stopnia. Tak więc w tym przypadku interesuje nas liczba i rodzaj przypisanych minimów, a tabela PRN_MIN_KADR_KIER nie ma praktycznie znaczenia. Data utworzenia: 2011-07-20 Status: Obowiązujący Strona: 48 / 64 Dokument Utworzył: Kod zdarz enia Typ Zdarze nia Grupa błędów 56 O Ostrzeżenia Opis procesu masowego importu danych do systemu PON-on Marek Michajłowicz Kategoria błędu Dotyczy Etap walidacji Ostatnia modyfikacja: 2011-11-21 Wersja: 2.3.0 Reguła walidacyjna Opis biznesowy (Komunikat błędu) Data utworzenia: 2011-07-20 Pracownik. Błędy minimum kadrowego I Status: Uwagi (Instrukcja postępowania dla pracownika Uczelni) (GInterfejs użytkowni ka,I import masowy) minimum kadrowe tylko jedno minimum 1 stopnia Sugerowane działanie Jeśli są dwa aktualne minima kadrowe, to jedno z nich musi być I stopnia (nie może być dwóch większych od I stopnia). Reguła obowiązuje wyłącznie dla nowej wersji ustawy. Dotyczy daty zatrudnienia i przypisania do minimum kadrowego po 1-10-2011 Obowiązujący Strona: Pracownik przypisany do dwóch minimów kadrowych w ramach kierunków większych od I stopnia 49 / 64 Od strony pracownika (raportów, walidacji) interesuje nas to, czy osoba spełnia warunki i (przede wszystkim) nie jest przypisana do większej liczby minimów kadrowych niż przewidują przepisy. Tak więc interesuje nas przede wszystkim związek między tabelami PRN_ZATRUDNIENIE oraz PRN_MINIMUM_KADR OWE. W PRN_MINIMUM_KADR OWE przede wszystkim pola STOPIEN_KOD i ROK_AKADEMICKI. Podstawowa reguła: w danym roku akademickim danej osobie nie mogą być Dokument Utworzył: Kod zdarz enia Typ Zdarze nia Grupa błędów Opis procesu masowego importu danych do systemu PON-on Marek Michajłowicz Kategoria błędu Dotyczy Etap walidacji Ostatnia modyfikacja: 2011-11-21 Wersja: 2.3.0 Reguła walidacyjna Opis biznesowy (Komunikat błędu) Sugerowane działanie Uwagi (Instrukcja postępowania dla pracownika Uczelni) (GInterfejs użytkowni ka,I import masowy) przypisane więcej niż 2 minima kadrowe (powiązane z aktualnym zatrudnieniem). Jeśli są dwa, to co najmniej jedno musi być I stopnia. Tak więc w tym przypadku interesuje nas liczba i rodzaj przypisanych minimów, a tabela PRN_MIN_KADR_KIER nie ma praktycznie znaczenia. Data utworzenia: 2011-07-20 Status: Obowiązujący Strona: 50 / 64 Dokument Utworzył: Opis procesu masowego importu danych do systemu PON-on Marek Michajłowicz Kategoria błędu Dotyczy Etap walidacji Ostatnia modyfikacja: 2011-11-21 Wersja: 2.3.0 Kod zdarz enia Typ Zdarze nia Grupa błędów Reguła walidacyjna Opis biznesowy (Komunikat błędu) 57 O Ostrzeżenia Pracownik.B łędy minimum kadrowego I Rozp. 11.1. Przypisanie do I stopnia – osoba musi być • nauczycielem akademickim (NA) • mianowanie lub umowa o pracę • pełny wymiar czasu pracy • zatrudnienie w uczelni nie krócej niż od początku roku akademickiego 58 O Ostrzeżenia Pracownik.B łędy minimum kadrowego I Rozp. 11.2. Przypisanie do II, I+II, JM stopnia – osoba musi być • nauczycielem akademickim (NA) • mianowanie lub umowa o pracę • pełny wymiar czasu pracy • zatrudnienie w uczelni nie krócej niż od początku roku akademickiego • podstawowe miejsce pracy 59 K Błędy importu Student I Import danych studenta do kierunku zlikwidowanego 2011-07-20 Status: Uwagi (Instrukcja postępowania dla pracownika Uczelni) (GInterfejs użytkowni ka,I import masowy) Data utworzenia: Sugerowane działanie Obowiązujący Strona: Przypisanie do Minimum kadrowego I stopnia – wymaga by osoba była: • nauczycielem akademickim (NA) • mianowanie lub umowa o pracę • pełny wymiar czasu pracy • zatrudnienie w uczelni nie krócej niż od początku roku akademickiego Przypisanie do Minimum kadrowego II, I+II, JM stopnia – wymaga by osoba była: • nauczycielem akademickim (NA) • Rodzaj umowy: mianowanie lub umowa o pracę • pełny wymiar czasu pracy • zatrudnienie w uczelni nie krócej niż od początku roku akademickiego • podstawowe miejsce pracy Próba dowiązania studenta do kierunku zlikwidowanego 51 / 64 nie uwzgledniamy kryterium daty nie uwzględniamy kryterium daty, wszystko w walidatorze 57 Dokument Utworzył: Opis procesu masowego importu danych do systemu PON-on Marek Michajłowicz Kod zdarz enia Typ Zdarze nia Grupa błędów Kategoria błędu Dotyczy Etap walidacji 60 O Ostrzeżenia Student I 61 K Błędy importu Struktury pliku I/G 63 K Błędy importu PracownikBłędy zatrudnienia I Ostatnia modyfikacja: 2011-11-21 Wersja: 2.3.0 Reguła walidacyjna Opis biznesowy (Komunikat błędu) (Instrukcja postępowania dla pracownika Uczelni) (GInterfejs użytkowni ka,I import masowy) Data utworzenia: 2011-07-20 Status: Sugerowane działanie Import danych do kierunku zawieszonego W przypadku nazwiska obywatela Polski obowiązuje reguła dotycząca formatu nazwiska: Rozpoczynane z dużej litery, brak spacji w środku, w przypadku nazwisk dwuczłonowych znakiem rozdzielającym jest myślnik, a oba człony pisane z dużych liter. Pracownik może w danym momencie posiadać tylko jedno aktywne zatrudnienie w ramach jednej jednostki (wydziału). Weryfikacja na podstawie pliku XML i stanu bazy. Kryterium weryfikacji w oparciu o dane: IdInstytucji, DataOd, DataDo, stanowisko Obowiązujący Strona: Import danych do kierunku zawieszonego W przypadku nazwiska obywatela Polski obowiązuje reguła dotycząca formatu nazwiska: Rozpoczynane z dużej litery, brak spacji w środku, w przypadku nazwisk dwuczłonowych znakiem rozdzielającym jest myślnik, a oba człony pisane z dużych liter. Podano informacje o więcej niż jednym aktywnym zatrudnieniu pracownika na osobnym stanowisku z ramach tej samej jednostki organizacyjnej 52 / 64 Uwagi Dokument Utworzył: Kod zdarz enia Typ Zdarze nia Grupa błędów 64 O Ostrzeżenia Opis procesu masowego importu danych do systemu PON-on Marek Michajłowicz Kategoria błędu Dotyczy Etap walidacji Ostatnia modyfikacja: 2011-11-21 Wersja: 2.3.0 Reguła walidacyjna Opis biznesowy (Komunikat błędu) Data utworzenia: 2011-07-20 I Status: Uwagi (Instrukcja postępowania dla pracownika Uczelni) (GInterfejs użytkowni ka,I import masowy) PracownikBłędy zatrudnienia Sugerowane działanie Weryfikacja na podstawie pliku XML oraz stanu bazy. Na podstawie danych z pliku zidentyfikowano zatrudnienie pracownika z domkniętym okresem (podana dataDo). Informacja w pliku zawiera ten sam zakres danych (IdInstytucji, Stanowisko, DataOd) identyfikacyjnych z pustą wartością w polu dataDo. W systemie nie istnieją inne aktywne zatrudnienia w ramach tego samego kierunku. Obowiązujący Strona: Dokonano ponownej akutalizacji danych w ramach zatrudnienia z podaną datą zakończenia stosunku pracy. W wyniku operacji aktywowano zatrudnienie pracownika w ramach jednostki organizacyjnej. 53 / 64 Sytuacja opisuje potencjalnie możliwe do wystąpienia przypadki związane z aktualizacją / przedłużeniem umowy na czas określony na kolejny okres. W myśl zasady tego typu zatrudnienia powinno być przekazane podwójnie tzn. raz z informacją o zamknięciu okresu zatrudnienia w ramach istniejącej umowy oraz ponownie z podaniem nowej daty zatrudnienia po wygaśnięciu umowy tymczasowej. Dokument Utworzył: Opis procesu masowego importu danych do systemu PON-on Marek Michajłowicz Kod zdarz enia Typ Zdarze nia Grupa błędów Kategoria błędu Dotyczy Etap walidacji 66 K Błędy wstępnej walidacji Student I 67 K Błędy wstępnej walidacji Struktury pliku I 68 K Błędy wstępnej walidacji Struktury pliku I Ostatnia modyfikacja: 2011-11-21 Wersja: 2.3.0 Reguła walidacyjna Opis biznesowy (Komunikat błędu) 2011-07-20 Status: Uwagi (Instrukcja postępowania dla pracownika Uczelni) (GInterfejs użytkowni ka,I import masowy) Data utworzenia: Sugerowane działanie Jeśli w polu Czy student pobiera pomoc materialną (pobieraPomocMaterialna) zaznaczone "T" musi być wprowadzona min. jedna wartość w polu Rodzaj przyznanych świadczeń pomocy materialnej w uczelni publicznej i niepublicznej (rodzajPrzyznanychSwiadczen) Plik musi zawierać dane chociaż jednego zidentyfikowanego obiektu (Student, Ankieta EN1) Identyfikatory kierunków w polach minimimum kadrowego nie mogą być takie same :<kierunekInstancja01Id> ;<kierunekInstancja02Id> Obowiązujący Strona: Dla studenta pobierającego pomoc materialną, nie wprowadzono rodzaju otrzymywanej pomocy materialnej. Nie zidentyfikowano żadnego z wymaganych obiektów importu (Student, Pracownik, Doktorant, Ankieta EN-1) Identyfikatory kierunków w polach minimimum kadrowego nie mogą być takie same (dotyczy pól <kierunekInstancja01Id>, <kierunekInstancja02Id> w sekcji minimum kadrowe). 54 / 64 Wyeliminowanie przetwarzania pustych plików korekta pliku Dokument Utworzył: Kod zdarz enia Typ Zdarze nia Grupa błędów 69 K Błędy importu Opis procesu masowego importu danych do systemu PON-on Marek Michajłowicz Kategoria błędu Dotyczy Etap walidacji Ostatnia modyfikacja: 2011-11-21 Wersja: 2.3.0 Reguła walidacyjna Opis biznesowy (Komunikat błędu) Data utworzenia: 2011-07-20 I Status: Uwagi (Instrukcja postępowania dla pracownika Uczelni) (GInterfejs użytkowni ka,I import masowy) Pracownik.B łędy minimum kadrowego Sugerowane działanie Weryfikacja na podstawie pola rok akademicki w minimum kadrowym: Dla lat <= 2011 jeden nauczyciel akademicki może być wliczony do minimum kadrowego nie więcej niż dwukrotnie, z tym że tylko do jednego minimum kadrowego kierunku studiów drugiego stopnia albo kierunku jednolitych studiów magisterskich, oraz zasady, iż w przypadku, gdy podstawowa jednostka organizacyjna uczelni prowadzi na danym kierunku studia pierwszego i drugiego stopnia, do minimum kadrowego studiów pierwszego stopnia mogą być również wliczani nauczyciele akademiccy stanowiący minimum kadrowe kierunku studiów drugiego stopnia, a także proporcje liczby tych pracowników do liczby studentów na danym kierunku studiów; korekta pliku Przypisując pracownika do minimum kadrowego dwóch instancji kierunku dozwolone jest tylko przypisanie do kierunków poziomu I+II Dla lat > 2011 (nowa wersja ustawy) stopień kierunków studiów nie da się przeliczyć na stopień minimum kadrowego. Zła kombinacja: JM+I, ObowiązującyJM+II, II+II, JM+JM. Strona: 55 / 64 Nieprawidłowo zdefiniowane stopnia kierunku studiów dla minimum kadrowego. Podane kody kierunków w oświadczeniu odnoszą się do kierunków określonych w systemie jako kombinacja stopnii JM+I lub JM+II; Dokument Utworzył: Kod zdarz enia Typ Zdarze nia 70 K 78 K Grupa błędów Opis procesu masowego importu danych do systemu PON-on Marek Michajłowicz Kategoria błędu Dotyczy Etap walidacji Ostatnia modyfikacja: 2011-11-21 Wersja: 2.3.0 Reguła walidacyjna Opis biznesowy (Komunikat błędu) Błędy importu Data utworzenia: Data wyrejestrowani a studenta, wcześniejsza niż data zarejestrowani a. 2011-07-20 I Student I stopnie w Instacje kierunków minimum kadrowego są różne od wartości wpisanej <minimumKadrowe><stopienStudiow>... </stopienStudiow> Status: Uwagi (Instrukcja postępowania dla pracownika Uczelni) (GInterfejs użytkowni ka,I import masowy) Pracownik.B łędy minimum kadrowego Sugerowane działanie Data wyrejestrowania studenta z kierunku (dataWyrejestrowaniaStudenta) nie może być wczesniejsza niż Data zarejestrowania studenta na kierunku studiów (dataZarejestrowaniaStudenta) Obowiązujący Strona: Nieprawidłowo zdefiniowane stopnie kierunków studiów dla minimum kadrowego. Podane kody kierunków w oświadczeniu odnoszą się do kierunków określonych w systemie w ramach innego stopnia niż podany w pliku. Data wyrejestrowania studenta z kierunku (dataWyrejestrowaniaStudenta) nie może być wczesniejsza niż Data zarejestrowania studenta na kierunku studiów (dataZarejestrowaniaStudenta) 56 / 64 w MinimumKadrowe w polu stopieńStudiów wybrano inny stopień niż wynika to z wybranych instancji kierunków kierunekInstancja01Idi kierunekInstancja02Id. Dokument Utworzył: Kod zdarz enia Typ Zdarze nia Grupa błędów 86 K Błędy importu Opis procesu masowego importu danych do systemu PON-on Marek Michajłowicz Kategoria błędu Dotyczy Etap walidacji Ostatnia modyfikacja: 2011-11-21 Wersja: 2.3.0 Reguła walidacyjna Opis biznesowy (Komunikat błędu) (Instrukcja postępowania dla pracownika Uczelni) (GInterfejs użytkowni ka,I import masowy) Data utworzenia: Czy wypełnione pole zwolniony z opłat za studia 2011-07-20 Student I/G Status: Sugerowane działanie Jeśli w polu Pierwszy kierunek studiów stacjonarnych (pierwszyKierunek) podano wartość "N", to pole Zwolniony z opłat za studia (zwolnionyZOplatZaStudia) musi być uzupełnione. W roku akademickim 2011 / 2012 wszystkie kierunki stacjonarne uczelni publicznych są kwalifikowane jako zwolnione z opłat. Dla uczelni niepublicznych wartość ta jest domyślnie usuwana, jeśli wystąpi (do bazy nie powinna zostać zapisana żadna informacja o odpłatności dla kierunków niepublicznych). Obowiązujący Strona: Pole zwolnionyZOplatZaStudi musi być uzupełnione dla wszytskich kierunków, które nie są oznaczone jako pierwsze. ----------------------------Komunikat dla plików importowanych w okresie do 30.06.2012: " W roku akademickim 2011/2012 obowiązuje reguła kwalifikująca domyślnie wszystkie kierunki stacjonarne na uczelniach publicznych jako zwolnione z opłat. Dla kierunku <idKierunku>/<nazwaKierunku> dokonano zmiany podanej wartości pola <nazwapola> na <parametr>. " 57 / 64 Uwagi Opis procesu masowego importu danych do systemu PON-on Dokument Utworzył: Kod zdarz enia Typ Zdarze nia Grupa błędów 87 K Błędy importu 89 K Błędy importu 90 K Błędy importu Marek Michajłowicz Kategoria błędu Dotyczy Etap walidacji Ostatnia modyfikacja: 2011-11-21 Wersja: 2.3.0 Reguła walidacyjna Opis biznesowy (Komunikat błędu) (Instrukcja postępowania dla pracownika Uczelni) (GInterfejs użytkowni ka,I import masowy) Data utworzenia: Student rozpoczął jeszcze raz studia na tym samym kierunku. 2011-07-20 Student I PracownikBłędy zatrudnienia PracownikBłędy zatrudnienia I I Status: Sugerowane działanie Jeśli student posiada już relację z raportowanym kierunkiem, należy zweryfikować, czy zgadza się data zarejestrowania studenta na kierunku studiów z XMLa(dataZarejestrowaniaStudenta) i w bazie (SAD_KIERUNEK.DATA_ROZPOCZECI A). Jeśli się nie zgadzają należy zweryfikować, czy w XMLu dla tego samego kierunku, jest informacja o wyrejestrowaniu studenta z kierunku(musi to być inny rekord tego samego kierunku i studenta, posiadający uzupełnione pole dataWyrejestrowaniaStudenta). Jeśli go nie posiada, to jest to błąd i należy przerwać import. stanowisko DataObjecia jest polem wymaganym dla Nauczyciela Akademickiego Data zatrudnienia (dataOd) <= data systemowa Obowiązujący Strona: Podjęto ponowną próbę zarejestrowania studenta na kierunku, do którego jest już przypisany (istnieje rozbieżność pomiędzy datami zarejestrowania studenta, pomiędzy plikiem XML a bazą danych). Do zarejestrowania, studenta ponownie na tym samym kierunku, konieczne jest wskazanie daty wyrejestrowania studenta z poprzedniej edycji studiów. stanowisko DataObjecia jest polem wymaganym dla Nauczyciela Akademickiego Data zatrudnienia nie może być datą z przyszłości 58 / 64 Uwagi Dokument Utworzył: Kod zdarz enia Typ Zdarze nia Grupa błędów 94 O Ostrzeżenia 91 K 96 97 Opis procesu masowego importu danych do systemu PON-on Marek Michajłowicz Kategoria błędu Dotyczy Etap walidacji Ostatnia modyfikacja: 2011-11-21 Wersja: 2.3.0 Reguła walidacyjna Opis biznesowy (Komunikat błędu) (Instrukcja postępowania dla pracownika Uczelni) (GInterfejs użytkowni ka,I import masowy) Student I W pliku xml jest odwołanie do id kierunku, który nie istnieje Kierunek o podanym Id {id} nie istnieje. Błędy importu PracownikStopień Naukowy I/G K Błędy wstępnej walidacji Struktury pliku I K Błędy wstępnej walidacji Struktury pliku I Pracownik nie może być przypisany do minimum związanego z uprawnieniem jednostki do nadawania stopnia naukowego, jeśli sam nie posiada stopnia naukowego Sprawdzenie czy w stopniu naukowym została podana nazwa dyscypliny i dziedziny dla klasyfikacji historycznej lub kod dyscypliny dla innych rodzajów klasyfikacji Sprawdzenie czy w tytule naukowym została podana nazwa dziedziny dla klasyfikacji historycznej lub kod dziedziny dla innych rodzajów klasyfikacji Pracownik musi posiadać stopień naukowy w dyscyplinie do której odnosi się nowe uprawnienie do nadawania stopni Wymagane jest podanie kodu dyscypliny dla klasyfikacji innej niż KLAS_HIST. Wymagane jest podanie nazwy dyscypliny dla klasyfikacji KLAS_HIST. Wymagane jest podanie kodu dziedziny dla klasyfikacji innej niż KLAS_HIST Wymagane jest podanie nazwy dziedziny dla klasyfikacji KLAS_HIST Data utworzenia: Kierunek o podanym id nie istnieje. 2011-07-20 Status: Sugerowane działanie Obowiązujący Strona: 59 / 64 Uwagi Dokument Utworzył: Kod zdarz enia Typ Zdarze nia Grupa błędów 99 K Błędy wstępnej walidacji 100 K 103 K 106 K Opis procesu masowego importu danych do systemu PON-on Marek Michajłowicz Kategoria błędu Dotyczy Etap walidacji Ostatnia modyfikacja: 2011-11-21 Wersja: 2.3.0 Reguła walidacyjna Opis biznesowy (Komunikat błędu) (Instrukcja postępowania dla pracownika Uczelni) (GInterfejs użytkowni ka,I import masowy) Pracownik I W przypadku wystąpienia sekcji Tytuł Zawodowy w pliku XML wymagane jest podanie informacji o dowiązaniu do jednostki i definicji kierunku. W pliku muszą wystąpić dane dla pól instytucjaId i kierunekKod dla instytucji dostępnej w systemie lub nazwaKierunku i nazwaUczelni w przypadku instytucji historycznych Błędy importu Pracownik I Błędy wstępnej walidacji Błędy importu Pracownik I/G PracownikBłędy zatrudnienia I Data objęcia stanowiska musi być większa lub równa dacie nawiązania stosunku pracy Jeżeli zatrudnienie jest na czas określony należy podać datę zakończenia stosunku pracy Zatrudnienie wymiarCzasuPracyCalosc lub wymiarCzasuPracyCzesc większe od 100 Data utworzenia: Tytuł zawodowy pracownika 2011-07-20 Status: Sugerowane działanie Obowiązujący Strona: W przypadku wystąpienia sekcji Tytuł Zawodowy w pliku XML wymagane jest podanie informacji o dowiązaniu do jednostki i definicji kierunku. W pliku muszą wystąpić dane dla pól instytucjaId i kierunekKod dla instytucji dostępnej w systemie lub nazwaKierunku i nazwaUczelni w przypadku instytucji historycznych Data objęcia stanowiska musi być większa lub równa dacie nawiązania stosunku pracy Jeżeli zatrudnienie jest na czas określony należy podać datę zakończenia stosunku pracy Wymiar czasu pracy podany w zatrdunieniu, w polu <wymiarCzasuPracyCalosc> nie może być większy niż 100 60 / 64 Uwagi Dokument Utworzył: Opis procesu masowego importu danych do systemu PON-on Marek Michajłowicz Kategoria błędu Dotyczy Etap walidacji Ostatnia modyfikacja: 2011-11-21 Wersja: 2.3.0 Kod zdarz enia Typ Zdarze nia Grupa błędów Reguła walidacyjna Opis biznesowy (Komunikat błędu) 107 O Błędy wstępnej walidacji Struktury pliku I Walidator sprawdzający czy kod instytucji podany w imporcie nie jest zdupilikowany w systemie 108 K Błędy wstępnej walidacji Struktury pliku I Walidator sprawdzający czy kod dyscypliny podany w pliku istnieje w bazie i odnosi się do dyscypliny. Dwa rodzaje błędów: 1. Gdy podano kod obszaru ze słownika CKSST w miejscu dyscypliny: Zdarzenie nr. 108: Podany kod dyscypliny 'OB05' nie zawiera pozycji nadrzędnych (czyli dziedziny). Prawdpoodbnie wartość 'OB05' nie wskazuje na kodDyscypliny. 2. Gdy podano kod który nie istnieje w bazie: Zdarzenie nr. 108: Podany kod dyscypliny 'DS020109' nie występuje w słowniku dyscyplin CKSST (Instrukcja postępowania dla pracownika Uczelni) (GInterfejs użytkowni ka,I import masowy) Data utworzenia: 2011-07-20 Status: Sugerowane działanie Obowiązujący Strona: Zdarzenie nr. 107: Podany kod instytucji 'PW' został zduplikowany w systemie. Prosimy o zalogowanie i weryfikację przypisania z poziomu aplikacji. W przypadku rozbieżności prosimy o zgłoszenie blędu. Dwa rodzaje błędów: 1. Gdy podano kod obszaru ze słownika CKSST w miejscu dyscypliny: Zdarzenie nr. 108: Podany kod dyscypliny 'OB05' nie zawiera pozycji nadrzędnych (czyli dziedziny). Prawdpoodbnie wartość 'OB05' nie wskazuje na kodDyscypliny. 2. Gdy podano kod który nie istnieje w bazie: Zdarzenie nr. 108: Podany kod dyscypliny 'DS020109' nie występuje w słowniku dyscyplin CKSST 61 / 64 Uwagi Dokument Utworzył: Opis procesu masowego importu danych do systemu PON-on Marek Michajłowicz Kategoria błędu Dotyczy Etap walidacji Ostatnia modyfikacja: 2011-11-21 Wersja: 2.3.0 Kod zdarz enia Typ Zdarze nia Grupa błędów Reguła walidacyjna Opis biznesowy (Komunikat błędu) 110 K Błędy wstępnej walidacji Struktury pliku I/ G Dla zatrudnienia jako <pracownikNaukowyZatrudnienie> wymagane jest podanie albo pola <stanowiskoKod> albo <stanowiskoNazwa> 111 O Błędy importu PracownikBłędy zatrudnienia I/G 114 K Błędy wstępnej walidacji Pracownik tytuł naukowy I zgodaRektDodZatrData - dla dodatkowego zatrudnienia powinna być podana w ramach aktywnego podstawowego zatrudnienia. Pracownik może podjąć dodatkowe zatrudnienie w ramach innej jednostki tylko, gdy uzyska zgodę rektora ( dotyczy podstawowego zatrudnienia) Walidacja XSD nie sprawdza czy <dziedzinaKod> lub <dziedzinaNazwa> instnieje w TytuleNaukowym. Dla CKSST musi być podany dziedzinaKod, a dla KLAS_HIST musi być podana <dziedzinaNazwa> (Instrukcja postępowania dla pracownika Uczelni) (GInterfejs użytkowni ka,I import masowy) Data utworzenia: 2011-07-20 Status: Sugerowane działanie Obowiązujący Strona: Nie podano żadnego z pól wymagalnych dla określenia stanowiska. W sekcji <pracownikNaukowyZatrudnieni e> powinna wystąpić jedna z pozycji : <stanowiskoKod> lub <stanowiskoNazwa> Brak zgody rektora na podjęcie dodatkowego zatrudnienia. Dotyczy <lista aktywnych zatrudnień podstawowych> w <jednostce>. Nie podano żadnej wartości definiującej dziedzinę w jakiej uzyskany został stopień naukowy - <dziedzinaKod> lub <dziedzinaNazwa> . Dla klasyfikacji 'CKSST' musi być podana dziedzinaKod, a dla 'KLAS_HIST' musi być podana <dziedzinaNazwa> 62 / 64 Uwagi Dokument Utworzył: Opis procesu masowego importu danych do systemu PON-on Marek Michajłowicz Etap walidacji Wersja: 2.3.0 Typ Zdarze nia Grupa błędów 115 K Błedy wstępnej walidacji Pracownik naukowy zatrudnienie I Pole <nauczycielAkademickiKod> powinno być podane dla nauczyciela akademickiego. Nie podano pozycji <nauczycielAkademickiKod> dla nauczyciela akademickiego 116 K Błedy wstępnej walidacji Student I Dla studenta uczelni publicznej, studiów stacjonarnych wymagalne pola: limitPunktowEcts; liczbaWolnychPunktowEcts; Dla pozostałych studentów nie wymagane podawanie danych: limitPunktowEcts; liczbaWolnychPunktowEcts; W przypadku wystąpienia tych wartości w pliku importu, powinny one zostać wykasowane. REG_1: Nie podano pól wymaganych dla studenta uczelni publicznej studiów stacjonarnych: <limitPunktowEcts>, <liczbaWolnychPunktowEcts> O Dotyczy 2011-11-21 Kod zdarz enia 117 Kategoria błędu Ostatnia modyfikacja: Reguła walidacyjna Opis biznesowy (Komunikat błędu) (Instrukcja postępowania dla pracownika Uczelni) (GInterfejs użytkowni ka,I import masowy) Ostrzeżenia Data utworzenia: 2011-07-20 Student I Status: Sugerowane działanie W roku akademickim 2011/2012 wszystkie kierunki na uczelniach publicznych są domyślnie traktowane jako pierwsze (Domyślna wartość pola dla wszystkich kierunków „T” ). Należy dostosować działanie walidatora do Obowiązujący Strona: REG_2: Dane limitPunktowEcts, liczbaWolnychPunktowEcts są wymagalne wyłącznie dla studiów stacjonarnych uczelni publicznej. Informacja z pliku została zignorowana. 1. Komunikat dla plików importowanych w okresie do 30.06.2012: " W roku akademickim 2011/2012 obowiązuje reguła kwalifikująca domyślnie wszystkie kierunki na 63 / 64 Uwagi Dokument Utworzył: Kod zdarz enia Typ Zdarze nia Grupa błędów Opis procesu masowego importu danych do systemu PON-on Marek Michajłowicz Kategoria błędu Dotyczy Etap walidacji Ostatnia modyfikacja: 2011-11-21 Wersja: 2.3.0 Reguła walidacyjna Opis biznesowy (Komunikat błędu) (Instrukcja postępowania dla pracownika Uczelni) (GInterfejs użytkowni ka,I import masowy) powyższej reguły. Dane w bazie ustawiane domyślnie według podanego klucza: - jeżeli uczelnia niepubliczna -> żadna informacja o tym, czy kierunek jest kwalifikowany jako pierwszy lub kolejny, nie powinna być zapisana w systemie. W przypadku wystąpienia wartości w pliku, informacja o nie wprowadzeniu wartości do bazy zwrócona w komunikacie dla użytkownika - jeżeli uczelnia publiczna -> wprowadź domyślnie "pierwszyKierunek" = T; zwolnionyZOplatZaStudia = T. Jeżeli w pliku zdefiniowano wartość na "N", należy dokonać jej zmiany. Użytkownikowi powinien zostać zwrócony komunikat o wprowadzeniu do systemu innej wartości od zadeklarowanej. Data utworzenia: 2011-07-20 Status: Sugerowane działanie Obowiązujący Strona: uczelniach publicznych jako pierwsze. Dla kierunku <idKierunku>/<nazwaKierunku> dokonano zmiany podanej wartości pola <nazwapola> na <parametr>. " 2. Komunikat dla uczelni niepublicznych: Uczelnie niepubliczne nie posiadają obowiązku raportowania informacji o kwalifikacji kierunku jako pierwszy lub drugi. Informacja z pliku została zignorowana. {komunikat o ignorowaniu pola <pierwszyKierunek> dla uczelnia niepublicznych} 64 / 64 Uwagi