Compare commits
2 Commits
726bbe2118
...
9db957dc37
| Author | SHA1 | Date | |
|---|---|---|---|
|
|
9db957dc37 | ||
|
|
38581f72d6 |
3
.gitignore
vendored
3
.gitignore
vendored
@@ -13,4 +13,5 @@ tmpclaude-*
|
||||
*workspace*
|
||||
*.png
|
||||
data/
|
||||
*.xlsm
|
||||
*.xlsm
|
||||
*.xlsx
|
||||
@@ -1,226 +0,0 @@
|
||||
# BIPUploadModule 流程图文档
|
||||
|
||||
## 模块概述
|
||||
|
||||
**模块名**: BIPUploadModule
|
||||
**功能**: 处理产品订单数据,提取BOM后生成[BIP上传模板]格式数据
|
||||
**主入口**: ProcessOrdersToBIP
|
||||
|
||||
## ProcessOrdersToBIP 流程图(简化版)
|
||||
|
||||
```mermaid
|
||||
flowchart TD
|
||||
Start([开始处理]) --> Init["初始化<br/>1. 获取工作表<br/>2. 加载BOM库"]
|
||||
|
||||
Init --> Loop["循环处理每个订单"]
|
||||
|
||||
Loop --> Read["读取订单信息<br/>- 生产订单号<br/>- 产品型号<br/>- 数量<br/>- 产品编码<br/>- 部件优先标志"]
|
||||
|
||||
Read --> Parse["解析产品型号<br/>提取规格参数"]
|
||||
|
||||
Parse --> Extract["提取BOM物料<br/>根据规格参数匹配物料库"]
|
||||
|
||||
Extract --> CheckPriority{"部件优先=否?"}
|
||||
CheckPriority -->|是| SkipComponent["排除'部件'类别<br/>只提取子类别物料"]
|
||||
CheckPriority -->|否| KeepAll["保留所有物料"]
|
||||
SkipComponent --> Generate
|
||||
KeepAll --> Generate["生成BIP上传数据<br/>- 订单信息<br/>- 物料清单<br/>- 行号编码"]
|
||||
|
||||
Generate --> Collect["收集到内存集合"]
|
||||
|
||||
Collect --> NextOrder{"还有订单?"}
|
||||
NextOrder -->|是| Loop
|
||||
NextOrder -->|否| BatchWrite["批量写入[BIP上传模板]"]
|
||||
|
||||
BatchWrite --> Format["格式化表格"]
|
||||
|
||||
Format --> End([完成])
|
||||
|
||||
style Init fill:#e1f5e1
|
||||
style Parse fill:#fff3cd
|
||||
style Extract fill:#d1ecf1
|
||||
style Generate fill:#d1ecf1
|
||||
style BatchWrite fill:#f8d7da
|
||||
style End fill:#e1f5e1
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## ProcessSingleOrder 子流程(详细版)
|
||||
|
||||
> 注:以下为技术人员提供详细流程图
|
||||
|
||||
```mermaid
|
||||
flowchart TD
|
||||
Start([开始 ProcessSingleOrder]) --> ClearExclude["清空排除类别<br/>ClearExcludeCategories"]
|
||||
|
||||
ClearExclude --> CheckPriority{"部件优先?"}
|
||||
CheckPriority -->|否/0/FALSE| AddExclude["创建排除类别集合<br/>添加: 部件"]
|
||||
AddExclude --> SetExclude["设置排除类别"]
|
||||
SetExclude --> ParseModel
|
||||
CheckPriority -->|是| ParseModel["解析产品型号<br/>ProductModelParser.Parse"]
|
||||
|
||||
ParseModel --> CheckParse{"解析成功?"}
|
||||
CheckParse -->|否| CreateError1["创建错误行数据<br/>备注: 解析失败信息"]
|
||||
CreateError1 --> AddError1["添加到outputData"] --> End1([返回])
|
||||
|
||||
CheckParse -->|是| ExtractBOM["提取BOM<br/>BomExtractor.ExtractBom"]
|
||||
ExtractBOM --> GetErrors["获取错误信息摘要"]
|
||||
|
||||
GetErrors --> CheckMatch{"匹配到物料?"}
|
||||
CheckMatch -->|否| SetError1["设置备注: 未匹配到任何物料"]
|
||||
SetError1 --> CreateError2["创建空记录行数据"]
|
||||
CreateError2 --> AddError2["添加到outputData"] --> End2([返回])
|
||||
|
||||
CheckMatch -->|是| InitLine["初始化行号索引 lineIndex = 1"]
|
||||
InitLine --> StartLoop["开始循环物料"]
|
||||
|
||||
StartLoop --> GetItem["获取物料项"]
|
||||
GetItem --> InitNote["初始化备注 = 提取错误"]
|
||||
|
||||
InitNote --> CheckItemError{"物料有错误?"}
|
||||
CheckItemError -->|是| AppendError["追加物料错误信息"]
|
||||
CheckItemError -->|否| CreateRow
|
||||
AppendError --> CreateRow["创建BIP行数据<br/>CreateBIPRowArray"]
|
||||
|
||||
CreateRow --> AddRow["添加到outputData"]
|
||||
AddRow --> IncLine["lineIndex++"]
|
||||
IncLine --> NextLoop{"还有物料?"}
|
||||
NextLoop -->|是| StartLoop
|
||||
NextLoop -->|否| End3([返回])
|
||||
```
|
||||
|
||||
## WriteBatchData 批量写入流程
|
||||
|
||||
```mermaid
|
||||
flowchart TD
|
||||
Start([开始 WriteBatchData]) --> CheckData{"outputData为空?"}
|
||||
CheckData -->|是| End1([直接返回])
|
||||
CheckData -->|否| GetRowCount["获取行数 rowCount"]
|
||||
|
||||
GetRowCount --> CreateArray["创建二维数组<br/>resultData1 to rowCount, 1 to 10"]
|
||||
|
||||
CreateArray --> StartLoop["开始循环: i = 1 to rowCount"]
|
||||
StartLoop --> GetRowArray["获取行数组 rowArray = outputDatai"]
|
||||
|
||||
GetRowArray --> FillArray["填充二维数组<br/>resultDatai, 1 to 10 = rowArray1 to 10"]
|
||||
FillArray --> NextLoop{"i++ 还有数据?"}
|
||||
NextLoop -->|是| StartLoop
|
||||
NextLoop -->|否| WriteSheet["一次性写入工作表<br/>A2单元格.Resize rowCount, 10"]
|
||||
|
||||
WriteSheet --> End([完成])
|
||||
```
|
||||
|
||||
## 数据结构说明
|
||||
|
||||
### BIP上传模板字段 (10列)
|
||||
|
||||
| 列号 | 字段名 | 说明 | 数据来源 |
|
||||
|------|--------|------|----------|
|
||||
| 1 | 来源单据号(生产订单号) | 订单唯一标识 | [产品订单] A列 |
|
||||
| 2 | 产品编码 | 产品代码 | [产品订单] D列 |
|
||||
| 3 | 生产数量 | 生产数量 | [产品订单] C列 |
|
||||
| 4 | 行号 | BOM行号 = 7000 + 索引 | 自动生成(7001, 7002...) |
|
||||
| 5 | 材料编码 | 物料66编码 | BOM提取结果 |
|
||||
| 6 | 供应方式 | 固定值 | "一般发料" |
|
||||
| 7 | 需用日期 | 日期 | 当天日期 Date |
|
||||
| 8 | 发料组织 | 固定值 | "重庆布莱迪仪器仪表有限公司" |
|
||||
| 9 | 计划出库数量 | 数量 | 与生产数量一致 |
|
||||
| 10 | 备注 | 异常信息 | BOM提取错误/异常 |
|
||||
|
||||
### [产品订单] 工作表结构 (5列)
|
||||
|
||||
| 列号 | 字段名 | 说明 | 必填 |
|
||||
|------|--------|------|------|
|
||||
| A | 生产订单号 | 订单唯一标识 | 是 |
|
||||
| B | 产品型号 | 产品完整型号 | 是 |
|
||||
| C | 数量 | 生产数量 | 是 |
|
||||
| D | 产品编码 | 产品代码 | 否 |
|
||||
| E | 部件优先 | 是否优先提取部件类别 | 否 |
|
||||
|
||||
## 关键特性
|
||||
|
||||
### 1. 性能优化
|
||||
- **批量写入**: 使用数组一次性写入所有数据,而非逐个单元格写入
|
||||
- **内存缓存**: 所有数据先收集到Collection对象,最后统一输出
|
||||
- **预期性能提升**: 10-100倍(取决于数据量)
|
||||
|
||||
### 2. 部件优先功能
|
||||
- 当`部件优先` = "否"/"0"/"FALSE"时:
|
||||
- 排除"部件"类别的物料
|
||||
- 只提取"部件"的子类别物料(如"接头"、"弹性元件"等)
|
||||
- 当`部件优先` = "是"或其他值时:
|
||||
- 正常提取所有物料,包括"部件"类别及其子类别
|
||||
|
||||
### 3. 错误处理
|
||||
- **必填字段验证**: 生产订单号、产品型号、数量
|
||||
- **解析失败处理**: 记录错误信息到备注列
|
||||
- **BOM提取异常**: 记录匹配失败和异常信息
|
||||
- **空行处理**: 自动跳过完全空白的行
|
||||
|
||||
### 4. 数据完整性
|
||||
- 每次运行前清空旧数据(保留表头)
|
||||
- 自动创建[BIP上传模板]工作表(如不存在)
|
||||
- 行号自动生成(7001, 7002, 7003...)
|
||||
- 日期自动填充为当天日期
|
||||
|
||||
## 执行示例
|
||||
|
||||
### 正常流程示例
|
||||
|
||||
```
|
||||
输入: [产品订单] 3行数据
|
||||
- 订单001, 型号MD-100, 数量10, 编码P001, 部件优先=是
|
||||
- 订单002, 型号MD-200, 数量20, 编码P002, 部件优先=否
|
||||
- 订单003, 型号MD-300, 数量30, 编码P003, 部件优先=是
|
||||
|
||||
处理流程:
|
||||
1. 读取3行订单数据
|
||||
2. 逐个解析产品型号
|
||||
3. 根据部件优先设置提取BOM
|
||||
4. 订单001: 提取5种物料(包括部件)
|
||||
5. 订单002: 提取4种物料(排除部件,只提取子类别)
|
||||
6. 订单003: 提取6种物料(包括部件)
|
||||
7. 批量写入15行数据到[BIP上传模板]
|
||||
8. 显示完成信息: 处理3个订单,生成15行BOM数据
|
||||
|
||||
输出: [BIP上传模板] 15行数据
|
||||
```
|
||||
|
||||
### 异常处理示例
|
||||
|
||||
```
|
||||
输入: [产品订单] 包含异常数据
|
||||
- 订单A01, 型号INVALID, 数量5 ← 型号解析失败
|
||||
- 订单A02, 型号MD-100, 数量0 ← 未匹配到任何物料
|
||||
- 订单A03, 型号MD-200, 数量10 ← 正常提取3种物料
|
||||
|
||||
输出:
|
||||
第1行: 订单A01, ..., 备注: "解析失败: 无效的型号格式"
|
||||
第2行: 订单A02, ..., 备注: "未匹配到任何物料"
|
||||
第3-5行: 订单A03, 3种物料数据
|
||||
```
|
||||
|
||||
## 相关模块
|
||||
|
||||
### 依赖的类模块
|
||||
- **BomExtractor**: BOM提取器,负责从平台配置清单中提取匹配的物料
|
||||
- **ProductModelParser**: 产品型号解析器,解析型号字符串为结构化条件
|
||||
- **BomItem**: BOM物料项数据模型
|
||||
- **ConditionEvaluator**: 条件评估器,评估选择条件和类别条件
|
||||
|
||||
### 相关模块
|
||||
- **MainModule**: 主控模块,处理产品型号提取和BOM匹配
|
||||
- 类似的处理逻辑
|
||||
- 输出到[BOM提取结果]工作表
|
||||
- 支持部件优先功能
|
||||
- 使用相同的批量写入优化
|
||||
|
||||
## 版本历史
|
||||
|
||||
| 版本 | 日期 | 说明 |
|
||||
|------|------|------|
|
||||
| 1.0 | 2026-02-01 | 初始版本,实现基本的订单处理和BOM提取功能 |
|
||||
| 1.1 | 2026-02-01 | 添加部件优先功能,支持排除特定类别 |
|
||||
| 1.2 | 2026-02-01 | 性能优化,使用数组批量写入替代逐个单元格写入 |
|
||||
| 1.3 | 2026-02-01 | 修复Mermaid流程图方括号转义问题 |
|
||||
@@ -1,443 +0,0 @@
|
||||
# ComponentInventoryCheckModule 流程图文档
|
||||
|
||||
## 模块概述
|
||||
|
||||
**模块名**: ComponentInventoryCheckModule
|
||||
**功能**: 部件库存核对模块 - 自动核对产品订单中"部件"类物料的库存情况
|
||||
**主入口**: CheckComponentInventory
|
||||
**说明**: 当库存不足时,按订单顺序将超出部分的订单的"部件优先"字段标记为"否"
|
||||
|
||||
---
|
||||
|
||||
## 业务流程图(面向非技术人员)
|
||||
|
||||
```mermaid
|
||||
flowchart TD
|
||||
Start([开始核对部件库存]) --> Step1["1. 读取数据<br/>读取产品订单表<br/>读取库存表<br/>读取物料配置表"]
|
||||
|
||||
Step1 --> Step2["2. 分析订单<br/>查看每个订单需要哪些部件<br/>计算每个订单需要多少个部件"]
|
||||
|
||||
Step2 --> Step3["3. 汇总需求<br/>统计所有订单总共需要多少个部件<br/>按部件种类分别统计"]
|
||||
|
||||
Step3 --> Step4["4. 检查库存<br/>对比库存数量和需求数量<br/>找出库存不够的部件"]
|
||||
|
||||
Step4 --> Step5["5. 分配库存<br/>按订单从上到下依次分配<br/>库存够的订单→保持不变<br/>库存不够的订单→标记为'否'"]
|
||||
|
||||
Step5 --> Step6["6. 完成处理<br/>显示处理结果<br/>多少订单能发货<br/>多少订单缺部件"]
|
||||
|
||||
Step6 --> End([完成])
|
||||
|
||||
style Step1 fill:#e1f5e1
|
||||
style Step2 fill:#d1ecf1
|
||||
style Step3 fill:#fff3cd
|
||||
style Step4 fill:#ffe5b4
|
||||
style Step5 fill:#f8d7da
|
||||
style Step6 fill:#e1f5e1
|
||||
```
|
||||
|
||||
### 业务流程说明
|
||||
|
||||
| 步骤 | 做什么 | 为什么 |
|
||||
|------|--------|--------|
|
||||
| **1. 读取数据** | 从Excel表格中读取订单、库存、配置信息 | 获取处理所需的所有数据 |
|
||||
| **2. 分析订单** | 查看每个订单需要什么部件、多少个 | 了解每个订单的部件需求 |
|
||||
| **3. 汇总需求** | 把所有订单的相同部件需求加在一起 | 算出总共需要多少部件 |
|
||||
| **4. 检查库存** | 对比总需求和实际库存 | 判断库存是否够用 |
|
||||
| **5. 分配库存** | 先来先得,库存不够的标记为"否" | 确定哪些订单能按时发货 |
|
||||
| **6. 完成处理** | 显示统计结果 | 让用户了解处理情况 |
|
||||
|
||||
### 举例说明
|
||||
|
||||
假设有3个订单,都需要同一个部件A:
|
||||
|
||||
| 订单 | 需要部件A数量 | 库存分配过程 | 最终状态 |
|
||||
|------|--------------|--------------|---------|
|
||||
| 订单1 | 2个 | 库存剩5个,够用 | ✓ 保持原值 |
|
||||
| 订单2 | 2个 | 库存剩3个,够用 | ✓ 保持原值 |
|
||||
| 订单3 | 2个 | 库存剩1个,不够 | ✗ 标记为"否" |
|
||||
|
||||
> **技术说明**:标记为"否"的订单,在生成BIP上传数据时会跳过部件类物料,优先保证子部件供应。
|
||||
|
||||
---
|
||||
|
||||
## CheckComponentInventory 主流程图(技术版)
|
||||
|
||||
> 以下流程图面向技术人员,展示完整的错误处理和验证步骤。
|
||||
|
||||
---
|
||||
|
||||
## CheckComponentInventory 主流程图(详细版)
|
||||
|
||||
```mermaid
|
||||
flowchart TD
|
||||
Start(["开始 CheckComponentInventory"]) --> GetSheet1["获取[产品订单]工作表"]
|
||||
GetSheet1 --> CheckSheet1{工作表存在?}
|
||||
CheckSheet1 -->|否| ShowMsg1["显示错误消息"] --> End1(["结束"])
|
||||
CheckSheet1 -->|是| GetSheet2["获取[现存量]工作表"]
|
||||
|
||||
GetSheet2 --> CheckSheet2{工作表存在?}
|
||||
CheckSheet2 -->|否| ShowMsg2["显示错误消息"] --> End2(["结束"])
|
||||
CheckSheet2 -->|是| GetSheet3["获取[平台配置清单]工作表"]
|
||||
|
||||
GetSheet3 --> CheckSheet3{工作表存在?}
|
||||
CheckSheet3 -->|否| ShowMsg3["显示错误消息"] --> End3(["结束"])
|
||||
CheckSheet3 -->|是| CheckData{订单数据存在?}
|
||||
|
||||
CheckData -->|否| ShowMsg4["显示无数据消息"] --> End4(["结束"])
|
||||
CheckData -->|是| InitBOM["初始化BOM提取器<br/>LoadBomData"]
|
||||
|
||||
InitBOM --> CheckBOM{BOM加载成功?}
|
||||
CheckBOM -->|否| ShowMsg5["显示BOM错误"] --> End5(["结束"])
|
||||
CheckBOM -->|是| LoadInv["LoadInventoryData<br/>读取库存数据到字典"]
|
||||
|
||||
LoadInv --> CheckInv{库存数据有效?}
|
||||
CheckInv -->|否| ShowMsg6["显示无库存消息"] --> End6(["结束"])
|
||||
CheckInv -->|是| LoadOrders["LoadOrderData<br/>读取订单数据"]
|
||||
|
||||
LoadOrders --> CheckOrders{订单数据有效?}
|
||||
CheckOrders -->|否| ShowMsg7["显示无订单消息"] --> End7(["结束"])
|
||||
CheckOrders -->|是| ParseAll["ParseAllOrdersBOM<br/>解析所有订单的BOM"]
|
||||
|
||||
ParseAll --> CalcDemand["CalculateComponentDemand<br/>统计部件总需求"]
|
||||
|
||||
CalcDemand --> CheckDemand{有部件需求?}
|
||||
CheckDemand -->|否| ShowMsg8["显示无部件消息"] --> End8(["结束"])
|
||||
CheckDemand -->|是| Validate["ValidateInventory<br/>验证库存数据"]
|
||||
|
||||
Validate --> Allocate["AllocateInventory<br/>按订单顺序分配库存"]
|
||||
|
||||
Allocate --> ShowResult["显示结果统计<br/>总订单数、包含部件订单数<br/>库存充足/不足订单数"]
|
||||
|
||||
ShowResult --> End9(["完成"])
|
||||
|
||||
style InitBOM fill:#e1f5e1
|
||||
style LoadInv fill:#d1ecf1
|
||||
style LoadOrders fill:#d1ecf1
|
||||
style ParseAll fill:#fff3cd
|
||||
style CalcDemand fill:#fff3cd
|
||||
style Validate fill:#ffe5b4
|
||||
style Allocate fill:#f8d7da
|
||||
style End9 fill:#e1f5e1
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## AllocateInventory 库存分配详细流程
|
||||
|
||||
```mermaid
|
||||
flowchart TD
|
||||
AllocStart([开始 AllocateInventory]) --> InitStats[初始化统计信息<br/>TotalOrders, OrdersWithComponent<br/>OrdersSufficient, OrdersInsufficient, OrdersSkipped]
|
||||
|
||||
InitStats --> LoopStart{遍历订单<br/>i = 1 to orders.Count}
|
||||
|
||||
LoopStart -->|有订单| GetOrder[获取订单 order = orders i]
|
||||
GetOrder --> CheckParse{解析失败?}
|
||||
CheckParse -->|ORDER_PARSE_ERR <> ""| Skip1[跳过订单<br/>OrdersSkipped++]
|
||||
CheckParse -->|无错误| CheckHasComp{包含部件?}
|
||||
|
||||
CheckHasComp -->|ORDER_HAS_COMP = False| Skip2[跳过订单<br/>OrdersSkipped++]
|
||||
CheckHasComp -->|HasComponent = True| CheckQty{数量为0?}
|
||||
|
||||
CheckQty -->|ORDER_QUANTITY = 0| Skip3[跳过订单<br/>OrdersSkipped++]
|
||||
CheckQty -->|数量 > 0| UpdateComp[OrdersWithComponent++]
|
||||
|
||||
UpdateComp --> GetComp[获取部件库存信息<br/>compInv = componentDemands compCode]
|
||||
GetComp --> CalcReq[计算需求量<br/>requiredQty = CompQty × OrderQty]
|
||||
|
||||
CalcReq --> CheckStock{库存充足?<br/>compInv.STOCK >= requiredQty}
|
||||
|
||||
CheckStock -->|是| DeductSufficient[扣减库存<br/>compInv.STOCK -= requiredQty<br/>OrdersSufficient++]
|
||||
CheckStock -->|否| MarkNo[标记E列为"否"<br/>orderSheet.Cells Row, 5 = "否"<br/>compInv.STOCK -= requiredQty<br/>OrdersInsufficient++]
|
||||
|
||||
DeductSufficient --> NextOrder[继续下一个订单]
|
||||
MarkNo --> NextOrder
|
||||
Skip1 --> NextOrder
|
||||
Skip2 --> NextOrder
|
||||
Skip3 --> NextOrder
|
||||
|
||||
NextOrder --> LoopStart
|
||||
|
||||
style UpdateComp fill:#e1f5e1
|
||||
style DeductSufficient fill:#e1f5e1
|
||||
style MarkNo fill:#f8d7da
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## ParseOrderBOM 解析详细流程
|
||||
|
||||
```mermaid
|
||||
flowchart TD
|
||||
ParseStart([开始 ParseOrderBOM]) --> CreateParser[创建ProductModelParser]
|
||||
CreateParser --> ParseModel[解析型号<br/>parser.Parse model]
|
||||
|
||||
ParseModel --> CheckParse{解析成功?}
|
||||
CheckParse -->|否| SetError[设置解析错误<br/>ORDER_PARSE_ERR = "解析失败: ..."]
|
||||
SetError --> ParseEnd([结束返回])
|
||||
|
||||
CheckParse -->|是| ExtractBOM[提取BOM<br/>bomExtractor.ExtractBom conditions]
|
||||
|
||||
ExtractBOM --> LoopComp{遍历BOM项目<br/>For Each item In matchedItems}
|
||||
|
||||
LoopComp -->|有项目| CheckCat{item.category = "部件"?}
|
||||
|
||||
CheckCat -->|否| NextItem[继续下一个项目]
|
||||
CheckCat -->|是| SetCompInfo[设置部件信息<br/>ORDER_COMP_CODE = item.Code66<br/>ORDER_COMP_QTY = item.quantity<br/>ORDER_HAS_COMP = True]
|
||||
|
||||
SetCompInfo --> ParseEnd
|
||||
NextItem --> LoopComp
|
||||
|
||||
style SetCompInfo fill:#d1ecf1
|
||||
style SetError fill:#f8d7da
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 数据处理序列图
|
||||
|
||||
```mermaid
|
||||
sequenceDiagram
|
||||
participant Main as CheckComponentInventory
|
||||
participant Loader as 数据加载器
|
||||
participant Parser as BOM解析器
|
||||
participant Calc as 需求计算器
|
||||
participant Validator as 库存验证器
|
||||
participant Allocator as 库存分配器
|
||||
|
||||
Main->>Loader: LoadInventoryData(ws)
|
||||
Loader-->>Main: 库存字典 Dictionary(编码 -> 数量)
|
||||
|
||||
Main->>Loader: LoadOrderData(ws)
|
||||
Loader-->>Main: 订单集合 Collection(Of Dictionary)
|
||||
|
||||
loop 每个订单
|
||||
Main->>Parser: ParseOrderBOM(order, bomExtractor)
|
||||
Parser->>Parser: ProductModelParser.Parse(model)
|
||||
Parser->>Parser: BomExtractor.ExtractBom(conditions)
|
||||
Parser->>Parser: 查找 category="部件" 的物料
|
||||
Parser-->>Main: 设置订单部件信息
|
||||
end
|
||||
|
||||
Main->>Calc: CalculateComponentDemand(orders)
|
||||
Calc->>Calc: 累加每个订单的部件需求
|
||||
Note over Calc: 需求 = CompQty × OrderQty
|
||||
Calc-->>Main: 部件需求字典 Dictionary(编码 -> 库存信息)
|
||||
|
||||
Main->>Validator: ValidateInventory(demands, inventoryData)
|
||||
Validator->>Validator: 检查每个部件是否存在
|
||||
Validator->>Validator: 计算是否短缺
|
||||
Validator-->>Main: 警告集合 Collection
|
||||
|
||||
Main->>Allocator: AllocateInventory(orders, demands, sheet)
|
||||
loop 按订单顺序遍历
|
||||
Allocator->>Allocator: 获取订单部件需求
|
||||
Allocator->>Allocator: 检查库存是否充足
|
||||
alt 库存充足
|
||||
Allocator->>Allocator: 扣减库存,保持原值
|
||||
Note over Allocator: OrdersSufficient++
|
||||
else 库存不足
|
||||
Allocator->>Allocator: 标记 E5 = "否"
|
||||
Note over Allocator: OrdersInsufficient++
|
||||
end
|
||||
end
|
||||
Allocator-->>Main: 统计信息 Statistics
|
||||
|
||||
Main-->>Main: 显示结果消息框
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 数据结构说明
|
||||
|
||||
### 订单字典结构 (Dictionary Object)
|
||||
|
||||
| 键名 | 常量 | 类型 | 说明 |
|
||||
|------|------|------|------|
|
||||
| RowNumber | ORDER_ROW | Long | 订单所在行号 |
|
||||
| ProductModel | ORDER_MODEL | String | 产品型号 |
|
||||
| Quantity | ORDER_QUANTITY | Double | 产品数量 |
|
||||
| ComponentCode | ORDER_COMP_CODE | String | 部件66编码 |
|
||||
| ComponentQty | ORDER_COMP_QTY | Double | 部件BOM数量 |
|
||||
| HasComponent | ORDER_HAS_COMP | Boolean | 是否包含部件 |
|
||||
| ParseError | ORDER_PARSE_ERR | String | 解析错误信息 |
|
||||
|
||||
### 部件库存字典结构 (Dictionary Object)
|
||||
|
||||
| 键名 | 常量 | 类型 | 说明 |
|
||||
|------|------|------|------|
|
||||
| ComponentCode | INV_CODE | String | 部件66编码 |
|
||||
| TotalDemand | INV_DEMAND | Double | 总需求量 |
|
||||
| AvailableStock | INV_STOCK | Double | 可用库存(动态扣减) |
|
||||
| IsShortage | INV_SHORTAGE | Boolean | 是否短缺 |
|
||||
|
||||
### 统计信息结构 (Statistics Type)
|
||||
|
||||
| 字段 | 类型 | 说明 |
|
||||
|------|------|------|
|
||||
| TotalOrders | Long | 总订单数 |
|
||||
| OrdersWithComponent | Long | 包含部件的订单数 |
|
||||
| OrdersSufficient | Long | 库存充足订单数 |
|
||||
| OrdersInsufficient | Long | 库存不足订单数 |
|
||||
| OrdersSkipped | Long | 跳过订单数 |
|
||||
|
||||
---
|
||||
|
||||
## 关键特性
|
||||
|
||||
### 1. 库存分配策略
|
||||
- **按订单顺序分配**: 从上到下遍历订单,先到先得
|
||||
- **动态库存扣减**: 库存充足时扣减,不足时标记为负数
|
||||
- **只标记不跳过**: 即使库存不足也继续处理后续订单
|
||||
|
||||
### 2. 部件识别机制
|
||||
- 通过 `BomExtractor` 提取完整BOM
|
||||
- 遍历BOM项目,查找 `category = "部件"` 的物料
|
||||
- 只记录第一个匹配到的部件(假设每个产品只有一个主部件)
|
||||
|
||||
### 3. 错误处理
|
||||
- **工作表缺失**: 提前验证,友好提示
|
||||
- **BOM加载失败**: 显示错误摘要,终止处理
|
||||
- **型号解析失败**: 记录错误,跳过该订单
|
||||
- **部件找不到库存**: 添加警告,继续处理(库存设为0)
|
||||
|
||||
### 4. 数据完整性
|
||||
- 使用 `Dictionary` 实现库存的引用更新
|
||||
- 使用 `Collection` 保持订单顺序
|
||||
- 统计跳过的订单(解析失败、无部件、数量为0)
|
||||
|
||||
---
|
||||
|
||||
## 执行示例
|
||||
|
||||
### 正常流程示例
|
||||
|
||||
```
|
||||
输入数据:
|
||||
[产品订单]
|
||||
第2行: MD-100, 数量2, 部件A(编码661001, 用量1)
|
||||
第3行: MD-200, 数量2, 部件A(编码661001, 用量1)
|
||||
第4行: MD-300, 数量2, 部件A(编码661001, 用量1)
|
||||
|
||||
[现存量]
|
||||
661001: 5
|
||||
|
||||
处理流程:
|
||||
1. 读取3个订单
|
||||
2. 解析BOM,识别部件661001
|
||||
3. 统计需求: 1×2 + 1×2 + 1×2 = 6
|
||||
4. 验证库存: 6 > 5,短缺
|
||||
5. 分配库存:
|
||||
- 订单2: 需求2,库存5→3,充足
|
||||
- 订单3: 需求2,库存3→1,充足
|
||||
- 订单4: 需求2,库存1→-1,不足,标记E4="否"
|
||||
|
||||
输出结果:
|
||||
[产品订单]
|
||||
第2行: E列保持原值
|
||||
第3行: E列保持原值
|
||||
第4行: E列 = "否"
|
||||
|
||||
统计信息:
|
||||
处理订单数: 3
|
||||
包含部件订单: 3
|
||||
库存充足订单: 2
|
||||
库存不足订单: 1
|
||||
```
|
||||
|
||||
### 异常处理示例
|
||||
|
||||
```
|
||||
输入数据:
|
||||
[产品订单]
|
||||
第2行: INVALID-MODEL, 数量5 ← 型号解析失败
|
||||
第3行: MD-100, 数量0 ← 数量为0
|
||||
第4行: MD-200, 数量2, 部件669999 (库存中不存在)
|
||||
|
||||
[现存量]
|
||||
661001: 10
|
||||
|
||||
输出结果:
|
||||
第2行: 跳过(解析失败)
|
||||
第3行: 跳过(数量为0)
|
||||
第4行: 标记E4="否",但添加警告 "部件 '669999' 在[现存量]中未找到"
|
||||
|
||||
统计信息:
|
||||
处理订单数: 3
|
||||
包含部件订单: 1
|
||||
库存充足订单: 0
|
||||
库存不足订单: 1
|
||||
跳过订单数: 2
|
||||
|
||||
警告信息:
|
||||
部件 '669999' 在[现存量]中未找到
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 工作表结构要求
|
||||
|
||||
### [产品订单] 工作表
|
||||
|
||||
| 列号 | 字段名 | 说明 | 必填 |
|
||||
|------|--------|------|------|
|
||||
| A | 生产订单号 | 订单唯一标识 | 否 |
|
||||
| B | 产品型号 | 产品完整型号 | 是 |
|
||||
| C | 数量 | 生产数量 | 是 |
|
||||
| D | 产品编码 | 产品代码 | 否 |
|
||||
| E | 部件优先 | 是否优先提取部件类别(输出字段) | - |
|
||||
|
||||
- **表头**: 第1行
|
||||
- **数据起始**: 第2行
|
||||
- **输出位置**: E列(第5列)
|
||||
|
||||
### [现存量] 工作表
|
||||
|
||||
| 列号 | 字段名 | 说明 |
|
||||
|------|--------|------|
|
||||
| B | 物料编码 | 对应BOM中的66代码 |
|
||||
| J | 结存主数量 | 库存数量 |
|
||||
|
||||
- **表头**: 第3行
|
||||
- **数据起始**: 第4行
|
||||
|
||||
### [平台配置清单] 工作表
|
||||
|
||||
标准的BOM配置清单,用于提取物料信息。
|
||||
|
||||
---
|
||||
|
||||
## 相关模块
|
||||
|
||||
### 依赖的类模块
|
||||
- **BomExtractor**: BOM提取器,负责从平台配置清单中提取匹配的物料
|
||||
- **ProductModelParser**: 产品型号解析器,解析型号字符串为结构化条件
|
||||
- **BomItem**: BOM物料项数据模型
|
||||
|
||||
### 相关模块
|
||||
- **BIPUploadModule**: 生成BIP上传模板
|
||||
- 读取"部件优先"字段
|
||||
- 当值为"否"时排除"部件"类别物料
|
||||
- 与本模块功能互补
|
||||
|
||||
---
|
||||
|
||||
## 算法复杂度
|
||||
|
||||
| 操作 | 时间复杂度 | 说明 |
|
||||
|------|-----------|------|
|
||||
| LoadInventoryData | O(n) | n = 库存行数 |
|
||||
| LoadOrderData | O(m) | m = 订单行数 |
|
||||
| ParseAllOrdersBOM | O(m × p) | p = 平均BOM物料数 |
|
||||
| CalculateComponentDemand | O(m) | 遍历订单统计需求 |
|
||||
| ValidateInventory | O(k) | k = 不同部件数 |
|
||||
| AllocateInventory | O(m) | 遍历订单分配库存 |
|
||||
|
||||
**总体复杂度**: O(m × p),主要由BOM解析决定
|
||||
|
||||
---
|
||||
|
||||
## 版本历史
|
||||
|
||||
| 版本 | 日期 | 说明 |
|
||||
|------|------|------|
|
||||
| 1.0 | 2026-02-03 | 初始版本,实现部件库存核对功能 |
|
||||
@@ -1,391 +0,0 @@
|
||||
# 执行计划:部件数量核对功能
|
||||
|
||||
## 一、需求概述
|
||||
|
||||
### 1.1 功能描述
|
||||
自动核对产品订单中"部件"类物料的库存情况,当库存不足时,按订单顺序将超出部分的订单的"部件优先"字段标记为"否"。
|
||||
|
||||
### 1.2 数据源
|
||||
|
||||
#### [产品订单]工作表
|
||||
- **表头位置**:第1行
|
||||
- **数据起始行**:第2行
|
||||
- **关键列**:
|
||||
- B列:产品型号
|
||||
- C列:产品数量
|
||||
- E列:部件优先(输出字段)
|
||||
|
||||
#### [现存量]工作表
|
||||
- **表头位置**:第3行
|
||||
- **数据起始行**:第4行
|
||||
- **关键列**:
|
||||
- B列:物料编码(对应BOM中的66代码)
|
||||
- J列:结存主数量(库存数量)
|
||||
|
||||
---
|
||||
|
||||
## 二、业务逻辑
|
||||
|
||||
### 2.1 核心流程
|
||||
|
||||
```
|
||||
1. 读取所有订单 → 2. 解析型号提取BOM → 3. 识别部件物料
|
||||
↓
|
||||
4. 统计部件总需求 → 5. 查询库存 → 6. 库存充足性检查
|
||||
↓
|
||||
7. 按订单顺序分配库存 → 8. 修改部件优先字段
|
||||
```
|
||||
|
||||
### 2.2 计算规则
|
||||
|
||||
#### 部件总需求量
|
||||
```
|
||||
部件总需求 = Σ(订单i的BOM中部件数量 × 订单i的产品数量)
|
||||
```
|
||||
|
||||
#### 示例
|
||||
```
|
||||
订单1:产品数量=2,部件A的BOM数量=1 → 需求 = 1 × 2 = 2
|
||||
订单2:产品数量=2,部件A的BOM数量=1 → 需求 = 1 × 2 = 2
|
||||
订单3:产品数量=2,部件A的BOM数量=1 → 需求 = 1 × 2 = 2
|
||||
--------------------------------------------------------
|
||||
部件A总需求 = 2 + 2 + 2 = 6
|
||||
部件A库存 = 5
|
||||
库存不足 = 6 - 5 = 1
|
||||
```
|
||||
|
||||
### 2.3 分配策略
|
||||
|
||||
**原则**:按订单自上而下的顺序分配库存
|
||||
|
||||
| 订单 | 需求量 | 分配前库存 | 分配后库存 | 部件优先 |
|
||||
|------|--------|-----------|-----------|---------|
|
||||
| 订单1 | 2 | 5 | 3 | 保持不变 |
|
||||
| 订单2 | 2 | 3 | 1 | 保持不变 |
|
||||
| 订单3 | 2 | 1 | -1(不足) | **改为"否"** |
|
||||
|
||||
---
|
||||
|
||||
## 三、处理规则
|
||||
|
||||
### 3.1 正常情况
|
||||
- 订单包含"部件"物料,库存充足 → 保持原值
|
||||
- 订单包含"部件"物料,库存不足 → 改为"否"
|
||||
- 订单不包含"部件"物料 → **保持原值不变**
|
||||
|
||||
### 3.2 异常情况
|
||||
- **部件在[现存量]中找不到** → 报错提示,终止处理
|
||||
- **型号解析失败** → 跳过该订单,记录错误
|
||||
- **未匹配到任何物料** → 跳过该订单(无部件)
|
||||
|
||||
### 3.3 字段修改规则
|
||||
- **基于现有值进行修改**(不清空原有值)
|
||||
- **只修改E列"部件优先"字段**
|
||||
- 修改格式:`是`、`否`、`1`、`0`、`TRUE`、`FALSE` 均可识别
|
||||
|
||||
---
|
||||
|
||||
## 四、数据结构设计
|
||||
|
||||
### 4.1 订单数据结构
|
||||
```vba
|
||||
Type OrderInfo
|
||||
RowNumber As Long ' 行号
|
||||
ProductModel As String ' 产品型号
|
||||
Quantity As Long ' 产品数量
|
||||
ComponentCode As String ' 部件66编码
|
||||
ComponentQty As Double ' 部件BOM数量
|
||||
HasComponent As Boolean ' 是否包含部件
|
||||
ParseError As String ' 解析错误信息
|
||||
End Type
|
||||
```
|
||||
|
||||
### 4.2 部件库存结构
|
||||
```vba
|
||||
Type ComponentInventory
|
||||
ComponentCode As String ' 部件66编码
|
||||
TotalDemand As Double ' 总需求量
|
||||
AvailableStock As Double ' 可用库存
|
||||
IsShortage As Boolean ' 是否短缺
|
||||
End Type
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 五、实现方案
|
||||
|
||||
### 5.1 新建模块
|
||||
|
||||
**文件名**:`ComponentInventoryCheckModule.bas`
|
||||
|
||||
**主要过程**:
|
||||
```vba
|
||||
Public Sub CheckComponentInventory()
|
||||
' 主入口程序
|
||||
End Sub
|
||||
```
|
||||
|
||||
### 5.2 核心函数
|
||||
|
||||
#### 5.2.1 读取订单数据
|
||||
```vba
|
||||
Private Function LoadOrderData(ws As Worksheet) As Collection
|
||||
' 返回 Collection(Of OrderInfo)
|
||||
' 读取[产品订单]的B、C列数据
|
||||
End Function
|
||||
```
|
||||
|
||||
#### 5.2.2 读取库存数据
|
||||
```vba
|
||||
Private Function LoadInventoryData(ws As Worksheet) As Object
|
||||
' 返回 Dictionary(物料编码 -> 库存数量)
|
||||
' 读取[现存量]的B、J列数据
|
||||
End Function
|
||||
```
|
||||
|
||||
#### 5.2.3 解析订单BOM
|
||||
```vba
|
||||
Private Sub ParseOrderBOM(orderInfo As OrderInfo, _
|
||||
bomExtractor As BomExtractor, _
|
||||
parser As ProductModelParser)
|
||||
' 解析型号,提取BOM
|
||||
' 识别"部件"类别物料
|
||||
' 填充 orderInfo.ComponentCode 和 orderInfo.ComponentQty
|
||||
End Sub
|
||||
```
|
||||
|
||||
#### 5.2.4 统计部件需求
|
||||
```vba
|
||||
Private Function CalculateComponentDemand( _
|
||||
orders As Collection) As Object
|
||||
' 返回 Dictionary(部件编码 -> ComponentInventory)
|
||||
' 累加所有订单的部件需求量
|
||||
End Function
|
||||
```
|
||||
|
||||
#### 5.2.5 检查库存充足性
|
||||
```vba
|
||||
Private Sub ValidateInventory( _
|
||||
componentDemands As Object, _
|
||||
inventoryData As Object)
|
||||
' 检查每个部件的库存是否充足
|
||||
' 如果找不到或不足,报错提示
|
||||
End Sub
|
||||
```
|
||||
|
||||
#### 5.2.6 分配库存并标记
|
||||
```vba
|
||||
Private Sub AllocateInventory( _
|
||||
orders As Collection, _
|
||||
componentDemands As Object, _
|
||||
orderSheet As Worksheet)
|
||||
' 按订单顺序分配库存
|
||||
' 库存不足时,修改E列"部件优先"为"否"
|
||||
End Sub
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 六、详细实现步骤
|
||||
|
||||
### 6.1 主流程(CheckComponentInventory)
|
||||
|
||||
```
|
||||
1. 获取工作表对象
|
||||
├─ [产品订单]工作表
|
||||
├─ [现存量]工作表
|
||||
└─ [平台配置清单]工作表
|
||||
|
||||
2. 初始化BOM提取器
|
||||
└─ 加载BOM数据
|
||||
|
||||
3. 读取库存数据到字典
|
||||
└─ Dictionary(66编码 -> 库存数量)
|
||||
|
||||
4. 读取订单数据
|
||||
└─ Collection(Of OrderInfo)
|
||||
|
||||
5. 解析所有订单的BOM
|
||||
└─ 识别部件,填充ComponentCode和ComponentQty
|
||||
|
||||
6. 统计部件总需求
|
||||
└─ Dictionary(部件编码 -> ComponentInventory)
|
||||
|
||||
7. 验证库存
|
||||
└─ 检查部件是否存在于[现存量]中
|
||||
|
||||
8. 按订单顺序分配库存
|
||||
└─ 修改E列"部件优先"字段
|
||||
|
||||
9. 输出结果统计
|
||||
└─ MsgBox显示处理结果
|
||||
```
|
||||
|
||||
### 6.2 分配算法(伪代码)
|
||||
|
||||
```vba
|
||||
For Each order In orders
|
||||
If order.HasComponent Then
|
||||
Dim demand As ComponentInventory
|
||||
demand = componentDemands(order.ComponentCode)
|
||||
|
||||
Dim requiredQty As Double
|
||||
requiredQty = order.ComponentQty * order.Quantity
|
||||
|
||||
If demand.AvailableStock >= requiredQty Then
|
||||
' 库存充足,保持原值
|
||||
demand.AvailableStock = demand.AvailableStock - requiredQty
|
||||
Else
|
||||
' 库存不足,标记为"否"
|
||||
orderSheet.Cells(order.RowNumber, 5).Value = "否"
|
||||
demand.AvailableStock = demand.AvailableStock - requiredQty
|
||||
End If
|
||||
End If
|
||||
Next order
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 七、边界情况处理
|
||||
|
||||
### 7.1 无部件的订单
|
||||
```
|
||||
条件:订单的BOM中没有"类别=部件"的物料
|
||||
处理:跳过该订单,E列保持原值
|
||||
```
|
||||
|
||||
### 7.2 多个订单使用不同部件
|
||||
```
|
||||
订单1:部件A
|
||||
订单2:部件B
|
||||
处理:分别统计A和B的需求,独立核算库存
|
||||
```
|
||||
|
||||
### 7.3 库存为0的情况
|
||||
```
|
||||
条件:[现存量]中某部件的结存主数量 = 0
|
||||
处理:所有需要该部件的订单都标记为"否"
|
||||
```
|
||||
|
||||
### 7.4 产品数量为0的情况
|
||||
```
|
||||
条件:订单的C列产品数量 = 0
|
||||
处理:该订单的部件需求 = 0,不影响库存
|
||||
```
|
||||
|
||||
### 7.5 部件优先字段原有值
|
||||
```
|
||||
可能的值:"是"、"否"、1、0、TRUE、FALSE、空
|
||||
处理:基于现有值修改,不清空
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 八、测试用例
|
||||
|
||||
### 8.1 基本功能测试
|
||||
|
||||
| 测试场景 | 订单数 | 部件 | 总需求 | 库存 | 预期结果 |
|
||||
|---------|--------|------|--------|------|---------|
|
||||
| 库存充足 | 3 | A(1) | 6 | 10 | 全部保持原值 |
|
||||
| 库存不足 | 3 | A(1) | 6 | 5 | 第3个订单改为"否" |
|
||||
| 库存刚好 | 3 | A(1) | 6 | 6 | 全部保持原值 |
|
||||
| 无部件订单 | 2 | - | - | - | 保持原值 |
|
||||
| 库存为0 | 2 | A(1) | 4 | 0 | 全部改为"否" |
|
||||
|
||||
### 8.2 异常情况测试
|
||||
|
||||
| 测试场景 | 预期行为 |
|
||||
|---------|---------|
|
||||
| 部件在[现存量]中不存在 | 报错提示,终止处理 |
|
||||
| 型号解析失败 | 跳过该订单,记录错误 |
|
||||
| [产品订单]为空 | 提示无数据,退出 |
|
||||
| [现存量]为空 | 报错提示,退出 |
|
||||
|
||||
### 8.3 边界值测试
|
||||
|
||||
| 测试场景 | 输入值 | 预期结果 |
|
||||
|---------|--------|---------|
|
||||
| 产品数量为1 | 所有订单数量=1 | 正常计算 |
|
||||
| 产品数量为大数 | 订单数量=1000 | 正常计算 |
|
||||
| 部件BOM数量为小数 | 0.5 | 正确计算总需求 |
|
||||
| 库存数量为小数 | 2.5 | 正确判断库存 |
|
||||
|
||||
---
|
||||
|
||||
## 九、用户界面设计
|
||||
|
||||
### 9.1 执行入口
|
||||
|
||||
建议在主界面添加按钮:
|
||||
```
|
||||
[部件库存核对]
|
||||
```
|
||||
|
||||
### 9.2 结果提示
|
||||
|
||||
执行完成后显示:
|
||||
```
|
||||
✓ 部件库存核对完成!
|
||||
|
||||
处理订单数:10
|
||||
包含部件订单:8
|
||||
库存充足订单:6
|
||||
库存不足订单:2
|
||||
|
||||
耗时:0.50秒
|
||||
```
|
||||
|
||||
### 9.3 错误提示
|
||||
|
||||
格式:
|
||||
```
|
||||
✗ 部件库存核对失败!
|
||||
|
||||
错误信息:
|
||||
- 订单第5行:部件 '661234' 在[现存量]中未找到
|
||||
|
||||
请检查数据后重试。
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 十、实施步骤
|
||||
|
||||
1. **创建新模块**
|
||||
- 文件名:`ComponentInventoryCheckModule.bas`
|
||||
- 位置:`VBA/Modules/`
|
||||
|
||||
2. **实现核心函数**
|
||||
- LoadOrderData
|
||||
- LoadInventoryData
|
||||
- ParseOrderBOM
|
||||
- CalculateComponentDemand
|
||||
- ValidateInventory
|
||||
- AllocateInventory
|
||||
|
||||
3. **实现主流程**
|
||||
- CheckComponentInventory
|
||||
|
||||
4. **测试验证**
|
||||
- 基本功能测试
|
||||
- 异常情况测试
|
||||
- 边界值测试
|
||||
|
||||
5. **集成到主界面**
|
||||
- 添加按钮或菜单项
|
||||
|
||||
---
|
||||
|
||||
## 十一、风险评估
|
||||
|
||||
| 风险 | 影响 | 缓解措施 |
|
||||
|------|------|---------|
|
||||
| 库存数据不准确 | 导致错误的分配结果 | 执行前提示用户确认库存数据 |
|
||||
| 订单量大导致性能问题 | 处理时间长 | 优化算法,使用批量操作 |
|
||||
| BOM解析失败 | 无法识别部件 | 记录错误日志,跳过该订单 |
|
||||
| 部件编码不一致 | 无法匹配库存 | 严格验证,报错提示 |
|
||||
|
||||
---
|
||||
|
||||
**是否批准此执行计划?确认后我将开始代码实现。**
|
||||
@@ -1,199 +0,0 @@
|
||||
# 执行计划:添加附加功能(fjgn)支持
|
||||
|
||||
## 一、需求概述
|
||||
|
||||
### 1.1 新增条件字段
|
||||
- **条件代码**:`fjgn`
|
||||
- **条件名称**:`附加功能`
|
||||
- **提取位置**:从型号表头的[仪表特性]字段中提取(第6个位置,索引5)
|
||||
|
||||
### 1.2 型号结构
|
||||
```
|
||||
[型号]-[公称外径].[安装形式].[壳体形式].[过程连接&接液材质].[量程范围].[仪表特性]
|
||||
```
|
||||
|
||||
### 1.3 仪表特性解析规则
|
||||
- **充油类型**:位于最后,格式为 `Y`+一位数字(如 Y3)
|
||||
- **附加功能**:在充油类型前面的内容
|
||||
- 分隔符可能是 `,` 或 `.`(如 `N2,N3` 或 `N2.N3`)
|
||||
- 可能为空(如仪表特性只有 `Y3`)
|
||||
|
||||
### 1.4 示例
|
||||
| 型号 | 仪表特性 | 充油类型 | 附加功能 |
|
||||
|------|----------|----------|----------|
|
||||
| PYTHN-100.A0.541.M201.M06.N2,N3.Y3 | N2,N3.Y3 | Y3 | N2,N3 |
|
||||
| YTHN-100.A0.531.M201.M08.Y3 | Y3 | Y3 | (空) |
|
||||
|
||||
---
|
||||
|
||||
## 二、条件评估规则
|
||||
|
||||
### 2.1 fjgn 条件的特殊处理
|
||||
|
||||
| 条件表达式 | 型号中的 fjgn | 评估结果 | 说明 |
|
||||
|-----------|--------------|---------|------|
|
||||
| fjgn=N1 | N1,N2 | ✅ True | 包含 N1 |
|
||||
| fjgn=N1 | N2,N3 | ❌ False | 不包含 N1 |
|
||||
| fjgn=N1 | (空) | ❌ False | 空值不包含任何值 |
|
||||
| fjgn!=N1 | N1,N2 | ❌ False | 包含 N1,不满足!= |
|
||||
| fjgn!=N1 | N2,N3 | ✅ True | 不包含 N1 |
|
||||
| fjgn!=N1 | (空) | ✅ True | 空值不包含 N1 |
|
||||
|
||||
### 2.2 匹配逻辑
|
||||
- **等值匹配(fjgn=XX)**:fjgn 字符串中包含指定值即为真
|
||||
- **不等匹配(fjgn!=XX)**:fjgn 字符串中不包含指定值即为真
|
||||
- **空值处理**:空字符串不包含任何值
|
||||
|
||||
---
|
||||
|
||||
## 三、代码修改方案
|
||||
|
||||
### 3.1 ProductModelParser.cls
|
||||
|
||||
**修改位置**:`ParseHeader()` 方法
|
||||
|
||||
**新增内容**:
|
||||
```vba
|
||||
' 仪表特性 - 第6个位置(索引5),可能不存在
|
||||
If UBound(dotParts) >= 5 Then
|
||||
Dim instrumentFeature As String
|
||||
instrumentFeature = Trim(dotParts(5))
|
||||
|
||||
' 提取附加功能
|
||||
Dim fjgn As String
|
||||
fjgn = ExtractAdditionalFeatures(instrumentFeature)
|
||||
|
||||
pConditions.Add "fjgn", fjgn
|
||||
Else
|
||||
' 如果没有仪表特性字段,fjgn为空
|
||||
pConditions.Add "fjgn", ""
|
||||
End If
|
||||
```
|
||||
|
||||
**新增方法**:`ExtractAdditionalFeatures()`
|
||||
```vba
|
||||
Private Function ExtractAdditionalFeatures(instrumentFeature As String) As String
|
||||
' 1. 检查是否以Y+数字结尾(充油类型)
|
||||
Dim lastTwoChars As String
|
||||
If Len(instrumentFeature) >= 2 Then
|
||||
lastTwoChars = Right(instrumentFeature, 2)
|
||||
If UCase(Left(lastTwoChars, 1)) = "Y" And IsNumeric(Right(lastTwoChars, 1)) Then
|
||||
' 去掉充油类型
|
||||
instrumentFeature = Left(instrumentFeature, Len(instrumentFeature) - 2)
|
||||
instrumentFeature = Trim(instrumentFeature)
|
||||
End If
|
||||
End If
|
||||
|
||||
' 2. 处理可能的分隔符(,或.)
|
||||
' 将可能的.替换为,,统一处理
|
||||
instrumentFeature = Replace(instrumentFeature, ".", ",")
|
||||
|
||||
' 3. 去除可能的后缀分隔符
|
||||
If Right(instrumentFeature, 1) = "," Then
|
||||
instrumentFeature = Left(instrumentFeature, Len(instrumentFeature) - 1)
|
||||
End If
|
||||
|
||||
ExtractAdditionalFeatures = Trim(instrumentFeature)
|
||||
End Function
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### 3.2 BIPUploadModule.bas
|
||||
|
||||
**修改位置**:第12行常量定义
|
||||
|
||||
**修改内容**:
|
||||
```vba
|
||||
' 修改前
|
||||
Private Const CONDITION_CONFIG = "azxs,安装形式|bkxs,表壳形式|gclj,过程连接|jycz,接液材质|lcfw,量程范围"
|
||||
|
||||
' 修改后
|
||||
Private Const CONDITION_CONFIG = "azxs,安装形式|bkxs,表壳形式|gclj,过程连接|jycz,接液材质|lcfw,量程范围|fjgn,附加功能"
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### 3.3 ConditionEvaluator.cls
|
||||
|
||||
**修改位置**:`EvaluateSingleCondition()` 方法
|
||||
|
||||
**修改内容**:在现有的 `=` 和 `!=` 运算符处理后,添加 fjgn 特殊处理
|
||||
|
||||
```vba
|
||||
' 在现有的 actualValue = Conditions(varName) 之后添加
|
||||
actualValue = Conditions(varName)
|
||||
|
||||
' fjgn 字段特殊处理(多值匹配)
|
||||
If varName = "fjgn" Then
|
||||
If operator = "=" Then
|
||||
' fjgn=N1:检查actualValue中是否包含value
|
||||
EvaluateSingleCondition = InStr(actualValue, value) > 0
|
||||
ElseIf operator = "!=" Then
|
||||
' fjgn!=N1:检查actualValue中是否不包含value
|
||||
EvaluateSingleCondition = InStr(actualValue, value) = 0
|
||||
End If
|
||||
Exit Function
|
||||
End If
|
||||
|
||||
' 其他字段使用原有逻辑
|
||||
EvaluateSingleCondition = (actualValue = value)
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 四、测试用例
|
||||
|
||||
### 4.1 解析测试
|
||||
|
||||
| 测试型号 | 预期 fjgn | 预期其他条件 |
|
||||
|---------|----------|-------------|
|
||||
| PYTHN-100.A0.541.M201.M06.N2,N3.Y3 | N2,N3 | azxs=A0, bkxs=541, gclj=M20, jycz=1, lcfw=M06 |
|
||||
| YTHN-100.A0.531.M201.M08.Y3 | (空) | azxs=A0, bkxs=531, gclj=M20, jycz=1, lcfw=M08 |
|
||||
| BP-088.2312.M08.0A3.N1.N2.Y2 | N1,N2 | azxs=23, bkxs=12, gclj=M08, jycz=0, lcfw=A3 |
|
||||
| BP-088.2312.M08.0A3.Y2 | (空) | azxs=23, bkxs=12, gclj=M08, jycz=0, lcfw=A3 |
|
||||
|
||||
### 4.2 条件评估测试
|
||||
|
||||
| fjgn值 | 选用条件 | 预期结果 |
|
||||
|-------|---------|---------|
|
||||
| N1,N2 | fjgn=N1 | True |
|
||||
| N1,N2 | fjgn=N3 | False |
|
||||
| (空) | fjgn=N1 | False |
|
||||
| N1,N2 | fjgn!=N1 | False |
|
||||
| N1,N2 | fjgn!=N3 | True |
|
||||
| (空) | fjgn!=N1 | True |
|
||||
|
||||
---
|
||||
|
||||
## 五、实施步骤
|
||||
|
||||
1. **修改 ProductModelParser.cls**
|
||||
- 在 `ParseHeader()` 方法中添加仪表特性提取逻辑
|
||||
- 新增 `ExtractAdditionalFeatures()` 方法
|
||||
|
||||
2. **修改 BIPUploadModule.bas**
|
||||
- 更新 `CONDITION_CONFIG` 常量
|
||||
|
||||
3. **修改 ConditionEvaluator.cls**
|
||||
- 在 `EvaluateSingleCondition()` 方法中添加 fjgn 特殊处理逻辑
|
||||
|
||||
4. **测试验证**
|
||||
- 测试型号解析是否正确
|
||||
- 测试条件评估是否符合预期
|
||||
- 测试边界情况(空值、多个附加功能等)
|
||||
|
||||
---
|
||||
|
||||
## 六、风险评估
|
||||
|
||||
| 风险 | 影响 | 缓解措施 |
|
||||
|------|------|---------|
|
||||
| 旧型号缺少仪表特性字段 | 解析失败 | 判断字段是否存在,不存在时 fjgn 为空 |
|
||||
| 充油类型识别错误 | 提取错误 | 严格匹配 Y+一位数字的格式 |
|
||||
| 分隔符不一致 | 解析错误 | 统一将 `.` 替换为 `,` 处理 |
|
||||
| 条件评估逻辑错误 | 匹配错误 | 充分测试各种边界情况 |
|
||||
|
||||
---
|
||||
|
||||
**是否批准此执行计划?确认后我将开始代码实现。**
|
||||
23
reference_docs/平台配置清单.md
Normal file
23
reference_docs/平台配置清单.md
Normal file
@@ -0,0 +1,23 @@
|
||||
| | A | B | C | D | E | F | G | H |
|
||||
| --- | --- | --- | --- | --- | --- | --- | --- | --- |
|
||||
| 1 | 代号 | YTHN-100 | 描述 | | 英文名称 | | | |
|
||||
| 2 | 名称 | (不锈钢)耐震压力表 | 负责人 | | 备注 | | | |
|
||||
| 3 | 行号 | 模块 | 代号 | 名称 | 数量 | 选择条件 | 备注 | 类别 |
|
||||
| 4 | 10 | 316L部件 | 01011009557 | 径向低压接头部件 | 1.0 | gclj=M20 AND jycz=1 AND lcfw=M01 AND (azxs=A0 OR azxs=AT OR azxs=AH) | | 部件 |
|
||||
| 5 | 20 | 316L部件 | 01011009520 | 径向低压接头部件 | 1.0 | gclj=M20 AND jycz=1 AND lcfw=M02 AND (azxs=A0 OR azxs=AT OR azxs=AH) | | 部件 |
|
||||
| 6 | 330 | 316L部件 | 01011013929 | 下轴向低压接头部件 | 1.0 | gclj=M20 AND jycz=1 AND lcfw=M01 AND (azxs=B0 OR azxs=BT OR azxs=BZ OR azxs=BH) | | 部件 |
|
||||
| 7 | 340 | 316L部件 | 01011013978 | 下轴向低压接头部件 | 1.0 | gclj=M20 AND jycz=1 AND lcfw=M02 AND (azxs=B0 OR azxs=BT OR azxs=BZ OR azxs=BH) | | 部件 |
|
||||
| 8 | 650 | 304部件 | 01011019001 | 径向低压接头部件 | 1.0 | gclj=M20 AND jycz=3 AND lcfw=M02 AND (azxs=A0 OR azxs=AT OR azxs=AH) | | 部件 |
|
||||
| 9 | 660 | 304部件 | 01011019002 | 径向低压接头部件 | 1.0 | gclj=M20 AND jycz=3 AND lcfw=M03 AND (azxs=A0 OR azxs=AT OR azxs=AH) | | 部件 |
|
||||
| 10 | 800 | 316L接头 | 01081012669 | 径向低压接头 | 1.0 | gclj=M16 AND (azxs=A0 OR azxs=AT OR azxs=AH) AND jycz=1 AND (lcfw=M01 OR lcfw=M02 ) | | 接头 |
|
||||
| 11 | 810 | 316L接头 | 01081007411 | 径向低压接头 | 1.0 | gclj=M14 AND (azxs=A0 OR azxs=AT OR azxs=AH) AND jycz=1 AND (lcfw=M01 OR lcfw=M02) | | 接头 |
|
||||
| 12 | 1080 | 316L接头 | 01081016737 | 径向高压接头(Ф7管专用) | 1.0 | gclj=M20 AND (azxs=A0 OR azxs=AT OR azxs=AH) AND jycz=1 AND lcfw=M18 | | 接头 |
|
||||
| 13 | 1090 | 316L接头 | 01081016738 | 径向高压接头(Ф7管专用) | 1.0 | gclj=M16 AND (azxs=A0 OR azxs=AT OR azxs=AH) AND jycz=1 AND lcfw=M18 | | 接头 |
|
||||
| 14 | 1200 | 316L接头 | 01081013841 | 下轴向低压接头 | 1.0 | gclj=M16 AND (azxs=B0 OR azxs=BT OR azxs=BZ OR azxs=BH) AND jycz=1 AND (lcfw=M01 OR lcfw=M02) | | 接头 |
|
||||
| 15 | 1210 | 316L接头 | 01081013839 | 下轴向低压接头 | 1.0 | gclj=M14 AND (azxs=B0 OR azxs=BT OR azxs=BZ OR azxs=BH) AND jycz=1 AND (lcfw=M01 OR lcfw=M02) | | 接头 |
|
||||
| 16 | 1420 | 316L接头 | 01081016761 | 下轴向高压接头(Ф7管专用) | 1.0 | gclj=M20 AND (azxs=B0 OR azxs=BT OR azxs=BZ OR azxs=BH) AND jycz=1 AND lcfw=M18 | | 接头 |
|
||||
| 17 | 1430 | 316L接头 | 01081016762 | 下轴向高压接头(Ф7管专用) | 1.0 | gclj=M16 AND (azxs=B0 OR azxs=BT OR azxs=BZ OR azxs=BH) AND jycz=1 AND lcfw=M18 | | 接头 |
|
||||
| 18 | 1540 | 316L接头 | 01081011491 | 中轴向低压接头 | 1.0 | gclj=M20 AND (azxs=Z0 OR azxs=ZT OR azxs=ZZ OR azxs=ZH) AND (bkxs=531 OR bkxs=631) AND jycz=1 AND (lcfw=M01 OR lcfw=M02) | | 接头 |
|
||||
| 19 | 1550 | 316L接头 | 01081011490 | 中轴向低压接头 | 1.0 | gclj=M16 AND (azxs=Z0 OR azxs=ZT OR azxs=ZZ OR azxs=ZH) AND (bkxs=531 OR bkxs=631) AND jycz=1 AND (lcfw=M01 OR lcfw=M02) | | 接头 |
|
||||
| 20 | 2710 | 弹性元件 | 01041001939 | 弹簧管 | 1.0 | lcfw=M01 AND ((gclj=KT06 AND (azxs=A0 OR azxs=AT OR azxs=AH) AND jycz=1) OR (gclj=KT08 AND (azxs=A0 OR azxs=AT OR azxs=AH) AND jycz=1)) | | 弹性元件 |
|
||||
| 21 | 2720 | 弹性元件 | 01041001940 | 弹簧管 | 1.0 | lcfw=M02 AND ((gclj=KT06 AND (azxs=A0 OR azxs=AT OR azxs=AH) AND jycz=1) OR (gclj=KT08 AND (azxs=A0 OR azxs=AT OR azxs=AH) AND jycz=1)) | | 弹性元件 |
|
||||
Reference in New Issue
Block a user