org.jbpm.casemgmt.api

Interface CaseRuntimeDataService

public interface CaseRuntimeDataService

Provides access to case(s) and its runtime data such as:

• available cases
• available milestones
• available stages

Method Summary

Modifier and Type	Method and Description
Collection<org.jbpm.services.api.model.NodeInstanceDesc>	getActiveNodesForCase(String caseId, org.kie.internal.query.QueryContext queryContext) Returns active nodes in given case regardless in what process instance they belong to.
Collection<AdHocFragment>	getAdHocFragmentsForCase(String caseId) Returns list of AdHocFragments available in given case.
CaseDefinition	getCase(String deploymentId, String caseDefinitionId) Returns case definition identified by caseDefinitionId that belongs to given deploymentId.
Collection<CaseMilestoneInstance>	getCaseInstanceMilestones(String caseId, boolean achievedOnly, org.kie.internal.query.QueryContext queryContext) Returns milestones for given case instance, identified by case id.
Collection<CaseInstance>	getCaseInstances(List<Integer> statuses, org.kie.internal.query.QueryContext queryContext) Returns all available active case instances that match given statuses
Collection<CaseInstance>	getCaseInstances(org.kie.internal.query.QueryContext queryContext) Returns all available active case instances
Collection<CaseInstance>	getCaseInstancesByDefinition(String caseDefinitionId, List<Integer> statuses, org.kie.internal.query.QueryContext queryContext) Returns all available case instances;
Collection<CaseInstance>	getCaseInstancesByDeployment(String deploymentId, List<Integer> statuses, org.kie.internal.query.QueryContext queryContext) Returns all available case instances;
Collection<CaseInstance>	getCaseInstancesOwnedBy(String owner, List<Integer> statuses, org.kie.internal.query.QueryContext queryContext) Returns all case instances owned by given user
Collection<CaseStageInstance>	getCaseInstanceStages(String caseId, boolean activeOnly, org.kie.internal.query.QueryContext queryContext) Returns stages of given case instance, identified by case id.
Collection<CaseDefinition>	getCases(org.kie.internal.query.QueryContext queryContext) Returns available cases.
Collection<CaseDefinition>	getCases(String filter, org.kie.internal.query.QueryContext queryContext) Returns available cases which matching filter that applies to case name (usually represented by process id or name).
Collection<CaseDefinition>	getCasesByDeployment(String deploymentId, org.kie.internal.query.QueryContext queryContext) Returns available cases for given deployment id
List<org.kie.api.task.model.TaskSummary>	getCaseTasksAssignedAsBusinessAdmin(String caseId, String userId, List<org.kie.api.task.model.Status> status, org.kie.internal.query.QueryContext queryContext) Returns all tasks associated with given case id that are eligible for user to see as business admin role.
List<org.kie.api.task.model.TaskSummary>	getCaseTasksAssignedAsPotentialOwner(String caseId, String userId, List<org.kie.api.task.model.Status> status, org.kie.internal.query.QueryContext queryContext) Returns all tasks associated with given case id that are eligible for user to see.
List<org.kie.api.task.model.TaskSummary>	getCaseTasksAssignedAsStakeholder(String caseId, String userId, List<org.kie.api.task.model.Status> status, org.kie.internal.query.QueryContext queryContext) Returns all tasks associated with given case id that are eligible for user to see in task stakeholder role.
Collection<org.jbpm.services.api.model.ProcessInstanceDesc>	getProcessInstancesForCase(String caseId, List<Integer> states, org.kie.internal.query.QueryContext queryContext) Returns process instances found for given case id.
Collection<org.jbpm.services.api.model.ProcessInstanceDesc>	getProcessInstancesForCase(String caseId, org.kie.internal.query.QueryContext queryContext) Returns process instances found for given case id.

Method Detail

getCase

CaseDefinition getCase(String deploymentId,
                       String caseDefinitionId)

Returns case definition identified by caseDefinitionId that belongs to given deploymentId.

Parameters:

deploymentId - deployment identifier that case definition is part of

caseDefinitionId - id of the case

getCases

Collection<CaseDefinition> getCases(org.kie.internal.query.QueryContext queryContext)

Returns available cases.

Parameters:

queryContext - control parameters for the result e.g. sorting, paging

getCases

Collection<CaseDefinition> getCases(String filter,
                                    org.kie.internal.query.QueryContext queryContext)

Returns available cases which matching filter that applies to case name (usually represented by process id or name).

Parameters:

filter - filter for case name to narrow down results

queryContext - control parameters for the result e.g. sorting, paging

getCasesByDeployment

Collection<CaseDefinition> getCasesByDeployment(String deploymentId,
                                                org.kie.internal.query.QueryContext queryContext)

Returns available cases for given deployment id

Parameters:

deploymentId - deployment identifier that case definition is part of

queryContext - control parameters for the result e.g. sorting, paging

getProcessInstancesForCase

Collection<org.jbpm.services.api.model.ProcessInstanceDesc> getProcessInstancesForCase(String caseId,
                                                                                       org.kie.internal.query.QueryContext queryContext)

Returns process instances found for given case id.

Parameters:

caseId - unique id of the case

queryContext - control parameters for the result e.g. sorting, paging

getProcessInstancesForCase

