BOM表与明细栏摘要在现代产品设计与制造流程中BOMBill of Materials物料清单表与明细栏是连接设计端与制造端的关键桥梁。本文从装配体自动生成零件清单的实际需求出发深入探讨了BOM表的构成原理、自定义属性的设计与应用、材料统计的自动化实现方法。通过SolidWorks API二次开发与Excel VBA结合的方式提供了完整的代码示例帮助读者掌握从三维模型到结构化物料清单的完整技术路径。文章涵盖了BOM表的基本概念、属性映射策略、自动化生成脚本、材料统计算法以及多级BOM展开技术适用于机械设计工程师、PDM系统管理员以及制造工艺规划人员。引言在机械设计领域一个中等复杂程度的装配体通常包含数百甚至上千个零部件。传统的BOM表制作方式——人工从装配体中逐项统计零件编号、名称、数量、材料等信息——不仅效率低下而且极易出错。随着三维CAD软件的普及利用API接口自动提取装配体信息并生成结构化BOM表已成为行业标准做法。然而实际工程中面临的挑战远不止“提取零件列表”这么简单不同企业有各自的自定义属性命名规范材料统计需要考虑重量与成本核算多级装配体需要展开为扁平化的BOM结构。这些问题如果处理不当将导致BOM表与实物不符进而引发采购错误、生产延误等连锁问题。本文将系统性地解决上述痛点通过具体的技术方案和可运行的代码示例帮助读者建立一套从装配体模型到完整BOM表的自动化工作流。1. BOM表的核心概念与结构1.1 BOM表的本质BOM表本质上是一种产品结构树的表格化呈现。它记录了制造一个产品所需的所有零部件、原材料及其数量关系。在工程实践中BOM表通常包含以下核心字段字段名称含义示例层级零件在装配体中的嵌套深度1, 2, 3零件号唯一标识零件的编码PLT-001名称零件的中文或英文名称基座板数量在父装配体中的使用数量4材料零件的材质信息6061铝合金重量单件重量kg1.25备注工艺或采购特殊要求表面阳极氧化1.2 单级BOM与多级BOM单级BOM仅列出直接组成父装配体的下一级零件不展开子装配体。适用于简单产品或只需采购层级的场景。多级BOM将装配体完全展开到最底层的不可拆零件显示完整的层级关系。这是制造BOM的标准形式。1.3 BOM表与明细栏的关系在工程图纸中“明细栏”通常指图纸右下角的零件列表表格而“BOM表”则是更广义的物料清单概念可以存在于图纸、Excel文件或PDM系统中。本文中我们统一使用“BOM表”来指代结构化的物料清单数据而“明细栏”则特指图纸表格中的呈现形式。2. 自定义属性的设计与映射策略2.1 为什么需要自定义属性SolidWorks等CAD软件的标准文件属性如文件名、文件大小远不能满足BOM表的需求。企业通常需要为每个零件定义以下自定义属性PartNo零件图号Description描述Material材料需与材质库关联Weight重量由模型计算SurfaceTreatment表面处理Supplier供应商2.2 属性命名规范策略为了避免混乱建议采用以下命名策略方案一全大写下划线推荐PART_NO, DESCRIPTION, MATERIAL, WEIGHT_KG方案二驼峰命名PartNo, Description, Material, Weight方案三中文命名不推荐用于系统间交互图号, 名称, 材料, 重量关键原则同一企业内必须统一命名规范且属性名不能包含空格和特殊字符。2.3 属性值的自动填充以下SolidWorks VBA脚本演示了如何为当前打开的零件自动填充自定义属性 SolidWorks VBA宏自动填充自定义属性 功能从模型配置中提取材料、重量并写入自定义属性 Option Explicit Sub AutoFillCustomProperties() Dim swApp As SldWorks.SldWorks Dim swModel As SldWorks.ModelDoc2 Dim swCustPrpMgr As SldWorks.CustomPropertyManager Dim swConf As SldWorks.Configuration Dim confName As String Dim materialName As String Dim weight As Double 初始化SolidWorks应用 Set swApp Application.SldWorks Set swModel swApp.ActiveDoc If swModel Is Nothing Then MsgBox 请先打开一个零件或装配体 Exit Sub End If 获取当前激活的配置 Set swConf swModel.GetActiveConfiguration confName swConf.Name 获取自定义属性管理器 Set swCustPrpMgr swModel.Extension.CustomPropertyManager(confName) 获取材料名称 materialName swConf.GetMaterialPropertyName(1) 1材质名称 If Len(materialName) 0 Then 写入自定义属性 swCustPrpMgr.Add2 Material, swCustomInfoText, materialName End If 获取重量需要先计算质量属性 Dim swMassProp As SldWorks.MassProperty Set swMassProp swModel.Extension.CreateMassProperty2(swMassPropertyCombine_None, False) If Not swMassProp Is Nothing Then weight swMassProp.Mass 写入重量保留3位小数 swCustPrpMgr.Add2 Weight_kg, swCustomInfoText, Format(weight, 0.000) End If 写入默认值可根据需要修改 swCustPrpMgr.Add2 PartNo, swCustomInfoText, swModel.GetTitle swCustPrpMgr.Add2 Description, swCustomInfoText, 待完善描述 MsgBox 自定义属性填充完成 End Sub3. 从装配体自动生成零件清单3.1 遍历装配体树形结构生成BOM表的核心是递归遍历装配体的所有子节点。以下C#代码使用SolidWorks API实现了完整的递归遍历并提取每个零件的自定义属性usingSystem;usingSystem.Collections.Generic;usingSolidWorks.Interop.sldworks;usingSolidWorks.Interop.swconst;namespaceBOMGenerator{/// summary/// BOM表生成器 - 递归遍历装配体/// /summarypublicclassBomGenerator{privateSldWorksswApp;privateListBomItembomItems;privateintcurrentLevel;publicBomGenerator(){swAppnewSldWorks();bomItemsnewListBomItem();}/// summary/// 从装配体生成BOM表/// /summarypublicListBomItemGenerateBom(stringassemblyPath){bomItems.Clear();currentLevel0;ModelDoc2swModelswApp.OpenDoc(assemblyPath,(int)swDocumentTypes_e.swDocASSEMBLY);if(swModelnull){thrownewException(无法打开装配体文件);}AssemblyDocswAssembly(AssemblyDoc)swModel;TraverseAssembly(swAssembly,null,1);swApp.CloseDoc(assemblyPath);returnbomItems;}/// summary/// 递归遍历装配体/// /summaryprivatevoidTraverseAssembly(AssemblyDocassembly,stringparentPath,intquantity){object[]children(object[])assembly.GetComponents(false);if(childrennull)return;foreach(objectchildinchildren){Component2swComp(Component2)child;stringcompNameswComp.Name2;stringpathNameswComp.GetPathName();// 跳过虚拟组件和轻化组件if(string.IsNullOrEmpty(pathName))continue;// 提取自定义属性ModelDoc2swChildModelswComp.GetModelDoc2();if(swChildModelnull)continue;BomItemitemExtractBomItem(swChildModel,swComp,currentLevel);bomItems.Add(item);// 如果是子装配体递归遍历if(swComp.GetModelDoc2().GetType()(int)swDocumentTypes_e.swDocASSEMBLY){// 打开子装配体AssemblyDocsubAssembly(AssemblyDoc)swApp.OpenDoc(pathName,(int)swDocumentTypes_e.swDocASSEMBLY);if(subAssembly!null){currentLevel;TraverseAssembly(subAssembly,compName,item.Quantity);currentLevel--;swApp.CloseDoc(pathName);}}}}/// summary/// 从模型提取BOM项信息/// /summaryprivateBomItemExtractBomItem(ModelDoc2model,Component2component,intlevel){BomItemitemnewBomItem();item.Levellevel;item.ComponentNamecomponent.Name2;item.Quantity(int)component.GetTotalCount();// 读取自定义属性stringconfNamemodel.GetActiveConfiguration().Name;CustomPropertyManagerpropMgrmodel.Extension.CustomPropertyManager(confName);item.PartNoGetCustomProperty(propMgr,PartNo);item.DescriptionGetCustomProperty(propMgr,Description);item.MaterialGetCustomProperty(propMgr,Material);item.WeightGetCustomProperty(propMgr,Weight_kg);item.SurfaceTreatmentGetCustomProperty(propMgr,SurfaceTreatment);returnitem;}privatestringGetCustomProperty(CustomPropertyManagerpropMgr,stringpropName){objectvaluenull;boolresolvedfalse;propMgr.Get5(propName,false,outresolved,outvalue);returnvalue?.ToString()??;}}/// summary/// BOM表条目数据结构/// /summarypublicclassBomItem{publicintLevel{get;set;}publicstringComponentName{get;set;}publicstringPartNo{get;set;}publicstringDescription{get;set;}publicstringMaterial{get;set;}publicstringWeight{get;set;}publicstringSurfaceTreatment{get;set;}publicintQuantity{get;set;}}}3.2 输出为Excel表格生成BOM列表后需要输出为结构化表格。以下代码使用EPPlus库将BOM数据写入ExcelusingOfficeOpenXml;usingSystem.IO;publicvoidExportToExcel(ListBomItemitems,stringoutputPath){ExcelPackage.LicenseContextLicenseContext.NonCommercial;using(varpackagenewExcelPackage()){varworksheetpackage.Workbook.Worksheets.Add(BOM表);// 设置表头string[]headers{层级,组件名称,图号,描述,材料,重量(kg),表面处理,数量};for(inti0;iheaders.Length;i){worksheet.Cells[1,i1].Valueheaders[i];worksheet.Cells[1,i1].Style.Font.Boldtrue;}// 填充数据introw2;foreach(variteminitems){worksheet.Cells[row,1].Valueitem.Level;worksheet.Cells[row,2].Valueitem.ComponentName;worksheet.Cells[row,3].Valueitem.PartNo;worksheet.Cells[row,4].Valueitem.Description;worksheet.Cells[row,5].Valueitem.Material;worksheet.Cells[row,6].Valueitem.Weight;worksheet.Cells[row,7].Valueitem.SurfaceTreatment;worksheet.Cells[row,8].Valueitem.Quantity;row;}// 自动调整列宽worksheet.Cells.AutoFitColumns();// 保存文件FileInfofilenewFileInfo(outputPath);package.SaveAs(file);}}4. 材料统计与成本核算4.1 材料分类统计算法在BOM表基础上我们需要对相同材料的零件进行汇总以便采购部门统一采购。以下算法实现了材料维度的统计# Python脚本BOM材料统计与汇总# 输入BOM表CSV文件# 输出材料统计汇总表importpandasaspdimportnumpyasnpdefmaterial_statistics(bom_csv_path): 对BOM表进行材料统计 # 读取BOM表dfpd.read_csv(bom_csv_path)# 计算总重量数量 * 单件重量df[总重量_kg]df[数量]*pd.to_numeric(df[重量],errorscoerce).fillna(0)# 按材料分组统计material_statsdf.groupby(材料).agg({数量:sum,总重量_kg:sum,图号:lambdax:, .join(x.unique())# 列出所有涉及的图号}).reset_index()# 添加成本估算假设每公斤材料成本material_cost{6061铝合金:30,# 元/kg45钢:8,304不锈钢:25,聚甲醛(POM):15}material_stats[单价_元/kg]material_stats[材料].map(material_cost).fillna(10)material_stats[预估成本_元]material_stats[总重量_kg]*material_stats[单价_元/kg]# 排序按总重量降序material_statsmaterial_stats.sort_values(总重量_kg,ascendingFalse)returnmaterial_stats# 使用示例if__name____main__:statsmaterial_statistics(bom_output.csv)stats.to_csv(material_statistics.csv,indexFalse)print(材料统计完成结果已保存到 material_statistics.csv)4.2 重量计算与精度控制在SolidWorks中重量计算需要特别注意材料密度必须在模型中正确设置材质否则重量为0单位统一SolidWorks默认单位为克gBOM表中通常使用千克kg精度控制建议保留3-4位小数避免累积误差以下VBA代码展示了如何获取精确的重量值 获取精确重量带单位转换 Function GetPreciseWeight(swModel As ModelDoc2) As Double Dim swMassProp As MassProperty Dim weightGrams As Double 计算质量属性高精度模式 Set swMassProp swModel.Extension.CreateMassProperty2( _ swMassPropertyCombine_None, True) True使用高精度 If Not swMassProp Is Nothing Then weightGrams swMassProp.Mass 单位克 转换为千克 GetPreciseWeight weightGrams / 1000 Else GetPreciseWeight 0 End If End Function5. 高级功能多级BOM展开与差异对比5.1 多级BOM的扁平化处理对于复杂装配体多级BOM需要展开为扁平结构同时保留层级信息。以下算法实现了标准的“缩进式”BOM输出/// summary/// 生成缩进式多级BOM/// /summarypublicvoidGenerateIndentedBOM(ListBomItemflatBom,stringoutputPath){using(StreamWriterwriternewStreamWriter(outputPath)){// 写入表头writer.WriteLine(层级\t图号\t名称\t材料\t数量\t重量(kg));// 按层级排序varsortedBomflatBom.OrderBy(xx.Level).ThenBy(xx.ComponentName);foreach(variteminsortedBom){// 根据层级生成缩进stringindentnewstring(-,item.Level*2);stringline${item.Level}\t{indent}{item.PartNo}\t{item.Description}\t${item.Material}\t{item.Quantity}\t{item.Weight};writer.WriteLine(line);}}}5.2 BOM版本差异对比在实际工程中经常需要比较两个版本BOM的差异。以下算法实现了基于图号的差异检测defcompare_bom_versions(bom_old_path,bom_new_path): 比较两个版本BOM的差异 返回新增零件、删除零件、数量变化零件 old_dfpd.read_csv(bom_old_path)new_dfpd.read_csv(bom_new_path)old_partsset(old_df[图号])new_partsset(new_df[图号])# 新增的零件addednew_parts-old_parts# 删除的零件removedold_parts-new_parts# 数量变化的零件图号都存在但数量不同old_dictdict(zip(old_df[图号],old_df[数量]))new_dictdict(zip(new_df[图号],new_df[数量]))