/**
 * Dezaktywuje użytkownika. Wszystkie widoki, zastępstwa, powiadomienia, raporty i otwarte zadania oraz możliwe
 * przyszłe zadania użytkownika zostaną przepisane do admina.
 * 
 * @param userName Login użytkownika
 * @author Paweł Rosolak 16 paź 2013
 */
void deactivateUser( String userName );
 
/**
 * Dezaktywuje użytkownika.
 * 
 * @param deactivation Obiekt zawierający wszystkie informacje niezbędne do dezaktywacji użytkownika.
 * @author Rafał Nowacki 05-12-2014
 */
void deactivateUser( Deactivation deactivation );

Pierwsza metoda wykonuje dezaktywację i domyślnie wszystko przekazywane jest do użytkownika o loginie 'admin'. Druga metoda pozwala na konfigurację wszystkich przypisań za pomocą obiektu 

Obiekt Deactivation

Tworzenie obiektu odbywa się następująco:

 Deactivation deactivation = Deactivation.create( userNameToDeactivate );

Utworzony obiekt posiada uzupełnione następujące informacje:

• użytkownik dezaktywowany:

  Code Block
  language java theme Eclipse

• linenumbers true

  User userToDeactivate = deactivation.getUser();

• lista wszystkich procesów, ról i zadań w formie drzewiastej:

  Code Block
  language java theme Eclipse

• linenumbers true

  List<DeactivationProcess> processes = deactivation.getProcesses(); for(DeactivationProcess process : processes) { List<DeactivationParticipant> participants = process.getParticipants(); for ( DeactivationParticipant participant : participants ) { List<DeactivationActivity> activities = participant.getActivities(); } }

• lista domyślnych użytkowników, pobranych z pliku konfiguracyjnego z parametru EmptyTaskUserName. Użytkownicy ci są wykorzystywani do przypisywania zadań, które nie mają określonych przypisań:

  Code Block
  language java theme Eclipse linenumbers true
  List<User> defaultUsers = deactivation.getDefaultUsers();

Mając obiekt deactivation należy w nim ustawić następujące parametry:

//Ustawia użytkownika, któremu zostaną przepisane zastępstwa.
deactivation.setSubstitutionUser( substitutionUser );
 
//Ustawia użytkownika, któremu zostaną przepisane widoki.
deactivation.setViewUser( viewUser );
 
//Ustawia użytkownika, któremu zostaną przepisane raporty.
deactivation.setReportUser( reportUser );
 
//Ustawia użytkownika, któremu zostaną przepisane powiadomienia.
deactivation.setNotificationUser( notificationUser );

Ostatnią rzeczą, jaką należy zrobić, jest określenie do jakich użytkowników mają trafić istniejące instancje zadań użytkownika oraz możliwe przyszłe zadania. W przypadku istniejących instancji zadań wymagane jest, aby ustawić przypisania dla tych definicji zadań. Pozostałe zadania nie muszą być przypisywane. W takim wypadku zostaną do nich przypisani domyślni użytkownicy zdefiniowani w pliku konfiguracyjnym z parametru EmptyTaskUserName.

Przypisanie zadań może nastąpić z następujących poziomów:

• obiekt dezaktywacji - przypisania zostaną ustawione dla wszystkich zadań,
• poziom procesu - przypisania zostaną ustawione dla wszystkich zadań z procesu,
• poziom roli - przypisania zostaną ustawione dla wszystkich zadań z roli,
• poziom zadania - przypisanie zostanie ustawione tylko dla tego zadania.

Przypisywać zadania możemy zarówno do pojedynczych użytkowników oraz do grup użytkowników.

//przypisanie użytkowników do wszystkich zadań
deactivation.setUsers( users );
//przypisanie grup użytkowników do wszystkich zadań
deactivation.setGroups( groups );
 
List<DeactivationProcess> processes = deactivation.getProcesses();
for(DeactivationProcess process : processes)
{
	//przypisanie użytkowników do wszystkich zadań z procesu
	process.setUsers( users );
	//przypisanie grup użytkowników do wszystkich zadań z procesu
	process.setGroups( groups );
	
	List<DeactivationParticipant> participants = process.getParticipants();
    for ( DeactivationParticipant participant : participants )
    {
		//przypisanie użytkowników do wszystkich zadań z roli
		participant.setUsers( users );
		//przypisanie grup użytkowników do wszystkich zadań z roli
		participant.setGroups( groups );
    	List<DeactivationActivity> activities = participant.getActivities();
		for( DeactivationActivity activity : activities )
		{
			if( activity.isAssigned() == true )
			{
				//obowiązkowo należy przypisać użytkownika, bądź grupę użytkowników do tego zadania
			}
			//przypisanie użytkowników do zadania
			activity.setUsers( users );
			//przypisanie grup użytkowników do zadania
			activity.setGroups( groups );
 
			//z poziomu zadania można również dodawać użytkownika, bądź grupę pojedynczo
			activity.addUser( user );
			activity.addGroup( group );
		}
    }
}

Walidacja

• dezaktywowany użytkownik musi istnieć,
• dezaktywowany użytkownik musi być aktywny  (czyli nie może być już wcześniej zdezaktywowany),
• użytkownik, któremu zostaną przypisane zastępstwa musi być ustawiony oraz nie może być nim użytkownik, którego dotyczy dezaktywacja,
• użytkownik, któremu zostaną przypisane widoki musi być ustawiony oraz nie może być nim użytkownik, którego dotyczy dezaktywacja,
• użytkownik, któremu zostaną przypisane raporty musi być ustawiony oraz nie może być nim użytkownik, którego dotyczy dezaktywacja,
• użytkownik, któremu zostaną przypisane powiadomienia musi być ustawiony oraz nie może być nim użytkownik, którego dotyczy dezaktywacja,
• zadania, których instancje posiada dezaktywowany użytkownik, muszą mieć przypisanych użytkowników lub grupy, w przypadku przypisania użytkownika dezaktywowanego, nie jest on brany pod uwagę.

