com.atlassian.jira.workflow

Class OSWorkflowManager

java.lang.Object

com.atlassian.jira.workflow.OSWorkflowManager

All Implemented Interfaces:

WorkflowManager

public class OSWorkflowManager
extends Object
implements WorkflowManager

Constructor Summary

Constructors

Constructor and Description
OSWorkflowManager(com.opensymphony.workflow.config.Configuration configuration, DraftWorkflowStore draftWorkflowStore, com.atlassian.event.api.EventPublisher eventPublisher, WorkflowsRepository workflowsRepository, WorkflowCopyNameFactory workflowCopyNameFactory, JiraAuthenticationContext context, IssueTextFieldCharacterLengthValidator textFieldCharacterLengthValidator)

Method Summary

Modifier and Type	Method and Description
void	copyAndDeleteDraftsForInactiveWorkflowsIn(ApplicationUser user, Iterable<JiraWorkflow> workflows) Provided a set of workflows, this method will check, if the passed in inactive workflows have any drafts linked to them.
void	copyAndDeleteDraftWorkflows(ApplicationUser user, Set<JiraWorkflow> workflows) Provided a set of workflows, this method will check, if the passed in inactive workflows have any drafts linked to them.
JiraWorkflow	copyWorkflow(ApplicationUser user, String clonedWorkflowName, String clonedWorkflowDescription, JiraWorkflow workflowToClone) Clones a workflow by creating a deep copy of the workflow provided.
JiraWorkflow	copyWorkflow(String username, String clonedWorkflowName, String clonedWorkflowDescription, JiraWorkflow workflowToClone) Clones a workflow by creating a deep copy of the workflow provided.
JiraWorkflow	createDraftWorkflow(ApplicationUser user, String parentWorkflowName) This will create an draft workflow of the named active workflow.
JiraWorkflow	createDraftWorkflow(String username, String parentWorkflowName) This will create an draft workflow of the named active workflow.
org.ofbiz.core.entity.GenericValue	createIssue(String remoteUserName, Map<String,Object> fields) Create an issue in the database.
void	createWorkflow(ApplicationUser user, JiraWorkflow workflow)
void	createWorkflow(String username, JiraWorkflow workflow)
boolean	deleteDraftWorkflow(String parentWorkflowName) Deletes all draft workflows (there should every be only one) for a given parent workflow.
void	deleteWorkflow(JiraWorkflow workflow)
void	doWorkflowAction(WorkflowProgressAware from)
com.opensymphony.workflow.loader.ActionDescriptor	getActionDescriptor(Issue issue, int actionId) Given an issue and the identifier if a workflow action, returns the ActionDescriptor associated.
com.opensymphony.workflow.loader.ActionDescriptor	getActionDescriptor(WorkflowProgressAware workflowProgressAware)
Collection<JiraWorkflow>	getActiveWorkflows() Retrieve all currently active workflows.
protected com.opensymphony.workflow.config.Configuration	getConfiguration()
JiraWorkflow	getDefaultWorkflow()
JiraWorkflow	getDraftWorkflow(String parentWorkflowName) Retrieve a single draft workflow by name.
Optional<String>	getInitialStatusIdForIssue(Issue issue) Returns the initial status for the workflow the given issue belongs to.
String	getNextStatusIdForAction(Issue issue, int actionId) Given an issue and the identifier of a workflow action, returns the next status id for the issue if the action gets executed.
String	getNextStatusIdForAction(Issue issue, JiraWorkflow workflow, com.opensymphony.workflow.loader.ActionDescriptor actionDescriptor)
Map<com.opensymphony.workflow.loader.ActionDescriptor,Collection<com.opensymphony.workflow.loader.FunctionDescriptor>>	getPostFunctionsForWorkflow(JiraWorkflow workflow) Retrieve a map: actions -> post functions for a workflow.
String	getStepId(long actionDescriptorId, String workflowName) Gets the first stepId for the given action and workflow name.
com.opensymphony.workflow.spi.WorkflowStore	getStore() This is used for unit testing so we can return our own 'mock store' instead of the static StoreFactory.getPersistence(ctx);
JiraWorkflow	getWorkflow(org.ofbiz.core.entity.GenericValue issue) Retrieve the workflow for a given issue.
JiraWorkflow	getWorkflow(Issue issue) Retrieve the workflow for a given issue.
JiraWorkflow	getWorkflow(Long projectId, String issueTypeId) Retrieve the workflow for a given project - issue type pair.
JiraWorkflow	getWorkflow(String name) Retrieve a single workflow by name.
JiraWorkflow	getWorkflowClone(String name) This method returns a JiraWorkflow, that contains a WorkflowDescriptor that is mutable.
JiraWorkflow	getWorkflowFromScheme(org.ofbiz.core.entity.GenericValue scheme, String issueTypeId) Return the workflow in a particular scheme for a given issue type.
JiraWorkflow	getWorkflowFromScheme(WorkflowScheme scheme, String issueTypeId) Return the workflow in a particular scheme for a given issue type.
protected String	getWorkflowName(Long projectId, String issueType) This method returns the (unique) name of the workflow which should be used for the provided projectId and issueType
Collection<JiraWorkflow>	getWorkflows() Retrieve all of the workflows in the system
protected WorkflowSchemeManager	getWorkflowSchemeManager()
Collection<JiraWorkflow>	getWorkflowsFromScheme(org.ofbiz.core.entity.GenericValue scheme) Returns all workflows for a given scheme.
Iterable<JiraWorkflow>	getWorkflowsFromScheme(Scheme workflowScheme) Returns all workflows for a given scheme.
List<JiraWorkflow>	getWorkflowsIncludingDrafts() Retrieve all of the workflows in the system including drafts.
boolean	isActive(JiraWorkflow workflow) Determine whether or not a given workflow is active in the system.
boolean	isEditable(Issue issue)
boolean	isEditable(Issue issue, String nextStatusId) Checks if the issue will be editable in workflow step with given id.
boolean	isSystemWorkflow(JiraWorkflow workflow) Determine whether or not a given workflow is a system workflow.
com.opensymphony.workflow.Workflow	makeWorkflow(ApplicationUser user) Prepares Workflow object with given user as caller
com.opensymphony.workflow.Workflow	makeWorkflow(String userName) Prepares Workflow object with given username as caller
com.opensymphony.workflow.Workflow	makeWorkflowWithUserKey(String userKey)
com.opensymphony.workflow.Workflow	makeWorkflowWithUserName(String userName)
void	migrateIssueToWorkflow(org.ofbiz.core.entity.GenericValue issue, JiraWorkflow newWorkflow, org.ofbiz.core.entity.GenericValue newStatus) Migrates given issue to new workflow and sets new status on it.
void	migrateIssueToWorkflow(MutableIssue issue, JiraWorkflow newWorkflow, Status status) Migrates given issue to new workflow and sets new status on it.
boolean	migrateIssueToWorkflowNoReindex(org.ofbiz.core.entity.GenericValue issue, JiraWorkflow newWorkflow, org.ofbiz.core.entity.GenericValue newStatus) Migrates given issue to new workflow and sets new status on it.
void	overwriteActiveWorkflow(ApplicationUser user, String workflowName) Saves the draft workflow into the active workflow.
void	overwriteActiveWorkflow(String username, String workflowName) Saves the draft workflow into the active workflow.
void	removeWorkflowEntries(org.ofbiz.core.entity.GenericValue issue)
void	replaceConditionInTransition(com.opensymphony.workflow.loader.ActionDescriptor transition, Map<String,String> matchMap, Map<String,String> newMap) Changes the parameter map of all conditions that have the parameter map matching matchMap by adding all properties from newMap.
void	saveWorkflowWithoutAudit(JiraWorkflow workflow) This method will save the workflow and it will not affect the updatedDate and updatedAuthorName meta attributes of the workflow.
protected boolean	updateIssueStatusAndUpdatedDate(org.ofbiz.core.entity.GenericValue issue, org.ofbiz.core.entity.GenericValue newStatus)
void	updateWorkflow(ApplicationUser user, JiraWorkflow workflow) Saves the given JiraWorkflow, which may be either a "live" or "draft" version.
void	updateWorkflow(String username, JiraWorkflow workflow) Saves the given JiraWorkflow, which may be either a "live" or "draft" version.
void	updateWorkflowNameAndDescription(ApplicationUser user, JiraWorkflow currentWorkflow, String newName, String newDescription) Used to change the name and description of an existing worfklow with the given name.
void	updateWorkflowNameAndDescription(String username, JiraWorkflow currentWorkflow, String newName, String newDescription) Used to change the name and description of an existing worfklow with the given name.
boolean	workflowExists(String name)

