org.bonitasoft.engine.core.process.definition

Interface ProcessDefinitionService

All Known Implementing Classes:

ProcessDefinitionServiceImpl

public interface ProcessDefinitionService

Since:

6.0

Author:

Matthieu Chaffotte, Yanyan Liu, Celine Souchet, Arthur Freycon

Field Summary

Fields

Modifier and Type	Field and Description
static String	GROUP_ID
static String	PROCESS_CACHE_NAME
static String	PROCESS_DEFINITION_ID
static String	PROCESSDEFINITION
static String	PROCESSDEFINITION_DEPLOY_INFO
static String	PROCESSDEFINITION_IS_DISABLED
static String	PROCESSDEFINITION_IS_ENABLED
static String	PROCESSDEFINITION_IS_RESOLVED
static String	PROCESSDEFINITION_IS_UNRESOLVED
static String	ROLE_ID
static String	STARTED_BY_SUFFIX
static String	UNCATEGORIZED_SUFFIX
static String	UNCATEGORIZED_SUPERVISED_BY_SUFFIX
static String	UNCATEGORIZED_USERCANSTART_SUFFIX
static String	USER_ID
static String	WHOCANSTART_PROCESS_SUFFIX

Method Summary

Methods

Modifier and Type	Method and Description
void	delete(long processId) Delete the id specified process definition and its deploy info
void	disableProcessDeploymentInfo(long processId) set the process as RESOLVED when it's in ENABLED state
void	enableProcessDeploymentInfo(long processId) Enable the specific process definition, set the process as ENABLED when it's in RESOLVED state
DesignProcessDefinition	getDesignProcessDefinition(long processDefinitionId) Returns a specific process definition that include informations such as tasks definition, actors...
long	getLatestProcessDefinitionId(String processName) Get the processDefinitionId of the most recent version of the process
SFlowNodeDefinition	getNextFlowNode(SProcessDefinition definition, String source) Get target flow node for the given source flow node in the specific process
long	getNumberOfProcessDeploymentInfos() Gets how many processes are defined.
long	getNumberOfProcessDeploymentInfos(long userId, org.bonitasoft.engine.persistence.QueryOptions countOptions, String querySuffix) Get total number of process definitions for the specific user who can perform the "querySuffix" specified action
long	getNumberOfProcessDeploymentInfos(org.bonitasoft.engine.persistence.QueryOptions countOptions) Get number of all process definition deploy infos according to the specific search criteria
long	getNumberOfProcessDeploymentInfosByActivationState(ActivationState activationState) Gets how many processes are in the given state.
long	getNumberOfProcessDeploymentInfosCanBeStartedBy(long userId, org.bonitasoft.engine.persistence.QueryOptions countOptions) Get number of all process definitions for the specific user who can start
long	getNumberOfProcessDeploymentInfosCanBeStartedByUsersManagedBy(long managerUserId, org.bonitasoft.engine.persistence.QueryOptions countOptions) Get number of all process definitions for the users managed by specific manager, or manager who can start
long	getNumberOfProcessDeploymentInfosStartedBy(long startedBy, org.bonitasoft.engine.persistence.QueryOptions countOptions) Get number of all process deploy info started by the specific user
Long	getNumberOfProcessDeploymentInfosUnrelatedToCategory(long categoryId) Get number of SProcessDefinitionDeployInfos unrelated to the specific category
long	getNumberOfProcessDeploymentInfosWithAssignedOrPendingHumanTasks(org.bonitasoft.engine.persistence.QueryOptions queryOptions) Get the total number of the process definitions that have instances with one or more human tasks assigned/pending.
long	getNumberOfProcessDeploymentInfosWithAssignedOrPendingHumanTasksFor(long userId, org.bonitasoft.engine.persistence.QueryOptions queryOptions) Get the total number of the process definitions that have one or more human tasks assigned/pending for a specific user.
long	getNumberOfProcessDeploymentInfosWithAssignedOrPendingHumanTasksSupervisedBy(long userId, org.bonitasoft.engine.persistence.QueryOptions queryOptions) Get the total number of the process definitions supervised by a specific user, that have instances with one or more human tasks assigned/pending.
long	getNumberOfUncategorizedProcessDeploymentInfos(org.bonitasoft.engine.persistence.QueryOptions countOptions) Get total number of uncategorized process definitions by given query criteria
long	getNumberOfUncategorizedProcessDeploymentInfosCanBeStartedBy(long userId, org.bonitasoft.engine.persistence.QueryOptions countOptions) Get total number of uncategorized process definitions for the specific user who can start
long	getNumberOfUncategorizedProcessDeploymentInfosSupervisedBy(long userId, org.bonitasoft.engine.persistence.QueryOptions countOptions) Get total number of uncategorized process definitions by given query criteria for specific supervisor
long	getNumberOfUsersWhoCanStartProcessDeploymentInfo(long processDefinitionId, org.bonitasoft.engine.persistence.QueryOptions queryOptions) Get total number of users according to specific query options, and who can start the given process definition
SProcessDefinition	getProcessDefinition(long processDefinitionId) Get processDefinition by its id
long	getProcessDefinitionId(String name, String version) Get the processDefinitionId by name and version
List<Long>	getProcessDefinitionIds(ActivationState activationState, int fromIndex, int numberOfResult) Get the process definition identifiers in the given state.
List<Long>	getProcessDefinitionIds(int fromIndex, int numberOfResult) Get the process definition identifiers.
SProcessDefinition	getProcessDefinitionIfIsEnabled(long processDefinitionId) Get processDefinition by its id, if it's enabled.
SProcessDefinitionDeployInfo	getProcessDeploymentInfo(long processId) Get deployment info of the process definition having the id given in parameter
List<SProcessDefinitionDeployInfo>	getProcessDeploymentInfos(int fromIndex, int numberPerPage, String field, org.bonitasoft.engine.persistence.OrderByType order) Get process definition deploy info in a specific interval with order, this can be used for pagination
List<SProcessDefinitionDeployInfo>	getProcessDeploymentInfos(List<Long> processIds)
List<SProcessDefinitionDeployInfo>	getProcessDeploymentInfos(List<Long> processIds, int fromIndex, int numberOfProcesses, String field, org.bonitasoft.engine.persistence.OrderByType order) get sub set of processDefinitionDeployInfos in specific order
List<SProcessDefinitionDeployInfo>	getProcessDeploymentInfos(org.bonitasoft.engine.persistence.QueryOptions queryOptions) Get process definition deploy info in a specific interval with order, this can be used for pagination
Map<Long,SProcessDefinitionDeployInfo>	getProcessDeploymentInfosFromArchivedProcessInstanceIds(List<Long> archivedProcessInstantsIds) Get A list of SProcessDefinitionDeployInfos for the specific archived processInstances
Map<Long,SProcessDefinitionDeployInfo>	getProcessDeploymentInfosFromProcessInstanceIds(List<Long> processInstanceIds) A list of SProcessDefinitionDeployInfos for the specific processInstances
List<SProcessDefinitionDeployInfo>	getProcessDeploymentInfosUnrelatedToCategory(long categoryId, int pageIndex, int numberPerPage, ProcessDeploymentInfoCriterion pagingCriterion) Get A list of SProcessDefinitionDeployInfos unrelated to the specific category
List<SProcessDefinitionDeployInfo>	getProcessDeploymentInfosWithActorOnlyForGroup(long groupId, org.bonitasoft.engine.persistence.QueryOptions queryOptions) List all processes that contain at least one task which actor is mapped only to the specified group.
List<SProcessDefinitionDeployInfo>	getProcessDeploymentInfosWithActorOnlyForGroups(List<Long> groupIds, org.bonitasoft.engine.persistence.QueryOptions queryOptions) List all processes that contain at least one task which actor is mapped only to the specified groups.
List<SProcessDefinitionDeployInfo>	getProcessDeploymentInfosWithActorOnlyForRole(long roleId, org.bonitasoft.engine.persistence.QueryOptions queryOptions) List all processes that contain at least one task which actor is mapped only to the specified role.
List<SProcessDefinitionDeployInfo>	getProcessDeploymentInfosWithActorOnlyForRoles(List<Long> roleIds, org.bonitasoft.engine.persistence.QueryOptions queryOptions) List all processes that contain at least one task which actor is mapped only to the specified roles.
List<SProcessDefinitionDeployInfo>	getProcessDeploymentInfosWithActorOnlyForUser(long userId, org.bonitasoft.engine.persistence.QueryOptions queryOptions) List all processes that contain at least one task which actor is mapped only to the specified user.
List<SProcessDefinitionDeployInfo>	getProcessDeploymentInfosWithActorOnlyForUsers(List<Long> userIds, org.bonitasoft.engine.persistence.QueryOptions queryOptions) List all processes that contain at least one task which actor is mapped only to the specified users.
void	resolveProcess(long processId) set the process as RESOLVED when it's in UNRESOLVED state
List<SProcessDefinitionDeployInfo>	searchProcessDeploymentInfos(long userId, org.bonitasoft.engine.persistence.QueryOptions searchOptions, String querySuffix) Search all process definitions for the specific user who can perform the "querySuffix" specified action
List<SProcessDefinitionDeployInfo>	searchProcessDeploymentInfos(org.bonitasoft.engine.persistence.QueryOptions searchOptions) Search all process definition deploy infos according to the specific search criteria
List<SProcessDefinitionDeployInfo>	searchProcessDeploymentInfosCanBeStartedBy(long userId, org.bonitasoft.engine.persistence.QueryOptions searchOptions) Search all process definitions for the specific user who can start
List<SProcessDefinitionDeployInfo>	searchProcessDeploymentInfosCanBeStartedByUsersManagedBy(long managerUserId, org.bonitasoft.engine.persistence.QueryOptions searchOptions) Search all process definitions for the users managed by specific manager, or manager who can start
List<SProcessDefinitionDeployInfo>	searchProcessDeploymentInfosOfCategory(long categoryId, org.bonitasoft.engine.persistence.QueryOptions queryOptions) Search all process definitions for a specific category.
List<SProcessDefinitionDeployInfo>	searchProcessDeploymentInfosStartedBy(long startedBy, org.bonitasoft.engine.persistence.QueryOptions searchOptions) Search all process deploy info started by the specific user
List<SProcessDefinitionDeployInfo>	searchProcessDeploymentInfosWithAssignedOrPendingHumanTasks(org.bonitasoft.engine.persistence.QueryOptions queryOptions) Search all process definitions that have instances with one or more human tasks assigned/pending.
List<SProcessDefinitionDeployInfo>	searchProcessDeploymentInfosWithAssignedOrPendingHumanTasksFor(long userId, org.bonitasoft.engine.persistence.QueryOptions queryOptions) Search all process definitions that have one or more human tasks assigned/pending for a specific user.
List<SProcessDefinitionDeployInfo>	searchProcessDeploymentInfosWithAssignedOrPendingHumanTasksSupervisedBy(long userId, org.bonitasoft.engine.persistence.QueryOptions queryOptions) Search all process definitions supervised by a specific user, that have instances with one or more human tasks assigned/pending.
List<SProcessDefinitionDeployInfo>	searchUncategorizedProcessDeploymentInfos(org.bonitasoft.engine.persistence.QueryOptions searchOptions) Search all uncategorized process definitions according to the search criteria.
List<SProcessDefinitionDeployInfo>	searchUncategorizedProcessDeploymentInfosCanBeStartedBy(long userId, org.bonitasoft.engine.persistence.QueryOptions searchOptions) Search all uncategorized process definitions for the specific user who can start
List<SProcessDefinitionDeployInfo>	searchUncategorizedProcessDeploymentInfosSupervisedBy(long userId, org.bonitasoft.engine.persistence.QueryOptions searchOptions) Search all uncategorized process definitions by given query criteria for specific supervisor
List<org.bonitasoft.engine.identity.model.SUser>	searchUsersWhoCanStartProcessDeploymentInfo(long processDefinitionId, org.bonitasoft.engine.persistence.QueryOptions queryOptions) Search users according to specific query options, and who can start the given process definition
SProcessDefinition	store(DesignProcessDefinition designProcessDefinition) Store the processDefinition to file system and its deploy info to DB.
void	updateExpressionContent(long processDefinitionId, long expressionDefinitionId, String content) Updates the content of an Expression, for a given process definition.
SProcessDefinitionDeployInfo	updateProcessDefinitionDeployInfo(long processId, org.bonitasoft.engine.recorder.model.EntityUpdateDescriptor descriptor) Update deployment info of the process definition having the id given in parameter

