org.eclipse.stardust.engine.api.ejb2
Interface RemoteQueryService

All Superinterfaces:

javax.ejb.EJBObject, java.rmi.Remote

public interface RemoteQueryService
extends javax.ejb.EJBObject

to set SessionProperties.DS_NAME_READ_ONLY used in DataValueBean

Method Summary

java.util.List<Department>	findAllDepartments(DepartmentInfo parent, OrganizationInfo organization) Retrieves all the departments satisfying the search criteria.
Department	findDepartment(DepartmentInfo parent, java.lang.String id, OrganizationInfo info) Searches for a department having the specified id in the scope defined by the parent department.
ActivityInstance	findFirstActivityInstance(ActivityInstanceQuery query) Retrieves the first ActivityInstance satisfying the criteria specified in the provided query.
Document	findFirstDocument(DocumentQuery query) Retrieves the first document satisfying the criteria specified in the provided query.
LogEntry	findFirstLogEntry(LogEntryQuery query) Retrieves the first LogEntry satisfying the criteria specified in the provided query.
ProcessInstance	findFirstProcessInstance(ProcessInstanceQuery query) Retrieves the first ProcessInstance satisfying the criteria specified in the provided query.
User	findFirstUser(UserQuery query) Retrieves the first User satisfying the criteria specified in the provided query.
UserGroup	findFirstUserGroup(UserGroupQuery query) Retrieves the first UserGroup satisfying the criteria specified in the provided query.
DeployedModel	getActiveModel() Deprecated. This method returns the active model with the highest priority. Use getModels(DeployedModelQuery.findActive( )) to retrieve all active models.
DeployedModelDescription	getActiveModelDescription() Deprecated. This method returns the description of the active model with the highest priority. Use getModels(DeployedModelQuery.findActive( )) to retrieve all active models.
long	getActivityInstancesCount(ActivityInstanceQuery query) Counts the number of activity instances satisfying the criteria specified in the provided query.
ActivityInstances	getAllActivityInstances(ActivityInstanceQuery query) Retrieves all activity instances satisfying the criteria specified in the provided query.
java.util.List<DeployedModelDescription>	getAllAliveModelDescriptions() Deprecated. Use getModels(DeployedModelQuery.findInState(DeployedModelQuery.ALIVE)).
org.eclipse.stardust.engine.api.runtime.DataQueryResult	getAllData(DataQuery query) Retrieves all data satisfying the criteria specified in the provided query.
Documents	getAllDocuments(DocumentQuery query) Retrieves all documents satisfying the criteria specified in the provided query.
LogEntries	getAllLogEntries(LogEntryQuery query) Retrieves all log entries satisfying the criteria specified in the provided query.
java.util.List<DeployedModelDescription>	getAllModelDescriptions() Deprecated. Use getModels(DeployedModelQuery.findAll()).
java.util.List<Participant>	getAllParticipants() Retrieves all the participants from the active model.
java.util.List<Participant>	getAllParticipants(long modelOID) Retrieves all participants defined in the specified model.
java.util.List<Preferences>	getAllPreferences(PreferenceQuery preferenceQuery) Retrieves preferences satisfying the criteria specified in the provided query.
java.util.List<ProcessDefinition>	getAllProcessDefinitions() Retrieves all process definitions for the active model.
java.util.List<ProcessDefinition>	getAllProcessDefinitions(long modelOID) Retrieves all the process definitions contained in the specified model.
ProcessInstances	getAllProcessInstances(ProcessInstanceQuery query) Retrieves all process instances satisfying the criteria specified in the provided query.
UserGroups	getAllUserGroups(UserGroupQuery query) Retrieves all user groups satisfying the criteria specified in the provided query.
Users	getAllUsers(UserQuery query) Retrieves all users satisfying the criteria specified in the provided query.
java.util.List<ActivityInstance>	getAuditTrail(long processInstanceOID) Returns all performed activity instances for the specified process instance.
long	getLogEntriesCount(LogEntryQuery query) Counts the number of log entries satisfying the criteria specified in the provided query.
DeployedModel	getModel(long modelOID) Retrieves the specified model.
DeployedModel	getModel(long modelOID, boolean computeAliveness) Retrieves the specified model.
java.lang.String	getModelAsXML(long modelOID) Retrieves the XML representation of the specified model.
DeployedModelDescription	getModelDescription(long modelOID) Retrieves the description of the specified model.
Models	getModels(DeployedModelQuery query) Retrieves the model descriptions satisfying the criteria specified in the provided query.
Participant	getParticipant(long modelOID, java.lang.String id) Retrieves a participant from a specified model.
Participant	getParticipant(java.lang.String id) Retrieves a specific participant from the active model.
java.util.List<Permission>	getPermissions() Retrieves all permissions the current user has on this service.
Preferences	getPreferences(PreferenceScope scope, java.lang.String moduleId, java.lang.String preferencesId) Retrieves preferences from the given scope.
ProcessDefinition	getProcessDefinition(long modelOID, java.lang.String id) Retrieves a process definition from the specified model.
ProcessDefinition	getProcessDefinition(java.lang.String id) Retrieves the specified process definition from the active model.
org.eclipse.stardust.engine.api.runtime.ProcessDefinitions	getProcessDefinitions(ProcessDefinitionQuery query)
long	getProcessInstancesCount(ProcessInstanceQuery query) Counts the number of process instances satisfying the criteria specified in the provided query.
RuntimeEnvironmentInfo	getRuntimeEnvironmentInfo() Retrieves the information about the deployed runtime environment ( e.g.
byte[]	getSchemaDefinition(long modelOID, java.lang.String typeDeclarationId) Retrieves XSD schema of the specified type declaration serialized into a byte[].
long	getUserGroupsCount(UserGroupQuery query) Counts the number of user groups satisfying the criteria specified in the provided query.
long	getUsersCount(UserQuery query) Counts the number of users satisfying the criteria specified in the provided query.
void	login(java.lang.String userId, java.lang.String password)
void	login(java.lang.String userId, java.lang.String password, java.util.Map properties)
void	logout()
boolean	wasRedeployed(long modelOid, int revision) Determines if the model was redeployed, i.e.

Methods inherited from interface javax.ejb.EJBObject

getEJBHome, getHandle, getPrimaryKey, isIdentical, remove

Method Detail

getUsersCount

long getUsersCount(UserQuery query)
                   throws WorkflowException,
                          java.rmi.RemoteException

Counts the number of users satisfying the criteria specified in the provided query.

Parameters:

query - the user query.

Returns:

the user count.

Throws:

WorkflowException - as a wrapper for org.eclipse.stardust.engine.api.ejb2.PublicExceptions and org.eclipse.stardust.engine.api.ejb2.ResourceExceptions

java.rmi.RemoteException

See Also:

QueryService.getUsersCount( org.eclipse.stardust.engine.api.query.UserQuery query)

getUserGroupsCount

long getUserGroupsCount(UserGroupQuery query)
                        throws WorkflowException,
                               java.rmi.RemoteException

Counts the number of user groups satisfying the criteria specified in the provided query.

Parameters:

query - the user group query.

Returns:

the user group count.

Throws:

WorkflowException - as a wrapper for org.eclipse.stardust.engine.api.ejb2.PublicExceptions and org.eclipse.stardust.engine.api.ejb2.ResourceExceptions

java.rmi.RemoteException

See Also:

QueryService.getUserGroupsCount( org.eclipse.stardust.engine.api.query.UserGroupQuery query)

getProcessInstancesCount

long getProcessInstancesCount(ProcessInstanceQuery query)
                              throws WorkflowException,
                                     java.rmi.RemoteException

Counts the number of process instances satisfying the criteria specified in the provided query.

Parameters:

query - the process instance query.

Returns:

the process instance count.

Throws:

IllegalOperationException - if no attributeName (XPath) is specified in a DataFilter for queries on a structured data Instances of IllegalOperationException will be wrapped inside WorkflowException.

IllegalOperationException - if attributeName (XPath) is specified in a DataFilter for queries on a non-structured data Instances of IllegalOperationException will be wrapped inside WorkflowException.

IllegalOperationException - if attributeName (XPath) specified in a DataFilter contains an invalid XPath Instances of IllegalOperationException will be wrapped inside WorkflowException.

WorkflowException - as a wrapper for org.eclipse.stardust.engine.api.ejb2.PublicExceptions and org.eclipse.stardust.engine.api.ejb2.ResourceExceptions

java.rmi.RemoteException

See Also:

QueryService.getProcessInstancesCount( org.eclipse.stardust.engine.api.query.ProcessInstanceQuery query)

getActivityInstancesCount

long getActivityInstancesCount(ActivityInstanceQuery query)
                               throws WorkflowException,
                                      java.rmi.RemoteException

Counts the number of activity instances satisfying the criteria specified in the provided query.

Parameters:

query - the activity instance query.

Returns:

the activity instance count.

Throws:

IllegalOperationException - if no attributeName (XPath) is specified in a DataFilter for queries on a structured data Instances of IllegalOperationException will be wrapped inside WorkflowException.

IllegalOperationException - if attributeName (XPath) is specified in a DataFilter for queries on a non-structured data Instances of IllegalOperationException will be wrapped inside WorkflowException.

IllegalOperationException - if attributeName (XPath) specified in a DataFilter contains an invalid XPath Instances of IllegalOperationException will be wrapped inside WorkflowException.

WorkflowException - as a wrapper for org.eclipse.stardust.engine.api.ejb2.PublicExceptions and org.eclipse.stardust.engine.api.ejb2.ResourceExceptions

java.rmi.RemoteException

See Also:

QueryService.getActivityInstancesCount( org.eclipse.stardust.engine.api.query.ActivityInstanceQuery query)

getLogEntriesCount

long getLogEntriesCount(LogEntryQuery query)
                        throws WorkflowException,
                               java.rmi.RemoteException

Counts the number of log entries satisfying the criteria specified in the provided query.

Parameters:

query - the log entry query.

Returns:

the log entry count.

Throws:

WorkflowException - as a wrapper for org.eclipse.stardust.engine.api.ejb2.PublicExceptions and org.eclipse.stardust.engine.api.ejb2.ResourceExceptions

java.rmi.RemoteException

See Also:

QueryService.getLogEntriesCount( org.eclipse.stardust.engine.api.query.LogEntryQuery query)

getAllUsers

Users getAllUsers(UserQuery query)
                  throws WorkflowException,
                         java.rmi.RemoteException

Retrieves all users satisfying the criteria specified in the provided query.

Parameters:

query - the user query.

Returns:

a List of User objects.

Throws:

WorkflowException - as a wrapper for org.eclipse.stardust.engine.api.ejb2.PublicExceptions and org.eclipse.stardust.engine.api.ejb2.ResourceExceptions

java.rmi.RemoteException

See Also:

QueryService.getAllUsers( org.eclipse.stardust.engine.api.query.UserQuery query)

getAllUserGroups

UserGroups getAllUserGroups(UserGroupQuery query)
                            throws WorkflowException,
                                   java.rmi.RemoteException

Retrieves all user groups satisfying the criteria specified in the provided query.

Parameters:

query - the user group query.

Returns:

A list of UserGroup objects.

Throws:

WorkflowException - as a wrapper for org.eclipse.stardust.engine.api.ejb2.PublicExceptions and org.eclipse.stardust.engine.api.ejb2.ResourceExceptions

java.rmi.RemoteException

See Also:

QueryService.getAllUserGroups( org.eclipse.stardust.engine.api.query.UserGroupQuery query)

getAllProcessInstances

ProcessInstances getAllProcessInstances(ProcessInstanceQuery query)
                                        throws WorkflowException,
                                               java.rmi.RemoteException

Retrieves all process instances satisfying the criteria specified in the provided query.

Parameters:

query - the process instance query.

Returns:

a List of ProcessInstance objects.

Throws:

IllegalOperationException - if no attributeName (XPath) is specified in a DataFilter for queries on a structured data Instances of IllegalOperationException will be wrapped inside WorkflowException.

IllegalOperationException - if attributeName (XPath) is specified in a DataFilter for queries on a non-structured data Instances of IllegalOperationException will be wrapped inside WorkflowException.

IllegalOperationException - if attributeName (XPath) specified in a DataFilter contains an invalid XPath Instances of IllegalOperationException will be wrapped inside WorkflowException.

WorkflowException - as a wrapper for org.eclipse.stardust.engine.api.ejb2.PublicExceptions and org.eclipse.stardust.engine.api.ejb2.ResourceExceptions

java.rmi.RemoteException

See Also:

QueryService.getAllProcessInstances( org.eclipse.stardust.engine.api.query.ProcessInstanceQuery query)

getAllActivityInstances

ActivityInstances getAllActivityInstances(ActivityInstanceQuery query)
                                          throws WorkflowException,
                                                 java.rmi.RemoteException

Retrieves all activity instances satisfying the criteria specified in the provided query.

Parameters:

query - the activity instance query.

Returns:

a List of ActivityInstance objects.

Throws:

IllegalOperationException - if no attributeName (XPath) is specified in a DataFilter for queries on a structured data Instances of IllegalOperationException will be wrapped inside WorkflowException.

IllegalOperationException - if attributeName (XPath) is specified in a DataFilter for queries on a non-structured data Instances of IllegalOperationException will be wrapped inside WorkflowException.

IllegalOperationException - if attributeName (XPath) specified in a DataFilter contains an invalid XPath Instances of IllegalOperationException will be wrapped inside WorkflowException.

WorkflowException - as a wrapper for org.eclipse.stardust.engine.api.ejb2.PublicExceptions and org.eclipse.stardust.engine.api.ejb2.ResourceExceptions

java.rmi.RemoteException

See Also:

QueryService.getAllActivityInstances( org.eclipse.stardust.engine.api.query.ActivityInstanceQuery query)

getAllLogEntries

LogEntries getAllLogEntries(LogEntryQuery query)
                            throws WorkflowException,
                                   java.rmi.RemoteException

Retrieves all log entries satisfying the criteria specified in the provided query.

Parameters:

query - the log entry query.

Returns:

a List of LogEntry objects.

Throws:

WorkflowException - as a wrapper for org.eclipse.stardust.engine.api.ejb2.PublicExceptions and org.eclipse.stardust.engine.api.ejb2.ResourceExceptions

java.rmi.RemoteException

See Also:

QueryService.getAllLogEntries( org.eclipse.stardust.engine.api.query.LogEntryQuery query)

findFirstUser

User findFirstUser(UserQuery query)
                   throws WorkflowException,
                          java.rmi.RemoteException

Retrieves the first User satisfying the criteria specified in the provided query.

Parameters:

query - the user query.

Returns:

the first matching user.

Throws:

org.eclipse.stardust.common.error.ObjectNotFoundException - if no matching user is found. Instances of ObjectNotFoundException will be wrapped inside WorkflowException.

WorkflowException - as a wrapper for org.eclipse.stardust.engine.api.ejb2.PublicExceptions and org.eclipse.stardust.engine.api.ejb2.ResourceExceptions

java.rmi.RemoteException

See Also:

QueryService.findFirstUser( org.eclipse.stardust.engine.api.query.UserQuery query)

findFirstUserGroup

UserGroup findFirstUserGroup(UserGroupQuery query)
                             throws WorkflowException,
                                    java.rmi.RemoteException

Retrieves the first UserGroup satisfying the criteria specified in the provided query.

Parameters:

query - the user group query.

Returns:

the first matching user group.

Throws:

org.eclipse.stardust.common.error.ObjectNotFoundException - if no matching user group is found. Instances of ObjectNotFoundException will be wrapped inside WorkflowException.

WorkflowException - as a wrapper for org.eclipse.stardust.engine.api.ejb2.PublicExceptions and org.eclipse.stardust.engine.api.ejb2.ResourceExceptions

java.rmi.RemoteException

See Also:

QueryService.findFirstUserGroup( org.eclipse.stardust.engine.api.query.UserGroupQuery query)

findFirstProcessInstance

ProcessInstance findFirstProcessInstance(ProcessInstanceQuery query)
                                         throws WorkflowException,
                                                java.rmi.RemoteException

Retrieves the first ProcessInstance satisfying the criteria specified in the provided query.

Parameters:

query - the process instance query.

Returns:

the first matching process instance.

Throws:

ObjectNotFoundException - if no matching process instance is found. Instances of ObjectNotFoundException will be wrapped inside WorkflowException.

IllegalOperationException - if no attributeName (XPath) is specified in a DataFilter for queries on a structured data Instances of IllegalOperationException will be wrapped inside WorkflowException.

IllegalOperationException - if attributeName (XPath) is specified in a DataFilter for queries on a non-structured data Instances of IllegalOperationException will be wrapped inside WorkflowException.

IllegalOperationException - if attributeName (XPath) specified in a DataFilter contains an invalid XPath Instances of IllegalOperationException will be wrapped inside WorkflowException.

WorkflowException - as a wrapper for org.eclipse.stardust.engine.api.ejb2.PublicExceptions and org.eclipse.stardust.engine.api.ejb2.ResourceExceptions

java.rmi.RemoteException

See Also:

QueryService.findFirstProcessInstance( org.eclipse.stardust.engine.api.query.ProcessInstanceQuery query)

findFirstActivityInstance

ActivityInstance findFirstActivityInstance(ActivityInstanceQuery query)
                                           throws WorkflowException,
                                                  java.rmi.RemoteException

Retrieves the first ActivityInstance satisfying the criteria specified in the provided query.

Parameters:

query - the activity instance query.

Returns:

the first matching activity instance.

Throws:

ObjectNotFoundException - if no matching activity instance is found. Instances of ObjectNotFoundException will be wrapped inside WorkflowException.

IllegalOperationException - if no attributeName (XPath) is specified in a DataFilter for queries on a structured data Instances of IllegalOperationException will be wrapped inside WorkflowException.

IllegalOperationException - if attributeName (XPath) is specified in a DataFilter for queries on a non-structured data Instances of IllegalOperationException will be wrapped inside WorkflowException.

IllegalOperationException - if attributeName (XPath) specified in a DataFilter contains an invalid XPath Instances of IllegalOperationException will be wrapped inside WorkflowException.

WorkflowException - as a wrapper for org.eclipse.stardust.engine.api.ejb2.PublicExceptions and org.eclipse.stardust.engine.api.ejb2.ResourceExceptions

java.rmi.RemoteException

See Also:

QueryService.findFirstActivityInstance( org.eclipse.stardust.engine.api.query.ActivityInstanceQuery query)

findFirstLogEntry

LogEntry findFirstLogEntry(LogEntryQuery query)
                           throws WorkflowException,
                                  java.rmi.RemoteException

Retrieves the first LogEntry satisfying the criteria specified in the provided query.

Parameters:

query - the log entry query.

Returns:

the first matching log entry.

Throws:

org.eclipse.stardust.common.error.ObjectNotFoundException - if no matching log entry is found. Instances of ObjectNotFoundException will be wrapped inside WorkflowException.

WorkflowException - as a wrapper for org.eclipse.stardust.engine.api.ejb2.PublicExceptions and org.eclipse.stardust.engine.api.ejb2.ResourceExceptions

java.rmi.RemoteException

See Also:

QueryService.findFirstLogEntry( org.eclipse.stardust.engine.api.query.LogEntryQuery query)

getAuditTrail

java.util.List<ActivityInstance> getAuditTrail(long processInstanceOID)
                                               throws WorkflowException,
                                                      java.rmi.RemoteException

Returns all performed activity instances for the specified process instance.

Parameters:

processInstanceOID - the OID of the process instance from where we retrieve the audit trail.

Returns:

a List of ActivityInstance objects.

Throws:

org.eclipse.stardust.common.error.ObjectNotFoundException - if there is no process instance with the specified OID. Instances of ObjectNotFoundException will be wrapped inside WorkflowException.

WorkflowException - as a wrapper for org.eclipse.stardust.engine.api.ejb2.PublicExceptions and org.eclipse.stardust.engine.api.ejb2.ResourceExceptions

java.rmi.RemoteException

See Also:

QueryService.getAuditTrail( long processInstanceOID)

getAllModelDescriptions

java.util.List<DeployedModelDescription> getAllModelDescriptions()
                                                                 throws WorkflowException,
                                                                        java.rmi.RemoteException

Deprecated. Use getModels(DeployedModelQuery.findAll()).

Retrieves the list of model descriptions for all deployed models.

Returns:

a List of DeployedModelDescription objects.

Throws:

WorkflowException - as a wrapper for org.eclipse.stardust.engine.api.ejb2.PublicExceptions and org.eclipse.stardust.engine.api.ejb2.ResourceExceptions

java.rmi.RemoteException

See Also:

QueryService.getAllModelDescriptions()

getAllAliveModelDescriptions

java.util.List<DeployedModelDescription> getAllAliveModelDescriptions()
                                                                      throws WorkflowException,
                                                                             java.rmi.RemoteException

Deprecated. Use getModels(DeployedModelQuery.findInState(DeployedModelQuery.ALIVE)).

Retrieves the list of model descriptions for all alive models. Whereby alive models are models with non-completed and non-aborted processes plus the active model.

Returns:

a List of DeployedModelDescription objects.

Throws:

WorkflowException - as a wrapper for org.eclipse.stardust.engine.api.ejb2.PublicExceptions and org.eclipse.stardust.engine.api.ejb2.ResourceExceptions

java.rmi.RemoteException

See Also:

QueryService.getAllAliveModelDescriptions()

getActiveModelDescription

DeployedModelDescription getActiveModelDescription()
                                                   throws WorkflowException,
                                                          java.rmi.RemoteException

Deprecated. This method returns the description of the active model with the highest priority. Use getModels(DeployedModelQuery.findActive( )) to retrieve all active models.

Retrieves the current active model description.

Returns:

the description of the active model.

Throws:

org.eclipse.stardust.common.error.ObjectNotFoundException - if there is no active model. Instances of ObjectNotFoundException will be wrapped inside WorkflowException.

WorkflowException - as a wrapper for org.eclipse.stardust.engine.api.ejb2.PublicExceptions and org.eclipse.stardust.engine.api.ejb2.ResourceExceptions

java.rmi.RemoteException

See Also:

QueryService.getActiveModelDescription()

getModels

Models getModels(DeployedModelQuery query)
                 throws WorkflowException,
                        java.rmi.RemoteException

Retrieves the model descriptions satisfying the criteria specified in the provided query.

Parameters:

query - the deployed model query.

Returns:

a List of DeployedModelDescription objects.

Throws:

WorkflowException - as a wrapper for org.eclipse.stardust.engine.api.ejb2.PublicExceptions and org.eclipse.stardust.engine.api.ejb2.ResourceExceptions

java.rmi.RemoteException

See Also:

QueryService.getModels( org.eclipse.stardust.engine.api.query.DeployedModelQuery query)

getModelDescription

DeployedModelDescription getModelDescription(long modelOID)
                                             throws WorkflowException,
                                                    java.rmi.RemoteException

Retrieves the description of the specified model.

Parameters:

modelOID - the oid of the model to retrieve.

Returns:

the description of the specified model.

Throws:

org.eclipse.stardust.common.error.ObjectNotFoundException - if there is no model with the specified OID. Instances of ObjectNotFoundException will be wrapped inside WorkflowException.

WorkflowException - as a wrapper for org.eclipse.stardust.engine.api.ejb2.PublicExceptions and org.eclipse.stardust.engine.api.ejb2.ResourceExceptions

java.rmi.RemoteException

See Also:

QueryService.getModelDescription( long modelOID)

wasRedeployed

boolean wasRedeployed(long modelOid,
                      int revision)
                      throws WorkflowException,
                             java.rmi.RemoteException

Determines if the model was redeployed, i.e. if a more recent revision than the provided one is available.

Parameters:

modelOid - The OID of the model to be checked..

revision - The currently retrieved revision of the model.

Returns:

true if a more recent revision of the model is available, false if not.

Throws:

WorkflowException - as a wrapper for org.eclipse.stardust.engine.api.ejb2.PublicExceptions and org.eclipse.stardust.engine.api.ejb2.ResourceExceptions

java.rmi.RemoteException

See Also:

QueryService.wasRedeployed( long modelOid, int revision)

getModel

DeployedModel getModel(long modelOID)
                       throws WorkflowException,
                              java.rmi.RemoteException

Retrieves the specified model.

Parameters:

modelOID - the oid of the model to retrieve.

Returns:

the specified model.

Throws:

org.eclipse.stardust.common.error.ObjectNotFoundException - if there is no model with the specified OID. Instances of ObjectNotFoundException will be wrapped inside WorkflowException.

WorkflowException - as a wrapper for org.eclipse.stardust.engine.api.ejb2.PublicExceptions and org.eclipse.stardust.engine.api.ejb2.ResourceExceptions

java.rmi.RemoteException

See Also:

QueryService.getModel(long modelOID)

getModel

DeployedModel getModel(long modelOID,
                       boolean computeAliveness)
                       throws WorkflowException,
                              java.rmi.RemoteException

Retrieves the specified model.

Parameters:

modelOID - the oid of the model to retrieve.

computeAliveness - whether the aliveness of the model should be computed or not

Returns:

the specified model.

Throws:

org.eclipse.stardust.common.error.ObjectNotFoundException - if there is no model with the specified OID. Instances of ObjectNotFoundException will be wrapped inside WorkflowException.

WorkflowException - as a wrapper for org.eclipse.stardust.engine.api.ejb2.PublicExceptions and org.eclipse.stardust.engine.api.ejb2.ResourceExceptions

java.rmi.RemoteException

See Also:

QueryService.getModel( long modelOID, boolean computeAliveness)

getActiveModel

DeployedModel getActiveModel()
                             throws WorkflowException,
                                    java.rmi.RemoteException

Deprecated. This method returns the active model with the highest priority. Use getModels(DeployedModelQuery.findActive( )) to retrieve all active models.

Retrieves the current active model.

Returns:

the active model.

Throws:

org.eclipse.stardust.common.error.ObjectNotFoundException - if there is no active model. Instances of ObjectNotFoundException will be wrapped inside WorkflowException.

WorkflowException - as a wrapper for org.eclipse.stardust.engine.api.ejb2.PublicExceptions and org.eclipse.stardust.engine.api.ejb2.ResourceExceptions

java.rmi.RemoteException

See Also:

QueryService.getActiveModel()

getModelAsXML

java.lang.String getModelAsXML(long modelOID)
                               throws WorkflowException,
                                      java.rmi.RemoteException

Retrieves the XML representation of the specified model.

Parameters:

modelOID - the oid of the model to retrieve.

Returns:

A string containing the XML representation of the model.

Throws:

org.eclipse.stardust.common.error.ObjectNotFoundException - if there is no model with the specified OID. Instances of ObjectNotFoundException will be wrapped inside WorkflowException.

WorkflowException - as a wrapper for org.eclipse.stardust.engine.api.ejb2.PublicExceptions and org.eclipse.stardust.engine.api.ejb2.ResourceExceptions

java.rmi.RemoteException

See Also:

QueryService.getModelAsXML(long modelOID)

getAllProcessDefinitions

java.util.List<ProcessDefinition> getAllProcessDefinitions(long modelOID)
                                                           throws WorkflowException,
                                                                  java.rmi.RemoteException

Retrieves all the process definitions contained in the specified model.

Parameters:

modelOID - the oid of the model.

Returns:

a List of ProcessDefinition objects.

Throws:

org.eclipse.stardust.common.error.ObjectNotFoundException - if there is no model with the specified OID. Instances of ObjectNotFoundException will be wrapped inside WorkflowException.

WorkflowException - as a wrapper for org.eclipse.stardust.engine.api.ejb2.PublicExceptions and org.eclipse.stardust.engine.api.ejb2.ResourceExceptions

java.rmi.RemoteException

See Also:

QueryService.getAllProcessDefinitions( long modelOID)

getProcessDefinition

ProcessDefinition getProcessDefinition(long modelOID,
                                       java.lang.String id)
                                       throws WorkflowException,
                                              java.rmi.RemoteException

Retrieves a process definition from the specified model.

Parameters:

modelOID - the oid of the model.

id - the id of the process definition.

Returns:

the process definition.

Throws:

ObjectNotFoundException - if there is no model with the specified OID or there is no process definition with the specified id in the model. Instances of ObjectNotFoundException will be wrapped inside WorkflowException.

WorkflowException - as a wrapper for org.eclipse.stardust.engine.api.ejb2.PublicExceptions and org.eclipse.stardust.engine.api.ejb2.ResourceExceptions

java.rmi.RemoteException

See Also:

QueryService.getProcessDefinition( long modelOID, java.lang.String id)

getAllProcessDefinitions

java.util.List<ProcessDefinition> getAllProcessDefinitions()
                                                           throws WorkflowException,
                                                                  java.rmi.RemoteException

Retrieves all process definitions for the active model.

Returns:

a List of ProcessDefinition objects.

Throws:

org.eclipse.stardust.common.error.ObjectNotFoundException - if there is no active model. Instances of ObjectNotFoundException will be wrapped inside WorkflowException.

WorkflowException - as a wrapper for org.eclipse.stardust.engine.api.ejb2.PublicExceptions and org.eclipse.stardust.engine.api.ejb2.ResourceExceptions

java.rmi.RemoteException

See Also:

QueryService.getAllProcessDefinitions()

getProcessDefinition

ProcessDefinition getProcessDefinition(java.lang.String id)
                                       throws WorkflowException,
                                              java.rmi.RemoteException

Retrieves the specified process definition from the active model.

Parameters:

id - the id of the process definition.

Returns:

the process definition.

Throws:

org.eclipse.stardust.common.error.ObjectNotFoundException - if there is no active model or if the active model does not contain the requested process definition. Instances of ObjectNotFoundException will be wrapped inside WorkflowException.

WorkflowException - as a wrapper for org.eclipse.stardust.engine.api.ejb2.PublicExceptions and org.eclipse.stardust.engine.api.ejb2.ResourceExceptions

java.rmi.RemoteException

See Also:

QueryService.getProcessDefinition( java.lang.String id)

getProcessDefinitions

org.eclipse.stardust.engine.api.runtime.ProcessDefinitions getProcessDefinitions(ProcessDefinitionQuery query)
                                                                                 throws WorkflowException,
                                                                                        java.rmi.RemoteException

Throws:

WorkflowException - as a wrapper for org.eclipse.stardust.engine.api.ejb2.PublicExceptions and org.eclipse.stardust.engine.api.ejb2.ResourceExceptions

java.rmi.RemoteException

See Also:

QueryService.getProcessDefinitions( org.eclipse.stardust.engine.api.query.ProcessDefinitionQuery query)

getAllData

org.eclipse.stardust.engine.api.runtime.DataQueryResult getAllData(DataQuery query)
                                                                   throws WorkflowException,
                                                                          java.rmi.RemoteException

Retrieves all data satisfying the criteria specified in the provided query.

Parameters:

query - The DataQuery.

Returns:

A list of Data objects.

Throws:

WorkflowException - as a wrapper for org.eclipse.stardust.engine.api.ejb2.PublicExceptions and org.eclipse.stardust.engine.api.ejb2.ResourceExceptions

java.rmi.RemoteException

See Also:

QueryService.getAllData( org.eclipse.stardust.engine.api.query.DataQuery query)

getAllParticipants

java.util.List<Participant> getAllParticipants(long modelOID)
                                               throws WorkflowException,
                                                      java.rmi.RemoteException

Retrieves all participants defined in the specified model.

Parameters:

modelOID - the oid of the model.

Returns:

a List of Participant objects.

Throws:

org.eclipse.stardust.common.error.ObjectNotFoundException - if there is no model with the specified oid. Instances of ObjectNotFoundException will be wrapped inside WorkflowException.

WorkflowException - as a wrapper for org.eclipse.stardust.engine.api.ejb2.PublicExceptions and org.eclipse.stardust.engine.api.ejb2.ResourceExceptions

java.rmi.RemoteException

See Also:

QueryService.getAllParticipants(long modelOID)

getParticipant

Participant getParticipant(long modelOID,
                           java.lang.String id)
                           throws WorkflowException,
                                  java.rmi.RemoteException

Retrieves a participant from a specified model.

Parameters:

modelOID - the oid of the model.

id - the id of the participant.

Returns:

the participant.

Throws:

ObjectNotFoundException - if there is no model with the specified oid, or the model does not contains the requested participant. Instances of ObjectNotFoundException will be wrapped inside WorkflowException.

WorkflowException - as a wrapper for org.eclipse.stardust.engine.api.ejb2.PublicExceptions and org.eclipse.stardust.engine.api.ejb2.ResourceExceptions

java.rmi.RemoteException

See Also:

QueryService.getParticipant( long modelOID, java.lang.String id)

getAllParticipants

java.util.List<Participant> getAllParticipants()
                                               throws WorkflowException,
                                                      java.rmi.RemoteException

Retrieves all the participants from the active model.

Returns:

a List of Participant objects.

Throws:

org.eclipse.stardust.common.error.ObjectNotFoundException - if there is no active model. Instances of ObjectNotFoundException will be wrapped inside WorkflowException.

WorkflowException - as a wrapper for org.eclipse.stardust.engine.api.ejb2.PublicExceptions and org.eclipse.stardust.engine.api.ejb2.ResourceExceptions

java.rmi.RemoteException

See Also:

QueryService.getAllParticipants()

getParticipant

Participant getParticipant(java.lang.String id)
                           throws WorkflowException,
                                  java.rmi.RemoteException

Retrieves a specific participant from the active model.

Parameters:

id - the id of the participant.

Returns:

the participant.

Throws:

ObjectNotFoundException - if there is no active model, or if the active model does not contain the requested participant. Instances of ObjectNotFoundException will be wrapped inside WorkflowException.

WorkflowException - as a wrapper for org.eclipse.stardust.engine.api.ejb2.PublicExceptions and org.eclipse.stardust.engine.api.ejb2.ResourceExceptions

java.rmi.RemoteException

See Also:

QueryService.getParticipant( java.lang.String id)

getPermissions

java.util.List<Permission> getPermissions()
                                          throws WorkflowException,
                                                 java.rmi.RemoteException

Retrieves all permissions the current user has on this service.

Returns:

a list of permission ids.

Throws:

WorkflowException - as a wrapper for org.eclipse.stardust.engine.api.ejb2.PublicExceptions and org.eclipse.stardust.engine.api.ejb2.ResourceExceptions

java.rmi.RemoteException

See Also:

QueryService.getPermissions()

getSchemaDefinition

byte[] getSchemaDefinition(long modelOID,
                           java.lang.String typeDeclarationId)
                           throws WorkflowException,
                                  java.rmi.RemoteException

Retrieves XSD schema of the specified type declaration serialized into a byte[].

Parameters:

modelOID - the oid of the model.

typeDeclarationId - the id of the type declaration.

Returns:

XSD schema of this type declaration

Throws:

ObjectNotFoundException - if there is no active model, or if the active model does not contain the requested type declaration. Instances of ObjectNotFoundException will be wrapped inside WorkflowException.

WorkflowException - as a wrapper for org.eclipse.stardust.engine.api.ejb2.PublicExceptions and org.eclipse.stardust.engine.api.ejb2.ResourceExceptions

java.rmi.RemoteException

See Also:

QueryService.getSchemaDefinition( long modelOID, java.lang.String typeDeclarationId)

findAllDepartments

java.util.List<Department> findAllDepartments(DepartmentInfo parent,
                                              OrganizationInfo organization)
                                              throws WorkflowException,
                                                     java.rmi.RemoteException

Retrieves all the departments satisfying the search criteria. The search is performed as following:

• if both parent and organization are null, then the result contains all top level departments, regardless of the organization to which they are assigned.
• if parent is not null but the organization is null, then the result contains all direct children of the parent department, regardless of the organization to which they are assigned.
• if parent is null but the organization is not null, then the result contains all departments assigned to the organization, regardless of their parent department.
• if both parent and organization are not null, then the result contains all departments assigned to the organization, that have as direct parent the specified department.

Parameters:

parent - the parent department.

organization - the organization to which the retrieved departments are assigned.

Returns:

the list of departments. The list can be empty if no departments are matching the search criteria.

Throws:

ObjectNotFoundException - if either the parent or the organization could not be resolved. Instances of ObjectNotFoundException will be wrapped inside WorkflowException.

WorkflowException - as a wrapper for org.eclipse.stardust.engine.api.ejb2.PublicExceptions and org.eclipse.stardust.engine.api.ejb2.ResourceExceptions

java.rmi.RemoteException

See Also:

QueryService.findAllDepartments( org.eclipse.stardust.engine.api.runtime.DepartmentInfo parent, org.eclipse.stardust.engine.api.model.OrganizationInfo organization)

findDepartment

Department findDepartment(DepartmentInfo parent,
                          java.lang.String id,
                          OrganizationInfo info)
                          throws WorkflowException,
                                 java.rmi.RemoteException

Searches for a department having the specified id in the scope defined by the parent department.

Parameters:

parent - the search scope. It can be null, in which case the search scope is the top level.

id - the id of the department. Must not be null or empty.

organization - the organization to which the retrieved departments are assigned.

Returns:

the department having the specified id.

Throws:

ObjectNotFoundException - if the parent could not be resolved or if the specified id is null or empty or if there is no department with the specified id in the parent scope. Instances of ObjectNotFoundException will be wrapped inside WorkflowException.

WorkflowException - as a wrapper for org.eclipse.stardust.engine.api.ejb2.PublicExceptions and org.eclipse.stardust.engine.api.ejb2.ResourceExceptions

java.rmi.RemoteException

See Also:

QueryService.findDepartment( org.eclipse.stardust.engine.api.runtime.DepartmentInfo parent, java.lang.String id, org.eclipse.stardust.engine.api.model.OrganizationInfo info)

findFirstDocument

Document findFirstDocument(DocumentQuery query)
                           throws WorkflowException,
                                  java.rmi.RemoteException

Retrieves the first document satisfying the criteria specified in the provided query.

Parameters:

query - the document query.

Returns:

the first matching document.

Throws:

org.eclipse.stardust.common.error.ObjectNotFoundException - if no matching document is found. Instances of ObjectNotFoundException will be wrapped inside WorkflowException.

WorkflowException - as a wrapper for org.eclipse.stardust.engine.api.ejb2.PublicExceptions and org.eclipse.stardust.engine.api.ejb2.ResourceExceptions

java.rmi.RemoteException

See Also:

QueryService.findFirstDocument( org.eclipse.stardust.engine.api.query.DocumentQuery query)

getAllDocuments

Documents getAllDocuments(DocumentQuery query)
                          throws WorkflowException,
                                 java.rmi.RemoteException

Retrieves all documents satisfying the criteria specified in the provided query.

Parameters:

query - the document query.

Returns:

a List of Document objects.

Throws:

WorkflowException - as a wrapper for org.eclipse.stardust.engine.api.ejb2.PublicExceptions and org.eclipse.stardust.engine.api.ejb2.ResourceExceptions

java.rmi.RemoteException

See Also:

QueryService.getAllDocuments( org.eclipse.stardust.engine.api.query.DocumentQuery query)

getPreferences

Preferences getPreferences(PreferenceScope scope,
                           java.lang.String moduleId,
                           java.lang.String preferencesId)
                           throws WorkflowException,
                                  java.rmi.RemoteException

Retrieves preferences from the given scope.

Parameters:

scope - the scope from which the preferences are to be retrieved from.

moduleId - the moduleId of the preferences.

preferencesId - the id of the preferences.

Returns:

a preferences object.

Throws:

PublicException - if scope is null. Instances of PublicException will be wrapped inside WorkflowException.

WorkflowException - as a wrapper for org.eclipse.stardust.engine.api.ejb2.PublicExceptions and org.eclipse.stardust.engine.api.ejb2.ResourceExceptions

java.rmi.RemoteException

See Also:

QueryService.getPreferences( org.eclipse.stardust.engine.core.preferences.PreferenceScope scope, java.lang.String moduleId, java.lang.String preferencesId)

getAllPreferences

java.util.List<Preferences> getAllPreferences(PreferenceQuery preferenceQuery)
                                              throws WorkflowException,
                                                     java.rmi.RemoteException

Retrieves preferences satisfying the criteria specified in the provided query.

Parameters:

preferenceQuery - the preference query.

Returns:

a list of preferences.

Throws:

PublicException - if querying is not supported for the specified PreferenceScope. Instances of PublicException will be wrapped inside WorkflowException.

java.lang.UnsupportedOperationException - if the PreferenceQuery contains unsupported terms or operations. Instances of UnsupportedOperationException will be wrapped inside WorkflowException.

InvalidArgumentException - if preferencesQuery is null. Instances of InvalidArgumentException will be wrapped inside WorkflowException.

WorkflowException - as a wrapper for org.eclipse.stardust.engine.api.ejb2.PublicExceptions and org.eclipse.stardust.engine.api.ejb2.ResourceExceptions

java.rmi.RemoteException

See Also:

QueryService.getAllPreferences( org.eclipse.stardust.engine.api.query.PreferenceQuery preferenceQuery)

getRuntimeEnvironmentInfo

RuntimeEnvironmentInfo getRuntimeEnvironmentInfo()
                                                 throws WorkflowException,
                                                        java.rmi.RemoteException

Retrieves the information about the deployed runtime environment ( e.g. version information).

Returns:

the runtime environment information.

Throws:

WorkflowException - as a wrapper for org.eclipse.stardust.engine.api.ejb2.PublicExceptions and org.eclipse.stardust.engine.api.ejb2.ResourceExceptions

java.rmi.RemoteException

See Also:

QueryService.getRuntimeEnvironmentInfo()

login

void login(java.lang.String userId,
           java.lang.String password)
           throws WorkflowException,
                  java.rmi.RemoteException

Throws:

WorkflowException

java.rmi.RemoteException

login

void login(java.lang.String userId,
           java.lang.String password,
           java.util.Map properties)
           throws WorkflowException,
                  java.rmi.RemoteException

Throws:

WorkflowException

java.rmi.RemoteException

logout

void logout()
            throws java.rmi.RemoteException

Throws:

java.rmi.RemoteException