com.xebialabs.deployit.engine.api

Interface TaskService

Deprecated.

Use TaskBlockService instead.

@Deprecated
public interface TaskService

Manages tasks on the XL Deploy Server.

Method Summary

Methods

Modifier and Type	Method and Description
void	abort(java.lang.String taskId) Deprecated. Aborts an active task.
TaskWithSteps	addPause(java.lang.String taskId, int stepId) Deprecated. Add a pause step at the specified position.
void	archive(java.lang.String taskId) Deprecated. Archive an executed task.
TaskState	assign(java.lang.String taskId, java.lang.String owner) Deprecated. Assigns a task to a different user.
void	cancel(java.lang.String taskId) Deprecated. Cancels a stopped task.
java.util.List<TaskWithSteps>	export(org.joda.time.LocalDate begin, org.joda.time.LocalDate end) Deprecated. Searches for tasks with detailed step information.
java.util.List<TaskState>	getAllCurrentTasks() Deprecated. Returns all active tasks for all users.
java.util.List<TaskState>	getMyCurrentTasks() Deprecated. Returns the active tasks of the logged in user.
StepState	getStep(java.lang.String taskId, int stepId, org.joda.time.DateTime ifModifiedSince) Deprecated. Retrieves information about a step.
TaskWithSteps	getSteps(java.lang.String taskId) Deprecated. Returns a task containing step information.
TaskState	getTask(java.lang.String taskId) Deprecated. Returns a task by ID.
TaskWithSteps	moveStep(java.lang.String taskId, int stepId, int newPosition) Deprecated. Moves a step.
java.util.List<TaskState>	query(org.joda.time.LocalDate begin, org.joda.time.LocalDate end) Deprecated. Searches for tasks without step information.
void	schedule(java.lang.String taskId, org.joda.time.DateTime time) Deprecated. Schedules a task.
TaskWithSteps	skip(java.lang.String taskId, java.util.List<java.lang.Integer> stepIds) Deprecated. Indicates that one or more steps should be skipped.
void	start(java.lang.String taskId) Deprecated. Starts a task.
void	stop(java.lang.String taskId) Deprecated. Gracefully stops an active task.
TaskState	takeover(java.lang.String taskId, java.lang.String owner) Deprecated. Takeover a task from the owner.
TaskWithSteps	unskip(java.lang.String taskId, java.util.List<java.lang.Integer> stepIds) Deprecated. Indicates that one or more steps should no longer be skipped, but executed.

Method Detail

getMyCurrentTasks

java.util.List<TaskState> getMyCurrentTasks()

Deprecated.

Returns the active tasks of the logged in user.

Returns:

a list of tasks.

getAllCurrentTasks

java.util.List<TaskState> getAllCurrentTasks()

Deprecated.

Returns all active tasks for all users. Only allowed for admin.

Returns:

a list of tasks.

getTask

TaskState getTask(java.lang.String taskId)

Deprecated.

Returns a task by ID.

Parameters:

taskId - the ID of the task

Returns:

the task.

Permission:

Available only to admin and owner of the task

getSteps

TaskWithSteps getSteps(java.lang.String taskId)

Deprecated.

Returns a task containing step information.

Parameters:

taskId - the ID of the task

Returns:

a task with full step information.

Permission:

Available only to admin and owner of the task

getStep

StepState getStep(java.lang.String taskId,
                int stepId,
                @HeaderParam(value="If-Modified-Since")
                org.joda.time.DateTime ifModifiedSince)

Deprecated.

Retrieves information about a step.

Parameters:

taskId - the ID of the task

stepId - the ordinal number of the step, starting from 1

ifModifiedSince - the if-modified-since date in RFC 1123 (RFC 822 with 4-digit years) date format.

Returns:

a stepStep

RestDetails:

If the step has not been modified since ifModifiedSince, a response with status code of 304 (Not Modified), otherwise returns a response with a status code of 200 (OK) and XML containing a StepState.

Permission:

Available only to admin and owner of the task

