com.suncode.pwfl.workflow.activity

Interface ActivityService

public interface ActivityService

Umożliwia zarządzanie zadaniami.

Author:

Paweł Rosolak 04-10-2012

Method Summary

Modifier and Type	Method and Description
void	acceptActivity(AcceptationDefinition definition) Akceptuje zadanie.
void	addActivityDelegation(DelegatedActivity da) Dodaje zastępstwo
void	changeState(String processId, String activityId, ActivityState state) Zmienia status zadania
boolean	changeStateIfPossible(String processId, String activityId, ActivityState state) Zmienia status zadania, jeżeli obecny status można zmienić na nowy.
void	deleteActivityDelegation(DelegatedActivity da) Dodaje zastępstwo
Activity	getActivity(String processId, String activityId, String... joins) Pobiera informacje o zadaniu
Map<String,Object>	getActivityContext(String processId, String activityId) Metoda służy do pobierania kontekst mapy zadania(zawiera wszystkie zmienne i ich wartości z zadania)
DelegatedActivity	getActivityDelegation(String activityId, String userName) Pobiera informacje o zastępstwie
List<DelegatedActivity>	getActivityDelegations(String activityId, String userName) Zwraca informacje o wszystkich zastępstwach
String	getActivityName(String processDefId, String activityDefId)
List<String>	getAssignments(String processId, String activityId) Pobiera informacje o przypisanych do zadania użytkownikach
void	openActivity(String userName, String processId, String activityId) Uruchamia zadanie jako podany użytkownik.
void	openActivity(String userName, String userPassword, String processId, String activityId) Deprecated. User password is not required anymore. Use openActivity(String, String, String) instead.
void	openActivity(String domain, String userName, String userPassword, String processId, String activityId) Deprecated. Domain and user password is not required anymore. Use openActivity(String, String, String) instead.
void	setActivityContext(String processId, String activityId, Map<String,Object> activityContext) Ustawia mapę zmiennych zadania

Method Detail

openActivity

void openActivity(String userName,
                  String processId,
                  String activityId)
           throws UserIsNotAssignedToActivityException,
                  ActivityAlreadyCompletedException,
                  ActivityIsSuspendedException

Uruchamia zadanie jako podany użytkownik. Po zakończeniu funkcji, zadanie zmienia status na uruchomione.

Parameters:

userName - Login użytkownika, którym chcemy uruchomić zadanie

processId - Id procesu

activityId - Id zadania

Throws:

UserIsNotAssignedToActivityException

ActivityAlreadyCompletedException

ActivityIsSuspendedException

openActivity

@Deprecated
void openActivity(String userName,
                              String userPassword,
                              String processId,
                              String activityId)
                       throws UserIsNotAssignedToActivityException,
                              ActivityAlreadyCompletedException,
                              ActivityIsSuspendedException

Deprecated. User password is not required anymore. Use openActivity(String, String, String) instead.

Uruchamia zadanie jako podany użytkownik. Po zakończeniu funkcji, zadanie zmienia status na uruchomione.

Parameters:

userName - Login użytkownika, którym chcemy uruchomić zadanie

userPassword - Hasło użytkownika

processId - Id procesu

activityId - Id zadania

Throws:

UserIsNotAssignedToActivityException

ActivityAlreadyCompletedException

ActivityIsSuspendedException

openActivity

@Deprecated
void openActivity(String domain,
                              String userName,
                              String userPassword,
                              String processId,
                              String activityId)
                       throws Exception

Deprecated. Domain and user password is not required anymore. Use openActivity(String, String, String) instead.

Uruchamia zadanie jako podany użytkownik. Po zakończeniu funkcji, zadanie zmienia status na uruchomione.

Parameters:

domain - Domena użytkownika

userName - Login użytkownika, którym chcemy uruchomić zadanie

userPassword - Hasło użytkownika

processId - Id procesu

activityId - Id zadania

Throws:

Exception

setActivityContext

void setActivityContext(String processId,
                        String activityId,
                        Map<String,Object> activityContext)

Ustawia mapę zmiennych zadania

Parameters:

processId - Id procesu

activityId - Id zadania

activityContext - Mapa zmiennych zadania

getActivityContext

Map<String,Object> getActivityContext(String processId,
                                      String activityId)

Metoda służy do pobierania kontekst mapy zadania(zawiera wszystkie zmienne i ich wartości z zadania)

Parameters:

processId - Id procesu

activityId - Id zadania

Returns:

Zwaraca mapę zmiennych zadania

getActivity

Activity getActivity(String processId,
                     String activityId,
                     String... joins)

Pobiera informacje o zadaniu

Parameters:

processId - Id procesu

activityId - Id zadania

joins - Określa, które elementy mamy dołączyć do obiektu zadania.

Returns:

Zwraca informacje o zadaniu

getActivityDelegation

DelegatedActivity getActivityDelegation(String activityId,
                                        String userName)

Pobiera informacje o zastępstwie

Parameters:

activityId - Id zadania

userName - Użytkownik, który zastępuje pierwotnego użytkownika

Returns:

Zwraca null jeżeli podany użytkownik nie jest zastępcą w tym zadaniu

getActivityDelegations

List<DelegatedActivity> getActivityDelegations(String activityId,
                                               String userName)

Zwraca informacje o wszystkich zastępstwach

Parameters:

activityId - Id zadania

userName - Użytkownik, który zastępuje pierwotnego użytkownika

Returns:

Zwraca null jeżeli podany użytkownik nie jest zastępcą w tym zadaniu

addActivityDelegation

void addActivityDelegation(DelegatedActivity da)

Dodaje zastępstwo

Parameters:

da - Definicja zastępstwa

deleteActivityDelegation

void deleteActivityDelegation(DelegatedActivity da)

Dodaje zastępstwo

Parameters:

da - Definicja zastępstwa

acceptActivity

void acceptActivity(AcceptationDefinition definition)

Akceptuje zadanie. Użytkownik nie musi mieć zadania przypisanego do siebie, jeżeli parametr ignoreOwnerShip w definicji jest ustawiony na true.

Parameters:

definition - Definicja akceptacji zadania

getAssignments

List<String> getAssignments(String processId,
                            String activityId)

Pobiera informacje o przypisanych do zadania użytkownikach

Parameters:

activityId - Id zadania

Returns:

Zwraca listę loginów użytkowników przypisanych do zadania

getActivityName

String getActivityName(String processDefId,
                       String activityDefId)

changeState

void changeState(String processId,
                 String activityId,
                 ActivityState state)

Zmienia status zadania

Parameters:

processId - Id procesu

activityId - Id zadania

state - Status zadania, który chcemy ustawić

changeStateIfPossible

boolean changeStateIfPossible(String processId,
                              String activityId,
                              ActivityState state)

Zmienia status zadania, jeżeli obecny status można zmienić na nowy. W odróżnieniu do {changeState(String, String, ActivityState) jeżeli nie można zmienić statusu z powodu niekompatybilnego obecnego statusu zadania, nie zostanie rzucony żaden wyjątek. Jedynie w logach będzie informacja, że nie można mienić statusu takiego zadania.

Parameters:

processId - Id procesu

activityId - Id zadania

state - Status zadania, który chcemy ustawić

Returns:

true - jeżeli status został zmieniony, false - jeżeli nie udało się zmienić statusu.

Throws:

ServiceException - Wyjątek rzucony w przypadku nieoczekiwanego błędu.