Methods inherited from class java.lang.Object

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

Constructor Detail

OSWorkflowManager

public OSWorkflowManager(com.opensymphony.workflow.config.Configuration configuration,
                         DraftWorkflowStore draftWorkflowStore,
                         com.atlassian.event.api.EventPublisher eventPublisher,
                         WorkflowsRepository workflowsRepository,
                         WorkflowCopyNameFactory workflowCopyNameFactory,
                         JiraAuthenticationContext context,
                         IssueTextFieldCharacterLengthValidator textFieldCharacterLengthValidator)

Method Detail

getWorkflows

public Collection<JiraWorkflow> getWorkflows()

Retrieve all of the workflows in the system

Specified by:

getWorkflows in interface WorkflowManager

Returns:

A collection of JiraWorkflow objects.

getWorkflowsIncludingDrafts

public List<JiraWorkflow> getWorkflowsIncludingDrafts()

Description copied from interface: WorkflowManager

Retrieve all of the workflows in the system including drafts. We return a list as we want to keep workflows and associated drafts are adjacent.

Specified by:

getWorkflowsIncludingDrafts in interface WorkflowManager

Returns:

A List of JiraWorkflow objects.

getWorkflowName

protected String getWorkflowName(Long projectId,
                                 String issueType)

This method returns the (unique) name of the workflow which should be used for the provided projectId and issueType

