Package org.bonitasoft.engine.core.process.instance.api

Interface FlowNodeInstanceService

All Known Subinterfaces:

ActivityInstanceService

All Known Implementing Classes:

ActivityInstanceServiceImpl, FlowNodeInstancesServiceImpl

public interface FlowNodeInstanceService

Author:

Elias Ricken de Medeiros, Matthieu Chaffotte, Celine Souchet

Field Summary

Fields

Modifier and Type	Field	Description
static final String	ACTIVITY_INSTANCE_TOKEN_COUNT
static final String	ACTIVITYINSTANCE_DISPLAY_DESCRIPTION
static final String	ACTIVITYINSTANCE_DISPLAY_NAME
static final String	ACTIVITYINSTANCE_STATE
static final String	EXECUTED_BY_MODIFIED
static final String	EXECUTED_BY_SUBSTITUTE_MODIFIED
static final String	EXPECTED_END_DATE_MODIFIED
static final String	FLOWNODE_INSTANCE
static final String	LOOPINSTANCE_LOOPMAX_MODIFIED
static final String	MULTIINSTANCE_LOOPCARDINALITY_MODIFIED
static final String	MULTIINSTANCE_NUMBEROFINSTANCE_MODIFIED
static final String	STATE_CATEGORY

Method Summary

Modifier and Type	Method	Description
void	deleteArchivedFlowNodeInstances(List<Long> sourceObjectIds)
void	deleteFlowNodeInstance(SFlowNodeInstance sFlowNodeInstance)
List<SFlowNodeInstance>	getAllChildrenOfProcessInstance(long processInstanceId, int fromIndex, int maxResults)	get the flow node instances directly contained in the given process instance
SAFlowNodeInstance	getArchivedFlowNodeInstance(long archivedFlowNodeInstanceId)
List<SAFlowNodeInstance>	getArchivedFlowNodeInstances(long rootContainerId, int fromIndex, int maxResults)
List<SFlowNodeInstance>	getDirectChildrenOfActivityInstance(long parentActivityInstanceId, int fromIndex, int maxResults)	get the flow node instances directly contained in the given activity instance
List<SFlowNodeInstance>	getDirectChildrenOfProcessInstance(long processInstanceId, int fromIndex, int maxResults)	get the flow node instances directly contained in the given process instance
SFlowNodeInstance	getFlowNodeInstance(long flowNodeInstanceId)
List<Long>	getFlowNodeInstanceIdsToRecover(Duration considerElementsOlderThan, QueryOptions queryOptions)	retrieve ids of elements that need to be recovered Called on start node to set the flag to tell the engine to restart these flow nodes Should not be called when the engine is started! This does not retrieve SGatewayInstances
List<SFlowNodeInstance>	getFlowNodeInstancesByIds(List<Long> ids)
List<SFlowNodeInstance>	getFlowNodeInstancesByNameAndParentContainerId(String name, Long parentContainerId)
List<Long>	getGatewayInstanceIdsToRecover(Duration considerElementsOlderThan, QueryOptions queryOptions)	Retrieve ids of SGatewayInstances that need to be recovered
<T extends SAFlowNodeInstance> T	getLastArchivedFlowNodeInstance(Class<T> entityClass, long sourceObjectFlowNodeInstanceId)
long	getNumberOfArchivedFlowNodeInstances(Class<? extends SAFlowNodeInstance> entityClass, QueryOptions queryOptions)	Retrieve the total number of the archived flow nodes matching the given search criteria.
long	getNumberOfArchivedFlowNodeInstancesSupervisedBy(long supervisorId, Class<? extends SAFlowNodeInstance> entityClass, QueryOptions queryOptions)	Retrieve the total number of the archived flow nodes matching the given search criteria, for a specific supervisor.
List<SFlowNodeInstanceStateCounter>	getNumberOfArchivedFlownodesInAllStates(long processInstanceId)	Counts the number of archived flownode instances in a specific state.
long	getNumberOfFlowNodeInstances(Class<? extends SFlowNodeInstance> entityClass, QueryOptions countOptions)
long	getNumberOfFlowNodeInstancesSupervisedBy(Long supervisorId, Class<? extends SFlowNodeInstance> entityClass, QueryOptions countOptions)
int	getNumberOfFlowNodes(long rootContainerId)	get the number of flow node is this root container
List<SFlowNodeInstanceStateCounter>	getNumberOfFlownodesInAllStates(long processInstanceId)	Counts the number of flownode instances in all states.
List<SFlowNodeInstanceStateCounter>	getNumberOfFlownodesOfProcessDefinitionInAllStates(long processDefinitionId)	Counts the number of flownode instances in all states.
Set<Long>	getSourceObjectIdsOfArchivedFlowNodeInstances(List<Long> sourceProcessInstanceIds)	get all flow nodes contained in the list of root source process instance ids
<T extends SAFlowNodeInstance> List<T>	searchArchivedFlowNodeInstances(Class<T> entityClass, QueryOptions queryOptions)	Retrieve the total number of the archived flow nodes matching the given search criteria.
<T extends SAFlowNodeInstance> List<T>	searchArchivedFlowNodeInstancesSupervisedBy(long supervisorId, Class<T> entityClass, QueryOptions queryOptions)	Retrieve the total number of the archived flow nodes matching the given search criteria, for a specific supervisor.
<T extends SFlowNodeInstance> List<T>	searchFlowNodeInstances(Class<T> entityClass, QueryOptions searchOptions)
<T extends SFlowNodeInstance> List<T>	searchFlowNodeInstancesSupervisedBy(Long supervisorId, Class<T> entityClass, QueryOptions searchOptions)
void	setExecutedBy(SFlowNodeInstance sFlowNodeInstance, long userId)	Set execute by for the specific flow node instance
void	setExecutedBySubstitute(SFlowNodeInstance sFlowNodeInstance, long executerSubstituteId)	Set execute by delegate for the specific flow node instance
void	setExecuting(SFlowNodeInstance flowNodeInstance)
void	setExpectedEndDate(SFlowNodeInstance flowNodeInstance, Long dueDate)
void	setState(SFlowNodeInstance flowNodeInstance, FlowNodeState state)
void	setStateCategory(SFlowNodeInstance flowElementInstance, SStateCategory stateCategory)
void	setTaskPriority(SFlowNodeInstance flowNodeInstance, STaskPriority priority)
void	updateDisplayDescription(SFlowNodeInstance flowNodeInstance, String displayDescription)
void	updateDisplayName(SFlowNodeInstance flowNodeInstance, String displayName)

