flexagon.fd.services.webhooks.functions

Class FlexDeployFunctions

java.lang.Object

BaseFunctions

flexagon.fd.services.webhooks.functions.FlexDeployFunctions

public class FlexDeployFunctions
extends BaseFunctions

Functions to perform actions in FlexDeploy, like building a project or starting a release.

Since:

5.3

Constructor Summary

Constructors

Constructor and Description
FlexDeployFunctions(DevOpsRestAM pRestAM, LogFunctions pFLOG)

Method Summary

Modifier and Type	Method and Description
void	addFilesToPackage(java.lang.Long pProjectId, java.lang.String pPackageName, java.util.List<java.lang.String> pFiles) Adds files to a given package.
void	addProjectsToRelease(java.lang.String pReleaseName, java.util.List<ReleaseProjectsPojo> pReleaseProjects) Add FlexDeploy projects to a given release.
void	approveTask(java.lang.String pUsername, java.lang.Long pTaskId, java.lang.String pNotes) Approve a FlexDeploy Task.
java.lang.Long	buildPackage(java.lang.Long pStreamId, ProjectPackagePojo projectPackage) Builds a FlexDeploy Package.
java.lang.Long	buildPackage(java.lang.Long pStreamId, ProjectPackagePojo projectPackage, PollingResult pPollingResult) Builds a FlexDeploy Package using a PollingResult.
java.lang.Long	buildPackage(java.lang.Long pStreamId, ProjectPackagePojo projectPackage, java.lang.String pEnvironmentCode) Builds a FlexDeploy Package.
java.lang.Long	buildPackage(java.lang.Long pStreamId, ProjectPackagePojo projectPackage, java.lang.String pEnvironmentCode, PollingResult pPollingResult) Builds a FlexDeploy Package using a PollingResult.
java.lang.Long	buildProject(java.lang.Long pStreamId, java.lang.Long pProjectId) Builds a FlexDeploy Project.
java.lang.Long	buildProject(java.lang.Long pStreamId, java.lang.Long pProjectId, PollingResult pPollingResult) Builds a FlexDeploy Project using a PollingResult.
java.lang.Long	buildProject(java.lang.Long pStreamId, java.lang.Long pProjectId, java.lang.String pEnvironmentCode) Builds a FlexDeploy Project.
java.lang.Long	buildProject(java.lang.Long pStreamId, java.lang.Long pProjectId, java.lang.String pEnvironmentCode, PollingResult pPollingResult) Builds a FlexDeploy Project using a PollingResult.
java.lang.Long	createPackage(java.lang.Long pProjectId, java.lang.String pPackageName, java.lang.String pDescription, java.util.List<java.lang.String> pFiles) Creates a package for a given project and list of files.
java.lang.Long	createRelease(java.lang.String pReleaseName, java.lang.String pPipelineName, java.lang.String pDescription) Create an empty FlexDeploy Release that defaults to 'Not Started' status.
java.lang.Long	createRelease(java.lang.String pReleaseName, java.lang.String pPipelineName, java.lang.String pDescription, java.lang.String pCronSchedule) Create an empty scheduled FlexDeploy Release that defaults to 'Not Started' status.
java.lang.Long	createSnapshot(java.lang.Long pReleaseId) Create a Snapshot for a given Release.
java.lang.Long	createStream(java.lang.Long pProjectId, java.lang.String pStreamName) Create a FlexDeploy Stream on a given project.
java.lang.Long	createStream(java.lang.Long pProjectId, java.lang.String pStreamName, java.lang.String pVersionSyntax) Create a FlexDeploy Stream on a given project.
void	deletePackage(java.lang.Long pProjectId, java.lang.String pPackageName) Deletes a project package
void	endRelease(java.lang.Long pReleaseId) End a FlexDeploy Release.
void	endRelease(java.lang.String pReleaseName) End a FlexDeploy Release.
PollingResult	findLocalChangeLogs(java.lang.String pUrl, java.lang.String pBranch, java.lang.String pCurrentRevision, java.lang.String pFromRevision) Finds change logs for a local ssh enabled git repository.
PollingResult	findLocalChangeLogs(java.lang.String pUrl, java.lang.String pBranch, java.lang.String pCurrentRevision, java.lang.String pFromRevision, java.lang.String pUser, java.lang.String pPassword) Finds change logs for a local git repository.
java.util.List<ProjectPackagePojo>	findPackagesForChange(java.lang.String pRepositoryName, java.lang.String pStreamName, java.util.List<java.lang.String> pChangedFiles) Finds relevant FlexDeploy Packages for a list of changed files.
java.util.List<ProjectPackagePojo>	findPackagesForChange(java.lang.String pRepositoryName, java.lang.String pStreamName, PollingResult pPollingResult) Finds relevant FlexDeploy Packages for any given PollingResult.
java.lang.Long	findProjectId(java.lang.String pProjectName) Finds the FlexDeploy Project id for any given name
java.util.Set<java.lang.Long>	findProjectsForChange(java.lang.String pRepositoryName, java.lang.String pStreamName, java.util.List<java.lang.String> pChangedFiles) Finds relevant FlexDeploy Projects for a list of changed files.
java.util.Set<java.lang.Long>	findProjectsForChange(java.lang.String pRepositoryName, java.lang.String pStreamName, PollingResult pPollingResult) Finds relevant FlexDeploy Projects for any given PollingResult and stream.
java.util.Set<java.lang.Long>	findProjectsForNewBranch(java.lang.String pRepositoryName) Finds relevant FlexDeploy Projects for a new branch event.
java.util.Set<java.lang.Long>	findProjectsForNewBranch(java.lang.String pRepositoryName, PollingResult pPollingResult) Finds relevant FlexDeploy Projects for a new branch event.
java.util.List<ReleasePojo>	findReleases(java.lang.String pName) Finds Releases matching the specified name.
java.lang.Long	findStreamId(java.lang.Long pProjectId, java.lang.String pStreamName) Finds a FlexDeploy stream id from the Stream name.
java.lang.String	getGroovyKey()
ProjectPojo	getProject(java.lang.Long pProjectId) Returns project information for a given projectId.
ReleasePojo	getRelease(java.lang.Long pId) Gets a release by a specific id.
void	inactivateStream(java.lang.Long pProjectId, java.lang.String pStreamName) Inactive a FlexDeploy Stream on a project.
void	pauseRelease(java.lang.Long pReleaseId) Pause a FlexDeploy Release.
void	pauseRelease(java.lang.String pReleaseName) Pause a FlexDeploy Release.
java.lang.Integer	populateFiles(java.lang.Long pProjectId, java.lang.Long pStreamId) Populate partial deployment files for a given project.
void	rejectTask(java.lang.String pUsername, java.lang.Long pTaskId, java.lang.String pNotes) Reject a FlexDeploy Task.
void	removeProjectsFromRelease(java.lang.String pReleaseName, java.util.List<ReleaseProjectsPojo> pReleaseProjects) Remove FlexDeploy projects from a given release.
void	startRelease(java.lang.Long pReleaseId) Start a FlexDeploy Release.
void	startRelease(java.lang.String pReleaseName) Start a FlexDeploy Release.
void	updatePackage(java.lang.Long pProjectId, java.lang.String pPackageName, java.lang.Long pStreamId, PollingResult pPollingResult) Updates a given package relative to a PollingResult.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