ApiDetails:

If the step has not been modified since ifModifiedSince, the method throws a RuntimeException, otherwise returns a StepState

start

void start(java.lang.String taskId)

Deprecated.

Starts a task.

Parameters:

taskId - the ID of the task

Permission:

Available only to admin and owner of the task

schedule

void schedule(java.lang.String taskId,
            org.joda.time.DateTime time)

Deprecated.

Schedules a task.

Parameters:

taskId - the ID of the task

time - the local time (including the local timezone) when the task should be started by the server.

Permission:

Available only to admin and owner of the task

stop

void stop(java.lang.String taskId)

Deprecated.

Gracefully stops an active task.

Parameters:

taskId - the ID of the task

Permission:

Available only to admin and owner of the task

abort

void abort(java.lang.String taskId)

Deprecated.

Aborts an active task.

Parameters:

taskId - the ID of the task

Permission:

Available only to admin and owner of the task

cancel

void cancel(java.lang.String taskId)

Deprecated.

Cancels a stopped task.

Parameters:

taskId - the ID of the task

Permission:

Available only to admin and owner of the task

archive

void archive(java.lang.String taskId)

Deprecated.

Archive an executed task.

Parameters:

taskId - the ID of the task

Permission:

Available only to admin and owner of the task

skip

TaskWithSteps skip(java.lang.String taskId,
                 java.util.List<java.lang.Integer> stepIds)

Deprecated.

Indicates that one or more steps should be skipped.

Parameters:

taskId - the ID of the task

stepIds - the IDs of the steps to skip

Returns:

a task with full step information.

Permission:

task#skip_step

unskip

TaskWithSteps unskip(java.lang.String taskId,
                   java.util.List<java.lang.Integer> stepIds)

Deprecated.

Indicates that one or more steps should no longer be skipped, but executed.

Parameters:

taskId - the ID of the task

stepIds - the IDs of the steps to unskip

Returns:

a task with full step information.

Permission:

task#skip_step

moveStep

TaskWithSteps moveStep(java.lang.String taskId,
                     int stepId,
                     int newPosition)

Deprecated.

Moves a step.

Parameters:

taskId - the ID of the task

stepId - the current position of the step in the step list.

newPosition - the new position of the step in the step list.

Returns:

a task with full step information.

Permission:

task#move_step

addPause

TaskWithSteps addPause(java.lang.String taskId,
                     int stepId)

Deprecated.

Add a pause step at the specified position.

Parameters:

taskId - the ID of the task

stepId - the position of the step in the step list.

Returns:

a task with full step information.

Permission:

Available only to admin and owner of the task

assign

TaskState assign(java.lang.String taskId,
               java.lang.String owner)

Deprecated.

Assigns a task to a different user.

Parameters:

taskId - the ID of the task

owner - the name of the user that will be the new owner of the task.

Returns:

the task.

Permission:

task#assign

takeover

TaskState takeover(java.lang.String taskId,
                 java.lang.String owner)

Deprecated.

Takeover a task from the owner. This will re-assign the task to your logged in user. This is the reverse of the assign(String, String) method, which allows you to re-assign a task.

Parameters:

taskId - the ID of the task to take over

owner - the current owner of the task

Returns:

the task you took over.

Permission:

task#takeover

query

java.util.List<TaskState> query(org.joda.time.LocalDate begin,
                              org.joda.time.LocalDate end)

Deprecated.

Searches for tasks without step information.

Parameters:

begin - The first day we want to see tasks from, or null for no such limit.

end - The last day we want to see tasks from, or null for no such limit.

Returns:

a list of tasks.

Permission:

report#view

export

java.util.List<TaskWithSteps> export(org.joda.time.LocalDate begin,
                                   org.joda.time.LocalDate end)

Deprecated.

Searches for tasks with detailed step information.

Parameters:

begin - The first day we want to see tasks from, or null for no such limit.

end - The last day we want to see tasks from, or null for no such limit.

Returns:

a list of tasks with step information.

Permission:

report#view