org.squashtest.tm.service.campaign
Interface CampaignLibraryNavigationService

All Superinterfaces:

CampaignLibraryFinderService, LibraryNavigationService<org.squashtest.tm.domain.campaign.CampaignLibrary,org.squashtest.tm.domain.campaign.CampaignFolder,org.squashtest.tm.domain.campaign.CampaignLibraryNode>

All Known Implementing Classes:

CampaignLibraryNavigationServiceImpl

public interface CampaignLibraryNavigationService
extends LibraryNavigationService<org.squashtest.tm.domain.campaign.CampaignLibrary,org.squashtest.tm.domain.campaign.CampaignFolder,org.squashtest.tm.domain.campaign.CampaignLibraryNode>, CampaignLibraryFinderService

Method Summary

void	addCampaignToCampaignFolder(long folderId, org.squashtest.tm.domain.campaign.Campaign campaign) Adds a campaign to a folder.
void	addCampaignToCampaignFolder(long folderId, org.squashtest.tm.domain.campaign.Campaign campaign, Map<Long,String> customFieldValues) Adds a campaign to a folder, and its initial custom field values.
void	addCampaignToCampaignLibrary(long libraryId, org.squashtest.tm.domain.campaign.Campaign campaign) Adds a Campaign to the root of the library.
void	addCampaignToCampaignLibrary(long libraryId, org.squashtest.tm.domain.campaign.Campaign campaign, Map<Long,String> customFieldValues) Adds a Campaign to the root of the Library, and its initial custom field values.
int	addIterationToCampaign(org.squashtest.tm.domain.campaign.Iteration iteration, long campaignId, boolean copyTestPlan) Adds a new iteration to a campaign.
int	addIterationToCampaign(org.squashtest.tm.domain.campaign.Iteration iteration, long campaignId, boolean copyTestPlan, Map<Long,String> customFieldValues) Adds a new iteration to a campaign.
List<org.squashtest.tm.domain.campaign.Iteration>	copyIterationsToCampaign(long campaignId, Long[] iterationsIds)
OperationReport	deleteIterations(List<Long> targetIds) that method should delete the iterations.
OperationReport	deleteSuites(List<Long> suiteIds) that method should delete test suites, and remove its references in iteration and iteration test plan item
org.squashtest.tm.domain.campaign.CampaignExportCSVModel	exportCampaignToCSV(Long campaignId, String exportType) given a campaign Id, returns a model.
org.squashtest.tm.domain.campaign.Campaign	findCampaign(long campaignId) Deprecated. use CampaignFinder.findById(long) instead
org.squashtest.tm.domain.campaign.Iteration	findIteration(long iterationId) Deprecated. use IterationFinder.findById(long) instead
List<org.squashtest.tm.domain.campaign.TestSuite>	findIterationContent(long iterationId)
List<org.squashtest.tm.domain.campaign.Iteration>	findIterationsByCampaignId(long campaignId)
List<org.squashtest.tm.domain.campaign.CampaignLibrary>	findLinkableCampaignLibraries()
List<String>	getParentNodesAsStringList(Long elementId)
List<SuppressionPreviewReport>	simulateIterationDeletion(List<Long> targetIds) that method should investigate the consequences of the deletion request of iterations, and return a report about what will happen.
List<SuppressionPreviewReport>	simulateSuiteDeletion(List<Long> targetIds) that method should investigate the consequences of the deletion request of tes suites, and return a report about what will happen.

Methods inherited from interface org.squashtest.tm.service.library.LibraryNavigationService

addFolderToFolder, addFolderToLibrary, copyNodesToFolder, copyNodesToLibrary, deleteNodes, findCreatableLibrary, findFolder, findFolderContent, findLibrary, findLibraryOfRootNodeIfExist, findLibraryRootContent, findParentIfExists, moveNodesToFolder, moveNodesToLibrary, renameFolder, simulateDeletion

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

getPathAsString

Method Detail

addCampaignToCampaignLibrary

void addCampaignToCampaignLibrary(long libraryId,
                                  org.squashtest.tm.domain.campaign.Campaign campaign)

Adds a Campaign to the root of the library. The custom fields will be created with their default value.

Parameters:

libraryId -

campaign -

addCampaignToCampaignLibrary

