org.apache.syncope.common.services

Interface UserWorkflowService

All Superinterfaces:

JAXRSService

@Path(value="userworkflow")
public interface UserWorkflowService
extends JAXRSService

REST operations related to user workflow.

Field Summary

Fields inherited from interface org.apache.syncope.common.services.JAXRSService

DEFAULT_PARAM_PAGE, DEFAULT_PARAM_PAGE_VALUE, DEFAULT_PARAM_SIZE, DEFAULT_PARAM_SIZE_VALUE, PARAM_DETAILS, PARAM_FIQL, PARAM_ORDERBY, PARAM_PAGE, PARAM_SIZE

Method Summary

Methods

Modifier and Type	Method and Description
WorkflowFormTO	claimForm(String taskId) Claims the form for the given task id.
UserTO	executeTask(String taskId, UserTO userTO) Executes workflow task for matching id.
WorkflowFormTO	getFormForUser(Long userId) Returns a list of available forms for the given user id.
List<WorkflowFormTO>	getForms() Returns a list of all available workflow forms.
UserTO	submitForm(WorkflowFormTO form) Submits a workflow form.

Method Detail

getForms

@GET
@Path(value="forms")
@Produces(value={"application/xml","application/json"})
List<WorkflowFormTO> getForms()

Returns a list of all available workflow forms.

Returns:

list of all available workflow forms

getFormForUser

@GET
@Path(value="forms/{userId}")
@Produces(value={"application/xml","application/json"})
WorkflowFormTO getFormForUser(@NotNull@PathParam(value="userId")
                                              Long userId)

Returns a list of available forms for the given user id.

Parameters:

userId - user id

Returns:

list of available forms for the given user id

claimForm

@POST
@Path(value="forms/{taskId}/claim")
@Produces(value={"application/xml","application/json"})
WorkflowFormTO claimForm(@NotNull@PathParam(value="taskId")
                                          String taskId)

Claims the form for the given task id.

Parameters:

taskId - workflow task id

Returns:

the workflow form for the given task id

submitForm

@POST
@Path(value="forms")
@Produces(value={"application/xml","application/json"})
@Consumes(value={"application/xml","application/json"})
UserTO submitForm(@NotNull
                                            WorkflowFormTO form)

Submits a workflow form.

Parameters:

form - workflow form.

Returns:

updated user

executeTask

@POST
@Path(value="tasks/{taskId}/execute")
@Produces(value={"application/xml","application/json"})
@Consumes(value={"application/xml","application/json"})
UserTO executeTask(@NotNull@PathParam(value="taskId")
                                             String taskId,
                                             @NotNull
                                             UserTO userTO)

Executes workflow task for matching id.

Parameters:

taskId - workflow task id

userTO - argument to be passed to workflow task

Returns:

updated user