FlexDeployFunctions

public FlexDeployFunctions(DevOpsRestAM pRestAM,
                           LogFunctions pFLOG)

Method Detail

findLocalChangeLogs

public PollingResult findLocalChangeLogs(java.lang.String pUrl,
                                         java.lang.String pBranch,
                                         java.lang.String pCurrentRevision,
                                         java.lang.String pFromRevision)
                                  throws FlexCheckedException

Finds change logs for a local ssh enabled git repository. This can be used as a replacement for the getChangeLogs functions if your git provider doesn't have a specific function. If fromRevision is null it will return an empty PollingResult object. If your repository is not ssh enabled see findLocalChangeLogs

Parameters:

pUrl - Url of the git repository to find logs against

pBranch - Branch to find logs against

pCurrentRevision - Current revision after the push

pFromRevision - Previous revision before the push

Returns:

PollingResult object containing the change logs found.

Throws:

FlexCheckedException - If an invalid revision is passed.

Since:

5.3.0.1

findLocalChangeLogs

public PollingResult findLocalChangeLogs(java.lang.String pUrl,
                                         java.lang.String pBranch,
                                         java.lang.String pCurrentRevision,
                                         java.lang.String pFromRevision,
                                         java.lang.String pUser,
                                         java.lang.String pPassword)
                                  throws FlexCheckedException

