Coverage
The following tables show which Camunda 8 entities and properties are migrated by the History Data Migrator.
Unsupported entities
The following entities are not supported for migration (no properties are migrated):
- Batch operation
- Batch operation item
- Cluster variable
- Correlated message subscription
- Exporter position
- History deletion
- Job metrics batch
- Message subscription
- Sequence flow
- Usage metric
- Usage metric (TU)
- Web session
Supported entities
The following limitations apply to Audit log entries:
- Audit log entries are migrated only for user tasks, process definitions, process instances, variables, decisions, users, groups, and authorizations.
- Audit log entries are not migrated for batch operations, identity links, attachments, job definitions, jobs, external tasks, metrics, operation logs, filters, comments, and properties.
| Entity Type | Property | Migration Supported | Notes |
|---|---|---|---|
| Audit log | |||
auditLogKey | Yes | ||
entityKey | Partially | Migrated only for entities related to user tasks, process definitions, and process instances | |
entityType | Yes | ||
operationType | Yes | ||
entityVersion | Yes | ||
entityValueType | No | ||
entityOperationIntent | No | ||
batchOperationKey | No | ||
batchOperationType | No | ||
timestamp | Yes | ||
actorType | Yes | ||
actorId | Yes | ||
agentElementId | No | ||
tenantId | Yes | ||
tenantScope | Yes | ||
result | Yes | ||
annotation | Yes | ||
category | Yes | ||
processDefinitionId | Yes | ||
decisionRequirementsId | No | ||
decisionDefinitionId | No | ||
processDefinitionKey | Yes | ||
processInstanceKey | Yes | ||
rootProcessInstanceKey | Yes | ||
elementInstanceKey | Partially | Migrated only for entities related to user tasks | |
jobKey | No | ||
userTaskKey | Yes | ||
decisionRequirementsKey | No | ||
decisionDefinitionKey | No | ||
decisionEvaluationKey | No | ||
deploymentKey | No | ||
formKey | No | ||
resourceKey | No | ||
relatedEntityType | No | ||
relatedEntityKey | No | ||
entityDescription | Partially | Migrated only for user, group, tenant, and delete variable operations | |
partitionId | Yes | Always 1. | |
historyCleanupDate | Yes | ||
| Decision definition | |||
decisionDefinitionKey | Yes | ||
name | Yes | ||
decisionDefinitionId | Yes | ||
tenantId | Yes | ||
version | Yes | ||
decisionRequirementsId | Yes | ||
decisionRequirementsKey | Yes | ||
decisionRequirementsName | Yes | ||
decisionRequirementsVersion | Yes | ||
| Decision instance | |||
decisionInstanceId | Yes | ||
decisionInstanceKey | Yes | ||
state | Yes | ||
evaluationDate | Yes | ||
evaluationFailure | No | ||
evaluationFailureMessage | No | ||
result | Yes | ||
flowNodeInstanceKey | Yes | ||
flowNodeId | Yes | ||
processInstanceKey | Yes | ||
processDefinitionKey | Yes | ||
processDefinitionId | Yes | ||
rootProcessInstanceKey | Yes | ||
decisionDefinitionKey | Yes | ||
decisionDefinitionId | Yes | ||
decisionRequirementsKey | Yes | ||
decisionRequirementsId | Yes | ||
rootDecisionDefinitionKey | Yes | ||
decisionType | Yes | ||
tenantId | Yes | ||
partitionId | Yes | Always 1. | |
evaluatedInputs | Yes | ||
evaluatedOutputs | Yes | ||
historyCleanupDate | Yes | ||
| Decision requirements | |||
decisionRequirementsKey | Yes | ||
decisionRequirementsId | Yes | ||
name | Yes | ||
resourceName | Yes | ||
version | Yes | ||
xml | Yes | ||
tenantId | Yes | ||
| Flow node instance | |||
flowNodeInstanceKey | Yes | ||
processInstanceKey | Yes | ||
processDefinitionKey | Yes | ||
processDefinitionId | Yes | ||
flowNodeScopeKey | Yes | ||
startDate | Yes | ||
endDate | Yes | ||
flowNodeId | Yes | ||
flowNodeName | Yes | ||
treePath | Yes | ||
type | Yes | ||
state | Yes | ||
incidentKey | No | ||
numSubprocessIncidents | No | ||
tenantId | Yes | ||
partitionId | Yes | Always 1. | |
rootProcessInstanceKey | Yes | ||
| Form | |||
formKey | Yes | ||
tenantId | Yes | ||
formId | Yes | ||
schema | Yes | ||
version | Yes | ||
isDeleted | Yes | Always false. | |
| Incident | |||
incidentKey | Yes | ||
processDefinitionKey | Yes | ||
processDefinitionId | Yes | ||
processInstanceKey | Yes | ||
rootProcessInstanceKey | Yes | ||
flowNodeInstanceKey | Yes | Will not be populated when an incident occurs in flow node in waiting state with asyncBefore configuration | |
flowNodeId | Yes | ||
jobKey | Partially | Populated only for entities related to jobs of type asynchronous continuation. | |
errorType | Yes | Populated when an equivalent mapping is possible. In all other cases, it's set to UNKNOWN | |
errorMessage | Yes | ||
errorMessageHash | No | ||
creationDate | Yes | ||
state | Yes | Always Resolved | |
treePath | Yes | ||
tenantId | Yes | ||
partitionId | Yes | Always 1. | |
| Job | |||
| jobKey | Yes | ||
| type | No | ||
| worker | Yes | Set to the hostname of the machine where Camunda 7 has executed the job. | |
| state | Yes | Always COMPLETED. | |
| kind | Yes | Always BPMN_ELEMENT. | |
| listenerEventType | Yes | Always UNSPECIFIED. | |
| retries | Yes | Always 0. | |
| isDenied | No | ||
| deniedReason | No | ||
| hasFailedWithRetriesLeft | No | ||
| errorCode | No | ||
| errorMessage | No | ||
| serializedCustomHeaders | No | ||
| customHeaders | No | ||
| deadline | No | ||
| endTime | No | ||
| processDefinitionId | Yes | ||
| processDefinitionKey | Yes | ||
| processInstanceKey | Yes | ||
| rootProcessInstanceKey | Yes | ||
| elementId | Yes | ||
| elementInstanceKey | Partially | It is not populated for jobs related to flow nodes in waiting state with asyncBefore configuration | |
| tenantId | Yes | ||
| partitionId | Yes | Always 1. | |
| creationTime | Yes | ||
| lastUpdateTime | No | ||
| Process definition | |||
processDefinitionKey | Yes | ||
processDefinitionId | Yes | ||
resourceName | Yes | ||
name | Yes | ||
tenantId | Yes | ||
versionTag | Yes | ||
version | Yes | ||
bpmnXml | Yes | ||
formId | Yes | ||
| Process instance | |||
processInstanceKey | Yes | ||
rootProcessInstanceKey | Yes | ||
processDefinitionId | Yes | ||
processDefinitionKey | Yes | ||
state | Yes | ||
startDate | Yes | ||
endDate | Yes | ||
tenantId | Yes | ||
parentProcessInstanceKey | Yes | ||
parentElementInstanceKey | Yes | ||
numIncidents | Yes | Always 0. | |
version | Yes | ||
partitionId | Yes | Always 1. | |
treePath | Yes | ||
historyCleanupDate | Yes | ||
tags | Yes | Tags do not exist in Camunda 7, but we allow to set them during migration via interceptors and they will be visible in Camunda 8 after migration. Default tags: legacy-id-<processInstanceId> | |
businessId | Yes | ||
| User task | |||
userTaskKey | Yes | ||
elementId | Yes | ||
name | Yes | ||
processDefinitionId | Yes | ||
creationDate | Yes | ||
completionDate | Yes | ||
assignee | Yes | ||
state | Yes | ||
formKey | Yes | ||
processDefinitionKey | Yes | ||
processInstanceKey | Yes | ||
rootProcessInstanceKey | Yes | ||
elementInstanceKey | Yes | ||
tenantId | Yes | ||
dueDate | Yes | ||
followUpDate | Yes | ||
candidateGroups | Yes | ||
candidateUsers | Yes | ||
externalFormReference | No | ||
processDefinitionVersion | Yes | ||
customHeaders | No | ||
priority | Yes | ||
tags | Yes | Tags do not exist in Camunda 7, but we allow to set them during migration via interceptors and they will be visible in Camunda 8 after migration | |
partitionId | Yes | Always 1. | |
| Variable | |||
variableKey | Yes | ||
name | Yes | ||
type | Yes | ||
doubleValue | Yes | ||
longValue | Yes | ||
value | Yes | ||
fullValue | Yes | ||
isPreview | Yes | ||
scopeKey | Yes | ||
processInstanceKey | Yes | ||
rootProcessInstanceKey | Yes | ||
processDefinitionId | Yes | ||
tenantId | Yes | ||
partitionId | Yes | Always 1. | |
elementInstanceKey | Yes |