org.flowable.engine.migration

Interface ProcessInstanceMigrationBuilder

All Known Implementing Classes:

ProcessInstanceMigrationBuilderImpl

public interface ProcessInstanceMigrationBuilder

Author:

Dennis Federico

Method Summary

Modifier and Type	Method and Description
ProcessInstanceMigrationBuilder	addActivityMigrationMapping(ActivityMigrationMapping mapping) Adds an activity mapping to the process instance migration plan.
ProcessInstanceMigrationBuilder	fromProcessInstanceMigrationDocument(ProcessInstanceMigrationDocument processInstanceMigrationDocument) Creates a ProcessInstanceMigrationBuilder using the values of a ProcessInstanceMigrationDocument
ProcessInstanceMigrationDocument	getProcessInstanceMigrationDocument() Builds a ProcessInstanceMigrationDocument
void	migrate(String processInstanceId) Starts the process instance migration for a process identified with the submitted processInstanceId
void	migrateProcessInstances(String processDefinitionId) Starts the process instance migration for all process instances of a given process definition identified by the process definition id.
void	migrateProcessInstances(String processDefinitionKey, int processDefinitionVersion, String processDefinitionTenantId) Starts the process instance migration for all process instances of a given process definition identified by the process definition key and version (optional tenantId).
ProcessInstanceMigrationBuilder	migrateToProcessDefinition(String processDefinitionId) Specifies the process definition to migrate to, using the process definition id
ProcessInstanceMigrationBuilder	migrateToProcessDefinition(String processDefinitionKey, int processDefinitionVersion) Specifies the process definition to migrate to, identified by its key and version
ProcessInstanceMigrationBuilder	migrateToProcessDefinition(String processDefinitionKey, int processDefinitionVersion, String processDefinitionTenantId) Specifies the process definition to migrate to, identified by its key and version and tenantId
ProcessInstanceMigrationValidationResult	validateMigration(String processInstanceId) Validates this process instance migration instructions for a given process instance identified by its processInstanceId
ProcessInstanceMigrationValidationResult	validateMigrationOfProcessInstances(String processDefinitionId) Validates this process instance migration instruction for each process instance of a given process definition identified by the process definition id.
ProcessInstanceMigrationValidationResult	validateMigrationOfProcessInstances(String processDefinitionKey, int processDefinitionVersion, String processDefinitionTenantId) Validates this process instance migration instruction for each process instance of a given process definition identified by the process definition key and version (optional tenantId).
ProcessInstanceMigrationBuilder	withMigrateToProcessDefinitionTenantId(String processDefinitionTenantId) Specifies the tenantId of the process definition to migrate to
ProcessInstanceMigrationBuilder	withProcessInstanceVariable(String variableName, Object variableValue) Specifies a process instance variable that will also be available during the process migration (ie.
ProcessInstanceMigrationBuilder	withProcessInstanceVariables(Map<String,Object> variables) Specified process instances variables that will also be available during process migration

Method Detail

fromProcessInstanceMigrationDocument

ProcessInstanceMigrationBuilder fromProcessInstanceMigrationDocument(ProcessInstanceMigrationDocument processInstanceMigrationDocument)

Creates a ProcessInstanceMigrationBuilder using the values of a ProcessInstanceMigrationDocument

Parameters:

processInstanceMigrationDocument -

Returns:

See Also:

ProcessInstanceMigrationDocument

migrateToProcessDefinition

ProcessInstanceMigrationBuilder migrateToProcessDefinition(String processDefinitionId)

Specifies the process definition to migrate to, using the process definition id

Parameters:

processDefinitionId -

Returns:

See Also:

ProcessDefinition

migrateToProcessDefinition

ProcessInstanceMigrationBuilder migrateToProcessDefinition(String processDefinitionKey,
                                                           int processDefinitionVersion)

Specifies the process definition to migrate to, identified by its key and version

Parameters:

processDefinitionKey -

processDefinitionVersion -

Returns:

See Also:

ProcessDefinition

migrateToProcessDefinition

ProcessInstanceMigrationBuilder migrateToProcessDefinition(String processDefinitionKey,
                                                           int processDefinitionVersion,
                                                           String processDefinitionTenantId)

Specifies the process definition to migrate to, identified by its key and version and tenantId

Parameters:

processDefinitionKey -

processDefinitionVersion -

processDefinitionTenantId -

Returns:

See Also:

ProcessDefinition

withMigrateToProcessDefinitionTenantId

ProcessInstanceMigrationBuilder withMigrateToProcessDefinitionTenantId(String processDefinitionTenantId)

Specifies the tenantId of the process definition to migrate to

Parameters:

processDefinitionTenantId -

Returns:

addActivityMigrationMapping

ProcessInstanceMigrationBuilder addActivityMigrationMapping(ActivityMigrationMapping mapping)

Adds an activity mapping to the process instance migration plan. Addition order is relevant and "auto-mapping" has priority. There can only be one mapping for a given "from" activity.

Parameters:

mapping -

Returns:

See Also:

ActivityMigrationMapping

withProcessInstanceVariable

ProcessInstanceMigrationBuilder withProcessInstanceVariable(String variableName,
                                                            Object variableValue)

Specifies a process instance variable that will also be available during the process migration (ie. to resolve callActivity calledElement expressions of the new process definition - if any)

Parameters:

variableName -

variableValue -

Returns:

withProcessInstanceVariables

ProcessInstanceMigrationBuilder withProcessInstanceVariables(Map<String,Object> variables)

Specified process instances variables that will also be available during process migration

Parameters:

variables -

Returns:

getProcessInstanceMigrationDocument

ProcessInstanceMigrationDocument getProcessInstanceMigrationDocument()

Builds a ProcessInstanceMigrationDocument

Returns:

See Also:

ProcessInstanceMigrationDocument

migrate

void migrate(String processInstanceId)

Starts the process instance migration for a process identified with the submitted processInstanceId

Parameters:

processInstanceId -

validateMigration

ProcessInstanceMigrationValidationResult validateMigration(String processInstanceId)

Validates this process instance migration instructions for a given process instance identified by its processInstanceId

Parameters:

processInstanceId -

Returns:

a ProcessInstanceMigrationValidationResult that contains validation error messages - if any

See Also:

ProcessInstanceMigrationValidationResult

migrateProcessInstances

void migrateProcessInstances(String processDefinitionId)

Starts the process instance migration for all process instances of a given process definition identified by the process definition id.

Parameters:

processDefinitionId -

validateMigrationOfProcessInstances

ProcessInstanceMigrationValidationResult validateMigrationOfProcessInstances(String processDefinitionId)

Validates this process instance migration instruction for each process instance of a given process definition identified by the process definition id.

Parameters:

processDefinitionId -

Returns:

a ProcessInstanceMigrationValidationResult that contains validation error messages - if any

See Also:

ProcessInstanceMigrationValidationResult

migrateProcessInstances

void migrateProcessInstances(String processDefinitionKey,
                             int processDefinitionVersion,
                             String processDefinitionTenantId)

Starts the process instance migration for all process instances of a given process definition identified by the process definition key and version (optional tenantId).

Parameters:

processDefinitionKey -

processDefinitionVersion -

processDefinitionTenantId -

validateMigrationOfProcessInstances

ProcessInstanceMigrationValidationResult validateMigrationOfProcessInstances(String processDefinitionKey,
                                                                             int processDefinitionVersion,
                                                                             String processDefinitionTenantId)

Validates this process instance migration instruction for each process instance of a given process definition identified by the process definition key and version (optional tenantId).

Parameters:

processDefinitionKey -

processDefinitionVersion -

processDefinitionTenantId -

Returns:

a ProcessInstanceMigrationValidationResult that contains validation error messages - if any

See Also:

ProcessInstanceMigrationValidationResult