Field Details

FLOWNODE_INSTANCE

static final String FLOWNODE_INSTANCE

See Also:

• Constant Field Values

ACTIVITYINSTANCE_STATE

static final String ACTIVITYINSTANCE_STATE

See Also:

• Constant Field Values

ACTIVITY_INSTANCE_TOKEN_COUNT

static final String ACTIVITY_INSTANCE_TOKEN_COUNT

See Also:

• Constant Field Values

ACTIVITYINSTANCE_DISPLAY_DESCRIPTION

static final String ACTIVITYINSTANCE_DISPLAY_DESCRIPTION

See Also:

• Constant Field Values

LOOPINSTANCE_LOOPMAX_MODIFIED

static final String LOOPINSTANCE_LOOPMAX_MODIFIED

See Also:

• Constant Field Values

MULTIINSTANCE_LOOPCARDINALITY_MODIFIED

static final String MULTIINSTANCE_LOOPCARDINALITY_MODIFIED

See Also:

• Constant Field Values

MULTIINSTANCE_NUMBEROFINSTANCE_MODIFIED

static final String MULTIINSTANCE_NUMBEROFINSTANCE_MODIFIED

See Also:

• Constant Field Values

ACTIVITYINSTANCE_DISPLAY_NAME

static final String ACTIVITYINSTANCE_DISPLAY_NAME

See Also:

• Constant Field Values

STATE_CATEGORY

static final String STATE_CATEGORY

See Also:

• Constant Field Values

EXECUTED_BY_MODIFIED

static final String EXECUTED_BY_MODIFIED

See Also:

• Constant Field Values

EXECUTED_BY_SUBSTITUTE_MODIFIED

static final String EXECUTED_BY_SUBSTITUTE_MODIFIED

See Also:

• Constant Field Values

EXPECTED_END_DATE_MODIFIED

static final String EXPECTED_END_DATE_MODIFIED

See Also:

• Constant Field Values

Method Details

getFlowNodeInstance

SFlowNodeInstance getFlowNodeInstance(long flowNodeInstanceId)
                               throws SFlowNodeNotFoundException,
SFlowNodeReadException

Parameters:

flowNodeInstanceId -

Returns:

Throws:

SFlowNodeNotFoundException

