All URIs are relative to http://localhost:8080/engine-rest
Method | HTTP request | Description |
---|---|---|
delete_async_historic_query_based | post /process-instance/delete-historic-query-based | |
delete_process_instance | delete /process-instance/{id} | |
delete_process_instance_variable | delete /process-instance/{id}/variables/{varName} | |
delete_process_instances_async_operation | post /process-instance/delete | |
get_activity_instance_tree | get /process-instance/{id}/activity-instances | |
get_process_instance_variable | get /process-instance/{id}/variables/{varName} | |
get_process_instance_variable_binary | get /process-instance/{id}/variables/{varName}/data | |
get_process_instance_variables | get /process-instance/{id}/variables | |
get_process_instances | get /process-instance | |
get_process_instances_count | get /process-instance/count | |
modify_process_instance | post /process-instance/{id}/modification | |
modify_process_instance_async_operation | post /process-instance/{id}/modification-async | |
modify_process_instance_variables | post /process-instance/{id}/variables | |
query_process_instances | post /process-instance | |
query_process_instances_count | post /process-instance/count | |
set_process_instance_variable | put /process-instance/{id}/variables/{varName} | |
set_process_instance_variable_binary | post /process-instance/{id}/variables/{varName}/data | |
set_retries_by_process | post /process-instance/job-retries | |
set_retries_by_process_historic_query_based | post /process-instance/job-retries-historic-query-based | |
update_suspension_state | put /process-instance/suspended | |
update_suspension_state_async_operation | post /process-instance/suspended-async | |
update_suspension_state_by_id | put /process-instance/{id}/suspended |
crate::models::BatchDto delete_async_historic_query_based(delete_process_instances_dto)
Deletes a set of process instances asynchronously (batch) based on a historic process instance query.
Name | Type | Description | Required | Notes |
---|---|---|---|---|
delete_process_instances_dto | Option<DeleteProcessInstancesDto> | Unallowed property: processInstanceQuery |
No authorization required
- Content-Type: application/json
- Accept: application/json
[Back to top] [Back to API list] [Back to Model list] [Back to README]
delete_process_instance(id, skip_custom_listeners, skip_io_mappings, skip_subprocesses, fail_if_not_exists)
Deletes a running process instance by id.
Name | Type | Description | Required | Notes |
---|---|---|---|---|
id | String | The id of the process instance to be deleted. | [required] | |
skip_custom_listeners | Option<bool> | If set to true, the custom listeners will be skipped. | [default to false] | |
skip_io_mappings | Option<bool> | If set to true, the input/output mappings will be skipped. | [default to false] | |
skip_subprocesses | Option<bool> | If set to true, subprocesses related to deleted processes will be skipped. | [default to false] | |
fail_if_not_exists | Option<bool> | If set to false, the request will still be successful if the process id is not found. | [default to true] |
(empty response body)
No authorization required
- Content-Type: Not defined
- Accept: application/json
[Back to top] [Back to API list] [Back to Model list] [Back to README]
delete_process_instance_variable(id, var_name)
Deletes a variable of a process instance by id.
Name | Type | Description | Required | Notes |
---|---|---|---|---|
id | String | The id of the process instance to delete the variable from. | [required] | |
var_name | String | The name of the variable to delete. | [required] |
(empty response body)
No authorization required
- Content-Type: Not defined
- Accept: Not defined
[Back to top] [Back to API list] [Back to Model list] [Back to README]
crate::models::BatchDto delete_process_instances_async_operation(delete_process_instances_dto)
Deletes multiple process instances asynchronously (batch).
Name | Type | Description | Required | Notes |
---|---|---|---|---|
delete_process_instances_dto | Option<DeleteProcessInstancesDto> | Unallowed property: historicProcessInstanceQuery |
No authorization required
- Content-Type: application/json
- Accept: application/json
[Back to top] [Back to API list] [Back to Model list] [Back to README]
crate::models::ActivityInstanceDto get_activity_instance_tree(id)
Retrieves an Activity Instance (Tree) for a given process instance by id.
Name | Type | Description | Required | Notes |
---|---|---|---|---|
id | String | The id of the process instance for which the activity instance should be retrieved. | [required] |
crate::models::ActivityInstanceDto
No authorization required
- Content-Type: Not defined
- Accept: application/json
[Back to top] [Back to API list] [Back to Model list] [Back to README]
crate::models::VariableValueDto get_process_instance_variable(id, var_name, deserialize_value)
Retrieves a variable of a given process instance by id.
Name | Type | Description | Required | Notes |
---|---|---|---|---|
id | String | The id of the process instance to retrieve the variable for. | [required] | |
var_name | String | The name of the variable to retrieve. | [required] | |
deserialize_value | Option<bool> | Determines whether serializable variable values (typically variables that store custom Java objects) should be deserialized on server side (default true). If set to true, a serializable variable will be deserialized on server side and transformed to JSON using Jackson's POJO/bean property introspection feature. Note that this requires the Java classes of the variable value to be on the REST API's classpath. If set to false, a serializable variable will be returned in its serialized format. For example, a variable that is serialized as XML will be returned as a JSON string containing XML. Note: While true is the default value for reasons of backward compatibility, we recommend setting this parameter to false when developing web applications that are independent of the Java process applications deployed to the engine. | [default to true] |
crate::models::VariableValueDto
No authorization required
- Content-Type: Not defined
- Accept: application/json
[Back to top] [Back to API list] [Back to Model list] [Back to README]
std::path::PathBuf get_process_instance_variable_binary(id, var_name)
Retrieves the content of a Process Variable by the Process Instance id and the Process Variable name. Applicable for byte array or file Process Variables.
Name | Type | Description | Required | Notes |
---|---|---|---|---|
id | String | The id of the process instance to retrieve the variable for. | [required] | |
var_name | String | The name of the variable to retrieve. | [required] |
std::path::PathBuf
No authorization required
- Content-Type: Not defined
- Accept: application/octet-stream, text/plain, application/json
[Back to top] [Back to API list] [Back to Model list] [Back to README]
::std::collections::HashMap<String, crate::models::VariableValueDto> get_process_instance_variables(id, deserialize_value)
Retrieves all variables of a given process instance by id.
Name | Type | Description | Required | Notes |
---|---|---|---|---|
id | String | The id of the process instance to retrieve the variables from. | [required] | |
deserialize_value | Option<bool> | Determines whether serializable variable values (typically variables that store custom Java objects) should be deserialized on server side (default true). If set to true, a serializable variable will be deserialized on server side and transformed to JSON using Jackson's POJO/bean property introspection feature. Note that this requires the Java classes of the variable value to be on the REST API's classpath. If set to false, a serializable variable will be returned in its serialized format. For example, a variable that is serialized as XML will be returned as a JSON string containing XML. Note: While true is the default value for reasons of backward compatibility, we recommend setting this parameter to false when developing web applications that are independent of the Java process applications deployed to the engine. | [default to true] |
::std::collections::HashMap<String, crate::models::VariableValueDto>
No authorization required
- Content-Type: Not defined
- Accept: application/json
[Back to top] [Back to API list] [Back to Model list] [Back to README]
Veccrate::models::ProcessInstanceDto get_process_instances(sort_by, sort_order, first_result, max_results, process_instance_ids, business_key, business_key_like, case_instance_id, process_definition_id, process_definition_key, process_definition_key_in, process_definition_key_not_in, deployment_id, super_process_instance, sub_process_instance, super_case_instance, sub_case_instance, active, suspended, with_incident, incident_id, incident_type, incident_message, incident_message_like, tenant_id_in, without_tenant_id, process_definition_without_tenant_id, activity_id_in, root_process_instances, leaf_process_instances, variables, variable_names_ignore_case, variable_values_ignore_case)
Queries for process instances that fulfill given parameters. Parameters may be static as well as dynamic runtime properties of process instances. The size of the result set can be retrieved by using the Get Instance Count method.
Name | Type | Description | Required | Notes |
---|---|---|---|---|
sort_by | Option<String> | Sort the results lexicographically by a given criterion. Must be used in conjunction with the sortOrder parameter. | ||
sort_order | Option<String> | Sort the results in a given order. Values may be asc for ascending order or desc for descending order. Must be used in conjunction with the sortBy parameter. | ||
first_result | Option<i32> | Pagination of results. Specifies the index of the first result to return. | ||
max_results | Option<i32> | Pagination of results. Specifies the maximum number of results to return. Will return less results if there are no more results left. | ||
process_instance_ids | Option<String> | Filter by a comma-separated list of process instance ids. | ||
business_key | Option<String> | Filter by process instance business key. | ||
business_key_like | Option<String> | Filter by process instance business key that the parameter is a substring of. | ||
case_instance_id | Option<String> | Filter by case instance id. | ||
process_definition_id | Option<String> | Filter by the deployment the id belongs to. | ||
process_definition_key | Option<String> | Filter by the key of the process definition the instances run on. | ||
process_definition_key_in | Option<String> | Filter by a comma-separated list of process definition keys. A process instance must have one of the given process definition keys. | ||
process_definition_key_not_in | Option<String> | Exclude instances by a comma-separated list of process definition keys. A process instance must not have one of the given process definition keys. | ||
deployment_id | Option<String> | Filter by the deployment the id belongs to. | ||
super_process_instance | Option<String> | Restrict query to all process instances that are sub process instances of the given process instance. Takes a process instance id. | ||
sub_process_instance | Option<String> | Restrict query to all process instances that have the given process instance as a sub process instance. Takes a process instance id. | ||
super_case_instance | Option<String> | Restrict query to all process instances that are sub process instances of the given case instance. Takes a case instance id. | ||
sub_case_instance | Option<String> | Restrict query to all process instances that have the given case instance as a sub case instance. Takes a case instance id. | ||
active | Option<bool> | Only include active process instances. Value may only be true, as false is the default behavior. | [default to false] | |
suspended | Option<bool> | Only include suspended process instances. Value may only be true, as false is the default behavior. | [default to false] | |
with_incident | Option<bool> | Filter by presence of incidents. Selects only process instances that have an incident. | [default to false] | |
incident_id | Option<String> | Filter by the incident id. | ||
incident_type | Option<String> | Filter by the incident type. See the User Guide for a list of incident types. | ||
incident_message | Option<String> | Filter by the incident message. Exact match. | ||
incident_message_like | Option<String> | Filter by the incident message that the parameter is a substring of. | ||
tenant_id_in | Option<String> | Filter by a comma-separated list of tenant ids. A process instance must have one of the given tenant ids. | ||
without_tenant_id | Option<bool> | Only include process instances which belong to no tenant. | [default to false] | |
process_definition_without_tenant_id | Option<bool> | Only include process instances which process definition has no tenant id. | [default to false] | |
activity_id_in | Option<String> | Filter by a comma-separated list of activity ids. A process instance must currently wait in a leaf activity with one of the given activity ids. | ||
root_process_instances | Option<bool> | Restrict the query to all process instances that are top level process instances. | [default to false] | |
leaf_process_instances | Option<bool> | Restrict the query to all process instances that are leaf instances. (i.e. don't have any sub instances). | [default to false] | |
variables | Option<String> | Only include process instances that have variables with certain values. Variable filtering expressions are comma-separated and are structured as follows: A valid parameter value has the form key_operator_value . key is the variable name, operator is the comparison operator to be used and value the variable value. Note: Values are always treated as String objects on server side. Valid operator values are: eq - equal to; neq - not equal to; gt - greater than; gteq - greater than or equal to; lt - lower than; lteq - lower than or equal to; like . key and value may not contain underscore or comma characters. |
||
variable_names_ignore_case | Option<bool> | Match all variable names in this query case-insensitively. If set to true variableName and variablename are treated as equal. | [default to false] | |
variable_values_ignore_case | Option<bool> | Match all variable values in this query case-insensitively. If set to true variableValue and variablevalue are treated as equal. | [default to false] |
Veccrate::models::ProcessInstanceDto
No authorization required
- Content-Type: Not defined
- Accept: application/json
[Back to top] [Back to API list] [Back to Model list] [Back to README]
crate::models::CountResultDto get_process_instances_count(process_instance_ids, business_key, business_key_like, case_instance_id, process_definition_id, process_definition_key, process_definition_key_in, process_definition_key_not_in, deployment_id, super_process_instance, sub_process_instance, super_case_instance, sub_case_instance, active, suspended, with_incident, incident_id, incident_type, incident_message, incident_message_like, tenant_id_in, without_tenant_id, process_definition_without_tenant_id, activity_id_in, root_process_instances, leaf_process_instances, variables, variable_names_ignore_case, variable_values_ignore_case)
Queries for the number of process instances that fulfill given parameters.
Name | Type | Description | Required | Notes |
---|---|---|---|---|
process_instance_ids | Option<String> | Filter by a comma-separated list of process instance ids. | ||
business_key | Option<String> | Filter by process instance business key. | ||
business_key_like | Option<String> | Filter by process instance business key that the parameter is a substring of. | ||
case_instance_id | Option<String> | Filter by case instance id. | ||
process_definition_id | Option<String> | Filter by the deployment the id belongs to. | ||
process_definition_key | Option<String> | Filter by the key of the process definition the instances run on. | ||
process_definition_key_in | Option<String> | Filter by a comma-separated list of process definition keys. A process instance must have one of the given process definition keys. | ||
process_definition_key_not_in | Option<String> | Exclude instances by a comma-separated list of process definition keys. A process instance must not have one of the given process definition keys. | ||
deployment_id | Option<String> | Filter by the deployment the id belongs to. | ||
super_process_instance | Option<String> | Restrict query to all process instances that are sub process instances of the given process instance. Takes a process instance id. | ||
sub_process_instance | Option<String> | Restrict query to all process instances that have the given process instance as a sub process instance. Takes a process instance id. | ||
super_case_instance | Option<String> | Restrict query to all process instances that are sub process instances of the given case instance. Takes a case instance id. | ||
sub_case_instance | Option<String> | Restrict query to all process instances that have the given case instance as a sub case instance. Takes a case instance id. | ||
active | Option<bool> | Only include active process instances. Value may only be true, as false is the default behavior. | [default to false] | |
suspended | Option<bool> | Only include suspended process instances. Value may only be true, as false is the default behavior. | [default to false] | |
with_incident | Option<bool> | Filter by presence of incidents. Selects only process instances that have an incident. | [default to false] | |
incident_id | Option<String> | Filter by the incident id. | ||
incident_type | Option<String> | Filter by the incident type. See the User Guide for a list of incident types. | ||
incident_message | Option<String> | Filter by the incident message. Exact match. | ||
incident_message_like | Option<String> | Filter by the incident message that the parameter is a substring of. | ||
tenant_id_in | Option<String> | Filter by a comma-separated list of tenant ids. A process instance must have one of the given tenant ids. | ||
without_tenant_id | Option<bool> | Only include process instances which belong to no tenant. | [default to false] | |
process_definition_without_tenant_id | Option<bool> | Only include process instances which process definition has no tenant id. | [default to false] | |
activity_id_in | Option<String> | Filter by a comma-separated list of activity ids. A process instance must currently wait in a leaf activity with one of the given activity ids. | ||
root_process_instances | Option<bool> | Restrict the query to all process instances that are top level process instances. | [default to false] | |
leaf_process_instances | Option<bool> | Restrict the query to all process instances that are leaf instances. (i.e. don't have any sub instances). | [default to false] | |
variables | Option<String> | Only include process instances that have variables with certain values. Variable filtering expressions are comma-separated and are structured as follows: A valid parameter value has the form key_operator_value . key is the variable name, operator is the comparison operator to be used and value the variable value. Note: Values are always treated as String objects on server side. Valid operator values are: eq - equal to; neq - not equal to; gt - greater than; gteq - greater than or equal to; lt - lower than; lteq - lower than or equal to; like . key and value may not contain underscore or comma characters. |
||
variable_names_ignore_case | Option<bool> | Match all variable names in this query case-insensitively. If set to true variableName and variablename are treated as equal. | [default to false] | |
variable_values_ignore_case | Option<bool> | Match all variable values in this query case-insensitively. If set to true variableValue and variablevalue are treated as equal. | [default to false] |
No authorization required
- Content-Type: Not defined
- Accept: application/json
[Back to top] [Back to API list] [Back to Model list] [Back to README]
modify_process_instance(id, process_instance_modification_dto)
Submits a list of modification instructions to change a process instance's execution state. A modification instruction is one of the following: * Starting execution before an activity * Starting execution after an activity on its single outgoing sequence flow * Starting execution on a specific sequence flow * Canceling an activity instance, transition instance, or all instances (activity or transition) for an activity Instructions are executed immediately and in the order they are provided in this request's body. Variables can be provided with every starting instruction. The exact semantics of modification can be read about in the User guide.
Name | Type | Description | Required | Notes |
---|---|---|---|---|
id | String | The id of the process instance to modify. | [required] | |
process_instance_modification_dto | Option<ProcessInstanceModificationDto> |
(empty response body)
No authorization required
- Content-Type: application/json
- Accept: application/json
[Back to top] [Back to API list] [Back to Model list] [Back to README]
crate::models::BatchDto modify_process_instance_async_operation(id, process_instance_modification_dto)
Submits a list of modification instructions to change a process instance's execution state async. A modification instruction is one of the following: * Starting execution before an activity * Starting execution after an activity on its single outgoing sequence flow * Starting execution on a specific sequence flow * Cancelling an activity instance, transition instance, or all instances (activity or transition) for an activity Instructions are executed asynchronous and in the order they are provided in this request's body. Variables can be provided with every starting instruction. The exact semantics of modification can be read about in the User guide.
Name | Type | Description | Required | Notes |
---|---|---|---|---|
id | String | The id of the process instance to modify. | [required] | |
process_instance_modification_dto | Option<ProcessInstanceModificationDto> |
No authorization required
- Content-Type: application/json
- Accept: application/json
[Back to top] [Back to API list] [Back to Model list] [Back to README]
modify_process_instance_variables(id, patch_variables_dto)
Updates or deletes the variables of a process instance by id. Updates precede deletions. So, if a variable is updated AND deleted, the deletion overrides the update.
Name | Type | Description | Required | Notes |
---|---|---|---|---|
id | String | The id of the process instance to set variables for. | [required] | |
patch_variables_dto | Option<PatchVariablesDto> |
(empty response body)
No authorization required
- Content-Type: application/json
- Accept: application/json
[Back to top] [Back to API list] [Back to Model list] [Back to README]
Veccrate::models::ProcessInstanceDto query_process_instances(first_result, max_results, process_instance_query_dto)
Queries for process instances that fulfill given parameters through a JSON object. This method is slightly more powerful than the Get Instances method because it allows filtering by multiple process variables of types string
, number
or boolean
.
Name | Type | Description | Required | Notes |
---|---|---|---|---|
first_result | Option<i32> | Pagination of results. Specifies the index of the first result to return. | ||
max_results | Option<i32> | Pagination of results. Specifies the maximum number of results to return. Will return less results if there are no more results left. | ||
process_instance_query_dto | Option<ProcessInstanceQueryDto> |
Veccrate::models::ProcessInstanceDto
No authorization required
- Content-Type: application/json
- Accept: application/json
[Back to top] [Back to API list] [Back to Model list] [Back to README]
crate::models::CountResultDto query_process_instances_count(process_instance_query_dto)
Queries for the number of process instances that fulfill the given parameters. This method takes the same message body as the Get Instances (POST) method and therefore it is slightly more powerful than the Get Instance Count method.
Name | Type | Description | Required | Notes |
---|---|---|---|---|
process_instance_query_dto | Option<ProcessInstanceQueryDto> |
No authorization required
- Content-Type: application/json
- Accept: application/json
[Back to top] [Back to API list] [Back to Model list] [Back to README]
set_process_instance_variable(id, var_name, variable_value_dto)
Sets a variable of a given process instance by id.
Name | Type | Description | Required | Notes |
---|---|---|---|---|
id | String | The id of the process instance to set the variable for. | [required] | |
var_name | String | The name of the variable to set. | [required] | |
variable_value_dto | Option<VariableValueDto> |
(empty response body)
No authorization required
- Content-Type: application/json
- Accept: application/json
[Back to top] [Back to API list] [Back to Model list] [Back to README]
set_process_instance_variable_binary(id, var_name, data, value_type)
Sets the serialized value for a binary variable or the binary value for a file variable.
Name | Type | Description | Required | Notes |
---|---|---|---|---|
id | String | The id of the process instance to retrieve the variable for. | [required] | |
var_name | String | The name of the variable to retrieve. | [required] | |
data | Option<std::path::PathBuf> | The binary data to be set. For File variables, this multipart can contain the filename, binary value and MIME type of the file variable to be set Only the filename is mandatory. | ||
value_type | Option<String> | The name of the variable type. Either Bytes for a byte array variable or File for a file variable. |
(empty response body)
No authorization required
- Content-Type: multipart/form-data
- Accept: application/json
[Back to top] [Back to API list] [Back to Model list] [Back to README]
crate::models::BatchDto set_retries_by_process(set_job_retries_by_process_dto)
Create a batch to set retries of jobs associated with given processes asynchronously.
Name | Type | Description | Required | Notes |
---|---|---|---|---|
set_job_retries_by_process_dto | Option<SetJobRetriesByProcessDto> | Please note that if both processInstances and processInstanceQuery are provided, then the resulting execution will be performed on the union of these sets. Unallowed property: historicProcessInstanceQuery |
No authorization required
- Content-Type: application/json
- Accept: application/json
[Back to top] [Back to API list] [Back to Model list] [Back to README]
crate::models::BatchDto set_retries_by_process_historic_query_based(set_job_retries_by_process_dto)
Create a batch to set retries of jobs asynchronously based on a historic process instance query.
Name | Type | Description | Required | Notes |
---|---|---|---|---|
set_job_retries_by_process_dto | Option<SetJobRetriesByProcessDto> | Please note that if both processInstances and historicProcessInstanceQuery are provided, then the resulting execution will be performed on the union of these sets. Unallowed property: processInstanceQuery |
No authorization required
- Content-Type: application/json
- Accept: application/json
[Back to top] [Back to API list] [Back to Model list] [Back to README]
update_suspension_state(process_instance_suspension_state_dto)
Activates or suspends process instances by providing certain criteria: # Activate/Suspend Process Instance By Process Definition Id * suspend
* processDefinitionId
# Activate/Suspend Process Instance By Process Definition Key * suspend
* processDefinitionKey
* processDefinitionTenantId
* processDefinitionWithoutTenantId
# Activate/Suspend Process Instance In Group * suspend
* processInstanceIds
* processInstanceQuery
* historicProcessInstanceQuery
Name | Type | Description | Required | Notes |
---|---|---|---|---|
process_instance_suspension_state_dto | Option<ProcessInstanceSuspensionStateDto> |
(empty response body)
No authorization required
- Content-Type: application/json
- Accept: application/json
[Back to top] [Back to API list] [Back to Model list] [Back to README]
crate::models::BatchDto update_suspension_state_async_operation(process_instance_suspension_state_async_dto)
Activates or suspends process instances asynchronously with a list of process instance ids, a process instance query, and/or a historical process instance query.
Name | Type | Description | Required | Notes |
---|---|---|---|---|
process_instance_suspension_state_async_dto | Option<ProcessInstanceSuspensionStateAsyncDto> |
No authorization required
- Content-Type: application/json
- Accept: application/json
[Back to top] [Back to API list] [Back to Model list] [Back to README]
update_suspension_state_by_id(id, suspension_state_dto)
Activates or suspends a given process instance by id.
Name | Type | Description | Required | Notes |
---|---|---|---|---|
id | String | The id of the process instance to activate or suspend. | [required] | |
suspension_state_dto | Option<SuspensionStateDto> |
(empty response body)
No authorization required
- Content-Type: application/json
- Accept: Not defined
[Back to top] [Back to API list] [Back to Model list] [Back to README]