Activiti 多实例任务 nrOfCompletedInstances 属性详解

Activiti 多实例任务 nrOfCompletedInstances 属性详解

nrOfCompletedInstances 是 Activiti 工作流引擎中用于多实例任务的一个重要属性，它表示当前已完成的实例数量。在多实例循环执行过程中，该属性用于追踪已完成实例的数量，方便流程控制和状态监控。

重要特性：

• 只读属性: nrOfCompletedInstances 属性不可直接设置，它会随着多实例任务中实例的完成自动更新。
• 自动更新: 每当一个多实例任务的子实例执行完毕，nrOfCompletedInstances 的值就会自动加 1。

如何获取该属性值？

您可以通过 Activiti 提供的 API 获取 nrOfCompletedInstances 属性的值。以下是一个 Java 代码示例：

String taskId = 'yourTaskId'; // 请替换为实际的多实例任务ID
TaskService taskService = processEngine.getTaskService();
Task task = taskService.createTaskQuery().taskId(taskId).singleResult();

// 获取 nrOfCompletedInstances 属性值
Integer completedInstances = (Integer) taskService.getVariableLocal(taskId, 'nrOfCompletedInstances');

System.out.println('已完成实例数量：' + completedInstances);

代码解析：

1. 获取任务对象: 使用 TaskService 通过任务 ID 查询并获取对应的任务对象。
2. 获取属性值: 使用 taskService.getVariableLocal() 方法，传入任务 ID 和属性名 'nrOfCompletedInstances' 获取属性值，并转换为 Integer 类型。

注意事项:

• 确保已正确配置和启动 Activiti 流程引擎。
• 确保多实例任务的相关信息已正确存储于流程实例和任务中。

希望本文能帮助您更好地理解和使用 Activiti 中的 nrOfCompletedInstances 属性！