PDMS二次开发应用案例——PipelineTool

一、概述

1.1 Pipeline 是什么

Pipeline 是一个PDMS插件，实现了些简单的批处理功能，包括：出材料表/螺栓表、目录树顺序检查、汇料属性设置、焊口自动处理等。我进入PDMS二次开发这个领域的初衷是为了做Naki.CI编码工具，为我的材料管理系统提供带编码的材料表，但是因为之前没有接触过PDMS开发，所以打算先做一个helloworld练练手，这个helloworld后来一步一步演化成了今天的Pipeline。

1.2 最新版下载地址

Pipeline版本号	适配PDMS/E3D版本	链接	提取码
1.0.2.0	E3D 2.10	https://pan.baidu.com/s/17xnlRprcakwiuSW7xR8b3g	8e6d
1.0.3.1	E3D 3.1.7	关注公众号回复下载获取下载地址	输入：“下载”（不要引号）
1.0.3.1	PDMS 12.1.sp4	关注公众号回复下载获取下载地址	输入：“下载”（不要引号）
1.0.0.6	PDMS 12.1.sp2	https://pan.baidu.com/s/144U2i9WVOvqz-4nd93QIGg	un3t
0.9.5.0	PDMS 12.0.sp6	https://pan.baidu.com/s/11CWL8D09k_LRgx0fom72Yw	16u7

备注：
Pipeline于2021年10月国庆假期将版本号正式更新为1.0.0.0。
适配PDMS 12.0.sp6 的版本从0.9.4.3开始不再维护。
适配PDMS 12.0.sp6 的版本于2022年6月23日更新到0.9.5.0，仅增加了自动调整ATTA顺序功能。
目前最新版本是1.0.3.1

1.3 用户手册*

安装好后可以在菜单中点击：帮助-声明与用户协议，使用前请阅读《声明与用户协议》。

为了便于及时补充和订正内容，用户手册不再以文档形式随软件提供，用户手册的唯一出处是本博客。

本说明中部分截图可能是旧版本的截图，一般情况下不影响对软件功能的理解，所有界面以最新版本的软件界面为准。

PDMS Pipeline Tool 教程（一）：安装说明
PDMS Pipeline Tool 教程（二）：通用功能
PDMS Pipeline Tool 教程（三）：材料表
PDMS Pipeline Tool 教程（四）：目录树顺序检
PDMS Pipeline Tool 教程（五）：汇料属性设置
PDMS Pipeline Tool 教程（六）：选项设置
PDMS Pipeline Tool 教程（七）：错误代码
PDMS Pipeline Tool 教程（八）：E3D的安装和测试
PDMS Pipeline Tool 教程（九）：自动插入焊口和计算焊接当量（达因数）

与螺栓材料表有关专题
PDMS二次开发（十）——螺栓材料统计功能重构开发介绍
PDMS二次开发（十一）——螺栓材料统计功能有一批bug修复的说明
PDMS二次开发（二十一）——关于Pipeline工具生成螺栓材料表的计算思路

1.4 问题汇总

Q1 Pipeline是免费使用的吗？

免费使用，使用前请先阅读用户协议。

Q2 在哪了解更多关于Pipeline的细节介绍？

可以检索或者订阅我的专栏《数字工厂的学习和研究》这里有关于Pipeline工具的全部文章，包括：操作说明、版本升级介绍和功能细节讲解。该专栏也包含我的其它PDMS开发成果。

Q3 没有支持的PDMS的版本？

为了便于发布程序的维护，Pipeline以后只发布PDMS12.1.sp4的版本，如果需要兼容其它版本PDMS的Pipeline工具，可以发邮件来获取。

Q4 如果发现bug或者有其它建议？

直接发邮件，带上报错截图、PDMS命令行窗口的错误提示信息和log日志中的错误记录。

Q5 使用过程中遇到问题的解决方法

可以在这里列出的问题清单里查找以便快速解决：
PDMS二次开发（十七）——关于Pipeline安装/使用时遇到的问题（集合一）