Returns:

the name of the workflow that should be used for the issue

getActiveWorkflows

public Collection<JiraWorkflow> getActiveWorkflows()
                                            throws WorkflowException

Description copied from interface: WorkflowManager

Retrieve all currently active workflows.

Specified by:

getActiveWorkflows in interface WorkflowManager

Returns:

Collection of JiraWorkflow objects.

Throws:

WorkflowException - RuntimeException wrapper for any errors.

isActive

public boolean isActive(JiraWorkflow workflow)
                 throws WorkflowException

Description copied from interface: WorkflowManager

Determine whether or not a given workflow is active in the system.

Active workflows are those currently assigned to schemes and associated with projects - they cannot be edited but can be used.

Specified by:

isActive in interface WorkflowManager

Parameters:

workflow - the JiraWorkflow to check

Returns:

true if the given workflow is active

Throws:

WorkflowException - RuntimeException wrapper for any errors.

isSystemWorkflow

public boolean isSystemWorkflow(JiraWorkflow workflow)

Description copied from interface: WorkflowManager

Determine whether or not a given workflow is a system workflow.

Check for a system or XML based workflow - can not be edited.

Specified by:

isSystemWorkflow in interface WorkflowManager

Parameters:

workflow - the JiraWorkflow to check

Returns:

true if the given workflow is a system workflow

getWorkflow

public JiraWorkflow getWorkflow(String name)

Description copied from interface: WorkflowManager

Retrieve a single workflow by name. The returned JiraWorkflow contains a descriptor that by default isn't mutable.

If you need to edit a workflow, please see WorkflowManager.getWorkflowClone(String).

Specified by:

getWorkflow in interface WorkflowManager

Parameters:

name - The workflow name

Returns:

A JiraWorkflow that wraps an Immutable WorkflowDescriptor or null

See Also:

WorkflowManager.getWorkflowClone(String)

getWorkflowClone

public JiraWorkflow getWorkflowClone(String name)

Description copied from interface: WorkflowManager

This method returns a JiraWorkflow, that contains a WorkflowDescriptor that is mutable. This method should be called, if you require to edit the workflow.

If you only need to view a workflow, please use WorkflowManager.getWorkflow(String) as it will provide better performance. Cloning a workflow is expensive, as it requires de-constructing and re-constructing the underlying WorkflowDescriptor from XML.

Specified by:

getWorkflowClone in interface WorkflowManager

Parameters:

name - The workflow name

Returns:

A JiraWorkflow or null if it doesn't exist.

See Also:

WorkflowManager.getWorkflow(String)

getDraftWorkflow

public JiraWorkflow getDraftWorkflow(String parentWorkflowName)
                              throws IllegalArgumentException

Description copied from interface: WorkflowManager

Retrieve a single draft workflow by name. If there is not an draft workflow associated with the name this will return null.

