Opis:

Moduł służy do automatycznego przepisania zadań na innych użytkowników po określonym czasie.

Po wgraniu modułu pojawi się nowa zakładka "Automatyczne przepisywania zadań" w Administracja > Konfiguracja systemu. W zakładce tej można skonfigurować jaki typ zadania (nazwa procesu i nazwa zadania) ma być przepisane.

Ustala się jak długo dany typ zadania pozostaje u danej osoby, określa się to za pomocą parametru termin. Wartość ta to ilość dni zwłoki. Można ustawić na 0 (natychmiast) lub na konkretną liczbę dni. Można też wybrać czy ma pomijać dni wolne . Przy zaznaczeniu opcji na tak, uwzględniane też są dni wolne wpisane w parametrach systemu.

Rodzaj przypisania określa do kogo ma zostać przepisane zadanie. Wartości to: Użytkownik, Symbol Stanowiska, Przełożony. Wartość przypisania jest uzależnione od wyboru rodzaju przepisania.

Tabele można sortować oraz wyszukiwać, operacje na wierszu to edycja danych oraz możliwość usunięcia wpisu.  Aby uruchomić moduł należy dodać specjalne zadanie zaplanowane "Uruchamia moduł automatycznego przenoszenia zadań" i ustawić cykliczny czas aktywacji.

Ograniczenia

Górnym ograniczeniem jest to że dla danego procesu i zadania może być tylko jeden wpis (jedna konfiguracja). To znaczy, że nie da się np ustawić dla takiego samego zadania przepisanie do przełożonego po 3 dniach i do konkretnej osoby po 2 dniach

Widok konfiguracji

Dodawanie nowej konfiguracji

W celu dodania nowego wpisu należy wcisnąć przycisk "Nowa definicja".

Pojawi się okno z konfiguracją:

Należy wybrać Nazwę procesu oraz Zadanie należące do tego procesu.

Termin – Ilość dni po których zadanie zostanie przepisane (liczone od daty utworzenia zadania lub od daty ostatniego przypisania). Jeżeli mamy ustawioną wartość 0, to zadania będą przepisywane zawsze po uruchomieniu zadania zaplanowanego.

Pominięcie dni wolnych: 

•  NIE - uwzględnia również dni wolne
• TAK - przy obliczaniu uwzględnia tylko dni robocze (dni wolne nie są liczone do terminu)

Uruchomienie modułu

Należy dodać nowe zadanie zaplanowane w Administracja > Konfiguracja systemu > Zadania zaplanowane.

Można użyć wyszukiwarki i znaleźć zadanie "Uruchamia moduł automatycznego przenoszenia zadań" lub wpisać w "Nazwa klasy" ścieżkę: "com.suncode.plugin.autotasktransfer.scheluedtasks.RunAutoTaskTransfer" i wybrać metodę. Następnie wystarczy określić "Okres powtórzeń" oraz ustawić jako "Zadanie aktywne".

Informacje o Bazie danych

Po wgraniu modułu do systemu zostaną utworzone dodatkowo 2 tabele: att_definition i att_lasttransfer.

Pierwsza służy do zapisywania konfiguracji (przechowuję acctivityDefId oraz processDefId zamiast nazw które są wyświetlane na stronie konfiguracyjnej modułu )

Druga tabela służy przechowywania informacji o ostatnim przepisaniu zadania. Informacja ta jest ważna ze względu na to żeby drugi raz zadanie nie zostało przepisane, oraz po to że jak nadal przekroczy termin żeby przepisało dalej np do kolejnego przełożonego. Data jest zapisywana w formacie liczbowym Timestamp ( w milisekundach)

Opis zachowania modułu

Kilka uwag co do zachowania się modułu

1.Formularz:

Przed zapisem sprawdza się , czy wymagane pola ("Nazwa procesu", "Zadanie", "Wartość przypisania")  są uzupełnione. Z tym, że dla typu "Przełożony"  pole "Wartość przypisania" pozostaje puste i zablokowane.

2.Zadanie zaplanowane

Zadanie zaplanowane wczytuje cała tabele konfiguracyjną ("att_definition") i dla każdego wpisu (wiersza) pobiera pasujące zadania. Wyszukuję wszystkie zadania, które mają ten sam processDefId, activityDefId, termin jest przekroczony (czyli minęło X dni od utworzenia zadania lub od ostatniego przepisania zadania) oraz status zdania jest otwarty (oczekuje na uruchomienie, uruchomiony lub otwarte). 

Następnie zadanie pobiera listę osób u których jest aktualnie zadanie i będzie je przepisywać do osoby wedle ustawień.  Po przepisaniu zapisuje informacje do tabeli "att_lasttransfer" z aktualną datą, aby zadanie nie zostało znowu przepisane. Zadania nie będą przepisane gdy nowy użytkownik jest ten sam co stary użytkownik, gdy użytkownik nie ma żadnego przełożonego, użytkownik nie istnieję, nie ma stanowiska lub nie ma przepisanej osoby do stanowiska. W takim przypadku data w  tabeli "att_lasttransfer" zostanie zaktualizowana i poleci stosowna informacje w logach.  W momencie wystąpienia błędu podczas przepisywania zadania  poleci błąd w logach, zadanie się nie wywali, ale data w tabeli "att_lasttransfer" nie zostanie zaktualizowana, dzięki czemu podczas kolejnego sprawdzania zadanie znowu będzie brane pod uwagę.

Kilka przykładów

Przykłady dla zastępstw

User2 oraz User3 zastępują User1

Status Projektu

MODPLWRKFL-399 - Getting issue details... STATUS

Modyfikacja rozszerzenia  MODPLWRKFL-403 - Getting issue details... STATUS

W tym zadaniu zostały zastosowane kilka modyfikacji i rozszerzeń.

1. Znika ze strony konfiguracyjnej ilość pokazywanych wierszy w  tabeli, zamiast tego brana jest informacja z konfiguracji użytkownika systemowego.
2. Na stronie konfiguracyjnej w kolumnie "Wartość przypisania" teraz będzie pojawiać się imię i nazwisko dla użytkownika (jeżeli użytkownik nie posiada wpisanych danych w systemie to wyświetli się login)
3. Po udanym przepisaniu zadania do innej osoby, dodaję się automatycznie komentarz do procesu z informacją od jakich osób zostało przepisane zadania na jakie osoby
4. Dołożono opcje "Wszystkie procesy", "Wszystkie zadania" w polach odpowiednio "Nazwa procesu", "Zadanie". Opcja ta pozwala na wybranie wszystkich zadań  z aktualnego procesu lub ze wszystkich procesów (brane są pod uwagę tylko najnowsze pakiety). W bazie zapisuje się jako "*"
5. Do pola "Rodzaj przypisania" doszła nowa opcja Zastępca. Opcja ta pozwala przepisać zadanie do zastępców poszczególnych zadań, ale tylko gdy dana osoba ma zastępstwo w dniu przypisania zadania.  
6. Rozszerzeni walidacji formularza. Formularz ten wymaga aby wszystkie pola były uzupełnione (oprócz wartości przypisania gdy rodzaj przypisania jest "Przełożony" lub "Zastępca"). Termin nie może mieć wartości ujemnych.
7. Kolejność wykonywania konfiguracji od szczegóły do ogółu. Najpierw wykonają się definicje z podanymi procesami i zadaniami, potem konkretny proces, dowolne zadanie. Na końcu dowolny proces i dowolne zadanie.