1. 安装时提示:E10001未能找到路径
2. 菜单配置用的uic文件缺失/不会自动创建，导致程序启动时加载插件报错
3. 材料表可以预览，导出时报错
4. 材料表选无模板时可以导出，但是选标准模板时导出报错

如果不会安装可以远程协助安装，提前约时间即可。

二、功能介绍

2.1 基础功能

1. 目录树特定类型对象添加到列表控件和删除；
2. 选择列表中的节点对象并在目录树中定位；
3. PIPE、BRAN、COMPONMENT三级树形结构的遍历、节点类型判断、属性值读取和写入；
4. 通过txt文件另存和读取管线列表，实现工作对象范围的存储功能；
5. 通过log文件记录错误和提示信息，实现日志功能；
6. 通过xml文件加载和存储参数信息，实现用户差异化设置功能；
7. 如果xml配置文件丢失或者被破坏，可以一键重置；
8. List增加了右键菜单功能，验证了界面的可扩展性；
9. 增加了对框选的元件进行捕捉并添加所属的管线到List列表；

2.2 材料表

1. 单线材料表、综合材料表、螺栓表计算、预览和导出，增加了按Excel格式模板生成套表功能；
2. 在材料表计算中增加Material Control属性值的判断，让对该属性在汇料时发挥作用，设置为DOTD值的材料不会汇料；
3. 改进对FTUBE类型材料的处理计算方法，找到了按长度和件数两种方式计算FTUBE材料量的方法，目前采用的按件数计算的办法；

2.3 目录树顺序检查

1. 目录树元件顺序错误检查，连接点坐标系计算显示、检查结果集导出报表；
2. 目录树ATTA顺序检查、偏离检查；
3. 目录树ATTA自动调整顺序功能。

2.4 汇料属性DOTD设置

1. Material Control属性值（MTOC、MTOT、MTOH）管理，可以实现六种批处理：全部材料虚、全部材料取消虚、只虚仪表、虚仪表+配对法兰垫片、取消虚仪表、只虚管嘴配对法兰垫片（可以只虚头或尾或同时虚）、取消虚管嘴配对法兰垫片；

2.5 焊口自动化处理

1. 新增批量自动添加、移除焊口功能；
2. 自动添加焊口后返回焊口清单，同时可以实现导出为Excel报表；
3. 根据焊口数据自动计算焊接当量（达因数）；
4. 根据壁厚自动调整系数K；
5. 根据焊口连接的元件智能判断焊口类型，方便用户换算达因量的时候按需求分别乘不同的系数，目前支持类型包括：普通对焊、普通承插焊、假三通开孔、鞍座/凸台支管口承插焊、鞍座/凸台与主管开孔处的对焊；
6. 螺纹接口也按承插焊计算；
7. 在焊口预览窗口双击某个焊口（数据行），在目录树中自动定位到该元件。

2.6 管子虚线检查

1. 检查管子的模型是否为虚线；
2. 批量设置ATTA的Spkbrk属性；

三、软件更新日志

1.0.3.1版（发布时间：2023.9.4）

1. 重构了自动添加焊口功能，修复了原来计算方法里的多个bug。
2. 在添加焊口之前先清除当前branch已有焊口；
3. 显示清除焊口的个数和添加焊口的个数；
4. 更新致谢名单。

1.0.2.0版（发布时间：2022.6.23）

1. 新增了ATTA材料表。
2. 新增了ATTA自动调整目录树顺序功能；
3. 修复了ATTA顺序算法的一处bug，该bug导致少数元件原本处于正确顺序位置却被计算为越过上游元件；
4. PDMS12.0.sp6增加了ATTA自动调整目录树顺序功能，版本升级到0.9.5.0；
5. E3D2.1的pipeline工具已升级到1.0.2.0版。

PDMS二次开发（二十）——关于1.0.2.0版本升级内容的说明

1.0.1.0版（发布时间：2022.4.20）

1. 新增了一个虚线管线检查模块，可以批量检查管子的虚线状态。
2. 批量设置ATTA的Spkbrk属性；

1.0.0.7版（发布时间：2022.3.16）