Specified by:

getDraftWorkflow in interface WorkflowManager

Parameters:

parentWorkflowName - is the name of the Saved workflow which identifies then paritally edited draft workflow to retrieve.

Returns:

a JiraWorkflow that represents an draft edited workflow.

Throws:

IllegalArgumentException - if no parentWorkflow with the name provided can be found.

createDraftWorkflow

public JiraWorkflow createDraftWorkflow(String username,
                                        String parentWorkflowName)

Description copied from interface: WorkflowManager

This will create an draft workflow of the named active workflow. This draft workflow can be used to edit active workflows without overwriting the active workflow immediately.
This method will not allow you to create an draft workflow if the parent workflow is not active, the method will throw an IllegalStateException in this case.

Specified by:

createDraftWorkflow in interface WorkflowManager

Parameters:

username - identifies the user performing the action so that we can keep an audit trail of who has last saved the workflow. Empty string for anonymous user. If null an IllegalArgumentException will be thrown

parentWorkflowName - identifies the parent workflow that should be used as the template for creating the draft workflow.

Returns:

An instance of JiraWorkflow that represents a copy of the parent that can be edited without overwriting the active workflow immediately.

createDraftWorkflow

public JiraWorkflow createDraftWorkflow(ApplicationUser user,
                                        String parentWorkflowName)

Description copied from interface: WorkflowManager

This will create an draft workflow of the named active workflow. This draft workflow can be used to edit active workflows without overwriting the active workflow immediately.
This method will not allow you to create an draft workflow if the parent workflow is not active, the method will throw an IllegalStateException in this case.

Specified by:

createDraftWorkflow in interface WorkflowManager

Parameters:

user - identifies the user performing the action so that we can keep an audit trail of who has last saved the workflow. Empty string for anonymous user. If null an IllegalArgumentException will be thrown

parentWorkflowName - identifies the parent workflow that should be used as the template for creating the draft workflow.

Returns:

An instance of JiraWorkflow that represents a copy of the parent that can be edited without overwriting the active workflow immediately.

deleteDraftWorkflow

public boolean deleteDraftWorkflow(String parentWorkflowName)
                            throws IllegalArgumentException

Description copied from interface: WorkflowManager

Deletes all draft workflows (there should every be only one) for a given parent workflow.

Specified by:

deleteDraftWorkflow in interface WorkflowManager

Parameters:

parentWorkflowName - The parentworkflow for which the draft workflow needs to be deleted.

Returns:

true if a draft workflow as deleted, false otherwise.

Throws:

IllegalArgumentException - if the parentWorkflowName is null

workflowExists

public boolean workflowExists(String name)
                       throws WorkflowException

Specified by:

workflowExists in interface WorkflowManager

Throws:

WorkflowException

getWorkflow

public JiraWorkflow getWorkflow(Issue issue)
                         throws WorkflowException

Description copied from interface: WorkflowManager

Retrieve the workflow for a given issue.

Specified by:

getWorkflow in interface WorkflowManager

Parameters:

issue - the Issue

Returns:

the workflow for the given issue.

Throws:

WorkflowException - RuntimeException wrapper for any errors.

getWorkflow

public JiraWorkflow getWorkflow(Long projectId,
                                String issueTypeId)
                         throws WorkflowException

Description copied from interface: WorkflowManager

Retrieve the workflow for a given project - issue type pair.

Specified by:

getWorkflow in interface WorkflowManager

Parameters:

projectId - the Project

issueTypeId - the IssueType ID

Returns:

the workflow for the given project - issue type pair.

Throws:

WorkflowException - RuntimeException wrapper for any errors.

getWorkflowFromScheme

public JiraWorkflow getWorkflowFromScheme(org.ofbiz.core.entity.GenericValue scheme,
                                          String issueTypeId)

Description copied from interface: WorkflowManager

Return the workflow in a particular scheme for a given issue type.

Specified by:

getWorkflowFromScheme in interface WorkflowManager

Parameters:

scheme - the Scheme

issueTypeId - the IssueType ID

Returns:

the workflow for the issue type in the scheme.

getWorkflowFromScheme

public JiraWorkflow getWorkflowFromScheme(WorkflowScheme scheme,
                                          String issueTypeId)

Description copied from interface: WorkflowManager

Return the workflow in a particular scheme for a given issue type.

