Quick Start (EJB mode): Retrieving task information using the Java API

The following Java code example retrieves all tasks that are based on a process named MortgageLoan - Prebuilt. The status of each returned task is checked to ensure that it is a completed task. Information such as the name of the user who completed the task and the date that the task was completed is retrieved and displayed.

/* 
    * This Java Quick Start uses the following JAR files 
    * 1. adobe-taskmanager-client.jar 
    * 2. adobe-livecycle-client.jar 
    * 3. adobe-usermanager-client.jar 
    * 4. adobe-utilities.jar 
    * 5. jbossall-client.jar (use a different JAR file if the LiveCycle server is not deployed 
    * on JBoss) 
    * 6. commons-code-1.3.jar 
    * 7. adobe-workflow-client-sdk.jar 
    * 8. jacorb.jar (use a different JAR file if the LiveCycle server is not deployed on JBoss) 
    * 9. jnp-client.jar (use a different JAR file if the LiveCycle server is not deployed on JBoss) 
    *  
    *  The JBoss files must be kept in the jboss\client folder. You can copy the client folder to  
    *  your local development environment and then include the 3 JBoss JAR files in your class path 
    *   
    *  These JAR files are located in the following path: 
    * <install directory>/sdk/client-libs/common 
    *  
    * The adobe-utilities.jar file is located in the following path: 
    * <install directory>/sdk/client-libs/jboss 
    *  
    * The jbossall-client.jar file is located in the following path: 
    * <install directory>/jboss/client 
    *  
    * If you want to invoke a remote LiveCycle server instance and there is a 
    * firewall between the client application and the server, then it is  
    * recommended that you use the SOAP mode. When using the SOAP mode,  
    * you have to include additional JAR files located in the following  
    * path 
    * <install directory>/sdk/client-libs/thirdparty 
    *  
    * For information about the SOAP  
    * mode and the additional JAR files that need to be included,  
    * see "Setting connection properties" in Programming  
    * with LiveCycle 
    */ 
import java.util.*; 
 
import com.adobe.idp.dsc.clientsdk.ServiceClientFactory; 
import com.adobe.idp.dsc.clientsdk.ServiceClientFactoryProperties; 
import com.adobe.idp.taskmanager.dsc.client.query.TaskRow; 
import com.adobe.idp.taskmanager.dsc.client.query.TaskSearchFilter; 
import com.adobe.idp.taskmanager.dsc.client.task.ParticipantInfo; 
import com.adobe.idp.taskmanager.dsc.client.task.TaskInfo; 
import com.adobe.idp.taskmanager.dsc.client.task.TaskManager; 
import com.adobe.idp.taskmanager.dsc.client.*; 
import com.adobe.idp.um.api.infomodel.Principal; 
import com.adobe.livecycle.usermanager.client.DirectoryManagerServiceClient; 
 
public class RetrievingTasks { 
 
    public static void main(String[] args) { 
             
        try{ 
            //Set connection properties required to invoke LiveCycle                                                                                                                        
            Properties connectionProps = new Properties(); 
            connectionProps.setProperty(ServiceClientFactoryProperties.DSC_DEFAULT_EJB_ENDPOINT, "jnp://localhost:1099"); 
     connectionProps.setProperty(ServiceClientFactoryProperties.DSC_TRANSPORT_PROTOCOL,ServiceClientFactoryProperties.DSC_EJB_PROTOCOL);           
            connectionProps.setProperty(ServiceClientFactoryProperties.DSC_SERVER_TYPE, "JBoss"); 
            connectionProps.setProperty(ServiceClientFactoryProperties.DSC_CREDENTIAL_USERNAME, "administrator"); 
            connectionProps.setProperty(ServiceClientFactoryProperties.DSC_CREDENTIAL_PASSWORD, "password"); 
     
            //Create a ServiceClientFactory object 
            ServiceClientFactory myFactory = ServiceClientFactory.createInstance(connectionProps); 
 
            //Create a TaskManagerQueryService object     
            TaskManagerQueryService queryManager = TaskManagerClientFactory.getQueryManager(myFactory); 
             
            //Create a TaskManager object 
            TaskManager taskManager = TaskManagerClientFactory.getTaskManager(myFactory); 
             
            //Define search criteria by performing a search on  
            //completed tasks 
            TaskSearchFilter filter = new TaskSearchFilter();  
            filter.setServiceName("MortgageLoan - Prebuilt"); 
            filter.setAdminIgnoreAllAcls(true); 
                                                             
            //Perform the search on tasks 
            List result = queryManager.taskSearch(filter);  
                     
            //Create an Iterator object and iterate through 
            //the List object 
            Iterator iter = result.iterator(); 
            int i = 0 ; 
            while (iter.hasNext()) { 
                TaskRow myTask = (TaskRow)iter.next(); 
                             
                //Make sure that the task is completed- 100 represents 
                //a completed task 
                if (myTask.getTaskStatus()== 100) 
                { 
                    //Get the name of the user who completed the task 
                    long taskId = myTask.getTaskId(); 
                    TaskInfo taskInfo= taskManager.getTaskInfo(taskId); 
                    ParticipantInfo user = taskInfo.getAssignedTo(); 
                    String userId = user.getSpecifiedUserId(); 
                    String userName = getUserName(myFactory, userId); 
                     
                    //Get the name of the process 
                    String processName = myTask.getProcessName(); 
                     
                    //Get the completion time 
                    Date completionTime = myTask.getCompleteTime(); 
                     
                    //Display task information     
                     System.out.println("The task identifier is "+taskId +"\n"+ 
                    "The name of the user who completed the task is "+ userName +"\n"+ 
                    "The name of the process on which the task is based is "+ processName+"\n"+ 
                     "The completion time is "+ completionTime.getDate()); 
                     i++ ; 
                    } 
                 } 
            } 
             
        catch(Exception e) 
        { 
            e.printStackTrace(); 
        } 
    } 
     
     
    //This method accepts a user Id and returns the corresponding user name 
    static private String getUserName(ServiceClientFactory myFactory, String userId){ 
         String userName = "";     
         try{ 
             //Create a DirectoryManagerServiceClient object              
             DirectoryManagerServiceClient dirClient = new DirectoryManagerServiceClient(myFactory); 
         
            //Find a local user 
            Principal prin = dirClient.findPrincipal(userId); 
            userName = prin.getCanonicalName(); 
            } 
         catch(Exception e) 
         { 
             e.printStackTrace(); 
         } 
         return userName; 
      } 
    }