4. 修复了一处bug，该bug导致AutoWeld模块有时出现：管子末端在没有连接关系的状态下，多加一道焊口，可能导致多计算焊口达因和多编号；
5. E3D版本同步升级到1.0.0.7。

1.0.0.6版（发布时间：2022.3.3）

1. 增加了一个是否启用支持参数化描述的开关，当关闭该功能的时候，出MTO速度更快；因为参数化查询短期内可能没有突破性进展，为了不影响非参数化描述材料表功能，增加了此项功能；
2. 对MTO参数化描述的支持功能仍然在征集测试反馈意见中，如果你有什么元件出材料描述不对可以把元件导出txt发给我研究一下，我这里缺少数据样本；
3. 计划下一步完善CI工具，通过CI+Pipeline工具联合应用来实现更加灵活有效的材料描述管理方案；
4. E3D和PDMS12.1.sp2版本同步更新到最新版。

1.0.0.5 beta fix2版（发布时间：2022.2.23）

3. 根据大家反馈的意见，对MTO参数化描述的支持功能做了第一版优化，继续征集测试反馈意见中。

1.0.0.5 beta版（发布时间：2022.2.20）

1. 新增了对MTO参数化描述的支持，该版本是测试版，征集测试反馈意见中。

1.0.0.4版（发布时间：2022.1.26）

1. 新增了“控制在超过6M的直管段是否按每6M创建一个直管段焊口”的功能。
   控制直管段焊口的选项功能演示视频

1.0.0.3版（发布时间：2021.12.15）

1. 改为按skey判断带支管元件类型，使元件类型判断更加准确和通用；
2. 改为按P3点的pbore获取支管口径，使元件支管口径值计算更加准确；
3. 修复了一处bug，该bug导致在少数情况下显示焊口结果数据集时，焊口编号排序不正确；
4. 修复了一处bug，该bug导致在PIPE的等级中没有WELD元件时报错；
5. E3D同步更新到1.0.0.3版本。

1.0.0.2版（发布时间：2021.12.6）

1. 修复一个bug，该bug导致鞍座和半管接头与主管焊接处的焊口没有被计入，由于模型连接的原因这个焊口（的模型）只能垂直于鞍座，达因量计算时按支管口径计算，使偏差量最小；
2. 新增了一种焊口类型（BW.OLET）表示上述焊口，便于筛选统计；
3. 焊口预览弹窗中增加了双击快速定位到焊口的功能，增加了一个附图说明BW.OLET和SW.OLET的区别；
4. 修复了一个bug，该bug导致当PIPE没有设置等级（PSpec）时，在批量加焊口时报错退出，现在会在commandline窗口中显示错误信息，并跳过该管线（PIPE）；
5. E3D同步更新到1.0.0.2版本。

本次修改的部分内容在:《PDMS二次开发（十四）——自动插入焊口和计算焊接当量（达因数）》，中予以补充说明。

1.0.0.1版（发布时间：2021.10.16）

1. 修改了一处bug，该bug导致添加承插焊口时，将branch的尾部的最后一个焊口（如果尾部是焊口的话）创建到了branch的头部（这个bug在PDMS里没有测出来，到E3D里面测出来的）；
2. 螺栓MTO材料表以前做的时候材料编码这一列没有填数据，在热心用户的“鞭策”下加好了；
3. 修复一个bug，螺栓数量求和操作时，没有将PartNumber放在分项判断中，导致材料量重复计算；
4. 增加了一个导出MTO的设置项：是否按等级分项；
5. 增加了一个感谢窗口，对过去资助过该项目的热心用户表示感谢；
6. E3D同步更新到1.0.0.1版本；

1.0.0.0版（发布时间：2021.10.3）

1. 改进自动添加焊口功能，增加了承插焊口和假三通开孔焊口；
2. 根据焊口连接的元件智能判断焊口类型，方便用户换算达因量的时候按需求分别乘不同的系数，目前支持类型包括：普通对焊、普通承插焊、假三通开孔、鞍座/凸台类承插焊；
3. 螺纹接口也按承插焊计算。
4. 焊口预览窗口增加了部分说明性文字，方便查阅计算规则。
5. 因为软著证书已经申请下来，为了与软著证书版本匹配，版本号正式更新为1.0.0.0。

