### 启动 Camunda 流程实例并修改流程变量 Camunda 提供了 REST API 接口，允许外部系统（如 Python 应用）与流程引擎进行交互。通过调用这些接口，可以在 Python 中启动流程实例，并在启动时或运行过程中设置、修改流程变量。 #### 启动流程实例 Camunda 的 `/process-definition/{processDefinitionId}/start` 接口可用于启动新的流程实例。该接口接受 JSON 格式的请求体，其中可以包含 `businessKey` 和 `variables` 字段。`variables` 是一个键值对对象，用于初始化流程变量[^1]。 ```python import requests base_url = "http://localhost:8080/engine-rest" def start_process_instance(process_definition_id, business_key=None, variables=None): url = f"{base_url}/process-definition/{process_definition_id}/start" payload = {} if business_key: payload["businessKey"] = business_key if variables: payload["variables"] = variables response = requests.post(url, json=payload) return response.json() ``` 此方法中，`variables` 的结构是一个字典，每个键代表变量名，对应的值是一个包含 `value` 和 `type` 的对象。例如： ```json { "variables": { "customerName": { "value": "Alice", "type": "String" }, "orderAmount": { "value": "500", "type": "Integer" } } } ``` #### 修改流程变量 流程实例运行期间，可以通过 `/process-instance/{processInstanceId}/modify-variables` 接口更新流程变量。该接口支持部分更新，即仅修改指定的变量，不影响其他已存在的变量[^1]。 ```python def update_process_variables(process_instance_id, variables): url = f"{base_url}/process-instance/{process_instance_id}/modify-variables" payload = {"variables": variables} response = requests.post(url, json=payload) return response.json() ``` 示例调用： ```python update_process_variables("PROCESS_INSTANCE_ID", { "orderAmount": { "value": "600", "type": "Integer" } }) ``` #### 查询流程变量 在流程执行过程中，如果需要读取当前变量状态，可以使用 `/process-instance/{id}/variables` 接口获取所有变量信息： ```python def get_process_variables(process_instance_id): url = f"{base_url}/process-instance/{process_instance_id}/variables" response = requests.get(url) return response.json() ``` 该接口返回的数据结构为变量名到其值和类型的映射。 #### 外部任务与 Python 服务集成 除了直接操作流程变量，Camunda 还支持通过外部任务（External Task）机制调用 Python 编写的服务。外部任务客户端可以轮询 Camunda 引擎获取待处理的任务，执行本地逻辑后将结果回传给引擎，从而实现服务调用与流程推进的结合[^1]。 ---