Operacje wykonywane podczas dezaktywacji użytkownika

• zapisanie przekierowań zadań z użytkownika dezaktywowanego do innych użytkowników, bądź grup, w przypadku możliwych przyszłych zadań, które mogłyby trafić do już zdezaktywowanego użytkownika,
• przepisanie instancji zadań zdezaktywowanego użytkownika do zdefiniowanych użytkowników,
• zastępstwom, w których dezaktywowany użytkownik jest zastępcą zostaje zmieniony zastępca na zdefiniowanego użytkownika,
• zastępstwa, w których dezaktywowany użytkownik jest zastępowanym zostają usunięte,
• widoki zdezaktywowanego użytkownika zostają przepisane do zdefiniowanego użytkownika,
• udostępnienia widoków zdezaktywowanemu użytkownikowi zostają usunięte,
• raporty zdezaktywowanego użytkownika zostają przepisane do zdefiniowanego użytkownika,
• udostępnienia raportów zdezaktywowanemu użytkownikowi zostają usunięte,
• powiadomienia zdezaktywowanego użytkownika zostają przepisane do zdefiniowanego użytkownika,
  
• odłączenie zdezaktywowanego użytkownika od stanowisk,
• udostępnienia kalendarza zdezaktywowanemu użytkownikowi zostają usunięte,
• uprawnienia nadane zdezaktywowanemu użytkownikowi zostają usunięte,
• ustawienia konta zdezaktywowanego użytkownika zostają usunięte,
• zdefiniowany widok dokumentów użytkownika zostaje usunięty,
• usunięcie zdezaktywowanego użytkownika ze wszystkich grup,
• ustawienia użytkownika jako nieaktywnego.

Having a deactivation object, the following parameters should be set in it:

//Sets the user to whom substitutions will be prescribed.
deactivation.setSubstitutionUser( substitutionUser );
 
//Sets the user to whom the views will be rewritten.
deactivation.setViewUser( viewUser );
 
//Sets the user to whom the reports will be rewritten.
deactivation.setReportUser( reportUser );
 
//Sets the user to whom notifications will be rewritten.
deactivation.setNotificationUser( notificationUser );

The last thing to do is to specify to which users existing user task instances and possible future tasks should go. For existing task instances, it is required to set assignments for these task definitions. Other tasks do not need to be assigned. In this case, the default users defined in the configuration file from the EmptyTaskUserName parameter will be assigned to them.

Assignment of tasks can be done from the following levels:

• deactivation object - assignments will be set for all tasks,

• process level - assignments will be set for all tasks from the process,

• role level - assignments will be set for all tasks from a role,

• task level - assignments will be set only for this task.

You can assign tasks to both individual users and groups of users.

//assign users to all tasks
deactivation.setUsers( users );
//assign groups to all tasks
deactivation.setGroups( groups );
 
List<DeactivationProcess> processes = deactivation.getProcesses();
for(DeactivationProcess process : processes)
{
	//assign users to all tasks from the process
	process.setUsers( users );
	//assign user groups to all tasks from the process
	process.setGroups( groups );
	
	List<DeactivationParticipant> participants = process.getParticipants();
    for ( DeactivationParticipant participant : participants )
    {
		//assign users to all tasks from the role
		participant.setUsers( users );
		//assign user groups to all tasks from the role
		participant.setGroups( groups );
    	List<DeactivationActivity> activities = participant.getActivities();
		for( DeactivationActivity activity : activities )
		{
			if( activity.isAssigned() == true )
			{
				//obowiązkowo należy przypisać użytkownika, bądź grupę użytkowników do tego zadania
			}
			//assigning users to a task
			activity.setUsers( users );
			//assign user groups to the task
			activity.setGroups( groups );
 
			//from the task level, you can also add a user or group individually
			activity.addUser( user );
			activity.addGroup( group );
		}
    }
}

Validation

• the deactivated user must exist,

• the deactivated user must be active (i.e., it cannot have been deactivated before),

• the user to whom substitutions will be assigned must be set and must not be the deactivated user,

• the user to whom the views will be assigned must be set up and must not be the user to whom the deactivation applies,

• the user to whom reports will be assigned must be set and must not be the user affected by the deactivation,

• the user to whom notifications will be assigned must be set and must not be the user affected by the deactivation,

• tasks whose instances are held by a deactivated user must have users or groups assigned to them, if a deactivated user is assigned, it is not taken into account.

Operations performed during user deactivation

• saving task redirections from a deactivated user to other users, or groups, for possible future tasks that could go to an already deactivated user,

• rewriting task instances of the deactivated user to defined users,

• substitutions in which the deactivated user is a substitute are changed to the defined user,

• substitutions in which the deactivated user is a substitute are deleted,

• views of the deactivated user are rewritten to the defined user,

• view shares of the deactivated user are deleted,

• reports of the deactivated user are rewritten to the defined user,

• report releases to the deactivated user are deleted,

• notifications of the deactivated user are rewritten to the defined user,

• disconnection of deactivated user from jobs,

• calendar accesses to the deactivated user are deleted,

• permissions granted to the deactivated user are deleted,

• account settings of the deactivated user are deleted,

• the user's defined document view is deleted,

• deleting the deactivated user from all groups,

• setting the user as inactive.