Field Detail

PROCESSDEFINITION

static final String PROCESSDEFINITION

See Also:

Constant Field Values

PROCESSDEFINITION_IS_ENABLED

static final String PROCESSDEFINITION_IS_ENABLED

See Also:

Constant Field Values

PROCESSDEFINITION_IS_DISABLED

static final String PROCESSDEFINITION_IS_DISABLED

See Also:

Constant Field Values

PROCESSDEFINITION_DEPLOY_INFO

static final String PROCESSDEFINITION_DEPLOY_INFO

See Also:

Constant Field Values

PROCESSDEFINITION_IS_RESOLVED

static final String PROCESSDEFINITION_IS_RESOLVED

See Also:

Constant Field Values

PROCESSDEFINITION_IS_UNRESOLVED

static final String PROCESSDEFINITION_IS_UNRESOLVED

See Also:

Constant Field Values

PROCESS_CACHE_NAME

static final String PROCESS_CACHE_NAME

See Also:

Constant Field Values

UNCATEGORIZED_SUFFIX

static final String UNCATEGORIZED_SUFFIX

See Also:

Constant Field Values

UNCATEGORIZED_SUPERVISED_BY_SUFFIX

static final String UNCATEGORIZED_SUPERVISED_BY_SUFFIX

See Also:

Constant Field Values

UNCATEGORIZED_USERCANSTART_SUFFIX

static final String UNCATEGORIZED_USERCANSTART_SUFFIX

See Also:

Constant Field Values

WHOCANSTART_PROCESS_SUFFIX

static final String WHOCANSTART_PROCESS_SUFFIX

See Also:

Constant Field Values

STARTED_BY_SUFFIX

static final String STARTED_BY_SUFFIX

See Also:

Constant Field Values

PROCESS_DEFINITION_ID

static final String PROCESS_DEFINITION_ID

See Also:

Constant Field Values

USER_ID

static final String USER_ID

See Also:

Constant Field Values

ROLE_ID

static final String ROLE_ID

See Also:

Constant Field Values

GROUP_ID

static final String GROUP_ID

See Also:

Constant Field Values

Method Detail

store

SProcessDefinition store(DesignProcessDefinition designProcessDefinition)
                         throws SProcessDefinitionException

Store the processDefinition to file system and its deploy info to DB.

Parameters:

designProcessDefinition - the processDefinition will be stored

Returns:

the definition will an id

Throws:

SProcessDefinitionException

getProcessDefinition

SProcessDefinition getProcessDefinition(long processDefinitionId)
                                        throws SProcessDefinitionNotFoundException,
                                               org.bonitasoft.engine.persistence.SBonitaReadException

Get processDefinition by its id

Parameters:

processDefinitionId - identifier of processDefinition

Returns:

the processDefinition corresponding to the parameter processId

Throws:

SProcessDefinitionNotFoundException - error thrown if no process definition found

org.bonitasoft.engine.persistence.SBonitaReadException

getProcessDefinitionIfIsEnabled

SProcessDefinition getProcessDefinitionIfIsEnabled(long processDefinitionId)
                                                   throws org.bonitasoft.engine.persistence.SBonitaReadException,
                                                          SProcessDefinitionException

Get processDefinition by its id, if it's enabled.

Parameters:

processDefinitionId - The identifier of processDefinition

Returns:

The processDefinition corresponding to the parameter processId

Throws:

org.bonitasoft.engine.persistence.SBonitaReadException

SProcessDefinitionException

Since:

6.4.0

getProcessDeploymentInfo

SProcessDefinitionDeployInfo getProcessDeploymentInfo(long processId)
                                                      throws SProcessDefinitionNotFoundException,
                                                             org.bonitasoft.engine.persistence.SBonitaReadException

Get deployment info of the process definition having the id given in parameter

Parameters:

processId - id of the process definition on which we want deployment information

Returns:

an SProcessDefinitionDeployInfo object to the process definition

Throws:

SProcessDefinitionNotFoundException - error thrown if no process definition found

org.bonitasoft.engine.persistence.SBonitaReadException

delete

void delete(long processId)
            throws SProcessDefinitionNotFoundException,
                   SProcessDeletionException,
                   SDeletingEnabledProcessException

Delete the id specified process definition and its deploy info

Parameters:

processId - identifier of processDefinition

Throws:

SProcessDefinitionNotFoundException - error thrown if no process definition found

SProcessDeletionException

SDeletingEnabledProcessException - error throw if the process still enabled

getProcessDeploymentInfos

List<SProcessDefinitionDeployInfo> getProcessDeploymentInfos(int fromIndex,
                                                           int numberPerPage,
                                                           String field,
                                                           org.bonitasoft.engine.persistence.OrderByType order)
                                                             throws org.bonitasoft.engine.persistence.SBonitaReadException

Get process definition deploy info in a specific interval with order, this can be used for pagination

Parameters:

fromIndex - Index of the record to be retrieved from. First record has index 0

numberPerPage - Number of result we want to get. Maximum number of result returned

field - the field user to do order

order - ASC or DESC

Returns:

a list of SProcessDefinitionDeployInfo object

Throws:

org.bonitasoft.engine.persistence.SBonitaReadException

enableProcessDeploymentInfo

void enableProcessDeploymentInfo(long processId)
                                 throws SProcessDefinitionNotFoundException,
                                        SProcessEnablementException

Enable the specific process definition, set the process as ENABLED when it's in RESOLVED state

Parameters:

processId - identifier of processDefinition

Throws:

SProcessDefinitionNotFoundException - error thrown if no process definition found for the given processId

SProcessEnablementException

disableProcessDeploymentInfo