Finds change logs for a local git repository. This can be used as a replacement for the getChangeLogs functions if your git provider doesn't have a specific function. If fromRevision is null it will return an empty PollingResult object

Parameters:

pUrl - Url of the git repository to find logs against

pBranch - Branch to find logs against

pCurrentRevision - Current revision after the push

pFromRevision - Previous revision before the push

pUser - User to use for local credentials

pPassword - Password of the user

Returns:

PollingResult object containing the change logs found.

Throws:

FlexCheckedException - If an invalid revision is passed.

Since:

5.3.0.1

getProject

public ProjectPojo getProject(java.lang.Long pProjectId)
                       throws FlexNotFoundException

Returns project information for a given projectId.

Parameters:

pProjectId - Project Id of the project to retrieve

Returns:

Object containing meta data about the given project

Throws:

FlexNotFoundException - When no project is found for given Id

Since:

5.3.0.1

getRelease

public ReleasePojo getRelease(java.lang.Long pId)
                       throws FlexNotFoundException

Gets a release by a specific id.

Parameters:

pId - Release Id

Returns:

Object containing Release metadata

Throws:

FlexNotFoundException - When no Release is found for the given id

Since:

5.3.0.1

findReleases

public java.util.List<ReleasePojo> findReleases(java.lang.String pName)
                                         throws FlexNotFoundException

Finds Releases matching the specified name. Search uses an ignore case and contains on the Release Name. Unlike getRelease this method returns a list of Releases.

Parameters:

pName - Name to search by

Returns:

A List of Release objects containing Release information.

Throws:

FlexNotFoundException - When no releases match the naming criteria

Since:

5.3.0.1

addFilesToPackage

public void addFilesToPackage(java.lang.Long pProjectId,
                              java.lang.String pPackageName,
                              java.util.List<java.lang.String> pFiles)
                       throws FlexCheckedException

Adds files to a given package. The files should match the filepath found in the project files tab on the project.

Parameters:

pProjectId - Parent project id of the package

pPackageName - Name of the package

pFiles - Filepaths to add to the package.

Throws:

FlexCheckedException

populateFiles

public java.lang.Integer populateFiles(java.lang.Long pProjectId,
                                       java.lang.Long pStreamId)

Populate partial deployment files for a given project. This will automatically save populate changes so it should only be used after commands and attributes have been validated.

Parameters:

pProjectId - Project id to populate files for. This should be a project using partial deployment.

pStreamId - Stream id to use when populating.

Returns:

The number of new files found during populate.

See Also:

findStreamId(java.lang.Long, java.lang.String)

updatePackage

public void updatePackage(java.lang.Long pProjectId,
                          java.lang.String pPackageName,
                          java.lang.Long pStreamId,
                          PollingResult pPollingResult)
                   throws FlexNotFoundException,
                          FlexCheckedException

Updates a given package relative to a PollingResult. For manually adding files to a package use the addFilesToPackage method. This function will automatically populate files if new files are detected.

Parameters:

pProjectId - Parent project id of the package

pPackageName - Name of the package