void addCampaignToCampaignLibrary(long libraryId,
                                  org.squashtest.tm.domain.campaign.Campaign campaign,
                                  Map<Long,String> customFieldValues)

Adds a Campaign to the root of the Library, and its initial custom field values. The initial custom field values are passed as a Map, that maps the id of the CustomField to the values of the corresponding CustomFieldValue. Read that last sentence again.

Parameters:

libraryId -

campaign -

customFieldValues -

addCampaignToCampaignFolder

void addCampaignToCampaignFolder(long folderId,
                                 org.squashtest.tm.domain.campaign.Campaign campaign)

Adds a campaign to a folder. The custom fields will be created with their default value.

Parameters:

libraryId -

campaign -

addCampaignToCampaignFolder

void addCampaignToCampaignFolder(long folderId,
                                 org.squashtest.tm.domain.campaign.Campaign campaign,
                                 Map<Long,String> customFieldValues)

Adds a campaign to a folder, and its initial custom field values. The initial custom field values are passed as a Map, that maps the id of the CustomField to the values of the corresponding CustomFieldValue. Read that last sentence again.

Parameters:

libraryId -

campaign -

customFieldValues -

findCampaign

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

Deprecated. use CampaignFinder.findById(long) instead

Parameters:

campaignId -

Returns:

addIterationToCampaign

int addIterationToCampaign(org.squashtest.tm.domain.campaign.Iteration iteration,
                           long campaignId,
                           boolean copyTestPlan)

Adds a new iteration to a campaign. Returns the index of the new iteration.

Parameters:

iteration -

campaignId -

Returns:

addIterationToCampaign

int addIterationToCampaign(org.squashtest.tm.domain.campaign.Iteration iteration,
                           long campaignId,
                           boolean copyTestPlan,
                           Map<Long,String> customFieldValues)

Adds a new iteration to a campaign. Returns the index of the new iteration. The initial custom field values are passed as a Map, that maps the id of the CustomField to the values of the corresponding CustomFieldValue. Read that last sentence again.

Parameters:

iteration -

campaignId -

Returns:

findIterationsByCampaignId

List<org.squashtest.tm.domain.campaign.Iteration> findIterationsByCampaignId(long campaignId)

copyIterationsToCampaign

List<org.squashtest.tm.domain.campaign.Iteration> copyIterationsToCampaign(long campaignId,
                                                                           Long[] iterationsIds)

findIteration

@Deprecated
org.squashtest.tm.domain.campaign.Iteration findIteration(long iterationId)

Deprecated. use IterationFinder.findById(long) instead

Parameters:

iterationId -

Returns:

findIterationContent

List<org.squashtest.tm.domain.campaign.TestSuite> findIterationContent(long iterationId)

findLinkableCampaignLibraries

List<org.squashtest.tm.domain.campaign.CampaignLibrary> findLinkableCampaignLibraries()

simulateIterationDeletion

List<SuppressionPreviewReport> simulateIterationDeletion(List<Long> targetIds)

that method should investigate the consequences of the deletion request of iterations, and return a report about what will happen.

Parameters:

targetIds -

Returns:

deleteIterations

OperationReport deleteIterations(List<Long> targetIds)

that method should delete the iterations. It still takes care of non deletable iterations so the implementation should filter out the ids who can't be deleted.

Parameters:

targetIds -

Returns:

simulateSuiteDeletion

List<SuppressionPreviewReport> simulateSuiteDeletion(List<Long> targetIds)

that method should investigate the consequences of the deletion request of tes suites, and return a report about what will happen.

Parameters:

targetIds -

Returns:

deleteSuites

OperationReport deleteSuites(List<Long> suiteIds)

that method should delete test suites, and remove its references in iteration and iteration test plan item

Parameters:

testSuites -

Returns:

exportCampaignToCSV

org.squashtest.tm.domain.campaign.CampaignExportCSVModel exportCampaignToCSV(Long campaignId,
                                                                             String exportType)

given a campaign Id, returns a model. It's made of rows and cell, and have a row header, check the relevant methods. Note that the actual model will differ according to the export type : "L" (light), "S" (standard), "F" (full).

Parameters:

campaignId -

Returns:

getParentNodesAsStringList

List<String> getParentNodesAsStringList(Long elementId)