void disableProcessDeploymentInfo(long processId)
                                  throws SProcessDefinitionNotFoundException,
                                         SProcessDisablementException

set the process as RESOLVED when it's in ENABLED state

Parameters:

processId - identifier of process definition

Throws:

SProcessDefinitionNotFoundException - error thrown if no process definition found for the given processId

SProcessDisablementException

resolveProcess

void resolveProcess(long processId)
                    throws SProcessDefinitionNotFoundException,
                           SProcessDisablementException

set the process as RESOLVED when it's in UNRESOLVED state

Parameters:

processId - identifier of process definition

Throws:

SProcessDefinitionNotFoundException - error thrown if no process definition found for the given processId

SProcessDisablementException

getNumberOfProcessDeploymentInfosByActivationState

long getNumberOfProcessDeploymentInfosByActivationState(ActivationState activationState)
                                                        throws org.bonitasoft.engine.persistence.SBonitaReadException

Gets how many processes are in the given state.

Parameters:

activationState - the activation state

Returns:

number of processes are in the given state or 0;

Throws:

org.bonitasoft.engine.persistence.SBonitaReadException

getNumberOfProcessDeploymentInfos

long getNumberOfProcessDeploymentInfos()
                                       throws org.bonitasoft.engine.persistence.SBonitaReadException

Gets how many processes are defined.

Returns:

the number of process definitions;

Throws:

org.bonitasoft.engine.persistence.SBonitaReadException - occurs when an exception is thrown during method execution

getProcessDefinitionIds

List<Long> getProcessDefinitionIds(ActivationState activationState,
                                 int fromIndex,
                                 int numberOfResult)
                                   throws org.bonitasoft.engine.persistence.SBonitaReadException

Get the process definition identifiers in the given state.

Parameters:

activationState - the activation state

fromIndex - Index of the record to be retrieved from. First record has index 0

numberOfResult - Number of result we want to get. Maximum number of result returned

Returns:

the paginated list of process definition identifiers or an empty list

Throws:

org.bonitasoft.engine.persistence.SBonitaReadException

getProcessDefinitionIds

List<Long> getProcessDefinitionIds(int fromIndex,
                                 int numberOfResult)
                                   throws org.bonitasoft.engine.persistence.SBonitaReadException

Get the process definition identifiers. * @param fromIndex Index of the record to be retrieved from. First record has index 0

Parameters:

numberOfResult - Number of result we want to get. Maximum number of result returned

Returns:

the paginated list of process definition identifiers or an empty list

Throws:

org.bonitasoft.engine.persistence.SBonitaReadException

getNextFlowNode

SFlowNodeDefinition getNextFlowNode(SProcessDefinition definition,
                                  String source)

Get target flow node for the given source flow node in the specific process

Parameters:

definition - the process definition containing source flow node

source - a flow node in process definition

Returns:

target flow node of the given source

getProcessDeploymentInfos

List<SProcessDefinitionDeployInfo> getProcessDeploymentInfos(List<Long> processIds,
                                                           int fromIndex,
                                                           int numberOfProcesses,
                                                           String field,
                                                           org.bonitasoft.engine.persistence.OrderByType order)
                                                             throws SProcessDefinitionNotFoundException,
                                                                    org.bonitasoft.engine.persistence.SBonitaReadException

get sub set of processDefinitionDeployInfos in specific order

Parameters:

processIds - identifiers of process definition

fromIndex - Index of the record to be retrieved from. First record has index 0

numberOfProcesses - Number of result we want to get. Maximum number of result returned

field - filed user to do order

order - ASC or DESC

Returns:

a list of SProcessDefinitionDeployInfo objects

Throws:

SProcessDefinitionNotFoundException

org.bonitasoft.engine.persistence.SBonitaReadException

getProcessDeploymentInfos

List<SProcessDefinitionDeployInfo> getProcessDeploymentInfos(List<Long> processIds)
                                                             throws SProcessDefinitionNotFoundException,
                                                                    org.bonitasoft.engine.persistence.SBonitaReadException

Throws:

SProcessDefinitionNotFoundException

org.bonitasoft.engine.persistence.SBonitaReadException

getLatestProcessDefinitionId

long getLatestProcessDefinitionId(String processName)
                                  throws org.bonitasoft.engine.persistence.SBonitaReadException,
                                         SProcessDefinitionNotFoundException

Get the processDefinitionId of the most recent version of the process

Parameters:

processName - name of process definition

Returns:

the latest process definition

Throws:

org.bonitasoft.engine.persistence.SBonitaReadException

SProcessDefinitionNotFoundException

getProcessDefinitionId

long getProcessDefinitionId(String name,
                          String version)
                            throws org.bonitasoft.engine.persistence.SBonitaReadException,
                                   SProcessDefinitionNotFoundException

Get the processDefinitionId by name and version

Parameters:

name - name of process definition

version - version or process definition

Returns:

identifier of process definition

Throws:

org.bonitasoft.engine.persistence.SBonitaReadException

SProcessDefinitionNotFoundException

updateProcessDefinitionDeployInfo

SProcessDefinitionDeployInfo updateProcessDefinitionDeployInfo(long processId,
                                                             org.bonitasoft.engine.recorder.model.EntityUpdateDescriptor descriptor)
                                                               throws SProcessDefinitionNotFoundException,
                                                                      SProcessDeploymentInfoUpdateException

Update deployment info of the process definition having the id given in parameter

Parameters:

processId - identifier of process deploy info

descriptor - update description

Throws:

SProcessDefinitionNotFoundException - error thrown when no process deploy info found with the give processId

SProcessDeploymentInfoUpdateException

searchProcessDeploymentInfosStartedBy

List<SProcessDefinitionDeployInfo> searchProcessDeploymentInfosStartedBy(long startedBy,
                                                                       org.bonitasoft.engine.persistence.QueryOptions searchOptions)
                                                                         throws org.bonitasoft.engine.persistence.SBonitaReadException

Search all process deploy info started by the specific user

Parameters:

startedBy - the name of user who started the process

searchOptions - a QueryOptions object containing some query conditions

Returns:

a list of SProcessDefinitionDeployInfo objects

Throws:

org.bonitasoft.engine.persistence.SBonitaReadException

getNumberOfProcessDeploymentInfosStartedBy

long getNumberOfProcessDeploymentInfosStartedBy(long startedBy,
                                              org.bonitasoft.engine.persistence.QueryOptions countOptions)
                                                throws org.bonitasoft.engine.persistence.SBonitaReadException

Get number of all process deploy info started by the specific user

Parameters:

startedBy - the name of user who started the process

countOptions - a QueryOptions object containing some query conditions

Returns:

number of all process deploy info to the criteria

Throws:

org.bonitasoft.engine.persistence.SBonitaReadException

searchProcessDeploymentInfos

List<SProcessDefinitionDeployInfo> searchProcessDeploymentInfos(org.bonitasoft.engine.persistence.QueryOptions searchOptions)
                                                                throws org.bonitasoft.engine.persistence.SBonitaReadException

Search all process definition deploy infos according to the specific search criteria

Parameters:

searchOptions - a QueryOptions object containing search criteria

Returns:

a list of SProcessDefinitionDeployInfo object

Throws:

org.bonitasoft.engine.persistence.SBonitaReadException

getNumberOfProcessDeploymentInfos

long getNumberOfProcessDeploymentInfos(org.bonitasoft.engine.persistence.QueryOptions countOptions)
                                       throws org.bonitasoft.engine.persistence.SBonitaReadException

Get number of all process definition deploy infos according to the specific search criteria

Parameters:

countOptions - a QueryOptions object containing query criteria

Returns:

number of all process definition deploy infos corresponding to the criteria

Throws:

org.bonitasoft.engine.persistence.SBonitaReadException

getNumberOfUncategorizedProcessDeploymentInfos

long getNumberOfUncategorizedProcessDeploymentInfos(org.bonitasoft.engine.persistence.QueryOptions countOptions)
                                                    throws org.bonitasoft.engine.persistence.SBonitaReadException

Get total number of uncategorized process definitions by given query criteria

Parameters:

countOptions - a QueryOptions object containing query criteria

Returns:

total number of uncategorized process definitions suit to query criteria

Throws:

org.bonitasoft.engine.persistence.SBonitaReadException

getNumberOfUncategorizedProcessDeploymentInfosSupervisedBy

long getNumberOfUncategorizedProcessDeploymentInfosSupervisedBy(long userId,
                                                              org.bonitasoft.engine.persistence.QueryOptions countOptions)
                                                                throws org.bonitasoft.engine.persistence.SBonitaReadException

Get total number of uncategorized process definitions by given query criteria for specific supervisor

Parameters:

userId - identifier of a supervisor user

countOptions - a QueryOptions object containing query criteria

Returns:

number of uncategorized process definitions managed by the specific supervisor

Throws:

org.bonitasoft.engine.persistence.SBonitaReadException

searchUncategorizedProcessDeploymentInfos

List<SProcessDefinitionDeployInfo> searchUncategorizedProcessDeploymentInfos(org.bonitasoft.engine.persistence.QueryOptions searchOptions)
                                                                             throws org.bonitasoft.engine.persistence.SBonitaReadException

Search all uncategorized process definitions according to the search criteria.

Parameters:

searchOptions - a QueryOptions object containing query criteria

Returns:

a list of SProcessDefinitionDeployInfo objects

Throws:

org.bonitasoft.engine.persistence.SBonitaReadException

searchProcessDeploymentInfosOfCategory

List<SProcessDefinitionDeployInfo> searchProcessDeploymentInfosOfCategory(long categoryId,
                                                                        org.bonitasoft.engine.persistence.QueryOptions queryOptions)
                                                                          throws org.bonitasoft.engine.persistence.SBonitaReadException

Search all process definitions for a specific category.

Parameters:

categoryId - Identifier of the category

queryOptions - a QueryOptions object containing query criteria

Returns:

a list of SProcessDefinitionDeployInfo objects

Throws:

org.bonitasoft.engine.persistence.SBonitaReadException

searchUncategorizedProcessDeploymentInfosSupervisedBy

List<SProcessDefinitionDeployInfo> searchUncategorizedProcessDeploymentInfosSupervisedBy(long userId,
                                                                                       org.bonitasoft.engine.persistence.QueryOptions searchOptions)
                                                                                         throws org.bonitasoft.engine.persistence.SBonitaReadException

Search all uncategorized process definitions by given query criteria for specific supervisor

Parameters:

userId - identifier of a supervisor user

searchOptions - a QueryOptions object containing query criteria

Returns:

a list of SProcessDefinitionDeployInfo object

Throws:

org.bonitasoft.engine.persistence.SBonitaReadException

searchProcessDeploymentInfosCanBeStartedBy

List<SProcessDefinitionDeployInfo> searchProcessDeploymentInfosCanBeStartedBy(long userId,
                                                                            org.bonitasoft.engine.persistence.QueryOptions searchOptions)
                                                                              throws org.bonitasoft.engine.persistence.SBonitaReadException

Search all process definitions for the specific user who can start

Parameters:

userId - identifier of user

searchOptions - a QueryOptions object containing query criteria

Returns:

a list of SProcessDefinitionDeployInfo objects

Throws:

org.bonitasoft.engine.persistence.SBonitaReadException

getNumberOfProcessDeploymentInfosCanBeStartedBy

long getNumberOfProcessDeploymentInfosCanBeStartedBy(long userId,
                                                   org.bonitasoft.engine.persistence.QueryOptions countOptions)
                                                     throws org.bonitasoft.engine.persistence.SBonitaReadException

Get number of all process definitions for the specific user who can start

Parameters:

userId - identifier of user

countOptions - a QueryOptions object containing query criteria

Returns:

number of all process definitions for the specific user who can start

Throws:

org.bonitasoft.engine.persistence.SBonitaReadException

searchProcessDeploymentInfosCanBeStartedByUsersManagedBy

List<SProcessDefinitionDeployInfo> searchProcessDeploymentInfosCanBeStartedByUsersManagedBy(long managerUserId,
                                                                                          org.bonitasoft.engine.persistence.QueryOptions searchOptions)
                                                                                            throws org.bonitasoft.engine.persistence.SBonitaReadException