pStreamId - Stream to use when populating files if new files are found

pPollingResult - PollingResult object to use for finding differences

Throws:

FlexNotFoundException - Project id is not found or package doesnt exist on project.

FlexCheckedException - All other exceptions

See Also:

BitbucketFunctions.getChangeLogs(java.lang.Object, java.lang.String, java.lang.String), GithubFunctions.getChangeLogs(java.lang.Object)

createPackage

public java.lang.Long createPackage(java.lang.Long pProjectId,
                                    java.lang.String pPackageName,
                                    java.lang.String pDescription,
                                    java.util.List<java.lang.String> pFiles)
                             throws FlexCheckedException

Creates a package for a given project and list of files.

Parameters:

pProjectId - Parent project id to create package under.

pPackageName - Package name to use.

pDescription - Description to give the package.

pFiles - List of files to add to the package. File paths should be as they appear in the project files tab of the project.

Returns:

Package id

Throws:

FlexCheckedException

deletePackage

public void deletePackage(java.lang.Long pProjectId,
                          java.lang.String pPackageName)
                   throws FlexCheckedException

Deletes a project package

Parameters:

pProjectId - Parent project id package is under.

pPackageName - Name of package to delete.

Throws:

FlexCheckedException

buildPackage

public java.lang.Long buildPackage(java.lang.Long pStreamId,
                                   ProjectPackagePojo projectPackage)
                            throws FlexCheckedException

Builds a FlexDeploy Package. This function will gather change logs and commiter information from scm. If you have this information already you can improve performance by using PollingResult variant

Parameters:

pStreamId - Stream to use when building package. See findStreamId.

projectPackage - Wrapper object containing project id and package name to build.

Returns:

WorkflowRequest id

Throws:

FlexCheckedException

buildPackage

public java.lang.Long buildPackage(java.lang.Long pStreamId,
                                   ProjectPackagePojo projectPackage,
                                   java.lang.String pEnvironmentCode)
                            throws FlexCheckedException

Builds a FlexDeploy Package. This function will gather change logs and commiter information from scm. If you have this information already you can improve performance by using PollingResult variant

Parameters:

pStreamId - Stream to use when building package. See findStreamId.

projectPackage - Wrapper object containing project id and package name to build.

pEnvironmentCode - Environment code to use for the build request.

Returns:

WorkflowRequest id

Throws:

FlexCheckedException

buildPackage

public java.lang.Long buildPackage(java.lang.Long pStreamId,
                                   ProjectPackagePojo projectPackage,
                                   PollingResult pPollingResult)
                            throws FlexCheckedException

Builds a FlexDeploy Package using a PollingResult.

Parameters:

pStreamId - Stream to use when building package. See findStreamId.

projectPackage - Wrapper object containing project id and package name to build.

pPollingResult - PollingResult object containing change logs and committer information.

Returns:

WorkflowRequest id

Throws:

FlexCheckedException

See Also:

BitbucketFunctions.getChangeLogs(java.lang.Object, java.lang.String, java.lang.String), GithubFunctions.getChangeLogs(java.lang.Object)

buildPackage

public java.lang.Long buildPackage(java.lang.Long pStreamId,
                                   ProjectPackagePojo projectPackage,
                                   java.lang.String pEnvironmentCode,
                                   PollingResult pPollingResult)
                            throws FlexCheckedException

Builds a FlexDeploy Package using a PollingResult.

Parameters:

pStreamId - Stream to use when building package. See findStreamId.

projectPackage - Wrapper object containing project id and package name to build.

pEnvironmentCode - Environment code to use for the build request.

pPollingResult - PollingResult object containing change logs and committer information.

Returns:

WorkflowRequest id

Throws:

FlexCheckedException

See Also:

BitbucketFunctions.getChangeLogs(java.lang.Object, java.lang.String, java.lang.String), GithubFunctions.getChangeLogs(java.lang.Object)

buildProject

