org.squashtest.tm.service.campaign

Interface CampaignTestPlanManagerService

All Known Implementing Classes:

CampaignTestPlanManagerServiceImpl

public interface CampaignTestPlanManagerService

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	addTestCasesToCampaignTestPlan(List<Long> testCaseIds, long campaignId) Adds a list of test cases to a campaign.
void	addTestCaseToCampaignTestPlan(Long testCaseId, Long datasetId, long campaignId) Will add the given test case, with the given test plan, to the test plan of the given campaign.
void	assignUserToTestPlanItem(long itemId, long campaignId, long userId) Assign a user to the given test plan items
void	assignUserToTestPlanItems(List<Long> itemsIds, long campaignId, long userId) Assign a user to the given test plan items
void	changeDataset(long itemId, Long datasetId) Attach a dataset to an item.
List<org.squashtest.tm.domain.users.User>	findAssignableUserForTestPlan(long campaignId) Get Users with Execute Access for a campaign and his test plans.
org.squashtest.tm.domain.campaign.CampaignTestPlanItem	findById(long itemId)
org.squashtest.tm.domain.campaign.Campaign	findCampaign(long campaignId) Find a campaign using its id
List<org.squashtest.tm.domain.testcase.TestCaseLibrary>	findLinkableTestCaseLibraries() Returns a collection of TestCaseLibrary, the test cases of which may be added to the campaign
List<Long>	findPlannedTestCasesIds(Long campaignId) Will find the distinct ids of test cases referenced in the campaign test plan.
org.squashtest.tm.core.foundation.collection.PagedCollectionHolder<List<IndexedCampaignTestPlanItem>>	findTestPlan(long campaignId, org.squashtest.tm.core.foundation.collection.PagingAndMultiSorting sorting, org.squashtest.tm.core.foundation.collection.ColumnFiltering filtering)
org.squashtest.tm.core.foundation.collection.PagedCollectionHolder<List<org.squashtest.tm.domain.campaign.CampaignTestPlanItem>>	findTestPlanByCampaignId(long campaignId, org.squashtest.tm.core.foundation.collection.PagingAndSorting filter)
void	moveTestPlanItems(long campaignId, int targetIndex, List<Long> itemIds)
void	removeTestPlanItem(long campaignId, long itemId)
void	removeTestPlanItems(long campaignId, List<Long> itemIds)
void	reorderTestPlan(long campaignId, org.squashtest.tm.core.foundation.collection.MultiSorting newSorting)

Method Detail

findCampaign

org.squashtest.tm.domain.campaign.Campaign findCampaign(long campaignId)

Find a campaign using its id

Parameters:

campaignId -

findLinkableTestCaseLibraries

List<org.squashtest.tm.domain.testcase.TestCaseLibrary> findLinkableTestCaseLibraries()

Returns a collection of TestCaseLibrary, the test cases of which may be added to the campaign

findTestPlanByCampaignId

org.squashtest.tm.core.foundation.collection.PagedCollectionHolder<List<org.squashtest.tm.domain.campaign.CampaignTestPlanItem>> findTestPlanByCampaignId(long campaignId,
                                                                                                                                                        org.squashtest.tm.core.foundation.collection.PagingAndSorting filter)

findTestPlan

org.squashtest.tm.core.foundation.collection.PagedCollectionHolder<List<IndexedCampaignTestPlanItem>> findTestPlan(long campaignId,
                                                                                                                 org.squashtest.tm.core.foundation.collection.PagingAndMultiSorting sorting,
                                                                                                                 org.squashtest.tm.core.foundation.collection.ColumnFiltering filtering)

addTestCasesToCampaignTestPlan

void addTestCasesToCampaignTestPlan(List<Long> testCaseIds,
                                  long campaignId)

Adds a list of test cases to a campaign. If a test case have one or several datasets, that test case will be planned as many time with a different dataset.

Parameters:

testCaseIds -

campaignId -

addTestCaseToCampaignTestPlan

void addTestCaseToCampaignTestPlan(Long testCaseId,
                                 Long datasetId,
                                 long campaignId)

Will add the given test case, with the given test plan, to the test plan of the given campaign.

Parameters:

testCaseId -

datasetId, - may be null

campaignId -

findAssignableUserForTestPlan

List<org.squashtest.tm.domain.users.User> findAssignableUserForTestPlan(long campaignId)

Get Users with Execute Access for a campaign and his test plans.

Parameters:

testCaseId -

campaignId -

assignUserToTestPlanItem

void assignUserToTestPlanItem(long itemId,
                            long campaignId,
                            long userId)

Assign a user to the given test plan items

Parameters:

itemsIds - the test plan items to which assign a user

campaignId - the campaign which test plan contains the items.

userId - the assigned user

assignUserToTestPlanItems

void assignUserToTestPlanItems(List<Long> itemsIds,
                             long campaignId,
                             long userId)

Assign a user to the given test plan items

Parameters:

itemsIds - the test plan items to which assign a user

campaignId - the campaign which test plan contains the items.

userId - the assigned user

moveTestPlanItems

void moveTestPlanItems(long campaignId,
                     int targetIndex,
                     List<Long> itemIds)

Parameters:

campaignId - the campaign which test plan we are about to modify.

targetIndex - the index of the test plan to which we want to move the items

itemIds - the ids of the items we want to move.

reorderTestPlan

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

removeTestPlanItem

void removeTestPlanItem(long campaignId,
                      long itemId)

Parameters:

campaignId - id of the campaign which test plan we will remove an item from

itemId - id of the test plan item we want to remove

removeTestPlanItems

void removeTestPlanItems(long campaignId,
                       List<Long> itemIds)

Parameters:

campaignId - id of the campaign which test plan we will remove items from

itemId -

findById

org.squashtest.tm.domain.campaign.CampaignTestPlanItem findById(long itemId)

Parameters:

itemId -

Returns:

findPlannedTestCasesIds

List<Long> findPlannedTestCasesIds(Long campaignId)

Will find the distinct ids of test cases referenced in the campaign test plan.

Parameters:

campaignId - : the id of the concerned Campaign

Returns:

: the distinct ids of the TestCases referenced by the campaign.

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)