com.atlassian.jira.functest.framework.admin
Interface Project

All Known Implementing Classes:

ProjectImpl

public interface Project

Framework for manipulating projects

Since:

v3.13

Method Summary

String	addComponent(String projectKey, String componentName, String description, String leadUserName) Adds a component to the project
long	addProject(String name, String key, String lead) Adds a project, or if a project with that name exists, does almost nothing.
String	addVersion(String projectKey, String versionName, String description, String releaseDate) Adds a version to a project.
void	archiveVersion(String projectKey, String versionName) Archives a version of a project.
void	associateFieldConfigurationScheme(String projectName, String newFieldConfigurationSchemeName) Associates the specified configuration scheme with the project.
void	associateNotificationScheme(String projectName, String notificationSchemeName) Associates the specified notification scheme with the project.
void	associateWorkflowScheme(String projectName, String workflowSchemeName) Associates the specified workflow scheme with the project.
void	associateWorkflowScheme(String projectName, String workflowSchemeName, Map<String,String> statusMapping, boolean wait) Associates the specified workflow scheme with the project.
void	deleteProject(long projectId) Delete a project
void	deleteProject(String project) Delete project with the given name
void	deleteVersion(String projectKey, String versionName) Deletes a version of a project.
void	editComponent(String projectKey, String componentName, String name, String description, String leadUserName) Edits a component of a project.
void	editProject(long projectId, String name, String description, String url) Change the parameters for the passed project.
void	editVersionDetails(String projectName, String versionName, String name, String description, String releaseDate) Edits a version of a project.
boolean	projectExists(String project) Checks whether or not the specified project exists.
void	releaseVersion(String projectKey, String versionName, String releaseDate) Releases a version of a project.
void	setProjectLead(String projectName, String userName) Sets the lead for a project
void	unreleaseVersion(String projectKey, String versionName, String releaseDate) Unreleases a version of a project.
void	viewProject(String project) Browses to the View Project administration screen.

Method Detail

projectExists

boolean projectExists(String project)

Checks whether or not the specified project exists.

Parameters:

project - the name of the project to check e.g. "homosapien"

Returns:

true if the project already exists; false otherwise

addProject

long addProject(String name,
                String key,
                String lead)

Adds a project, or if a project with that name exists, does almost nothing. Choose a project name that will not clash with operational links on the page such as "View Projects" or "Add".

Parameters:

name - the name of the project.

key - the project key.

lead - the username of the project lead.

Returns:

the project id.

viewProject

void viewProject(String project)

Browses to the View Project administration screen.

Parameters:

project - the name of the project

editProject

void editProject(long projectId,
                 String name,
                 String description,
                 String url)

Change the parameters for the passed project.

Parameters:

projectId - the id of the project to change.

name - the new name of the project. Set to null to keep current setting.

description - the description of the project. Set to null to keep current setting.

url - the url for the project. Set to null to keep current setting.

deleteProject

void deleteProject(long projectId)

Delete a project

Parameters:

projectId - the id of the project

deleteProject

void deleteProject(String project)

Delete project with the given name

Parameters:

project - the project name.

addVersion

String addVersion(String projectKey,
                  String versionName,
                  String description,
                  String releaseDate)

Adds a version to a project.

Parameters:

projectKey - the key of the project e.g. "HSP".

versionName - the name of the version e.g. "New Version 1"

description - the new description of the version; use null to not provide a description

releaseDate - the new release date of the version; use null to not provide a release date

Returns:

the version id.

archiveVersion

void archiveVersion(String projectKey,
                    String versionName)

Archives a version of a project.

Parameters:

projectKey - the name of the project e.g. "HSP"

versionName - the name of the version e.g. "New Version 5"

releaseVersion

void releaseVersion(String projectKey,
                    String versionName,
                    String releaseDate)

Releases a version of a project.

Parameters:

projectKey - the name of the project e.g. "HSP". Must not be null.

versionName - the name of the version e.g. "New Version 5". Must not be null.

releaseDate - the release date of the version. Use null to ignore setting of this field.

unreleaseVersion

void unreleaseVersion(String projectKey,
                      String versionName,
                      String releaseDate)

Unreleases a version of a project.

Parameters:

projectKey - the name of the project e.g. "HSP". Must not be null.

versionName - the name of the version e.g. "New Version 5". Must not be null.

releaseDate - the release date of the version. Use null to ignore setting of this field.

deleteVersion

void deleteVersion(String projectKey,
                   String versionName)

Deletes a version of a project.

Parameters:

projectKey - the name of the project e.g. "HSP". Must not be null.

versionName - the name of the version e.g. "New Version 5". Must not be null.

editVersionDetails

void editVersionDetails(String projectName,
                        String versionName,
                        String name,
                        String description,
                        String releaseDate)

Edits a version of a project.

Parameters:

projectName - the name of the project e.g. "homosapien".

versionName - the name of the version e.g. "New Version 1"

name - the new name of the version; use null to retain previous value

description - the new description of the version; use null to retain previous value

releaseDate - the new release date of the version; use null to retain previous value

editComponent

void editComponent(String projectKey,
                   String componentName,
                   String name,
                   String description,
                   String leadUserName)

Edits a component of a project.

Parameters:

projectKey - the key of the project e.g. "HSP".

componentName - the name of the component e.g. "New Component 1"

name - the new name of the component; use null to retain previous value

description - the new description of the component; use null to retain previous value

leadUserName - the new username of the component lead; use null to retain previous value

associateFieldConfigurationScheme

void associateFieldConfigurationScheme(String projectName,
                                       String newFieldConfigurationSchemeName)

Associates the specified configuration scheme with the project.

Parameters:

projectName - the name of the project to alter

newFieldConfigurationSchemeName - the name of the new field configuration scheme; use null or "None" to restore the System Default Field Configuration Scheme.

associateWorkflowScheme

void associateWorkflowScheme(String projectName,
                             String workflowSchemeName)

Associates the specified workflow scheme with the project.

Parameters:

projectName - the name of the project to alter

workflowSchemeName - name of the workflow scheme to associate.

associateWorkflowScheme

void associateWorkflowScheme(String projectName,
                             String workflowSchemeName,
                             Map<String,String> statusMapping,
                             boolean wait)

Associates the specified workflow scheme with the project.

Parameters:

projectName - the name of the project to alter

workflowSchemeName - name of the workflow scheme to associate.

statusMapping - mapping for statuses

associateNotificationScheme

void associateNotificationScheme(String projectName,
                                 String notificationSchemeName)

Associates the specified notification scheme with the project.

Parameters:

projectName - the name of the project to alter

notificationSchemeName - name of the notification scheme to associate.

setProjectLead

void setProjectLead(String projectName,
                    String userName)

Sets the lead for a project

Parameters:

projectName - the project to change

userName - the new project lead

addComponent

String addComponent(String projectKey,
                    String componentName,
                    String description,
                    String leadUserName)

Adds a component to the project

Parameters:

projectKey - the key of the project

componentName - the component name

description - the description; use null to not set one

leadUserName - the lead user's name; use null to not set one

Returns:

the id of the component