点击链接:《PDMS二次开发（十八）——关于1.0.0.0版本升级内容的说明（让我们告一段落吧）》，了解本次修改的细节。

0.9.5.4版（发布时间：2021.9.20）

1. 修复了一处bug，该bug导致：鞍座或者开孔类型元件也在主管道方向创建了进出两端的焊口，这个焊口是多余的不应该存在；
2. 修复了一处bug，该bug导致：没有元件的空管线在批量生成焊口时报错；
3. 针对材料表导出Excel报错，优化了错误捕捉逻辑，避免程序崩溃，并弹出提示框引导用户下载所缺插件。

0.9.5.3版（发布时间：2021.9.14）

1. 修复了一处bug，该bug导致：如果支管口起点或终点连接了另一根支管的三通元件（其它带支管口的元件也有相同问题）的支口，则会在起点支口遗漏了第一个weld，或在终点支口遗漏最后一个weld；
2. 修改了全部图标，为了让pipeline走的更远，全部替换为自己画的图标；
3. 修改了《声明与用户协议》；
4. E3D版本完成同步更新（9月16日补充）。

点击链接:《PDMS二次开发（十六）——关于0.9.5.3版本升级内容的说明》，了解本次修改的细节。

0.9.5.2版（发布时间：2021.7.6）

1. 修复了一处bug，该bug导致当第一个元件是对焊管件时，元件与第一个直管段之间的焊口被遗漏；
2. E3D版工具同步更新到0.9.5.2版；
3. 更新了关于本次修复的bug相关说明和E3D功能示例截图，详见文章《十五》。

点击链接:《PDMS二次开发（十五）——关于0.9.5.2版本升级内容的说明》，了解本次修改的细节。

0.9.5.1版（发布时间：2021.7.4）

1. 重构了达因数计算方法；
2. 增加了达因数计算结果回看功能；
3. 增加了焊口类别区分，将直管段超出6m后自动切割形成的焊口高亮显示
4. 更新了关于达因数计算方法的若干说明，详见文章《十四》。

0.9.5.0版（发布时间：2021.6.30）

1. 新增批量自动添加、移除焊口功能；
2. 自动添加焊口后返回焊口清单，同时可以实现导出为Excel报表；
3. 根据焊口数据自动计算焊接当量（达因数）。

点击链接:《PDMS二次开发（十四）——自动插入焊口和计算焊接当量（达因数）》，了解本次修改的细节。

0.9.4.4版（发布时间：2021.6.9）

1. PipelineTool适配E3D；
2. 对E3D的Sample项目数据进行了测试，重点测试了MTO功能；
3. 优化了螺栓长度圆整策略；
4. 优化了安全阀出入口计算方法；
5. 修复了当管段尾部接Nozz时，法兰厚度和螺栓个数计算错误的bug。

点击链接:《PDMS二次开发（十三）——Pipeline Tool升级到E3D版本》，了解本次修改的细节。

0.9.4.3版（发布时间：2021.5.4）

1. 修复了bug：当MTO汇料排序时，如果SIZE1或者SIZE2出现非数字型字符导致字符转Decimal失败引发异常；
2. 修改了《声明和用户协议的部分内容》，删除了一些啰嗦的话；
3. 修改了NPOI和Apache License2.0的引用链接。；

0.9.4.2版（发布时间：2021.4.16）

1. MTO材料表修改为按GTYPE和SIZE1/SIZE2排序；
2. 设置全部元件DOTD时，包括了ATTA元件类型；
3. 新增了单独设置ATTA类型元件的DOTD属性值的功能；

0.9.4.1版（发布时间：2021.4.13）

7. 更换了Excel组件；
8. 增加了《声明和用户协议》；
9. 增加了引用组件的声明；
10. 增加了遵循开源协议的声明；
11. 为了便于维护，以后每次只发布12.1.sp4版本，如需其它版本，发邮件联系。

