org.squashtest.tm.service.campaign

Interface TestSuiteTestPlanManagerService

All Known Implementing Classes:

TestSuiteTestPlanManagerServiceImpl

@Transactional
public interface TestSuiteTestPlanManagerService

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

Author:

François Gaillard

Method Summary

Methods

Modifier and Type	Method and Description
void	addTestCasesToIterationAndTestSuite(List<Long> testCaseIds, long suiteId)
void	bindTestPlan(long suiteId, List<Long> itemTestPlanIds) That method will attach several IterationTestPlanItem to the given TestSuite.
void	bindTestPlanObj(org.squashtest.tm.domain.campaign.TestSuite testSuite, List<org.squashtest.tm.domain.campaign.IterationTestPlanItem> itemTestPlans) That method will attach several IterationTestPlanItem to the given TestSuite.
void	bindTestPlanToMultipleSuites(List<Long> suiteIds, List<Long> itemTestPlanIds) That method will attach several IterationTestPlanItem to several TestSuite.
void	bindTestPlanToMultipleSuitesObj(List<org.squashtest.tm.domain.campaign.TestSuite> testSuites, List<org.squashtest.tm.domain.campaign.IterationTestPlanItem> itemTestPlans) That method will attach several IterationTestPlanItem to the given TestSuites.
void	changeTestPlanPosition(long testSuiteId, int newIndex, List<Long> itemIds)
void	detachTestPlanFromTestSuite(List<Long> testPlanIds, long suiteId)
boolean	detachTestPlanFromTestSuiteAndRemoveFromIteration(List<Long> testPlanIds, long suiteId)
org.squashtest.tm.core.foundation.collection.PagedCollectionHolder<List<IndexedIterationTestPlanItem>>	findAssignedTestPlan(long suiteId, org.squashtest.tm.core.foundation.collection.PagingAndMultiSorting sorting, org.squashtest.tm.core.foundation.collection.ColumnFiltering filtering) Returns a suite test plan filtered for a specific user.
List<Long>	findPlannedTestCasesIds(Long suiteId) Will find the distinct ids of the test cases referenced in the suite matching the given id
org.squashtest.tm.domain.campaign.TestSuite	findTestSuite(long testSuiteId) Find a iteration using its id
void	reorderTestPlan(long iterationId, org.squashtest.tm.core.foundation.collection.MultiSorting newSorting)
void	unbindTestPlanObj(org.squashtest.tm.domain.campaign.TestSuite testSuite, List<org.squashtest.tm.domain.campaign.IterationTestPlanItem> itemTestPlans) That method will detach several IterationTestPlanItem from the given TestSuite.
void	unbindTestPlanToMultipleSuites(List<Long> unboundTestSuiteIds, List<Long> itpIds) That method will detach several IterationTestPlanItem from the given TestSuites.

Method Detail

findTestSuite

@Transactional(readOnly=true)
org.squashtest.tm.domain.campaign.TestSuite findTestSuite(long testSuiteId)

Find a iteration using its id

Parameters:

testSuiteId -

findAssignedTestPlan

@Transactional(readOnly=true)
org.squashtest.tm.core.foundation.collection.PagedCollectionHolder<List<IndexedIterationTestPlanItem>> findAssignedTestPlan(long suiteId,
                                                                                                                                        org.squashtest.tm.core.foundation.collection.PagingAndMultiSorting sorting,
                                                                                                                                        org.squashtest.tm.core.foundation.collection.ColumnFiltering filtering)

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

Parameters:

suiteId -

Returns:

the test plan of given iteration filtered by the current user

changeTestPlanPosition

void changeTestPlanPosition(long testSuiteId,
                          int newIndex,
                          List<Long> itemIds)

reorderTestPlan

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

bindTestPlan

void bindTestPlan(long suiteId,
                List<Long> itemTestPlanIds)

That method will attach several IterationTestPlanItem to the given TestSuite. As usual, they are identified using their Ids.

The implementation must also check that all these entities all belong to the same iteration or throw an unchecked exception if not. TODO : define that exception.

Parameters:

suiteId -

itemTestPlanIds -

bindTestPlanToMultipleSuites

void bindTestPlanToMultipleSuites(List<Long> suiteIds,
                                List<Long> itemTestPlanIds)

That method will attach several IterationTestPlanItem to several TestSuite. As usual, they are identified using their Ids.

The implementation must also check that all these entities all belong to the same iteration or throw an unchecked exception if not. TODO : define that exception.

Parameters:

suiteIds -

itemTestPlanIds -

bindTestPlanObj

void bindTestPlanObj(org.squashtest.tm.domain.campaign.TestSuite testSuite,
                   List<org.squashtest.tm.domain.campaign.IterationTestPlanItem> itemTestPlans)

That method will attach several IterationTestPlanItem to the given TestSuite. They are identified using their Objects.

These entities all belong to the same iteration since they have previously been attached to it.

Parameters:

testSuite -

itemTestPlans -

bindTestPlanToMultipleSuitesObj

void bindTestPlanToMultipleSuitesObj(List<org.squashtest.tm.domain.campaign.TestSuite> testSuites,
                                   List<org.squashtest.tm.domain.campaign.IterationTestPlanItem> itemTestPlans)

That method will attach several IterationTestPlanItem to the given TestSuites. They are identified using their Objects.

These entities all belong to the same iteration since they have previously been attached to it.

Parameters:

testSuites -

itemTestPlans -

unbindTestPlanObj

void unbindTestPlanObj(org.squashtest.tm.domain.campaign.TestSuite testSuite,
                     List<org.squashtest.tm.domain.campaign.IterationTestPlanItem> itemTestPlans)

That method will detach several IterationTestPlanItem from the given TestSuite. They are identified using their Objects.

These entities all belong to the same iteration since they have previously been attached to it.

Parameters:

testSuite -

itemTestPlans -

unbindTestPlanToMultipleSuites

void unbindTestPlanToMultipleSuites(List<Long> unboundTestSuiteIds,
                                  List<Long> itpIds)

That method will detach several IterationTestPlanItem from the given TestSuites. They are identified using their ids.

These entities all belong to the same iteration since they have previously been attached to it.

Parameters:

testSuite -

itemTestPlans -

addTestCasesToIterationAndTestSuite

void addTestCasesToIterationAndTestSuite(List<Long> testCaseIds,
                                       long suiteId)

detachTestPlanFromTestSuite

void detachTestPlanFromTestSuite(List<Long> testPlanIds,
                               long suiteId)

detachTestPlanFromTestSuiteAndRemoveFromIteration

boolean detachTestPlanFromTestSuiteAndRemoveFromIteration(List<Long> testPlanIds,
                                                        long suiteId)

findPlannedTestCasesIds

@Transactional(readOnly=true)
List<Long> findPlannedTestCasesIds(Long suiteId)

Will find the distinct ids of the test cases referenced in the suite matching the given id

Parameters:

suiteId - : the id of the concerned TestSuite

Returns:

the distinct ids of the TestCases referenced in the suite's test plan.