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.
void	addTestCaseToIteration(Long testCaseId, Long datasetId, long iterationId) Will add the given test case, with the given test plan, to the test plan of the given 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)
void	copyTestPlanItems(List<Long> iterationTestPlanIds, long iterationId) Will copy each items into the test plan of the given iteration.
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, findByReferencedTestCase, findLinkableTestCaseLibraries, findPlannedTestCases, findTestPlan, findTestPlanItem, findTestPlanItems

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. If a test case have one or several datasets, that test case will be planned as many time with a different dataset. Id annotation is used by PreventConcurrent, BatchPreventConcurrent and PreventConcurrents in sub classes

addTestCaseToIteration

void addTestCaseToIteration(Long testCaseId,
                          Long datasetId,
                          long iterationId)

Will add the given test case, with the given test plan, to the test plan of the given iteration. Id annotation is used by PreventConcurrent, BatchPreventConcurrent and PreventConcurrents in sub classes

Parameters:

testCaseId -

datasetId, - may be null

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. If a test case have one or several datasets, that test case will be planned as many time with a different dataset.

Parameters:

testCaseIds -

iteration -

copyTestPlanItems

void copyTestPlanItems(List<Long> iterationTestPlanIds,
                     long iterationId)

Will copy each items into the test plan of the given iteration. In business terms it means that each designated pair of testcase + dataset will be replanned in the target iteration.

Parameters:

iterationTestPlanIds -

iterationId -

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 not 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)