Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Code Block
languagejava
titleOperacje na zadaniach
linenumberstrue
		// Pobieranie informacji o zadaniu
        Activity activity=activityService.getActivity( processId, activityId );
        String activityDefId=activity.getActivityDefinitionId();
        String desc=activity.getDescription();
        String name=activity.getName();
        ActivityState state=activity.getState();//RUNNING, NOT_STARTED, SUSPENDED, COMPLETED, TERMINATED, ABORTED
        Date created=activity.getCreatedTime();//data utworzenia zadani
        Date started=activity.getStartedTime();//data uruchomienia
       
        
        // Zmiana wartości zmiennych zadania
        Map<String,Object> activityContext=activityService.getActivityContext( processId, activityId );
        activityContext.put( "zmienna", "wartość" );    
        activityService.setActivityContext( processId, activityId, activityContext );
        
        
        //Otworzenie zadania przez podanego użytkownika. Jeżeli zadanie ma status 'Oczekujące na uruchomienie'
        //i jest przypisane do podanego użytkownika to poniższa funkcja spowoduje przypisanie zadania
        //do podanego użytkownia i zmieni status na 'Uruchomione'
        activityService.openActivity( userName, userPassword, processId, activityId );
        
        
        //Akceptacja zadania
        String executor="jkowalski";//użytkownik akceptujący
        String actionName="akceptacja";//nazwa akcji z mapy
        Map<String,Object> map=new HashMap<String,Object>();
        map.put( "zmienna", "wartosc" );//mapa nie zostanie całkowicie zastąpiona podaną
        //zostaną nadpisane tylko podane wartości
        AcceptationDefinition acceptation=new AcceptationDefinition( processId, activityId, executor, actionName );
        acceptation.setContextMap( map );//opcjonalnie
		acceptation.setIgnoreValidators( false ); //opcjonalne wymuszenie walidacji akceptacji 	
 		
		//Akceptacja zadania, na dowolnym użytkowniku (ownerLogin), jeśli jest on właścicielem zadania (tj.zostało przez niego otwarte w PWFL)
		String ownerLogin = "jkowalski";
		AcceptationDefinition acceptation = new AcceptationDefinition( procId, activId, ownerLogin, actionName );
 		activityService.acceptActivity( acceptation );

		//Akceptacja zadania, na dowolnym użytkowniku (approverLogin), nawet jeśli nie jest on właścicielem zadania 
		String approverLogin = "test";
		assignmentService.assignActivityToUser( procId, activId, approverLogin );
		AcceptationDefinition acceptation = new AcceptationDefinition( procId, activId, approverLogin, actionName );
		acceptation.setIgnoreOwnerShip( true );
		activityService.acceptActivity( acceptation );

		
Warning
titleUwaga dot. akceptacji zadania

Powyżej wspomniana akceptacja zadania nie może być uruchamiana w tej samej transakcji co tworzenie procesu w którego dotyczy akceptowane zadanie. Wtedy co prawda akceptacja powiedzie się, ale w logach polecą wyjątki dot. powiadomień systemowych, które przez to nie zostaną poprawnie wykonane.
Jeśli jest potrzeba, aby akceptacja zadania była wykonana zaraz po utworzeniu procesu tego zadania (np w jednym zadaniu automatycznym/zaplanowanym itp.), to trzeba wymusić stworzenie procesu w osobnej transakcji. Co można zrobić zgodnie z instrukcją Opis używania transakcji.

Warning
titleUwaga dot. walidacji akceptacji

Przy walidacji zadania przez API brane są pod uwagę tylko walidatory komponentowe.

Code Block
languagejava
titleWyszukiwanie zadań
linenumberstrue
	     // Pobieranie otwartych zadań
        List<Activity> activities = activityFinder.findOpenedActivities( processId );
        for ( Activity activity : activities )
        {
            activityId = activity.getActivityId();
        }
        // Pobieranie zadań przypisanych do użytkownika
        activities = activityFinder.findActivitiesAssignedToUser( userName, Activity.JOIN_PROCESS );
        for ( Activity activity : activities )
        {
            activityId = activity.getActivityId();
            Process process = activity.getProcess();// tylko gdy użyliśmy Activity.JOIN_PROCESS
        }
        // Pobieranie zadań z procesu
        activities = activityFinder.findByProcessId( processId, Activity.JOIN_PROCESS );
        for ( Activity activity : activities )
        {
            activityId = activity.getActivityId();
            Process process = activity.getProcess();// tylko gdy użyliśmy Activity.JOIN_PROCESS
        }