ParameterCollectActivity - 过程参数采集
概述
| 属性 | 值 |
|---|---|
| 节点名称 | 过程参数采集 |
| 节点描述 | 过程参数采集步骤 |
| 节点类型 | 业务节点 |
| 命名空间 | CMS.Plugin.MesSuite.Activitys |
| 程序集 | CMS.Plugin.MesSuite.Activitys |
| 分类 | 工序步骤 |
| 排序 | 24 |
| 发布 | 是 |
| 基类 | ProcessBusinessActivity |
功能说明
ParameterCollectActivity 是过程参数采集节点，用于从 PLC 或其他设备采集生产过程中的各类参数数据。采集的数据包括：
- 工艺参数（ProcessParameters）
- 物料参数（MaterialParameters）
- 配方参数（FormulaParameters）
- 不良原因变量
- 合格信号变量
- SOP 相关变量
- 物料扣减量变量
- 系统班次变量
配置属性
| 属性名 | 显示名称 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|---|
| CollectDeliverVariable | 采集配方下发参数 | bool | 否 | true | 是否采集配方下发参数 |
| CollectWatchVariable | 采集配方监听参数 | bool | 否 | true | 是否采集配方监听参数 |
| CollectSystemShift | 采集系统班次 | bool | 否 | true | 是否采集系统班次 |
| ParameterVariables | 采集参数 | ReadParameterVariables | 否 | 空 | 额外的参数变量集合 |
业 务逻辑
执行流程
开始
│
▼
检查产品码是否存在
│
├─► 为空 → 抛出异常
│
▼
收集需要采集的变量名
│
├─► 合格信号变量
├─► 更新码变量
├─► SOP 相关变量
├─► 物料扣减量变量
├─► 不良原因变量
├─► 工艺参数变量
├─► 物料参数变量
├─► 自定义参数变量
├─► 配方下发参数（可选）
├─► 配方监听参数（可选）
└─► 系统班次变量（可选）
│
▼
去重并过滤空变量
│
▼
调用变量服务批量读取
│
▼
存储采集结果到流程数据项
│
▼
结束
采集变量来源
| 来源 | 说明 |
|---|---|
| OutboundQualityVariable | PLC 合格信号变量 |
| UpdateCodeVariable | 更新码变量 |
| SopPassButton/SopRejectButton/SopQuality | SOP 相关变量 |
| MaterialDeductions.DosageQtyVariable | 物料扣减量变量 |
| UnqualifiedReasons.Variable | 不良原因变量 |
| ProcessParameters.Variable | 工艺参数变量 |
| MaterialParameters.BarcodeVariable | 物料条码变量 |
| FormulaParameters.DeliverVariable | 配方下发变量 |
| FormulaParameters.WatchVariable | 配方监听变量 |
| SystemShiftVariable | 系统班次变量 |
流程数据项
输入数据项
| 数据项 | 类型 | 说明 |
|---|---|---|
| ApplicationData | ProcessModel | 工艺模型 |
| SerialNumber | string | 产品码 |
| OutboundQualityVariable | string | 合格信号变量名 |
| SopPassButton | string | SOP 合格按钮变量 |
| SopRejectButton | string | SOP 不合格按钮变量 |
| SopQuality | string | SOP 质量变量 |
输出数据项
| 数据项 | 类型 | 说明 |
|---|---|---|
| ParameterCollectData | IReadOnlyDictionary<string, IVariableValue> | 采集的参数数据 |
| ParameterCollectVarNames | List<string> | 采集的变量名列表 |
| QualityResultValue | int? | 质量结果值 |
| QualityResultReason | string | 不合格原因 |
依赖服务
| 服务接口 | 说明 |
|---|---|
| IFlowVariableService | 流程变量服务 |
使用示例
基本配置
<ParameterCollectActivity Name="过程参数采集">
<CollectDeliverVariable>true</CollectDeliverVariable>
<CollectWatchVariable>true</CollectWatchVariable>
<CollectSystemShift>true</CollectSystemShift>
</ParameterCollectActivity>
添加自定义采集参数
<ParameterCollectActivity Name="过程参数采集">
<ParameterVariables>
<Variable VariableName="CustomParam1" />
<Variable VariableName="CustomParam2" />
</ParameterVariables>
</ParameterCollectActivity>
典型流程配置
进站初始化 → 生产加工 → 参数采集 → 合格判断 → 参数存储
<InboundInitializeActivity Name="进站初始化" />
<!-- 生产加工过程 -->
<ParameterCollectActivity Name="过程参数采集">
<CollectDeliverVariable>true</CollectDeliverVariable>
<CollectWatchVariable>true</CollectWatchVariable>
</ParameterCollectActivity>
<LocalQualificationJudgmentActivity Name="本机合格判断" />
<ParameterSaveActivity Name="过程参数存储" />
相关节点
- ParameterSaveActivity - 过程参数存储
- ParameterTransferActivity - 参数传递
- LocalQualificationJudgmentActivity - 本机合格判断
- ProcessBusinessActivity - 工序业务活动基类
注意事项
- 产品码必须存在，否则会抛出异常
- 采集的变量名会自动去重和过滤空值
- 采集结果存储在
ParameterCollectData数据项中 - 后续节点（如合格判断、参数存储）依赖此节点的采集结果