Specified by:

getWorkflowFromScheme in interface WorkflowManager

Parameters:

scheme - the Scheme

issueTypeId - the IssueType ID

Returns:

the workflow for the issue type in the scheme.

getWorkflowsFromScheme

public Collection<JiraWorkflow> getWorkflowsFromScheme(org.ofbiz.core.entity.GenericValue scheme)
                                                throws WorkflowException

Description copied from interface: WorkflowManager

Returns all workflows for a given scheme.

Specified by:

getWorkflowsFromScheme in interface WorkflowManager

Parameters:

scheme - the Workflow Scheme.

Returns:

Collection of workflow schemes, empty collection if none exists.

Throws:

WorkflowException - RuntimeException wrapper for any errors.

getWorkflowsFromScheme

public Iterable<JiraWorkflow> getWorkflowsFromScheme(Scheme workflowScheme)
                                              throws WorkflowException

Description copied from interface: WorkflowManager

Returns all workflows for a given scheme.

Specified by:

getWorkflowsFromScheme in interface WorkflowManager

Parameters:

workflowScheme - the Workflow Scheme.

Returns:

Collection of workflow schemes, empty collection if none exists.

Throws:

WorkflowException - RuntimeException wrapper for any errors.

copyAndDeleteDraftWorkflows

public void copyAndDeleteDraftWorkflows(ApplicationUser user,
                                        Set<JiraWorkflow> workflows)

Description copied from interface: WorkflowManager

Provided a set of workflows, this method will check, if the passed in inactive workflows have any drafts linked to them. If they do, it will copy the draft into a new inactive workflow, and then delete the draft.

Specified by:

copyAndDeleteDraftWorkflows in interface WorkflowManager

Parameters:

user - The user performing the operation

workflows - A set of parent JiraWorkflows

copyAndDeleteDraftsForInactiveWorkflowsIn

public void copyAndDeleteDraftsForInactiveWorkflowsIn(ApplicationUser user,
                                                      Iterable<JiraWorkflow> workflows)

Description copied from interface: WorkflowManager

Provided a set of workflows, this method will check, if the passed in inactive workflows have any drafts linked to them. If they do, it will copy the draft into a new inactive workflow, and then delete the draft.

This method is only meant to be used internally in JIRA. External developers should not call this method directly.

Specified by:

copyAndDeleteDraftsForInactiveWorkflowsIn in interface WorkflowManager

Parameters:

user - The user performing the operation

workflows - A set of parent JiraWorkflows

getNextStatusIdForAction

@Nonnull
public String getNextStatusIdForAction(@Nonnull
                                                Issue issue,
                                                int actionId)

Description copied from interface: WorkflowManager

Given an issue and the identifier of a workflow action, returns the next status id for the issue if the action gets executed.

Specified by:

getNextStatusIdForAction in interface WorkflowManager

Parameters:

issue - The issue

actionId - The identifier of a workflow action

Returns:

The status id corresponding to the next status of the issue if the action got executed

getNextStatusIdForAction

@Nonnull
public String getNextStatusIdForAction(@Nonnull
                                                Issue issue,
                                                @Nonnull
                                                JiraWorkflow workflow,
                                                @Nonnull
                                                com.opensymphony.workflow.loader.ActionDescriptor actionDescriptor)

getInitialStatusIdForIssue

@Nonnull
public Optional<String> getInitialStatusIdForIssue(@Nonnull
                                                            Issue issue)

Description copied from interface: WorkflowManager

Returns the initial status for the workflow the given issue belongs to.

Specified by:

getInitialStatusIdForIssue in interface WorkflowManager

Parameters:

issue - the issue in workflow for which the initial status should be returned

Returns:

initial status id in the workflow

getActionDescriptor

@Nonnull
public com.opensymphony.workflow.loader.ActionDescriptor getActionDescriptor(@Nonnull
                                                                                      Issue issue,
                                                                                      int actionId)

Description copied from interface: WorkflowManager

Given an issue and the identifier if a workflow action, returns the ActionDescriptor associated.

Specified by:

getActionDescriptor in interface WorkflowManager

Parameters:

issue - The issue.

actionId - The identifier of a workflow action.

Returns:

The ActionDescriptor corresponding to the workflow action id for the given issue.

createWorkflow