0.9.4版补充（发布时间：2021.3.25）

1. 上一版更新时因为修改了custom.xml，忘记修改重置用户配置文件，导致重置的还是旧版本custom.xml，本次修复了这个bug，但是版本号就不修改了；
2. 增加了对应PDMS 12.0.sp6和12.1.sp2两个版本。

0.9.4版（发布时间：2021.3.21）

1. 修复了材料表口径对应直管段的口径计算bug，该bug可能导致在少数情况下将异径管件的大口径端的直管口径误计算成了异径管件小口径端的尺寸；
2. 修改了螺栓数量汇总计算方法，增加了对一个元件（例如安全阀）有两个螺栓集的判断和处理；
3. 修复了一个对材质属性的判断的bug，该bug会使一些可以不设置材质的元件被误报错误导致材料在统计时被漏掉；
4. 修改了查询主方法，增加了对gtype口径策略参数的判断处理；
5. 调整了出材料表时的范围策略，增加了部分原本不出材料表的元件类型（INST）；
6. 修复了对螺栓BTSE属性的判断bug，该Bug会导致计算螺栓个数时，以no of identical bolts方式做的螺栓没有被计算，从而遗漏了螺栓个数；
7. 取消了对仪表、特殊件、阀门三类元件的螺栓集参数检查，该检查用于判断螺栓数量是否减半；
8. 增加了对螺栓集与arrive口和leave口对应关系的判断处理，智能匹配异径管件类端口应对应的螺栓集；
9. 增加了对螺栓集属性的规范检查，螺栓个数设置为0的螺栓不计入材料表，设置为负数报错提示；
10. 出MTO时，数量在四舍五入后=0的材料项不计入MTO数据集；
11. 修复了获取螺栓长度表时不能判断用户自定义螺栓长度表的限制，计算螺栓长度时会按照用户设置的螺栓长度表寻找对应长度；
12. 升级了用户配置文件，增加GTYPE的单/双口径策略设置参数和启动功能模块设置参数；
13. 增加了软件启动时默认打开模块设置功能;
14. 修改和补充了错误代码，并完善了相关报错日志功能；
15. 材料表预览窗口改为可以手动调整，方便查看大数据量结果；
16. 简化了关于窗口，踏踏实实，不作妖；
17. 修订了用户手册。

点击链接:《PDMS二次开发（十一）——螺栓材料统计功能有一批bug修复的说明》，了解本次修改的细节。

0.9.3.4版（发布时间：2020.11.19）

1. 目录树检查结果弹出窗口允许以拖动方式改变窗体大小；
2. 所有弹框改为单实例模式，不会重复显示相同的弹框；
3. 所有弹框改为默认置于最顶层，焦点不在窗体上时，窗体依然保持在最顶层；
4. 重新做了一个比较作的关于对话框；
5. 同步适配12.0.sp6的版本0.8.5.3。

0.9.3.3版（发布时间：2020.11.10）

1. 修复了对夹元件的连接面形式判断逻辑漏洞；
2. 修改了用户设置界面的样式和控件处理逻辑；
3. 如果没有设置属于法兰连接面形式的COCO代码，则系统默认初始值为FBB和FBD；
4. 如果设置了法兰连接面形式的COCO代码，则系统默认同时设置了对应的对夹连接形式；

【补充说明】

1. 例如设置法兰连接形式FBB，系统默认将对夹类型的法兰连接形式WFBB纳入判断，无需专门设置对夹类型的连接形式，设置了反而会出错；
2. 默认对夹型连接形式命名方式为首字母是W；
3. 0.9.3.3版已经在8月8日发布，微信公号没有发布更新文章，12.0版本也没有适配；11月10日适配了12.0版本后重新修订了0.9.3.3的发布信息。

---

0.9.3.2版（发布时间：2020.08.05）

1. 优化了错误信息的检查和提示功能；
2. 增加了连接形式（法兰面）设置功能；
3. 增加了报错是否终止程序的设置功能。

---

0.9.3版（发布时间：2020.07.13）

