com.xebialabs.deployit.engine.api

Interface TaskBlockService

public interface TaskBlockService

Manages tasks with blocks on the XL Deploy Server.

Method Summary

Methods

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

Method Detail

getMyCurrentTasks

java.util.List<TaskWithBlock> getMyCurrentTasks()

Returns the active tasks of the logged in user.

Returns:

a list of tasks with blocks.

getAllCurrentTasks

java.util.List<TaskWithBlock> getAllCurrentTasks()

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

Returns:

a list of tasks with blocks.

getTask

TaskWithBlock getTask(java.lang.String taskId)

Returns a task by ID.

Parameters:

taskId - the ID of the task

Returns:

the task with blocks.

Permission:

Available only to admin and owner of the task

getBlock

BlockState getBlock(java.lang.String taskId,
                  java.lang.String blockPath)

Returns a block by ID.

Parameters:

taskId - the ID of the task

blockPath - the ID of the block

Returns:

the block.

Permission:

Available only to admin and owner of the task

getSteps

StepBlockState getSteps(java.lang.String taskId,
                      java.lang.String blockPath)

Returns a block with steps by ID.

Parameters:

taskId - the ID of the task

blockPath - the ID of the block

Returns:

the block with steps.

Permission:

Available only to admin and owner of the task

getStep

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

Retrieves information about a step.

Parameters:

taskId - the ID of the task

stepPath - the path of the step in the block tree.

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

Returns:

XML containing a StepState if the step has not been modified since ifModifiedSince

RestDetails:

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

Permission:

Available only to admin and owner of the task

ApiDetails:

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

start

void start(java.lang.String taskId)

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)

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)

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)

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)

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)

Archive an executed task.

Parameters:

taskId - the ID of the task

Permission:

Available only to admin and owner of the task

skip

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

Indicates that one or more steps should be skipped.

Parameters:

taskId - the ID of the task

stepIds - the paths of the steps to skip

Returns:

a task

Permission:

task#skip_step

unskip

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

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

Parameters:

taskId - the ID of the task

stepIds - the paths of the steps to unskip

Returns:

a task

Permission:

task#skip_step

addPause

StepBlockState addPause(java.lang.String taskId,
                      java.lang.String stepPath)

Add a pause step at the specified position.

Parameters:

taskId - the ID of the task

stepPath - the path of the step

Returns:

a task with full step information.

Permission:

Available only to admin and owner of the task

assign

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

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

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

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<TaskWithBlock> query(org.joda.time.LocalDate begin,
                                  org.joda.time.LocalDate end)

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<TaskWithBlock> export(org.joda.time.LocalDate begin,
                                   org.joda.time.LocalDate end)

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