VariableWriteActivity
分类: 通用步骤
命名空间: CMS.Plugin.FlowManagement.Domain.FlowBusiness.Activitys
基类: BusinessActivity
模块: FlowManagement.Domain
概述
VariableWriteActivity（变量下发）是用于在流程中写入外部变量（如 PLC 变量）的节点。它继承自 BusinessActivity，通过 IFlowVariableService 服务将值写入变量。
配置说明
| 属性名 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
| CheckVariableName | bool | 否 | false | 是否检查变量配置 |
| WriteRetryCount | int | 否 | 3 | 写入重试次数 |
| WriteRetryDelay | int | 否 | 500 | 写入重试延时（毫秒） |
| ParameterVariables | WriteParameterVariables | 否 | 空集合 | 参数变量集合 |
参数变量配置
| 属性名 | 类型 | 说明 |
|---|---|---|
| WriteVariableName | string | 写入变量名称 |
| WriteVariableValue | string | 写入固定值 |
| ReadParameterName | string | 从流程上下文读取值的键名 |
| ReadVariableName | string | 从其他变量读取值 |
| FlowItemKey | string | 流程上下文键名 |
| WriteIntoDataItems | bool | 是否写入流程上下文 |
| Sort | int | 排序 |
使用示例
{
"Type": "VariableWriteActivity",
"Name": "下发PLC变量",
"Alias": "WritePLCVars",
"WriteRetryCount": 3,
"WriteRetryDelay": 500,
"ParameterVariables": [
{
"WriteVariableName": "DB1.StartSignal",
"WriteVariableValue": "1",
"WriteIntoDataItems": false
},
{
"WriteVariableName": "DB1.ProductCode",
"ReadParameterName": "ProductCode_Value",
"WriteIntoDataItems": true
}
]
}
注意事项
- 💡 支持批量写入多个变量
- 💡 写入失败会自动重试
- 💡 支持从流程上下文或其他变量读取值
- ⚠️ 需要配置变量服务（IFlowVariableService）
相关节点
- VariableReadActivity: 变量读取节点
- VariableMonitorActivity: 变量监控节点
更新历史
| 日期 | 版本 | 说明 |
|---|---|---|
| 2025-11-28 | 1.0 | 初始版本 |
本文档最后更新时间: 2025-11-28