Collection<org.jbpm.services.api.model.ProcessInstanceDesc> getProcessInstancesForCase(String caseId,
                                                                                       List<Integer> states,
                                                                                       org.kie.internal.query.QueryContext queryContext)

Returns process instances found for given case id.

Parameters:

caseId - unique id of the case

states - states representing process instance (active, completed, aborted)

queryContext - control parameters for the result e.g. sorting, paging

getCaseInstanceMilestones

Collection<CaseMilestoneInstance> getCaseInstanceMilestones(String caseId,
                                                            boolean achievedOnly,
                                                            org.kie.internal.query.QueryContext queryContext)

Returns milestones for given case instance, identified by case id.

Parameters:

caseId - unique id of the case

achievedOnly - filter option to return only these that have already been achieved

queryContext - control parameters for the result e.g. sorting, paging

getCaseInstanceStages

Collection<CaseStageInstance> getCaseInstanceStages(String caseId,
                                                    boolean activeOnly,
                                                    org.kie.internal.query.QueryContext queryContext)

Returns stages of given case instance, identified by case id.

Parameters:

caseId - unique id of the case

activeOnly - filter option to return only stages that are active

queryContext - control parameters for the result e.g. sorting, paging

getActiveNodesForCase

Collection<org.jbpm.services.api.model.NodeInstanceDesc> getActiveNodesForCase(String caseId,
                                                                               org.kie.internal.query.QueryContext queryContext)

Returns active nodes in given case regardless in what process instance they belong to.

Parameters:

caseId - unique id of the case

queryContext - control parameters for the result e.g. sorting, paging

getAdHocFragmentsForCase

Collection<AdHocFragment> getAdHocFragmentsForCase(String caseId)

Returns list of AdHocFragments available in given case. It includes all ad hoc fragments that are eligible for triggering - meaning it's container is active (case instance or stage)

Parameters:

caseId - unique id of the case

getCaseInstances

Collection<CaseInstance> getCaseInstances(org.kie.internal.query.QueryContext queryContext)

Returns all available active case instances

Parameters:

queryContext - control parameters for the result e.g. sorting, paging

getCaseInstances

Collection<CaseInstance> getCaseInstances(List<Integer> statuses,
                                          org.kie.internal.query.QueryContext queryContext)

Returns all available active case instances that match given statuses

Parameters:

statuses - list of statuses that case should be in to match

queryContext - control parameters for the result e.g. sorting, paging

getCaseInstancesByDeployment

Collection<CaseInstance> getCaseInstancesByDeployment(String deploymentId,
                                                      List<Integer> statuses,
                                                      org.kie.internal.query.QueryContext queryContext)

Returns all available case instances;

Parameters:

deploymentId - deployment identifier that case instance is part of

queryContext - control parameters for the result e.g. sorting, paging

getCaseInstancesByDefinition

Collection<CaseInstance> getCaseInstancesByDefinition(String caseDefinitionId,
                                                      List<Integer> statuses,
                                                      org.kie.internal.query.QueryContext queryContext)

Returns all available case instances;

Parameters:

caseDefinitionId - case definition id

queryContext - control parameters for the result e.g. sorting, paging

getCaseInstancesOwnedBy

Collection<CaseInstance> getCaseInstancesOwnedBy(String owner,
                                                 List<Integer> statuses,
                                                 org.kie.internal.query.QueryContext queryContext)

Returns all case instances owned by given user

Parameters:

queryContext - control parameters for the result e.g. sorting, paging

getCaseTasksAssignedAsPotentialOwner

List<org.kie.api.task.model.TaskSummary> getCaseTasksAssignedAsPotentialOwner(String caseId,
                                                                              String userId,
                                                                              List<org.kie.api.task.model.Status> status,
                                                                              org.kie.internal.query.QueryContext queryContext)

Returns all tasks associated with given case id that are eligible for user to see.

Parameters:

caseId - unique id of the case

userId - user id that the tasks should be available for

status - status of the task

queryContext - control parameters for the result e.g. sorting, paging

Returns:

list of tasks found for given case id and user

getCaseTasksAssignedAsBusinessAdmin

List<org.kie.api.task.model.TaskSummary> getCaseTasksAssignedAsBusinessAdmin(String caseId,
                                                                             String userId,
                                                                             List<org.kie.api.task.model.Status> status,
                                                                             org.kie.internal.query.QueryContext queryContext)

Returns all tasks associated with given case id that are eligible for user to see as business admin role.

Parameters:

caseId - unique id of the case

userId - user id that the tasks should be available for

status - status of the task

queryContext - control parameters for the result e.g. sorting, paging

Returns:

list of tasks found for given case id and user

getCaseTasksAssignedAsStakeholder

List<org.kie.api.task.model.TaskSummary> getCaseTasksAssignedAsStakeholder(String caseId,
                                                                           String userId,
                                                                           List<org.kie.api.task.model.Status> status,
                                                                           org.kie.internal.query.QueryContext queryContext)

Returns all tasks associated with given case id that are eligible for user to see in task stakeholder role.

Parameters:

caseId - unique id of the case

userId - user id that the tasks should be available for

status - status of the task

queryContext - control parameters for the result e.g. sorting, paging

Returns:

list of tasks found for given case id and user