org.squashtest.tm.service.campaign

Interface IterationTestPlanManagerService

All Superinterfaces:

IterationTestPlanFinder

All Known Implementing Classes:

IterationTestPlanManagerServiceImpl

public interface IterationTestPlanManagerService
extends IterationTestPlanFinder

Service that aims at managing the test cases of a campaign (i.e. its test plan)

Author:

Agnes Durand

Method Summary

Methods

Modifier and Type	Method and Description
void	addTestCasesToIteration(List<Long> testCaseIds, long iterationId) Adds a list of test cases to an iteration.
List<org.squashtest.tm.domain.campaign.IterationTestPlanItem>	addTestPlanItemsToIteration(List<Long> testCaseIds, org.squashtest.tm.domain.campaign.Iteration iteration) Adds a list of test cases to an iteration.
void	addTestPlanToIteration(List<org.squashtest.tm.domain.campaign.IterationTestPlanItem> testPlan, long iterationId) persist each iteration_test_plan_item and add it to iteration
void	assignUserToTestPlanItem(long testPlanItemId, long userId) Assign User with Execute Access to a TestPlan item.
void	assignUserToTestPlanItems(List<Long> testPlanIds, long userId) Assign User with Execute Access to a multiple TestPlan items.
void	changeDataset(long itemId, Long datasetId) Attach a dataset to an item.
void	changeTestPlanPosition(long iterationId, int newPosition, List<Long> itemIds)
Collection<org.squashtest.tm.domain.campaign.IterationTestPlanItem>	createTestPlanFragment(org.squashtest.tm.domain.testcase.TestCase testCase, org.squashtest.tm.domain.users.User assignee) Creates a fragment of test plan, containing either : a unique item when the test case is not parameterized one item per dataset when the test case is parameterized Note : The returned test plan fragment is in a transient state.
org.squashtest.tm.core.foundation.collection.PagedCollectionHolder<List<IndexedIterationTestPlanItem>>	findAssignedTestPlan(long iterationId, org.squashtest.tm.core.foundation.collection.PagingAndMultiSorting sorting, org.squashtest.tm.core.foundation.collection.ColumnFiltering filtering) Returns an iteration filtered for a specific user.
List<org.squashtest.tm.domain.campaign.IterationTestPlanItem>	forceExecutionStatus(List<Long> testPlanIds, String statusName) Assigns an execution status to each test plan item matching the given ids.
List<org.squashtest.tm.domain.execution.ExecutionStatus>	getExecutionStatusList()
boolean	removeTestPlanFromIteration(long testPlanItemId) Removes a test case from an iteration except if the test plans was executed
boolean	removeTestPlansFromIteration(List<Long> testPlanIds, long iterationId) Removes a list of test cases from a campaign excepted the test plans which were executed
boolean	removeTestPlansFromIterationObj(List<Long> testPlanIds, org.squashtest.tm.domain.campaign.Iteration iteration) Removes a list of test cases from an iteration excepted the test plans which were executed
void	reorderTestPlan(long iterationId, org.squashtest.tm.core.foundation.collection.MultiSorting newSorting)
void	updateMetadata(org.squashtest.tm.domain.campaign.IterationTestPlanItem item) Will update the item test plan execution metadata using the last execution data.

Methods inherited from interface org.squashtest.tm.service.campaign.IterationTestPlanFinder

findAssignableUserForTestPlan, findLinkableTestCaseLibraries, findPlannedTestCases, findTestPlan, findTestPlanItem, findTestPlanItemByTestCaseId

Method Detail

findAssignedTestPlan

org.squashtest.tm.core.foundation.collection.PagedCollectionHolder<List<IndexedIterationTestPlanItem>> findAssignedTestPlan(long iterationId,
                                                                                                                          org.squashtest.tm.core.foundation.collection.PagingAndMultiSorting sorting,
                                                                                                                          org.squashtest.tm.core.foundation.collection.ColumnFiltering filtering)

Returns an iteration filtered for a specific user. It returns an iteration with a test plan containing only the items that are assigned to that user or have been executed by that user.

Parameters:

iterationId -

Returns:

