Package com.logicaldoc.workflow.webservice.soap.client

Class SoapWorkflowClient

java.lang.Object

com.logicaldoc.webservice.soap.client.SoapClient<WorkflowService>

com.logicaldoc.workflow.webservice.soap.client.SoapWorkflowClient

All Implemented Interfaces:

WorkflowService

public class SoapWorkflowClient
extends com.logicaldoc.webservice.soap.client.SoapClient<WorkflowService>
implements WorkflowService

Simple client for the Workflow webservice

Since:

7.6

Author:

Marco Meschieri - LogicalDOC

Constructor Summary

Constructors

Constructor	Description
SoapWorkflowClient(String endpoint)

Method Summary

Modifier and Type	Method	Description
WSWorkflowHistory	addNote(String sid, String taskId, String note)	Adds a new note
void	appendDocuments(String sid, String taskId, Long[] docIds)	Appends new documents to the workflow
void	claim(String sid, String taskId)	Claims a task
void	complete(String sid, String taskId, String transition)	Completes a task taking a given transition
WSWorkflowHistory[]	getHistories(String sid, String instanceId, String event)	Gets the histories of a workflow instance
WSWorkflowTask[]	getTasksAssignedToMe(String sid)	Retrieves the tasks assigned to the current user
WSWorkflowTask[]	getTasksICanOwn(String sid)	Retrieves the tasks that can be owned by the current user
String[]	getWorkflows(String sid)	Lists the available workflows
void	reassign(String sid, String taskId, long userId)	Reassigns a task to another user
String	startWorkflow(String sid, String workflow, String tag, long[] docIds)	Launches a new workflow instance
void	unclaim(String sid, String taskId)	Turns a task back to pool

Methods inherited from class com.logicaldoc.webservice.soap.client.SoapClient

setMaxChildElements

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

SoapWorkflowClient

public SoapWorkflowClient(String endpoint)

Method Detail

claim

public void claim(String sid,
                  String taskId)
           throws Exception

Description copied from interface: WorkflowService

Claims a task

Specified by:

claim in interface WorkflowService

Parameters:

sid - identifier of the session

taskId - identifier of the task

Throws:

Exception - error in the server

complete

public void complete(String sid,
                     String taskId,
                     String transition)
              throws Exception

Description copied from interface: WorkflowService

Completes a task taking a given transition

Specified by:

complete in interface WorkflowService

Parameters:

sid - identifier of the session

taskId - identifier of the task

transition - name of the transition

Throws:

Exception - error in the server

unclaim

public void unclaim(String sid,
                    String taskId)
             throws Exception

Description copied from interface: WorkflowService

Turns a task back to pool

Specified by:

unclaim in interface WorkflowService

Parameters:

sid - identifier of the session

taskId - identifier of the task

Throws:

Exception - error in the server

addNote

public WSWorkflowHistory addNote(String sid,
                                 String taskId,
                                 String note)
                          throws Exception

Description copied from interface: WorkflowService

Adds a new note

Specified by:

addNote in interface WorkflowService

Parameters:

sid - identifier of the session

taskId - identifier of the task

note - text of the note

Returns:

the event created for this note

Throws:

Exception - error in the server

getTasksAssignedToMe

public WSWorkflowTask[] getTasksAssignedToMe(String sid)
                                      throws Exception

Description copied from interface: WorkflowService

Retrieves the tasks assigned to the current user

Specified by:

getTasksAssignedToMe in interface WorkflowService

Parameters:

sid - identifier of the session

Returns:

list of tasks

Throws:

Exception - error in the server

getTasksICanOwn

public WSWorkflowTask[] getTasksICanOwn(String sid)
                                 throws Exception

Description copied from interface: WorkflowService

Retrieves the tasks that can be owned by the current user

Specified by:

getTasksICanOwn in interface WorkflowService

Parameters:

sid - identifier of the session

Returns:

list of tasks

Throws:

Exception - error in the server

getHistories

public WSWorkflowHistory[] getHistories(String sid,
                                        String instanceId,
                                        String event)
                                 throws Exception

Description copied from interface: WorkflowService

Gets the histories of a workflow instance

Specified by:

getHistories in interface WorkflowService

Parameters:

sid - identifier of the session

instanceId - identifier of the workflow instance

event - optional filter on a specific event type

Returns:

the histories

Throws:

Exception - error in the server

appendDocuments

public void appendDocuments(String sid,
                            String taskId,
                            Long[] docIds)
                     throws Exception

Description copied from interface: WorkflowService

Appends new documents to the workflow

Specified by:

appendDocuments in interface WorkflowService

Parameters:

sid - identifier of the session

taskId - identifier of the task

docIds - identifiers of the documents to append

Throws:

Exception - error in the server

getWorkflows

public String[] getWorkflows(String sid)
                      throws Exception

Description copied from interface: WorkflowService

Lists the available workflows

Specified by:

getWorkflows in interface WorkflowService

Parameters:

sid - identifier of the session

Returns:

list of the workflow names

Throws:

Exception - error in the server

startWorkflow

public String startWorkflow(String sid,
                            String workflow,
                            String tag,
                            long[] docIds)
                     throws Exception

Description copied from interface: WorkflowService

Launches a new workflow instance

Specified by:

startWorkflow in interface WorkflowService

Parameters:

sid - identifier of the session

workflow - name of the workflow

tag - a tag you can assign to the new instance

docIds - identifiers of the documents to be appended to the workflow

Returns:

identifier of the workflow instance

Throws:

Exception - error in the server

reassign

public void reassign(String sid,
                     String taskId,
                     long userId)
              throws Exception

Description copied from interface: WorkflowService

Reassigns a task to another user

Specified by:

reassign in interface WorkflowService

Parameters:

sid - identifier of the session

taskId - identifier of the task

userId - identifier of the user

Throws:

Exception - error in the server