public void createWorkflow(String username,
                           JiraWorkflow workflow)
                    throws WorkflowException

Specified by:

createWorkflow in interface WorkflowManager

Throws:

WorkflowException

createWorkflow

public void createWorkflow(ApplicationUser user,
                           JiraWorkflow workflow)
                    throws WorkflowException

Specified by:

createWorkflow in interface WorkflowManager

Throws:

WorkflowException

saveWorkflowWithoutAudit

public void saveWorkflowWithoutAudit(JiraWorkflow workflow)
                              throws WorkflowException

Description copied from interface: WorkflowManager

This method will save the workflow and it will not affect the updatedDate and updatedAuthorName meta attributes of the workflow. This should only ever be invoked by system operations such as upgrade tasks. All other saves should use the method WorkflowManager.updateWorkflow(String, JiraWorkflow)

Specified by:

saveWorkflowWithoutAudit in interface WorkflowManager

Parameters:

workflow - the workflow to save.

Throws:

WorkflowException - RuntimeException wrapper for any errors.

getWorkflowSchemeManager

protected WorkflowSchemeManager getWorkflowSchemeManager()

deleteWorkflow

public void deleteWorkflow(JiraWorkflow workflow)
                    throws WorkflowException

Specified by:

deleteWorkflow in interface WorkflowManager

Throws:

WorkflowException

getWorkflow

public JiraWorkflow getWorkflow(org.ofbiz.core.entity.GenericValue issue)
                         throws WorkflowException

Description copied from interface: WorkflowManager

Retrieve the workflow for a given issue.

Specified by:

getWorkflow in interface WorkflowManager

Parameters:

issue - the Issue

Returns:

the workflow for the given issue.

Throws:

WorkflowException - RuntimeException wrapper for any errors.

migrateIssueToWorkflow

public void migrateIssueToWorkflow(org.ofbiz.core.entity.GenericValue issue,
                                   JiraWorkflow newWorkflow,
                                   org.ofbiz.core.entity.GenericValue newStatus)
                            throws WorkflowException

Description copied from interface: WorkflowManager

Migrates given issue to new workflow and sets new status on it.

Specified by:

migrateIssueToWorkflow in interface WorkflowManager

Parameters:

issue - issue to migrate

newWorkflow - new workflow

newStatus - new status

Throws:

WorkflowException - if migration fails

migrateIssueToWorkflowNoReindex

public boolean migrateIssueToWorkflowNoReindex(org.ofbiz.core.entity.GenericValue issue,
                                               JiraWorkflow newWorkflow,
                                               org.ofbiz.core.entity.GenericValue newStatus)
                                        throws WorkflowException

Description copied from interface: WorkflowManager

Migrates given issue to new workflow and sets new status on it. It returns true iff the issue that was migrated needs a reindex. The passed issue is not reindexed even if necessary.

Specified by:

migrateIssueToWorkflowNoReindex in interface WorkflowManager

Parameters:

issue - issue to migrate

newWorkflow - new workflow

newStatus - new status

Returns:

true if the issue

Throws:

WorkflowException - if migration fails

overwriteActiveWorkflow

public void overwriteActiveWorkflow(String username,
                                    String workflowName)

Description copied from interface: WorkflowManager

Saves the draft workflow into the active workflow.

Specified by:

overwriteActiveWorkflow in interface WorkflowManager

Parameters:

username - User will be added to the workflows Audit trail

workflowName - The workflow to be overwritten

overwriteActiveWorkflow

public void overwriteActiveWorkflow(ApplicationUser user,
                                    String workflowName)

Description copied from interface: WorkflowManager

Saves the draft workflow into the active workflow.

Specified by:

overwriteActiveWorkflow in interface WorkflowManager

Parameters:

user - User will be added to the workflows Audit trail

workflowName - The workflow to be overwritten

updateIssueStatusAndUpdatedDate

protected boolean updateIssueStatusAndUpdatedDate(org.ofbiz.core.entity.GenericValue issue,
                                                  org.ofbiz.core.entity.GenericValue newStatus)

updateWorkflow

public void updateWorkflow(String username,
                           JiraWorkflow workflow)

Description copied from interface: WorkflowManager

Saves the given JiraWorkflow, which may be either a "live" or "draft" version. This method does not save the changes to the active workflow. Instead, this is meant to be used to make persistent changes to your working edit. Once all changes have been made you can over write the active workflow by calling WorkflowManager.overwriteActiveWorkflow(String, String)