Search all process definitions for the users managed by specific manager, or manager who can start

Parameters:

managerUserId - identifier of manager

searchOptions - a QueryOptions object containing query criteria

Returns:

a list of SProcessDefinitionDeployInfo objects

Throws:

org.bonitasoft.engine.persistence.SBonitaReadException

getNumberOfProcessDeploymentInfosCanBeStartedByUsersManagedBy

long getNumberOfProcessDeploymentInfosCanBeStartedByUsersManagedBy(long managerUserId,
                                                                 org.bonitasoft.engine.persistence.QueryOptions countOptions)
                                                                   throws org.bonitasoft.engine.persistence.SBonitaReadException

Get number of all process definitions for the users managed by specific manager, or manager who can start

Parameters:

managerUserId - identifier of manager

countOptions - a QueryOptions object containing query criteria

Returns:

Number of all process definitions for the users managed by specific manager, or manager who can start

Throws:

org.bonitasoft.engine.persistence.SBonitaReadException

searchProcessDeploymentInfos

List<SProcessDefinitionDeployInfo> searchProcessDeploymentInfos(long userId,
                                                              org.bonitasoft.engine.persistence.QueryOptions searchOptions,
                                                              String querySuffix)
                                                                throws org.bonitasoft.engine.persistence.SBonitaReadException

Search all process definitions for the specific user who can perform the "querySuffix" specified action

Parameters:

userId - identifier of user

searchOptions - a QueryOptions object containing query criteria

querySuffix - query suffix to specify the thing the user can do, it can be "UserSupervised" or "UserCanStart"

Returns:

a list of SProcessDefinitionDeployInfo object

Throws:

org.bonitasoft.engine.persistence.SBonitaReadException

getNumberOfProcessDeploymentInfos

long getNumberOfProcessDeploymentInfos(long userId,
                                     org.bonitasoft.engine.persistence.QueryOptions countOptions,
                                     String querySuffix)
                                       throws org.bonitasoft.engine.persistence.SBonitaReadException

Get total number of process definitions for the specific user who can perform the "querySuffix" specified action

Parameters:

userId - identifier of user

countOptions - a QueryOptions object containing query criteria

querySuffix - query suffix to specify the thing the user can do, it can be "UserSupervised" or "UserCanStart"

Returns:

number of process definitions for the specific user with specific action

Throws:

org.bonitasoft.engine.persistence.SBonitaReadException

searchUncategorizedProcessDeploymentInfosCanBeStartedBy

List<SProcessDefinitionDeployInfo> searchUncategorizedProcessDeploymentInfosCanBeStartedBy(long userId,
                                                                                         org.bonitasoft.engine.persistence.QueryOptions searchOptions)
                                                                                           throws org.bonitasoft.engine.persistence.SBonitaReadException

Search all uncategorized process definitions for the specific user who can start

Parameters:

userId - identifier of user

searchOptions - a QueryOptions object containing query criteria

Returns:

a list of SProcessDefinitionDeployInfo object

Throws:

org.bonitasoft.engine.persistence.SBonitaReadException

getNumberOfUncategorizedProcessDeploymentInfosCanBeStartedBy

long getNumberOfUncategorizedProcessDeploymentInfosCanBeStartedBy(long userId,
                                                                org.bonitasoft.engine.persistence.QueryOptions countOptions)
                                                                  throws org.bonitasoft.engine.persistence.SBonitaReadException

Get total number of uncategorized process definitions for the specific user who can start

Parameters:

userId - identifier of user

countOptions - a QueryOptions object containing query criteria

Returns:

number of uncategorized process definitions for the specific user who can start

Throws:

org.bonitasoft.engine.persistence.SBonitaReadException

getProcessDeploymentInfosFromProcessInstanceIds

Map<Long,SProcessDefinitionDeployInfo> getProcessDeploymentInfosFromProcessInstanceIds(List<Long> processInstanceIds)
                                                                                       throws org.bonitasoft.engine.persistence.SBonitaReadException

A list of SProcessDefinitionDeployInfos for the specific processInstances

Parameters:

processInstanceIds - identifier of process instances

Returns:

a map containing identifiers of process instance and the corresponding SProcessDefinitionDeployInfo object

Throws:

org.bonitasoft.engine.persistence.SBonitaReadException

getProcessDeploymentInfosFromArchivedProcessInstanceIds

Map<Long,SProcessDefinitionDeployInfo> getProcessDeploymentInfosFromArchivedProcessInstanceIds(List<Long> archivedProcessInstantsIds)
                                                                                               throws org.bonitasoft.engine.persistence.SBonitaReadException

Get A list of SProcessDefinitionDeployInfos for the specific archived processInstances

Parameters:

archivedProcessInstantsIds - identifiers of archived processInstance

Returns:

a map containing identifiers of archived process instance and the corresponding SProcessDefinitionDeployInfo object

Throws:

org.bonitasoft.engine.persistence.SBonitaReadException

getProcessDeploymentInfosUnrelatedToCategory

List<SProcessDefinitionDeployInfo> getProcessDeploymentInfosUnrelatedToCategory(long categoryId,
                                                                              int pageIndex,
                                                                              int numberPerPage,
                                                                              ProcessDeploymentInfoCriterion pagingCriterion)
                                                                                throws org.bonitasoft.engine.persistence.SBonitaReadException

Get A list of SProcessDefinitionDeployInfos unrelated to the specific category

Parameters:

categoryId -

pagingCriterion -

numberPerPage -

pageIndex -

Returns:

A list of SProcessDefinitionDeployInfos unrelated to the specific category

Throws:

org.bonitasoft.engine.persistence.SBonitaReadException

getNumberOfProcessDeploymentInfosUnrelatedToCategory

Long getNumberOfProcessDeploymentInfosUnrelatedToCategory(long categoryId)
                                                          throws org.bonitasoft.engine.persistence.SBonitaReadException

Get number of SProcessDefinitionDeployInfos unrelated to the specific category