public java.lang.Long buildProject(java.lang.Long pStreamId,
                                   java.lang.Long pProjectId)
                            throws FlexCheckedException

Builds a FlexDeploy Project. This function will gather change logs and commiter information from scm. If you have this information already you can improve performance by using PollingResult variant

Parameters:

pStreamId - Stream to use when building project. See findStreamId.

pProjectId - Project id to build.

Returns:

WorkflowRequest id

Throws:

FlexCheckedException

buildProject

public java.lang.Long buildProject(java.lang.Long pStreamId,
                                   java.lang.Long pProjectId,
                                   java.lang.String pEnvironmentCode)
                            throws FlexCheckedException

Builds a FlexDeploy Project. This function will gather change logs and commiter information from scm. If you have this information already you can improve performance by using PollingResult variant

Parameters:

pStreamId - Stream to use when building project. See findStreamId.

pProjectId - Project id to build.

pEnvironmentCode - Environment code to use for the build request.

Returns:

WorkflowRequest id

Throws:

FlexCheckedException

buildProject

public java.lang.Long buildProject(java.lang.Long pStreamId,
                                   java.lang.Long pProjectId,
                                   PollingResult pPollingResult)
                            throws FlexCheckedException

Builds a FlexDeploy Project using a PollingResult.

Parameters:

pStreamId - Stream to use when building project. See findStreamId.

pProjectId - Project id to build.

pPollingResult - PollingResult object containing change logs and committer information.

Returns:

WorkflowRequest id

Throws:

FlexCheckedException

See Also:

BitbucketFunctions.getChangeLogs(java.lang.Object, java.lang.String, java.lang.String), GithubFunctions.getChangeLogs(java.lang.Object)

buildProject

public java.lang.Long buildProject(java.lang.Long pStreamId,
                                   java.lang.Long pProjectId,
                                   java.lang.String pEnvironmentCode,
                                   PollingResult pPollingResult)
                            throws FlexCheckedException

Builds a FlexDeploy Project using a PollingResult.

Parameters:

pStreamId - Stream to use when building project. See findStreamId.

pProjectId - Project id to build.

pEnvironmentCode - Environment code to use for the build request.

pPollingResult - PollingResult object containing change logs and committer information.

Returns:

WorkflowRequest id

Throws:

FlexCheckedException

See Also:

BitbucketFunctions.getChangeLogs(java.lang.Object, java.lang.String, java.lang.String), GithubFunctions.getChangeLogs(java.lang.Object)

findProjectsForNewBranch

public java.util.Set<java.lang.Long> findProjectsForNewBranch(java.lang.String pRepositoryName)

Finds relevant FlexDeploy Projects for a new branch event. All webhook enabled projects using this repository will be returned. This function currently only compares against Git repositories and is not compatible with other scm types.

Parameters:

pRepositoryName - Github repository name with the change. Name is of the form (username/repo). e.g. toddmotto/public-apis

Returns:

List of Project ids

Since:

5.3.0.1

findProjectsForNewBranch

public java.util.Set<java.lang.Long> findProjectsForNewBranch(java.lang.String pRepositoryName,
                                                              PollingResult pPollingResult)

Finds relevant FlexDeploy Projects for a new branch event. Only projects whose sources use the files found in the polling result will be returned. If you want to return ALL projects regardless of changed files then use findProjectsForNewBranch. This function currently only compares against Git repositories and is not compatible with other scm types.

Parameters:

pRepositoryName - Github repository name with the change. Name is of the form (username/repo). e.g. toddmotto/public-apis

pPollingResult - PollingResult object for determining relevant projects.

Returns:

List of Project ids

Since:

5.3.0.1

See Also:

BitbucketFunctions.getChangeLogs(java.lang.Object, java.lang.String, java.lang.String), GithubFunctions.getChangeLogs(java.lang.Object)

findProjectsForChange

public java.util.Set<java.lang.Long> findProjectsForChange(java.lang.String pRepositoryName,
                                                           java.lang.String pStreamName,
                                                           PollingResult pPollingResult)