SFlowNodeReadException

Since:

6.0

getAllChildrenOfProcessInstance

List<SFlowNodeInstance> getAllChildrenOfProcessInstance(long processInstanceId,
 int fromIndex,
 int maxResults)
                                                 throws SFlowNodeReadException,
SBonitaReadException

get the flow node instances directly contained in the given process instance

Parameters:

processInstanceId - the parent process instance

Throws:

SFlowNodeReadException

SBonitaReadException

getDirectChildrenOfProcessInstance

List<SFlowNodeInstance> getDirectChildrenOfProcessInstance(long processInstanceId,
 int fromIndex,
 int maxResults)
                                                    throws SFlowNodeReadException,
SBonitaReadException

get the flow node instances directly contained in the given process instance

Parameters:

processInstanceId - the parent process instance

Throws:

SFlowNodeReadException

SBonitaReadException

getDirectChildrenOfActivityInstance

List<SFlowNodeInstance> getDirectChildrenOfActivityInstance(long parentActivityInstanceId,
 int fromIndex,
 int maxResults)
                                                     throws SFlowNodeReadException,
SBonitaReadException

get the flow node instances directly contained in the given activity instance

Parameters:

parentActivityInstanceId - the parent process instance

Throws:

SFlowNodeReadException

SBonitaReadException

setState

void setState(SFlowNodeInstance flowNodeInstance,
 FlowNodeState state)
       throws SFlowNodeModificationException

Parameters:

flowNodeInstance -

state -

Throws:

SFlowNodeModificationException

Since:

6.0

setTaskPriority

void setTaskPriority(SFlowNodeInstance flowNodeInstance,
 STaskPriority priority)
              throws SFlowNodeModificationException

Parameters:

flowNodeInstance -

priority -

Throws:

SFlowNodeModificationException

Since:

6.0

updateDisplayDescription

void updateDisplayDescription(SFlowNodeInstance flowNodeInstance,
 String displayDescription)
                       throws SFlowNodeModificationException

Parameters:

flowNodeInstance -

displayDescription -

Throws:

SFlowNodeModificationException

Since:

6.0

updateDisplayName

void updateDisplayName(SFlowNodeInstance flowNodeInstance,
 String displayName)
                throws SFlowNodeModificationException

Parameters:

flowNodeInstance -

displayName -

Throws:

SFlowNodeModificationException

Since:

6.0

setStateCategory

void setStateCategory(SFlowNodeInstance flowElementInstance,
 SStateCategory stateCategory)
               throws SFlowNodeModificationException

Parameters:

flowElementInstance -

stateCategory -

Throws:

SFlowNodeModificationException

Since:

6.0

getNumberOfFlowNodeInstances

long getNumberOfFlowNodeInstances(Class<? extends SFlowNodeInstance> entityClass,
 QueryOptions countOptions)
                           throws SBonitaReadException

Parameters:

entityClass -

countOptions -

Returns:

Throws:

SBonitaReadException

Since:

6.0

getNumberOfFlowNodeInstancesSupervisedBy

long getNumberOfFlowNodeInstancesSupervisedBy(Long supervisorId,
 Class<? extends SFlowNodeInstance> entityClass,
 QueryOptions countOptions)
                                       throws SBonitaReadException

Parameters:

entityClass -

countOptions -

Returns:

Throws:

SBonitaReadException

Since:

6.0

searchFlowNodeInstances

<T extends SFlowNodeInstance> List<T> searchFlowNodeInstances(Class<T> entityClass,
 QueryOptions searchOptions)
                                                       throws SBonitaReadException

Parameters:

entityClass -

searchOptions -

Returns:

Throws:

SBonitaReadException

Since:

6.0

searchFlowNodeInstancesSupervisedBy

<T extends SFlowNodeInstance> List<T> searchFlowNodeInstancesSupervisedBy(Long supervisorId,
 Class<T> entityClass,
 QueryOptions searchOptions)
                                                                   throws SBonitaReadException

Parameters:

entityClass -

searchOptions -

Returns:

Throws:

SBonitaReadException

Since:

6.0

getNumberOfFlownodesOfProcessDefinitionInAllStates

List<SFlowNodeInstanceStateCounter> getNumberOfFlownodesOfProcessDefinitionInAllStates(long processDefinitionId)
                                                                                throws SBonitaReadException

Counts the number of flownode instances in all states. Only considers flownodes direcly contained in given process definition. Results are counted per flownode name and per state.