Specified by:

updateWorkflow in interface WorkflowManager

Parameters:

username - User making the request.

workflow - The JiraWorkflow to save.

updateWorkflow

public void updateWorkflow(ApplicationUser user,
                           JiraWorkflow workflow)

Description copied from interface: WorkflowManager

Saves the given JiraWorkflow, which may be either a "live" or "draft" version. This method does not save the changes to the active workflow. Instead, this is meant to be used to make persistent changes to your working edit. Once all changes have been made you can over write the active workflow by calling WorkflowManager.overwriteActiveWorkflow(ApplicationUser, String)

Specified by:

updateWorkflow in interface WorkflowManager

Parameters:

user - User making the request.

workflow - The JiraWorkflow to save.

copyWorkflow

public JiraWorkflow copyWorkflow(String username,
                                 String clonedWorkflowName,
                                 String clonedWorkflowDescription,
                                 JiraWorkflow workflowToClone)

Description copied from interface: WorkflowManager

Clones a workflow by creating a deep copy of the workflow provided.

Specified by:

copyWorkflow in interface WorkflowManager

Parameters:

username - The user performing the operation

clonedWorkflowName - The name to store the new workflow with.

clonedWorkflowDescription - The description to store with the cloned workflow. Can be null.

workflowToClone - The workflow to copy.

Returns:

A cloned copy of the original workflow.

copyWorkflow

public JiraWorkflow copyWorkflow(ApplicationUser user,
                                 String clonedWorkflowName,
                                 String clonedWorkflowDescription,
                                 JiraWorkflow workflowToClone)

Description copied from interface: WorkflowManager

Clones a workflow by creating a deep copy of the workflow provided.

Specified by:

copyWorkflow in interface WorkflowManager

Parameters:

user - The user performing the operation

clonedWorkflowName - The name to store the new workflow with.

clonedWorkflowDescription - The description to store with the cloned workflow. Can be null.

workflowToClone - The workflow to copy.

Returns:

A cloned copy of the original workflow.

updateWorkflowNameAndDescription

public void updateWorkflowNameAndDescription(String username,
                                             JiraWorkflow currentWorkflow,
                                             String newName,
                                             String newDescription)

Description copied from interface: WorkflowManager

Used to change the name and description of an existing worfklow with the given name.

Specified by:

updateWorkflowNameAndDescription in interface WorkflowManager

Parameters:

username - The user performing the operation

currentWorkflow - The workflow to update.

newName - The new name to save with the workflow

newDescription - The new description to save with the workflow

updateWorkflowNameAndDescription

public void updateWorkflowNameAndDescription(ApplicationUser user,
                                             JiraWorkflow currentWorkflow,
                                             String newName,
                                             String newDescription)

Description copied from interface: WorkflowManager

Used to change the name and description of an existing worfklow with the given name.

Specified by:

updateWorkflowNameAndDescription in interface WorkflowManager

Parameters:

user - The user performing the operation

currentWorkflow - The workflow to update.

newName - The new name to save with the workflow

newDescription - The new description to save with the workflow

getDefaultWorkflow

public JiraWorkflow getDefaultWorkflow()
                                throws WorkflowException

Specified by:

getDefaultWorkflow in interface WorkflowManager

Throws:

WorkflowException

createIssue

public org.ofbiz.core.entity.GenericValue createIssue(String remoteUserName,
                                                      Map<String,Object> fields)
                                               throws WorkflowException

Description copied from interface: WorkflowManager

Create an issue in the database.

Specified by:

createIssue in interface WorkflowManager

Parameters:

remoteUserName - Issue creator

fields - Map of fields. The key is the name of the field, and the type of the value depends on the key. Must include a key "issue", which contains MutableIssue object (holding values, not yet persisted to disk). May include other fields (eg "pkey"->String key of project, "originalissueobject"->Issue object) passed onto the workflow engine.

Returns:

The created issue GenericValue

Throws:

WorkflowException - If any errors occur while trying to create the issue.

removeWorkflowEntries

public void removeWorkflowEntries(org.ofbiz.core.entity.GenericValue issue)

Specified by:

removeWorkflowEntries in interface WorkflowManager

doWorkflowAction

public void doWorkflowAction(WorkflowProgressAware from)