Parameters:

categoryId -

Returns:

Number of SProcessDefinitionDeployInfos unrelated to the specific category

Throws:

org.bonitasoft.engine.persistence.SBonitaReadException

getProcessDeploymentInfos

List<SProcessDefinitionDeployInfo> getProcessDeploymentInfos(org.bonitasoft.engine.persistence.QueryOptions queryOptions)
                                                             throws org.bonitasoft.engine.persistence.SBonitaReadException

Get process definition deploy info in a specific interval with order, this can be used for pagination

Parameters:

queryOptions - object containing query criteria

Returns:

a list of SProcessDefinitionDeployInfo corresponding to the criteria

Throws:

org.bonitasoft.engine.persistence.SBonitaReadException

getProcessDeploymentInfosWithActorOnlyForGroup

List<SProcessDefinitionDeployInfo> getProcessDeploymentInfosWithActorOnlyForGroup(long groupId,
                                                                                org.bonitasoft.engine.persistence.QueryOptions queryOptions)
                                                                                  throws org.bonitasoft.engine.persistence.SBonitaReadException

List all processes that contain at least one task which actor is mapped only to the specified group.

Parameters:

groupId - the Id of the group from which to retrieve the processes with tasks only it can do.

queryOptions - object containing query criteria

Returns:

the list of matching processes, as a List of SProcessDefinitionDeployInfo

Throws:

org.bonitasoft.engine.persistence.SBonitaReadException - in case a read problem occurs

getProcessDeploymentInfosWithActorOnlyForGroups

List<SProcessDefinitionDeployInfo> getProcessDeploymentInfosWithActorOnlyForGroups(List<Long> groupIds,
                                                                                 org.bonitasoft.engine.persistence.QueryOptions queryOptions)
                                                                                   throws org.bonitasoft.engine.persistence.SBonitaReadException

List all processes that contain at least one task which actor is mapped only to the specified groups.

Parameters:

groupIds - the Ids of the groups from which to retrieve the processes with tasks only they can do.

queryOptions - object containing query criteria

Returns:

the list of matching processes, as a List of SProcessDefinitionDeployInfo

Throws:

org.bonitasoft.engine.persistence.SBonitaReadException - in case a read problem occurs

getProcessDeploymentInfosWithActorOnlyForRole

List<SProcessDefinitionDeployInfo> getProcessDeploymentInfosWithActorOnlyForRole(long roleId,
                                                                               org.bonitasoft.engine.persistence.QueryOptions queryOptions)
                                                                                 throws org.bonitasoft.engine.persistence.SBonitaReadException

List all processes that contain at least one task which actor is mapped only to the specified role.

Parameters:

roleId - the Id of the role from which to retrieve the processes with tasks only it can do.

queryOptions - object containing query criteria

Returns:

the list of matching processes, as a List of SProcessDefinitionDeployInfo

Throws:

org.bonitasoft.engine.persistence.SBonitaReadException - in case a read problem occurs

getProcessDeploymentInfosWithActorOnlyForRoles

List<SProcessDefinitionDeployInfo> getProcessDeploymentInfosWithActorOnlyForRoles(List<Long> roleIds,
                                                                                org.bonitasoft.engine.persistence.QueryOptions queryOptions)
                                                                                  throws org.bonitasoft.engine.persistence.SBonitaReadException

List all processes that contain at least one task which actor is mapped only to the specified roles.

Parameters:

roleIds - the Ids of the roles from which to retrieve the processes with tasks only they can do.

queryOptions - object containing query criteria

Returns:

the list of matching processes, as a List of SProcessDefinitionDeployInfo

Throws:

org.bonitasoft.engine.persistence.SBonitaReadException - in case a read problem occurs

getProcessDeploymentInfosWithActorOnlyForUser

List<SProcessDefinitionDeployInfo> getProcessDeploymentInfosWithActorOnlyForUser(long userId,
                                                                               org.bonitasoft.engine.persistence.QueryOptions queryOptions)
                                                                                 throws org.bonitasoft.engine.persistence.SBonitaReadException

List all processes that contain at least one task which actor is mapped only to the specified user.

Parameters:

userId - the Id of the user from which to retrieve the processes with tasks only he / she can do.

queryOptions - object containing query criteria

Returns:

the list of matching processes, as a List of SProcessDefinitionDeployInfo

Throws:

org.bonitasoft.engine.persistence.SBonitaReadException - in case a read problem occurs

getProcessDeploymentInfosWithActorOnlyForUsers

List<SProcessDefinitionDeployInfo> getProcessDeploymentInfosWithActorOnlyForUsers(List<Long> userIds,
                                                                                org.bonitasoft.engine.persistence.QueryOptions queryOptions)
                                                                                  throws org.bonitasoft.engine.persistence.SBonitaReadException

List all processes that contain at least one task which actor is mapped only to the specified users.

Parameters:

userIds - the Ids of the users from which to retrieve the processes with tasks only they can do.

queryOptions - object containing query criteria

Returns:

the list of matching processes, as a List of SProcessDefinitionDeployInfo

Throws:

org.bonitasoft.engine.persistence.SBonitaReadException - in case a read problem occurs

getNumberOfUsersWhoCanStartProcessDeploymentInfo

long getNumberOfUsersWhoCanStartProcessDeploymentInfo(long processDefinitionId,
                                                    org.bonitasoft.engine.persistence.QueryOptions queryOptions)
                                                      throws org.bonitasoft.engine.persistence.SBonitaReadException

Get total number of users according to specific query options, and who can start the given process definition

Parameters:

processDefinitionId - Identifier of the process definition

queryOptions - The QueryOptions object containing some query conditions

Returns:

Throws:

org.bonitasoft.engine.persistence.SBonitaReadException

searchUsersWhoCanStartProcessDeploymentInfo

List<org.bonitasoft.engine.identity.model.SUser> searchUsersWhoCanStartProcessDeploymentInfo(long processDefinitionId,
                                                                                           org.bonitasoft.engine.persistence.QueryOptions queryOptions)
                                                                                             throws org.bonitasoft.engine.persistence.SBonitaReadException

