ch.aaap.harvestclient.api

Interface TaskAssignmentsApi

All Known Implementing Classes:

TaskAssignmentsApiImpl

public interface TaskAssignmentsApi

API for TaskAssignments. All methods are specific to a given project

Method Summary

Modifier and Type	Method and Description
TaskAssignment	create(Reference<Project> projectReference, TaskAssignmentCreationInfo creationInfo) Create a new TaskAssignment
void	delete(Reference<Project> projectReference, Reference<TaskAssignment> taskAssignmentReference) Delete an existing Task.
TaskAssignment	get(Reference<Project> projectReference, Reference<TaskAssignment> taskAssignmentReference) Return an existing TaskAssignment.
List<TaskAssignment>	list(Reference<Project> projectReference, TaskAssignmentFilter filter)
TaskAssignment	update(Reference<Project> projectReference, Reference<TaskAssignment> taskAssignmentReference, TaskAssignmentUpdateInfo updateInfo) Updates the specific TaskAssignment by setting the values of the parameters passed.

Method Detail

list

List<TaskAssignment> list(Reference<Project> projectReference,
                          TaskAssignmentFilter filter)

Parameters:

filter - filtering options

projectReference - the project containing the assignments

Returns:

a list of all TaskAssignments in the project, sorted by creation date, newest first.

get

TaskAssignment get(Reference<Project> projectReference,
                   Reference<TaskAssignment> taskAssignmentReference)

Return an existing TaskAssignment.

Parameters:

projectReference - the project containing the assignment

taskAssignmentReference - a reference to an existing TaskAssignment

Returns:

the full TaskAssignment object

create

TaskAssignment create(Reference<Project> projectReference,
                      TaskAssignmentCreationInfo creationInfo)

Create a new TaskAssignment

Parameters:

projectReference - the project that will contain the assignment

creationInfo - creation information

Returns:

the created Task

update

TaskAssignment update(Reference<Project> projectReference,
                      Reference<TaskAssignment> taskAssignmentReference,
                      TaskAssignmentUpdateInfo updateInfo)

Updates the specific TaskAssignment by setting the values of the parameters passed. Any parameters not provided will be left unchanged

Parameters:

projectReference - the project that contains the assignment

taskAssignmentReference - An existing TaskAssignment to be updated

updateInfo - the changes to be performed

Returns:

the updated TaskAssignment

delete

void delete(Reference<Project> projectReference,
            Reference<TaskAssignment> taskAssignmentReference)

Delete an existing Task. Only possible if no time entries are associated with it

Parameters:

projectReference - the project that contains the assignment

taskAssignmentReference - An existing TaskAssignment to be deleted