Finds relevant FlexDeploy Projects for any given PollingResult and stream. A project must have a webhook trigger configured for this stream on the CI tab in order to be found by this function. This function currently only compares against Git repositories and is not compatible with other scm types.

Parameters:

pRepositoryName - Github repository name with the change. Name is of the form (username/repo). e.g. toddmotto/public-apis

pStreamName - Stream/branch name for which the change occurred. e.g. 'master'

pPollingResult - PollingResult object for determining relevant projects.

Returns:

List of Project ids

See Also:

BitbucketFunctions.getChangeLogs(java.lang.Object, java.lang.String, java.lang.String), GithubFunctions.getChangeLogs(java.lang.Object)

findProjectsForChange

public java.util.Set<java.lang.Long> findProjectsForChange(java.lang.String pRepositoryName,
                                                           java.lang.String pStreamName,
                                                           java.util.List<java.lang.String> pChangedFiles)

Finds relevant FlexDeploy Projects for a list of changed files. A project must have a webhook trigger configured for this stream on the CI tab in order to be found by this function. This function currently only compares against Git repositories and is not compatible with other scm types.

Parameters:

pRepositoryName - Github repository name with the change. Name is of the form (username/repo). e.g. toddmotto/public-apis

pStreamName - Stream/branch name for which the change occurred. e.g. 'master'

pChangedFiles - List of changed files from a push event. If no files are passed then all projects using given repository will be returned.

Returns:

List of Project ids

See Also:

BitbucketFunctions.getChangeLogs(java.lang.Object, java.lang.String, java.lang.String), GithubFunctions.getChangeLogs(java.lang.Object)

findPackagesForChange

public java.util.List<ProjectPackagePojo> findPackagesForChange(java.lang.String pRepositoryName,
                                                                java.lang.String pStreamName,
                                                                PollingResult pPollingResult)

Finds relevant FlexDeploy Packages for any given PollingResult. A project must have a webhook trigger configured for this stream on the CI tab in order to be found by this function.This function currently only compares against Git repositories and is not compatible with other scm types.

Parameters:

pRepositoryName - Github repository name with the change. Name is of the form (username/repo). e.g. toddmotto/public-apis

pStreamName - Stream/branch name for which the change occurred. e.g. 'master'

pPollingResult - PollingResult object for determining relevant packages.

Returns:

List of ProjectPackages

See Also:

BitbucketFunctions.getChangeLogs(java.lang.Object, java.lang.String, java.lang.String), GithubFunctions.getChangeLogs(java.lang.Object)

findPackagesForChange

public java.util.List<ProjectPackagePojo> findPackagesForChange(java.lang.String pRepositoryName,
                                                                java.lang.String pStreamName,
                                                                java.util.List<java.lang.String> pChangedFiles)

Finds relevant FlexDeploy Packages for a list of changed files. A project must have a webhook trigger configured for this stream on the CI tab in order to be found by this function. This function currently only compares against Git repositories and is not compatible with other scm types.

Parameters:

pRepositoryName - Github repository name with the change. Name is of the form (username/repo). e.g. toddmotto/public-apis

pStreamName - Stream/branch name for which the change occurred. e.g. 'master'

pChangedFiles - List of changed files from a push event. If no files are passed then all packages using given repository will be returned.

Returns:

List of ProjectPackages

See Also:

BitbucketFunctions.getChangeLogs(java.lang.Object, java.lang.String, java.lang.String), GithubFunctions.getChangeLogs(java.lang.Object)

findProjectId

public java.lang.Long findProjectId(java.lang.String pProjectName)
                             throws FlexNotFoundException,
                                    FlexCheckedException

Finds the FlexDeploy Project id for any given name

Parameters:

pProjectName - Case sensitive project name to search by

Returns:

Project id

Throws:

FlexNotFoundException - If project name is not found in FlexDeploy

FlexCheckedException - All other exceptions

