public interface ProcessDesignService extends ContextSensitiveSingletonService
ProcessDesignService
is used for creating and modifying
ProcessModel
which are organized by storing them in
ProcessModelFolder
objects. It also contains methods for
handling the security of these objects. It mainly deals with the design of
Process Models whereas the ProcessExecutionService
deals with all
aspects of starting and maintaining instances of a ProcessModel
(Process
).
A ProcessModelFolder
can be created and modified with this
service. Process models are organized into folders in the process model
pickers.
ProcessModel
objects created by this service can be run
using the ProcessExecutionService
.
When a ProcessModel
is being designed it is considered a draft.
When a designer is satisfied with their design he or she may save the
ProcessModel
using updateProcessModel(ProcessModel)
and create a new version using versionProcessModel(ProcessModel)
.
When a ProcessModel
is first versioned it is given the version
"1.0" and all subsequent versions are incremented by 1.0. Versions of a
ProcessModel
cannot be run until they are published, and
a ProcessModel
version cannot be published unless it is valid.
A ProcessModel
can be validated using the
#validateProcessModel(ProcessModel)
method.
A ProcessModel
can be locked by a user so that no other
users can edit the ProcessModel
. However, a User
can attempt to override the lock placed on a ProcessModel
by
another User
by calling lockProcessModel(Long,boolean)
or unlockProcessModel(Long,boolean)
and setting the override
boolean
to true
.
In addition to regular ProcessNode
objects a
ProcessModel
can contain other ProcessModel
objects through sub and linked processes.
A sub-process is a node which contains a ProcessModel
. This
node is considered a single node by the parent ProcessModel
.
When a sub-process node is reached during process execution the sub-process
is started and the sub-process node is considered active. The node does not
complete until the sub-process has completed.
A linked-process is a node which starts an instance of a
ProcessModel
. Once the linked-process has been started the
linked-process node is considered complete by the parent
Process
.
As mentioned above, this service contains methods relating to the security
and permissions of various objects. The permissions which can be obtained
through this service include: getPermissionsForFolder(Long)
,
#getPermissionsForPalette(Long)
,
getPermissionsForProcessApplication()
, and
getPermissionsForProcessModel(Long)
. These methods should be used
when determining which actions a User
can perform on the
corresponding object. Permissions are obtained through
ProcessModelPermissions
. These may be referenced to determine
whether a user has sufficient privileges to perform a particular action.
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.
CONFIGURE_METHOD_NAME
Modifier and Type | Method and Description |
---|---|
void |
activateUserSession(java.lang.Long[] membership_,
java.lang.Long[] administration_,
java.lang.Long userTypeId_,
java.lang.String username)
Notifies the Process application that a new session has been created
for the current user, and provides information about the current
user's membership and administration rights to groups.
|
void |
addProcessModelToFavorites(java.lang.Long modelId_)
Associates this
ProcessModel by given modelId_
as one of the current user's favorites. |
void |
commitUpdateUsernames()
Deprecated.
|
void |
createBusinessEntity(BusinessEntity business_)
Creates a
BusinessEntity for use with Web Services. |
ProcessModelFolder |
createFolder(ProcessModelFolder folder_)
Creates a folder for storing process models.
|
ProcessModel |
createProcessModel(ProcessModel pm_)
Creates a
ProcessModel in the database using the input parameter. |
void |
createProcessModelWebService(ProcessModelWebService pmws_)
Create a
ProcessModelWebService . |
void |
deleteFolder(java.lang.Long folderId_)
Deletes a
ProcessModelFolder |
ResultList |
deleteFolders(java.lang.Long[] folders_)
Deletes a list of folders
|
void |
deleteProcessModel(java.lang.Long processModelId_)
Deletes a process model.
|
void |
deleteProcessModels(java.lang.Long[] processModelIds_)
Deletes multiple
ProcessModel objects. |
void |
deleteProcessModelVersion(java.lang.Long processModelId_,
java.lang.String version_)
Deletes a version of a
ProcessModel . |
void |
deleteProcessModelWebService(java.lang.String serviceName_)
Deletes a
ProcessModelWebService based on the service name which it
contains. |
void |
disableProcessModel(java.lang.Long processModelId_,
java.lang.String version_)
Disables a version of a
ProcessModel . |
void |
enableProcessModel(java.lang.Long processModelId_,
java.lang.String version_)
Enables a
ProcessModel version. |
TypedValue |
evaluateExpression(java.lang.String expression)
Evaluate the given expression (including java expression functions).
|
TypedValue |
evaluateExpression(java.lang.String expression,
NamedTypedValue[] variableValues)
Evaluate the given expression (including java expression functions).
|
PartialResult |
evaluateExpressionInVariableContext(java.lang.String expression,
NamedTypedValue[] typedVariables,
NamedTypedValue[] continueParams) |
ProcessModel |
exportProcessModel(java.lang.Long processModelId_)
Retrieve a working draft of a
ProcessModel . |
ProcessModel |
exportProcessModelVersion(java.lang.Long processModelId_,
java.lang.String version_)
Retrieves a version of a
ProcessModel . |
java.lang.String |
externalizeExpression(java.lang.String expression,
java.lang.String... parameterNames)
Replaces rule names with UUIDs within the given expression.
|
ResultPage |
findEventsPaging(java.lang.String searchString_,
java.lang.Long pmId_,
java.lang.Long[] eventTypes_,
java.lang.Boolean includeStartEvents_,
int startIndex_,
int batchSize_,
java.lang.Integer sortProperty_,
java.lang.Integer sortOrder_)
Searches for Events associated with the given Process Model that match the specified searchString.
|
ResultList |
getACInstanceIdsForLocalIds(java.lang.String[] localIds_)
Returns a
ResultList containing the actual Id's in database
corresponding to given localId's of ActivityClass |
ResultList |
getACPInstanceIdsForLocalIds(java.lang.Long activityClassLocalId_,
java.lang.String[] localIds_)
Returns a
ResultList containing the actual Id's in database
for ActivityClassParameter corresponding to given a
ActivityClass localId and ActivityClassParameter
localId's. |
ActivityClassSchema |
getACSchemaByLocalId(java.lang.String acsLocalId_)
Retrieves an
ActivityClassSchema by local id. |
ActivityClassSchema |
getActivityClassSchema(java.lang.Long acsId_)
Retrieves an
ActivityClassSchema . |
Identity[] |
getActivityClassSchemas(java.lang.Long[] acsIds_)
Retrieves a list of abbreviated
ActivityClassSchema representations
for the given IDs |
ActivityClassSchema[] |
getAssigneePoolACSchemas()
Retrieves the activity class schemas for the activity classes that operate
on the assignee pool.
|
ActivityClassSchema[] |
getAssignmentPoolACSchemas()
Retrieves the activity class schemas for the activity classes that
operate on the assignment pool.
|
ResultList |
getAsynchronousSubProcessModelDescriptorsForProcessModel(java.lang.Long processModelId_)
Retrieve a list of process model descriptors that represent the working
drafts of all linked process models for the given process model.
|
BusinessEntity |
getBusinessEntity()
Retrieves the
BusinessEntity which has been created on the system. |
ResultPage |
getChildFolders(java.lang.Long folderId_,
int startIndex_,
int batchSize_,
java.lang.Integer sortProperty_,
java.lang.Integer sortOrder_)
Gets all the direct child folders of a process model folder
|
int |
getCountProcessModelParametersForVersion(java.lang.Long processModelId_,
java.lang.String version_)
Retrieves count of all of the process variables that are required to
start an instance of the given process model version (ie.
|
java.lang.String[] |
getCurrentNotePaths()
Deprecated.
since 23.2
|
java.lang.Long |
getDashboardPageForProcessModel(java.lang.Long processModelId_)
Returns the dashboard Id that is used for the
ProcessModel
by given processModelId_ |
Priority |
getDefaultPriority()
Retrieves the default
Priority for the system. |
java.lang.Long |
getEmailAttachmentFolderIdForPm(java.lang.Long pm_)
Returns the Id of the folder where attachments will be stored when an email
message is sent to either the
ProcessModel or any event within
the ProcessModel |
ActivityClassSchema[] |
getEscalationACSchemas()
Retrieves the activity class schemas for activities that can
be used as escalations.
|
java.lang.String[] |
getEventOrProcessModelNames(java.lang.Long[] pmIds_,
java.lang.String[] eventPersistentIds_)
Returns the display names of processModels and Events for the provided
ProcessModel Ids and Event Ids |
ResultList |
getEventsByPersistentId(java.lang.String[] eventPersistentIds_)
Returns a ResultList containing Events that correspond to the passed in
array of Event persistent IDs.
|
ResultPage |
getEventsForProcessModelPaging(java.lang.Long pmId_,
java.lang.Long[] eventTypes_,
java.lang.Boolean includeStartEvents_,
int startIndex_,
int batchSize_,
java.lang.Integer sortProperty_,
java.lang.Integer sortOrder_)
Returns the Events for a given
ProcessModel specified by
eventTypes_ . |
ExpressionDependency[] |
getExpressionDependencies(java.lang.String[] expression,
java.lang.String[] parameterNames)
Returns an array of the
ExpressionDependency objects for the given expressions. |
ExpressionDependency |
getExpressionDependencies(java.lang.String expressionText,
java.lang.String... parameterNames)
Returns the expression dependencies for the given
expressionText . |
ProcessModelFolder |
getFolder(java.lang.Long folderId_)
Retrieves a
ProcessModelFolder . |
ResultList |
getFolders(java.lang.Long[] folderIds_)
Retrieves multiple process model folders
|
FormConfig |
getFormConfig(java.lang.Long processModelId_)
Retrieves the
FormConfig of the draft of the given process model. |
FormConfig |
getFormConfigForVersion(java.lang.Long processModelId,
java.lang.String version)
Retrieves the
FormConfig of the given process model version. |
ResultPage |
getLingeringTasksForProcessModel(java.lang.Long processModelId_,
boolean recursive_,
int startIndex_,
int batchSize_,
java.lang.Integer sortProperty_,
java.lang.Integer sortOrder_)
Returns all instances of lingering nodes in the
specified process.
|
ResultList |
getLinkProcessModelDescriptorsForProcessModel(java.lang.Long processModelId_)
Deprecated.
|
int |
getMaximumNumberOfAttachments()
Returns the maximum number of attachments that can be added to
a process model or process node.
|
int |
getMaximumNumberOfNotes()
Deprecated.
since 23.2
|
ProcessModel.Descriptor[] |
getMyProcessModels()
Retrieves
ProcessModel objects for which the current
user is an owner. |
ResultList |
getParentsForProcessModel(java.lang.Long processModelId_)
Retrieves the working drafts of the parents of a
ProcessModel . |
ResultList |
getParentsOfUnpublishedChildrenForProcessModel(java.lang.Long processModelId_)
Returns the working drafts of the parents of the unpublished children
(sub process models) of a
ProcessModel . |
ProcessModelFolderPermissions |
getPermissionsForFolder(java.lang.Long folderId_)
Retrieves
ProcessModelFolderPermissions for a
ProcessModelFolder |
ProcessModelFolderPermissions[] |
getPermissionsForFolders(java.lang.Long[] folderIds_)
Retrieves
ProcessModelFolderPermissions objects for multiple
ProcessModelFolder objects. |
ProcessApplicationPermissions |
getPermissionsForProcessApplication()
Retrieves permissions on the Process application
for the current user
|
ProcessModelPermissions |
getPermissionsForProcessModel(java.lang.Long id_)
Retrieves permissions on a process model for the
current user.
|
ProcessModelPermissions[] |
getPermissionsForProcessModels(java.lang.Long[] ids_)
Retrieves permissions on multiple process models
objects for the current user.
|
java.lang.Long |
getPmIdForEvent(java.lang.String eventPersistentId_)
Returns the ID of the
ProcessModel that the Event by given
eventPersistentId belongs to. |
Priority |
getPriority(java.lang.Long priorityId_)
Retrieves a
Priority |
Priority |
getPriorityOfProcessModel(java.lang.Long processModelId_)
Retrieves the priority for a
ProcessModel . |
java.lang.Long |
getProcessDashboardPageForProcessModel(java.lang.Long processModelId_)
Returns the dashboard Id that is used for all processes spawned from the
ProcessModel by given processModelId_ |
ProcessModel |
getProcessModel(java.lang.Long processModelId_)
Retrieve a working draft of a
ProcessModel . |
ProcessModel |
getProcessModelByUuid(java.lang.String uuid_)
Retrieves the working draft of the
ProcessModel specified by a UUID
(Universal Unique Identifier). |
ProcessModel.Descriptor |
getProcessModelDescriptor(java.lang.Long processModelId_)
Retrieves a process model descriptor representing the working draft of a process model.
|
ResultList |
getProcessModelDescriptors(java.lang.Long[] pmIds_)
Retrieves multiple process model descriptors, representing the working
drafts of the given process models
|
ResultList |
getProcessModelDescriptorsContainingAsynchronousSubProcessModel(java.lang.Long linkProcessModelId_)
Retrieves process model descriptors representing the working drafts of the
process models that contain the given linked process model
|
ResultList |
getProcessModelDescriptorsContainingLinkProcessModel(java.lang.Long linkProcessModelId_)
Deprecated.
|
ResultList |
getProcessModelDescriptorsContainingSubProcessModel(java.lang.Long subProcessModelId_)
Deprecated.
|
ResultList |
getProcessModelDescriptorsContainingSynchronousSubProcessModel(java.lang.Long subProcessModelId_)
Retrieves process model descriptors representing the working drafts of the
process models that contain the given process model as a sub-process model
|
ProcessModelDetails |
getProcessModelDetails(java.lang.Long processModelId_)
Retrieves
ProcessModelDetails representing the working drafts of
the given ProcessModel
If only requiring FormConfig, see getFormConfig in this class. |
java.lang.Long |
getProcessModelIdByUuid(java.lang.String uuid_)
Retrieves the ID of a
ProcessModel by a UUID (Universal
Unique Identifier). |
java.lang.Long[] |
getProcessModelIdsByUuids(java.lang.String[] pmUUIDs_)
Returns the IDs of ProcessModels that match the given UUID.
|
ProcessModel |
getProcessModelLatestPublishedVersion(java.lang.Long processModelId_)
Retrieve the latest published version of a
ProcessModel or the
working draft if a published version does not exist. |
ProcessModel.Descriptor |
getProcessModelLatestPublishedVersionDescriptor(java.lang.Long processModelId_)
Retrieve the latest published version of a
ProcessModel.Descriptor
or the working draft if a published version does not exist. |
ProcessVariable[] |
getProcessModelParameters(java.lang.Long processModelId_)
Retrieves all of the process variables that are required to
start an instance of the given process model (ie.
|
ProcessVariable[] |
getProcessModelParametersForVersion(java.lang.Long processModelId_,
java.lang.String version_)
Retrieves all of the process variables that are required to
start an instance of the given process model version (ie.
|
ProcessModelProperties |
getProcessModelProperties(java.lang.Long modelId_)
Retrieves the
ProcessModelProperties representing the working
draft of a ProcessModel . |
ProcessModel[] |
getProcessModels(java.lang.Long[] ids_)
Deprecated.
Use
getProcessModelDescriptors(Long[]) or call
getProcessModel(Long) iteratively instead. |
ProcessModel[] |
getProcessModelsAndDescendants(java.lang.Long[] ids_)
Retrieves multiple
ProcessModel objects as well as the sub
ProcessModel objects which they contain. |
ResultPage |
getProcessModelsForFolder(java.lang.Long folderId_,
int startIndex_,
int batchSize_,
java.lang.Integer sortProperty_,
java.lang.Integer sortOrder_)
Retrieve process model descriptors representing the working drafts of the
process models directly in a process model folder
|
ResultPage |
getProcessModelsForFolderStartableOnly(java.lang.Long folderId_,
int startIndex_,
int batchSize_,
java.lang.Integer sortProperty_,
java.lang.Integer sortOrder_)
Retrieve descriptors representing the working drafts of the startable
process models directly in a process model folder.
|
ResultPage |
getProcessModelsForGroup(java.lang.Long groupId_,
int startIndex_,
int batchSize_,
java.lang.Integer sortProperty_,
java.lang.Integer sortOrder_)
Deprecated.
Process models are no longer associated with groups, but rather are organized into folders.
Use
getProcessModelsForFolder(java.lang.Long, int, int, java.lang.Integer, java.lang.Integer) |
ProcessModel.Descriptor[] |
getProcessModelsICanStart()
Retrieves process model descriptors which represent the working drafts of
the process models that the current user has permission to start
|
ResultList |
getProcessModelsLatestPublishedDescriptors(java.lang.Long[] pmIds_)
Retrieves multiple process model descriptors, representing the latest
published version or a draft if there is no publish version.
|
ProcessModel |
getProcessModelVersion(java.lang.Long processModelId_,
java.lang.String version_)
Retrieves a version of a
ProcessModel . |
ProcessModel.Descriptor |
getProcessModelVersionDescriptor(java.lang.Long processModelId_,
java.lang.String version_)
Retrieves the process model descriptor for a version of a
ProcessModel . |
ResultPage |
getProcessModelWebServices(int startIndex_,
int batchSize_,
java.lang.Integer sortProperty_,
java.lang.Integer sortOrder_)
Retrieves all
ProcessModelWebService objects on the server. |
ProcessStartingInfo |
getProcessStartingInfo(java.lang.String serviceName_)
Retrieves the
ProcessStartingInfo for a service. |
ProcessVariable[] |
getProcessVariablesForModel(java.lang.Long pmId_,
boolean recursive_)
Returns the list of all process variables in a given process model.
|
ProcessVariable[] |
getProcessVariablesForModel(java.lang.String uuid,
boolean recursive)
Returns the list of all process variables in a given process model.
|
int |
getRecursiveRelationship(java.lang.Long processModelId_,
java.lang.Long subProcessModelId_)
Return the status of the two process models' recursive relationship
|
java.lang.Long[] |
getRuleIdReferences(java.lang.Long pmId)
Gets all the rule ids that the expressions within the process model with
pmId id contain, including nested rules referenced by all the
expressions. |
java.lang.String[] |
getRuleUuidReferences(ProcessModel pm)
Gets all the rule UUID references that the expressions within the process model bean
(
pm ) contain. |
Security |
getSecurityForFolder(java.lang.Long folderId_)
Gets the security for a process model folder
|
Security |
getSecurityForProcessApplication()
Gets the security settings of the Process Application
|
Security |
getSecurityForProcessModel(java.lang.Long id_)
Gets the security settings of a process model
|
ResultList |
getSubProcessModelDescriptorsForProcessModel(java.lang.Long processModelId_)
Deprecated.
|
ResultList |
getSynchronousSubProcessModelDescriptorsForProcessModel(java.lang.Long processModelId_)
Gets a ResultList containing process model descriptors representing the
working drafts of the sub-process models of the given process model
|
ResultPage |
getTopLevelFolders(int startIndex_,
int batchSize_,
java.lang.Integer sortProperty_,
java.lang.Integer sortOrder_)
Returns the top level folders in the process application that the current
user can see.
|
ResultList |
getTopLevelProcessModelDescriptorsForAsynchronousSubProcessModel(java.lang.Long linkProcessModelId_)
Gets a
ResultList containing process model descriptors
that represent the working drafts of all parent process models for the given
linked process model |
ResultList |
getTopLevelProcessModelDescriptorsForLinkProcessModel(java.lang.Long linkProcessModelId_)
Deprecated.
|
ResultList |
getTopLevelProcessModelDescriptorsForSubProcessModel(java.lang.Long subProcessModelId_)
Deprecated.
|
ResultList |
getTopLevelProcessModelDescriptorsForSynchronousSubProcessModel(java.lang.Long subProcessModelId_)
Gets a ResultList containing process model descriptors that represent the
working drafts of the top level process models of the given sub-process
model
|
ResultList |
getUnpublishedChildrenForProcessModel(java.lang.Long processModelId_)
Returns the working draft of the unpublished children (sub
process models) of the given process model
|
ResultPage |
getVersionsForProcessModel(java.lang.Long processModelId_,
int startIndex_,
int batchSize_,
java.lang.Integer sortProperty_,
java.lang.Integer sortOrder_)
Gets the versions for a process model
|
ProcessVariable[] |
getVisibleProcessVariables(java.lang.Long processModelId_)
Retrieves all visible process variables associated with the given
process model, or the process variables that are reportable through
analytics and can be mapped in a subprocess relationship
|
ProcessVariable[] |
getVisibleProcessVariablesForVersion(java.lang.Long processModelId_,
java.lang.String version_)
Retrieves all visible process variables associated with the given
process model version, or the process variables that are reportable through
analytics and can be mapped in a subprocess relationship
|
int[] |
handleMessages(InternalMessage[] messages_)
Sends the messages to the design server to be handled by the Events
framework, and returns appropriate result codes.
|
java.lang.Long |
initiateProcess(java.lang.Long processModelId,
ProcessStartConfig config)
Starts an instance of the given process model.
|
java.lang.String |
internalizeExpression(java.lang.String expression)
Replaces UUIDs with rule names within the given expression.
|
boolean |
isProcessModelLocked(java.lang.Long processModelId_)
Determines whether a process model is locked
|
ResultList |
isStartFormCapable(java.lang.Long[] processModelIds,
int capabilities)
Retrieves a ResultList containing Boolean values representing whether the start form
for the latest published version of each of the process models is capable of ALL the
specified form capabilities.
|
ProcessModel.Descriptor[] |
listProcessModels()
Deprecated.
Use
getProcessModelDescriptors(Long[]) instead. This method performs
poorly and should not be called. |
void |
lockProcessModel(java.lang.Long processModelId_,
boolean override_)
Locks the specified process model
|
void |
moveFolder(java.lang.Long folderId_,
java.lang.Long parentFolderId_)
Moves a process model folder
|
void |
moveProcessModel(java.lang.Long processModelId_,
java.lang.Long parentFolderId_)
Moves a process model to a new process model folder
|
void |
notifyUserCreation(java.lang.String username_)
Deprecated.
done automatically by UserService.createUser
|
void |
notifyUsersCreation(java.lang.String[] usernames_)
Notifies the server that new users were created on the Personalization
server
|
ProcessModel |
publishProcessModel(ProcessModel processModel_)
Deprecated.
use saveAndPublishProcessModel
|
void |
reloadProperties()
Deprecated.
reloading properties is now automatic, so this call is now unnecessary and does nothing.
|
void |
removeDashboardPageForProcessModel(java.lang.Long processModelId)
Disassociates the current Dashboard page for the given
ProcessModel
by processModelId . |
void |
removeProcessDashboardPageForProcessModel(java.lang.Long processModelId_)
Removes any custom dashboards created for instances of a particular process model.
|
void |
removeProcessModelFromFavorites(java.lang.Long modelId_)
Removes this
ProcessModel by given modelId_ as
one of the current user's favorites. |
void |
rollbackUpdateUsernames()
Deprecated.
|
ProcessModelWithErrors |
saveAndPublishProcessModel(ProcessModel processModel_,
boolean overrideLock_)
Attempts to lock, save, validate, and publish the given model.
|
void |
setActorsInRolesForFolder(java.lang.Long folderId_,
java.lang.String[] users_,
java.lang.String[][] userRoles_,
java.lang.Long[] groups_,
java.lang.String[][] groupRoles_)
Sets actors (users and groups) in roles for a process model folder.
|
void |
setActorsInRolesForProcessApplication(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 on the Process
Application.
|
void |
setActorsInRolesForProcessModel(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 on a specified
ProcessModel.
|
void |
setApplicationAdministratorGroup(java.lang.Long groupId_)
Determines which group users need to be in to have
the application administrator role.
|
void |
setCurrentNotePaths(java.lang.String[] notePaths_)
Deprecated.
since 23.2
|
void |
setDashboardPageForProcessModel(java.lang.Long processModelId,
java.lang.Long pageId)
Sets a page as the Dashboard page for the given
ProcessModel by
processModelId . |
void |
setDefaultPriority(java.lang.Long priorityId_)
Sets the default Priority that the Process Application will use.
|
void |
setInheritanceForFolder(java.lang.Long folderId_,
boolean inherits_)
Sets the inheritance for a process model folder
|
void |
setPriorityOfProcessModel(java.lang.Long processModelId_,
java.lang.Long priorityId_)
Sets the priority of a process model
|
void |
setProcessDashboardPageForProcessModel(java.lang.Long processModelId_,
java.lang.Long pageId_)
Sets a particular page as the dashboard for every instance of a given
ProcessModel by processModelId . |
void |
setSecurityForFolder(java.lang.Long folderId_,
Security security_)
Sets the security for a process model folder.
|
void |
setSecurityForProcessApplication(Security s_)
Sets the security settings of the Process Application.
|
void |
setSecurityForProcessModel(java.lang.Long id_,
Security s_)
Sets the security settings of a process model.
|
void |
setSiteLocaleSettings(SiteLocaleSettings settings_)
Registers the site locale settings on the process design server.
|
void |
setTimeZone(BackendTimeZoneSimple tz)
Set a backend timezone.
|
void |
setTimeZoneSameAs(BackendTimeZoneSimple tz,
java.lang.String sameAsId)
Set a backend timezone to have the same rules as another backend timezone the sameAsId.
|
java.lang.Long |
startProcess(java.lang.Long processModelId_,
ProcessVariable[] variables_)
Deprecated.
Use
initiateProcess(Long, ProcessStartConfig) ,
which has better enforcement of required parameters (requires that their
values not be null or empty) |
java.lang.Long |
startProcessVersion(java.lang.Long processModelId_,
ProcessVariable[] variables_,
java.lang.String version_,
java.lang.Long priorityId_)
Deprecated.
Use
initiateProcess(Long, ProcessStartConfig) ,
which has better enforcement of required parameters (requires that their
values not be null or empty) |
java.lang.Long |
startProcessWithPriority(java.lang.Long processModelId_,
ProcessVariable[] variables_,
java.lang.Long priorityId_)
Deprecated.
Use
initiateProcess(Long, ProcessStartConfig) ,
which has better enforcement of required parameters (requires that their
values not be null or empty) |
void |
unlockProcessModel(java.lang.Long processModelId_,
boolean override_)
Unlocks the given process model
|
void |
unlockProcessModels()
Unlocks all process models locked by the current user.
|
void |
updateBusinessEntity(BusinessEntity business_)
Updates a
BusinessEntity . |
ProcessModelFolder |
updateFolder(ProcessModelFolder folder_)
Updates a process model folder.
|
ResultList |
updateFolders(ProcessModelFolder[] processModelFolders_)
Updates a list of process model folders.
|
ProcessModel |
updateProcessModel(ProcessModel pm_)
Updates a process model in the database based on the input parameter.
|
ResultList |
updateProcessModelsWithDescriptors(ProcessModel.Descriptor[] descriptors_)
Updates process models in the database.
|
void |
updateUsernames(java.lang.String[] oldUsernames_,
java.lang.String[] newUsernames_,
long maxExpirationTimeInSeconds_)
Deprecated.
|
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
|
boolean |
validateGroupMembership(java.lang.Long[] memGroupIds_,
java.lang.Long[] admGroupIds_,
java.lang.Long userTypeId_,
java.lang.String username)
Validates if the association of a user as 'Member' and as an 'Administrator
has changed or not.
|
java.lang.String[] |
validateProcessModel(AbstractProcessModel apm_)
Returns the results of validating a process model
|
java.lang.String[] |
validateProcessModelVersion(java.lang.Long processModelId_,
java.lang.String version_)
Returns the results of validating a process model, same as
getProcessModelVersion followed by validateProcessModel.
|
boolean |
validateTypedValues(TypedValue[] typedValues)
Validates given TypedValues.
|
java.lang.Boolean[] |
validateUsernames(java.lang.String[] usernames_)
Returns an array of Boolean values, Boolean.TRUE if the user given by the username
exists and Boolean.FALSE otherwise.
|
ProcessModel |
versionProcessModel(ProcessDiagram pm_)
The returned process model is not transformed.
|
ProcessModel |
versionProcessModel(ProcessModel pm_)
Versions a process model in the database based on the input parameter.
|
configureContextSensitiveSingletonService
static final int DOES_NOT_RECURSE
static final int PARENT_PROCESS_RECURSES
static final int SUBPROCESS_RECURSES
static final int EMBEDDED
static final int INDEPENDENT
static final int ALL
static final java.lang.Integer UNPUBLISHED_CHILDREN_VIEW_PERMISSIONS
static final java.lang.Integer UNPUBLISHED_CHILDREN_INVALID
static final java.lang.Integer UNPUBLISHED_CHILDREN_PUBLISH_PERMISSIONS
static final java.lang.Integer UNPUBLISHED_CHILDREN_SUCCESS
static final boolean createProcessModel$UPDATES
static final boolean updateProcessModel$UPDATES
static final boolean getProcessModel$UPDATES
static final boolean exportProcessModel$UPDATES
static final boolean listProcessModels$UPDATES
static final boolean getActivityClassSchemas$UPDATES
static final boolean getActivityClassSchema$UPDATES
static final boolean getACSchemaByLocalId$UPDATES
static final boolean startProcess$UPDATES
static final boolean startProcessWithPriority$UPDATES
static final boolean initiateProcess$UPDATES
static final boolean getProcessModelsForGroup$UPDATES
static final boolean getProcessModelDetails$UPDATES
static final boolean getFormConfig$UPDATES
static final boolean getFormConfigForVersion$UPDATES
static final boolean isStartFormCapable$UPDATES
static final boolean getMyProcessModels$UPDATES
static final boolean getProcessModelsICanStart$UPDATES
static final boolean getProcessModels$UPDATES
static final boolean getProcessModelParameters$UPDATES
static final boolean getVisibleProcessVariables$UPDATES
static final boolean getAssigneePoolACSchemas$UPDATES
static final boolean getAssignmentPoolACSchemas$UPDATES
static final boolean activateUserSession$UPDATES
static final boolean getEscalationACSchemas$UPDATES
static final boolean deleteProcessModel$UPDATES
static final boolean deleteProcessModels$UPDATES
static final boolean getProcessModelDescriptor$UPDATES
static final boolean getRecursiveRelationship$UPDATES
static final boolean getSubProcessModelDescriptorsForProcessModel$UPDATES
static final boolean getSynchronousSubProcessModelDescriptorsForProcessModel$UPDATES
static final boolean getProcessModelDescriptorsContainingSubProcessModel$UPDATES
static final boolean getProcessModelDescriptorsContainingSynchronousSubProcessModel$UPDATES
static final boolean getTopLevelProcessModelDescriptorsForSubProcessModel$UPDATES
static final boolean getTopLevelProcessModelDescriptorsForSynchronousSubProcessModel$UPDATES
static final boolean getLinkProcessModelDescriptorsForProcessModel$UPDATES
static final boolean getAsynchronousSubProcessModelDescriptorsForProcessModel$UPDATES
static final boolean getProcessModelDescriptorsContainingLinkProcessModel$UPDATES
static final boolean getProcessModelDescriptorsContainingAsynchronousSubProcessModel$UPDATES
static final boolean getTopLevelProcessModelDescriptorsForLinkProcessModel$UPDATES
static final boolean getTopLevelProcessModelDescriptorsForAsynchronousSubProcessModel$UPDATES
static final boolean getSecurityForProcessApplication$UPDATES
static final boolean setSecurityForProcessApplication$UPDATES
static final boolean getSecurityForProcessModel$UPDATES
static final boolean setSecurityForProcessModel$UPDATES
static final boolean setActorsInRolesForProcessApplication$UPDATES
static final boolean setActorsInRolesForProcessModel$UPDATES
static final boolean getPermissionsForProcessApplication$UPDATES
static final boolean getPermissionsForProcessModel$UPDATES
static final boolean getPermissionsForProcessModels$UPDATES
static final boolean getPriority$UPDATES
static final boolean getDefaultPriority$UPDATES
static final boolean setDefaultPriority$UPDATES
static final boolean getPriorityOfProcessModel$UPDATES
static final boolean setPriorityOfProcessModel$UPDATES
static final boolean lockProcessModel$UPDATES
static final boolean getProcessModelVersion$UPDATES
static final boolean exportProcessModelVersion$UPDATES
static final boolean versionProcessModel$UPDATES
static final boolean getProcessModelsForFolder$UPDATES
static final boolean getChildFolders$UPDATES
static final boolean getTopLevelFolders$UPDATES
static final boolean getVersionsForProcessModel$UPDATES
static final boolean setActorsInRolesForFolder$UPDATES
static final boolean unlockProcessModel$UPDATES
static final boolean unlockProcessModels$UPDATES
static final boolean getFolder$UPDATES
static final boolean getFolders$UPDATES
static final boolean startProcessVersion$UPDATES
static final boolean getProcessModelProperties$UPDATES
static final boolean getMaximumNumberOfNotes$UPDATES
static final boolean getMaximumNumberOfAttachments$UPDATES
static final boolean getUnpublishedChildrenForProcessModel$UPDATES
static final boolean getParentsForProcessModel$UPDATES
static final boolean getParentsOfUnpublishedChildrenForProcessModel$UPDATES
static final boolean publishProcessModel$UPDATES
static final boolean saveAndPublishProcessModel$UPDATES
static final boolean getVisibleProcessVariablesForVersion$UPDATES
static final boolean getProcessModelParametersForVersion$UPDATES
static final boolean getCountProcessModelParametersForVersion$UPDATES
static final boolean updateFolder$UPDATES
static final boolean createFolder$UPDATES
static final boolean disableProcessModel$UPDATES
static final boolean enableProcessModel$UPDATES
static final boolean deleteFolders$UPDATES
static final boolean deleteFolder$UPDATES
static final boolean updateFolders$UPDATES
static final boolean updateProcessModelsWithDescriptors$UPDATES
static final boolean getSecurityForFolder$UPDATES
static final boolean setSecurityForFolder$UPDATES
static final boolean getProcessModelDescriptors$UPDATES
static final boolean getProcessModelsLatestPublishedDescriptors$UPDATES
static final boolean getProcessModelVersionDescriptor$UPDATES
static final boolean moveProcessModel$UPDATES
static final boolean moveFolder$UPDATES
static final boolean getPermissionsForFolder$UPDATES
static final boolean getPermissionsForFolders$UPDATES
static final boolean setInheritanceForFolder$UPDATES
static final boolean deleteProcessModelVersion$UPDATES
static final boolean getBusinessEntity$UPDATES
static final boolean createBusinessEntity$UPDATES
static final boolean updateBusinessEntity$UPDATES
static final boolean getProcessModelWebServices$UPDATES
static final boolean createProcessModelWebService$UPDATES
static final boolean deleteProcessModelWebService$UPDATES
static final boolean getProcessStartingInfo$UPDATES
static final boolean getProcessModelByUuid$UPDATES
static final boolean getProcessModelIdByUuid$UPDATES
static final boolean getProcessModelsAndDescendants$UPDATES
static final boolean getProcessModelsForFolderStartableOnly$UPDATES
static final boolean validateProcessModel$UPDATES
static final boolean validateProcessModelVersion$UPDATES
static final boolean isProcessModelLocked$UPDATES
static final boolean getProcessModelLatestPublishedVersion$UPDATES
static final boolean getProcessModelLatestPublishedVersionDescriptor$UPDATES
static final boolean getACInstanceIdsForLocalIds$UPDATES
static final boolean getACPInstanceIdsForLocalIds$UPDATES
static final boolean notifyUserCreation$UPDATES
static final boolean notifyUsersCreation$UPDATES
static final boolean validateGroupMembership$UPDATES
static final boolean updateUsernames$UPDATES
static final boolean commitUpdateUsernames$UPDATES
static final boolean rollbackUpdateUsernames$UPDATES
static final boolean setApplicationAdministratorGroup$UPDATES
static final boolean reloadProperties$UPDATES
static final boolean validate$UPDATES
static final boolean setSiteLocaleSettings$UPDATES
static final boolean getEventsForProcessModelPaging$UPDATES
static final boolean findEventsPaging$UPDATES
static final boolean getEventOrProcessModelNames$UPDATES
static final boolean getProcessModelIdsByUuids$UPDATES
static final boolean getEmailAttachmentFolderIdForPm$UPDATES
static final boolean getPmIdForEvent$UPDATES
static final boolean getEventsByPersistentId$UPDATES
static final boolean setDashboardPageForProcessModel$UPDATES
static final boolean getDashboardPageForProcessModel$UPDATES
static final boolean removeDashboardPageForProcessModel$UPDATES
static final boolean addProcessModelToFavorites$UPDATES
static final boolean removeProcessModelFromFavorites$UPDATES
static final boolean handleMessages$UPDATES
static final boolean validateUsernames$UPDATES
static final boolean getProcessVariablesForModel$UPDATES
static final boolean getCurrentNotePaths$UPDATES
static final boolean setCurrentNotePaths$UPDATES
static final boolean getExpressionDependencies$UPDATES
static final boolean evaluateExpressionInVariableContext$UPDATES
static final boolean evaluateExpression$UPDATES
static final boolean externalizeExpression$UPDATES
static final boolean internalizeExpression$UPDATES
static final boolean getRuleIdReferences$UPDATES
static final boolean getRuleUuidReferences$UPDATES
static final boolean evaluateRule$UPDATES
static final boolean setProcessDashboardPageForProcessModel$UPDATES
static final boolean getProcessDashboardPageForProcessModel$UPDATES
static final boolean removeProcessDashboardPageForProcessModel$UPDATES
static final boolean getLingeringTasksForProcessModel$UPDATES
static final boolean validateTypedValues$UPDATES
static final boolean setTimeZone$UPDATES
static final boolean setTimeZoneSameAs$UPDATES
ProcessModel createProcessModel(ProcessModel pm_) throws PrivilegeException, InvalidFolderException, InvalidPriorityException, InvalidUserException, DuplicateUuidException
ProcessModel
in the database using the input parameter.
The database generates primary keys and reconstitutes the model to create
the return value.
In order to create a model at least the following fields must be populated:
LocalizedIdentity.setName(com.appiancorp.suiteapi.common.LocaleString)
AbstractProcessModel.setProcessName(com.appiancorp.suiteapi.common.LocaleString)
AbstractProcessModel.setFolderId(java.lang.Long)
AbstractProcessModel.setPriority(com.appiancorp.suiteapi.process.Priority)
ProcessModel.setVariables(com.appiancorp.suiteapi.process.ProcessVariable[])
must be populated, because these nodes require
variables to be defined.
For each process variable, the following fields must be populated:
key
,
value
,
type
, and
multiple
For each process node, the following fields
must be populated:
id
,
guiId
,
ownerId
,
ownerName
,
groupOwnerId
,
groupOwnerName
,
icon
,
paletteIcon
,
x
,
y
,
activityClass
,
preActivities
(can be an empty array),
postActivities
(can be an empty array),
connections
(can be an empty array),
notify
,
assign
(if the node is attended),
confirmationUrl
(populated by default),
schedule
,
escalations
(can be an empty array),
multipleInstance
,
notes
(can be an empty array),
attachments (can be an empty array)
,
priority
,
targetCompletion
(populated by default),
and
targetLag
(populated by default).
Within each process node, in the assign member, the following fields must
be populated:
assignees
,
multipleInstanceAssigneeType
,
assignmentFunction
,
and
assignmentPosition
Within each process node, in the activity class member, the following
fields must be populated:
acSchemaId
,
localId
,
parameters
(can be an empty list),
customParameters
(can be an empty list),
unattended
,
runAs
(if it is unattended),
outputExpressions
(can be an empty list),
formConfig
(if it is attended),
and
helperClass
.
Within each activity class, for each activity class parameter,
the following fields must be populated:
acpSchemaId
,
expression
,
and
validationMessages
pm_
- the ProcessModel
to createProcessModel
, with IDs populated.PrivilegeException
- if the current user does not have permission to perform this actionInvalidFolderException
- if the ProcessModelFolder
does
not existInvalidPriorityException
- if the Priority
does not existInvalidUserException
- if any user referenced in the
ProcessModel
does not existcom.appiancorp.asl3.servicefw.connect.ServiceException
- if any system-level error occursDuplicateUuidException
- if the UUID of the process model already existsProcessModel updateProcessModel(ProcessModel pm_) throws InvalidUuidException, InvalidProcessModelException, InvalidPriorityException, PrivilegeException, LockException, InvalidUserException
id
and uuid
fields are only
used for retrieving the model and cannot be changed since they are assigned
by the server in the first place.
In order to update a model at least the following fields must be populated:
LocalizedIdentity.setId(java.lang.Long)
LocalizedIdentity.setName(com.appiancorp.suiteapi.common.LocaleString)
AbstractProcessModel.setProcessName(com.appiancorp.suiteapi.common.LocaleString)
AbstractProcessModel.setPriority(com.appiancorp.suiteapi.process.Priority)
ProcessModel.setVariables(com.appiancorp.suiteapi.process.ProcessVariable[])
must be populated, because these nodes require
variables to be defined.
For each process variable, the following fields must be populated:
key
,
value
,
type
, and
multiple
For each process node, the following fields
must be populated:
id
,
guiId
,
ownerId
,
ownerName
,
groupOwnerId
,
groupOwnerName
,
icon
,
paletteIcon
,
x
,
y
,
activityClass
,
preActivities
(can be an empty array),
postActivities
(can be an empty array),
connections
(can be an empty array),
notify
,
assign
(if the node is attended),
confirmationUrl
(populated by default),
schedule
,
escalations
(can be an empty array),
multipleInstance
,
notes
(can be an empty array),
attachments (can be an empty array)
,
priority
,
targetCompletion
(populated by default),
and
targetLag
(populated by default).
Within each process node, in the assign member, the following fields must
be populated: assignees
.
Within each process node, in the activity class member, the following
fields must be populated:
acSchemaId
,
localId
,
parameters
(can be an empty list),
customParameters
(can be an empty list),
unattended
,
runAs
(if it is unattended),
outputExpressions
(can be an empty list),
formConfig
(if it is attended),
and
helperClass
.
Within each activity class, for each activity class parameter,
the following fields must be populated:
acpSchemaId
,
expression
, and
validationMessages
.
pm_
- the processModel to updateInvalidProcessModelException
- if the process model does not existPrivilegeException
- if the user does not have privileges to
update the process modelLockException
- if the process model is locked by someone other
than the current userInvalidUuidException
- if the specified uuid
is
used by another process modelInvalidUserException
- if any user referenced in the
ProcessModel
does not existcom.appiancorp.asl3.servicefw.connect.ServiceException
- if a system-level error occurs.InvalidPriorityException
ProcessModel getProcessModel(java.lang.Long processModelId_) throws PrivilegeException, InvalidProcessModelException
ProcessModel
. If the information needed can
be retrieved from ProcessModel.Descriptor
consider calling the
getProcessModelDescriptor(Long)
method instead which is considerably
faster.processModelId_
- ID of the ProcessModel
to retrieveProcessModel
specified by
processModelId_
InvalidProcessModelException
- if the ProcessModel
specified by processModelId_
does not existPrivilegeException
- if the current User
does not have
sufficient privileges to view the ProcessModel
com.appiancorp.asl3.servicefw.connect.ServiceException
- if any system-level error occursProcessModel exportProcessModel(java.lang.Long processModelId_) throws PrivilegeException, InvalidProcessModelException
ProcessModel
.
Unlike getProcessModel(java.lang.Long)
, this API does not convert rule
uuids to names (within expressions). Therefore this API should be used
when retrieving a model for export.processModelId_
- ID of the ProcessModel
to retrieveProcessModel
specified by
processModelId_
InvalidProcessModelException
- if the ProcessModel
specified by processModelId_
does not existPrivilegeException
- if the current User
does not have
sufficient privileges to view the ProcessModel
com.appiancorp.asl3.servicefw.connect.ServiceException
- if any system-level error occurs@Deprecated ProcessModel.Descriptor[] listProcessModels()
getProcessModelDescriptors(Long[])
instead. This method performs
poorly and should not be called.com.appiancorp.asl3.servicefw.connect.ServiceException
- if any system-level error occursIdentity[] getActivityClassSchemas(java.lang.Long[] acsIds_) throws InvalidActivityClassSchemaException
ActivityClassSchema
representations
for the given IDsacsIds_
- the activity class schema IDsIdentity
objects which are abbreviated
representations of ActivityClassSchema
objects.InvalidActivityClassSchemaException
- if ActivityClassSchema
does not existcom.appiancorp.asl3.servicefw.connect.ServiceException
- if any system-level error occursActivityClassSchema getActivityClassSchema(java.lang.Long acsId_) throws InvalidActivityClassSchemaException
ActivityClassSchema
.acsId_
- the ID of the ActivityClassSchema
to retrieve.ActivityClassSchema
specified by
acsId_
InvalidActivityClassSchemaException
- if the ActivityClassSchema
specified
by acsId_
does not existcom.appiancorp.asl3.servicefw.connect.ServiceException
- if any system-level error occursActivityClassSchema getACSchemaByLocalId(java.lang.String acsLocalId_) throws InvalidActivityClassSchemaException
ActivityClassSchema
by local id.acsLocalId_
- the local ID of the ActivityClassSchema
to retrieve.ActivityClassSchema
specified by
acsLocalId_
InvalidActivityClassSchemaException
- if the ActivityClassSchema
specified
by acsId_
does not existcom.appiancorp.asl3.servicefw.connect.ServiceException
- if any system-level error occurs@Deprecated java.lang.Long startProcess(java.lang.Long processModelId_, ProcessVariable[] variables_) throws InvalidProcessModelException, PrivilegeException, InvalidStateException, StorageLimitException, InvalidUserException, java.lang.IllegalArgumentException, java.lang.Exception
initiateProcess(Long, ProcessStartConfig)
,
which has better enforcement of required parameters (requires that their
values not be null or empty)
The following fields must be populated for each ProcessVariable
object:
key
, value
, type
, and multiple
processModelId_
- id of process model to startvariables_
- parameters for the process model. If using a process variable of an Appian
type, do not set the value to that object but instead to the corresponding
primitive. For instance, do not assign a User process variable a
User
object. Instead, assign that process variable a
String
containing the username. Likewise, assign a process
variable of type Group should be assigned a Long
, etc. The
exception to this rule is the People type. Process variables of type People
should be assigned a LocalObject
. Only the values are used for
passed parameters, not expressions; expressions must be set on the process
model at design time.InvalidProcessModelException
- if the referenced process model does not exist or has been deleted.PrivilegeException
- if the user does not have permission to perform this action.InvalidStateException
- if there is no published version of the specified pm, the published version
is disabled, or if the process model contains sub process models that have
been disabled or deleted. Note that all sub process models of a published
process model must have been published, but they can still be disabled.InvalidUserException
- if any user referenced in any ProcessVariable
does not exist.java.lang.IllegalArgumentException
- if the ProcessModel
requires process parameters to start, and
the variables_
parameter is an empty array, or does not
contain all necessary process parameters.com.appiancorp.asl3.servicefw.connect.ServiceException
- if any system-level error occurs.java.lang.NullPointerException
- if processModelId_
or variables_
array is null.java.lang.Exception
StorageLimitException
@Deprecated java.lang.Long startProcessWithPriority(java.lang.Long processModelId_, ProcessVariable[] variables_, java.lang.Long priorityId_) throws InvalidProcessModelException, InvalidPriorityException, InvalidStateException, PrivilegeException, InvalidUserException, java.lang.IllegalArgumentException, java.lang.Exception
initiateProcess(Long, ProcessStartConfig)
,
which has better enforcement of required parameters (requires that their
values not be null or empty)processModelId_
- id of process model to startvariables_
- parameters for the process model. If using a process variable of an Appian
type, do not set the value to that object but instead to the corresponding
primitive. For instance, do not assign a User process variable a
User
object. Instead, assign that process variable a
String
containing the username. Likewise, assign a process
variable of type Group should be assigned a Long
, etc. The
exception to this rule is the People type. Process variables of type People
should be assigned a LocalObject
.priorityId_
- the priority with which to start the processInvalidPriorityException
- if the Priority does not existInvalidProcessModelException
- if the ProcessModel
does not existPrivilegeException
- if the user does not have permission to perform this actionInvalidStateException
- if there is no published version of the specified pm, the published version
is disabled, or if the process model contains sub process models that have
been disabled or deleted. Note that all sub process models of a published
process model must have been published, but they can still be disabled.InvalidUserException
- if any user referenced in any ProcessVariable
does not existjava.lang.IllegalArgumentException
- if the ProcessModel
requires process parameters to start, and
the variables_
parameter is null, an empty array, or does not
contain all necessary process parameters.com.appiancorp.asl3.servicefw.connect.ServiceException
- if any system-level error occursjava.lang.Exception
java.lang.Long initiateProcess(java.lang.Long processModelId, ProcessStartConfig config) throws InvalidProcessModelException, InvalidPriorityException, InvalidVersionException, PrivilegeException, InvalidStateException, StorageLimitException, InvalidUserException, java.lang.IllegalArgumentException, java.lang.Exception
processModelId_
- id of process model to startconfig
- additional configuration to control how the process is startedInvalidProcessModelException
- if the referenced process model does not exist or has been deleted.PrivilegeException
- if the user does not have permission to perform this action.InvalidStateException
- if there is no published version of the specified pm, the published version
is disabled, or if the process model contains sub process models that have
been disabled or deleted. Note that all sub process models of a published
process model must have been published, but they can still be disabled.InvalidUserException
- if any user referenced in any ProcessVariable
does not exist.java.lang.IllegalArgumentException
- if the ProcessModel
requires process parameters to start, and
any of the required parameters are missing or have not been given a value
that is not null or empty.com.appiancorp.asl3.servicefw.connect.ServiceException
- if any system-level error occurs.java.lang.NullPointerException
- if processModelId_
or variables_
array is null.java.lang.Exception
InvalidPriorityException
InvalidVersionException
StorageLimitException
@Deprecated ResultPage getProcessModelsForGroup(java.lang.Long groupId_, int startIndex_, int batchSize_, java.lang.Integer sortProperty_, java.lang.Integer sortOrder_)
getProcessModelsForFolder(java.lang.Long, int, int, java.lang.Integer, java.lang.Integer)
groupId_
- ID of the Group
for which to retrieve ProcessModel.Descriptor
objectsstartIndex_
- 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
Constants.COUNT_ALL
to return the entire collection, but this is
STRONGLY discouraged.sortProperty_
- the property by which the results will be sorted. This is one of the
SORT_BY_XXX
constants located in ProcessModel.Descriptor
sortOrder_
- the order in which to sort the results. This is one of
Constants.SORT_ORDER_ASCENDING
or
Constants.SORT_ORDER_DESCENDING
ResultPage
which contains an array of ProcessModel.Descriptor
objects
for each ProcessModel
owned by the Group
specified by groupId_
com.appiancorp.asl3.servicefw.connect.ServiceException
- if any system-level error occursProcessModelDetails getProcessModelDetails(java.lang.Long processModelId_) throws InvalidProcessModelException, PrivilegeException
ProcessModelDetails
representing the working drafts of
the given ProcessModel
If only requiring FormConfig, see getFormConfig
in this class.processModelId_
- ID of the ProcessModel
for which to
retrieve the ProcessModelDetails
ProcessModelDetails
which contains details about the
ProcessModel
specified by processModelId_
InvalidProcessModelException
- if the ProcessModel
specified
by processModelId_
does not existPrivilegeException
- if the current user does not have sufficient
privileges to perform this operationcom.appiancorp.asl3.servicefw.connect.ServiceException
- if any system-level error occursFormConfig getFormConfig(java.lang.Long processModelId_) throws InvalidProcessModelException, PrivilegeException
FormConfig
of the draft of the given process model.processModelId_
- ID of the ProcessModel
for which to retrieve the
FormConfig
FormConfig
InvalidProcessModelException
PrivilegeException
FormConfig getFormConfigForVersion(java.lang.Long processModelId, java.lang.String version) throws InvalidProcessModelException, InvalidVersionException, InvalidStateException, PrivilegeException
FormConfig
of the given process model version.processModelId
- ID of the ProcessModel
for which to retrieve the
FormConfig
version
- version of the process model (use null
to refer to a draft, or
AbstractProcessModel.LATEST_PUBLISHED_VERSION
to refer to the latest
published version)FormConfig
InvalidProcessModelException
InvalidVersionException
InvalidStateException
- if there is no published version of the specified pm, the published version
is disabled, or if the process model contains sub process models that have
been disabled or deleted. Note that all sub process models of a published
process model must have been published, but they can still be disabled.PrivilegeException
ResultList isStartFormCapable(java.lang.Long[] processModelIds, int capabilities)
ResultList.CODE_VALID
for that entry.processModelIds
- the process model idscapabilities
- a bitwise OR of any of the following values:
FormConfig.CAPABILITY_RENDER_WEB
,
FormConfig.CAPABILITY_RENDER_MOBILE
ResultList.CODE_VALID
if the process model exists and has the
requested capability, ResultList.CODE_INVALID
if the specified
process model does not exist, does not have a published version or does not have the requested capability, or
ResultList.CODE_NO_PERMISSION
if the user does not have
permission to view the given process model.ProcessModel.Descriptor[] getMyProcessModels()
ProcessModel
objects for which the current
user is an owner.ProcessModel.Descriptor
objects which
represent the ProcessModel
objects owned by the current
User
com.appiancorp.asl3.servicefw.connect.ServiceException
- if any sytem-level error occursProcessModel.Descriptor[] getProcessModelsICanStart()
ProcessModel.Descriptor
objects for each
ProcessModel
which the current user can start.com.appiancorp.asl3.servicefw.connect.ServiceException
- if any system-level error occurs@Deprecated ProcessModel[] getProcessModels(java.lang.Long[] ids_)
getProcessModelDescriptors(Long[])
or call
getProcessModel(Long)
iteratively instead.ProcessModel
objects, representing the
working drafts of the process models with the given IDs. This method will throw a
PrivilegeException
if an ID points to a ProcessModel
to which the
current user does not have "viewer" or higher privileges. If the information
needed can be retrieved from ProcessModel.Descriptor
consider calling the
getProcessModelDescriptors(Long[])
method instead which is considerably
faster.ids_
- Unique IDs of the ProcessModel
objects to retrieveProcessModel
objects specified by
ids_
java.lang.NullPointerException
- if it is called with a null argumentcom.appiancorp.asl3.servicefw.connect.ServiceException
- if any system-level error occursPrivilegeException
- if the user does not have "viewer" or higher privileges for any
of the referenced ProcessModel
s.ProcessVariable[] getProcessModelParameters(java.lang.Long processModelId_) throws InvalidProcessModelException, PrivilegeException, InvalidStateException, java.lang.Exception
processModelId_
- ID of the ProcessModel
for which to
retrieve the process parametersProcessVariable
objects which represent those
variables which are required to start the given
ProcessModel
InvalidProcessModelException
- if the ProcessModel
specified by processModelId_
does not exist.PrivilegeException
- if the current User
does not have
permissions to get the ProcessModel
's parametersInvalidStateException
- if there is no published version of the specified pm, the published version
is disabled, or if the process model contains sub process models that have
been disabled or deleted. Note that all sub process models of a published
process model must have been published, but they can still be disabled.com.appiancorp.asl3.servicefw.connect.ServiceException
- if any system-level error occursjava.lang.Exception
ProcessVariable[] getVisibleProcessVariables(java.lang.Long processModelId_) throws InvalidProcessModelException, PrivilegeException
processModelId_
- the unique Id of the process model to retrieve
variables forInvalidProcessModelException
- if the ProcessModel
specified by processModelId_
does not exist.PrivilegeException
- if the current User
does not have
permissions to get the ProcessModel
's parameterscom.appiancorp.asl3.servicefw.connect.ServiceException
- if any system-level error occursActivityClassSchema[] getAssigneePoolACSchemas()
ActivityClassSchema
objects which
represent the functions that operate on the assignee pool.com.appiancorp.asl3.servicefw.connect.ServiceException
- if any system-level error occursActivityClassSchema[] getAssignmentPoolACSchemas()
ActivityClassSchema
objects which
represent the functions that operate on the assignment pool.com.appiancorp.asl3.servicefw.connect.ServiceException
- if any system-level error occursvoid activateUserSession(java.lang.Long[] membership_, java.lang.Long[] administration_, java.lang.Long userTypeId_, java.lang.String username) throws InvalidUserException
This method should be called every time the group membership role of the
current user is changed (eg: from member to admin, etc), or when a new
group is created, or when the current user was newly created.
This method will skip any null
values for membership_
or
administration_
.
If the userTypeId_
is null
, the method will fail
but will NOT throw any exceptions
membership_
- An array of group IDs which represent the
groups to which the current user belongs.administration_
- An array of group IDs which represent the
groups for which the current user is an
administrator.userTypeId_
- this is one of
UserProfile.USER_TYPE_BASIC
or UserProfile.USER_TYPE_SYS_ADMIN
.
If neither or null is given, UserProfile.USER_TYPE_BASIC
will be assumed.username
- the username of the user whose session is to be activatedcom.appiancorp.asl3.servicefw.connect.ServiceException
- if any system-level error occursInvalidUserException
ActivityClassSchema[] getEscalationACSchemas()
ActivityClassSchema
objects which
represent all activity classes of type Escalationcom.appiancorp.asl3.servicefw.connect.ServiceException
- if any system-level error occursvoid deleteProcessModel(java.lang.Long processModelId_) throws InvalidProcessModelException, PrivilegeException
ProcessExecutionService.deleteProcess(java.lang.Long, boolean)
, and
ProcessExecutionService.deleteProcesses(java.lang.Long[], boolean)
processModelId_
- the ID of the ProcessModel
to
delete.InvalidProcessModelException
- if the ProcessModel
specified by processModelId_
does not exist.PrivilegeException
- if the current User
does not have
permissions to delete the ProcessModel
com.appiancorp.asl3.servicefw.connect.ServiceException
- if any system-level error occursvoid deleteProcessModels(java.lang.Long[] processModelIds_) throws InvalidProcessModelException, PrivilegeException
ProcessModel
objects. A model can
only be deleted if there are no processes that have been created from it on
any of the execution servers. To delete processes, use
ProcessExecutionService.deleteProcess(java.lang.Long, boolean)
, and
ProcessExecutionService.deleteProcesses(java.lang.Long[], boolean)
processModelIds_
- ids of process models to delete.InvalidProcessModelException
- if a specified ProcessModel
does not exist.PrivilegeException
- if the current User
does not have
permissions to delete a specified ProcessModel
com.appiancorp.asl3.servicefw.connect.ServiceException
- if any system-level error occursProcessModel.Descriptor getProcessModelDescriptor(java.lang.Long processModelId_) throws InvalidProcessModelException, PrivilegeException
ProcessModel
.processModelId_
- ID of the ProcessModel
for which to get
the descriptorProcessModel.Descriptor
specified by given
processModelId_
InvalidProcessModelException
- if the ProcessModel
specified by processModelId_
does not existPrivilegeException
- if the current User
does not have
sufficient privileges to get the ProcessModel
descriptorcom.appiancorp.asl3.servicefw.connect.ServiceException
- if any system-level error occursint getRecursiveRelationship(java.lang.Long processModelId_, java.lang.Long subProcessModelId_) throws InvalidProcessModelException
processModelId_
- id of process model to check for recursive
relationshipsubProcessModelId_
- subProcessModel to check for relationship
with parent ProcessModelDOES_NOT_RECURSE
, PARENT_PROCESS_RECURSES
or SUBPROCESS_RECURSES
InvalidProcessModelException
- if the ProcessModel
specified by
processModelId_
does not existcom.appiancorp.asl3.servicefw.connect.ServiceException
- if any system-level error occurs@Deprecated ResultList getSubProcessModelDescriptorsForProcessModel(java.lang.Long processModelId_) throws InvalidProcessModelException, PrivilegeException
getSynchronousSubProcessModelDescriptorsForProcessModel(java.lang.Long)
insteadprocessModelId_
- the unique ID of the process model to get the sub
process model descriptors forProcessModel.Descriptor
objects
that are subprocesses for the given process. 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 model does
not existInvalidProcessModelException
- if the process model is invalidPrivilegeException
- if the current user does not have sufficient
privileges to perform this operationcom.appiancorp.asl3.servicefw.connect.ServiceException
- if any system-level error occursResultList getSynchronousSubProcessModelDescriptorsForProcessModel(java.lang.Long processModelId_) throws InvalidProcessModelException, PrivilegeException
processModelId_
- the unique ID of the process model to get the
sub-process model descriptors forProcessModel.Descriptor
objects
that are subprocesses for the given process. 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 model does
not existInvalidProcessModelException
- if the process model is invalidPrivilegeException
- if the current user does not have sufficient
privileges to perform this operationcom.appiancorp.asl3.servicefw.connect.ServiceException
- if any system-level error occurs@Deprecated ResultList getProcessModelDescriptorsContainingSubProcessModel(java.lang.Long subProcessModelId_) throws InvalidProcessModelException, PrivilegeException
getProcessModelDescriptorsContainingSynchronousSubProcessModel(java.lang.Long)
insteadsubProcessModelId_
- The ID of the sub process model
which will be contained in the returned process modelsResultList
which contains an array of
ProcessModel.Descriptor
objects representing those
process models containing the given sub process model.
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 model does
not existInvalidProcessModelException
- if the ProcessModel
given by subProcessModelId_
is invalidPrivilegeException
- if the current user does not have
sufficient permissions to view the given process modelcom.appiancorp.asl3.servicefw.connect.ServiceException
- if any system-level error occursResultList getProcessModelDescriptorsContainingSynchronousSubProcessModel(java.lang.Long subProcessModelId_) throws InvalidProcessModelException, PrivilegeException
subProcessModelId_
- The ID of the sub-process model
which will be contained in the returned process modelsResultList
which contains an array of
ProcessModel.Descriptor
objects representing
process models that contain the given sub process model.
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 model does
not existInvalidProcessModelException
- if the ProcessModel
given by subProcessModelId_
is invalidPrivilegeException
- if the current user does not have
sufficient permissions to view the given process modelcom.appiancorp.asl3.servicefw.connect.ServiceException
- if any system-level error occurs@Deprecated ResultList getTopLevelProcessModelDescriptorsForSubProcessModel(java.lang.Long subProcessModelId_) throws InvalidProcessModelException, PrivilegeException
getTopLevelProcessModelDescriptorsForSynchronousSubProcessModel(java.lang.Long)
insteadsubProcessModelId_
- the process model to get top level
ProcessModel.Descriptor
objects forProcessModel.Descriptor
objects for all
top level process models of the given sub process model. This will return
an empty ResultList for models that solely form a recursive loop or if
called on a top-level process model.
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 model does
not existInvalidProcessModelException
- if the process model is invalidPrivilegeException
- if the current user does not have sufficient
privileges to perform this operationcom.appiancorp.asl3.servicefw.connect.ServiceException
- if any system-level error occursResultList getTopLevelProcessModelDescriptorsForSynchronousSubProcessModel(java.lang.Long subProcessModelId_) throws InvalidProcessModelException, PrivilegeException
subProcessModelId_
- the process model to get top level
ProcessModel.Descriptor
objects forProcessModel.Descriptor
objects for all
top level process models of the given sub process model. This will return
an empty ResultList for models that solely form a recursive loop or if
called on a top-level process model.
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 model does
not existInvalidProcessModelException
- if the process model is invalidPrivilegeException
- if the current user does not have sufficient
privileges to perform this operationcom.appiancorp.asl3.servicefw.connect.ServiceException
- if any system-level error occurs@Deprecated ResultList getLinkProcessModelDescriptorsForProcessModel(java.lang.Long processModelId_) throws InvalidProcessModelException, PrivilegeException
getAsynchronousSubProcessModelDescriptorsForProcessModel(java.lang.Long)
instead.processModelId_
- ID of the ProcessModel
for which to
retrieve the linked ProcessModel.Descriptor
objectsResultList
containing
ProcessModel.Descriptor
objects which represent the linked
ProcessModel
objects for the specified
ProcessModel
. 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 model does
not existInvalidProcessModelException
- if the ProcessModel
specified by processModelId_
is invalidPrivilegeException
- if the current user does not have
sufficient privileges to access the ProcessModel
com.appiancorp.asl3.servicefw.connect.ServiceException
- if any system-level error occursResultList getAsynchronousSubProcessModelDescriptorsForProcessModel(java.lang.Long processModelId_) throws InvalidProcessModelException, PrivilegeException
processModelId_
- ID of the ProcessModel
for which to
retrieve the linked ProcessModel.Descriptor
objectsResultList
containing
ProcessModel.Descriptor
objects which represent the linked
ProcessModel
objects for the specified
ProcessModel
. 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 model does
not existInvalidProcessModelException
- if the ProcessModel
specified by processModelId_
is invalidPrivilegeException
- if the current user does not have
sufficient privileges to access the ProcessModel
com.appiancorp.asl3.servicefw.connect.ServiceException
- if any system-level error occurs@Deprecated ResultList getProcessModelDescriptorsContainingLinkProcessModel(java.lang.Long linkProcessModelId_) throws InvalidProcessModelException, PrivilegeException
getProcessModelDescriptorsContainingAsynchronousSubProcessModel(java.lang.Long)
instead.linkProcessModelId_
- The ID of the linked ProcessModel
which will be contained in the returned ProcessModel
objectsResultList
which contains an array of
ProcessModel.Descriptor
objects which contain the linked
ProcessModel
specified by linkProcessModelId_
.
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 model does
not existInvalidProcessModelException
- if the linked
ProcessModel
does not existPrivilegeException
- if the current user does not have
sufficient permissions to view the ProcessModel
com.appiancorp.asl3.servicefw.connect.ServiceException
- if any system-level error occursResultList getProcessModelDescriptorsContainingAsynchronousSubProcessModel(java.lang.Long linkProcessModelId_) throws InvalidProcessModelException, PrivilegeException
linkProcessModelId_
- The ID of the linked ProcessModel
which will be contained in the returned ProcessModel
objectsResultList
which contains an array of
ProcessModel.Descriptor
objects which contain the linked
ProcessModel
specified by linkProcessModelId_
.
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 model does
not existInvalidProcessModelException
- if the linked
ProcessModel
does not existPrivilegeException
- if the current user does not have
sufficient permissions to view the ProcessModel
com.appiancorp.asl3.servicefw.connect.ServiceException
- if any system-level error occurs@Deprecated ResultList getTopLevelProcessModelDescriptorsForLinkProcessModel(java.lang.Long linkProcessModelId_) throws InvalidProcessModelException, PrivilegeException
getTopLevelProcessModelDescriptorsForAsynchronousSubProcessModel(java.lang.Long)
insteadResultList
containing process model descriptors
representing the working drafts of thetop level process models of the given
linked process modellinkProcessModelId_
- the process model to get top level
process model descriptors forProcessModel.Descriptor
objects for
all top level process models of the given linked process model. This will
return an empty ResultList for models that solely form a recursive loop or
if called on a top level process model.InvalidProcessModelException
- if the process model is invalidPrivilegeException
- if the current user does not have sufficient
privileges to perform this operationcom.appiancorp.asl3.servicefw.connect.ServiceException
- if any system-level error occursResultList getTopLevelProcessModelDescriptorsForAsynchronousSubProcessModel(java.lang.Long linkProcessModelId_) throws InvalidProcessModelException, PrivilegeException
ResultList
containing process model descriptors
that represent the working drafts of all parent process models for the given
linked process modellinkProcessModelId_
- the process model to get top level
process model descriptors forProcessModel.Descriptor
objects for
all top level process models of the given linked process model. This will
return an empty ResultList for models that solely form a recursive loop or
if called on a top level process model.InvalidProcessModelException
- if the process model is invalidPrivilegeException
- if the current user does not have sufficient
privileges to perform this operationcom.appiancorp.asl3.servicefw.connect.ServiceException
- if any system-level error occursSecurity getSecurityForProcessApplication() throws PrivilegeException
Security
object (with all fields populated)
that contains the security for the process application. The role maps in the
Security
object are ProcessApplicationRoleMap
objects.PrivilegeException
- if the current user does not have sufficient
privileges to perform this operationcom.appiancorp.asl3.servicefw.connect.ServiceException
- if any system-level error occursvoid setSecurityForProcessApplication(Security s_) throws PrivilegeException, InvalidUserException
canInherit
and inheritable
will be ignored
(doesInherit
is not ignored).s_
- a Security
object which encapsulates the security
settings of the Process Application. The role maps in the
Security
object must be ProcessRoleMap
objectsPrivilegeException
- if the current user does not have sufficient
privileges to perform this operationInvalidUserException
- if any user referenced in the
Security
does not existcom.appiancorp.asl3.servicefw.connect.ServiceException
- if any system-level error occursSecurity getSecurityForProcessModel(java.lang.Long id_) throws InvalidProcessModelException, PrivilegeException
id_
- the unique Id of the process modelSecurity
object (with all fields populated) that
contains the security settings of the process model. The role maps in the
Security
object are be ProcessRoleMap
objectsInvalidProcessModelException
- if the ProcessModel
specified does not existPrivilegeException
- if the current user does not have sufficient
privileges to perform this operationcom.appiancorp.asl3.servicefw.connect.ServiceException
- if any system-level error occursvoid setSecurityForProcessModel(java.lang.Long id_, Security s_) throws InvalidProcessModelException, PrivilegeException, InvalidUserException
canInherit
and inheritable
(doesInherit
is not ignored).id_
- the unique Id of the process models_
- a Security
object which encapsulates the security
settings of the process model. The role maps in the
Security
object must be ProcessRoleMap
objectsInvalidProcessModelException
- if the ProcessModel
specified does not existPrivilegeException
- if the current user does not have sufficient
privileges to perform this operationInvalidUserException
- if any user referenced in the
Security
does not existcom.appiancorp.asl3.servicefw.connect.ServiceException
- if any system-level error occursvoid setActorsInRolesForProcessApplication(java.lang.String[] users_, java.lang.String[][] userRoles_, java.lang.Long[] groups_, java.lang.String[][] groupRoles_) throws PrivilegeException, InvalidUserException, InvalidRoleException
setSecurityForProcessApplication(Security)
See ProcessRoleMap
for valid roles.users_
- the list of 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 of size [users_.length][]. The
String array userRoles_[i] represents the roles which users_[i] will have.
(If this array is null or zero-length, the user have no explicit
permissions in the Process Application role map). It is legal to have null
within this array.groups_
- the list of 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 of size [groups_.length][]. The
String 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 in the Process Application role map). It is legal to have null within
this array.PrivilegeException
- if the current user does not have sufficient
privileges to perform this operationInvalidUserException
- if any users does not existInvalidRoleException
- if an invalid role is passed to the methodcom.appiancorp.asl3.servicefw.connect.ServiceException
- if any system-level error occursvoid setActorsInRolesForProcessModel(java.lang.Long id_, java.lang.String[] users_, java.lang.String[][] userRoles_, java.lang.Long[] groups_, java.lang.String[][] groupRoles_) throws InvalidProcessModelException, PrivilegeException, InvalidUserException, InvalidRoleException
setSecurityForProcessModel(Long, Security)
See ProcessRoleMap
for valid roles.id_
- the unique Id of the process modelusers_
- the list of 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 of size [users_.length][]. The
String array userRoles_[i] represents the roles which users_[i] will have.
(If this array is null or zero-length, the user have no explicit
permissions in the process model role map)groups_
- the list of 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 of size [groups_.length][]. The
String 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 in the process model role map)InvalidProcessModelException
- if the ProcessModel
specified does not existPrivilegeException
- if the current user does not have sufficient
privileges to perform this operationInvalidUserException
- if any users does not existInvalidRoleException
- if an invalid role is passed to the methodcom.appiancorp.asl3.servicefw.connect.ServiceException
- if any system-level error occursProcessApplicationPermissions getPermissionsForProcessApplication() throws InvalidUserException
ProcessApplicationPermissions
object which contains
the permissions for the current user on the Process Applicationcom.appiancorp.asl3.servicefw.connect.ServiceException
- if any system-level error occursInvalidUserException
ProcessModelPermissions getPermissionsForProcessModel(java.lang.Long id_) throws InvalidProcessModelException
id_
- ID of the ProcessModel
for which to get the
ProcessModelPermissions
ProcessModelPermissions
object which contains the
permissions on the process model for the current
user.InvalidProcessModelException
- if the ProcessModel
specified does not existcom.appiancorp.asl3.servicefw.connect.ServiceException
- if any system-level error occursProcessModelPermissions[] getPermissionsForProcessModels(java.lang.Long[] ids_) throws InvalidProcessModelException
ids_
- Unique IDs of the process models for which
to get the ProcessModelPermissions
ProcessModelPermissions
which contain the permissions
on the process models for the current userInvalidProcessModelException
- if a specified ProcessModel
does not existcom.appiancorp.asl3.servicefw.connect.ServiceException
- if any system-level error occursPriority getPriority(java.lang.Long priorityId_) throws InvalidPriorityException
Priority
priorityId_
- ID of the Priority
to retrievePriority
coresponding to priorityId_
InvalidPriorityException
- if the Priority
does not
existcom.appiancorp.asl3.servicefw.connect.ServiceException
- if any system-level error occursPriority getDefaultPriority()
Priority
for the system.Priority
; null
if no default
is configured.void setDefaultPriority(java.lang.Long priorityId_) throws InvalidPriorityException, java.lang.IllegalArgumentException
priorityId_
- the ID of the priority to set as the default priorityInvalidPriorityException
- if the specificed priority does not existjava.lang.IllegalArgumentException
- if a null
argument is passedcom.appiancorp.asl3.servicefw.connect.ServiceException
- if any system-level error occursPriority getPriorityOfProcessModel(java.lang.Long processModelId_) throws InvalidProcessModelException, PrivilegeException
ProcessModel
.processModelId_
- ID of the ProcessModel
for which to
retrieve the Priority
Priority
for the ProcessModel
specified by processModelId_
InvalidProcessModelException
- if the specified
ProcessModel
does not existPrivilegeException
- if the current user does not have privileges to
view the process modelcom.appiancorp.asl3.servicefw.connect.ServiceException
- if any system-level error occursvoid setPriorityOfProcessModel(java.lang.Long processModelId_, java.lang.Long priorityId_) throws InvalidPriorityException, InvalidProcessModelException, PrivilegeException
processModelId_
- the unique id of the process model to set the
priority ofpriorityId_
- the unique id of the priority to setInvalidPriorityException
- if the priority does not existInvalidProcessModelException
- if the process model does not existPrivilegeException
- if the current user does not have sufficient
permissions to perform this actioncom.appiancorp.asl3.servicefw.connect.ServiceException
- if any system-level error occursvoid lockProcessModel(java.lang.Long processModelId_, boolean override_) throws InvalidProcessModelException, PrivilegeException, LockException
processModelId_
- the unique ID of the process model to lockoverride_
- whether or not to override the lock another user
has placed on the process modelInvalidProcessModelException
- if the process model does not existPrivilegeException
- if the user does not have access to lock
(or override the existing lock, if specified) of the process
modelLockException
- if the process model is already locked (by someone
other than the user) and the
user did not choose to override it.com.appiancorp.asl3.servicefw.connect.ServiceException
- if any system-level error occursProcessModel getProcessModelVersion(java.lang.Long processModelId_, java.lang.String version_) throws InvalidProcessModelException, InvalidVersionException, PrivilegeException
ProcessModel
. If the version is
null
or empty, it returns the latest saved draft.processModelId_
- ID of the ProcessModel
whose version
will be retrievedversion_
- The version of the ProcessModel
to retrieveProcessModel
given by processModelId_
and version_
InvalidProcessModelException
- if the ProcessModel
does
not existInvalidVersionException
- if the ProcessModel
does not
have the given versionPrivilegeException
- if the current user does not have
sufficient permissions to view the ProcessModel
versionProcessModel exportProcessModelVersion(java.lang.Long processModelId_, java.lang.String version_) throws InvalidProcessModelException, InvalidVersionException, PrivilegeException
ProcessModel
. If the version is
null
or empty, it returns the latest saved draft.
Unlike getProcessModelVersion(java.lang.Long, java.lang.String)
, this API does not convert rule
uuids to names (within expressions). Therefore this API should be used
when retrieving a model for export.processModelId_
- ID of the ProcessModel
whose version
will be retrievedversion_
- The version of the ProcessModel
to retrieveProcessModel
given by processModelId_
and version_
InvalidProcessModelException
- if the ProcessModel
does
not existInvalidVersionException
- if the ProcessModel
does not
have the given versionPrivilegeException
- if the current user does not have
sufficient permissions to view the ProcessModel
versionProcessModel versionProcessModel(ProcessModel pm_) throws InvalidProcessModelException, PrivilegeException, LockException, InvalidUserException
createProcessModel(com.appiancorp.suiteapi.process.ProcessModel)
for the properties that
must be populated on the process model.
It creates a new process model if the process model Id
is set to -1.pm_
- a ProcessModel
object representing the
new process model versionProcessModel
object representing the versioned
process modelInvalidProcessModelException
- if the ID of the process model does
not correspond to a valid process modelPrivilegeException
- if the user does not have privileges to
version the process modelLockException
- if the process model is locked by someone other
than the current userInvalidUserException
- if any of the users referenced in the
ProcessModel
do not existcom.appiancorp.asl3.servicefw.connect.ServiceException
- if a system-level error occurs.ProcessModel versionProcessModel(ProcessDiagram pm_) throws InvalidProcessModelException, PrivilegeException, LockException, InvalidUserException
ResultPage getProcessModelsForFolder(java.lang.Long folderId_, int startIndex_, int batchSize_, java.lang.Integer sortProperty_, java.lang.Integer sortOrder_) throws InvalidFolderException, PrivilegeException
folderId_
- ID of the ProcessModelFolder
for which to
retrieve all contained ProcessModel
objectsstartIndex_
- 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 Constants.COUNT_ALL
to return the entire collection, but this is STRONGLY discouraged.sortProperty_
- the property by which the results will be sorted.
This is one of the SORT_BY_XXX
constants located in
ProcessModel.Descriptor
sortOrder_
- the order in which to sort the results.
This is one of
Constants.SORT_ORDER_ASCENDING
or Constants.SORT_ORDER_DESCENDING
ResultPage
which contains an array of
ProcessModel.Descriptor
objectsInvalidFolderException
- if the ProcessModelFolder
does
not existPrivilegeException
- if the current user does not have
permission to access the folderResultPage getChildFolders(java.lang.Long folderId_, int startIndex_, int batchSize_, java.lang.Integer sortProperty_, java.lang.Integer sortOrder_) throws InvalidFolderException, PrivilegeException
folderId_
- id of the folder for which to get child foldersstartIndex_
- 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 located in
ProcessModelFolder
sortOrder_
- the order in which to sort the results.
This is one of
Constants.SORT_ORDER_ASCENDING
or Constants.SORT_ORDER_DESCENDING
ResultPage
which contains an array of
ProcessModelFolder
objectsInvalidFolderException
- if the ProcessModelFolder
specified by folderId_
does not existPrivilegeException
- if the current user does not have
access to the ProcessModelFolder
com.appiancorp.asl3.servicefw.connect.ServiceException
- if any system-level error occursResultPage getTopLevelFolders(int startIndex_, int batchSize_, java.lang.Integer sortProperty_, java.lang.Integer sortOrder_)
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 located in
ProcessModelFolder
sortOrder_
- the order in which the results will be sorted
This is one of
Constants.SORT_ORDER_ASCENDING
or Constants.SORT_ORDER_DESCENDING
ResultPage
of ProcessModelFolder
objects
representing the top level folderscom.appiancorp.asl3.servicefw.connect.ServiceException
- if any system-level error occursResultPage getVersionsForProcessModel(java.lang.Long processModelId_, int startIndex_, int batchSize_, java.lang.Integer sortProperty_, java.lang.Integer sortOrder_) throws InvalidProcessModelException, PrivilegeException
processModelId_
- the id of the process model to get versions forstartIndex_
- 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 Constants.COUNT_ALL
to return
the entire collection, but this is STRONGLY discouraged.sortProperty_
- the property by which the results will be sorted.
This is one of the SORT_BY_XXX
constants located in
ProcessModel.Descriptor
sortOrder_
- The order in which to sort the results. This is either
Constants.SORT_ORDER_ASCENDING
or
Constants.SORT_ORDER_DESCENDING
ResultPage
containing
ProcessModel.Descriptor
objects
representing the versions of the specified process model.InvalidProcessModelException
- if the process model does not existPrivilegeException
- if the user does not have permissions to view
the process modelcom.appiancorp.asl3.servicefw.connect.ServiceException
- if any system-level error occursvoid setActorsInRolesForFolder(java.lang.Long folderId_, java.lang.String[] users_, java.lang.String[][] userRoles_, java.lang.Long[] groups_, java.lang.String[][] groupRoles_) throws InvalidFolderException, PrivilegeException, InvalidUserException, InvalidRoleException
setSecurityForFolder(Long, Security)
See ProcessRoleMap
for valid roles.folderId_
- the unique id of the process model folderusers_
- the list of users (user names) 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-dimensional array of size [users_.length]. The
String 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 in the process model folder's role map)groups_
- the list of 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 of size [groups_.length]. The
String array groupRoles_[i] represents
the roles which groups_[i] will have.
(If this array is null or zero-length, the group has no explicit
permissions in the process model folder's role map)InvalidFolderException
- if the folder does not existPrivilegeException
- if the user does not have permission to perform
the operationInvalidUserException
- if any of the users do not existInvalidRoleException
- if an invalid role is passed to the methodcom.appiancorp.asl3.servicefw.connect.ServiceException
- if any system-level error occursvoid unlockProcessModel(java.lang.Long processModelId_, boolean override_) throws InvalidProcessModelException, PrivilegeException, LockException
processModelId_
- the unique id of the process model to unlockoverride_
- whether or not to break a lock on the given process model,
if it is currently locked by someone other than the current userInvalidProcessModelException
- if the process model does not existLockException
- if the process model is already locked and the user
has not specified to override itPrivilegeException
- if the user does not have privileges to unlock
the process modelcom.appiancorp.asl3.servicefw.connect.ServiceException
- if any system-level error occursvoid unlockProcessModels()
com.appiancorp.asl3.servicefw.connect.ServiceException
- if any system-level error occursProcessModelFolder getFolder(java.lang.Long folderId_) throws InvalidFolderException, PrivilegeException
ProcessModelFolder
.folderId_
- ID of the ProcessModelFolder
to retrieveProcessModelFolder
specified by
folderId_
InvalidFolderException
- if the ProcessModelFolder
does not existPrivilegeException
- if the current User
does not have
permission to access to the foldercom.appiancorp.asl3.servicefw.connect.ServiceException
- if any system-level error occursResultList getFolders(java.lang.Long[] folderIds_)
folderIds_
- Unique IDs of the process model folders to retrieve.ResultList
which contains an array of ProcessModelFolder
objects, and result codes. In the case where there is an exception (such as access restriction)
the ResultList.getResultCodes() will have an entry for every id passed to it,
but the Result.getResults()
will only have an entry for every valid result
returned.
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 folder does
not existcom.appiancorp.asl3.servicefw.connect.ServiceException
- if any system-level error occurs@Deprecated java.lang.Long startProcessVersion(java.lang.Long processModelId_, ProcessVariable[] variables_, java.lang.String version_, java.lang.Long priorityId_) throws InvalidProcessModelException, InvalidPriorityException, InvalidVersionException, PrivilegeException, InvalidStateException, StorageLimitException, InvalidUserException, java.lang.IllegalArgumentException, java.lang.Exception
initiateProcess(Long, ProcessStartConfig)
,
which has better enforcement of required parameters (requires that their
values not be null or empty)processModelId_
- id of process model to startvariables_
- parameters for the process model. If using a process variable of an Appian
type, do not set the value to that object but instead to the corresponding
primitive. For instance, do not assign a User process variable a
User
object. Instead, assign that process variable a
String
containing the username. Likewise, assign a process
variable of type Group should be assigned a Long
, etc. The
exception to this rule is the People type. Process variables of type People
should be assigned a LocalObject
.version_
- version of the given process model to startpriorityId_
- priority of the process model to start, null
if the default
priority is to be usedInvalidProcessModelException
- if the process model is invalidInvalidPriorityException
- if the priority is invalidInvalidVersionException
- if the version is invalidPrivilegeException
- if the user does not have privileges to perform thisInvalidStateException
- if the version does not existStorageLimitException
- if all execution servers are fullInvalidUserException
- if any of the users users referenced by a ProcessVariable
does
not existjava.lang.IllegalArgumentException
- if the ProcessModel
requires process parameters to start, and
the variables_
parameter is null, an empty array, or does not
contain all necessary process parameters.com.appiancorp.asl3.servicefw.connect.ServiceException
- if any system-level error occursjava.lang.Exception
ProcessModelProperties getProcessModelProperties(java.lang.Long modelId_) throws PrivilegeException, InvalidProcessModelException
ProcessModelProperties
representing the working
draft of a ProcessModel
.modelId_
- ID of the ProcessModel
for which to retrieve
the ProcessModelProperties
ProcessModelProperties
object which contains the
properties for the ProcessModel
given by
modelId_
PrivilegeException
- if the current user does not have
sufficient privileges to view the ProcessModel
InvalidProcessModelException
- if the ProcessModel
does not exista
- ServiceException if any system-level error occurs@Deprecated int getMaximumNumberOfNotes()
com.appiancorp.asl3.servicefw.connect.ServiceException
- if any system-level error occursint getMaximumNumberOfAttachments()
com.appiancorp.asl3.servicefw.connect.ServiceException
- if any system-level error occursResultList getUnpublishedChildrenForProcessModel(java.lang.Long processModelId_) throws InvalidProcessModelException, PrivilegeException
processModelId_
- the id of the process model to get unpublished
children forProcessModel.Descriptor
objects
of the process model's unpublished children
The result codes are as follows:
UNPUBLISHED_CHILDREN_VIEW_PERMISSIONS
=
No permissions, cannot view process model;
UNPUBLISHED_CHILDREN_INVALID
=
Invalid Process Model (a process model that cannot be run);
UNPUBLISHED_CHILDREN_PUBLISH_PERMISSIONS
=
No permissions to publish the process model;
UNPUBLISHED_CHILDREN_SUCCESS
= SuccessInvalidProcessModelException
- if the process model does not existcom.appiancorp.asl3.servicefw.connect.ServiceException
- if any system-level error occursPrivilegeException
ResultList getParentsForProcessModel(java.lang.Long processModelId_) throws InvalidProcessModelException, PrivilegeException
ProcessModel
.
If the process model is not a sub process model in any other
process model, the returned ResultList
will have an empty
result set.processModelId_
- ID of the ProcessModel
for which to get
the parents.ProcessModel.Descriptor
objects which represent the parents
of the ProcessModel
specified by processModelId_
.
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 model does
not existInvalidProcessModelException
- if the ProcessModel
does
not exist.PrivilegeException
- if the user does not have privileges
to view the process modelResultList getParentsOfUnpublishedChildrenForProcessModel(java.lang.Long processModelId_) throws InvalidProcessModelException, PrivilegeException
ProcessModel
.
Does not return the ProcessModel
itself or its parents.processModelId_
- ID of the ProcessModel
for which to
retrieve the parents of the unpublished children.ProcessModel.Descriptor
objects which represent the parents
of the unpublished children of the ProcessModel
specified by
processModelId_
.
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 model does
not existInvalidProcessModelException
- if the ProcessModel
does
not existPrivilegeException
- if the user does not have privileges
to view the process modelcom.appiancorp.asl3.servicefw.connect.ServiceException
- if any system-level error occurs.@Deprecated ProcessModel publishProcessModel(ProcessModel processModel_) throws InvalidProcessModelException, PrivilegeException, LockException, InvalidStateException, InvalidUserException
processModel_
- process model to publishInvalidProcessModelException
- if the ID of the process model does
not correspond to a valid IDPrivilegeException
- if the user does not have privileges
to publish the process modelLockException
- if the process model is lockedInvalidStateException
- if the process model is in an invalid state
(not validated)InvalidUserException
- if any of the users referenced by the
ProcessModel
does not existcom.appiancorp.asl3.servicefw.connect.ServiceException
- if any system-level error occursProcessModelWithErrors saveAndPublishProcessModel(ProcessModel processModel_, boolean overrideLock_) throws InvalidProcessModelException, PrivilegeException, LockException, InvalidStateException, InvalidUserException, InvalidUuidException, InvalidFolderException, InvalidPriorityException
ProcessModel.Descriptor
objects are returned for those models
that were published and owners notified, those that cannot be published and
those parents of unpublished children that were notified.processModel_
- the model to save and publishoverrideLock_
- whether to lock the model if it is already lockedProcessModelWithErrors
data structure holding the saved
and/or published model and descriptions of any errors that occurredInvalidProcessModelException
- if the ID of the process model does
not correspond to a valid IDPrivilegeException
- if the user does not have privileges
to save or publish the process modelLockException
- if the process model is locked and we cannot overrideInvalidStateException
- if the process model is in an invalid state
(not validated)InvalidUserException
- if any of the users referenced in the
ProcessModel
do not existInvalidUuidException
- if any of the UUIDs referenced do not existInvalidFolderException
- if folder ID where processModel is to be saved
does not existInvalidPriorityException
- if priority for the processModel is invalidProcessVariable[] getVisibleProcessVariablesForVersion(java.lang.Long processModelId_, java.lang.String version_) throws InvalidProcessModelException, InvalidVersionException, PrivilegeException
processModelId_
- the unique Id of the process model to retrieve
variables forversion_
- version to get the parameters forInvalidProcessModelException
- if the process model does not existInvalidVersionException
- if the version does not exsitPrivilegeException
- if the user does not have sufficient privileges
to perform the operationcom.appiancorp.asl3.servicefw.connect.ServiceException
- if any system-level error occursProcessVariable[] getProcessModelParametersForVersion(java.lang.Long processModelId_, java.lang.String version_) throws InvalidProcessModelException, InvalidVersionException, PrivilegeException, java.lang.Exception
processModelId_
- ID of the ProcessModel
for which to
retrieve ProcessParameters
version_
- The version of the ProcessModel
for which to
retrieve ProcessParameters
(use null
to refer
to a draft)ProcessVariable
objects which represent those
variables which are required to start the ProcessModel
version given by processModelId_
and version_
InvalidProcessModelException
- if the ProcessModel
does
not existInvalidVersionException
- if the ProcessModel
version
does not existPrivilegeException
- if the current User
does not have
permissions to view the ProcessModel
java.lang.Exception
int getCountProcessModelParametersForVersion(java.lang.Long processModelId_, java.lang.String version_) throws InvalidProcessModelException, InvalidVersionException, PrivilegeException, java.lang.Exception
processModelId_
- ID of the ProcessModel
for which to
retrieve ProcessParameters
version_
- The version of the ProcessModel
for which to
retrieve ProcessParameters
(use null
to refer
to a draft)ProcessVariable
objects which represent those
variables which are required to start the ProcessModel
version given by processModelId_
and version_
InvalidProcessModelException
- if the ProcessModel
does
not existInvalidVersionException
- if the ProcessModel
version
does not existPrivilegeException
- if the current User
does not have
permissions to view the ProcessModel
java.lang.Exception
ProcessModelFolder updateFolder(ProcessModelFolder folder_) throws PrivilegeException, java.lang.IllegalArgumentException, InvalidFolderException, RecursiveRelationshipException
ProcessModelFolder
object:
id
,
name
,
description
,
and
parentFolderId
folder_
- a ProcessModelFolder
object containing the
properties of the folder to update. This methods will update
name
, description
and
parentFolderId
. Other fields will not be updated.ProcessModelFolder
object representing the updated
folderPrivilegeException
- if the user does not have permissions to perform
this actionjava.lang.IllegalArgumentException
- if the type
of the folder is
different from the previous type (not thrown if the new type
is null
, in which case the new type
is ignored)InvalidFolderException
- if the ID of the folder does not correspond
to a valid folder, or if the ID of the parent folder is invalidRecursiveRelationshipException
- if the update would result in a loop
in the tree of parent folderscom.appiancorp.asl3.servicefw.connect.ServiceException
- if a system-level error occurs.ProcessModelFolder createFolder(ProcessModelFolder folder_) throws PrivilegeException, java.lang.IllegalArgumentException, DuplicateUuidException
ProcessModelFolder
object:
name
,
and
type
folder_
- The ProcessModelFolder
to create.ProcessModelFolder
PrivilegeException
- if the current user does not have
permissions to create a ProcessModelFolder
java.lang.IllegalArgumentException
- if the type of folder is invalid. It must
be one of two types: ProcessModelFolder.TYPE_COMMUNITY
or
ProcessModelFolder.TYPE_PRIVATE
. This exception will also be thrown if the parent
folder is invalid (Top level folders must have a null
parent folder id).com.appiancorp.asl3.servicefw.connect.ServiceException
- if any system-level error occursDuplicateUuidException
- if the UUID of the folder already existsvoid disableProcessModel(java.lang.Long processModelId_, java.lang.String version_) throws InvalidProcessModelException, PrivilegeException, InvalidVersionException
ProcessModel
.processModelId_
- ID of the ProcessModel
on which to
disable a version.version_
- The ID of the version to disable.InvalidProcessModelException
- if the ProcessModel
specified by processModelId_
does not exist.PrivilegeException
- if the current User
does not have
sufficient permissions to disable a versionInvalidVersionException
- if the given version does not exist for the
ProcessModel
com.appiancorp.asl3.servicefw.connect.ServiceException
- if any system-level error occursvoid enableProcessModel(java.lang.Long processModelId_, java.lang.String version_) throws InvalidProcessModelException, PrivilegeException, InvalidVersionException
ProcessModel
version.processModelId_
- The ID of the ProcessModel
which has
the version to enable.version_
- The name of the version to enableInvalidProcessModelException
- if the ProcessModel
specified by processModelId_
does not exist.PrivilegeException
- if the current user does not have
sufficient permissions to enable the version.InvalidVersionException
- if the given version does not exist for the
ProcessModel
com.appiancorp.asl3.servicefw.connect.ServiceException
- if any system-level error occursResultList deleteFolders(java.lang.Long[] folders_)
folders_
- The ProcessModelFolder
objects to delete.ResultList
containing result codes for each
deletion. Possible values are: ResultList.CODE_NO_PERMISSION
if
the user does not have permission,
ResultList.CODE_INVALID
if the folder does not exist or
is not empty, and ResultList.CODE_VALID
if the delete succeeded
.com.appiancorp.asl3.servicefw.connect.ServiceException
- if any system-level error occursvoid deleteFolder(java.lang.Long folderId_) throws InvalidFolderException, PrivilegeException, InvalidStateException
ProcessModelFolder
folderId_
- id of the ProcessModelFolder
to delete.InvalidFolderException
- if the ProcessModelFolder
specified by folderId_
does not exist.PrivilegeException
- if the current user does not have
sufficient privileges to delete the ProcessModelFolder
.InvalidStateException
- if the ProcessModelFolder
is not empty (it must not contain sub-folders or process models)com.appiancorp.asl3.servicefw.connect.ServiceException
- if any system-level error occursResultList updateFolders(ProcessModelFolder[] processModelFolders_) throws RecursiveRelationshipException
ProcessModelFolder
object:
id
,
name
,
description
,
and
parentFolderId
processModelFolders_
- an array of ProcessModelFolder
objects each containing the
properties of the folders to update. This method will update
name
, description
, parentFolderId
.
Other fields will not be updated.ProcessModeFolder
objects and result codes for the operations.
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 folder does
not exist or its parent folder does not existRecursiveRelationshipException
- if the updates would result in a loop
in the tree of parent folderscom.appiancorp.asl3.servicefw.connect.ServiceException
- if a system-level error occurs.ResultList updateProcessModelsWithDescriptors(ProcessModel.Descriptor[] descriptors_)
ProcessModel.Descriptor
at least the
following fields must be populated: id
and
processName
descriptors_
- the ProcessModel.Descriptor
objects that
represent the process models to updateProcessModel.Descriptor
objects and a list of result codes
for the operations.
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 model does
not existcom.appiancorp.asl3.servicefw.connect.ServiceException
- if a system-level error occurs.Security getSecurityForFolder(java.lang.Long folderId_) throws InvalidFolderException, PrivilegeException
folderId_
- the unique Id of the folder to retrieve security forSecurity
object (with all fields populated) that
contains that security settings for the folder. The role maps in the
Security
object are be ProcessRoleMap
objectsInvalidFolderException
- if the folder doesn't existPrivilegeException
- if the user doesn't have privilegescom.appiancorp.asl3.servicefw.connect.ServiceException
- if any system-level error occursvoid setSecurityForFolder(java.lang.Long folderId_, Security security_) throws PrivilegeException, InvalidFolderException, InvalidUserException
canInherit
and inheritable
will be ignored
(doesInherit
is not ignored).folderId_
- the unique id of the folder to set security forsecurity_
- a Security
object representing the security
to set. The role maps in the
Security
object must be ProcessRoleMap
objectsPrivilegeException
- if the user doesn't have privilegesInvalidFolderException
- if the folder doesn't existInvalidUserException
- if any of the users referenced by the
Security
does not existcom.appiancorp.asl3.servicefw.connect.ServiceException
- if any system-level error occursResultList getProcessModelDescriptors(java.lang.Long[] pmIds_)
pmIds_
- Unique IDs of the ProcessModel
objects for
which to retrieve descriptorsResultList
which contains an array of
ProcessModel.Descriptor
objects and an array of result codes
which correspond to each ID.
The result codes can be:
ResultList.CODE_VALID
if the action succeeded,
ResultList.CODE_NO_PERMISSION
if the user does not have viewer
permission, or
ResultList.CODE_INVALID
if the specified process model does
not existResultList getProcessModelsLatestPublishedDescriptors(java.lang.Long[] pmIds_)
pmIds_
- Unique IDs of the ProcessModel
objects for
which to retrieve descriptorsResultList
which contains an array of
ProcessModel.Descriptor
objects and an array of result codes
which correspond to each ID.
The result codes can be:
ResultList.CODE_VALID
if the action succeeded,
ResultList.CODE_NO_PERMISSION
if the user does not have viewer
permission, or
ResultList.CODE_INVALID
if the specified process model does
not existProcessModel.Descriptor getProcessModelVersionDescriptor(java.lang.Long processModelId_, java.lang.String version_) throws InvalidProcessModelException, InvalidVersionException, PrivilegeException
ProcessModel
. If null is given as a parameter
for version, the returned value will be the descriptor of
the draft.processModelId_
- ID of the ProcessModel
whose version
will be retrievedversion_
- The version of the ProcessModel
for which to
get the ProcessModel.Descriptor
ProcessModel.Descriptor
for the
ProcessModel
given by processModelId_
and
version_
InvalidProcessModelException
- if the ProcessModel
does
not existInvalidVersionException
- if the version of the process model does
not existPrivilegeException
- if the current user does not have
permissions to view the ProcessModel
or versionvoid moveProcessModel(java.lang.Long processModelId_, java.lang.Long parentFolderId_) throws InvalidProcessModelException, InvalidFolderException, PrivilegeException
processModelId_
- the unique id of process model to moveparentFolderId_
- the unique id of new parent folderInvalidProcessModelException
- if the process model does not
existInvalidFolderException
- if the folder does not existPrivilegeException
- if the user does not have permissions to move
the given process model to the given foldercom.appiancorp.asl3.servicefw.connect.ServiceException
- if any system-level error occursvoid moveFolder(java.lang.Long folderId_, java.lang.Long parentFolderId_) throws InvalidFolderException, PrivilegeException, RecursiveRelationshipException
folderId_
- the unique id of the process model folder to moveparentFolderId_
- the unique id of the new parent folderInvalidFolderException
- if the folder or the new parent folder does
not existPrivilegeException
- if the user does not have permissions to perform
this actionRecursiveRelationshipException
- if the move would result in a loop
in the tree of parent folderscom.appiancorp.asl3.servicefw.connect.ServiceException
- if any system-level error occursProcessModelFolderPermissions getPermissionsForFolder(java.lang.Long folderId_) throws InvalidFolderException, PrivilegeException
ProcessModelFolderPermissions
for a
ProcessModelFolder
folderId_
- ID of ProcessModelFolder
for which to get
ProcessModelFolderPermissions
ProcessModelFolderPermissions
object which contains
permissions for the folder.InvalidFolderException
- if the ProcessModelFolder
does not existPrivilegeException
- if the current user does not have
sufficient permissions to view the
ProcessModelFolderPermissions
for the foldercom.appiancorp.asl3.servicefw.connect.ServiceException
- if any system-level error occursProcessModelFolderPermissions[] getPermissionsForFolders(java.lang.Long[] folderIds_) throws InvalidFolderException, PrivilegeException
ProcessModelFolderPermissions
objects for multiple
ProcessModelFolder
objects.folderIds_
- Unique IDs of ProcessModelFolder
objects for
which to get permissionsProcessModelFolderPermissions
objects
which contain the permissions for the folders.InvalidFolderException
- if any of the
ProcessModelFolder
objects do not existPrivilegeException
- if the current User
does not have
sufficient permissions to view the
ProcessModelFolderPermissions
for any of the foldersvoid setInheritanceForFolder(java.lang.Long folderId_, boolean inherits_) throws PrivilegeException, InvalidFolderException
folderId_
- the unique id of the folderinherits_
- if the folder inherits permissions from its parentPrivilegeException
- if the user does not have permission to
perform this actionInvalidFolderException
- if the folder does not existcom.appiancorp.asl3.servicefw.connect.ServiceException
- if any system-level error occursvoid deleteProcessModelVersion(java.lang.Long processModelId_, java.lang.String version_) throws InvalidProcessModelException, InvalidVersionException, PrivilegeException
ProcessModel
.processModelId_
- ID of the ProcessModel
version_
- ID of the version to delete. If null
, the
process model will be deleted.InvalidProcessModelException
- if the ProcessModel
does
not exist.InvalidVersionException
- if the version does not exist for the
ProcessModel
.PrivilegeException
- if the current user does not have
sufficient permissions to delete the ProcessModel
version.com.appiancorp.asl3.servicefw.connect.ServiceException
- if any system-level error occursBusinessEntity getBusinessEntity()
BusinessEntity
which has been created on the system.BusinessEntity
in the system. Returns
null
if no BusinessEntity
has been created.void createBusinessEntity(BusinessEntity business_) throws java.lang.IllegalArgumentException
BusinessEntity
for use with Web Services.business_
- The BusinessEntity
to create. Minimum
required fields are: uuid
, organizationName
,
and contactInformation
.
All fields in the contactInformation
bean are required
(non-null and non-empty Strings
).java.lang.IllegalArgumentException
- if any of the required fields or any
of the fields in the contactInformation
bean is null or
empty.com.appiancorp.asl3.servicefw.connect.ServiceException
- if a system-level error occurs.void updateBusinessEntity(BusinessEntity business_) throws java.lang.NullPointerException
BusinessEntity
.business_
- a BusinessEntity
object. Minimum
required fields are: uuid
, organizationName
,
and contactInformation
.java.lang.NullPointerException
- if,
null
or empty.contactInformation
field of the argument is a list
and any entry of this list is null
or empty.null
com.appiancorp.asl3.servicefw.connect.ServiceException
- if a system-level error occurs.ResultPage getProcessModelWebServices(int startIndex_, int batchSize_, java.lang.Integer sortProperty_, java.lang.Integer sortOrder_)
ProcessModelWebService
objects on the server.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 Constants.COUNT_ALL
to return the entire collection, 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
ProcessModelWebService
sortOrder_
- the order in which to sort the results.
This is one of
Constants.SORT_ORDER_ASCENDING
or Constants.SORT_ORDER_DESCENDING
ResultPage
which contains an array of
ProcessModelWebService
objects.com.appiancorp.asl3.servicefw.connect.ServiceException
- if any system-level error occursvoid createProcessModelWebService(ProcessModelWebService pmws_) throws DuplicateWebServiceNameException, InvalidProcessModelException, java.lang.Exception
ProcessModelWebService
.pmws_
- The ProcessModelWebService
to create. Minimum
required fields are: serviceName
, serviceUuid
,
and processModelId
.DuplicateWebServiceNameException
- if a
ProcessModelWebService
with the serviceName
already exists.InvalidProcessModelException
- if the ProcessModel
specified by processModelId
does not exist.java.lang.Exception
- if the ProcessModelWebService
does not
contain a serviceName
or serviceUuid
ServiceExeption
- if any system-level error occursvoid deleteProcessModelWebService(java.lang.String serviceName_)
ProcessModelWebService
based on the service name which it
contains.serviceName_
- The name of the service to delete. The
ProcessModelWebService
itself will be deleted.com.appiancorp.asl3.servicefw.connect.ServiceException
- if any system-level error occursProcessStartingInfo getProcessStartingInfo(java.lang.String serviceName_)
ProcessStartingInfo
for a service.serviceName_
- The service for which to retrieve the
ProcessStartingInfo
ProcessStartingInfo
object which contains the
information necessary to start a service.com.appiancorp.asl3.servicefw.connect.ServiceException
- if any system-level error occursProcessModel getProcessModelByUuid(@ConvertWith(value=com.appiancorp.kougar.mapper.parameters.UuidParameterConverter.class) java.lang.String uuid_) throws InvalidProcessModelException, PrivilegeException
ProcessModel
specified by a UUID
(Universal Unique Identifier).uuid_
- UUID which specifies the ProcessModel
to
retrieve.ProcessModel
specified by uuid_
InvalidProcessModelException
- if the ProcessModel
does not existPrivilegeException
- if the user is not allowed to access the model.com.appiancorp.asl3.servicefw.connect.ServiceException
- if any system-level error occursjava.lang.Long getProcessModelIdByUuid(@ConvertWith(value=com.appiancorp.kougar.mapper.parameters.UuidParameterConverter.class) java.lang.String uuid_) throws InvalidProcessModelException, PrivilegeException
ProcessModel
by a UUID (Universal
Unique Identifier).uuid_
- UUID of ProcessModel
whose ID will be retrievedProcessModel
specified by
uuid_
, or null
if no process model exists with
that UUIDInvalidProcessModelException
- if no process exists for the UUID providedPrivilegeException
- if the user is not allowed to access the model.com.appiancorp.asl3.servicefw.connect.ServiceException
- if any system-level error occursProcessModel[] getProcessModelsAndDescendants(java.lang.Long[] ids_) throws InvalidProcessModelException
ProcessModel
objects as well as the sub
ProcessModel
objects which they contain. All process
models returned represent the working drafts of the process models in
question.ids_
- Uniques IDs of the ProcessModel
which will be
retrieved. Their sub process models will be retrieved as
well.ProcessModel
objects specified by
ids_
, along with their sub process modelsInvalidProcessModelException
- if a specified
ProcessModel
does not existcom.appiancorp.asl3.servicefw.connect.ServiceException
- if any system-level error occursResultPage getProcessModelsForFolderStartableOnly(java.lang.Long folderId_, int startIndex_, int batchSize_, java.lang.Integer sortProperty_, java.lang.Integer sortOrder_) throws InvalidFolderException, PrivilegeException
ProcessModel
is startable if it has a valid version or draft.folderId_
- id of the folder to get all process models forstartIndex_
- 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 Constants.COUNT_ALL
to return the entire collection, but this is STRONGLY discouraged.sortProperty_
- the property by which the results will be sorted.
This is one of the SORT_BY_XXX
constants located in
ProcessModel.Descriptor
sortOrder_
- the order in which to sort the results.
This is one of
Constants.SORT_ORDER_ASCENDING
or Constants.SORT_ORDER_DESCENDING
ResultPage
of
ProcessModel.Descriptor
objects which represent the
startable ProcessModel
objects in the
ProcessModelFolder
specified by folderId_
InvalidFolderException
- if the ProcessModelFolder
does
not existPrivilegeException
- if the current user does not have
permission to access the folderjava.lang.String[] validateProcessModel(AbstractProcessModel apm_)
pm_
- a ProcessModel
object representing the process
model to be validated
The error strings contain the error name followed
by "@"-separated field names in the ProcessModel
bean to
specify the location, followed by
"@" and the reasons for the error
Possible error names include "Invalid Expression" and "Invalid Subprocess".
This name (prefix) is omitted from fatal invalidities.
com.appiancorp.asl3.servicefw.connect.ServiceException
- if a system-level error occurs.java.lang.String[] validateProcessModelVersion(java.lang.Long processModelId_, java.lang.String version_) throws InvalidProcessModelException, InvalidVersionException, PrivilegeException
processModelId_
- ID of the ProcessModel
whose version
will be validatedversion_
- The version of the ProcessModel
to retrieve
The error strings contain the error name followed
by "@"-separated field names in the ProcessModel
bean to
specify the location, followed by
"@" and the reasons for the error
Possible error names include "Invalid Expression" and "Invalid Subprocess".
This name (prefix) is omitted from fatal invalidities.
com.appiancorp.asl3.servicefw.connect.ServiceException
- if a system-level error occurs.InvalidProcessModelException
InvalidVersionException
PrivilegeException
boolean isProcessModelLocked(java.lang.Long processModelId_) throws InvalidProcessModelException, PrivilegeException
processModelId_
- the ID of the process modeltrue
, if the process model with the given ID is
locked; false
otherwise.InvalidProcessModelException
- if the ID does not correspond to a
valid process modelPrivilegeException
- if the current user cannot view the process
model (if ProcessModelPermissions.isView()
would return
false
for this process model)ProcessModel getProcessModelLatestPublishedVersion(java.lang.Long processModelId_) throws PrivilegeException, InvalidProcessModelException
ProcessModel
or the
working draft if a published version does not exist.processModelId_
- ID of the ProcessModel
to retrieveProcessModel
specified by
processModelId_
PrivilegeException
- if the current User
does not have
sufficient privileges to view the ProcessModel
InvalidProcessModelException
- if a ProcessModel
specified by processModelId_
does not existcom.appiancorp.asl3.servicefw.connect.ServiceException
- if any system-level error occursProcessModel.Descriptor getProcessModelLatestPublishedVersionDescriptor(java.lang.Long processModelId_) throws PrivilegeException, InvalidProcessModelException
ProcessModel.Descriptor
or the working draft if a published version does not exist.processModelId_
- ID of the Descriptor
to retrieveDescriptor
specified by
processModelId_
PrivilegeException
- if the current User
does not have
sufficient privileges to view the ProcessModel
InvalidProcessModelException
- if a ProcessModel
specified by processModelId_
does not existcom.appiancorp.asl3.servicefw.connect.ServiceException
- if any system-level error occursResultList getACInstanceIdsForLocalIds(java.lang.String[] localIds_)
ResultList
containing the actual Id's in database
corresponding to given localId's of ActivityClass
localIds_
- localId's of ActivityClass
objectsResultList
containing Long Id's of
ActivityClass
in databaseResultList getACPInstanceIdsForLocalIds(java.lang.Long activityClassLocalId_, java.lang.String[] localIds_)
ResultList
containing the actual Id's in database
for ActivityClassParameter
corresponding to given a
ActivityClass
localId and ActivityClassParameter
localId's. If the localIds array is empty,
InvalidActivityClassSchemaException might be thrown.activityClassLocalId_
- Id of ActivityClass>
whose
ActivityClassParameter
Id's are requestedlocalIds_
- localId's of ActivityClassParameter
objectsResultList
containing Long
Id's of
given ActivityClassParameter
objects in database@Deprecated void notifyUserCreation(java.lang.String username_) throws java.lang.NullPointerException
username_
- the name of the user that was addedjava.lang.NullPointerException
- if username_
is null
void notifyUsersCreation(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
boolean validateGroupMembership(java.lang.Long[] memGroupIds_, java.lang.Long[] admGroupIds_, java.lang.Long userTypeId_, java.lang.String username) throws InvalidAnonymousUserException, InvalidUserException
memGroupIds_
- Groups for which the User is a memberadmGroupIds_
- Groups for which the User is an administratoruserTypeId_
- this is one of
UserProfile.USER_TYPE_BASIC
or UserProfile.USER_TYPE_SYS_ADMIN
username
- the username of the user whose group membership is to be validatedInvalidAnonymousUserException
- if the user calling this method is
anonymous, but anonymous access has not been enabledInvalidUserException
- if the user calling this method does not existjava.lang.NullPointerException
- if any of the input arrays are null
com.appiancorp.asl3.servicefw.connect.ServiceException
- if any system-level error occurs@Deprecated void updateUsernames(java.lang.String[] oldUsernames_, java.lang.String[] newUsernames_, long maxExpirationTimeInSeconds_) throws java.lang.IllegalArgumentException, DuplicateNameException
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 existscom.appiancorp.asl3.servicefw.connect.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.
com.appiancorp.asl3.servicefw.connect.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.
com.appiancorp.asl3.servicefw.connect.ServiceException
- if any system-level error occursvoid 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 actioncom.appiancorp.asl3.servicefw.connect.ServiceException
- if any system-level error occurs@Deprecated void reloadProperties()
com.appiancorp.asl3.servicefw.connect.ServiceException
- if any system-level error occursjava.lang.String validate()
com.appiancorp.asl3.servicefw.connect.ServiceException
- if any system-level error occursvoid setSiteLocaleSettings(SiteLocaleSettings settings_)
GlobalizationService.setSiteLocaleSettings(SiteLocaleSettings)
if you
need to update the site locale settings for all the product Servers.settings_
- The site locale settings.ResultPage getEventsForProcessModelPaging(java.lang.Long pmId_, java.lang.Long[] eventTypes_, java.lang.Boolean includeStartEvents_, int startIndex_, int batchSize_, java.lang.Integer sortProperty_, java.lang.Integer sortOrder_)
ProcessModel
specified by
eventTypes_
.pmId_
- ID of the ProcessModel
for which to retrieve
Event
objectseventTypes_
- types of events to retrieve. This is one of
XXX_EVENT_YYY
constants in Event
includeStartEvents_
- whether start events should be includedstartIndex_
- 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 Constants.COUNT_ALL
to return the entire collection, but this is STRONGLY discouraged.sortProperty_
- the property by which the results will be sorted.
This is one of the SORT_BY_XXX
constants located in
Event
sortOrder_
- the order in which to sort the results.
This is one of
Constants.SORT_ORDER_ASCENDING
or Constants.SORT_ORDER_DESCENDING
ResultPage
which contains an array of Eventscom.appiancorp.asl3.servicefw.connect.ServiceException
- if any system-level error occursResultPage findEventsPaging(java.lang.String searchString_, java.lang.Long pmId_, java.lang.Long[] eventTypes_, java.lang.Boolean includeStartEvents_, int startIndex_, int batchSize_, java.lang.Integer sortProperty_, java.lang.Integer sortOrder_)
searchString_
- search string to search the Events' names.pmId_
- ID of the ProcessModel
for which to retrieve
Event
objects. If the ID is null, then events for all process
models are searched.eventTypes_
- types of events to retrieve. This is one of
XXX_EVENT_YYY
constants in Event
includeStartEvents_
- Whether or not events on start node should be returnedincludeConsuming_
- whether or not consuming events should be returnedincludeProducing_
- whether or not producing events should be returnedstartIndex_
- 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 Constants.COUNT_ALL
to return the entire collection, but this is STRONGLY discouraged.sortProperty_
- the property by which the results will be sorted.
This is one of the SORT_BY_XXX
constants located in
Event
sortOrder_
- the order in which to sort the results.
This is one of
Constants.SORT_ORDER_ASCENDING
or Constants.SORT_ORDER_DESCENDING
ResultPage
which contains an array of Event
objects
that match the search criteriacom.appiancorp.asl3.servicefw.connect.ServiceException
- if any system-level error occursjava.lang.String[] getEventOrProcessModelNames(java.lang.Long[] pmIds_, java.lang.String[] eventPersistentIds_)
ProcessModel
Ids and Event IdspmIds_
- Ids of Process Models to get the display name ofeventPersistentIds_
- Persistent Ids of Events (EventTrigger)to get the
display name forpmIds_
count and later part
of array is Events depending on the eventIds_
count.java.lang.NullPointerException
- if pmIds_
array or
eventIds_
array is null.java.lang.Long[] getProcessModelIdsByUuids(@ConvertWith(value=com.appiancorp.kougar.mapper.parameters.UuidParameterConverter[].class[]) java.lang.String[] pmUUIDs_) throws PrivilegeException
pmUUIDs_
- Array of UUID Strings.null
is returned for invalid UUID.PrivilegeException
java.lang.Long getEmailAttachmentFolderIdForPm(java.lang.Long pm_) throws InvalidProcessModelException
ProcessModel
or any event within
the ProcessModel
pm_
- ID of process modelInvalidProcessModelException
- if the specified ProcessModel
does not existcom.appiancorp.asl3.servicefw.connect.ServiceException
- if any system-level error occursjava.lang.Long getPmIdForEvent(java.lang.String eventPersistentId_) throws InvalidEventException
ProcessModel
that the Event by given
eventPersistentId
belongs to.eventPersistentId_
- Persistent ID of the EventInvalidEventException
- If passed in event persistent ID is invalidcom.appiancorp.asl3.servicefw.connect.ServiceException
- if any system-level error occursResultList getEventsByPersistentId(java.lang.String[] eventPersistentIds_)
eventPersistentIds_
- Array of Event persistent IDs.Event
objects corresponding to the
array of given persistent IDs. The result codes can be:
ResultList.CODE_VALID
if the action succeeded, or
ResultList.CODE_INVALID
if the event persistent ID is invalid.com.appiancorp.asl3.servicefw.connect.ServiceException
- if any system-level error occursvoid setDashboardPageForProcessModel(java.lang.Long processModelId, java.lang.Long pageId) throws InvalidProcessModelException, PrivilegeException
ProcessModel
by
processModelId
.processModelId
- Id of the ProcessModel
to associate the page withpageId
- the id of the page to set as the Process Model's Dashboard pageInvalidProcessModelException
- if the ProcessModel
specified
does not existPrivilegeException
- if the current user does not have permission to
associate the Dashboard page for the ProcessModel
java.lang.Long getDashboardPageForProcessModel(java.lang.Long processModelId_) throws InvalidProcessModelException
ProcessModel
by given processModelId_
processModelId_
- Id of the process modelInvalidProcessModelException
- if the ProcessModel
specified
does not existvoid removeDashboardPageForProcessModel(java.lang.Long processModelId) throws InvalidProcessModelException, PrivilegeException
ProcessModel
by processModelId
.processModelId
- Id of the ProcessModel
for which
to remove its current Dashboard pageInvalidProcessModelException
- if the ProcesModel
specified
does not existPrivilegeException
- if the current user does not have permission to
disassociate the Dashboard page from the ProcessModel
void addProcessModelToFavorites(java.lang.Long modelId_) throws InvalidProcessModelException, PrivilegeException
ProcessModel
by given modelId_
as one of the current user's favorites.modelId_
- Id of the ProcessModel
to be added as favorite.InvalidProcessModelException
- if the ProcessModel
specified does not existPrivilegeException
- if the current user does not have permission to
perform this action on the specified ProcessModel
java.lang.NullPointerException
- if modelId_
is nullcom.appiancorp.asl3.servicefw.connect.ServiceException
- if any system-level error occursvoid removeProcessModelFromFavorites(java.lang.Long modelId_) throws InvalidProcessModelException, PrivilegeException
ProcessModel
by given modelId_
as
one of the current user's favorites.modelId_
- Id of the ProcessModel
to be removed as favorite.InvalidProcessModelException
- if the ProcessModel
specified does not existPrivilegeException
- if the current user does not have permission to
perform this action on the specified ProcessModel
java.lang.NullPointerException
- if modelId_
is nullcom.appiancorp.asl3.servicefw.connect.ServiceException
- if any system-level error occursint[] handleMessages(InternalMessage[] messages_)
Message.SUCCESS_CODE
if the messages are handled successfully
Message.JMS_TYPE_NOT_PROVIDED_CODE
if the message does not provide
a valid JMS type
Message.INVALID_USERNAME_CODE
if the provided username is not valid.
If a username is not provided, the result code will return as Message.SUCCESS_CODE
because username may be anonymous.
Message.DESTINATION_NOT_PROVIDED_CODE
if the message does not specify
a valid destination
Message.DUPLICATE_MESSAGE_CODE
if the message is a duplicatemessages_
- an array of InternalMessage objects to be processed by the Events
frameworkcom.appiancorp.asl3.servicefw.connect.ServiceException
- if any system-level error occursjava.lang.NullPointerException
- if any of the messages in the messages_
array are null or if the array itself is nulljava.lang.Boolean[] validateUsernames(java.lang.String[] usernames_)
usernames_
- An array of usernames to validateProcessVariable[] getProcessVariablesForModel(java.lang.Long pmId_, boolean recursive_)
pmId_
- Id of the ProcessModel
to retrieve the process variables ofrecursive_
- true if you want to retrieve process variables from the child
process models (and their child models in turn).ProcessVariable
objects.java.lang.NullPointerException
- if pmId_
is null.ProcessVariable[] getProcessVariablesForModel(@ConvertWith(value=com.appiancorp.kougar.mapper.parameters.UuidParameterConverter.class) java.lang.String uuid, boolean recursive) throws InvalidProcessModelException
uuid_
- UUID which specifies the ProcessModel
to
retrieve the process variables of, as if by getProcessModelIdByUuidrecursive_
- true if you want to retrieve process variables from the child
process models (and their child models in turn).ProcessVariable
objects.java.lang.NullPointerException
- if pmId_
is null.InvalidProcessModelException
@Deprecated java.lang.String[] getCurrentNotePaths()
@Deprecated void setCurrentNotePaths(java.lang.String[] notePaths_) throws PrivilegeException
PrivilegeException
ExpressionDependency getExpressionDependencies(java.lang.String expressionText, java.lang.String... parameterNames)
expressionText
.
See ExpressionDependency
expressionText
- Expression for which the dependencies will be determinedparameterNames
- Parameters of the expression. Only apply when the expression is part
of a rule definition; pass null
if it's not a rule definition.ExpressionDependency
for the given expressionExpressionDependency[] getExpressionDependencies(java.lang.String[] expression, java.lang.String[] parameterNames)
ExpressionDependency
objects for the given expressions.expression
- Array of expressions for which the dependencies are to be determined.parameterNames
- Parameters of the expressions. Only apply when the expressions are
part of a rule definition; pass null
if it's not a rule definition.ExpressionDependency
objects for the given expressions.PartialResult evaluateExpressionInVariableContext(java.lang.String expression, NamedTypedValue[] typedVariables, NamedTypedValue[] continueParams)
TypedValue evaluateExpression(java.lang.String expression) throws com.appiancorp.process.expression.ExpressionEvaluationException
expression
- The expression to evaluate.com.appiancorp.process.expression.ExpressionEvaluationException
- If an error occurs during the
evaluation of the expression.java.lang.String externalizeExpression(java.lang.String expression, java.lang.String... parameterNames)
expression
- expression with rule namesparameterNames
- parameter names in expressions. Used to resolve conflicts
between unqualified variables, like unqualified rule inputs in rule
definitions, and other rule namesjava.lang.String internalizeExpression(java.lang.String expression)
expression
- expression with UUIDsjava.lang.Long[] getRuleIdReferences(java.lang.Long pmId) throws PrivilegeException, InvalidProcessModelException
pmId
id contain, including nested rules referenced by all the
expressions.pmId
- process model idInvalidProcessModelException
- if the ProcessModel
specified by pmId
does not existPrivilegeException
- if the current User
does not have
sufficient privileges to view the ProcessModel
java.lang.String[] getRuleUuidReferences(ProcessModel pm)
pm
) contain.pm
- process model beanTypedValue evaluateExpression(java.lang.String expression, NamedTypedValue[] variableValues) throws com.appiancorp.process.expression.ExpressionEvaluationException
expression
- The expression to evaluate.variableValues
- Values for all the variables used in the given
expression. The name, instance type, and value of each variable value
must be set. For example, if the expression is: ="Hello "&!firstName
The variableValues array should hold a single NamedTypedValue object
with the name "firstName", instance type AppianTypeLong.STRING and a
value such as "John".com.appiancorp.process.expression.ExpressionEvaluationException
- If an error occurrs during the
evaluation of the expression.void setProcessDashboardPageForProcessModel(java.lang.Long processModelId_, java.lang.Long pageId_) throws InvalidProcessModelException, PrivilegeException
ProcessModel
by processModelId
.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.InvalidProcessModelException
- if the ProcessModel
specified
does not existPrivilegeException
- if the current user does not have permission to
associate the Dashboard page for the ProcessModel
java.lang.Long getProcessDashboardPageForProcessModel(java.lang.Long processModelId_) throws InvalidProcessModelException
ProcessModel
by given processModelId_
processModelId_
- Id of the process modelInvalidProcessModelException
- if the ProcessModel
specified
does not existvoid removeProcessDashboardPageForProcessModel(java.lang.Long processModelId_) throws InvalidProcessModelException, PrivilegeException
processModelId_
- The ID of the process modelInvalidProcessModelException
- if the ProcessModel
specified
does not existPrivilegeException
- if the current user does not have permission to
associate the Dashboard page for the ProcessModel
ResultPage getLingeringTasksForProcessModel(java.lang.Long processModelId_, boolean recursive_, int startIndex_, int batchSize_, java.lang.Integer sortProperty_, java.lang.Integer sortOrder_) throws InvalidProcessException, PrivilegeException
processModelId_
- the id of the process model for which the lingering tasks
should be retrievedrecursive
- whether to return the lingering tasks of the sub-process
models of the given process model 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
TaskDesignProperties
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 invalidPrivilegeException
- if the user doesn't have privileges to see the modelboolean validateTypedValues(TypedValue[] typedValues)
typedValues
- void setTimeZone(BackendTimeZoneSimple tz)
tz
- void setTimeZoneSameAs(BackendTimeZoneSimple tz, java.lang.String sameAsId)
tz
- sameAsId
- Copyright © 2003-2024 Appian Corporation. All Rights Reserved.