1. 重构了螺栓数据导出功能
2. 修订了操作说明，增加了关于螺栓材料表验证策略的说明。

点击链接:《PDMS二次开发（十）——螺栓材料统计功能重构开发介绍》，了解计算螺栓MTO的细节。

---

0.9.2版（发布时间：2020.06.09）

1. 修复了异径管件支管口径计算错误的问题；
2. 修复了螺栓材料出材料表时，材料描述不正确和螺母垫圈配件缺失的问题；
3. 优化了对检查结果类型为警告的判断，可以显示是侵入上游还是下游的管件；
4. 重构了部分目录树顺序检查判断逻辑，提高了判断准确性；
5. 增加了快捷定位，双击预览窗口内的元件项可以直接定位到元件；
6. 增加了输出设置，可以选择显示全部错误和警告，也可以仅显示警告，或者其他显示策略；
7. 修订了操作说明。

点击链接:《PDMS二次开发（九）——关于0.9.2版本升级内容的说明》，了解更多本次升版的细节。
【6月23日补记:】补充测试发现螺栓的数量和长度计算与ISO出图不一致，查手册原来新螺栓计算方法长度是计算出来的，还有对夹类型的元件的特殊计算方法没有考虑，我感觉整个螺栓的计算方法要重构，暂定目标是跟ISO出图一致。
【7月13日更新:】该问题已在0.9.3版本修复。

---

0.9.1版（发布时间：2020.05.29）

1. 修复了材料表导出时如果螺栓数据为空时，会报空值异常的错误；
2. 修复了部分MTO功能报错时，直接导致 PDMS 程序崩溃退出的错误；
3. 更换了一套尺寸更小的图标；

---

0.9.0版（发布时间：2020.03.17）

1. 适配PDMS12.1.SP4；
2. 图形快捷菜单条去掉了按钮名称显示，并缩小了图标；
3. 主菜单增加了功能子菜单，用于切换对应的标签页子功能界面；
4. 标签页只显示当前可用的标签页；

点击链接:《PDMS二次开发（八）——向PDMS12.1版本迁移》，了解向12.1迁移的技术细节。

---

0.8.5.2版（发布时间：2020.11.10）

1. 同步更新到0.9.3.3版。

---

0.8.5版（发布时间：2020.07.21）

1. 同步更新到0.9.3版。

点击链接:《PDMS二次开发（十）——螺栓材料统计功能重构开发介绍》的章节：关于12.0.SP6版本的补充说明，了解12.1.SP4和12.0.SP6在螺栓材料处理过程中的不同之处。

---

0.8.4版（发布时间：2020.06.10）

1. 同步更新到0.9.2版。

---

0.8.3版（发布时间：2020.01.21）

1. 修复了ATTA元件类型目录树顺序检查功能中的一个bug，该bug导致部分在Branch头部或尾部的ATTA产生顺序不正确的误报；
2. 增加了Design Menu Bar，包括getwork、savework和unclaim all三个功能；并可以对是否开启Design Menu Bar快捷菜单栏进行用户自定义设置；
3. 增加了坐标计算精度设置功能，可以选择范围从0.1-0.0001（精确到小数点后一位——精确到小数点后四位）。

---

0.8.2版（发布时间：2019.12.24）

1. 新增了ATTA元件类型目录树顺序检查功能；
2. 新增了ATTA元件类型元件偏离管道中心线或连接点检查功能
3. 简化安装方法（详见安装说明）；
4. 修改了custom.xml配置文件预设值，新版本直接覆盖即可；

---

0.8.1版（发布时间：2019.12.8）

1. 修复了材料描述中带有单引号或者双引号时导出MTO报错的问题；
2. 增强了部分模块报错处理功能，便于查找软件BUG的原因。

---

0.8版（发布时间：2019.11.24）

1. 取消了数据库读写功能，不易推广使用
2. 增加了框选拾取功能
3. 增加了MTO按模板导出功能
4. 增加了释放所选管线功能
5. 增加了目录树检查的规则说明

---

了解更多信息请关注：