createRelease

public java.lang.Long createRelease(java.lang.String pReleaseName,
                                    java.lang.String pPipelineName,
                                    java.lang.String pDescription)
                             throws FlexCheckedException

Create an empty FlexDeploy Release that defaults to 'Not Started' status.

Parameters:

pReleaseName - Name to give Release.

pPipelineName - Pipeline name to use for the Release.

pDescription - Optional description to give the Release.

Returns:

Release id

Throws:

FlexCheckedException

createRelease

public java.lang.Long createRelease(java.lang.String pReleaseName,
                                    java.lang.String pPipelineName,
                                    java.lang.String pDescription,
                                    java.lang.String pCronSchedule)
                             throws FlexCheckedException

Create an empty scheduled FlexDeploy Release that defaults to 'Not Started' status.

Parameters:

pReleaseName - Name to give Release.

pPipelineName - Pipeline name to use for the Release.

pDescription - Optional description to give the Release.

pCronSchedule - Cron schedule to give the Release.

Returns:

Release id

Throws:

FlexCheckedException

endRelease

public void endRelease(java.lang.String pReleaseName)
                throws FlexCheckedException,
                       FlexNotFoundException

End a FlexDeploy Release.

Parameters:

pReleaseName - Release name to end.

Throws:

FlexNotFoundException - When Release is not found

FlexCheckedException - All other exceptions

endRelease

public void endRelease(java.lang.Long pReleaseId)
                throws FlexCheckedException,
                       FlexNotFoundException

End a FlexDeploy Release.

Parameters:

pReleaseId - Release id to end.

Throws:

FlexNotFoundException - When Release is not found

FlexCheckedException - All other exceptions

pauseRelease

public void pauseRelease(java.lang.String pReleaseName)
                  throws FlexCheckedException,
                         FlexNotFoundException

Pause a FlexDeploy Release.

Parameters:

pReleaseName - Release name to pause.

Throws:

FlexNotFoundException - When Release is not found

FlexCheckedException - All other exceptions

Since:

5.3.0.2

pauseRelease

public void pauseRelease(java.lang.Long pReleaseId)
                  throws FlexCheckedException,
                         FlexNotFoundException

Pause a FlexDeploy Release.

Parameters:

pReleaseId - Release id to pause.

Throws:

FlexNotFoundException - When Release is not found

FlexCheckedException - All other exceptions

Since:

5.3.0.2

startRelease

public void startRelease(java.lang.String pReleaseName)
                  throws FlexCheckedException,
                         FlexNotFoundException

Start a FlexDeploy Release.

Parameters:

pReleaseName - Release name to start.

Throws:

FlexNotFoundException - When Release is not found

FlexCheckedException - All other exceptions

startRelease

public void startRelease(java.lang.Long pReleaseId)
                  throws FlexCheckedException,
                         FlexNotFoundException

Start a FlexDeploy Release.

Parameters:

pReleaseId - Release id to start.

Throws:

FlexNotFoundException - When Release is not found

FlexCheckedException - All other exceptions

addProjectsToRelease

public void addProjectsToRelease(java.lang.String pReleaseName,
                                 java.util.List<ReleaseProjectsPojo> pReleaseProjects)
                          throws FlexCheckedException,
                                 FlexNotFoundException

Add FlexDeploy projects to a given release.

Parameters:

pReleaseName - Release name to add projects to.

pReleaseProjects - List of ReleaseProjects to add.

Throws:

FlexCheckedException

FlexNotFoundException

removeProjectsFromRelease

public void removeProjectsFromRelease(java.lang.String pReleaseName,
                                      java.util.List<ReleaseProjectsPojo> pReleaseProjects)
                               throws FlexCheckedException,
                                      FlexNotFoundException

Remove FlexDeploy projects from a given release.

Parameters:

pReleaseName - Release name to remove projects from.

pReleaseProjects - List of ReleaseProjects to remove.

Throws:

FlexCheckedException