Search users according to specific query options, and who can start the given process definition

Parameters:

processDefinitionId - Identifier of the process definition

searchOptions - The QueryOptions object containing some query conditions

Returns:

Throws:

org.bonitasoft.engine.persistence.SBonitaReadException

getNumberOfProcessDeploymentInfosWithAssignedOrPendingHumanTasksFor

long getNumberOfProcessDeploymentInfosWithAssignedOrPendingHumanTasksFor(long userId,
                                                                       org.bonitasoft.engine.persistence.QueryOptions queryOptions)
                                                                         throws org.bonitasoft.engine.persistence.SBonitaReadException

Get the total number of the process definitions that have one or more human tasks assigned/pending for a specific user. The tasks are in stable state, not in terminal/executing state.

Parameters:

userId - The identifier of the user.

queryOptions - The QueryOptions object containing some query conditions

Returns:

The number of the process definition

Throws:

org.bonitasoft.engine.persistence.SBonitaReadException

searchProcessDeploymentInfosWithAssignedOrPendingHumanTasksFor

List<SProcessDefinitionDeployInfo> searchProcessDeploymentInfosWithAssignedOrPendingHumanTasksFor(long userId,
                                                                                                org.bonitasoft.engine.persistence.QueryOptions queryOptions)
                                                                                                  throws org.bonitasoft.engine.persistence.SBonitaReadException

Search all process definitions that have one or more human tasks assigned/pending for a specific user. The tasks are in stable state, not in terminal/executing state.

Parameters:

userId - The identifier of the user.

queryOptions - The QueryOptions object containing some query conditions

Returns:

The list of process definitions

Throws:

org.bonitasoft.engine.persistence.SBonitaReadException

getNumberOfProcessDeploymentInfosWithAssignedOrPendingHumanTasksSupervisedBy

long getNumberOfProcessDeploymentInfosWithAssignedOrPendingHumanTasksSupervisedBy(long userId,
                                                                                org.bonitasoft.engine.persistence.QueryOptions queryOptions)
                                                                                  throws org.bonitasoft.engine.persistence.SBonitaReadException

Get the total number of the process definitions supervised by a specific user, that have instances with one or more human tasks assigned/pending. The tasks are in stable state, not in terminal/executing state.

Parameters:

userId - The identifier of the user.

queryOptions - The QueryOptions object containing some query conditions

Returns:

The number of the process definition

Throws:

org.bonitasoft.engine.persistence.SBonitaReadException - if an exception occurs when getting the process deployment information.

Since:

6.3.3

searchProcessDeploymentInfosWithAssignedOrPendingHumanTasksSupervisedBy

List<SProcessDefinitionDeployInfo> searchProcessDeploymentInfosWithAssignedOrPendingHumanTasksSupervisedBy(long userId,
                                                                                                         org.bonitasoft.engine.persistence.QueryOptions queryOptions)
                                                                                                           throws org.bonitasoft.engine.persistence.SBonitaReadException

Search all process definitions supervised by a specific user, that have instances with one or more human tasks assigned/pending. The tasks are in stable state, not in terminal/executing state.

Parameters:

userId - The identifier of the user.

queryOptions - The QueryOptions object containing some query conditions

Returns:

The list of process definitions

Throws:

org.bonitasoft.engine.persistence.SBonitaReadException - if an exception occurs when getting the process deployment information.

Since:

6.3.3

getNumberOfProcessDeploymentInfosWithAssignedOrPendingHumanTasks

long getNumberOfProcessDeploymentInfosWithAssignedOrPendingHumanTasks(org.bonitasoft.engine.persistence.QueryOptions queryOptions)
                                                                      throws org.bonitasoft.engine.persistence.SBonitaReadException

Get the total number of the process definitions that have instances with one or more human tasks assigned/pending. The tasks are in stable state, not in terminal/executing state.

Parameters:

queryOptions - The QueryOptions object containing some query conditions

Returns:

The number of the process definition

Throws:

org.bonitasoft.engine.persistence.SBonitaReadException - if an exception occurs when getting the process deployment information.

Since:

6.3.3

searchProcessDeploymentInfosWithAssignedOrPendingHumanTasks

List<SProcessDefinitionDeployInfo> searchProcessDeploymentInfosWithAssignedOrPendingHumanTasks(org.bonitasoft.engine.persistence.QueryOptions queryOptions)
                                                                                               throws org.bonitasoft.engine.persistence.SBonitaReadException

Search all process definitions that have instances with one or more human tasks assigned/pending. The tasks are in stable state, not in terminal/executing state.

Parameters:

queryOptions - The QueryOptions object containing some query conditions

Returns:

The list of process definitions

Throws:

org.bonitasoft.engine.persistence.SBonitaReadException - if an exception occurs when getting the process deployment information.

Since:

6.3.3

updateExpressionContent

void updateExpressionContent(long processDefinitionId,
                           long expressionDefinitionId,
                           String content)
                             throws SProcessDefinitionNotFoundException,
                                    org.bonitasoft.engine.commons.exceptions.SObjectModificationException

Updates the content of an Expression, for a given process definition. Any further use of this expresssion will then use the new content, as if it was designed like this in the first place.

Parameters:

processDefinitionId - the ID of the process definition on which the Expression content will be updated.

expressionDefinitionId - the ID of the expression definition to update

content - the new String content of the expression

Throws:

SProcessDefinitionNotFoundException - if the referenced process definition does not exist.

org.bonitasoft.engine.commons.exceptions.SObjectModificationException - if the update cannot be performed successfully.

getDesignProcessDefinition

DesignProcessDefinition getDesignProcessDefinition(long processDefinitionId)
                                                   throws SProcessDefinitionNotFoundException,
                                                          org.bonitasoft.engine.persistence.SBonitaReadException

Returns a specific process definition that include informations such as tasks definition, actors...

Parameters:

processDefinitionId - Identifier of process definition

Returns:

The corresponding process definition with informations.

Throws:

SProcessDefinitionNotFoundException - If the process definition doesn't exist.

org.bonitasoft.engine.persistence.SBonitaReadException - If the process definition design cannot be read

Since:

7.0