the test plan of given iteration filtered by the current user

addTestCasesToIteration

void addTestCasesToIteration(List<Long> testCaseIds,
                           long iterationId)

Adds a list of test cases to an iteration.

Parameters:

testCaseIds -

iterationId -

addTestPlanItemsToIteration

List<org.squashtest.tm.domain.campaign.IterationTestPlanItem> addTestPlanItemsToIteration(List<Long> testCaseIds,
                                                                                        org.squashtest.tm.domain.campaign.Iteration iteration)

Adds a list of test cases to an iteration.

Parameters:

testCaseIds -

iteration -

changeTestPlanPosition

void changeTestPlanPosition(long iterationId,
                          int newPosition,
                          List<Long> itemIds)

reorderTestPlan

void reorderTestPlan(long iterationId,
                   org.squashtest.tm.core.foundation.collection.MultiSorting newSorting)

removeTestPlansFromIteration

boolean removeTestPlansFromIteration(List<Long> testPlanIds,
                                   long iterationId)

Removes a list of test cases from a campaign excepted the test plans which were executed

Parameters:

testPlanIds - the ids of the test plan managing that test case for that iteration

iterationId - the id of the iteration

Returns:

true if at least one test plan item was deleted (because of insufficient rights on executed item)

removeTestPlansFromIterationObj

boolean removeTestPlansFromIterationObj(List<Long> testPlanIds,
                                      org.squashtest.tm.domain.campaign.Iteration iteration)

Removes a list of test cases from an iteration excepted the test plans which were executed

Parameters:

testPlanIds - the ids of the test plan managing that test case for that iteration

iteration - the iteration

Returns:

true if at least one test plan was already executed and therefore not deleted

removeTestPlanFromIteration

boolean removeTestPlanFromIteration(long testPlanItemId)

Removes a test case from an iteration except if the test plans was executed

Parameters:

testPlanId - the id of the test plan managing that test case for that iteration

iterationId -

Returns:

true if the test plan was already executed and therefore not deleted

updateMetadata

void updateMetadata(org.squashtest.tm.domain.campaign.IterationTestPlanItem item)

Will update the item test plan execution metadata using the last execution data.

Parameters:

execution -

assignUserToTestPlanItem

void assignUserToTestPlanItem(long testPlanItemId,
                            long userId)

Assign User with Execute Access to a TestPlan item.

Parameters:

testCaseId -

campaignId -

assignUserToTestPlanItems

void assignUserToTestPlanItems(List<Long> testPlanIds,
                             long userId)

Assign User with Execute Access to a multiple TestPlan items.

Parameters:

testPlanIds -

campaignId -

addTestPlanToIteration

void addTestPlanToIteration(List<org.squashtest.tm.domain.campaign.IterationTestPlanItem> testPlan,
                          long iterationId)

persist each iteration_test_plan_item and add it to iteration

Parameters:

testPlan -

iterationId -

getExecutionStatusList

List<org.squashtest.tm.domain.execution.ExecutionStatus> getExecutionStatusList()

Returns:

the list of defined execution statuses

forceExecutionStatus

List<org.squashtest.tm.domain.campaign.IterationTestPlanItem> forceExecutionStatus(List<Long> testPlanIds,
                                                                                 String statusName)

Assigns an execution status to each test plan item matching the given ids. Override the current itp execution status and other itp execution metadatas.

Parameters:

testPlanIds -

statusName -

createTestPlanFragment

Collection<org.squashtest.tm.domain.campaign.IterationTestPlanItem> createTestPlanFragment(org.squashtest.tm.domain.testcase.TestCase testCase,
                                                                                         org.squashtest.tm.domain.users.User assignee)

Creates a fragment of test plan, containing either :

• a unique item when the test case is not parameterized
• one item per dataset when the test case is parameterized

Note : The returned test plan fragment is in a transient state. Also assigns each item to the given user.

Parameters:

referenced -

assignee -

Returns:

changeDataset

void changeDataset(long itemId,
                 Long datasetId)

Attach a dataset to an item. If the ID of the dataset is null the item will reference no dataset instead.

Parameters:

itemId -

datasetId - (may be null)