FlexNotFoundException

createSnapshot

public java.lang.Long createSnapshot(java.lang.Long pReleaseId)
                              throws FlexCheckedException

Create a Snapshot for a given Release. The Release must be in a 'Started' state before a snapshot can be created.

Parameters:

pReleaseId - Release to create the snapshot for

Returns:

Snapshot id

Throws:

FlexCheckedException

findStreamId

public java.lang.Long findStreamId(java.lang.Long pProjectId,
                                   java.lang.String pStreamName)
                            throws FlexCheckedException,
                                   FlexNotFoundException

Finds a FlexDeploy stream id from the Stream name.

Parameters:

pProjectId - Project id on which the stream belongs.

pStreamName - Name of the stream. e.g. 'feature/JIRA-12', 'master'.

Returns:

Stream id

Throws:

FlexNotFoundException - If stream name is not found on the project.

FlexCheckedException - All other exceptions

createStream

public java.lang.Long createStream(java.lang.Long pProjectId,
                                   java.lang.String pStreamName,
                                   java.lang.String pVersionSyntax)
                            throws FlexCheckedException

Create a FlexDeploy Stream on a given project. Allows custom setting of the version syntax. Useful for when a branch is created in source control.

Parameters:

pProjectId - Project to create the stream on.

pStreamName - Stream name to create

pVersionSyntax - Version Syntax to use for the stream. For example: "1.0.mybranch." + SequenceNumber. Note that this is a groovy script and literal strings should be enclosed in quotes.

Returns:

Stream id

Throws:

FlexCheckedException

Since:

5.3.0.1

createStream

public java.lang.Long createStream(java.lang.Long pProjectId,
                                   java.lang.String pStreamName)
                            throws FlexCheckedException

Create a FlexDeploy Stream on a given project. The stream version syntax will default to 1.0.x.n where x is the stream name and n is the incrementing version. Useful for when a branch is created in source control.

Parameters:

pProjectId - Project to create the stream on.

pStreamName - Stream name to create

Returns:

Stream id

Throws:

FlexCheckedException

inactivateStream

public void inactivateStream(java.lang.Long pProjectId,
                             java.lang.String pStreamName)
                      throws FlexCheckedException

Inactive a FlexDeploy Stream on a project. Useful for when a branch is deleted from source control.

Parameters:

pProjectId - Project id for which the stream belongs.

pStreamName - Stream name to inactivate.

Throws:

FlexCheckedException

approveTask

public void approveTask(java.lang.String pUsername,
                        java.lang.Long pTaskId,
                        java.lang.String pNotes)
                 throws FlexCheckedException,
                        FlexNotFoundException

Approve a FlexDeploy Task. Approval, scheduled or human tasks are all compatible. When using this function the execution will run as the username that is passed. Due to this, precaution should be taken to be sure that only relevant users have access to edit the use of this method.

Parameters:

pUsername - Username to approve the task as, the user passed here needs permission to approve otherwise an error will occur. User must be in local realm.

pTaskId - Task id to approve.

pNotes - Optional notes to assign to the approval.

Throws:

FlexNotFoundException - If no task found for passed id

FlexCheckedException - All other exceptions

rejectTask

public void rejectTask(java.lang.String pUsername,
                       java.lang.Long pTaskId,
                       java.lang.String pNotes)
                throws FlexCheckedException,
                       FlexNotFoundException

Reject a FlexDeploy Task. Approval, scheduled or human tasks are all compatible. When using this function the execution will run as the username that is passed. Due to this, precaution should be taken to be sure that only relevant users have access to edit the use of this method.

Parameters:

pUsername - Username to reject the task as, the user passed here needs permission to reject otherwise an error will occur. User must be in local realm.

pTaskId - Task id to reject.

pNotes - Optional notes to assign to the rejected task.

Throws:

FlexNotFoundException - If no task found for passed id

FlexCheckedException - All other exceptions

getGroovyKey

public java.lang.String getGroovyKey()