Parameters:

processDefinitionId - the ID of the process definition to search flownodes for.

Returns:

a list of FlowNodeInstanceStateCounter. If no results, returns an empty list.

Throws:

SBonitaReadException - if a read exception occurs.

getNumberOfFlownodesInAllStates

List<SFlowNodeInstanceStateCounter> getNumberOfFlownodesInAllStates(long processInstanceId)
                                                             throws SBonitaReadException

Counts the number of flownode instances in all states. Only considers flownodes direcly contained in given process instance, not flownodes in sub-process instances. Results are counted per flownode name and per state.

Parameters:

processInstanceId - the ID of the process instance to search flownodes for.

Returns:

a list of FlowNodeInstanceStateCounter. If no results, returns an empty list.

Throws:

SBonitaReadException - if a read exception occurs.

getNumberOfArchivedFlownodesInAllStates

List<SFlowNodeInstanceStateCounter> getNumberOfArchivedFlownodesInAllStates(long processInstanceId)
                                                                     throws SBonitaReadException

Counts the number of archived flownode instances in a specific state. Only considers archived flownodes direcly contained in given process instance, not flownodes in sub-process instances. Results are counted per flownode name and per state.

Parameters:

processInstanceId - the ID of the process instance to search flownodes for. This is the ID of the process instance before it was archived (corresponding to the sourceObjectId in the archives)

Returns:

a list of FlowNodeInstanceStateCounter. If no results, returns an empty list.

Throws:

SBonitaReadException - if a read exception occurs.

setExecutedBy

void setExecutedBy(SFlowNodeInstance sFlowNodeInstance,
 long userId)
            throws SFlowNodeModificationException

Set execute by for the specific flow node instance

Parameters:

sFlowNodeInstance - the flowNodeInstance will be updated

userId - value for executedBy

Throws:

SFlowNodeModificationException

Since:

6.0

setExecutedBySubstitute

void setExecutedBySubstitute(SFlowNodeInstance sFlowNodeInstance,
 long executerSubstituteId)
                      throws SFlowNodeModificationException

Set execute by delegate for the specific flow node instance

Parameters:

sFlowNodeInstance - the flowNodeInstance will be updated

executerSubstituteId - value for executedBySubstitute

Throws:

SFlowNodeModificationException

Since:

6.0.1

getNumberOfArchivedFlowNodeInstances

long getNumberOfArchivedFlowNodeInstances(Class<? extends SAFlowNodeInstance> entityClass,
 QueryOptions queryOptions)
                                   throws SBonitaReadException

Retrieve the total number of the archived flow nodes matching the given search criteria.

Parameters:

entityClass - The type of the archived flow node to search for

queryOptions - The search options to filter the results

Returns:

The number found, 0 if none matching search criteria

Throws:

SBonitaReadException

Since:

6.0

getNumberOfArchivedFlowNodeInstancesSupervisedBy

long getNumberOfArchivedFlowNodeInstancesSupervisedBy(long supervisorId,
 Class<? extends SAFlowNodeInstance> entityClass,
 QueryOptions queryOptions)
                                               throws SBonitaReadException

Retrieve the total number of the archived flow nodes matching the given search criteria, for a specific supervisor.

Parameters:

supervisorId - The identifier of the supervisor

entityClass - The type of the archived flow node to search for

queryOptions - The search options to filter the results

Returns:

The number found, 0 if no matching search criteria

Throws:

SBonitaReadException

Since:

6.3

searchArchivedFlowNodeInstances

<T extends SAFlowNodeInstance> List<T> searchArchivedFlowNodeInstances(Class<T> entityClass,
 QueryOptions queryOptions)
                                                                throws SBonitaReadException

Retrieve the total number of the archived flow nodes matching the given search criteria.

Parameters:

entityClass - The type of the archived flow node to search for

queryOptions - The search options to filter the results

Returns:

The list of paginated results, according to the QueryOptions search criteria

Throws:

SBonitaReadException

Since:

6.0

searchArchivedFlowNodeInstancesSupervisedBy

<T extends SAFlowNodeInstance> List<T> searchArchivedFlowNodeInstancesSupervisedBy(long supervisorId,
 Class<T> entityClass,
 QueryOptions queryOptions)
                                                                            throws SBonitaReadException

Retrieve the total number of the archived flow nodes matching the given search criteria, for a specific supervisor.

Parameters:

supervisorId - The identifier of the supervisor

entityClass - The type of the archived flow node to search for

queryOptions - The search options to filter the results

Returns:

The list of paginated results, according to the QueryOptions search criteria

Throws:

SBonitaReadException

Since:

6.3

setExpectedEndDate

void setExpectedEndDate(SFlowNodeInstance flowNodeInstance,
 Long dueDate)
                 throws SFlowNodeModificationException

Parameters:

flowNodeInstance -

dueDate -

Throws:

SFlowNodeModificationException

getArchivedFlowNodeInstances

List<SAFlowNodeInstance> getArchivedFlowNodeInstances(long rootContainerId,
 int fromIndex,
 int maxResults)
                                               throws SFlowNodeReadException

Parameters:

rootContainerId -

fromIndex -

maxResults -

Returns:

Throws:

SFlowNodeReadException

getArchivedFlowNodeInstance

SAFlowNodeInstance getArchivedFlowNodeInstance(long archivedFlowNodeInstanceId)
                                        throws SFlowNodeReadException,
SFlowNodeNotFoundException

Parameters:

archivedFlowNodeInstanceId -

Returns:

Throws:

SFlowNodeReadException

SFlowNodeNotFoundException

Since:

6.0

getLastArchivedFlowNodeInstance

<T extends SAFlowNodeInstance> T getLastArchivedFlowNodeInstance(Class<T> entityClass,
 long sourceObjectFlowNodeInstanceId)
                                                          throws SBonitaReadException

Parameters:

sourceObjectFlowNodeInstanceId - The source identifier of the flow node instance

Returns:

The last archived flow node

Throws:

SBonitaReadException

Since:

6.3

setExecuting

void setExecuting(SFlowNodeInstance flowNodeInstance)
           throws SFlowNodeModificationException

Parameters:

flowNodeInstance -

Throws:

SFlowNodeModificationException

deleteFlowNodeInstance

void deleteFlowNodeInstance(SFlowNodeInstance sFlowNodeInstance)
                     throws SFlowNodeReadException,
SFlowNodeDeletionException

Parameters:

sFlowNodeInstance -

Throws:

SFlowNodeReadException

SFlowNodeDeletionException

Since:

6.1

getFlowNodeInstanceIdsToRecover

List<Long> getFlowNodeInstanceIdsToRecover(Duration considerElementsOlderThan,
 QueryOptions queryOptions)
                                    throws SBonitaReadException

retrieve ids of elements that need to be recovered Called on start node to set the flag to tell the engine to restart these flow nodes Should not be called when the engine is started! This does not retrieve SGatewayInstances

Parameters:

considerElementsOlderThan - consider elements older than that duration

queryOptions - used for pagination

Throws:

SBonitaReadException

getFlowNodeInstancesByIds

List<SFlowNodeInstance> getFlowNodeInstancesByIds(List<Long> ids)
                                           throws SBonitaReadException

Throws:

SBonitaReadException

getGatewayInstanceIdsToRecover

List<Long> getGatewayInstanceIdsToRecover(Duration considerElementsOlderThan,
 QueryOptions queryOptions)
                                   throws SBonitaReadException

Retrieve ids of SGatewayInstances that need to be recovered

Parameters:

queryOptions -

Returns:

Throws:

SBonitaReadException

getNumberOfFlowNodes

int getNumberOfFlowNodes(long rootContainerId)
                  throws SBonitaReadException

get the number of flow node is this root container

Parameters:

rootContainerId -

Returns:

the number of flow node

Throws:

SBonitaReadException

Since:

6.5

getSourceObjectIdsOfArchivedFlowNodeInstances

Set<Long> getSourceObjectIdsOfArchivedFlowNodeInstances(List<Long> sourceProcessInstanceIds)
                                                 throws SBonitaReadException

get all flow nodes contained in the list of root source process instance ids

Parameters:

sourceProcessInstanceIds - root source process instance ids

Returns:

list of root source process instance ids

Throws:

SBonitaReadException

deleteArchivedFlowNodeInstances

void deleteArchivedFlowNodeInstances(List<Long> sourceObjectIds)
                              throws SBonitaException

Throws:

SBonitaException

getFlowNodeInstancesByNameAndParentContainerId

List<SFlowNodeInstance> getFlowNodeInstancesByNameAndParentContainerId(String name,
 Long parentContainerId)
                                                                throws SBonitaReadException

Throws:

SBonitaReadException