AutoBOM/docs/执行计划-附加功能支持.md

执行计划：添加附加功能（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() 方法

新增内容：

' 仪表特性 - 第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()

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行常量定义

修改内容：

' 修改前
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 特殊处理

' 在现有的 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+一位数字的格式
分隔符不一致	解析错误	统一将 . 替换为 , 处理
条件评估逻辑错误	匹配错误	充分测试各种边界情况

---

是否批准此执行计划？确认后我将开始代码实现。