Specified by:

doWorkflowAction in interface WorkflowManager

getStore

public com.opensymphony.workflow.spi.WorkflowStore getStore()
                                                     throws com.opensymphony.workflow.StoreException

This is used for unit testing so we can return our own 'mock store' instead of the static StoreFactory.getPersistence(ctx);

Also used in the migrateIssueToWorkflow method.

Specified by:

getStore in interface WorkflowManager

Throws:

com.opensymphony.workflow.StoreException

getActionDescriptor

public com.opensymphony.workflow.loader.ActionDescriptor getActionDescriptor(WorkflowProgressAware workflowProgressAware)
                                                                      throws Exception

Specified by:

getActionDescriptor in interface WorkflowManager

Throws:

Exception

migrateIssueToWorkflow

public void migrateIssueToWorkflow(MutableIssue issue,
                                   JiraWorkflow newWorkflow,
                                   Status status)
                            throws WorkflowException

Migrates given issue to new workflow and sets new status on it.

Specified by:

migrateIssueToWorkflow in interface WorkflowManager

Parameters:

issue - issue to migrate

newWorkflow - new workflow

status - new status

Throws:

WorkflowException - if migration fails

makeWorkflow

public com.opensymphony.workflow.Workflow makeWorkflow(String userName)

Description copied from interface: WorkflowManager

Prepares Workflow object with given username as caller

Specified by:

makeWorkflow in interface WorkflowManager

Parameters:

userName - caller username

Returns:

created Workflow

makeWorkflowWithUserName

public com.opensymphony.workflow.Workflow makeWorkflowWithUserName(String userName)

Specified by:

makeWorkflowWithUserName in interface WorkflowManager

makeWorkflowWithUserKey

public com.opensymphony.workflow.Workflow makeWorkflowWithUserKey(String userKey)

Specified by:

makeWorkflowWithUserKey in interface WorkflowManager

makeWorkflow

public com.opensymphony.workflow.Workflow makeWorkflow(ApplicationUser user)

Description copied from interface: WorkflowManager

Prepares Workflow object with given user as caller

Specified by:

makeWorkflow in interface WorkflowManager

Parameters:

user - caller

Returns:

created Workflow

isEditable

public boolean isEditable(Issue issue)

Specified by:

isEditable in interface WorkflowManager

isEditable

public boolean isEditable(@Nonnull
                          Issue issue,
                          @Nonnull
                          String nextStatusId)

Description copied from interface: WorkflowManager

Checks if the issue will be editable in workflow step with given id.

Specified by:

isEditable in interface WorkflowManager

Parameters:

issue - the issue which is affected by the workflow action

nextStatusId - the workflow status that the issue will be in after transition

Returns:

a boolean value which indicates if the issue will be editable in step with given id

getConfiguration

protected com.opensymphony.workflow.config.Configuration getConfiguration()

getPostFunctionsForWorkflow

public Map<com.opensymphony.workflow.loader.ActionDescriptor,Collection<com.opensymphony.workflow.loader.FunctionDescriptor>> getPostFunctionsForWorkflow(JiraWorkflow workflow)

Description copied from interface: WorkflowManager

Retrieve a map: actions -> post functions for a workflow.

Specified by:

getPostFunctionsForWorkflow in interface WorkflowManager

Parameters:

workflow - The Workflow

Returns:

Map of actions-> post functions

getStepId

public String getStepId(long actionDescriptorId,
                        String workflowName)

Description copied from interface: WorkflowManager

Gets the first stepId for the given action and workflow name.

Specified by:

getStepId in interface WorkflowManager

Parameters:

actionDescriptorId - id of the ActionDescriptor

workflowName - name of the JiraWorkflow

Returns:

the first stepId for the given action and workflow name.

replaceConditionInTransition

public void replaceConditionInTransition(com.opensymphony.workflow.loader.ActionDescriptor transition,
                                         Map<String,String> matchMap,
                                         Map<String,String> newMap)

Description copied from interface: WorkflowManager

Changes the parameter map of all conditions that have the parameter map matching matchMap by adding all properties from newMap.

Specified by:

replaceConditionInTransition in interface WorkflowManager

Parameters:

transition - transition to change the conditions in

matchMap - the map used to determine if the condition should be modified

newMap - a map of properties to be added to the parameter map