public interface ProcessExecutionService
extends com.appiancorp.services.ContextSensitiveService
A process is an instance of a process model. The nodes added to processes at design time are translated into activities at execution time. Activities may need to be attended by human actors (in which case they are also called "tasks") or may be unattended. Activities can be run asynchronously.
Processes may contain process variables, or process-scoped variables that
may be used and set by activities. Process variables can also be set up as
process parameters, or variables for which the value can be set upon starting
the process (and may also be required).
See: #addProcessVariable(Long,ProcessVariable)
,
#addProcessVariables(Long,ProcessVariable[])
,
getProcessParameter(Long,String)
,
getProcessParameters(Long)
,
getProcessVariable(Long,String)
,
getProcessVariables(Long)
,
#setProcessVariable(Long,ProcessVariable)
, and
#setProcessVariables(Long,ProcessVariable[])
Nodes may be executed more than once if they are set up with recurrence.
See: skipRecurrence(Long,Long,Long)
,
triggerRecurrence(Long,Long,Long)
, and
getNextRecurrence(Long,Long)
Nodes may be set up with escalations, or actions that should be taken after
a certain amount of time if the task is not complete.
See: skipTaskEscalation(Long,Long)
and
triggerTaskEscalation(Long,Long)
Processes can be archived, or saved to files, and unarchived.
See: archiveProcess(Long)
,
archiveProcesses(Long[])
,
unarchiveProcess(Long)
,
unarchiveProcesses(Long[])
The methods of this class may throw a
PrivilegeException
if the
current user does not have privileges (permission) to perform an action, as
specified in NodePermissions
and
ProcessModelPermissions
*
Methods of service classes can all throw the unchecked exception
ServiceException
if any
system-level error (for example, server failure) occurs, and will in general
throw a checked exception (InvalidXXXException
) when an entity
to be retrieved is inaccessible, instead of returning null
.
Exceptions to this paradigm (including the use of ResultList
as
described below) are noted. All checked exceptions extend
AppianException
.
It may be necessary to retrieve a subset of results as opposed to an entire
collection, and also to sort the subset by some property of the returned
object. "Paging" methods which return a
ResultPage
are provided in certain
instances for this purpose. The ResultPage
will contain the
sorted subset of results
(via Result.getResults()
), and the
total number of items in the available result set
(via ResultPage.getAvailableItems()
).
It may also be necessary to retrieve some results, even if all results
cannot be retrieved (for instance, some of the entities corresponding
to a list of entity IDs may no longer exist). Methods which return a
ResultList
are provided for this
purpose. The Result.getResults()
method in this case will return all results which can be retrieved. In
addition, there will be a list of result codes
(ResultList.getResultCodes()
) that
represent the successful retrieval of an entity, or, if the entity could
not be retrieved, the reason for the failure. See the CODE_XXX
constants in ResultList
for details.
Modifier and Type | Field and Description |
---|---|
static boolean |
acceptTask$UPDATES |
static boolean |
acknowledgeActivity$UPDATES |
static boolean |
acknowledgeMessages$UPDATES |
static int |
ACTIVITY_CANCELLED
A constant indicating that an activity has been cancelled
|
static int |
ACTIVITY_COMPLETED
A constant indicating that an activity is in an invalid state.
|
static int |
ACTIVITY_INVALID_STATE
A constant indicating that an activity is in an invalid state
|
static int |
ACTIVITY_PAUSED
A constant indicating that an activity has been paused
|
static int |
ACTIVITY_PROCESS_CANCELLED
A constant indicating that an activity exists in a process that has been
cancelled
|
static int |
ACTIVITY_PROCESS_COMPLETED
A constant indicating that an activity exists in a process that has been
completed
|
static int |
ACTIVITY_PROCESS_DELETED
A constant indicating that an activity has been deleted, since its parent
process has been deleted
|
static int |
ACTIVITY_PROCESS_PAUSED
A constant indicating that the process for an activity is paused
|
static int |
ACTIVITY_SKIPPED
A constant indicating that an activity has been skipped by an exception flow.
|
static int |
ACTIVITY_VALID
A constant indicating that an activity is valid.
|
static int |
ACTIVITY_WAITING
A constant indicating that an activity is waiting on an asynchronous workq item in Java.
|
static boolean |
addAttachmentsToProcess$UPDATES |
static boolean |
addAttachmentsToTask$UPDATES |
static boolean |
addAttachmentToProcess$UPDATES |
static boolean |
addAttachmentToProcesses$UPDATES |
static boolean |
addAttachmentToTask$UPDATES |
static boolean |
addAttachmentToTasks$UPDATES |
static boolean |
addProcessToFavorites$UPDATES |
static boolean |
addProcessVariable$UPDATES |
static boolean |
addProcessVariables$UPDATES |
static boolean |
addTaskToFavorites$UPDATES |
static boolean |
archiveProcess$UPDATES |
static boolean |
archiveProcesses$UPDATES |
static java.lang.Integer |
ATTACHMENT_RETURN_INVALID
Result code indicating that an attachment may not be added/removed because
the specified process, task, or attachment does not exist
|
static java.lang.Integer |
ATTACHMENT_RETURN_PERMISSIONS
Result code indicating that an attachment may not be added/removed because
the user does not have permission to do so
|
static java.lang.Integer |
ATTACHMENT_RETURN_PROCESS_CANCELLED
Result code indicating that an attachment may not be added to the process
because the process was cancelled
|
static java.lang.Integer |
ATTACHMENT_RETURN_SUCCESS
Return code indicating that adding an attachment was successful
|
static java.lang.Integer |
ATTACHMENT_RETURN_TASK_CANCELLED
Result code indicating that an attachment may not be added to the task
because the task was cancelled
|
static java.lang.Integer |
ATTACHMENT_RETURN_TASK_UNATTENDED
Result code indicating that an attachment may not be added to the task
because the task is unattended
|
static java.lang.Integer |
ATTACHMENT_RETURN_TOO_MANY
Result code indicating that an attachment may not be added because too
many attachments have been added
|
static int |
ATTENDED_TASKS
Code for attended tasks only
|
static boolean |
cancelAllNodes$UPDATES |
static boolean |
cancelProcess$UPDATES |
static boolean |
cancelProcesses$UPDATES |
static boolean |
cancelStore$UPDATES |
static boolean |
cancelTask$UPDATES |
static boolean |
cancelTasks$UPDATES |
static boolean |
canCompleteActivity$UPDATES |
static boolean |
canCompleteClone$UPDATES |
static boolean |
checkActivityValidity$UPDATES |
static boolean |
commitUpdateUsernames$UPDATES |
static boolean |
completeActivity$UPDATES |
static boolean |
completeClone$UPDATES |
static boolean |
completeStore$UPDATES |
static boolean |
containsAsynchronousSubProcesses$UPDATES |
static boolean |
containsLinkProcesses$UPDATES |
static boolean |
containsLinkProcessesInheritingPriority$UPDATES |
static boolean |
containsSubProcesses$UPDATES |
static boolean |
containsSubProcessesInheritingPriority$UPDATES |
static boolean |
containsSynchronousSubProcesses$UPDATES |
static boolean |
createNoteMetadata$UPDATES |
static boolean |
createNoteMetadataForProcess$UPDATES |
static boolean |
createNoteMetadataForProcesses$UPDATES |
static boolean |
createNoteMetadataForTask$UPDATES |
static boolean |
createNoteMetadataForTasks$UPDATES |
static boolean |
createNoteMetadatas$UPDATES |
static boolean |
createNoteMetadatasForProcess$UPDATES |
static boolean |
createNoteMetadatasForTask$UPDATES |
static boolean |
deleteNoteMetadataForProcess$UPDATES |
static boolean |
deleteNoteMetadataForTask$UPDATES |
static boolean |
deleteNoteMetadatasForProcess$UPDATES |
static boolean |
deleteNoteMetadatasForTask$UPDATES |
static boolean |
deleteProcess$UPDATES |
static boolean |
deleteProcesses$UPDATES |
static boolean |
execute$UPDATES |
static int |
EXECUTION_FAILURE_EXCEPTION
Constant indicating that unattended activities could not be completed
because an exception occurred
|
static int |
EXECUTION_FAILURE_TIMEOUT
Constant indicating that unattended activities could not be completed
because a timeout occurred connecting to Java from the process engine
|
static boolean |
executionFailure$UPDATES |
static boolean |
executionFailureMessage$UPDATES |
static boolean |
getActivitiesMetadata$UPDATES |
static boolean |
getActivityMetadata$UPDATES |
static boolean |
getActivityProperties$UPDATES |
static boolean |
getAllExceptionNoteMetadatasForProcess$UPDATES |
static boolean |
getArchivePaths$UPDATES |
static boolean |
getAssigneePoolForTasks$UPDATES |
static boolean |
getAsynchronousSubProcessesForProcess$UPDATES |
static boolean |
getAttachmentsAndNotesForTask$UPDATES |
static boolean |
getAttachmentsForProcess$UPDATES |
static boolean |
getAttachmentsForTask$UPDATES |
static boolean |
getAttachmentsInProcess$UPDATES |
static boolean |
getAutoArchiveProperties$UPDATES |
static boolean |
getCancelledTasksForProcess$UPDATES |
static boolean |
getCompletedTasksForProcess$UPDATES |
static boolean |
getCurrentNotePaths$UPDATES |
static boolean |
getCurrentTasksForProcess$UPDATES |
static boolean |
getDeadlineForProcess$UPDATES |
static boolean |
getDeadlineForTask$UPDATES |
static boolean |
getExceptionNoteMetadataForTask$UPDATES |
static boolean |
getExceptionNoteMetadatasForProcess$UPDATES |
static boolean |
getLingeringTasksForProcess$UPDATES |
static boolean |
getLingeringTasksForProcessAndNode$UPDATES |
static boolean |
getLinkProcessesForProcess$UPDATES |
static boolean |
getMaximumNumberOfAttachments$UPDATES |
static boolean |
getMaximumNumberOfNotes$UPDATES |
static boolean |
getMemoryUsageForExecEngine$UPDATES |
static boolean |
getMemoryUsageForNodesInProcesses$UPDATES |
static boolean |
getMemoryUsageForProcesses$UPDATES |
static boolean |
getMemoryUsageForProcessesByModelUUID$UPDATES |
static boolean |
getMemoryUsageForProcessModels$UPDATES |
static boolean |
getMemoryUsageForProcessModelsByUUID$UPDATES |
static boolean |
getNextRecurrence$UPDATES |
static boolean |
getNoteMetadataForProcess$UPDATES |
static boolean |
getNoteMetadataForTask$UPDATES |
static boolean |
getNoteMetadatasForProcess$UPDATES |
static boolean |
getNoteMetadatasForProcesses$UPDATES |
static boolean |
getNoteMetadatasForTask$UPDATES |
static boolean |
getNoteMetadatasForTasks$UPDATES |
static boolean |
getNoteMetadatasInProcess$UPDATES |
static boolean |
getNotePath$UPDATES |
static boolean |
getNotePaths$UPDATES |
static boolean |
getPausedTasksForProcess$UPDATES |
static boolean |
getPermissionsForNode$UPDATES |
static boolean |
getPermissionsForNodes$UPDATES |
static boolean |
getPermissionsForProcess$UPDATES |
static boolean |
getPermissionsForProcessDiagram$UPDATES |
static boolean |
getPermissionsForProcesses$UPDATES |
static boolean |
getPmIdForProcess$UPDATES |
static boolean |
getPriorityOfProcess$UPDATES |
static boolean |
getPriorityOfProcesses$UPDATES |
static boolean |
getPriorityOfTask$UPDATES |
static boolean |
getPriorityOfTasks$UPDATES |
static boolean |
getProcessDetails$UPDATES |
static boolean |
getProcessDiagram$UPDATES |
static boolean |
getProcessHistoryRecords$UPDATES |
static boolean |
getProcessHistoryRecordsPaging$UPDATES |
static boolean |
getProcessParameter$UPDATES |
static boolean |
getProcessParameters$UPDATES |
static boolean |
getProcessProperties$UPDATES |
static boolean |
getProcessVariable$UPDATES |
static boolean |
getProcessVariables$UPDATES |
static boolean |
getProcessVariablesPaging$UPDATES |
static boolean |
getRecursiveProcessVariables$UPDATES |
static boolean |
getScheduleSummariesForNode$UPDATES |
static boolean |
getSecurityForNode$UPDATES |
static boolean |
getSecurityForProcess$UPDATES |
static boolean |
getSubProcessesForProcess$UPDATES |
static boolean |
getSynchronousSubProcessesForProcess$UPDATES |
static boolean |
getTaskAssignees$UPDATES |
static boolean |
getTaskDetails$UPDATES |
static boolean |
getTaskFormExpression$UPDATES |
static boolean |
getTaskFormExpressions$UPDATES |
static boolean |
getTaskOpaqueUri$UPDATES |
static boolean |
getTaskPrivileges$UPDATES |
static boolean |
getTaskProperties$UPDATES |
static boolean |
getTasksAssignees$UPDATES |
static boolean |
getTasksDetails$UPDATES |
static boolean |
getTasksForProcess$UPDATES |
static boolean |
getTasksWithExceptionsForProcess$UPDATES |
static boolean |
getTasksWithStatusForProcess$UPDATES |
static boolean |
getTasksWithStatusForProcesses$UPDATES |
static boolean |
getTasksWithStatusForProcessModel$UPDATES |
static boolean |
getTasksWithStatusForProcessModels$UPDATES |
static boolean |
getTaskUrl$UPDATES |
static boolean |
getTopLevelProcessForProcess$UPDATES |
static boolean |
handleMessages$UPDATES |
static boolean |
isAsynchronousSubProcess$UPDATES |
static boolean |
isLinkProcess$UPDATES |
static boolean |
isSubProcess$UPDATES |
static boolean |
isSynchronousSubProcess$UPDATES |
static boolean |
keepSubmittedTasksAlive$UPDATES |
static boolean |
lockProcesses$UPDATES |
static boolean |
lockProcessModelForProcess$UPDATES |
static boolean |
lowerPriorityOfProcess$UPDATES |
static boolean |
lowerPriorityOfProcesses$UPDATES |
static boolean |
lowerPriorityOfTask$UPDATES |
static boolean |
lowerPriorityOfTasks$UPDATES |
static java.lang.Integer |
NOTE_CREATION_PROCESS_CANCELLED
Result code indicating that the creation of note metadata for a process
failed because the process has been cancelled
|
static java.lang.Integer |
NOTE_CREATION_PROCESS_INSUFFICIENT_PRIVILEGES
Result code indicating that the creation of note metadata for a process
failed because the current user has insufficient privileges to attach notes
to the process.
|
static java.lang.Integer |
NOTE_CREATION_PROCESS_INVALID
Result code indicating that the creation of note metadata for a process
failed because the process is invalid
|
static java.lang.Integer |
NOTE_CREATION_PROCESS_INVALID_BEAN
Result code indicating that the creation of note metadata for a process
failed because a null or invalid bean was passed as a parameter.
|
static java.lang.Integer |
NOTE_CREATION_PROCESS_NOTE_LIMIT_EXCEEDED
Result code indicating that the creation of note metadata for a process
failed because the process already has the maximum allowed number of notes
|
static java.lang.Integer |
NOTE_CREATION_PROCESS_SUCCESS
Result code indicating that the creation of note metadata for a process
was successful
|
static java.lang.Integer |
NOTE_CREATION_TASK_CANCELLED
Result code indicating that the creation of note metadata for a task
failed because the task has been cancelled
|
static java.lang.Integer |
NOTE_CREATION_TASK_INSUFFICIENT_PRIVILEGES
Result code indicating that the creation of note metadata for a task
failed because the current user has insufficient privileges to attach notes
to the task.
|
static java.lang.Integer |
NOTE_CREATION_TASK_INVALID
Result code indicating that the creation of note metadata for a task
failed because the task is invalid
|
static java.lang.Integer |
NOTE_CREATION_TASK_INVALID_BEAN
Result code indicating that the creation of note metadata for a task
failed because a null or invalid bean was passed as a parameter.
|
static java.lang.Integer |
NOTE_CREATION_TASK_NOTE_LIMIT_EXCEEDED
Result code indicating that the creation of note metadata for a task
failed because the task already has the maximum allowed number of notes
|
static java.lang.Integer |
NOTE_CREATION_TASK_SUCCESS
Result code indicating that the creation of note metadata for a task
was successful
|
static java.lang.Integer |
NOTE_CREATION_TASK_UNATTENDED
Result code indicating that the creation of note metadata for a task
failed because the task is unattended
|
static java.lang.Integer |
NOTE_DELETION_INSUFFICIENT_PRIVILEGES
Result code indicating that the deletion of note metadata from a process or
task failed because the user does not have sufficient privileges to delete
the note from the process or task.
|
static java.lang.Integer |
NOTE_DELETION_INVALID
Result code indicating that the deletion of note metadata from a process or
task failed because the note does not exist
|
static java.lang.Integer |
NOTE_DELETION_SUCCESS
Result code indicating that the deletion of note metadata from a process or
task succeeded
|
static java.lang.Integer |
NOTES_RETURN_INVALID
Return code indicating that a note may not be added/removed because the
specified process, task, or note does not exist
|
static java.lang.Integer |
NOTES_RETURN_PERMISSIONS
Return code indicating that a note may not be added/removed because the
user does not have permission to do so
|
static java.lang.Integer |
NOTES_RETURN_SUCCESS
Return code indicating that adding/removing a Note was successful
|
static boolean |
notifyException$UPDATES |
static boolean |
notifyInvalidParameters$UPDATES |
static boolean |
notifyUsersCreationByJava$UPDATES |
static boolean |
pauseAllNodes$UPDATES |
static boolean |
pauseProcess$UPDATES |
static boolean |
pauseProcesses$UPDATES |
static boolean |
pauseTask$UPDATES |
static boolean |
pauseTasks$UPDATES |
static java.lang.Integer |
PROCESS_CANCELLATION_INSUFFICIENT_PRIVILEGES
Result code indicating that the cancellation of a process failed because
the current user has insufficient privileges to cancel the process - that
is, if
ProcessPermissions.isStopAndPause() returns false |
static java.lang.Integer |
PROCESS_CANCELLATION_INVALID_PROCESS
Result code indicating that the cancellation of a process failed because
the process is invalid
|
static java.lang.Integer |
PROCESS_CANCELLATION_INVALID_STATE
Result code indicating that the cancellation of a process failed because
the process is in an invalid state - that is, if the status of the process
is not one of
ProcessSummary.STATE_ACTIVE ,
ProcessSummary.STATE_PAUSED or
ProcessSummary.STATE_PAUSED_BY_EXCEPTION |
static java.lang.Integer |
PROCESS_CANCELLATION_LOCKED_PROCESS
Result code indicating that the cancellation of a process failed because
the process is locked (see
lockProcessModelForProcess(Long,boolean) ) |
static java.lang.Integer |
PROCESS_CANCELLATION_SUCCESS
Result code indicating that the cancellation of a process was successful
|
static boolean |
processToNextAttended$UPDATES |
static boolean |
raisePriorityOfProcess$UPDATES |
static boolean |
raisePriorityOfProcesses$UPDATES |
static boolean |
raisePriorityOfTask$UPDATES |
static boolean |
raisePriorityOfTasks$UPDATES |
static boolean |
reassignTask$UPDATES |
static boolean |
reassignTasksToAssigneePool$UPDATES |
static boolean |
reassignTasksToSameAssigneePool$UPDATES |
static boolean |
reassignTaskToSameAssigneePool$UPDATES |
static boolean |
refreshTaskForm$UPDATES |
static boolean |
rejectTask$UPDATES |
static boolean |
reloadProperties$UPDATES |
static boolean |
removeDashboardPageForProcesses$UPDATES |
static boolean |
removeProcessAttachment$UPDATES |
static boolean |
removeProcessAttachments$UPDATES |
static boolean |
removeProcessFromFavorites$UPDATES |
static boolean |
removeTaskAttachment$UPDATES |
static boolean |
removeTaskAttachments$UPDATES |
static boolean |
removeTaskFromFavorites$UPDATES |
static boolean |
restartAllNodes$UPDATES |
static java.lang.Integer |
RESULT_CODE_INSUFFICIENT_PRIVILEGES
Result code indicating that the current user does not have sufficient
privileges to perform the action
|
static java.lang.Integer |
RESULT_CODE_INVALID_NODE
Result code indicating that the node is invalid because its activity
chaining settings prohibit multiple instances
|
static java.lang.Integer |
RESULT_CODE_INVALID_OPERATION
Result code indicating that the attempted operation was invalid for the
current user
|
static java.lang.Integer |
RESULT_CODE_INVALID_PROCESS
Result code indicating that the specified process is invalid
|
static java.lang.Integer |
RESULT_CODE_INVALID_STATE
Result code indicating that something is in an invalid state for the action
to succeed
|
static java.lang.Integer |
RESULT_CODE_INVALID_TASK
Result code indicating that the specified task is invalid
|
static java.lang.Integer |
RESULT_CODE_LOCK_EXCEPTION
Result code indicating that an item is locked
|
static java.lang.Integer |
RESULT_CODE_LOGIC_NODE
Result code indicating that an item is a logic node and cannot be started
|
static java.lang.Integer |
RESULT_CODE_NODE_CANNOT_PAUSE
Result code indicating that this is an event and cannot be paused
|
static java.lang.Integer |
RESULT_CODE_NODE_MULTIPLICITY
Result code indicating that a node cannot be started because multiple
instances of the node are not allowed.
|
static java.lang.Integer |
RESULT_CODE_RECURRING_TASK
Result code indicating that the task is set to recur
|
static java.lang.Integer |
RESULT_CODE_SUCCESS
Result code indicating that the action is successful
|
static java.lang.Integer |
RESULT_CODE_TOO_MANY_INSTANCES
Result code indicating that the maximum number of task instances has been
reached and a new one cannot be created.
|
static boolean |
resumeAllNodes$UPDATES |
static boolean |
resumeProcess$UPDATES |
static boolean |
resumeProcesses$UPDATES |
static boolean |
resumeTask$UPDATES |
static boolean |
resumeTasks$UPDATES |
static int |
RETRIEVE_PROCESS_MODEL_NOTES
Constant indicating that that the notes and attachments of the underlying
process model should be retrieved by
getProcessDiagram(java.lang.Long, int) |
static int |
RETRIEVE_PROCESS_NOTES
Constant indicating that that the notes and attachments of the process
should be retrieved by
getProcessDiagram(java.lang.Long, int) |
static boolean |
rollbackUpdateUsernames$UPDATES |
static boolean |
saveActivityParameters$UPDATES |
static boolean |
setActorsInRolesForNode$UPDATES |
static boolean |
setActorsInRolesForProcess$UPDATES |
static boolean |
setApplicationAdministratorGroup$UPDATES |
static boolean |
setArchivePaths$UPDATES |
static boolean |
setCurrentNotePaths$UPDATES |
static boolean |
setDashboardPageForProcesses$UPDATES |
static boolean |
setDeadlineForProcess$UPDATES |
static boolean |
setDeadlineForTask$UPDATES |
static boolean |
setInheritanceForNode$UPDATES |
static boolean |
setInheritanceForProcess$UPDATES |
static boolean |
setPriorityOfProcess$UPDATES |
static boolean |
setPriorityOfProcesses$UPDATES |
static boolean |
setPriorityOfTask$UPDATES |
static boolean |
setPriorityOfTasks$UPDATES |
static boolean |
setProcessProperties$UPDATES |
static boolean |
setProcessVariable$UPDATES |
static boolean |
setProcessVariables$UPDATES |
static boolean |
setSecurityForNode$UPDATES |
static boolean |
setSecurityForProcess$UPDATES |
static boolean |
setSiteLocaleSettings$UPDATES |
static boolean |
setTaskDisplayName$UPDATES |
static boolean |
setTaskProperties$UPDATES |
static boolean |
setTaskStateRunning$UPDATES |
static boolean |
setTaskStateSubmitted$UPDATES |
static boolean |
setTimeZone$UPDATES |
static boolean |
setTimeZoneSameAs$UPDATES |
static boolean |
skipRecurrence$UPDATES |
static boolean |
skipTaskEscalation$UPDATES |
static boolean |
startAllNodes$UPDATES |
static boolean |
startQuickTask$UPDATES |
static boolean |
startTask$UPDATES |
static boolean |
startTasks$UPDATES |
static java.lang.Integer |
TASK_ACCEPTANCE_ACCEPTED_BY_ANOTHER
Result code indicating that a task could not be accepted because it was
already accepted by another user.
|
static java.lang.Integer |
TASK_ACCEPTANCE_INVALID_STATE
Result code indicating that a task could not be accepted because it is
in an invalid state.
|
static java.lang.Integer |
TASK_ACCEPTANCE_NOT_ASSIGNEE
Result code indicating that a task could not be accepted because the
current user is not an assignee
|
static java.lang.Integer |
TASK_ACCEPTANCE_NOT_ASSIGNEE_CAN_COMPLETE
Result code indicating that a task could not be accepted because the
current user is not an assignee, but the user has complete permissions
|
static java.lang.Integer |
TASK_ACCEPTANCE_PAUSED
Result code indicating that a task could not be accepted because the
task is paused
|
static java.lang.Integer |
TASK_ACCEPTANCE_PROCESS_PAUSED
Result code indicating that a task could not be accepted because the
process is paused
|
static java.lang.Integer |
TASK_ACCEPTANCE_SUCCESS
Result code indicating that a task was accepted successfully
|
static java.lang.Integer |
TASK_CANCELLATION_INSUFFICIENT_PRIVILEGES
Result code indicating that the cancellation of a task failed because
the current user has insufficient privileges to cancel the task - that is,
if
ProcessPermissions.isStopAndPause() returns false for the
process containing the task |
static java.lang.Integer |
TASK_CANCELLATION_INVALID_STATE
Result code indicating that the cancellation of a task failed because
the task is in an invalid state
|
static java.lang.Integer |
TASK_CANCELLATION_INVALID_TASK
Result code indicating that the cancellation of a task failed because
the task is invalid
|
static java.lang.Integer |
TASK_CANCELLATION_SUCCESS
Result code indicating that the cancellation of a task was successful
|
static java.lang.Integer |
TASK_PRIVILEGE_REASSIGN_ANY
Constant indicating that the current user has the privileges to
reject a given task, or to reassign the task to any user or group (inside
or outside of the assignment pool)
|
static java.lang.Integer |
TASK_PRIVILEGE_REASSIGN_WITHIN_POOL
Constant indicating that the current user has the privileges to
reject a given task, or to reassign the task within the assignment pool
|
static java.lang.Integer |
TASK_PRIVILEGE_REJECT_ONLY
Constant indicating that the current user only has the privileges to
reject a given task
|
static java.lang.Integer |
TASK_REJECTION_RESULT_INVALID_STATE
Result code indicating that the rejection of a task was unsuccessful
because the task was in an invalid state to be rejected (i.e., the task
was cancelled)
|
static java.lang.Integer |
TASK_REJECTION_RESULT_NOT_OWNER
Result code indicating that the rejection of a task was unsuccessful
because the current user is not the owner of the task
|
static java.lang.Integer |
TASK_REJECTION_RESULT_SUCCESS
Result code indicating that the rejection of a task was successful
|
static boolean |
triggerRecurrence$UPDATES |
static boolean |
triggerSchedule$UPDATES |
static boolean |
triggerTaskEscalation$UPDATES |
static boolean |
unarchiveProcess$UPDATES |
static boolean |
unarchiveProcesses$UPDATES |
static int |
UNATTENDED_AND_ATTENDED_TASKS
Code for attended and unattended tasks
|
static int |
UNATTENDED_TASKS
Code for unattended tasks only
|
static boolean |
uncompleteActivity$UPDATES |
static boolean |
unlockProcesses$UPDATES |
static boolean |
unlockProcessModelForProcess$UPDATES |
static boolean |
unlockProcessModels$UPDATES |
static boolean |
updateNoteMetadataForProcess$UPDATES |
static boolean |
updateNoteMetadataForTask$UPDATES |
static boolean |
updateNoteMetadatasForProcess$UPDATES |
static boolean |
updateNoteMetadatasForTask$UPDATES |
static boolean |
updateProcessModelForProcess$UPDATES |
static boolean |
updateUsernames$UPDATES |
static boolean |
upgradeProcesses$UPDATES |
static boolean |
validate$UPDATES |
Modifier and Type | Method and Description |
---|---|
java.lang.Integer |
acceptTask(java.lang.Long activityId_)
Accepts a task for a user.
|
void |
acknowledgeActivity(java.lang.Long activityId_)
Deprecated.
no longer necessary
|
void |
acknowledgeActivity(java.lang.Long[] activityId_)
Deprecated.
no longer necessary
|
void |
acknowledgeMessages(java.lang.Long[] messageIds_)
Deprecated.
replaced by work queue, no longer requires separate acknowledgement: call does nothing now
|
java.lang.Long[] |
addAttachmentsToProcess(java.lang.Long processId_,
Attachment[] attachments_)
Add attachments to a given process.
|
java.lang.Long[] |
addAttachmentsToTask(java.lang.Long taskId_,
Attachment[] attachments_)
Adds attachments to a given task.
|
java.lang.Long |
addAttachmentToProcess(java.lang.Long processId_,
Attachment attachment_)
Add an attachment to a process.
|
java.lang.Long[] |
addAttachmentToProcesses(java.lang.Long[] processIds_,
Attachment attachment_)
Adds a single attachment to a list of processes.
|
java.lang.Long |
addAttachmentToTask(java.lang.Long taskId_,
Attachment attachment_)
Add an attachment to a task
|
java.lang.Long[] |
addAttachmentToTasks(java.lang.Long[] taskIds_,
Attachment attachment_)
Add an attachment to the given tasks
|
void |
addProcessToFavorites(java.lang.Long processId_)
Adds a
Process to the user's favorites list. |
void |
addProcessVariable(java.lang.Long processId_,
ProcessVariableInstance pv_)
Adds a new variable to the specified process.
|
void |
addProcessVariables(java.lang.Long processId_,
ProcessVariableInstance[] pvs_)
Adds new variables to the specified process.
|
void |
addTaskToFavorites(java.lang.Long taskId_)
Adds a
Task to the user's favorites list. |
void |
archiveProcess(java.lang.Long processId_)
Archive the process with the given id.
|
java.lang.Integer[] |
archiveProcesses(java.lang.Long[] processIds_)
Manually archive the processes with the given ids.
|
NodeActionResult |
cancelAllNodes(java.lang.String[] nodeUuids,
java.lang.Long[] withinProcessIds)
Cancel each given node in every applicable process.
|
void |
cancelProcess(java.lang.Long processId_,
boolean cancelLinkedProcesses_)
Cancels the specified process.
|
java.lang.Integer[] |
cancelProcesses(java.lang.Long[] processIds_,
boolean cancelLinkedProcesses_)
Cancel a list of processes.
|
void |
cancelStore(java.lang.Long expressionGroupId,
java.lang.String cancelMessage)
Cancel an external data store.
|
void |
cancelTask(java.lang.Long activityId_)
Cancels a given task
|
java.lang.Integer[] |
cancelTasks(java.lang.Long[] activityIds_)
Cancels a list of tasks.
|
boolean |
canCompleteActivity(java.lang.Long activityId_)
Determines whether the specified activity can be completed by the user.
|
boolean |
canCompleteClone(java.lang.Long activityId_)
Indicates whether the current user can use
completeClone(java.lang.Long, com.appiancorp.suiteapi.process.ActivityClassParameter[], com.appiancorp.suiteapi.process.ActivityReturnVariable[]) on the
given task to complete the activity. |
int |
checkActivityValidity(java.lang.Long activityId_)
Determines whether the specified activity is valid.
|
void |
commitUpdateUsernames()
Deprecated.
|
java.lang.Long |
completeActivity(java.lang.Long activityId_,
ActivityReturnVariable[] outputs_)
Signals the completion of an activity not implemented within the process
engine itself.
|
java.lang.Long |
completeClone(java.lang.Long activityId_,
ActivityClassParameter[] inputs_,
ActivityReturnVariable[] outputs_)
Clones the given task (only a new id is assigned to the cloned task,
everything else stays the same), and completes it using the passed inputs
(i.e. calls execute or completeActivity).
|
void |
completeStore(java.lang.Long expressionGroupId)
Complete an external data store.
|
boolean |
containsAsynchronousSubProcesses(java.lang.Long processId_)
Determines whether or not the given process contains asynchronous subprocesses.
|
java.lang.Boolean[] |
containsAsynchronousSubProcesses(java.lang.Long[] processId_) |
boolean |
containsLinkProcesses(java.lang.Long processId_)
Deprecated.
Use
containsAsynchronousSubProcesses(Long) instead. |
boolean |
containsLinkProcessesInheritingPriority(java.lang.Long processId_)
Deprecated.
Use
containsSubProcessesInheritingPriority(Long)
instead. |
boolean |
containsSubProcesses(java.lang.Long processId_)
Deprecated.
Use
containsSynchronousSubProcesses(Long) instead. |
boolean |
containsSubProcessesInheritingPriority(java.lang.Long processId_)
Checks if the specified
Process contains sub-processes that
inherit their priority instead of defining their own priority levels. |
boolean |
containsSynchronousSubProcesses(java.lang.Long processId_)
Determines whether or not the given process contains synchronous subprocesses.
|
java.lang.Boolean[] |
containsSynchronousSubProcesses(java.lang.Long[] processId_) |
NoteMetadata |
createNoteMetadata(NoteMetadata nm_)
Create note metadata that is not attached to a process or task.
|
NoteMetadata |
createNoteMetadataForProcess(java.lang.Long processId_,
NoteMetadata nm_)
Creates a new Note for the specified Process.
|
ResultList |
createNoteMetadataForProcesses(java.lang.Long[] processIds_,
NoteMetadata nm_)
Creates a new Note for the specified Processes.
|
NoteMetadata |
createNoteMetadataForTask(java.lang.Long taskId_,
NoteMetadata nm_)
Creates a new Note for a given Task.
|
ResultList |
createNoteMetadataForTasks(java.lang.Long[] taskIds_,
NoteMetadata nm_)
Creates a new Note for the given Tasks.
|
NoteMetadata[] |
createNoteMetadatas(NoteMetadata[] nms_)
Bulk create note metadata.
|
ResultList |
createNoteMetadatasForProcess(java.lang.Long processId_,
NoteMetadata[] nms_)
Creates multiple notes for a given Process.
|
ResultList |
createNoteMetadatasForTask(java.lang.Long taskId_,
NoteMetadata[] nms_)
Creates multiple notes for a given task.
|
java.lang.String |
deleteNoteMetadataForProcess(java.lang.Long noteId_,
java.lang.Long processId_)
Deletes the specified Note for the given process.
|
java.lang.String |
deleteNoteMetadataForTask(java.lang.Long noteId_,
java.lang.Long taskId_)
Deletes the specified Note from a given task.
|
ResultList |
deleteNoteMetadatasForProcess(java.lang.Long[] noteIds_,
java.lang.Long processId_)
Deletes the specified notes from the given process
|
ResultList |
deleteNoteMetadatasForTask(java.lang.Long[] noteIds_,
java.lang.Long taskId_)
Deletes the specified notes for the given task
|
void |
deleteProcess(java.lang.Long processId_,
boolean deleteSubProcesses_)
Deletes the specified process.
|
void |
deleteProcesses(java.lang.Long[] processIds_,
boolean deleteSubProcesses_)
Deletes all of the specified processes.
|
java.lang.Long |
execute(java.lang.Long activityId_)
Requests execution of an activity implemented within the process engine.
|
void |
executionFailure(int errorType_,
java.lang.Long[] activities_)
Deprecated.
unattended activities now run from the work queue.
|
void |
executionFailureMessage(int errorType_,
java.lang.Long[] activities_,
java.lang.String message_)
Deprecated.
unattended activities now run from the work queue.
|
ActivityExecutionMetadata[] |
getActivitiesMetadata(java.lang.Long[] activityIds_)
Gets metadata for the specified activities.
|
ActivityExecutionMetadata |
getActivityMetadata(java.lang.Long activityId_)
Gets the metadata for a specified activity.
|
ActivityProperties |
getActivityProperties(java.lang.Long activityId_)
Retrieves the activity properties for the given activity.
|
ResultPage |
getAllExceptionNoteMetadatasForProcess(java.lang.Long processId_,
int startIndex_,
int batchSize_,
java.lang.Integer sortProperty_,
java.lang.Integer sortOrder_)
Gets a page out of the note metadatas for process and task exceptions
for a specified process and all its tasks.
|
java.lang.String[] |
getArchivePaths()
Retrieve the paths where archived processes are stored.
|
Assignment.Assignee[] |
getAssigneePoolForTasks(java.lang.Long[] taskIds_)
Gets the set of unique assignees among all the specified tasks.
|
ResultList |
getAsynchronousSubProcessesForProcess(java.lang.Long processId_,
int asynchronousSubProcessStatus_)
Gets the asynchronous subprocesses of the given process.
|
ResultPage |
getAttachmentsAndNotesForTask(java.lang.Long taskId_,
boolean recursive_,
int startIndex_,
int batchSize_,
java.lang.Integer sortProperty_,
java.lang.Integer sortOrder_)
Returns the attachments and notes for a specified task
|
Attachment[] |
getAttachmentsForProcess(java.lang.Long processId_)
Deprecated.
|
ResultPage |
getAttachmentsForProcess(java.lang.Long id_,
boolean recursive_,
int startIndex_,
int batchSize_,
java.lang.Integer sortProperty_,
java.lang.Integer sortOrder_)
Returns the attachments for a specified process
|
Attachment[] |
getAttachmentsForTask(java.lang.Long taskId_)
Gets all the attachments for a given task and its related process
|
ResultList |
getAttachmentsInProcess(java.lang.Long processId_,
java.lang.Long[] attachmentIds_)
Gets the specified attachments associated with a given process, or tasks
in this process
|
java.util.Map |
getAutoArchiveProperties()
Retrieves auto archive properties from the backend
|
ResultPage |
getCancelledTasksForProcess(java.lang.Long processId_,
int type_,
int startIndex_,
int batchSize_,
java.lang.Integer sortProperty_,
java.lang.Integer sortOrder_)
Gets the cancelled tasks for a process
|
ResultPage |
getCompletedTasksForProcess(java.lang.Long processId_,
int type_,
int startIndex_,
int batchSize_,
java.lang.Integer sortProperty_,
java.lang.Integer sortOrder_)
Gets the completed tasks for a process
|
java.lang.String[] |
getCurrentNotePaths()
Retrieve the paths where notes are stored on Execution engine 0.
|
ResultPage |
getCurrentTasksForProcess(java.lang.Long processId_,
int type_,
int startIndex_,
int batchSize_,
java.lang.Integer sortProperty_,
java.lang.Integer sortOrder_)
Gets the current tasks for a process
|
java.sql.Timestamp |
getDeadlineForProcess(java.lang.Long processId_)
Retrieve the deadline of a given process.
|
java.sql.Timestamp |
getDeadlineForTask(java.lang.Long taskId_)
Retrieve the deadline for a given task.
|
NoteMetadata |
getExceptionNoteMetadataForTask(java.lang.Long taskId_)
Gets the last exception note (that is, the note attached to the exception)
for the specified task;
null if no exceptions have been
raised on the task |
ResultPage |
getExceptionNoteMetadatasForProcess(java.lang.Long processId_,
int startIndex_,
int batchSize_,
java.lang.Integer sortProperty_,
java.lang.Integer sortOrder_)
Gets a page out of the note metadatas for process exceptions for a
specified process.
|
ResultPage |
getLingeringTasksForProcess(java.lang.Long processId_,
boolean recursive,
int startIndex_,
int batchSize_,
java.lang.Integer sortProperty_,
java.lang.Integer sortOrder_)
Returns all instances of lingering nodes currently active in the
specified process.
|
TaskSummary[] |
getLingeringTasksForProcessAndNode(java.lang.Long processId_,
java.lang.Long nodeId_)
Returns all instances of the specified lingering node currently active
in the specified process.
|
ResultList |
getLinkProcessesForProcess(java.lang.Long processId_,
int linkProcessStatus_)
Deprecated.
Use
getAsynchronousSubProcessesForProcess(Long, int) instead. |
int |
getMaximumNumberOfAttachments()
Returns the Maximum number of attachmnets that can be added to
Process or Task
|
int |
getMaximumNumberOfNotes()
Returns the Maximum number of notes that can be added to Process
or Task
|
SizingReport |
getMemoryUsageForExecEngine()
Returns the
SizingReport which contains top-level summary of
memory usage by various objects in all Execution Engines. |
SizingReport |
getMemoryUsageForNodesInProcesses(java.lang.Long[] processIds_)
Returns the
SizingReport which contains a breakdown of memory
usage by individual nodes/activities in specific Process instances. |
SizingReport |
getMemoryUsageForProcesses(java.lang.Long[] processIds_)
Returns the
SizingReport which contains a breakdown of memory
usage by individual process instances |
SizingReport |
getMemoryUsageForProcessesByModelUUID(java.lang.String[] processModelUUIDs_)
Returns the
SizingReport which contains a breakdown of memory
usage by individual process instances based of of specific Process Models
given by Process Model UUIDs. |
SizingReport |
getMemoryUsageForProcessModels(java.lang.Long[] processModelIds_)
Returns the
SizingReport which contains a breakdown of memory
usage by all process instances based off of specific Process Models given
by the Process Model IDs. |
SizingReport |
getMemoryUsageForProcessModelsByUUID(java.lang.String[] processModelUUIDs_)
Returns the
SizingReport which contains a breakdown of memory
usage by all process instances based off of specific Process Models given by
Process Model UUIDs. |
RecurrenceInstance |
getNextRecurrence(java.lang.Long processId_,
java.lang.Long nodeId_)
Gets the next recurrence for a node within a process
|
NoteMetadata |
getNoteMetadataForProcess(java.lang.Long noteId_,
java.lang.Long processId_)
Returns a specified note for given process
|
NoteMetadata |
getNoteMetadataForTask(java.lang.Long noteId_,
java.lang.Long taskId_)
Returns a specified note for given task
|
ResultPage |
getNoteMetadatasForProcess(java.lang.Long id_,
boolean recursive_,
int startIndex_,
int batchSize_,
java.lang.Integer sortProperty_,
java.lang.Integer sortOrder_)
Returns the metadata for the notes for a specified process
|
ResultPage |
getNoteMetadatasForProcess(java.lang.Long id_,
int startIndex_,
int batchSize_,
java.lang.Integer sortProperty_,
java.lang.Integer sortOrder_)
Deprecated.
|
ResultList |
getNoteMetadatasForProcesses(java.lang.Long[] ids_)
Returns the metadata for the notes for specified processes.
|
ResultPage |
getNoteMetadatasForTask(java.lang.Long id_,
boolean includeProcess_,
int startIndex_,
int batchSize_,
java.lang.Integer sortProperty_,
java.lang.Integer sortOrder_)
Gets the metadata for the notes of a specified task.
|
ResultList |
getNoteMetadatasForTasks(java.lang.Long[] ids_,
boolean includeProcess_)
Gets the notes for the specified tasks
|
ResultList |
getNoteMetadatasInProcess(java.lang.Long processId_,
java.lang.Long[] noteIds_)
Gets the specified notes associated with a given process, or tasks
in this process
|
java.lang.String |
getNotePath(java.lang.Long noteId_)
Gets the location for storage of the content of an unattached note.
|
java.lang.String[] |
getNotePaths(java.lang.Long[] noteIds_)
Gets the locations for storage of the content of unattached notes.
|
ResultPage |
getPausedTasksForProcess(java.lang.Long processId_,
int type_,
int startIndex_,
int batchSize_,
java.lang.Integer sortProperty_,
java.lang.Integer sortOrder_)
Gets the paused tasks for a process
|
NodePermissions |
getPermissionsForNode(java.lang.Long activityId_)
Gets the permissions that the user has by default on tasks of the specified
node.
|
NodePermissions[] |
getPermissionsForNodes(java.lang.Long[] activityIds_)
Gets the permissions that the user has by default on tasks of the specified
nodes.
|
ProcessPermissions |
getPermissionsForProcess(java.lang.Long id_)
Gets the permissions that the user has on a specified process.
|
ProcessModelPermissions |
getPermissionsForProcessDiagram(java.lang.Long processId_)
Gets a
ProcessModelPermissions object that says which
In-Flight Modifications the user can or cannot perform to a given process. |
ProcessPermissions[] |
getPermissionsForProcesses(java.lang.Long[] ids_)
Gets the permissions that the user has on specified processes.
|
java.lang.Long |
getPmIdForProcess(java.lang.Long processId_)
Get the specified Process's Process Model's ID
|
Priority |
getPriorityOfProcess(java.lang.Long processId_)
Gets the priority of a specified Process.
|
Priority[] |
getPriorityOfProcesses(java.lang.Long[] processIds_)
Gets the priority for a list of processes.
|
Priority |
getPriorityOfTask(java.lang.Long taskId_)
Get the priority of the specified task.
|
Priority[] |
getPriorityOfTasks(java.lang.Long[] taskIds_)
Get the priorities of the specified tasks.
|
ProcessDetails |
getProcessDetails(java.lang.Long processId_)
Gets the details for a specified process.
|
ProcessDiagram |
getProcessDiagram(java.lang.Long processId_,
int typeOfNotesToRetrieve_)
Allows users to retrieve the instance of the process model that
the process is run off.
|
HistoryRecord[] |
getProcessHistoryRecords(java.lang.Long processId_)
Get the process history record of the given process.
|
ResultPage |
getProcessHistoryRecordsPaging(java.lang.Long processId_,
int startIndex_,
int batchSize_,
java.lang.Integer sortProperty_,
java.lang.Integer sortOrder_)
Get the process history record of the given process.
|
ProcessVariableInstance |
getProcessParameter(java.lang.Long processId_,
java.lang.String parameterName_)
Retrieves the specified process parameter of the specified process.
|
ProcessVariableInstance[] |
getProcessParameters(java.lang.Long processId_)
Retrieves process parameters for the specified process.
|
ProcessProperties |
getProcessProperties(java.lang.Long processId_)
Retrieves the properties for the given process.
|
ProcessVariableInstance |
getProcessVariable(java.lang.Long processId_,
java.lang.String pvName_)
Retrieves the specified process variable for the specified process.
|
ProcessVariableInstance[] |
getProcessVariables(java.lang.Long processId_)
Deprecated.
Use
getRecursiveProcessVariables(Long, boolean) instead. |
ResultPage |
getProcessVariablesPaging(java.lang.Long processId_,
int startIndex_,
int batchSize_,
java.lang.Integer sortProperty_,
java.lang.Integer sortOrder_)
Retrieves the process variables for the specified process.
|
ProcessVariableInstance[] |
getRecursiveProcessVariables(java.lang.Long processId_,
boolean recursive_)
Retrieves the process variables for the specified process.
|
ResultPage |
getScheduleSummariesForNode(java.lang.Long processId_,
java.lang.Long nodeId_,
int startIndex_,
int batchSize_,
java.lang.Integer sortProperty_,
java.lang.Integer sortOrder_)
Gets Summaries of schedules that are attached to the node.
|
Security |
getSecurityForNode(java.lang.Long id_)
Gets the default security configuration of tasks for a specified node.
|
Security |
getSecurityForProcess(java.lang.Long id_)
Gets the security configuration of a process.
|
ResultList |
getSubProcessesForProcess(java.lang.Long processId_,
int subProcessStatus_)
Deprecated.
Use
getSynchronousSubProcessesForProcess(Long, int) instead. |
ResultList |
getSynchronousSubProcessesForProcess(java.lang.Long processId_,
int synchronousSubProcessStatus_)
Gets the synchronous subprocesses of the given process.
|
Assignment.Assignee[] |
getTaskAssignees(java.lang.Long taskId_)
Gets all assignees for a specified task.
|
TaskDetails |
getTaskDetails(java.lang.Long taskId_)
Gets the details for the specified task.
|
java.lang.String |
getTaskFormExpression(java.lang.Long taskId)
Gets task form expressions for the specified task.
|
java.lang.String[] |
getTaskFormExpressions(java.lang.Long[] taskIds)
Gets task form expressions for the specified tasks.
|
java.lang.String |
getTaskOpaqueUri(java.lang.Long taskId_)
Gets the opaque URI for the specified task.
|
java.lang.Integer |
getTaskPrivileges(java.lang.Long activityId_)
Determines whether the user who is executing an attended activity is
permitted to reject or reassign the task.
|
TaskProperties |
getTaskProperties(java.lang.Long taskId_)
Retrieves the properties for the given task.
|
Assignment.Assignee[][] |
getTasksAssignees(java.lang.Long[] taskIds_)
Gets all assignees for the specified tasks.
|
TaskDetails[] |
getTasksDetails(java.lang.Long[] taskIds_)
Gets the details for the specified tasks.
|
ResultPage |
getTasksForProcess(java.lang.Long processId_,
boolean recursive_,
int startIndex_,
int batchSize_,
java.lang.Integer sortProperty_,
java.lang.Integer sortOrder_)
Gets the summaries of the tasks in the process.
|
ResultPage |
getTasksForProcess(java.lang.Long processId_,
int startIndex_,
int batchSize_,
java.lang.Integer sortProperty_,
java.lang.Integer sortOrder_)
Deprecated.
|
ResultPage |
getTasksWithExceptionsForProcess(java.lang.Long processId_,
int startIndex_,
int batchSize_,
java.lang.Integer sortProperty_,
java.lang.Integer sortOrder_)
Gets the tasks that are paused by exception for a specified process.
|
ResultPage |
getTasksWithStatusForProcess(java.lang.Long processId_,
java.lang.Integer taskStatus_,
boolean recursive_,
int startIndex_,
int batchSize_,
java.lang.Integer sortProperty_,
java.lang.Integer sortOrder_)
Get the pages of tasks, within a particular process or its subprocesses, currently in a given state.
|
ResultPage |
getTasksWithStatusForProcesses(java.lang.Long[] processIds_,
java.lang.Integer taskStatus_,
boolean recursive_,
int startIndex_,
int batchSize_)
Get the pages of tasks, within particular processes or their subprocesses, currently in a given state.
|
ResultPage |
getTasksWithStatusForProcessModel(java.lang.Long processModelId_,
java.lang.Integer taskStatus_,
boolean recursive_,
int startIndex_,
int batchSize_)
Get the pages of tasks, within a particular process model, currently in a given state.
|
ResultPage |
getTasksWithStatusForProcessModels(java.lang.Long[] processModelIds_,
java.lang.Integer taskStatus_,
boolean recursive_,
int startIndex_,
int batchSize_)
Get the pages of tasks, within any of particular process models, currently in a given state.
|
java.lang.String |
getTaskUrl(java.lang.Long taskId_)
Gets the URL for the specified task.
|
ProcessSummary |
getTopLevelProcessForProcess(java.lang.Long processId_)
Gets the top level process for a given process.
|
int[] |
handleMessages(InternalMessage[] messages_)
Sends messages to the execution server, to be handled by the events
framework.
|
boolean |
isAsynchronousSubProcess(java.lang.Long processId_)
Determines whether or not the given process is an asynchronous subprocess.
|
boolean |
isLinkProcess(java.lang.Long processId_)
Deprecated.
Use
isAsynchronousSubProcess(Long) instead. |
boolean |
isSubProcess(java.lang.Long processId_)
Deprecated.
Use
#isSynchronousSubProcesses(Long) instead. |
boolean |
isSynchronousSubProcess(java.lang.Long processId_)
Determines whether or not the given process is a synchronous subprocess.
|
void |
keepSubmittedTasksAlive(java.lang.Long[] activities_)
This method informs the Process Engine that the specified tasks are still
in the queue, waiting to be executed asynchronously.
|
int[] |
lockProcesses(java.lang.Long[] processIds,
boolean override)
Attempts to lock the specified processes.
|
void |
lockProcessModelForProcess(java.lang.Long processId_,
boolean override_)
Locks the underlying process model of the specified process.
|
void |
lowerPriorityOfProcess(java.lang.Long processId_,
boolean propagatePriorityChangeToLinkProcesses_)
Lowers the priority of a process by one level.
|
void |
lowerPriorityOfProcesses(java.lang.Long[] processIds_,
boolean propagatePriorityChangeToLinkProcesses_)
Lowers the priority of the specified processes by one level.
|
void |
lowerPriorityOfTask(java.lang.Long taskId_)
Lowers the priority of a task by one level.
|
void |
lowerPriorityOfTasks(java.lang.Long[] taskIds_)
Lowers the priority of specified tasks by one level.
|
void |
notifyException(java.lang.Long activityId_,
java.lang.String exceptionClassName_,
java.lang.String message_,
java.lang.String stackTrace_)
Notifies the server that an exception has occurred while executing
an activity.
|
void |
notifyInvalidParameters(java.lang.Long activityId_,
ActivityClassParameter[] acps_)
Notifies the user that the parameters sent as inputs to an unattended
activity were invalid.
|
void |
notifyUsersCreationByJava(java.lang.Long activityId_,
java.lang.String[] usernames_)
Deprecated.
This call should never be necessary.
|
void |
notifyUsersCreationByJava(java.lang.String[] usernames_)
Deprecated.
done automatically by UserService.createUser
|
NodeActionResult |
pauseAllNodes(java.lang.String[] nodeUuids,
java.lang.Long[] withinProcessIds)
Pause each given node in every applicable process.
|
void |
pauseProcess(java.lang.Long processId_)
Pauses the process, and all of its nodes.
|
java.lang.Integer[] |
pauseProcesses(java.lang.Long[] processIds_)
Pauses the processes, and all of their nodes.
|
void |
pauseTask(java.lang.Long activityId_)
Pauses the task
|
java.lang.Integer[] |
pauseTasks(java.lang.Long[] activityIds_)
Tries to pause the tasks, and returns an array of result codes on
whether the operation was successful or an error had occurred.
|
void |
processToNextAttended(java.lang.Long activityId,
boolean isQuickTask,
ActivityClassParameter[] parameters)
This method can be used to programatically execute an attended task and continue
flow to the next attended activity.
|
void |
raisePriorityOfProcess(java.lang.Long processId_,
boolean propagatePriorityChangeToLinkProcesses_)
Raises the priority of a specified process by one level.
|
void |
raisePriorityOfProcesses(java.lang.Long[] processIds_,
boolean propagatePriorityChangeToLinkProcesses_)
Raises the priority of the specified processes by one level.
|
void |
raisePriorityOfTask(java.lang.Long taskId_)
Raises the priority of the specified task by one level.
|
void |
raisePriorityOfTasks(java.lang.Long[] taskIds_)
Raises the priority of the specified tasks by one level.
|
void |
reassignTask(java.lang.Long taskId_,
Assignment.Assignee[] assignees_)
Reassigns a task to new assignees.
|
java.lang.Integer[] |
reassignTasksToAssigneePool(java.lang.Long[] activityIds_,
Assignment.Assignee[] assignees_)
Deprecated.
|
java.lang.Integer[] |
reassignTasksToSameAssigneePool(java.lang.Long[] activityIds_)
Tries to reassign the tasks, and returns an array of result codes on
whether the operation was successful or an error had occurred.
|
void |
reassignTaskToSameAssigneePool(java.lang.Long activityId_)
Reassigns the task to the assignee pool.
|
void |
refreshTaskForm(java.lang.Long activityId_)
Deprecated.
This method will cause a race condition between ACP refresh
and form label refresh. Instead, use the
"Refresh default values every time the task form is viewed" execution option
in the task configuration in the model.
|
java.lang.Integer |
rejectTask(java.lang.Long taskId_)
Rejects a task that has already been accepted.
|
void |
reloadProperties()
Deprecated.
reloading properties is now automatic, so this call is now unnecessary and does nothing.
|
void |
removeDashboardPageForProcesses(java.lang.Long processModelId)
Deprecated.
Use
ProcessDesignService.removeProcessDashboardPageForProcessModel(Long) instead. |
java.lang.Long |
removeProcessAttachment(java.lang.Long attachmentId_,
java.lang.Long processId_)
Removes the specified attachment from a process.
|
java.lang.Long[] |
removeProcessAttachments(java.lang.Long[] attachmentIds_,
java.lang.Long processId_)
Removes specified attachments from the specified process.
|
void |
removeProcessFromFavorites(java.lang.Long processId_)
Removes a process from the user's Favorite's list
|
java.lang.Long |
removeTaskAttachment(java.lang.Long attachmentId_,
java.lang.Long taskId_)
Removes a specified attachment from a task
|
java.lang.Long[] |
removeTaskAttachments(java.lang.Long[] attachmentIds_,
java.lang.Long taskId_)
Removes the specified attachments from a task
|
void |
removeTaskFromFavorites(java.lang.Long taskId_)
Removes a task from the user's Favorite's list
|
NodeActionResult |
restartAllNodes(java.lang.String[] nodeUuids,
java.lang.Long[] withinProcessIds,
BulkNodeOption... bulkNodeOption)
Restart a task for each of the given nodeUuids in every applicable process.
|
NodeActionResult |
resumeAllNodes(java.lang.String[] nodeUuids,
java.lang.Long[] withinProcessIds)
Resume each given node in every applicable process.
|
void |
resumeProcess(java.lang.Long processId_)
Resumes the process.
|
java.lang.Integer[] |
resumeProcesses(java.lang.Long[] processIds_)
Tries to resume the processes, and returns an array of result codes on
whether the operation was successful or an error had occurred.
|
void |
resumeTask(java.lang.Long activityId_)
Resumes the task
|
java.lang.Integer[] |
resumeTasks(java.lang.Long[] activityIds_)
Tries to resume the tasks, and returns an array of result codes on
whether the operation was successful or an error had occurred.
|
void |
rollbackUpdateUsernames()
Deprecated.
|
void |
saveActivityParameters(java.lang.Long activityId_,
ActivityClassParameter[] acps_)
Saves the values for parameters of an
activity.
|
void |
setActorsInRolesForNode(java.lang.Long id_,
java.lang.String[] users_,
java.lang.String[][] userRoles_,
java.lang.Long[] groups_,
java.lang.String[][] groupRoles_)
Adds and/or modifies the default roles of users and groups for a node
instance (activity).
|
void |
setActorsInRolesForProcess(java.lang.Long id_,
java.lang.String[] users_,
java.lang.String[][] userRoles_,
java.lang.Long[] groups_,
java.lang.String[][] groupRoles_)
Adds and/or modifies the roles of users and groups for a specified
process.
|
void |
setApplicationAdministratorGroup(java.lang.Long groupId_)
Determines which group users need to be in to have
the application administrator role.
|
void |
setArchivePaths(java.lang.String[] archivePaths)
Set the paths where archived processes will be stored.
|
void |
setCurrentNotePaths(java.lang.String[] notePaths)
Sets the paths where notes are stored on Execution engine 0.
|
void |
setDashboardPageForProcesses(java.lang.Long processModelId,
java.lang.Long pageId)
Deprecated.
Use
ProcessDesignService.setProcessDashboardPageForProcessModel(Long, Long) instead. |
void |
setDeadlineForProcess(java.lang.Long processId_,
java.sql.Timestamp deadline_)
Set the deadline for a given process.
|
void |
setDeadlineForTask(java.lang.Long taskId_,
java.sql.Timestamp deadline_)
Set the deadline for a given task.
|
void |
setInheritanceForNode(java.lang.Long id_,
boolean doesInherit_)
Sets whether a specified task inherits security from its process.
|
void |
setInheritanceForProcess(java.lang.Long id_,
boolean doesInherit_)
Sets whether a specified process inherits security from the process model
of which it is an instance.
|
void |
setPriorityOfProcess(java.lang.Long processId_,
java.lang.Long priorityId_,
boolean propagatePriorityChangeToSubProcesses_)
Sets the priority of a specified process
|
void |
setPriorityOfProcesses(java.lang.Long[] processIds_,
java.lang.Long priorityId_,
boolean propagatePriorityChangeToSubProcesses_)
Sets the priority
Priority of the specified processes
ProcessDetails . |
void |
setPriorityOfTask(java.lang.Long taskId_,
java.lang.Long priorityId_)
Sets the priority of a specified task.
|
void |
setPriorityOfTasks(java.lang.Long[] taskIds_,
java.lang.Long priorityId_)
Sets the priorities of specified tasks.
|
void |
setProcessProperties(ProcessProperties properties_)
Sets the properties of the specified process.
|
void |
setProcessVariable(java.lang.Long pProcessId_,
ProcessVariableInstance pv_)
Sets the value of the specified process variable
for the specified process.
|
void |
setProcessVariables(java.lang.Long pProcessId_,
ProcessVariableInstance[] pvs_)
Sets the values of the specified process variables
for the specified process.
|
void |
setSecurityForNode(java.lang.Long id_,
Security s_)
Sets the default security configuration of tasks for a
specified node.
|
void |
setSecurityForProcess(java.lang.Long id_,
Security s_)
Sets the security configuration of a process.
|
void |
setSiteLocaleSettings(SiteLocaleSettings settings_)
Registers the site locale settings on the process execution server.
|
void |
setTaskDisplayName(java.lang.Long taskId,
LocaleString displayName)
Sets the display name for the specified task to the specified string.
|
void |
setTaskProperties(TaskProperties properties_)
Sets the properties of the specified task .
|
void |
setTaskStateRunning(java.lang.Long taskId_)
Sets the Task in the Running state.
|
void |
setTaskStateSubmitted(java.lang.Long taskId_)
Sets the Task in the 'Submitted' state.
|
void |
setTimeZone(BackendTimeZoneSimple tz)
Set the time zone information using the format used by the engines to encapsulate time zone
information.
|
void |
setTimeZoneSameAs(BackendTimeZoneSimple tz,
java.lang.String sameAsId)
Deprecated.
this method will be removed in a future release
|
RecurrenceInstance |
skipRecurrence(java.lang.Long processId_,
java.lang.Long nodeId_,
java.lang.Long recurrenceNumber_)
Skips the recurrence instance of the given node
|
void |
skipTaskEscalation(java.lang.Long activityId_,
java.lang.Long escalationId_)
Skips the desired escalation instance for
the task
|
NodeActionResult |
startAllNodes(java.lang.String[] nodeUuids,
java.lang.Long[] withinProcessIds,
BulkNodeOption... bulkNodeOption)
Start a task for each of the given nodeUuids in every applicable process.
|
java.lang.Long |
startQuickTask(java.lang.Long processId_,
java.lang.Long nodeId_)
Starts a new task from the node
If the process to which the node belongs is cancelled or completed, then
the process is reactivated.
|
boolean |
startTask(java.lang.Long processId_,
java.lang.Long nodeId_)
Starts a new task from the node
If the process to which the node belongs is cancelled or completed, then
the process is reactivated.
|
java.lang.Integer[] |
startTasks(java.lang.Long processId_,
java.lang.Long[] nodeIds_)
Tries to start the tasks, and returns an array of result codes on
whether the operation was successful or an error had occurred.
|
RecurrenceInstance |
triggerRecurrence(java.lang.Long processId_,
java.lang.Long nodeId_,
java.lang.Long recurrenceNumber_)
Triggers the recurrence instance of the given
node
|
void |
triggerSchedule(java.lang.Integer scheduleType_,
java.lang.Long scheduleId_)
Triggers the schedule instance for the task or node
|
void |
triggerTaskEscalation(java.lang.Long activityId_,
java.lang.Long escalationId_)
Triggers the desired escalation instance for
the task.Users must obtain escalation id from TaskDetails object.
|
void |
unarchiveProcess(java.lang.Long processId_)
Bring all process data back to memory.
|
java.lang.Integer[] |
unarchiveProcesses(java.lang.Long[] processIds_)
Bring all process data back to memory.
|
ActivityExecutionMetadata |
uncompleteActivity(java.lang.Long activityId_)
Changes the status of an activity to ACCEPTED or ASSIGNED.
|
int[] |
unlockProcesses(java.lang.Long[] processIds,
boolean override)
Attempts to unlock the specified processes.
|
void |
unlockProcessModelForProcess(java.lang.Long processId_,
boolean override_)
Unlocks the underlying process model for the
process
|
void |
unlockProcessModels()
Unlocks all process models locked by the current user.
|
NoteMetadata |
updateNoteMetadataForProcess(NoteMetadata nm_,
java.lang.Long processId_)
Updates the specified Note for given process
The following field must be populated in the
NoteMetadata
object:
id |
NoteMetadata |
updateNoteMetadataForTask(NoteMetadata nm_,
java.lang.Long taskId_)
Updates the specified Note for given task
The following field must be populated in the
NoteMetadata
object:
id |
ResultList |
updateNoteMetadatasForProcess(NoteMetadata[] nms_,
java.lang.Long processId_)
Updates all the specified notes for the given process.
|
ResultList |
updateNoteMetadatasForTask(NoteMetadata[] nms_,
java.lang.Long taskId_)
Updates all the specified notes for a given
task.
|
ProcessDiagram |
updateProcessModelForProcess(java.lang.Long processId_,
ProcessDiagram pd_,
ProcessModel[] childProcessModels_)
Deprecated.
|
void |
updateUsernames(java.lang.String[] oldUsernames_,
java.lang.String[] newUsernames_,
long maxExpirationTimeInSeconds_)
Deprecated.
|
UpgradeResult |
upgradeProcesses(java.lang.Long toProcessModelId,
java.lang.String toVersion,
java.lang.Long[] processIds)
Attempts to upgrade the given processes to the specified process model id and version.
|
UpgradeResult |
upgradeProcesses(java.lang.Long toProcessModelId,
java.lang.String toVersion,
java.lang.Long fromProcessModelId,
java.lang.String[] fromVersions)
Attempts to upgrade the processes of the 'from' process model id and version to the 'to'
process model id and version.
|
java.lang.String |
validate()
Runs validation tests against the database to check whether it is corrupt,
and returns a line-separated list of validation results
|
static final java.lang.Integer TASK_ACCEPTANCE_SUCCESS
static final java.lang.Integer TASK_ACCEPTANCE_ACCEPTED_BY_ANOTHER
static final java.lang.Integer TASK_ACCEPTANCE_INVALID_STATE
TaskSummary.TASK_STATUS_ASSIGNED
or
TaskSummary.TASK_STATUS_ACCEPTED
static final java.lang.Integer TASK_ACCEPTANCE_NOT_ASSIGNEE
static final java.lang.Integer TASK_ACCEPTANCE_PROCESS_PAUSED
static final java.lang.Integer TASK_ACCEPTANCE_PAUSED
static final java.lang.Integer TASK_ACCEPTANCE_NOT_ASSIGNEE_CAN_COMPLETE
static final java.lang.Integer TASK_PRIVILEGE_REJECT_ONLY
static final java.lang.Integer TASK_PRIVILEGE_REASSIGN_WITHIN_POOL
static final java.lang.Integer TASK_PRIVILEGE_REASSIGN_ANY
static final java.lang.Integer TASK_REJECTION_RESULT_SUCCESS
static final java.lang.Integer TASK_REJECTION_RESULT_INVALID_STATE
static final java.lang.Integer TASK_REJECTION_RESULT_NOT_OWNER
static final java.lang.Integer PROCESS_CANCELLATION_SUCCESS
static final java.lang.Integer PROCESS_CANCELLATION_INVALID_PROCESS
static final java.lang.Integer PROCESS_CANCELLATION_INSUFFICIENT_PRIVILEGES
ProcessPermissions.isStopAndPause()
returns falsestatic final java.lang.Integer PROCESS_CANCELLATION_INVALID_STATE
ProcessSummary.STATE_ACTIVE
,
ProcessSummary.STATE_PAUSED
or
ProcessSummary.STATE_PAUSED_BY_EXCEPTION
static final java.lang.Integer PROCESS_CANCELLATION_LOCKED_PROCESS
lockProcessModelForProcess(Long,boolean)
)static final java.lang.Integer TASK_CANCELLATION_SUCCESS
static final java.lang.Integer TASK_CANCELLATION_INVALID_TASK
static final java.lang.Integer TASK_CANCELLATION_INSUFFICIENT_PRIVILEGES
ProcessPermissions.isStopAndPause()
returns false for the
process containing the taskstatic final java.lang.Integer TASK_CANCELLATION_INVALID_STATE
static final java.lang.Integer NOTE_CREATION_PROCESS_INVALID_BEAN
static final java.lang.Integer NOTE_CREATION_PROCESS_CANCELLED
static final java.lang.Integer NOTE_CREATION_PROCESS_NOTE_LIMIT_EXCEEDED
static final java.lang.Integer NOTE_CREATION_PROCESS_INVALID
static final java.lang.Integer NOTE_CREATION_PROCESS_INSUFFICIENT_PRIVILEGES
ProcessPermissions.isAddAttachment()
returns falsestatic final java.lang.Integer NOTE_CREATION_PROCESS_SUCCESS
static final java.lang.Integer NOTE_CREATION_TASK_INVALID_BEAN
static final java.lang.Integer NOTE_CREATION_TASK_UNATTENDED
static final java.lang.Integer NOTE_CREATION_TASK_CANCELLED
static final java.lang.Integer NOTE_CREATION_TASK_NOTE_LIMIT_EXCEEDED
static final java.lang.Integer NOTE_CREATION_TASK_INVALID
static final java.lang.Integer NOTE_CREATION_TASK_INSUFFICIENT_PRIVILEGES
NodePermissions.isAddAttachment()
returns falsestatic final java.lang.Integer NOTE_CREATION_TASK_SUCCESS
static final java.lang.Integer NOTE_DELETION_INVALID
static final java.lang.Integer NOTE_DELETION_INSUFFICIENT_PRIVILEGES
ProcessPermissions.isRemoveAttachment()
returns false for the process,
or for the process containing the task, respectively.static final java.lang.Integer NOTE_DELETION_SUCCESS
static final int ACTIVITY_VALID
static final int ACTIVITY_PROCESS_CANCELLED
static final int ACTIVITY_PROCESS_COMPLETED
static final int ACTIVITY_PROCESS_DELETED
static final int ACTIVITY_COMPLETED
static final int ACTIVITY_PROCESS_PAUSED
static final int ACTIVITY_PAUSED
static final int ACTIVITY_CANCELLED
static final int ACTIVITY_INVALID_STATE
static final int ACTIVITY_SKIPPED
static final int ACTIVITY_WAITING
static final java.lang.Integer RESULT_CODE_RECURRING_TASK
static final java.lang.Integer RESULT_CODE_TOO_MANY_INSTANCES
static final java.lang.Integer RESULT_CODE_SUCCESS
static final java.lang.Integer RESULT_CODE_INVALID_PROCESS
static final java.lang.Integer RESULT_CODE_INSUFFICIENT_PRIVILEGES
static final java.lang.Integer RESULT_CODE_INVALID_STATE
static final java.lang.Integer RESULT_CODE_INVALID_OPERATION
static final java.lang.Integer RESULT_CODE_INVALID_TASK
static final java.lang.Integer RESULT_CODE_LOCK_EXCEPTION
static final java.lang.Integer RESULT_CODE_LOGIC_NODE
static final java.lang.Integer RESULT_CODE_INVALID_NODE
static final java.lang.Integer RESULT_CODE_NODE_MULTIPLICITY
static final java.lang.Integer RESULT_CODE_NODE_CANNOT_PAUSE
static final java.lang.Integer ATTACHMENT_RETURN_TASK_UNATTENDED
static final java.lang.Integer ATTACHMENT_RETURN_TASK_CANCELLED
static final java.lang.Integer ATTACHMENT_RETURN_PROCESS_CANCELLED
static final java.lang.Integer ATTACHMENT_RETURN_TOO_MANY
static final java.lang.Integer ATTACHMENT_RETURN_INVALID
static final java.lang.Integer ATTACHMENT_RETURN_PERMISSIONS
static final java.lang.Integer ATTACHMENT_RETURN_SUCCESS
static final java.lang.Integer NOTES_RETURN_INVALID
static final java.lang.Integer NOTES_RETURN_PERMISSIONS
static final java.lang.Integer NOTES_RETURN_SUCCESS
static final int UNATTENDED_TASKS
static final int ATTENDED_TASKS
static final int UNATTENDED_AND_ATTENDED_TASKS
static final int EXECUTION_FAILURE_EXCEPTION
static final int EXECUTION_FAILURE_TIMEOUT
static final int RETRIEVE_PROCESS_MODEL_NOTES
getProcessDiagram(java.lang.Long, int)
static final int RETRIEVE_PROCESS_NOTES
getProcessDiagram(java.lang.Long, int)
static final boolean saveActivityParameters$UPDATES
static final boolean completeActivity$UPDATES
static final boolean acknowledgeActivity$UPDATES
static final boolean completeClone$UPDATES
static final boolean getLingeringTasksForProcess$UPDATES
static final boolean getLingeringTasksForProcessAndNode$UPDATES
static final boolean refreshTaskForm$UPDATES
static final boolean execute$UPDATES
static final boolean getActivityMetadata$UPDATES
static final boolean getActivitiesMetadata$UPDATES
static final boolean getTaskFormExpression$UPDATES
static final boolean getTaskFormExpressions$UPDATES
static final boolean acceptTask$UPDATES
static final boolean getTaskPrivileges$UPDATES
static final boolean getTaskAssignees$UPDATES
static final boolean getTasksAssignees$UPDATES
static final boolean getAssigneePoolForTasks$UPDATES
static final boolean reassignTask$UPDATES
static final boolean rejectTask$UPDATES
static final boolean getTaskDetails$UPDATES
static final boolean getTasksDetails$UPDATES
static final boolean getTaskOpaqueUri$UPDATES
static final boolean getTaskUrl$UPDATES
static final boolean getProcessDetails$UPDATES
static final boolean notifyException$UPDATES
static final boolean executionFailure$UPDATES
static final boolean executionFailureMessage$UPDATES
static final boolean deleteProcess$UPDATES
static final boolean deleteProcesses$UPDATES
static final boolean cancelProcess$UPDATES
static final boolean notifyInvalidParameters$UPDATES
static final boolean notifyUsersCreationByJava$UPDATES
static final boolean checkActivityValidity$UPDATES
static final boolean canCompleteActivity$UPDATES
static final boolean canCompleteClone$UPDATES
static final boolean getSubProcessesForProcess$UPDATES
static final boolean getSynchronousSubProcessesForProcess$UPDATES
static final boolean getTopLevelProcessForProcess$UPDATES
static final boolean isSubProcess$UPDATES
static final boolean isSynchronousSubProcess$UPDATES
static final boolean containsSubProcesses$UPDATES
static final boolean containsLinkProcesses$UPDATES
static final boolean containsSynchronousSubProcesses$UPDATES
static final boolean containsAsynchronousSubProcesses$UPDATES
static final boolean getLinkProcessesForProcess$UPDATES
static final boolean getAsynchronousSubProcessesForProcess$UPDATES
static final boolean isLinkProcess$UPDATES
static final boolean isAsynchronousSubProcess$UPDATES
static final boolean getActivityProperties$UPDATES
static final boolean getTaskProperties$UPDATES
static final boolean setTaskProperties$UPDATES
static final boolean setTaskDisplayName$UPDATES
static final boolean getProcessProperties$UPDATES
static final boolean setProcessProperties$UPDATES
static final boolean getProcessParameters$UPDATES
static final boolean getProcessParameter$UPDATES
static final boolean getProcessVariables$UPDATES
static final boolean getRecursiveProcessVariables$UPDATES
static final boolean getProcessVariablesPaging$UPDATES
static final boolean getProcessVariable$UPDATES
static final boolean setProcessVariables$UPDATES
static final boolean setProcessVariable$UPDATES
static final boolean addProcessVariable$UPDATES
static final boolean addProcessVariables$UPDATES
static final boolean getSecurityForProcess$UPDATES
static final boolean setSecurityForProcess$UPDATES
static final boolean getSecurityForNode$UPDATES
static final boolean setSecurityForNode$UPDATES
static final boolean setActorsInRolesForProcess$UPDATES
static final boolean setActorsInRolesForNode$UPDATES
static final boolean setInheritanceForProcess$UPDATES
static final boolean setInheritanceForNode$UPDATES
static final boolean getPermissionsForProcess$UPDATES
static final boolean getPermissionsForProcesses$UPDATES
static final boolean getPermissionsForNode$UPDATES
static final boolean getPermissionsForNodes$UPDATES
static final boolean getPermissionsForProcessDiagram$UPDATES
static final boolean getAttachmentsForProcess$UPDATES
static final boolean getAttachmentsAndNotesForTask$UPDATES
static final boolean getAttachmentsForTask$UPDATES
static final boolean removeProcessAttachments$UPDATES
static final boolean removeProcessAttachment$UPDATES
static final boolean removeTaskAttachments$UPDATES
static final boolean removeTaskAttachment$UPDATES
static final boolean addAttachmentToProcess$UPDATES
static final boolean addAttachmentToProcesses$UPDATES
static final boolean addAttachmentsToProcess$UPDATES
static final boolean addAttachmentToTask$UPDATES
static final boolean addAttachmentToTasks$UPDATES
static final boolean addAttachmentsToTask$UPDATES
static final boolean getDeadlineForProcess$UPDATES
static final boolean setDeadlineForProcess$UPDATES
static final boolean getDeadlineForTask$UPDATES
static final boolean setDeadlineForTask$UPDATES
static final boolean getPriorityOfTask$UPDATES
static final boolean getPriorityOfTasks$UPDATES
static final boolean getPriorityOfProcess$UPDATES
static final boolean getPriorityOfProcesses$UPDATES
static final boolean setPriorityOfTask$UPDATES
static final boolean setPriorityOfTasks$UPDATES
static final boolean setPriorityOfProcess$UPDATES
static final boolean setPriorityOfProcesses$UPDATES
static final boolean raisePriorityOfTask$UPDATES
static final boolean raisePriorityOfTasks$UPDATES
static final boolean raisePriorityOfProcess$UPDATES
static final boolean raisePriorityOfProcesses$UPDATES
static final boolean lowerPriorityOfTask$UPDATES
static final boolean lowerPriorityOfTasks$UPDATES
static final boolean lowerPriorityOfProcess$UPDATES
static final boolean lowerPriorityOfProcesses$UPDATES
static final boolean containsLinkProcessesInheritingPriority$UPDATES
static final boolean containsSubProcessesInheritingPriority$UPDATES
static final boolean createNoteMetadata$UPDATES
static final boolean createNoteMetadatas$UPDATES
static final boolean getNotePath$UPDATES
static final boolean getNotePaths$UPDATES
static final boolean getCurrentNotePaths$UPDATES
static final boolean setCurrentNotePaths$UPDATES
static final boolean getExceptionNoteMetadataForTask$UPDATES
static final boolean getExceptionNoteMetadatasForProcess$UPDATES
static final boolean getAllExceptionNoteMetadatasForProcess$UPDATES
static final boolean createNoteMetadataForProcess$UPDATES
static final boolean createNoteMetadataForProcesses$UPDATES
static final boolean createNoteMetadatasForProcess$UPDATES
static final boolean getNoteMetadatasForProcess$UPDATES
static final boolean getNoteMetadatasForProcesses$UPDATES
static final boolean createNoteMetadataForTask$UPDATES
static final boolean createNoteMetadataForTasks$UPDATES
static final boolean createNoteMetadatasForTask$UPDATES
static final boolean getNoteMetadatasForTask$UPDATES
static final boolean getNoteMetadatasForTasks$UPDATES
static final boolean deleteNoteMetadataForProcess$UPDATES
static final boolean deleteNoteMetadataForTask$UPDATES
static final boolean deleteNoteMetadatasForProcess$UPDATES
static final boolean deleteNoteMetadatasForTask$UPDATES
static final boolean updateNoteMetadataForProcess$UPDATES
static final boolean updateNoteMetadataForTask$UPDATES
static final boolean updateNoteMetadatasForProcess$UPDATES
static final boolean updateNoteMetadatasForTask$UPDATES
static final boolean getNoteMetadataForTask$UPDATES
static final boolean getNoteMetadataForProcess$UPDATES
static final boolean getTasksForProcess$UPDATES
static final boolean pauseProcess$UPDATES
static final boolean pauseProcesses$UPDATES
static final boolean resumeProcess$UPDATES
static final boolean resumeProcesses$UPDATES
static final boolean cancelProcesses$UPDATES
static final boolean startQuickTask$UPDATES
static final boolean startTask$UPDATES
static final boolean startTasks$UPDATES
static final boolean resumeTask$UPDATES
static final boolean resumeTasks$UPDATES
static final boolean pauseTask$UPDATES
static final boolean pauseTasks$UPDATES
static final boolean cancelTask$UPDATES
static final boolean cancelTasks$UPDATES
static final boolean startAllNodes$UPDATES
static final boolean restartAllNodes$UPDATES
static final boolean pauseAllNodes$UPDATES
static final boolean resumeAllNodes$UPDATES
static final boolean cancelAllNodes$UPDATES
static final boolean reassignTaskToSameAssigneePool$UPDATES
static final boolean reassignTasksToAssigneePool$UPDATES
static final boolean reassignTasksToSameAssigneePool$UPDATES
static final boolean getProcessDiagram$UPDATES
static final boolean updateProcessModelForProcess$UPDATES
static final boolean upgradeProcesses$UPDATES
static final boolean triggerSchedule$UPDATES
static final boolean triggerTaskEscalation$UPDATES
static final boolean skipTaskEscalation$UPDATES
static final boolean getScheduleSummariesForNode$UPDATES
static final boolean lockProcessModelForProcess$UPDATES
static final boolean lockProcesses$UPDATES
static final boolean unlockProcesses$UPDATES
static final boolean unlockProcessModelForProcess$UPDATES
static final boolean unlockProcessModels$UPDATES
static final boolean getMaximumNumberOfNotes$UPDATES
static final boolean getMaximumNumberOfAttachments$UPDATES
static final boolean skipRecurrence$UPDATES
static final boolean triggerRecurrence$UPDATES
static final boolean setTaskStateSubmitted$UPDATES
static final boolean keepSubmittedTasksAlive$UPDATES
static final boolean setTaskStateRunning$UPDATES
static final boolean getCurrentTasksForProcess$UPDATES
static final boolean getCompletedTasksForProcess$UPDATES
static final boolean getCancelledTasksForProcess$UPDATES
static final boolean getPausedTasksForProcess$UPDATES
static final boolean getTasksWithExceptionsForProcess$UPDATES
static final boolean unarchiveProcess$UPDATES
static final boolean unarchiveProcesses$UPDATES
static final boolean archiveProcess$UPDATES
static final boolean archiveProcesses$UPDATES
static final boolean getArchivePaths$UPDATES
static final boolean setArchivePaths$UPDATES
static final boolean getNextRecurrence$UPDATES
static final boolean getAttachmentsInProcess$UPDATES
static final boolean getNoteMetadatasInProcess$UPDATES
static final boolean updateUsernames$UPDATES
static final boolean commitUpdateUsernames$UPDATES
static final boolean rollbackUpdateUsernames$UPDATES
static final boolean uncompleteActivity$UPDATES
static final boolean setApplicationAdministratorGroup$UPDATES
static final boolean reloadProperties$UPDATES
static final boolean validate$UPDATES
static final boolean setSiteLocaleSettings$UPDATES
static final boolean handleMessages$UPDATES
static final boolean acknowledgeMessages$UPDATES
static final boolean getPmIdForProcess$UPDATES
static final boolean addProcessToFavorites$UPDATES
static final boolean removeProcessFromFavorites$UPDATES
static final boolean addTaskToFavorites$UPDATES
static final boolean removeTaskFromFavorites$UPDATES
static final boolean setDashboardPageForProcesses$UPDATES
static final boolean removeDashboardPageForProcesses$UPDATES
static final boolean getAutoArchiveProperties$UPDATES
static final boolean getMemoryUsageForExecEngine$UPDATES
static final boolean getMemoryUsageForProcessModels$UPDATES
static final boolean getMemoryUsageForProcessModelsByUUID$UPDATES
static final boolean getMemoryUsageForProcesses$UPDATES
static final boolean getMemoryUsageForProcessesByModelUUID$UPDATES
static final boolean getMemoryUsageForNodesInProcesses$UPDATES
static final boolean setTimeZone$UPDATES
static final boolean setTimeZoneSameAs$UPDATES
static final boolean getProcessHistoryRecords$UPDATES
static final boolean getProcessHistoryRecordsPaging$UPDATES
static final boolean getTasksWithStatusForProcessModel$UPDATES
static final boolean getTasksWithStatusForProcessModels$UPDATES
static final boolean getTasksWithStatusForProcess$UPDATES
static final boolean getTasksWithStatusForProcesses$UPDATES
static final boolean completeStore$UPDATES
static final boolean cancelStore$UPDATES
static final boolean processToNextAttended$UPDATES
void saveActivityParameters(java.lang.Long activityId_, ActivityClassParameter[] acps_) throws InvalidActivityException, PrivilegeException, InvalidActivityClassParameterException, InvalidUserException
getActivityMetadata(Long)
. In addition to
persisting parameters for later retrieval, this method is used to set
the parameters for activities executed within the process engine through a
call to execute(Long)
.
The following fields must be populated in the
ActivityClassParameter
objects:
id
,
value
,
type
, and
multiple
activityId_
- the id of the activity whose parameters will be savedacps_
- the parameters for the activity class, with desired values
filled-in.InvalidActivityException
- if the activity specified does not existPrivilegeException
- if the current user does not have permission to
perform this actionjava.lang.NullPointerException
- if acps_
is nullInvalidActivityClassParameterException
- if an
ActivityClassParameter
provided does not existInvalidUserException
- if any of the users referenced by a
ActivityClassParameter
does not existServiceException
- if any system-level error occursjava.lang.Long completeActivity(java.lang.Long activityId_, ActivityReturnVariable[] outputs_) throws InvalidActivityException, InvalidStateException, PrivilegeException, InvalidActivityClassParameterException, InvalidUserException
ActivityReturnVariable
s
should be the identical to those provided by getActivityMetadata(java.lang.Long)
,
except for having the values filled-in.activityId_
- the id of the activity that has been completedoutputs_
- the return values of the completed activitynull
otherwise.InvalidActivityException
- if the activity does not existInvalidStateException
- if activity is in a state other than
in-progress, or if it is not a Java activity (attended or
unattended)java.lang.NullPointerException
- if outputs_
is nullPrivilegeException
- (for attended only) if user is not the task
owner or does not have permission to complete taskInvalidActivityClassParameterException
- if an
ActivityClassParameter
provided does not existInvalidUserException
- if any of the users referenced by a
ActivityReturnVariable
do not existServiceException
- if any system-level error occurs@Deprecated void acknowledgeActivity(java.lang.Long activityId_) throws InvalidActivityException
activityId_
- the id of the activity that has been completedInvalidActivityException
- if the activity does not existServiceException
- if any system-level error occurs@Deprecated void acknowledgeActivity(java.lang.Long[] activityId_) throws InvalidActivityException
activityId_
- the id of the activity that has been completedInvalidActivityException
- if the activity does not existServiceException
- if any system-level error occursjava.lang.Long completeClone(java.lang.Long activityId_, ActivityClassParameter[] inputs_, ActivityReturnVariable[] outputs_) throws InvalidActivityException, InvalidStateException, PrivilegeException, InvalidActivityClassParameterException, InvalidUserException
activityId_
- the id of the task to clone and completeinputs_
- the parameters for the activity class, with desired values
filled inoutputs_
- the return values of the completed activitynull
otherwiseInvalidActivityException
- if the activity does not existInvalidStateException
- if activity is in a state other than
in-progress, or if it is not a Java activity (attended or unattended)PrivilegeException
- (for attended only) if user is not the task
owner or does not have permission to complete taskInvalidActivityClassParameterException
- if an
ActivityClassParameter
provided does not existInvalidUserException
- if any of the users referenced by a
ActivityReturnVariable
do not existResultPage getLingeringTasksForProcess(java.lang.Long processId_, boolean recursive, int startIndex_, int batchSize_, java.lang.Integer sortProperty_, java.lang.Integer sortOrder_) throws InvalidProcessException
processId_
- the id of the process for which the lingering tasks
should be retrievedrecursive
- whether to return the lingering tasks of the sub-processes
of the given process alsostartIndex_
- the index into the collection of total results at which
to start. Negative numbers are treated as zeros.batchSize_
- the number of results to return. use of
Constants.COUNT_ALL
will
result in the entire collection being returned, but this is
STRONGLY discouraged.sortProperty_
- the property by which the results will be sorted
This is one of the SORT_BY_XXX
constants in
TaskSummary
sortOrder_
- Constants.SORT_ORDER_ASCENDING
for sorting results in ascending order,
Constants.SORT_ORDER_DESCENDING
for sorting results in descending orderInvalidProcessException
- if the given process id is invalidTaskSummary[] getLingeringTasksForProcessAndNode(java.lang.Long processId_, java.lang.Long nodeId_) throws InvalidProcessException, InvalidNodeException
processId_
- the id of the process for which to retrieve the
lingering nodesnodeId_
- the id of the node within the model of the given process
for which to retrieve the lingering nodesInvalidProcessException
- if the given process id is invalidInvalidNodeException
- if the given node id is invalid@Deprecated void refreshTaskForm(java.lang.Long activityId_) throws InvalidActivityException, java.lang.IllegalArgumentException, PrivilegeException
activityId_
- the id of the taskInvalidActivityException
- if the given activity id is invalidjava.lang.IllegalArgumentException
- if the given task is not attendedPrivilegeException
- if the current user does not have sufficient
privileges to complete the given taskjava.lang.Long execute(java.lang.Long activityId_) throws InvalidActivityException, PrivilegeException, InvalidStateException
saveActivityParameters(java.lang.Long, com.appiancorp.suiteapi.process.ActivityClassParameter[])
.activityId_
- the id of the activity to executenull
otherwise.InvalidActivityException
- if the task does not existPrivilegeException
- if user is not the task owner or does not
have permission to complete taskInvalidStateException
- if the process is in paused by exception or
cancelled state, or if the task is not in-progress, or if the activity is
not implemented within the process engine (attended or unattended)ServiceException
- if any system-level error occursActivityExecutionMetadata getActivityMetadata(java.lang.Long activityId_) throws InvalidActivityException
execute(java.lang.Long)
) or outside of the engine
(see completeActivity(java.lang.Long, com.appiancorp.suiteapi.process.ActivityReturnVariable[])
).activityId_
- the id of the activity for which to get metadataActivityExecutionMetadata
for the activityInvalidActivityException
- if the activity does not existServiceException
- if any system-level error occursActivityExecutionMetadata[] getActivitiesMetadata(java.lang.Long[] activityIds_) throws InvalidActivityException
getActivityMetadata(java.lang.Long)
, but in bulk.activityIds_
- an array of the ids of the activities for which to
get metadataInvalidActivityException
- if the activity does not existServiceException
- if any system-level error occursjava.lang.String getTaskFormExpression(java.lang.Long taskId) throws InvalidActivityException
taskId
- the id of the task for which to get the task formInvalidActivityException
- if the activity does not existServiceException
- if any system-level error occursjava.lang.String[] getTaskFormExpressions(java.lang.Long[] taskIds) throws InvalidActivityException
getTaskFormExpression(Long)
, but in bulk.taskIds
- an array of the ids of the tasks for which to get the task formsInvalidActivityException
- if the activity does not existServiceException
- if any system-level error occursjava.lang.Integer acceptTask(java.lang.Long activityId_) throws InvalidActivityException, PrivilegeException
activityId_
- id of Task to acceptTASK_ACCEPTANCE_XXX
constants.InvalidActivityException
- if the task does not existPrivilegeException
- if the current user does not have permission to
perform this actionServiceException
- if any system-level error occursjava.lang.Integer getTaskPrivileges(java.lang.Long activityId_) throws InvalidActivityException, PrivilegeException
activityId_
- The id of the activity for which to get the privileges.TASK_PRIVILEGE_XXX
constants. If the task is completed then
this method will always return TASK_PRIVILEGE_REASSIGN_ANY
.InvalidActivityException
- if the task does not existPrivilegeException
- if the current user does not have permission to
perform this actionServiceException
- if any system-level error occursAssignment.Assignee[] getTaskAssignees(java.lang.Long taskId_) throws InvalidActivityException, PrivilegeException
taskId_
- The id of the task for which to get assignees.InvalidActivityException
- if the task does not existPrivilegeException
- if the current user does not have permission to
perform this actionServiceException
- if any system-level error occursAssignment.Assignee[][] getTasksAssignees(java.lang.Long[] taskIds_) throws InvalidActivityException, PrivilegeException
taskIds_
- The ids of the tasks for which to get assigneesInvalidActivityException
- if the task does not existPrivilegeException
- if the current user does not have permission to
perform this actionServiceException
- if any system-level error occursAssignment.Assignee[] getAssigneePoolForTasks(java.lang.Long[] taskIds_) throws InvalidActivityException, InvalidOperationException, PrivilegeException
taskIds_
- the ids of the tasks for which to get assigneesInvalidActivityException
- if the task does not existInvalidOperationException
- if any task is unattendedPrivilegeException
- if the current user does not have permission to
perform this actionServiceException
- if any system-level error occursvoid reassignTask(java.lang.Long taskId_, Assignment.Assignee[] assignees_) throws InvalidActivityException, InvalidStateException, PrivilegeException, InvalidUserException, InvalidOperationException
taskId_
- ID of the task to reassignassignees_
- the new assignees for the task. Note that the
privilege
field will be ignored for all assignees that are
already in the assignment pool.InvalidActivityException
- if the task does not existInvalidStateException
- if the task has been cancelledPrivilegeException
- if the user does not have sufficient privileges
to perform this actionInvalidUserException
- if any of the users referenced by an
Assignment.Assignee
does not existServiceException
- if any system-level error occursInvalidOperationException
java.lang.Integer rejectTask(java.lang.Long taskId_) throws InvalidActivityException, InvalidStateException, InvalidOperationException, PrivilegeException
taskId_
- the ID of the task to rejectTASK_REJECTION_RESULT_SUCCESS
TASK_REJECTION_RESULT_INVALID_STATE
TASK_REJECTION_RESULT_NOT_OWNER
InvalidActivityException
- if the task is invalidPrivilegeException
- if the current user is the owner of the task but
does not have permission to reject the task (the user was explicitly
denied that privilege)ServiceException
- if any system-level error occursInvalidStateException
InvalidOperationException
TaskDetails getTaskDetails(java.lang.Long taskId_) throws InvalidActivityException, PrivilegeException
taskId_
- The id of the task for which to get details.TaskDetails
bean will be an empty array.InvalidActivityException
- if the task does not existPrivilegeException
- if the current user does not have permission to
perform this actionServiceException
- if any system-level error occursTaskDetails[] getTasksDetails(java.lang.Long[] taskIds_) throws InvalidActivityException, PrivilegeException
taskIds_
- The ids of the tasks for which to get details.TaskDetails
bean will be an empty
array.InvalidActivityException
- if the task does not existPrivilegeException
- if the current user does not have permission to
perform this actionServiceException
- if any system-level error occursjava.lang.String getTaskOpaqueUri(java.lang.Long taskId_)
taskId_
- The id of the task for which to get the opaque URI.java.lang.String getTaskUrl(java.lang.Long taskId_)
taskId_
- The id of the task for which to get the URL.ProcessDetails getProcessDetails(java.lang.Long processId_) throws InvalidProcessException, ArchivedProcessException, PrivilegeException
processId_
- The id of the process for which to get the details.InvalidProcessException
- if the specified process does not existPrivilegeException
- if the user does not have sufficient privileges
to perform this actionServiceException
- if any system-level error occursArchivedProcessException
void notifyException(java.lang.Long activityId_, java.lang.String exceptionClassName_, java.lang.String message_, java.lang.String stackTrace_) throws InvalidActivityException, InvalidStateException
activityId_
- ID of the Activity on which the exception occurredexceptionClassName_
- the fully qualified class name of the exceptionmessage_
- message of the exceptionstackTrace_
- stack trace of the exceptionInvalidActivityException
- if the activity specified does not existInvalidStateException
- if the process is in any state other than
in-progressServiceException
- if any system-level error occurs@Deprecated void executionFailure(int errorType_, java.lang.Long[] activities_) throws InvalidActivityException, InvalidStateException, java.lang.IllegalArgumentException
errorType_
- this is one of the EXECUTION_FAILURE_XXX
constants. For EXECUTION_FAILURE_EXCEPTION
, don't attempt to
execute again until configurable delay has passed. For
EXECUTION_FAILURE_TIMEOUT
, attempt to execute again at next
usual execution time.activities_
- acitivites that failed to executeInvalidActivityException
- if the activity specified does not existInvalidStateException
- if the process is in any state other than
in-progress, or if the process is not unattended, or if it is not a Java
activityjava.lang.IllegalArgumentException
- if errorType_
is invalidServiceException
- if any system-level error occurs@Deprecated void executionFailureMessage(int errorType_, java.lang.Long[] activities_, java.lang.String message_) throws InvalidActivityException, InvalidStateException, java.lang.IllegalArgumentException
errorType_
- this is one of the EXECUTION_FAILURE_XXX
constants. For EXECUTION_FAILURE_EXCEPTION
, don't attempt to
execute again until configurable delay has passed. For
EXECUTION_FAILURE_TIMEOUT
, attempt to execute again at next
usual execution time.activities_
- activities that failed to executemessage_
- exception messageInvalidActivityException
- if the activity specified does not existInvalidStateException
- if the process is in any state other than
in-progress, or if the process is not unattended, or if it is not a Java
activityjava.lang.IllegalArgumentException
- if errorType_
is invalidServiceException
- if any system-level error occursvoid deleteProcess(java.lang.Long processId_, boolean deleteSubProcesses_) throws InvalidProcessException, PrivilegeException
processId_
- the id of the process to deletedeleteSubProcesses_
- true
if all the sub
processes in this process should also be deleted;
false
if not.InvalidProcessException
- if the process does not existPrivilegeException
- If the user does not have sufficient privileges
to perform this actionServiceException
- if any system-level error occursvoid deleteProcesses(java.lang.Long[] processIds_, boolean deleteSubProcesses_) throws InvalidProcessException, PrivilegeException
deleteProcess(java.lang.Long, boolean)
, but in bulk. Purges process history in Kafka.processIds_
- the ids of the processes to deletedeleteSubProcesses_
- true
if all the sub
processes should be deleted; false
if not.InvalidProcessException
- if the process does not existPrivilegeException
- If the user does not have sufficient privileges
to perform this actionServiceException
- if any system-level error occursvoid cancelProcess(java.lang.Long processId_, boolean cancelLinkedProcesses_) throws InvalidProcessException, InvalidStateException, PrivilegeException, LockException
processId_
- the id of the process to cancelcancelLinkedProcesses_
- true
if all the linked
processes should be cancelled; false
if not.InvalidProcessException
- if the specified process does not existInvalidStateException
- if the specified process is not active or
already cancelledPrivilegeException
- if the current user does not have privileges
to cancel the specified processLockException
- if the process is lockedServiceException
- if any system-level error occurslockProcessModelForProcess(Long, boolean)
void notifyInvalidParameters(java.lang.Long activityId_, ActivityClassParameter[] acps_) throws InvalidActivityException, InvalidStateException, java.lang.IllegalArgumentException, InvalidActivityClassParameterException
ActivityParameterHelper.validate(com.appiancorp.suiteapi.process.ActivityClassParameter[], java.lang.Object, boolean, com.appiancorp.services.ServiceContext, com.appiancorp.suiteapi.process.framework.MessageHolder)
returned false.activityId_
- The ID of the activity for which validation failedacps_
- The parameters with validation messages populated.InvalidActivityException
- if the activity does not existInvalidStateException
- if activity is in a state other than
in-progressjava.lang.NullPointerException
- if acps_
is nulljava.lang.IllegalArgumentException
- if the ACP array is empty, or if no ACPs
had validation messagesInvalidActivityClassParameterException
- if an
ActivityClassParameter
provided does not existServiceException
- if any system-level error occurs@Deprecated void notifyUsersCreationByJava(java.lang.Long activityId_, java.lang.String[] usernames_) throws InvalidActivityException, java.lang.NullPointerException
activityId_
- The ID of the activity for which validation failedusernames_
- the names of the users that were addedInvalidActivityException
- if the activity does not existjava.lang.NullPointerException
- if any of the usernames are null
@Deprecated void notifyUsersCreationByJava(java.lang.String[] usernames_) throws java.lang.NullPointerException
usernames_
- the names of the users that were addedjava.lang.NullPointerException
- if any of the usernames are null
int checkActivityValidity(java.lang.Long activityId_) throws java.lang.NullPointerException
activityId_
- the id of the activityACTIVITY_XXX
constantsjava.lang.NullPointerException
- if the activityId_ is nullServiceException
- if any system-level error occursboolean canCompleteActivity(java.lang.Long activityId_)
false
will be returned.activityId_
- the id of the activitytrue
, if the user can complete the activity;
false
otherwiseServiceException
- if any system-level error occursboolean canCompleteClone(java.lang.Long activityId_)
completeClone(java.lang.Long, com.appiancorp.suiteapi.process.ActivityClassParameter[], com.appiancorp.suiteapi.process.ActivityReturnVariable[])
on the
given task to complete the activity. Ensures that the specified task
is the correct type of task (quick task) and is in a proper state to be
completed by the current user.activityId_
- the id of the activity (aka task)@Deprecated ResultList getSubProcessesForProcess(java.lang.Long processId_, int subProcessStatus_) throws InvalidProcessException, PrivilegeException
getSynchronousSubProcessesForProcess(Long, int)
instead.processId_
- The id of the process for which to get subprocesses.subProcessStatus_
- The status of the subprocesses to get,
designated by one of the STATE_XXX
constants in
ProcessSummary
. Use
Constants.COUNT_ALL
to retrieve
subprocesses in any state.ResultList
containing ProcessSummary
objects for the subprocesses of the given process. The result codes can be
ResultList.CODE_NO_PERMISSION
or
ResultList.CODE_VALID
InvalidProcessException
- If the process is invalid.PrivilegeException
- If the user does not have sufficient privileges
to retrieve the subprocesses of this process.ServiceException
- if any system-level error occursResultList getSynchronousSubProcessesForProcess(java.lang.Long processId_, int synchronousSubProcessStatus_) throws InvalidProcessException, PrivilegeException
processId_
- the id of the process to get synchronous subprocesses forsynchronousSubProcessStatus_
- filters results by returning only those
subprocesses with the status given here. Possible statuses
are defined in ProcessSummary
and look like STATE_XXX
.
Use Constants.COUNT_ALL
to return
ALL synchronous subprocesses, without filtering by status.ResultList
containing ProcessSummary
objects
that represent the synchronous subprocesses. The ResultList
's
result codes can be:
ResultList.CODE_VALID
if the nth subprocess is accessible, or
ResultList.CODE_NO_PERMISSION
if the user does not have
permission to access the nth subprocess.InvalidProcessException
- if the process is invalidPrivilegeException
- if the user does not have sufficient privileges
to perform this operationServiceException
- if any system-level error occursProcessSummary getTopLevelProcessForProcess(java.lang.Long processId_) throws PrivilegeException, InvalidProcessException
processId_
- the id of the process to get the top level
process forProcessSummary
of the
top level process for the given
process if one exists. Returns only true top level processes.
In the case that the process itself is a top level process
the call will return itself.PrivilegeException
- if the user cannot view the top level
process or the current processInvalidProcessException
- if the process specified does not existServiceException
- if any system-level error occurs@Deprecated boolean isSubProcess(java.lang.Long processId_) throws InvalidProcessException
#isSynchronousSubProcesses(Long)
instead.processId_
- the ID of the process to checktrue
if the process given is a subprocess,
otherwise false
InvalidProcessException
- if the process specified does not existServiceException
- if any system-level error occursboolean isSynchronousSubProcess(java.lang.Long processId_) throws InvalidProcessException
processId_
- the ID of the process to checktrue
if the process given is a synchronous subprocess,
otherwise false
InvalidProcessException
- if the process specified does not existServiceException
- if any system-level error occurs@Deprecated boolean containsSubProcesses(java.lang.Long processId_) throws InvalidProcessException
containsSynchronousSubProcesses(Long)
instead.processId_
- the id of the process to check for subprocessestrue
if the process given contains subprocesses,
otherwise false
InvalidProcessException
- if the process specified does not existServiceException
- if any system-level error occurs@Deprecated boolean containsLinkProcesses(java.lang.Long processId_) throws InvalidProcessException
containsAsynchronousSubProcesses(Long)
instead.processId_
- the id of the process to check for linked processestrue
if the process given contains linked processes,
otherwise false
ServiceException
- if any system-level error occursInvalidProcessException
boolean containsSynchronousSubProcesses(java.lang.Long processId_) throws InvalidProcessException
processId_
- the id of the process to checktrue
if the process given contains synchronous subprocesses,
otherwise false
InvalidProcessException
- if the process specified does not existServiceException
- if any system-level error occursjava.lang.Boolean[] containsSynchronousSubProcesses(java.lang.Long[] processId_) throws InvalidProcessException
InvalidProcessException
boolean containsAsynchronousSubProcesses(java.lang.Long processId_) throws InvalidProcessException
processId_
- the id of the process to checktrue
if the process given contains asynchronous subprocesses,
otherwise false
InvalidProcessException
- if the process specified does not existServiceException
- if any system-level error occursjava.lang.Boolean[] containsAsynchronousSubProcesses(java.lang.Long[] processId_) throws InvalidProcessException
InvalidProcessException
@Deprecated ResultList getLinkProcessesForProcess(java.lang.Long processId_, int linkProcessStatus_) throws InvalidProcessException, PrivilegeException
getAsynchronousSubProcessesForProcess(Long, int)
instead.processId_
- the id of the process to get linked processes forlinkProcessStatus_
- the status of the linked processes to get;
designated by one of the STATE_XXX
constants
in ProcessSummary
, or
Constants.COUNT_ALL
to return
linked processes of any statusProcessSummary
objects
for the linked processes of the given process. The result
codes can be:
ResultList.CODE_VALID
if the action succeeded, or
ResultList.CODE_NO_PERMISSION
if the user does not have
permissionInvalidProcessException
- if the process is invalidPrivilegeException
- if the user does not have sufficient privileges
to perform this operationServiceException
- if any system-level error occursResultList getAsynchronousSubProcessesForProcess(java.lang.Long processId_, int asynchronousSubProcessStatus_) throws InvalidProcessException, PrivilegeException
processId_
- the id of the process to get asynchronous subprocesses forasynchronousSubProcessStatus_
- filters results by returning only those
subprocesses with the status given here. Possible statuses
are defined in ProcessSummary
and look like STATE_XXX
.
Use Constants.COUNT_ALL
to return
ALL asynchronous subprocesses, without filtering by status.ResultList
containing ProcessSummary
objects
that represent the asynchronous subprocesses. The ResultList
's
result codes can be:
ResultList.CODE_VALID
if the nth subprocess is accessible, or
ResultList.CODE_NO_PERMISSION
if the user does not have
permission to access the nth subprocess.InvalidProcessException
- if the process is invalidPrivilegeException
- if the user does not have sufficient privileges
to perform this operationServiceException
- if any system-level error occurs@Deprecated boolean isLinkProcess(java.lang.Long processId_) throws InvalidProcessException
isAsynchronousSubProcess(Long)
instead.processId_
- the ID of the process to checktrue
if the given process is a linked process,
otherwise false
InvalidProcessException
- if the process specified does not existServiceException
- if any system-level error occursboolean isAsynchronousSubProcess(java.lang.Long processId_) throws InvalidProcessException
processId_
- the ID of the process to checktrue
if the given process is an asynchronous subprocess,
otherwise false
InvalidProcessException
- if the process specified does not existServiceException
- if any system-level error occursActivityProperties getActivityProperties(java.lang.Long activityId_) throws PrivilegeException, InvalidActivityException
activityId_
- the id of the activity (task)PrivilegeException
- if the user does not have accessInvalidActivityException
- if no activity exists with the given idServiceException
- if any system-level error occursTaskProperties getTaskProperties(java.lang.Long taskId_) throws PrivilegeException, InvalidActivityException
taskId_
- The id of the task.PrivilegeException
- If the user does not have access to the task.InvalidActivityException
- If no task exists with the given id.ServiceException
- if any system-level error occursvoid setTaskProperties(TaskProperties properties_) throws PrivilegeException, InvalidActivityException, InvalidPriorityException
id
of the given properties object.
The following fields must be populated in the TaskProperties
object:
displayName
,
priority
, and
id
The id
field must be populated in the priority
member of the TaskProperties
object
Only displayName
and priority.id
may be updatedproperties_
- the properties of the taskPrivilegeException
- if the user does not have accessInvalidActivityException
- if no activity exists with the given idInvalidPriorityException
- if the call tries to set the priority
of the task to an invalid valueServiceException
- if any system-level error occursvoid setTaskDisplayName(java.lang.Long taskId, LocaleString displayName) throws PrivilegeException, java.lang.IllegalArgumentException, InvalidActivityException
taskId
- the id of the task whose display name should be updateddisplayName
- the string for the new display nameInvalidActivityException
- if there is no task for the specified taskIdjava.lang.IllegalArgumentException
- if the display name is null, empty, or invalidPrivilegeException
- if the user lacks permissions to perform the actionProcessProperties getProcessProperties(java.lang.Long processId_) throws PrivilegeException, InvalidProcessException
processId_
- The id of the process.PrivilegeException
- If the user does not have access to retrieve the
properties of the process.InvalidProcessException
- If no process exists with the given id.ServiceException
- if any system-level error occursvoid setProcessProperties(ProcessProperties properties_) throws PrivilegeException, InvalidProcessException, InvalidPriorityException, InvalidUserException
id
of the given properties object. Only
name
and priority.id
can be updated for the
process.properties_
- The updated properties of the process. Only
name
and priority.id
can be updated for the
process. The following fields must be populated in the passed object:
id
,
name
, and
priority
.
The id
field in the priority
member of the
passed ProcessProperties
object must also be populated.PrivilegeException
- if the user does not have privileges to perform
the given operationInvalidProcessException
- if no process exists with the given idInvalidPriorityException
- if the call tries to set the priority
of the process to an invalid valueInvalidUserException
- if any of the users referenced by the
ProcessProperties
does not existServiceException
- if any system-level error occursProcessVariableInstance[] getProcessParameters(java.lang.Long processId_) throws InvalidProcessException, PrivilegeException
processId_
- The id of the process.InvalidProcessException
- If no such process exists.PrivilegeException
- If the user does not have access to retrieve the
process parameters.ServiceException
- if any system-level error occursProcessVariableInstance getProcessParameter(java.lang.Long processId_, java.lang.String parameterName_) throws InvalidProcessException, InvalidProcessVariableNameException, PrivilegeException
processId_
- The id of the processparameterName_
- The name of the parameter to retrieve.InvalidProcessException
- If no such process exists.InvalidProcessVariableNameException
- If the process exists, but
there is no process parameter with the given name for the process.PrivilegeException
- If the user does not have access to retrieve the
process parameter.ServiceException
- if any system-level error occurs@Deprecated ProcessVariableInstance[] getProcessVariables(java.lang.Long processId_) throws InvalidProcessException, PrivilegeException
getRecursiveProcessVariables(Long, boolean)
instead.processId_
- The id of the process.InvalidProcessException
- If no such process exists.PrivilegeException
- If the user does not have access to retrieve the
process variables for the specified process.ServiceException
- if any system-level error occursProcessVariableInstance[] getRecursiveProcessVariables(java.lang.Long processId_, boolean recursive_) throws InvalidProcessException, PrivilegeException
processId_
- The id of the process.recursive_
- true if you want to retrieve process variables from the
child processes (and their children in turn).InvalidProcessException
- If no such process exists.PrivilegeException
- If the user does not have access to retrieve the
process variables for the specified process.ServiceException
- if any system-level error occursResultPage getProcessVariablesPaging(java.lang.Long processId_, int startIndex_, int batchSize_, java.lang.Integer sortProperty_, java.lang.Integer sortOrder_) throws InvalidProcessException, PrivilegeException
processId_
- The id of the process.startIndex_
- the index into the collection of total results at which
to start. Negative numbers are treated as zeros.batchSize_
- the number of results to return. use of
Constants.COUNT_ALL
will
result in the entire collection being returned, but this is
STRONGLY discouraged.sortProperty_
- the property by which the results will be sorted
This is one of the SORT_BY_XXX
constants in
ProcessVariable
sortOrder_
- Constants.SORT_ORDER_ASCENDING
for sorting results in ascending order,
Constants.SORT_ORDER_DESCENDING
for sorting results in descending orderInvalidProcessException
- If no such process exists.PrivilegeException
- If the user does not have access to retrieve the
process variables for the specified process.ServiceException
- if any system-level error occursProcessVariableInstance getProcessVariable(java.lang.Long processId_, java.lang.String pvName_) throws InvalidProcessException, InvalidProcessVariableNameException, PrivilegeException
processId_
- The id of the process.pvName_
- The name of a process variable.InvalidProcessException
- If no such process exists.InvalidProcessVariableNameException
- If the process exists, but
contains no variable with the given name.PrivilegeException
- If the user does not have access to retrieve the
process variable.ServiceException
- if any system-level error occursvoid setProcessVariables(java.lang.Long pProcessId_, ProcessVariableInstance[] pvs_) throws InvalidProcessException, InvalidProcessVariableNameException, PrivilegeException, InvalidUserException
#addProcessVariable(Long, ProcessVariable)
or
#addProcessVariables(Long, ProcessVariable[])
. The process
variables should be first retrieved via getProcessVariables(java.lang.Long)
,
and their values set appropriately, before calling this method.pProcessId_
- the id of the processpvs_
- the variables to setInvalidProcessException
- if no such process existsInvalidProcessVariableNameException
- if one of the names in pvs_
refers to a variable that does not exist in the given processPrivilegeException
- if the user does not have sufficent privielges
to perform this operationInvalidUserException
- if any of the users referenced by a
ProcessVariable
does not existServiceException
- if any system-level error occursvoid setProcessVariable(java.lang.Long pProcessId_, ProcessVariableInstance pv_) throws InvalidProcessException, InvalidProcessVariableNameException, PrivilegeException, InvalidUserException
ProcessExecutionService#addProcessVariable(Long, ProcessVariable)
or
ProcessExecutionService#addProcessVariables(Long, ProcessVariable[])
.
The process
variable should be first retrieved via getProcessVariable(java.lang.Long, java.lang.String)
,
and its values set appropriately, before calling this method.pProcessId_
- the id of the processpv_
- the variable to setInvalidProcessException
- if no such process existsInvalidProcessVariableNameException
- if the name
of
pv_ refers to a variable that does not exist in the given processPrivilegeException
- if the user does not have sufficent privielges
to perform this operationInvalidUserException
- if any of the users referenced by the
ProcessVariable
does not existServiceException
- if any system-level error occursvoid addProcessVariable(java.lang.Long processId_, ProcessVariableInstance pv_) throws InvalidProcessException, InvalidProcessVariableNameException, DuplicateNameException, PrivilegeException, InvalidUserException
The following fields must be populated in the ProcessVariable
object:
key
,
type
,
multiple
, and
value
processId_
- the id of the processpv_
- a new variable to addInvalidProcessException
- if no such process existsInvalidProcessVariableNameException
- if the name of the process
variable is null
DuplicateNameException
- if a variable with the same name already
exists for the processPrivilegeException
- if the user does not have sufficent privielges
to perform this operationInvalidUserException
- if any of the users referenced by the
ProcessVariable
does not existServiceException
- if any system-level error occursvoid addProcessVariables(java.lang.Long processId_, ProcessVariableInstance[] pvs_) throws InvalidProcessException, InvalidProcessVariableNameException, DuplicateNameException, PrivilegeException, InvalidUserException
The following fields must be populated in each ProcessVariable
object:
key
,
type
,
multiple
, and
value
processId_
- the id of the processpvs_
- the new variables to addInvalidProcessException
- if no such process existsInvalidProcessVariableNameException
- if the name of one of the
process variables is null
DuplicateNameException
- if a variable with the same name as one of
the process variables that already exists for the processPrivilegeException
- if the user does not have sufficent privileges
to perform this operationInvalidUserException
- if any of the users referenced by a
ProcessVariable
does not existServiceException
- if any system-level error occursSecurity getSecurityForProcess(java.lang.Long id_) throws InvalidProcessException, PrivilegeException
id_
- The id of the process.Security
object containing a ProcessRoleMap
which encapsulates the security configuration of the processInvalidProcessException
- if the process specified does not existPrivilegeException
- if the current user does not have changeRole
privileges for the processServiceException
- if any system-level error occursvoid setSecurityForProcess(java.lang.Long id_, Security s_) throws InvalidProcessException, PrivilegeException, InvalidUserException
canInherit
and inheritable
.id_
- the id of the processs_
- a Security
object containing a ProcessRoleMap
which encapsulates the security configuration of the processInvalidProcessException
- if the process specified does not existPrivilegeException
- if the current user does not have changeRole
privileges for the processInvalidUserException
- if any of the users referenced by the
Security
does not existServiceException
- if any system-level error occursSecurity getSecurityForNode(java.lang.Long id_) throws InvalidActivityException, PrivilegeException
id_
- The id of the primary activity of the node.Security
object containing a ProcessRoleMap
which encapsulates the security configuration of the processInvalidActivityException
- if the task specified does not existPrivilegeException
- if the current user does not have changeRole
privileges for the taskServiceException
- if any system-level error occursvoid setSecurityForNode(java.lang.Long id_, Security s_) throws InvalidActivityException, PrivilegeException, InvalidUserException
canInherit
and
inheritable
.id_
- the unique Id of the primary activity of the
ProcessNode
instances_
- a Security
object containing a ProcessRoleMap
which encapsulates the security configuration of the processInvalidActivityException
- if the task specified does not existPrivilegeException
- if the current user does not have changeRole
privileges for the taskInvalidUserException
- if any of the users referenced by the
Security
does not existServiceException
- if any system-level error occursvoid setActorsInRolesForProcess(java.lang.Long id_, java.lang.String[] users_, java.lang.String[][] userRoles_, java.lang.Long[] groups_, java.lang.String[][] groupRoles_) throws InvalidProcessException, PrivilegeException, InvalidUserException
setSecurityForProcess(Long, Security)
id_
- the id of the processusers_
- the list of usernames for users whose roles are to be
added/modified. This parameter can be null, as long as
userRoles_
is also null. If one is null and the other
is not, a NullPointerException will be thrown.userRoles_
- a 2-dimentional array whose first dimension parallels
users_
. The array userRoles_[i] represents
the roles which users_[i] will have. (If this array is
null or zero-length, the user has no explicit permissions for the
process). It is legal to have null within this array.groups_
- the list of group ids for groups whose roles are to be
added/modified. This parameter can be null, as long as
groupRoles_
is also null. If one is null and the other
is not, a NullPointerException will be thrown.groupRoles_
- a 2-dimentional array whose first dimension parallels
groups_
The array groupRoles_[i] represents the roles
which groups_[i] will have. (If this array is null or zero-length,
the group have no explicit permissions for the process). It is legal
to have null within this array.InvalidProcessException
- if the process specified does not existPrivilegeException
- if the current user does not have changeRole
privileges for the processInvalidUserException
- if any of the users referenced does not existServiceException
- if any system-level error occursvoid setActorsInRolesForNode(java.lang.Long id_, java.lang.String[] users_, java.lang.String[][] userRoles_, java.lang.Long[] groups_, java.lang.String[][] groupRoles_) throws InvalidActivityException, PrivilegeException, InvalidUserException
id_
- the id of the primary activity of the nodeusers_
- the list of usernames for users whose roles are to be
added/modified. This parameter can be null, as long as
userRoles_
is also null. If one is null and the other
is not, a NullPointerException will be thrown.userRoles_
- a 2-dimentional array whose first dimension parallels
users_
. The array userRoles_[i] represents
the roles which users_[i] will have. (If this array is
null or zero-length, the user has no explicit permissions for the
tasks)groups_
- the list of group ids for groups whose roles are to be
added/modified. This parameter can be null, as long as
groupRoles_
is also null. If one is null and the other
is not, a NullPointerException will be thrown.groupRoles_
- a 2-dimentional array whose first dimension parallels
groups_
The array groupRoles_[i] represents the roles
which groups_[i] will have. (If this array is null or zero-length,
the group have no explicit permissions for the tasks)InvalidActivityException
- if the task specified does not existPrivilegeException
- if the current user does not have changeRole
privileges for the taskInvalidUserException
- if any of the users referenced does not existServiceException
- if any system-level error occursvoid setInheritanceForProcess(java.lang.Long id_, boolean doesInherit_) throws InvalidProcessException, PrivilegeException
id_
- the id of the processdoesInherit_
- true
if the process inherits,
false
otherwise.InvalidProcessException
- if the process specified does not existPrivilegeException
- if the current user does not have changeRole
privileges for the processServiceException
- if any system-level error occursvoid setInheritanceForNode(java.lang.Long id_, boolean doesInherit_) throws InvalidActivityException, PrivilegeException
id_
- the id of the taskdoesInherit_
- true
if the task inherits,
false
otherwise.InvalidActivityException
- if the task specified does not existPrivilegeException
- if the current user does not have changeRole
privileges for the taskServiceException
- if any system-level error occursProcessPermissions getPermissionsForProcess(java.lang.Long id_) throws InvalidProcessException
id_
- The id of the process.InvalidProcessException
- if the process specified does not existServiceException
- if any system-level error occursProcessPermissions[] getPermissionsForProcesses(java.lang.Long[] ids_) throws InvalidProcessException
ids_
- The ids for the processes.InvalidProcessException
- if a specified process does not existServiceException
- if any system-level error occursNodePermissions getPermissionsForNode(java.lang.Long activityId_) throws InvalidActivityException
activityId_
- The primary activity id of the nodeInvalidActivityException
- if the task specified does not existServiceException
- if any system-level error occursNodePermissions[] getPermissionsForNodes(java.lang.Long[] activityIds_) throws InvalidActivityException
activityIds_
- The ids of the primary activities of the nodes.InvalidActivityException
- if a specified task does not existServiceException
- if any system-level error occursProcessModelPermissions getPermissionsForProcessDiagram(java.lang.Long processId_) throws InvalidProcessException
ProcessModelPermissions
object that says which
In-Flight Modifications the user can or cannot perform to a given process.processId_
- The id of the process.InvalidProcessException
- if the process specified does not existServiceException
- if any system-level error occursResultPage getAttachmentsForProcess(java.lang.Long id_, boolean recursive_, int startIndex_, int batchSize_, java.lang.Integer sortProperty_, java.lang.Integer sortOrder_) throws InvalidProcessException, PrivilegeException
id_
- the id of the processrecursive_
- return recursive results if set to truestartIndex_
- the index into the collection of total results at which
to start. Negative numbers are treated as zeros.batchSize_
- the number of results to return. Negative numbers will
result in the entire collection being returned, but this is
STRONGLY discouraged.sortProperty_
- the property by which the results will be sorted.
Should be one of the SORT_BY_XXX
constants on
Attachment
.sortOrder_
- The order in which to sort the results. This should be
either
Constants.SORT_ORDER_ASCENDING
or
Constants.SORT_ORDER_DESCENDING
.ResultPage
containing instances of
Attachment
. The result codes can be:
ResultList.CODE_VALID
if the action succeeded,
ResultList.CODE_NO_PERMISSION
if the user does not have
permission, or
ResultList.CODE_INVALID
if the specified process does not
existInvalidProcessException
- if the process does not existPrivilegeException
- if the current user does not have permission
to perform this actionServiceException
- if any system-level errors occur@Deprecated Attachment[] getAttachmentsForProcess(java.lang.Long processId_) throws InvalidProcessException, PrivilegeException
processId_
- the id of the processInvalidProcessException
- if the process specified does not existPrivilegeException
- if the current user does not have
privileges to perform this actionServiceException
- if any system-level error occursResultPage getAttachmentsAndNotesForTask(java.lang.Long taskId_, boolean recursive_, int startIndex_, int batchSize_, java.lang.Integer sortProperty_, java.lang.Integer sortOrder_) throws InvalidActivityException, PrivilegeException, InvalidOperationException
taskId_
- the id of the taskrecursive_
- when true, fetches the attachments and notes of the parent
process as well. And those of the parent of that parent, etc.,
all the way up the parent process totem.startIndex_
- the index into the collection of total results at which
to start. Negative numbers are treated as zeros.batchSize_
- the number of results to return. Negative numbers will
result in the entire collection being returned, but this is
STRONGLY discouraged.sortProperty_
- the property by which the results will be sorted.
Should be one of the SORT_BY_XXX
constants on
Attachment
.sortOrder_
- The order in which to sort the results. This should be
either
Constants.SORT_ORDER_ASCENDING
or
Constants.SORT_ORDER_DESCENDING
.ResultPage
containing instances of
Attachment
. The result codes can be:
ResultList.CODE_VALID
if the nth attachment/note is accessible,
ResultList.CODE_NO_PERMISSION
if the user does not have
permission to access the nth attachment/note, or
ResultList.CODE_INVALID
if the specified attachment/note does not
existInvalidProcessException
- if the process does not existPrivilegeException
- if the current user does not have permission
to perform this actionServiceException
- if any system-level errors occurInvalidActivityException
InvalidOperationException
Attachment[] getAttachmentsForTask(java.lang.Long taskId_) throws InvalidActivityException, PrivilegeException, InvalidOperationException, InvalidProcessException
taskId_
- the id of the taskInvalidActivityException
- if the task specified does not existPrivilegeException
- if the current user does not have
privileges to perform this actionInvalidProcessException
ServiceException
- if any system-level error occursInvalidOperationException
java.lang.Long[] removeProcessAttachments(java.lang.Long[] attachmentIds_, java.lang.Long processId_) throws InvalidProcessException, InvalidStateException
attachmentIds_
- the IDs of the attachments
to removeprocessId_
- the ID of the processArray
containing return codes for each attachment:
ATTACHMENT_RETURN_SUCCESS
if the attachment was added successfully,
ATTACHMENT_RETURN_PERMISSIONS
if the user does not have permission
to remove the attachment, or
ATTACHMENT_RETURN_INVALID
if the attachment does not existInvalidProcessException
- if the process specified does not existInvalidStateException
- if the process is cancelledServiceException
- if any system-level error occursjava.lang.Long removeProcessAttachment(java.lang.Long attachmentId_, java.lang.Long processId_) throws InvalidProcessException, InvalidStateException
attachmentId_
- the ID of the attachment to removeprocessId_
- the ID of the processATTACHMENT_RETURN_SUCCESS
if the attachment was added successfully,
ATTACHMENT_RETURN_PERMISSIONS
if the user does not have permissions
to remove the attachment, or
ATTACHMENT_RETURN_INVALID
if the attachment does not existInvalidProcessException
- if the process does not existInvalidStateException
- if the process is cancelledServiceException
- if any system-level error occursjava.lang.Long[] removeTaskAttachments(java.lang.Long[] attachmentIds_, java.lang.Long taskId_) throws InvalidActivityException, InvalidStateException, InvalidOperationException
attachmentIds_
- the ids of the attachments to removetaskId_
- the id of the specified taskArray
containing return codes for each attachment:
ATTACHMENT_RETURN_SUCCESS
if the attachment was added successfully,
ATTACHMENT_RETURN_PERMISSIONS
if the user does not have permissions
to remove the attachment, or
ATTACHMENT_RETURN_INVALID
if the attachment does not existInvalidActivityException
- if the task specified does not existInvalidStateException
- if the task is cancelledServiceException
- if any system-level error occursInvalidOperationException
java.lang.Long removeTaskAttachment(java.lang.Long attachmentId_, java.lang.Long taskId_) throws InvalidActivityException, InvalidStateException
attachmentId_
- the id of the Attachment
to removetaskId_
- the id of taskATTACHMENT_RETURN_SUCCESS
if the attachment was added successfully,
ATTACHMENT_RETURN_PERMISSIONS
if the user does not have permissions
to remove the attachment, or
ATTACHMENT_RETURN_INVALID
if the attachment does not existInvalidActivityException
- if the task specified does not existInvalidStateException
- if the task is cancelledServiceException
- if any system-level error occursjava.lang.Long addAttachmentToProcess(java.lang.Long processId_, Attachment attachment_) throws PrivilegeException, InvalidProcessException, InvalidStateException, ProcessAttachmentsLimitException
The following fields must be populated in the Attachment
object:
attachedObject
(with type and either id or stringId), and
attachedUrl
processId_
- Id of processattachment_
- the Attachment
to add to the processPrivilegeException
- if the user does not have sufficent privileges
to add attachments to this process - that is, if
ProcessPermissions.isAddAttachment()
returns
false
InvalidProcessException
- if the process specified does not existInvalidStateException
- if the process is cancelledProcessAttachmentsLimitException
- if no more attachments can be
added to the processServiceException
- if any system-level error occursgetPermissionsForProcess(Long)
java.lang.Long[] addAttachmentToProcesses(java.lang.Long[] processIds_, Attachment attachment_)
The following fields must be populated in the Attachment
object:
attachedObject
(with type and either id or stringId),
attachedUrl
, and
comment
(can be an empty string)
processIds_
- IDs of processesattachment_
- the attachment to addATTACHMENT_RETURN_PROCESS_CANCELLED
= Cancelled processATTACHMENT_RETURN_TOO_MANY
= Too many attachmentsATTACHMENT_RETURN_INVALID
= Process does not existATTACHMENT_RETURN_PERMISSIONS
= Insufficient permissionsATTACHMENT_RETURN_SUCCESS
= SuccessfulServiceException
- if any system-level error occursgetPermissionsForProcesses(Long[])
java.lang.Long[] addAttachmentsToProcess(java.lang.Long processId_, Attachment[] attachments_) throws PrivilegeException, InvalidProcessException, InvalidStateException, ProcessAttachmentsLimitException
The following fields must be populated in each Attachment
object:
attachedObject
(with type and either id or stringId),
attachedUrl
, and
comment
(can be an empty string)
processId_
- ID of the Processattachments_
- attachments to add to process.PrivilegeException
- if the user does not have sufficent privileges
to add attachments to this process - that is, if
ProcessPermissions.isAddAttachment()
returns
false
InvalidProcessException
- if the process specified does not exist,
or the processId_
parameter is null.InvalidStateException
- if the process is cancelledProcessAttachmentsLimitException
- if no more attachments can be
added to the processjava.lang.NullPointerException
- if the attachments_
parameter is
null or contains null values.ServiceException
- if any system-level error occursgetPermissionsForProcess(Long)
java.lang.Long addAttachmentToTask(java.lang.Long taskId_, Attachment attachment_) throws PrivilegeException, InvalidActivityException, InvalidStateException, ProcessAttachmentsLimitException, InvalidOperationException
taskId_
- Id of taskattachment_
- the attachment to add to the taskPrivilegeException
- if the user does not have sufficent privileges
to add attachments to this task - that is, if
NodePermissions.isAddAttachment()
returns
false
InvalidActivityException
- if the task specified does not existInvalidStateException
- if the task is cancelledProcessAttachmentsLimitException
- if no more attachments can be
added to the taskInvalidOperationException
- if the node is unattendedServiceException
- if any system-level error occursgetPermissionsForNode(Long)
java.lang.Long[] addAttachmentToTasks(java.lang.Long[] taskIds_, Attachment attachment_)
taskIds_
- Ids of tasksattachment_
- the attachment to add to the tasksServiceException
- if any system-level error occursgetPermissionsForNodes(Long[])
java.lang.Long[] addAttachmentsToTask(java.lang.Long taskId_, Attachment[] attachments_) throws PrivilegeException, InvalidActivityException, InvalidStateException, InvalidOperationException, ProcessAttachmentsLimitException
taskId_
- the ID of the Task.attachments_
- the attachments to be added to task.PrivilegeException
- if the user does not have sufficent privileges
to add attachments to this task - that is, if
NodePermissions.isAddAttachment()
returns
false
InvalidActivityException
- if the task specified does not existInvalidStateException
- if the task is cancelledProcessAttachmentsLimitException
- if no more attachments can be
added to the taskServiceException
- if any system-level error occursInvalidOperationException
- if the node is unattendedgetPermissionsForNode(Long)
java.sql.Timestamp getDeadlineForProcess(java.lang.Long processId_) throws java.lang.NullPointerException, InvalidProcessException, PrivilegeException
processId_
- The id of the process.null
if no deadline is set.java.lang.NullPointerException
- if processId_
is null
InvalidProcessException
- if the process
does not existPrivilegeException
- if the current user does not have privileges
to perform this actionvoid setDeadlineForProcess(java.lang.Long processId_, java.sql.Timestamp deadline_) throws java.lang.NullPointerException, InvalidProcessException, PrivilegeException
processId_
- The id of a process.deadline_
- The deadline to set for the process, or
null
to disable the deadline for the process.java.lang.NullPointerException
- if processId_
is null
InvalidProcessException
- if the process specified
does not existPrivilegeException
- if the current user does not have privileges
to perform this actionjava.sql.Timestamp getDeadlineForTask(java.lang.Long taskId_) throws java.lang.NullPointerException, InvalidActivityException, PrivilegeException
taskId_
- The id of the task.null
if no deadline is set.java.lang.NullPointerException
- if taskId_
is null
InvalidActivityException
- if the task specified
does not existPrivilegeException
- if the current user does not have privileges
to perform this actionvoid setDeadlineForTask(java.lang.Long taskId_, java.sql.Timestamp deadline_) throws java.lang.NullPointerException, InvalidActivityException, PrivilegeException
taskId_
- The id of a task.deadline_
- The deadline to set for the task, or
null
to disable the deadline for the task.java.lang.NullPointerException
- if taskId_
is null
InvalidActivityException
- if the task specifiedPrivilegeException
- if the current user does not have privileges
to perform this action
does not existPriority getPriorityOfTask(java.lang.Long taskId_) throws InvalidActivityException, PrivilegeException
taskId_
- The id of the task for which to get the priority.InvalidActivityException
- if the task does not exist.PrivilegeException
- if the current user does not have privileges
to perform this actionServiceException
- if any system-level error occursPriority[] getPriorityOfTasks(java.lang.Long[] taskIds_) throws InvalidActivityException, PrivilegeException
taskIds_
- The ids of the tasks for which to get the priorities.InvalidActivityException
- If any of the tasks do not exist.PrivilegeException
- if the current user does not have privileges
to perform this actionServiceException
- if any system-level error occursPriority getPriorityOfProcess(java.lang.Long processId_) throws InvalidProcessException, PrivilegeException
processId_
- The id of the process for which to retrieve the priority.InvalidProcessException
- If the process does not exist.PrivilegeException
- If the user does not have the permissions to
retrieve the priority of the process.ServiceException
- if any system-level error occursPriority[] getPriorityOfProcesses(java.lang.Long[] processIds_) throws InvalidProcessException, PrivilegeException
processIds_
- The ids of the processes for which to retrieve the
priorities.InvalidProcessException
- If any of the processes do not exist.PrivilegeException
- If the user does not have the permissions to
retrieve the priority of any of the processes.ServiceException
- if any system-level error occursvoid setPriorityOfTask(java.lang.Long taskId_, java.lang.Long priorityId_) throws InvalidActivityException, InvalidPriorityException, PrivilegeException, InvalidStateException
taskId_
- the task for which to set the prioritypriorityId_
- the id of the priority
to which to set the task; the id
is one of the ids from web.war/WEB-INF/conf/process/priority-config-process.xmlInvalidActivityException
- if the task does not existInvalidPriorityException
- if the priority does not existPrivilegeException
- if the current user does not have privileges
to perform this actionInvalidStateException
- if the process is already CANCELLED OR COMPLETEDServiceException
- if any system-level error occursvoid setPriorityOfTasks(java.lang.Long[] taskIds_, java.lang.Long priorityId_) throws InvalidActivityException, InvalidPriorityException, PrivilegeException, InvalidStateException
taskIds_
- the tasks for which to set the prioritiespriorityId_
- the id of the priority to which to set the tasks; the id
is one of the ids from web.war/WEB-INF/conf/process/priority-config-process.xmlInvalidActivityException
- if the task does not existInvalidPriorityException
- if the priority does not existPrivilegeException
- if the current user does not have privileges
to perform this actionInvalidStateException
- if the process is already CANCELLED OR PAUSEDServiceException
- if any system-level error occursvoid setPriorityOfProcess(java.lang.Long processId_, java.lang.Long priorityId_, boolean propagatePriorityChangeToSubProcesses_) throws InvalidProcessException, InvalidPriorityException, PrivilegeException, InvalidStateException
processId_
- the id of the processpriorityId_
- the id of the priority to which to set the process; the id
is one of the ids from web.war/WEB-INF/conf/process/priority-config-process.xmlpropagatePriorityChangeToSubProcesses_
- true
if the
priority will propagate to sub processes within this process,
otherwise false
InvalidProcessException
- if the process does not existInvalidPriorityException
- if the priority does not existPrivilegeException
- if the current user does not have privileges
to perform this actionInvalidStateException
- if the process is already CANCELLED OR COMPLETEDServiceException
- if any system-level error occursvoid setPriorityOfProcesses(java.lang.Long[] processIds_, java.lang.Long priorityId_, boolean propagatePriorityChangeToSubProcesses_) throws InvalidProcessException, InvalidPriorityException, PrivilegeException, InvalidStateException
Priority
of the specified processes
ProcessDetails
.processIds_
- the ids of the processes for which to set the
priority
priorityId_
- the priority
to set for the processes; the id
is one of the ids from web.war/WEB-INF/conf/process/priority-config-process.xmlpropagatePriorityChangeToSubProcesses_
- true
if the
priority will propagate to sub processes within the processes,
otherwise false
.InvalidProcessException
- if the process does not existInvalidPriorityException
- if the priority does not existPrivilegeException
- if the current user does not have privileges
to perform this actionInvalidStateException
- if the process is already CANCELLED OR COMPLETEDServiceException
- if any system-level error occursvoid raisePriorityOfTask(java.lang.Long taskId_) throws InvalidActivityException, PrivilegeException, InvalidStateException
taskId_
- the id of the task for which to raise the priorityInvalidTaskExpcetion
- if the task does not existPrivilegeException
- if the user does not have sufficient privileges
to perform this actionInvalidStateException
- if the process is already CANCELLED OR COMPLETEDServiceException
- if any system-level error occursInvalidActivityException
void raisePriorityOfTasks(java.lang.Long[] taskIds_) throws InvalidActivityException, PrivilegeException, InvalidStateException
taskIds_
- the ids of the tasks of which to raise the priorityInvalidActivityException
- if the task does not existPrivilegeException
- if the user does not have sufficient privileges
to perform this actionInvalidStateException
- if the process is already CANCELLED OR COMPLETEDServiceException
- if any system-level error occursvoid raisePriorityOfProcess(java.lang.Long processId_, boolean propagatePriorityChangeToLinkProcesses_) throws InvalidProcessException, PrivilegeException, InvalidStateException
processId_
- the ID of a process of which to raise the prioritypropagatePriorityChangeToLinkProcesses_
- true
if the
priority will propagate to linked processes within the processes,
otherwise false
InvalidProcessException
- if the process does not existPrivilegeException
- if the user does not have sufficient privileges
to perform this actionInvalidStateException
- if the process is already CANCELLED OR COMPLETEDServiceException
- if any system-level error occursvoid raisePriorityOfProcesses(java.lang.Long[] processIds_, boolean propagatePriorityChangeToLinkProcesses_) throws InvalidProcessException, PrivilegeException, InvalidStateException
processIds_
- the ids of the processes of which to raise the prioritypropagatePriorityChangeToLinkProcesses_
- true
if the
priority will propagate to linked processes within the processes,
otherwise false
InvalidProcessException
- if the process does not existPrivilegeException
- if the user does not have sufficient privileges
to perform this actionInvalidStateException
- if the process is already CANCELLED OR COMPLETEDServiceException
- if any system-level error occursvoid lowerPriorityOfTask(java.lang.Long taskId_) throws InvalidActivityException, PrivilegeException, InvalidStateException
taskId_
- the ID of the task of which to lower the priorityInvalidActivityException
- if the task does not existPrivilegeException
- if the user does not have sufficient privileges
to perform this actionInvalidStateException
- if the process is already CANCELLED OR COMPLETEDServiceException
- if any system-level error occursvoid lowerPriorityOfTasks(java.lang.Long[] taskIds_) throws InvalidActivityException, PrivilegeException, InvalidStateException
taskIds_
- the ID's of the tasks of which to lower the priorityInvalidActivityException
- if the task does not existPrivilegeException
- if the user does not have sufficient privileges
to perform this actionInvalidStateException
- if the process is already CANCELLED OR COMPLETEDServiceException
- if any system-level error occursvoid lowerPriorityOfProcess(java.lang.Long processId_, boolean propagatePriorityChangeToLinkProcesses_) throws InvalidProcessException, PrivilegeException, InvalidStateException
processId_
- the ID of the process of which to lower the prioritypropagatePriorityChangeToLinkProcesses_
- true
if the
priority will propagate to linked processes within the process,
otherwise false
InvalidProcessException
- if the specified process does not existPrivilegeException
- if the user does not have sufficient privileges
to perform this actionInvalidStateException
- if the process is already CANCELLED OR COMPLETEDServiceException
- if any system-level error occursvoid lowerPriorityOfProcesses(java.lang.Long[] processIds_, boolean propagatePriorityChangeToLinkProcesses_) throws InvalidProcessException, PrivilegeException, InvalidStateException
processIds_
- the ID's of the processes of which to lower the prioritypropagatePriorityChangeToLinkProcesses_
- true
if the
priority will propagate to linked processes within the processes,
otherwise false
InvalidProcessException
- if the process does not existPrivilegeException
- if the user does not have sufficient privileges
to perform this actionInvalidStateException
- if the process is already CANCELLED OR COMPLETEDServiceException
- if any system-level error occurs@Deprecated boolean containsLinkProcessesInheritingPriority(java.lang.Long processId_) throws InvalidProcessException
containsSubProcessesInheritingPriority(Long)
instead.processId_
- id of process for which to check linked processestrue
if the given process contains at least one
linked process inheriting its priority, false
otherwiseInvalidProcessException
- if the process does not existServiceException
- if any system-level errors occurboolean containsSubProcessesInheritingPriority(java.lang.Long processId_) throws InvalidProcessException
Process
contains sub-processes that
inherit their priority instead of defining their own priority levels.processId_
- The ID of the parent Process
.true
if the given Process
contains at
least one sub-process that inherits its priority and false
otherwise.InvalidProcessException
- If the given Process
does
not exist.ServiceException
- If an error occurs in the backend.NoteMetadata createNoteMetadata(NoteMetadata nm_) throws InvalidUserException
type
nm_
- the note metadata to be createdlocation
field populated, so
that the note can be written to disk using
NotesContentService.createNoteContent(NoteMetadata, String)
InvalidUserException
- if any of the users referenced by the
NoteMetadata
does not existServiceException
- if any system-level errors occurNoteMetadata[] createNoteMetadatas(NoteMetadata[] nms_) throws InvalidUserException
createNoteMetadata(NoteMetadata)
, except in bulknms_
- the note metadatas to be created. If any of the
NoteMetadata
objects is null the method will throw a
NullPointerException.location
field populated, so
that the notes can be created using
NotesContentService.createNoteContent(NoteMetadata, String)
InvalidUserException
- if any of the users referenced by a
NoteMetadata
does not existServiceException
- if any system-level errors occurjava.lang.String getNotePath(java.lang.Long noteId_) throws InvalidNoteException
noteId_
- Note id of the note path to get.InvalidNoteException
- if the note is invalid or does not exist.ServiceException
- if any system-level errors occurjava.lang.String[] getNotePaths(java.lang.Long[] noteIds_) throws InvalidNoteException
noteIds_
- Note ids of the note paths to get.InvalidNoteException
- If any of the notes are invalid or do not
exist.ServiceException
- if any system-level errors occurjava.lang.String[] getCurrentNotePaths()
ServiceException
- if any system-level errors occurvoid setCurrentNotePaths(java.lang.String[] notePaths) throws PrivilegeException, java.lang.IllegalArgumentException
notePaths
- PrivilegeException
- if the current user does not have privileges to
change the paths. Normally this only includes system admins.ServiceException
- if any system-level errors occurjava.lang.IllegalArgumentException
- if the length of the array passed does not
match the number of existing notesNoteMetadata getExceptionNoteMetadataForTask(java.lang.Long taskId_) throws InvalidActivityException
null
if no exceptions have been
raised on the tasktaskId_
- the id of the task for which to get the noteInvalidActivityException
- if no task with the passed id exists.ServiceException
- if any system-level errors occurResultPage getExceptionNoteMetadatasForProcess(java.lang.Long processId_, int startIndex_, int batchSize_, java.lang.Integer sortProperty_, java.lang.Integer sortOrder_) throws InvalidProcessException, PrivilegeException
processId_
- the ID of the processstartIndex_
- The index into the collection of total results at which
to start. Negative numbers are treated as zeros.batchSize_
- The number of results to return. Negative numbers will
result in the entire collection being returned, but
this is STRONGLY discouraged.sortProperty_
- the property by which the results will be sorted.
Should be one of the SORT_BY_XXX
constants on
NoteMetadata
.sortOrder_
- The order in which to sort the results. This should be
either
Constants.SORT_ORDER_ASCENDING
or
Constants.SORT_ORDER_DESCENDING
.ResultPage
containing instances of
NoteMetadata
InvalidProcessException
- if no process with the passed id exists.PrivilegeException
- if the user does not have permissions
to view the note metadatas for the process.ServiceException
- if any system-level errors occurResultPage getAllExceptionNoteMetadatasForProcess(java.lang.Long processId_, int startIndex_, int batchSize_, java.lang.Integer sortProperty_, java.lang.Integer sortOrder_) throws InvalidProcessException, PrivilegeException
processId_
- the ID of the processstartIndex_
- The index into the collection of total results at which
to start. Negative numbers are treated as zeros.batchSize_
- The number of results to return. Negative numbers will
result in the entire collection being returned, but
this is STRONGLY discouraged.sortProperty_
- the property by which the results will be sorted.
Should be one of the SORT_BY_XXX
constants on
NoteMetadata
.sortOrder_
- The order in which to sort the results. This should be
either
Constants.SORT_ORDER_ASCENDING
or
Constants.SORT_ORDER_DESCENDING
.ResultPage
containing instances of
NoteMetadata
InvalidProcessException
- if no process with the passed id exists.PrivilegeException
- if the user does not have permissions
to view the note metadatas for the process.ServiceException
- if any system-level errors occurNoteMetadata createNoteMetadataForProcess(java.lang.Long processId_, NoteMetadata nm_) throws InvalidProcessException, PrivilegeException, InvalidStateException, InvalidUserException, java.lang.NullPointerException, NotesLimitException
type
processId_
- ID of the Processnm_
- the note metadata to be createdlocation
field populated, so
that the note can be written to disk using
NotesContentService.createNoteContent(NoteMetadata, String)
InvalidProcessException
- if the process does not existInvalidStateException
- if the process is cancelled or paused by exceptionPrivilegeException
- if ProcessPermissions.isAddAttachment()
is
false
for current userInvalidUserException
- if any of the users referenced by the
NoteMetadata
does not existjava.lang.NullPointerException
- if nm_
is null
NotesLimitException
- if too many notes have already been added
to the processServiceException
- if any system-level errors occurResultList createNoteMetadataForProcesses(java.lang.Long[] processIds_, NoteMetadata nm_) throws InvalidUserException, java.lang.NullPointerException
type
processIds_
- Ids of the Processesnm_
- the note metadata to be createdResultList
of String
objects,
representing the location of the notes. Each of the result codes
returned will be one of the NOTE_CREATION_PROCESS_XXX
constantsInvalidUserException
- if any of the users referenced by the
NoteMetadata
does not existjava.lang.NullPointerException
- if nm_
is null
or
processIds_
is null
or both
processIds_
and nm_
are null
.ServiceException
- if any system-level errors occurResultList createNoteMetadatasForProcess(java.lang.Long processId_, NoteMetadata[] nms_) throws InvalidProcessException, InvalidStateException, PrivilegeException, InvalidUserException
type
Creating multiple notes for a single process will throw exceptions
for process conditions - for example if the process does not exist
or if the process is in an invalid state. Otherwise,
any errors such as insufficient permissions to create a certain note
will be returned in the ResultList
's result codes.processId_
- Id of the Processnms_
- the note metadatas to be createdResultList
of String
objects, representing
the location of the notes, so
that the notes can be written to disk using
NotesContentService.createNoteContent(NoteMetadata, String)
.
Each of the returned result codes in the ResultList
will be one of NOTE_CREATION_PROCESS_NOTE_LIMIT_EXCEEDED
,
NOTE_CREATION_PROCESS_INSUFFICIENT_PRIVILEGES
,
NOTE_CREATION_PROCESS_SUCCESS
, or
#NOTE_CREATION_PROCESS_INVALID_BEAN)
InvalidProcessException
- if the process does not existInvalidStateException
- if the process is cancelledPrivilegeException
- if ProcessPermissions.isAddAttachment()
is
false
for current userInvalidUserException
- if any of the users referenced by a
NoteMetadata
does not existServiceException
- if any system-level errors occurResultPage getNoteMetadatasForProcess(java.lang.Long id_, boolean recursive_, int startIndex_, int batchSize_, java.lang.Integer sortProperty_, java.lang.Integer sortOrder_) throws InvalidProcessException, PrivilegeException
id_
- the id of the processrecursive_
- return recursive results if set to truestartIndex_
- the index into the collection of total results at which
to start. Negative numbers are treated as zeros.batchSize_
- the number of results to return. Negative numbers will
result in the entire collection being returned, but this is
STRONGLY discouraged.sortProperty_
- the property by which the results will be sorted.
Should be one of the SORT_BY_XXX
constants on
NoteMetadata
.sortOrder_
- The order in which to sort the results. This should be
either
Constants.SORT_ORDER_ASCENDING
or
Constants.SORT_ORDER_DESCENDING
.ResultPage
containing instances of
NoteMetadata
. The result codes can be:
ResultList.CODE_VALID
if the action succeeded,
ResultList.CODE_NO_PERMISSION
if the user does not have
permission, or
ResultList.CODE_INVALID
if the specified process does not
existInvalidProcessException
- if the process does not existPrivilegeException
- if the current user does not have permission
to perform this actionServiceException
- if any system-level errors occurResultList getNoteMetadatasForProcesses(java.lang.Long[] ids_)
ids_
- the process idsResultList
containing instances of
NoteMetadata
ServiceException
- if any system-level errors occur@Deprecated ResultPage getNoteMetadatasForProcess(java.lang.Long id_, int startIndex_, int batchSize_, java.lang.Integer sortProperty_, java.lang.Integer sortOrder_) throws InvalidProcessException, PrivilegeException
id_
- the id of the processstartIndex_
- the index into the collection of total results at which
to start. Negative numbers are treated as zeros.batchSize_
- the number of results to return. Negative numbers will
result in the entire collection being returned, but this is
STRONGLY discouraged.sortProperty_
- the property by which the results will be sorted.
Should be one of the SORT_BY_XXX
constants on
NoteMetadata
.sortOrder_
- The order in which to sort the results. This should be
either
Constants.SORT_ORDER_ASCENDING
or
Constants.SORT_ORDER_DESCENDING
.ResultPage
containing instances of
NoteMetadata
. The result codes can be:
ResultList.CODE_VALID
if the action succeeded,
ResultList.CODE_NO_PERMISSION
if the user does not have
permission, or
ResultList.CODE_INVALID
if the specified process does not
existInvalidProcessException
- if the process does not existPrivilegeException
- if the current user does not have permission
to perform this actionServiceException
- if any system-level errors occurNoteMetadata createNoteMetadataForTask(java.lang.Long taskId_, NoteMetadata nm_) throws InvalidActivityException, PrivilegeException, InvalidStateException, InvalidOperationException, InvalidUserException, java.lang.NullPointerException, NotesLimitException
type
taskId_
- ID of the tasknm_
- the note metadata to be createdlocation
field populated, so
that the note can be written to disk using
NotesContentService.createNoteContent(NoteMetadata, String)
InvalidActivityException
- if the task does not existInvalidStateException
- if the task is in states
TaskSummary.TASK_STATUS_CANCELLED
,
TaskSummary.TASK_STATUS_ABORTED
,
TaskSummary.TASK_STATUS_ERROR
, or if the process is in state
ProcessSummary.STATE_CANCELLED
PrivilegeException
- if NodePermissions.isAddAttachment()
is
false
for current userInvalidOperationException
- if the activity is unattendedInvalidUserException
- if any of the users referenced by the
NoteMetadata
does not existjava.lang.NullPointerException
- if nm_
is null
ServiceException
- if any system-level errors occurNotesLimitException
ResultList createNoteMetadataForTasks(java.lang.Long[] taskIds_, NoteMetadata nm_) throws InvalidUserException, java.lang.NullPointerException
type
taskIds_
- IDs of the tasksnm_
- the note metadata to be createdResultList
containing one String
,
representing the location where the NoteMetadata
is
stored so that the notes can be written to disk using
NotesContentService.createNoteContent(NoteMetadata, String)
.
The result code returned in the ResultList
will be one
of the NOTE_CREATION_TASK_XXX
constantsInvalidUserException
- if any of the users referenced by a
NoteMetadata
does not existjava.lang.NullPointerException
- if nm_
is null
ServiceException
- if any system-level errors occurResultList createNoteMetadatasForTask(java.lang.Long taskId_, NoteMetadata[] nms_) throws InvalidActivityException, InvalidStateException, PrivilegeException, InvalidOperationException, InvalidUserException
type
Creating multiple notes for a single task will throw exceptions
for task conditions - for example if the task does not exist
or if the task is in an invalid state. Otherwise,
any errors such as insufficient permissions to create a certain note
will be returned in the ResultList
's result codes.taskId_
- ID of Tasknms_
- the note metadatas to be createdResultList
of NoteMetadata
objects, with the
location field populated so
that the notes can be written to disk using
NotesContentService.createNoteContent(NoteMetadata, String)
.
Each of the returned result codes in the ResultList
will be one of NOTE_CREATION_TASK_NOTE_LIMIT_EXCEEDED
,
NOTE_CREATION_TASK_INSUFFICIENT_PRIVILEGES
,
NOTE_CREATION_TASK_SUCCESS
, or
NOTE_CREATION_TASK_INVALID_BEAN
InvalidActivityException
- if the task does not existInvalidStateException
- if the task is in states
TaskSummary.TASK_STATUS_CANCELLED
,
TaskSummary.TASK_STATUS_ABORTED
,
TaskSummary.TASK_STATUS_ERROR
, or if the process is in state
ProcessSummary.STATE_CANCELLED
PrivilegeException
- if the current user does not have privileges
to perform this actionInvalidOperationException
- if the activity is unattendedInvalidUserException
- if any of the users referenced by a
NoteMetadata
does not existServiceException
- if any system-level errors occurResultPage getNoteMetadatasForTask(java.lang.Long id_, boolean includeProcess_, int startIndex_, int batchSize_, java.lang.Integer sortProperty_, java.lang.Integer sortOrder_) throws InvalidActivityException, PrivilegeException, InvalidOperationException
id_
- the task idincludeProcess_
- true
if the note metadata of the parent
process should be returned as well; false
otherwisestartIndex_
- the index into the collection of total results at which
to start. Negative numbers are treated as zeros.batchSize_
- the number of results to return. Negative numbers will
result in the entire collection being returned, but this is
STRONGLY discouraged.sortProperty_
- the property by which the results will be sorted.
Should be one of the SORT_BY_XXX
constants on
NoteMetadata
.sortOrder_
- The order in which to sort the results. This should be
either
Constants.SORT_ORDER_ASCENDING
or
Constants.SORT_ORDER_DESCENDING
.ResultPage
containing instances of
NoteMetadata
InvalidActivityException
- if the task specified does not existPrivilegeException
- if the current user does not have privileges
to perform this actionServiceException
- if any system-level errors occurInvalidOperationException
ResultList getNoteMetadatasForTasks(java.lang.Long[] ids_, boolean includeProcess_)
ids_
- the task idsincludeProcess_
- if true
, includes Process Notes,
otherwise does not.String
locations for storing
the note contents using
NotesContentService
.
The result codes can be:
ResultList.CODE_VALID
if the action succeeded,
ResultList.CODE_NO_PERMISSION
if the user does not have
permission, or
ResultList.CODE_INVALID
if the specified task does not
existServiceException
- if any system-level errors occurjava.lang.String deleteNoteMetadataForProcess(java.lang.Long noteId_, java.lang.Long processId_) throws InvalidProcessException, PrivilegeException, InvalidStateException, InvalidNoteException
noteId_
- ID of note to deleteprocessId_
- ID of the process from which to delete the noteInvalidProcessException
- if the process specified does not existPrivilegeException
- if the current user does not have privileges
to perform this actionInvalidStateException
- if the process is cancelledInvalidNoteException
- if the note specified does not existjava.lang.NullPointerException
- if noteId_
is null
ServiceException
- if any system-level error occursjava.lang.String deleteNoteMetadataForTask(java.lang.Long noteId_, java.lang.Long taskId_) throws InvalidActivityException, PrivilegeException, InvalidStateException, InvalidOperationException, InvalidNoteException
noteId_
- ID of Note to deletetaskId_
- ID of the task from which the note is to be deletedInvalidActivityException
- if the task specified does not existPrivilegeException
- if the current user does not have privileges
to perform this actionInvalidStateException
- if the task is cancelledInvalidOperationException
- if the activity is unattendedInvalidNoteException
- if the note specified does not existServiceException
- if any system-level error occursResultList deleteNoteMetadatasForProcess(java.lang.Long[] noteIds_, java.lang.Long processId_) throws InvalidProcessException, InvalidStateException
noteIds_
- IDs of notes to deleteprocessId_
- ID of the process from which to delete the notesResultList
of String
objects,
representing the location of the deleted notes.
Each of the returned result codes in the ResultList
will be one of NOTE_DELETION_INVALID
,
NOTE_DELETION_INSUFFICIENT_PRIVILEGES
or
NOTE_DELETION_SUCCESS
InvalidProcessException
- if the process specified does not existInvalidStateException
- if the process is cancelledjava.lang.NullPointerException
- if noteIds_
is null
ServiceException
- if any system-level error occursResultList deleteNoteMetadatasForTask(java.lang.Long[] noteIds_, java.lang.Long taskId_) throws InvalidActivityException, InvalidStateException, InvalidOperationException
noteIds_
- IDs of notes to deletetaskId_
- ID of the task from which to delete the notesResultList
of String
objects,
representing the location of the deleted notes.
Each of the returned result codes in the ResultList
will be one of NOTE_DELETION_INVALID
,
NOTE_DELETION_INSUFFICIENT_PRIVILEGES
or
NOTE_DELETION_SUCCESS
InvalidActivityException
- if the task specified does not existInvalidStateException
- if the task is cancelledInvalidOperationException
- if the activity is unattendedServiceException
- if any system-level error occursNoteMetadata updateNoteMetadataForProcess(NoteMetadata nm_, java.lang.Long processId_) throws InvalidProcessException, InvalidStateException, PrivilegeException, InvalidNoteException, InvalidUserException
The following field must be populated in the NoteMetadata
object:
id
nm_
- updated NoteMetadata ObjectNoteMetadata
with updated infoInvalidProcessException
- if the process does not existInvalidStateException
- if the process is cancelledPrivilegeException
- if the current user does not have privileges
to update the noteInvalidNoteException
- if the note specified does not existInvalidUserException
- if any of the users referenced by the
NoteMetadata
does not existServiceException
- if any system-level error occursNote
NoteMetadata updateNoteMetadataForTask(NoteMetadata nm_, java.lang.Long taskId_) throws InvalidActivityException, InvalidStateException, PrivilegeException, InvalidOperationException, InvalidNoteException, InvalidUserException
The following field must be populated in the NoteMetadata
object:
id
nm_
- updated NoteMetadata
ObjectNoteMetadata
InvalidActivityException
- if the task does not existInvalidStateException
- if the task is in states
TaskSummary.TASK_STATUS_CANCELLED
,
TaskSummary.TASK_STATUS_ABORTED
,
TaskSummary.TASK_STATUS_ERROR
, or if the process is in state
ProcessSummary.STATE_CANCELLED
InvalidOperationException
- if the activity is unattendedInvalidNoteException
- if the note specified does not existPrivilegeException
- if the current user does not have privileges
to update the noteInvalidUserException
- if any of the users referenced by the
NoteMetadata
does not existServiceException
- if any system-level error occursNote
ResultList updateNoteMetadatasForProcess(NoteMetadata[] nms_, java.lang.Long processId_) throws InvalidStateException, InvalidProcessException, InvalidUserException
ResultList
's result codes:
NOTES_RETURN_SUCCESS
if the note was added successfully,
NOTES_RETURN_PERMISSIONS
if the user does not have permission
to remove the note, or
NOTES_RETURN_INVALID
if the note does not exist
The following field must be populated in each NoteMetadata
object:
id
nms_
- Array of updated NoteMetadata
Objects.NoteMetadatas
and result codes, which compared with the
constants in Note
tells the user if the Note
was successfully updated or notInvalidProcessException
- if the process specified does not existInvalidStateException
- if the process is cancelledInvalidUserException
- if any of the users referenced by a
NoteMetadata
does not existServiceException
- if any system-level error occursNote
ResultList updateNoteMetadatasForTask(NoteMetadata[] nms_, java.lang.Long taskId_) throws InvalidActivityException, InvalidStateException, InvalidOperationException, InvalidNoteException, InvalidUserException
ResultList
's result codes.
The following field must be populated in each NoteMetadata
object:
id
nms_
- Array of updated NoteMetadata
Objects.NoteMetadatas
and result codes:
NOTES_RETURN_SUCCESS
if the note was added successfully,
NOTES_RETURN_PERMISSIONS
if the user does not have permission
to remove the note, or
NOTES_RETURN_INVALID
if the note does not existInvalidActivityException
- if the task does not existInvalidStateException
- if the task is in states
TaskSummary.TASK_STATUS_CANCELLED
,
TaskSummary.TASK_STATUS_ABORTED
,
TaskSummary.TASK_STATUS_ERROR
, or if the process is in state
ProcessSummary.STATE_CANCELLED
InvalidOperationException
- if the activity is unattendedInvalidUserException
- if any of the users referenced by a
NoteMetadata
does not existServiceException
- if any system-level error occursInvalidNoteException
Note
NoteMetadata getNoteMetadataForTask(java.lang.Long noteId_, java.lang.Long taskId_) throws InvalidActivityException, PrivilegeException, InvalidNoteException, InvalidNoteException
noteId_
- Note IdtaskId_
- Task IdInvalidActivityException
- if the task specified does not existPrivilegeException
- if the current user does not have privileges
to perform this actionInvalidNoteException
- if the note specified does not existServiceException
- if any system-level errors occurNoteMetadata getNoteMetadataForProcess(java.lang.Long noteId_, java.lang.Long processId_) throws InvalidProcessException, InvalidNoteException, PrivilegeException
noteId_
- Note IdprocessId_
- Process IdInvalidProcessException
- if the process specified does not existPrivilegeException
- if the current user does not have privileges
to perform this actionInvalidNoteException
- if the note specified does not existServiceException
- if any system-level errors occurResultPage getTasksForProcess(java.lang.Long processId_, boolean recursive_, int startIndex_, int batchSize_, java.lang.Integer sortProperty_, java.lang.Integer sortOrder_) throws InvalidProcessException, PrivilegeException
null
.processId_
- The id of the process.recursive_
- return recursive results if set to truestartIndex_
- The index into the collection of total results at which
to start. Negative numbers are treated as zeros.batchSize_
- The number of results to return. Negative numbers will
result in the entire collection being returned, but this is STRONGLY
discouraged.sortProperty_
- The property by which the results will be sorted. This
is one of the SORT_BY_XXX
constants in
TaskSummary
sortOrder_
- The order in which to sort the results. This should be
either
Constants.SORT_ORDER_ASCENDING
or
Constants.SORT_ORDER_DESCENDING
.ResultPage
containing
TaskSummary
objects representing tasks of the process. If a
task is completed then its assignees field will be an empty array.InvalidProcessException
- If the process does not exist or has
been deleted.PrivilegeException
- If the user does not have permissions view
the task summaries for the process.ServiceException
- if any system-level errors occur@Deprecated ResultPage getTasksForProcess(java.lang.Long processId_, int startIndex_, int batchSize_, java.lang.Integer sortProperty_, java.lang.Integer sortOrder_) throws InvalidProcessException, PrivilegeException
null
.processId_
- The id of the process.startIndex_
- The index into the collection of total results at which
to start. Negative numbers are treated as zeros.batchSize_
- The number of results to return. Negative numbers will
result in the entire collection being returned, but this is STRONGLY
discouraged.sortProperty_
- The property by which the results will be sorted. This
is one of the SORT_BY_XXX
constants in
TaskSummary
sortOrder_
- The order in which to sort the results. This should be
either
Constants.SORT_ORDER_ASCENDING
or
Constants.SORT_ORDER_DESCENDING
.ResultPage
containing
TaskSummary
objects representing tasks of the process. If a
task is completed then its assignees field will be an empty array.InvalidProcessException
- If the process does not exist or has
been deleted.PrivilegeException
- If the user does not have permissions view
the task summaries for the process.ServiceException
- if any system-level errors occurvoid pauseProcess(java.lang.Long processId_) throws InvalidProcessException, InvalidStateException, PrivilegeException, LockException
processId_
- ID of the processInvalidProcessException
- if the process does not exist or has
been deletedInvalidStateException
- if the process is cancelled or pausedPrivilegeException
- if the user does not have permission to
pause the process - if ProcessPermissions.isStopAndPause()
returns
false
LockException
- if the process is locked (see
lockProcessModelForProcess(Long,boolean)
)ServiceException
- if any system-level errors occurjava.lang.Integer[] pauseProcesses(java.lang.Long[] processIds_)
RESULT_CODE_SUCCESS
if the action succeeded,
RESULT_CODE_INVALID_PROCESS
if the process does not exist,
RESULT_CODE_INSUFFICIENT_PRIVILEGES
if the user does not have
permission,
RESULT_CODE_INVALID_STATE
if the process is not active, or
RESULT_CODE_LOCK_EXCEPTION
if the specified process is lockedprocessIds_
- IDs of the processesServiceException
- if any system-level errors occurvoid resumeProcess(java.lang.Long processId_) throws InvalidProcessException, InvalidStateException, PrivilegeException, LockException
processId_
- id of the processInvalidProcessException
- if the process does not exist or has
been deletedInvalidStateException
- if the process is not pausedPrivilegeException
- if the user does not have permission to
resume the processLockException
- if the process is locked (see
lockProcessModelForProcess(Long,boolean)
)ServiceException
- if any system-level errors occurjava.lang.Integer[] resumeProcesses(java.lang.Long[] processIds_)
RESULT_CODE_SUCCESS
if the action succeeded,
RESULT_CODE_INVALID_PROCESS
if the process does not exist,
RESULT_CODE_INSUFFICIENT_PRIVILEGES
if the user does not have
permission,
RESULT_CODE_INVALID_STATE
if the process is not active, or
RESULT_CODE_LOCK_EXCEPTION
if the specified process is lockedprocessIds_
- ids of the processesServiceException
- if any system-level errors occurjava.lang.Integer[] cancelProcesses(java.lang.Long[] processIds_, boolean cancelLinkedProcesses_)
processIds_
- the Ids of the processescancelLinkedProcesses_
- specifies whether or not to cancel all linked
processes when cancelling the processesPROCESS_CANCELLATION_XXX
constantsServiceException
- if any system-level error occursgetPermissionsForProcess(Long)
java.lang.Long startQuickTask(java.lang.Long processId_, java.lang.Long nodeId_) throws PrivilegeException, InvalidNodeException, InvalidProcessException, InvalidNodeTypeLogicException, InvalidStateException, InvalidNodeTypeRecurringException, InvalidNodeMultiplicityException
processId_
- The id of the process.nodeId_
- The id of the task's template node, which can be obtained
from the templateId
property of a TaskSummary
object.Long
the task id, if the task started correctly,
null if the node has spawning or recurrence configured.InvalidProcessException
- if the process does not existInvalidNodeException
- the node used does not exist or if the node
exists (it has a valid template) but does not belong to the given processInvalidNodeTypeLogicException
- if the node is a logic node.InvalidStateException
- if the process is paused by exceptionPrivilegeException
- if
NodePermissions.isModifyInFlight()
is false
for the
current userInvalidNodeTypeRecurringException
- if the node is set to recurInvalidNodeMultiplicityException
- if the node cannot be started
because its activity chaining settings prohibit multiple instancesServiceException
- if any system-level error occursboolean startTask(java.lang.Long processId_, java.lang.Long nodeId_) throws PrivilegeException, InvalidNodeException, InvalidProcessException, InvalidNodeTypeLogicException, InvalidStateException, InvalidNodeTypeRecurringException, InvalidNodeMultiplicityException
processId_
- The id of the process.nodeId_
- The id of the task's template node, which can be obtained
from the templateId
property of a TaskSummary
object.true
if the task started correctly, otherwise
false
InvalidProcessException
- if the process does not existInvalidNodeException
- the node used does not exist or if the node
exists (it has a valid template) but does not belong to the given processInvalidNodeTypeLogicException
- if the node is a logic node.InvalidStateException
- if the process is paused by exceptionPrivilegeException
- if
NodePermissions.isModifyInFlight()
is false
for the
current userInvalidNodeTypeRecurringException
- if the node is set to recurInvalidNodeMultiplicityException
- if the node cannot be started
because its activity chaining settings prohibit multiple instancesServiceException
- if any system-level error occursjava.lang.Integer[] startTasks(java.lang.Long processId_, java.lang.Long[] nodeIds_) throws InvalidProcessException
RESULT_CODE_SUCCESS
if the action succeeded,
RESULT_CODE_INVALID_TASK
if the node does not exist,
RESULT_CODE_INSUFFICIENT_PRIVILEGES
if the user does not have
permission, or
RESULT_CODE_INVALID_STATE
if it is a logic node
RESULT_CODE_NODE_MULTIPLICITY
if the node cannot be started
RESULT_CODE_INVALID_NODE
if the node is invalid
because its activity chaining settings prohibit multiple instancesprocessId_
- The id of the process.nodeIds_
- The ids of the tasks' template nodes, each of which can be
obtained from the templateId
property of the corresponding
TaskSummary
object.InvalidProcessException
- if no process exists for the given IDServiceException
- if any system-level error occursvoid resumeTask(java.lang.Long activityId_) throws InvalidActivityException, InvalidStateException, PrivilegeException
activityId_
- the ID of the taskInvalidActivityException
- if the task does not exist or has been
deletedInvalidStateException
- if the task is not PAUSEDPrivilegeException
- if the user does not have permissions to
resume the taskServiceException
- if any system-level error occursNodePermissions.isModifyInFlight()
java.lang.Integer[] resumeTasks(java.lang.Long[] activityIds_)
RESULT_CODE_SUCCESS
if the action succeeded,
RESULT_CODE_INVALID_TASK
if the node does not exist,
RESULT_CODE_INSUFFICIENT_PRIVILEGES
if the user does not have
permission, or
RESULT_CODE_INVALID_STATE
if its state is not paused or
paused-by-exceptionactivityIds_
- the IDs of the tasksServiceException
- if any system-level error occursvoid pauseTask(java.lang.Long activityId_) throws InvalidActivityException, InvalidStateException, PrivilegeException
activityId_
- the ID of the taskInvalidActivityException
- if the task does not exist or has been
deletedInvalidStateException
- if the task has been CANCELLEDPrivilegeException
- if the user does not have permissions to
pause the taskServiceException
- if any system-level error occursjava.lang.Integer[] pauseTasks(java.lang.Long[] activityIds_)
RESULT_CODE_SUCCESS
if the action succeeded,
RESULT_CODE_INVALID_TASK
if the node does not exist,
RESULT_CODE_INSUFFICIENT_PRIVILEGES
if the user does not have
permission, or
RESULT_CODE_INVALID_STATE
if its state is not started, paused,
paused-by-exception, completed, or cancelledactivityIds_
- the IDs of the tasksServiceException
- if any system-level error occursvoid cancelTask(java.lang.Long activityId_) throws InvalidActivityException, InvalidStateException, PrivilegeException
activityId_
- the ID of the taskInvalidActivityException
- if the task does not existInvalidStateException
- if the task is cancelledPrivilegeException
- if the user does not have sufficent privileges
to cancel this task - that is, if
ProcessPermissions.isStopAndPause()
returns
false
for the process containing this taskServiceException
- if any system-level error occursgetPermissionsForProcess(Long)
java.lang.Integer[] cancelTasks(java.lang.Long[] activityIds_)
activityIds_
- the IDs of the tasksTASK_CANCELLATION_XXX
constantsServiceException
- if any system-level error occursNodeActionResult startAllNodes(java.lang.String[] nodeUuids, java.lang.Long[] withinProcessIds, BulkNodeOption... bulkNodeOption) throws InvalidProcessException
nodeUuids
- The uuids of the tasks' template nodes, each of which can be
obtained from the uuid
property of the corresponding
TaskSummary
object.withinProcessIds
- list of process ids; a null list means all
processes containing these nodes.InvalidProcessException
- if no process exists for the given ID. If
an invalid process id is passed in withinProcessIds, it's thrown immediately
before any actions.ServiceException
- if any system-level error occursNodeActionResult restartAllNodes(java.lang.String[] nodeUuids, java.lang.Long[] withinProcessIds, BulkNodeOption... bulkNodeOption) throws InvalidProcessException
nodeUuids
- The uuids of the tasks' template nodes, each of which can be
obtained from the uuid
property of the corresponding
TaskSummary
object.withinProcessIds
- list of process ids; a null list means all
processes containing these nodes.InvalidProcessException
- if no process exists for the given ID. If
an invalid process id is passed in withinProcessIds, it's thrown immediately
before any actions.ServiceException
- if any system-level error occursNodeActionResult pauseAllNodes(java.lang.String[] nodeUuids, java.lang.Long[] withinProcessIds) throws InvalidProcessException
nodeUuids
- The uuids of the tasks' template nodes, each of which can be
obtained from the uuid
property of the corresponding
TaskSummary
object.withinProcessIds
- list of process ids; a null list means all
processes containing these nodes.InvalidProcessException
- if no process exists for the given ID. If
an invalid process id is passed in withinProcessIds, it's thrown immediately
before any actions.ServiceException
- if any system-level error occursNodeActionResult resumeAllNodes(java.lang.String[] nodeUuids, java.lang.Long[] withinProcessIds) throws InvalidProcessException
nodeUuids
- The uuids of the tasks' template nodes, each of which can be
obtained from the uuid
property of the corresponding
TaskSummary
object.withinProcessIds
- list of process ids; a null list means all
processes containing these nodes.InvalidProcessException
- if no process exists for the given ID. If
an invalid process id is passed in withinProcessIds, it's thrown immediately
before any actions.ServiceException
- if any system-level error occursNodeActionResult cancelAllNodes(java.lang.String[] nodeUuids, java.lang.Long[] withinProcessIds) throws InvalidProcessException
nodeUuids
- The uuids of the tasks' template nodes, each of which can be
obtained from the uuid
property of the corresponding
TaskSummary
object.withinProcessIds
- list of process ids; a null list means all
processes containing these nodes.InvalidProcessException
- if no process exists for the given ID. If
an invalid process id is passed in withinProcessIds, it's thrown immediately
before any actions.ServiceException
- if any system-level error occursvoid reassignTaskToSameAssigneePool(java.lang.Long activityId_) throws InvalidActivityException, InvalidStateException, PrivilegeException
activityId_
- the ID of the taskInvalidActivityException
- if the task does not exist or has been
deletedInvalidStateException
- if the task is not assigned or acceptedPrivilegeException
- if the user does not have permissions to
reassign the taskServiceException
- if any system-level error occurs@Deprecated java.lang.Integer[] reassignTasksToAssigneePool(java.lang.Long[] activityIds_, Assignment.Assignee[] assignees_) throws InvalidUserException
reassignTask(java.lang.Long, com.appiancorp.suiteapi.process.Assignment.Assignee[])
insteadRESULT_CODE_SUCCESS
if the action succeeded,
RESULT_CODE_INVALID_TASK
if the node does not exist,
RESULT_CODE_INSUFFICIENT_PRIVILEGES
if the user does not have
permission, or
RESULT_CODE_INVALID_STATE
if the task is not assigned or
acceptedactivityIds_
- the IDs of the tasksassignees_
- the assignees to whom the task will be reassigned
All the tasks will be assigned to the same assignee arrayInvalidUserException
- if any of the users referenced by an
Assignment.Assignee
does not existServiceException
- if any system-level error occursjava.lang.Integer[] reassignTasksToSameAssigneePool(java.lang.Long[] activityIds_)
RESULT_CODE_SUCCESS
if the action succeeded,
RESULT_CODE_INVALID_TASK
if the node does not exist,
RESULT_CODE_INSUFFICIENT_PRIVILEGES
if the user does not have
permission, or
RESULT_CODE_INVALID_STATE
if the task is not assigned or
acceptedactivityIds_
- the IDs of the tasksServiceException
- if any system-level error occursProcessDiagram getProcessDiagram(java.lang.Long processId_, int typeOfNotesToRetrieve_) throws InvalidProcessException, PrivilegeException, java.lang.IllegalArgumentException
processId_
- The id of the process.typeOfNotesToRetrieve_
- This is one of
RETRIEVE_PROCESS_MODEL_NOTES
or RETRIEVE_PROCESS_NOTES
InvalidProcessException
- If the process does not exist.PrivilegeException
- If the user does not have permissions to retrieve the
process or the process diagram of the process.java.lang.IllegalArgumentException
- if typeOfNotesToRetrieve_
is
invalidServiceException
- if any system-level error occurs@Deprecated ProcessDiagram updateProcessModelForProcess(java.lang.Long processId_, ProcessDiagram pd_, ProcessModel[] childProcessModels_) throws InvalidProcessException, LockException, PrivilegeException
upgradeProcesses(java.lang.Long, java.lang.String, java.lang.Long[])
insteadProcessDesignService.versionProcessModel(ProcessModel)
. The following
fields are not updated on the process model: creatorUsername
,
latestVersion
, version
, variables
processId_
- the id of the process, which is an instance of the
process model.pd_
- the process diagram of the process to be updated. This should be
retrieved by a call to getProcessDiagram(java.lang.Long, int)
.childProcessModels_
- the sub and linked process models for this
updating process modelInvalidProcessException
- if the process does not existLockException
- if the process is currently lockedPrivilegeException
- if the user does not have permission to update
the process (if ProcessPermissions#isModifyInFlight
returns
false
)java.lang.IllegalArgumentException
- if the ProcessModel bean passed in has
any nodes with non-null IDs that are not in the current version of the
process model.ServiceException
- if any system-level error occursUpgradeResult upgradeProcesses(java.lang.Long toProcessModelId, java.lang.String toVersion, java.lang.Long[] processIds) throws InvalidProcessModelException, InvalidVersionException, PrivilegeException, InvalidStateException, UpgradeException
toProcessModelId
- the id of the process model to upgrade totoVersion
- the version of the process model to upgrade to, exactly as it appears in the
user interface. For instance, "2.0" or "3.7"processIds
- InvalidProcessModelException
- if the specified process model id does not existInvalidVersionException
- if the specified process model version does not existPrivilegeException
- if the user performing the action does not have sufficient
privileges to view or initiate the specified process modelInvalidStateException
UpgradeException
UpgradeResult upgradeProcesses(java.lang.Long toProcessModelId, java.lang.String toVersion, java.lang.Long fromProcessModelId, java.lang.String[] fromVersions) throws InvalidProcessModelException, InvalidVersionException, PrivilegeException, InvalidStateException, UpgradeException
toProcessModelId
- the id of the process model to upgrade totoVersion
- the version of the process model to upgrade to, exactly as it appears in the
user interface. For instance, "2.0" or "3.7"fromProcessModelId
- the id of the process model to upgrade fromfromVersions
- the version of the process model to upgrade fromInvalidProcessModelException
- if the process model id specified by 'toProcessModelId'
does not existInvalidVersionException
- if the process model version specified by 'toVersion' does not
existPrivilegeException
- if the user performing the action does not have sufficient
privileges to view or initiate the specified process modelInvalidStateException
UpgradeException
void triggerSchedule(java.lang.Integer scheduleType_, java.lang.Long scheduleId_) throws InvalidScheduleTypeException, InvalidActivityException, InvalidNodeException, PrivilegeException, InvalidStateException
scheduleType_
- the schedule type. This should be one of
ScheduleSummary.SCHEDULE_TYPE_PENDING_SINGLE
, used for a delayed individual task, or
ScheduleSummary.SCHEDULE_TYPE_PENDING_MULTIPLE
, used for recurring tasks.scheduleId_
- the schedule ID. This is the ID of a
ScheduleSummary
retrieved from
getScheduleSummariesForNode(Long, Long, int, int, Integer, Integer)
InvalidScheduleTypeException
- if the schedule type is invalidInvalidActivityException
- if the schedule type is
SCHEDULE_TYPE_PENDING_SINGLE
, and the schedule ID does
not correspond to a valid taskInvalidNodeException
- if the schedule type is
SCHEDULE_TYPE_PENDING_MULTIPLE
, and the schedule ID does
not correspond to a valid nodePrivilegeException
- if the the user does not have sufficient
permissions to perform this operation - that is, if
ProcessPermissions.isModifyInFlight()
would return false for the
process in question.InvalidStateException
- if the task delay has already passed,
or if the task's status is TaskSummary.TASK_STATUS_CANCELLED
ServiceException
- if any system-level error occursScheduleSummary
void triggerTaskEscalation(java.lang.Long activityId_, java.lang.Long escalationId_) throws InvalidActivityException, InvalidStateException, InvalidEscalationException, PrivilegeException
activityId_
- the id of the taskescalationId_
- the id of the escalationInvalidActivityException
- if the task does not existInvalidStateException
- if the task has been completed,
or cancelled,
or if the escalation has already lapsed or the task has not yet been
startedInvalidEscalationException
- if the escalation does not existPrivilegeException
- if the the user does not have sufficient -
permissions to perform this operationServiceException
- if any system-level error occursEscalationInstance
void skipTaskEscalation(java.lang.Long activityId_, java.lang.Long escalationId_) throws InvalidActivityException, InvalidStateException, InvalidEscalationException, PrivilegeException
activityId_
- the id of the taskescalationId_
- the id of the escalationInvalidActivityException
- if the task does not existInvalidStateException
- if the task has been completed,
or cancelled,
or if the escalation has already lapsedInvalidEscalationException
- if the escalation does not existPrivilegeException
- if NodePermissions.isModifyInFlight()
is
false
for the current userEscalationInstance
ResultPage getScheduleSummariesForNode(java.lang.Long processId_, java.lang.Long nodeId_, int startIndex_, int batchSize_, java.lang.Integer sortProperty_, java.lang.Integer sortOrder_) throws InvalidNodeException, PrivilegeException, InvalidProcessException
processId_
- the ID of the processnodeId_
- the ID of the RuntimeProcessNode
in the processstartIndex_
- the index into the collection of total results at which
to start. Negative numbers are treated as zeros.batchSize_
- the number of results to return. use of
Constants.COUNT_ALL
will
result in the entire collection being returned, but this is
STRONGLY discouraged.sortProperty_
- the property by which the results will be sorted
This is one of the SORT_BY_XXX
constants in
ScheduleSummary
sortOrder_
- Constants.SORT_ORDER_ASCENDING
for sorting results in ascending order,
Constants.SORT_ORDER_DESCENDING
for sorting results in descending orderResultPage
of ScheduleSummary
objects;
ResultPage
contains an empty list of results if the node is
not scheduled to spawn or recur, or if no spawns have occurred.InvalidNodeException
- if the node does not existPrivilegeException
- if the user does not have sufficient privileges
to perform this actionInvalidProcessException
- if the process does not existServiceException
- if any system-level error occursvoid lockProcessModelForProcess(java.lang.Long processId_, boolean override_) throws InvalidProcessException, PrivilegeException, LockException, ArchivedProcessException, InvalidStateException
processId_
- the ID of the processoverride_
- true
to override lock status, if the process
model is already locked by another userInvalidProcessException
- if the process does not existPrivilegeException
- if the user does not have sufficient privileges
to perform this actionLockException
- if the user cannot override the lock, if the process
model is already currently lockedArchivedProcessException
- if the process is archivedInvalidStateException
ServiceException
- if any system-level error occursunlockProcessModelForProcess(java.lang.Long, boolean)
int[] lockProcesses(java.lang.Long[] processIds, boolean override)
processIds
- the ids of the processes to be lockedoverride
- true
to override lock status, if the process is already locked by
another userint[] unlockProcesses(java.lang.Long[] processIds, boolean override)
processIds
- the ids of the processes to be unlockedoverride
- true
to override lock status, if the process is locked by
another uservoid unlockProcessModelForProcess(java.lang.Long processId_, boolean override_) throws InvalidProcessException, PrivilegeException, LockException
processId_
- the id of the processoverride_
- true
to override lock status, if the process
model is locked by another userInvalidProcessException
- if the process does not existPrivilegeException
- if the user does not have sufficient privileges
to perform this actionServiceException
- if any system-level error occursLockException
- if the user cannot override the lock, if the process
model is already currently lockedlockProcessModelForProcess(java.lang.Long, boolean)
void unlockProcessModels()
ServiceException
- if any system-level error occursint getMaximumNumberOfNotes()
int getMaximumNumberOfAttachments()
RecurrenceInstance skipRecurrence(java.lang.Long processId_, java.lang.Long nodeId_, java.lang.Long recurrenceNumber_) throws InvalidProcessException, InvalidStateException, PrivilegeException, InvalidNodeException
processId_
- process which the node resides innodeId_
- id of the node to skip the next recurrence ofrecurrenceNumber_
- which recurrence to skip. For each node, the
recurrences are numbered starting at 0. The next recurrence number can
be obtained by calling getNextRecurrence(Long,Long)
RecurrenceInstance
with id
and
scheduledTime
populatedInvalidProcessException
- if the process does not existInvalidNodeException
- if the node template does not existInvalidStateException
- if the node does not have an recurrence
instance, the recurrence has passed or the node has not been reached, or
if the recurrence being skipped is not the next recurrence.PrivilegeException
- if the user does not have privilegesRecurrence
RecurrenceInstance triggerRecurrence(java.lang.Long processId_, java.lang.Long nodeId_, java.lang.Long recurrenceNumber_) throws InvalidProcessException, InvalidStateException, PrivilegeException, InvalidNodeException
processId_
- process which the node resides innodeId_
- ID of the RuntimeProcessNode
to skip the next
recurrence ofrecurrenceNumber_
- the recurrence of the node to skip.
For each node, the recurrences are numbered starting at 0. The next
recurrence number is the ID of the RecurrenceInstance
obtained by
calling getNextRecurrence(Long,Long)
, with parameters
processId_
and nodeId_
id
and
scheduledTime
populatedInvalidProcessException
- if the process does not existInvalidStateException
- if the node does not have recurrences,
the recurrence being skipped is not the next recurrence, the recurrence
has already passed or has not been reached.InvalidNodeException
- if the node template does not existPrivilegeException
- if the user does not have privileges. That is
if NodePermissions.isModifyInFlight()
is false
Recurrence
void setTaskStateSubmitted(java.lang.Long taskId_) throws PrivilegeException, InvalidActivityException
taskId_
- Id of the Task that is sumitted.PrivilegeException
- if the user cannot complete the task or is not the task owner of attended task.InvalidActivityException
- if the task does not exist.void keepSubmittedTasksAlive(java.lang.Long[] activities_) throws PrivilegeException, InvalidActivityException
activities_
- ID's of the tasks that are in the queuePrivilegeException
- if the user cannot complete the task or is not the task owner of any attended tasks in the list.InvalidActivityException
- if any task does not existServiceException
- if any system-level error occursvoid setTaskStateRunning(java.lang.Long taskId_) throws PrivilegeException, InvalidActivityException
taskId_
- Id of the task that RunningPrivilegeException
- if the user cannot complete the task or is not the task owner of attended task.InvalidActivityException
- if the task does not exist.ResultPage getCurrentTasksForProcess(java.lang.Long processId_, int type_, int startIndex_, int batchSize_, java.lang.Integer sortProperty_, java.lang.Integer sortOrder_) throws InvalidProcessException, PrivilegeException
processId_
- the ID of the processtype_
- type of tasks to return. This is one of:
UNATTENDED_TASKS
ATTENDED_TASKS
UNATTENDED_AND_ATTENDED_TASKS
startIndex_
- the index into the collection of total results at which
to start. Negative numbers are treated as zeros.batchSize_
- the number of results to return. use of
Constants.COUNT_ALL
will
result in the entire collection being returned, but this is
STRONGLY discouraged.sortProperty_
- the property by which the results will be sorted
This is one of the SORT_BY_XXX
constants in
TaskSummary
sortOrder_
- Constants.SORT_ORDER_ASCENDING
for sorting results in ascending order,
Constants.SORT_ORDER_DESCENDING
for sorting results in descending orderResultPage
of TaskSummary
objects.InvalidProcessException
- if the process does not existPrivilegeException
- if the user does not have sufficient privileges
to perform this actionServiceException
- if any system-level error occursResultPage getCompletedTasksForProcess(java.lang.Long processId_, int type_, int startIndex_, int batchSize_, java.lang.Integer sortProperty_, java.lang.Integer sortOrder_) throws InvalidProcessException, PrivilegeException
processId_
- the ID of the processtype_
- type of tasks to returnThis is one of:
UNATTENDED_TASKS
ATTENDED_TASKS
UNATTENDED_AND_ATTENDED_TASKS
startIndex_
- the index into the collection of total results at which
to start. Negative numbers are treated as zeros.batchSize_
- the number of results to return. use of
Constants.COUNT_ALL
will
result in the entire collection being returned, but this is
STRONGLY discouraged.sortProperty_
- the property by which the results will be sorted
This is one of the SORT_BY_XXX
constants in
TaskSummary
sortOrder_
- Constants.SORT_ORDER_ASCENDING
for sorting results in ascending order,
Constants.SORT_ORDER_DESCENDING
for sorting results in descending orderResultPage
of TaskSummary
objects. If a
task is completed then its assignees field will be an empty array.InvalidProcessException
- if the process does not existPrivilegeException
- if the user does not have sufficient privileges
to perform this actionServiceException
- if any system-level error occursResultPage getCancelledTasksForProcess(java.lang.Long processId_, int type_, int startIndex_, int batchSize_, java.lang.Integer sortProperty_, java.lang.Integer sortOrder_) throws InvalidProcessException, PrivilegeException
processId_
- the ID of the processtype_
- type of tasks to returnThis is one of:
UNATTENDED_TASKS
ATTENDED_TASKS
UNATTENDED_AND_ATTENDED_TASKS
startIndex_
- the index into the collection of total results at which
to start. Negative numbers are treated as zeros.batchSize_
- the number of results to return. use of
Constants.COUNT_ALL
will
result in the entire collection being returned, but this is
STRONGLY discouraged.sortProperty_
- the property by which the results will be sorted
This is one of the SORT_BY_XXX
constants in
TaskSummary
sortOrder_
- Constants.SORT_ORDER_ASCENDING
for sorting results in ascending order,
Constants.SORT_ORDER_DESCENDING
for sorting results in descending orderResultPage
of TaskSummary
objects.InvalidProcessException
- if the process does not existPrivilegeException
- if the user does not have sufficient privileges
to perform this actionServiceException
- if any system-level error occursResultPage getPausedTasksForProcess(java.lang.Long processId_, int type_, int startIndex_, int batchSize_, java.lang.Integer sortProperty_, java.lang.Integer sortOrder_) throws InvalidProcessException, PrivilegeException
processId_
- the ID of the processtype_
- type of tasks to returnThis is one of:
UNATTENDED_TASKS
ATTENDED_TASKS
UNATTENDED_AND_ATTENDED_TASKS
startIndex_
- the index into the collection of total results at which
to start. Negative numbers are treated as zeros.batchSize_
- the number of results to return. use of
Constants.COUNT_ALL
will
result in the entire collection being returned, but this is
STRONGLY discouraged.sortProperty_
- the property by which the results will be sorted
This is one of the SORT_BY_XXX
constants in
TaskSummary
sortOrder_
- Constants.SORT_ORDER_ASCENDING
for sorting results in ascending order,
Constants.SORT_ORDER_DESCENDING
for sorting results in descending orderResultPage
of TaskSummary
objects.InvalidProcessException
- if the process does not existPrivilegeException
- if the user does not have sufficient privileges
to perform this actionServiceException
- if any system-level error occursResultPage getTasksWithExceptionsForProcess(java.lang.Long processId_, int startIndex_, int batchSize_, java.lang.Integer sortProperty_, java.lang.Integer sortOrder_) throws InvalidProcessException, PrivilegeException
processId_
- the ID of the processstartIndex_
- The index into the collection of total results at which
to start. Negative numbers are treated as zeros.batchSize_
- the number of results to return. use of
Constants.COUNT_ALL
will
result in the entire collection being returned, but this is
STRONGLY discouraged.sortProperty_
- the property by which the results will be sorted
This is one of the SORT_BY_XXX
constants in
TaskSummary
defined in this file.sortOrder_
- The order in which to sort the results. This should be
either
Constants.SORT_ORDER_ASCENDING
or
Constants.SORT_ORDER_DESCENDING
.ResultPage
containing instances of
TaskSummary
. If a
task is completed then its assignees field will be an empty array.InvalidProcessException
- if no process with the specified id exists.PrivilegeException
- if the user does not have permissions to view
the task summaries for the process.ServiceException
- if any system-level error occursvoid unarchiveProcess(java.lang.Long processId_) throws InvalidProcessException, InvalidStateException, IncompatibleArchivedVersionException, PrivilegeException, com.appiancorp.process.engine.ArchiveReadException
processId_
- the id of the process to unarchiveInvalidProcessException
- if the process does not existInvalidStateException
- if the process has not been archivedIncompatibleArchivedVersionException
- if an archived process file is
from an incompatible release versionPrivilegeException
- if the current User
does not have
permission to unarchive the process. Use
ProcessDesignService.getPermissionsForProcessApplication()
to
determine if the User
has permission to unarchive processes.ServiceException
- if any system-level error occurscom.appiancorp.process.engine.ArchiveReadException
java.lang.Integer[] unarchiveProcesses(java.lang.Long[] processIds_) throws PrivilegeException
processIds_
- the ids of the processes to archiveResultList.CODE_VALID
if the action succeeded, or
ResultList.CODE_INVALID
if the specified process does not
existPrivilegeException
- if the user does not have permissions to
unarchive processesServiceException
- if any system-level error occursvoid archiveProcess(java.lang.Long processId_) throws InvalidProcessException, PrivilegeException, InvalidStateException, ArchivedProcessException
processId_
- the id of a process to archiveInvalidProcessException
- if the process does not existArchivedProcessException
- if the process is already archivedPrivilegeException
- if the user does not have the privileges.InvalidStateException
- if process is not completed or canceled
(only completed or canceled process can be archived)ServiceException
- if any system-level error occursjava.lang.Integer[] archiveProcesses(java.lang.Long[] processIds_)
processIds_
- the ids of a processes to archiveResultList.CODE_VALID
if the action succeeded,
ResultList.CODE_NO_PERMISSION
if the user does not have
permission, or
ResultList.CODE_INVALID
if the specified process does not
exist
(only completed or canceled process can be archived)ServiceException
- if any system-level error occursjava.lang.String[] getArchivePaths()
ServiceException
- if any system-level error occursvoid setArchivePaths(java.lang.String[] archivePaths) throws PrivilegeException
archivePaths
- The paths where archived processes will be stored.PrivilegeException
- if the current user does not have privileges to
change the paths. Normally this only includes system admins.ServiceException
- if any system-level error occursgetArchivePaths()
RecurrenceInstance getNextRecurrence(java.lang.Long processId_, java.lang.Long nodeId_) throws InvalidProcessException, InvalidNodeException, PrivilegeException
processId_
- the id of the process to get the recurrence fornodeId_
- the node to get the recurrence forInvalidProcessException
- If the process does not existInvalidNodeException
- if the node is invalidPrivilegeException
- If the user does not have permissions
to the process - if
ProcessPermissions.isModifyInFlight()
returns false
ServiceException
- if any system-level error occursResultList getAttachmentsInProcess(java.lang.Long processId_, java.lang.Long[] attachmentIds_) throws InvalidProcessException
processId_
- the id of the processattachmentIds_
- the unique Ids of the attachments to be retrievedResultList
containing an array of
Attachment
objectsInvalidProcessException
- if the process specified does not existServiceException
- if any system-level error occursResultList getNoteMetadatasInProcess(java.lang.Long processId_, java.lang.Long[] noteIds_) throws InvalidProcessException
processId_
- the id of the processnoteIds_
- the unique Ids of the notes to be retrievedResultList
containing an array of
NoteMetadata
objectsInvalidProcessException
- if the process specified does not existServiceException
- if any system-level error occurs@Deprecated void updateUsernames(java.lang.String[] oldUsernames_, java.lang.String[] newUsernames_, long maxExpirationTimeInSeconds_) throws java.lang.IllegalArgumentException, DuplicateNameException, PrivilegeException
UserService.renameUsersByUuid(java.lang.String[], java.lang.String[])
UserService.renameUsersByUuid(java.lang.String[], java.lang.String[])
Updates a list of old usernames to new usernames.
If successful, this method must be followed by
commitUpdateUsernames()
. After commitUpdateUsernames
has been called, the old usernames will still be active, but will
expire after the interval specified by
maxExpirationTimeInSeconds_
; if updateUsernames
is successful but commitUpdateUsernames
is not called, the
new usernames will not become active.
If unsuccessful, this method should be followed by
rollbackUpdateUsernames()
. This will simply free memory dedicated
to mapping old usernames to new usernames.
oldUsernames_
- the usernames to be updatednewUsernames_
- the usernames to which the old usernames will be
updatedmaxExpirationTimeInSeconds_
- the interval, in seconds, after
commitUpdateUsernames
has been called, after which
the old usernames will expire. If this parameter is zero or a
negative value the old usernames will expire instantly.
After expiration, the old usernames will no longer be valid.java.lang.IllegalArgumentException
- if the length of
oldUsernames_
is not the same as the length of
newUsernames_
.DuplicateNameException
- if any oldUsernames_
or
newUsernames_
contain any duplicates, or if an old
username is being updated to a username that already existsPrivilegeException
- if the current User
does not have
permission to update usernames, as determined by
ProcessDesignService.getSecurityForProcessApplication()
.ServiceException
- if any system-level error occurs@Deprecated void commitUpdateUsernames()
UserService.renameUsersByUuid(java.lang.String[], java.lang.String[])
UserService.renameUsersByUuid(java.lang.String[], java.lang.String[])
Commits an update of usernames.
This method should be preceded by a call to
updateUsernames(String[], String[], long)
. After the commit, the
old usernames will be temporarily active, and will expire after the
interval specified by maxExpirationTimeInSeconds_
; if
commitUpdateUsernames
is not called, the
new usernames will not become active.
ServiceException
- if any system-level error occurs@Deprecated void rollbackUpdateUsernames()
UserService.renameUsersByUuid(java.lang.String[], java.lang.String[])
UserService.renameUsersByUuid(java.lang.String[], java.lang.String[])
Rolls back an update of usernames.
This method should be called if
updateUsernames(String[], String[], long)
is unsuccessful. The
rollback will simply free memory dedicated to mapping old usernames to
new usernames.
ServiceException
- if any system-level error occursActivityExecutionMetadata uncompleteActivity(java.lang.Long activityId_) throws InvalidStateException, PrivilegeException, InvalidActivityException
activityId_
- the id of the activity to uncomplete.InvalidStateException
- if the activity in question is in a state
other than ACCEPTED, ASSIGNED OR COMPLETED. Also if the process
that this task is part off, is paused by exception and the API is
invoked.PrivilegeException
- if the current user does not have permission to
perform this actionjava.lang.NullPointerException
- if activityId_ is nullInvalidActivityException
- if activityId_ is invalid
(i.e. refers to an activity that does not exist)java.lang.IllegalArgumentException
- if the activity is unattended
(such activities are not allowed to be uncompleted, since they would
automatically recomplete with the same behavior).void setApplicationAdministratorGroup(java.lang.Long groupId_) throws PrivilegeException
groupId
- the id of the administrator groupPrivilegeException
- if the current user does not have permission to
perform this actionServiceException
- if any system-level error occurs@Deprecated void reloadProperties()
ServiceException
- if any system-level error occursjava.lang.String validate()
ServiceException
- if any system-level error occursvoid setSiteLocaleSettings(SiteLocaleSettings settings_)
settings_
- The site locale settings.int[] handleMessages(InternalMessage[] messages_)
messages_
- The messages to send to the execution serverjava.lang.NullPointerException
- if any element in messages_ is null or if messages_
itself is nullServiceException
- if any system-level error occurs@Deprecated void acknowledgeMessages(java.lang.Long[] messageIds_)
messageIds_
- The IDs of a set of messagesServiceException
- if any system-level error occursjava.lang.Long getPmIdForProcess(java.lang.Long processId_) throws InvalidProcessException
processId_
- the ID of the processInvalidProcessException
- if the process ID refers to a process that
does not existServiceException
- if any system-level error occursvoid addProcessToFavorites(java.lang.Long processId_) throws InvalidProcessException, PrivilegeException
Process
to the user's favorites list.processId_
- Id of the Process
to be added.InvalidProcessException
- if the Process
specified does
not existPrivilegeException
- if the current user does not have permission to
perform this action on the specified Process
java.lang.NullPointerException
- if processId_
is nullServiceException
- if any system-level error occursvoid removeProcessFromFavorites(java.lang.Long processId_) throws InvalidProcessException
processId_
- The ID of the process to remove from favorites.InvalidProcessException
- if the process does not exist.void addTaskToFavorites(java.lang.Long taskId_) throws InvalidActivityException, PrivilegeException
Task
to the user's favorites list.taskId_
- Id of the task to be added.InvalidActivityException
- if the activity specified does not existPrivilegeException
- if the current user does not have permission to
perform this action on the specified activityjava.lang.NullPointerException
- if taskId_
is nullServiceException
- if any system-level error occursvoid removeTaskFromFavorites(java.lang.Long taskId_) throws InvalidActivityException
processId_
- The ID of the task to remove from favorites.InvalidActivityException
- if the task does not exist.@Deprecated void setDashboardPageForProcesses(java.lang.Long processModelId, java.lang.Long pageId) throws InvalidProcessException, PrivilegeException
ProcessDesignService.setProcessDashboardPageForProcessModel(Long, Long)
instead.processModelId
- The ID of the process model whose processes will be nabbedpageId
- The ID of the page that will serve as the dashboard for those processes.InvalidProcessException
- if the process model does not exist.PrivilegeException
- if the user does not have access to perform this operation.@Deprecated void removeDashboardPageForProcesses(java.lang.Long processModelId) throws InvalidProcessException, PrivilegeException
ProcessDesignService.removeProcessDashboardPageForProcessModel(Long)
instead.processModelId
- the ID of the Process Model
InvalidProcessException
- if the Process Model does not existPrivilegeException
- if the current user does not have access to perform
this operationServiceException
- if any system-level error occursjava.util.Map getAutoArchiveProperties()
SizingReport getMemoryUsageForExecEngine() throws PrivilegeException
SizingReport
which contains top-level summary of
memory usage by various objects in all Execution Engines.SizingReport
PrivilegeException
- if the current user does not have access to perform
this operationSizingReport
SizingReport getMemoryUsageForProcessModels(java.lang.Long[] processModelIds_) throws PrivilegeException
SizingReport
which contains a breakdown of memory
usage by all process instances based off of specific Process Models given
by the Process Model IDs.processModelIDs
- the ids of the process modelsSizingReport
PrivilegeException
- if the current user does not have access to perform
this operationSizingReport
SizingReport getMemoryUsageForProcessModelsByUUID(java.lang.String[] processModelUUIDs_) throws PrivilegeException
SizingReport
which contains a breakdown of memory
usage by all process instances based off of specific Process Models given by
Process Model UUIDs.processModelUUIDs
- the process podel UUIDsSizingReport
PrivilegeException
- if the current user does not have access to perform
this operationSizingReport
SizingReport getMemoryUsageForProcesses(java.lang.Long[] processIds_) throws PrivilegeException, InvalidProcessException
SizingReport
which contains a breakdown of memory
usage by individual process instancesprocessIDs
- ID's of process instances.SizingReport
PrivilegeException
- if the current user does not have access to perform
this operationInvalidProcessException
- If any of the processes do not existSizingReport
SizingReport getMemoryUsageForProcessesByModelUUID(java.lang.String[] processModelUUIDs_) throws PrivilegeException
SizingReport
which contains a breakdown of memory
usage by individual process instances based of of specific Process Models
given by Process Model UUIDs.processModelUUIDs
- UUID's of process modelsSizingReport
PrivilegeException
- if the current user does not have access to perform
this operationSizingReport
SizingReport getMemoryUsageForNodesInProcesses(java.lang.Long[] processIds_) throws PrivilegeException, InvalidProcessException
SizingReport
which contains a breakdown of memory
usage by individual nodes/activities in specific Process instances.processIDs
- ID's of process instancesSizingReport
PrivilegeException
- if the current user does not have access to perform
this operationInvalidProcessException
- If any of the processes do not existSizingReport
void setTimeZone(BackendTimeZoneSimple tz)
GlobalizationService.setTimeZone(com.appiancorp.suiteapi.portal.BackendTimeZoneSimple)
to set the time zone across all engines (rarely
required).tz
- The specially formatted time zone object used by the engines@Deprecated void setTimeZoneSameAs(BackendTimeZoneSimple tz, java.lang.String sameAsId)
tz
- sameAsId
- HistoryRecord[] getProcessHistoryRecords(java.lang.Long processId_) throws PrivilegeException, InvalidProcessException
processId_
- InvalidProcessException
- If no such process exists.PrivilegeException
- If the user does not have access to retrieve the
process history for the specified process.ServiceException
- if any system-level error occursResultPage getProcessHistoryRecordsPaging(java.lang.Long processId_, int startIndex_, int batchSize_, java.lang.Integer sortProperty_, java.lang.Integer sortOrder_) throws PrivilegeException, InvalidProcessException
processId_
- The id of the process.startIndex_
- the index into the collection of total results at which
to start. Negative numbers are treated as zeros.batchSize_
- the number of results to return. use of
Constants.COUNT_ALL
will
result in the entire collection being returned, but this is
STRONGLY discouraged.sortProperty_
- the property by which the results will be sorted
This is one of the SORT_BY_XXX
constants in
HistoryRecord
sortOrder_
- Constants.SORT_ORDER_ASCENDING
for sorting results in ascending order,
Constants.SORT_ORDER_DESCENDING
for sorting results in descending orderInvalidProcessException
- If no such process exists.PrivilegeException
- If the user does not have access to retrieve the
process history for the specified process.ServiceException
- if any system-level error occursResultPage getTasksWithStatusForProcessModel(java.lang.Long processModelId_, java.lang.Integer taskStatus_, boolean recursive_, int startIndex_, int batchSize_) throws PrivilegeException
processModelId_
- The process model id to scan for tasks within.taskStatus_
- Retrieve tasks currently with this status number, see
TaskSummary.TASK_STATUS_PAUSED_BY_EXCEPTION, etc.recursive_
- Set to true to retrieve tasks from subprocesses as well.startIndex_
- The index into the collection of total results at which
to start. Negative numbers are treated as zeros.batchSize_
- The maximum number of results to return in the result page.
use of Constants.COUNT_ALL
will result in the entire collection being returned, but this is
STRONGLY discouraged.ResultPage
containing TaskSummary
objects representing tasks that have the given status, from processes of the specified Process ModelPrivilegeException
ResultPage getTasksWithStatusForProcessModels(java.lang.Long[] processModelIds_, java.lang.Integer taskStatus_, boolean recursive_, int startIndex_, int batchSize_) throws PrivilegeException
processModelIds_
- The process model ids to scan for. As this is
scanning for matches, a lack of matches will simply be indicated by a lack of results;.taskStatus_
- Retrieve tasks currently with this status number, see
TaskSummary.TASK_STATUS_PAUSED_BY_EXCEPTION, etc.recursive_
- Set to true to retrieve tasks from subprocesses as well.startIndex_
- The index into the collection of total results at which
to start. Negative numbers are treated as zeros.batchSize_
- The maximum number of results to return in the result page.
use of Constants.COUNT_ALL
will result in the entire collection being returned, but this is
STRONGLY discouraged.ResultPage
containing TaskSummary
objects representing tasks that have the given status, from processes of the specified Process ModelsPrivilegeException
ResultPage getTasksWithStatusForProcess(java.lang.Long processId_, java.lang.Integer taskStatus_, boolean recursive_, int startIndex_, int batchSize_, java.lang.Integer sortProperty_, java.lang.Integer sortOrder_) throws InvalidProcessException, PrivilegeException
processId_
- The process id containing the tasks to be examined.taskStatus_
- Retrieve tasks currently with this status number, see
TaskSummary.TASK_STATUS_PAUSED_BY_EXCEPTION, etc.recursive_
- Set to true to retrieve tasks from subprocesses as well.startIndex_
- The index into the collection of total results at which
to start. Negative numbers are treated as zeros.batchSize_
- The maximum number of results to return in the result page.
use of Constants.COUNT_ALL
will result in the entire collection being returned, but this is
STRONGLY discouraged.sortProperty_
- the property by which the results will be sorted
This is one of the SORT_BY_XXX
constants in
TaskSummary
sortOrder_
- Constants.SORT_ORDER_ASCENDING
for sorting results in ascending order,
Constants.SORT_ORDER_DESCENDING
for sorting results in descending orderResultPage
containing TaskSummary
objects representing tasks that have the given status from the specified processInvalidProcessException
PrivilegeException
ResultPage getTasksWithStatusForProcesses(java.lang.Long[] processIds_, java.lang.Integer taskStatus_, boolean recursive_, int startIndex_, int batchSize_) throws InvalidProcessException, PrivilegeException
processIds_
- The ids of the processes to be examined.taskStatus_
- Retrieve tasks currently with this status number, see
TaskSummary.TASK_STATUS_PAUSED_BY_EXCEPTION, etc.recursive_
- Set to true to retrieve tasks from subprocesses as well.startIndex_
- The index into the collection of total results at which
to start. Negative numbers are treated as zeros.batchSize_
- The maximum number of results to return in the result page.
use of Constants.COUNT_ALL
will result in the entire collection being returned, but this is
STRONGLY discouraged.ResultPage
containing TaskSummary
objects representing tasks that have the given status from the specified processesInvalidProcessException
PrivilegeException
void completeStore(java.lang.Long expressionGroupId) throws InvalidExpressionGroupException
expressionGroupId
- InvalidExpressionGroupException
void cancelStore(java.lang.Long expressionGroupId, java.lang.String cancelMessage) throws InvalidExpressionGroupException
expressionGroupId
- cancelMessage
- the text message to give as an errorInvalidExpressionGroupException
void processToNextAttended(java.lang.Long activityId, boolean isQuickTask, ActivityClassParameter[] parameters) throws InvalidProcessModelException, InvalidPriorityException, PrivilegeException, InvalidStateException, StorageLimitException, InvalidUserException, java.lang.IllegalArgumentException, InvalidActivityException, InvalidActivityClassParameterException, InvalidExpressionException, TaskNavigationException
This method replaces the deprecated method
ProcessEngineService.processToNextAttended(com.appiancorp.process.engine.ProcessActionResponse)
.
activityId
- the task activity id of the current activity to executeisQuickTask
- whether or not the current activity is a quick taskparameters
- the parameter values to use when executing the current activityInvalidProcessModelException
- if the related process model is invalidInvalidPriorityException
- if the related task priority does not existPrivilegeException
- if the user does not have sufficient privileges
to perform this operationInvalidStateException
- if the process or task is cancelledStorageLimitException
- if all execution engines are fullInvalidUserException
- if any of the users referenced do not existjava.lang.IllegalArgumentException
- if the given task is not attendedInvalidActivityException
- if an activity id is invalidInvalidActivityClassParameterException
- if an
ActivityClassParameter
provided does not existInvalidExpressionException
- if a referenced expression does not existTaskNavigationException
- if the given activityId would illegally send
the process flow back to a previous taskCopyright © 2003-2024 Appian Corporation. All Rights Reserved.