Aspen HYSYS 二次开发系列教程（3）：VBA 环境启用与第一个宏——默认禁用不是 bug

Aspen HYSYS 二次开发系列教程3VBA 环境启用与第一个宏——默认禁用不是 bug版本声明块软件aspenONE V15基线同第 1 篇文档现实Customization Guide V7.32011-03为公开手册基线语言/环境HYSYS 内置 VBAWindowsVBA support 默认禁用——启用前脚本无法运行铁律 4本文目标完成环境启用、跑通第一个宏并建立进程内 vs 进程外的能力边界认知一句话结论Aspen HYSYS 的 VBA support 默认禁用——必须 File→Options→VBA 勾选 Enable VBA support 后 Tools→VBA 才可用这不是安装缺陷而是默认状态铁律 4VBA 在进程内能访问 GUI 对象pywin32 在进程外只能走文档/数据对象——两条路线调用的是同一个 COM 服务器能力边界不同。〇、本篇要解决的认知问题VBA support 默认禁用时 Tools→VBA 是什么状态为什么很多人误判为安装坏了第一个宏的最小结构是什么——GetObject 与 CreateObject 的差别在哪个场景进程内VBA能做什么、进程外pywin32不能做什么——边界清单宏里的错误处理为什么比 Excel VBA 更麻烦COM 对象异常形态宏保存与分发有什么约束随 case 还是随全局一、机制解析1.1 启用路径与状态判定价值锚点这是新人第一道坎30 秒解决File → Options → VBA → ☑ Enable VBA support → OK Tools → VBA ← 启用后此菜单才可用判定标准练习用启用前 Tools→VBA 灰色/不可用启用后立即打开 Microsoft Visual Basic for Applications 编辑器——这个对照本身就是本篇的验收。1.2 GetObject vs CreateObject进程内语境CreateObject(“HYSYS.Application”)GetObject(, “HYSYS.Application”)语义新实例若已有实例可能新建连接已运行实例场景无 GUI 批处理、独立服务在 HYSYS 界面内操作当前会话风险多实例并存时对象挂错文档第 2 篇实例不存在时报错1.3 进程内 vs 进程外能力边界对照表能力VBA进程内pywin32进程外GUI 对象、对话框、页面导航✓✗只能走文档/数据对象独立部署成服务/定时任务✗依赖 HYSYS 环境✓异常粒度On Error 语句级try/except COM 错误对象第 14 篇适合场景单 case 快速自动化、报表联动系统集成、批量扫描、外层优化器1.4 宏保存与分发经验法则宏随环境走——分发时把启用步骤版本aspenONE V15对象名约定写进脚本头注释跨版本运行前用 dir()/对象浏览器自查属性名铁律 7。二、完整代码与逐行剖析2.1 第一个可运行宏复制即跑前提已启用 VBA supportSub FirstMacro() On Error GoTo Handler COM 对象异常必须显式处理第 14 篇 Dim app As Object, sim As Object, feed As Object Set app GetObject(, HYSYS.Application) 连接已运行实例1.2 Set sim app.ActiveDocument 单窗口场景可用多窗口用 Documents 遍历第 2 篇 Set feed sim.Flowsheet.MaterialStreamFlowsheetStreams.Item(Feed) 名称以本机为准铁律 7 feed.Temperature.Value 25 ℃——unit set 口径第 7 篇 feed.Pressure.Value 101.3 kPa Debug.Print T, feed.Temperature.Value, P, feed.Pressure.Value Exit Sub Handler: Debug.Print COM error:, Err.Description 现象→根因→解法三段式的现场版第 14 篇 End Sub逐行要点On Error GoTo Handler是 COM 自动化脚本的最小断言——把对象不支持属性与业务失败未收敛分开处理第 14 篇两类失败的分离原则。2.2 判定线本篇验收启用前后 Tools→VBA 状态对照记录宏输出与 GUI 读数一致相对误差 1e-6故意访问不存在属性触发 Handler——确认错误描述可读并存档。三、常见报错与排查Tools→VBA 不可用—— 根因默认禁用铁律 4。解法Options→VBA→Enable VBA support重启编辑器窗口生效与否以本机为准。GetObject 报对象不存在—— 根因无已运行实例1.2。解法先打开 HYSYS 或改用 CreateObject服务场景固定用 CreateObject显式绑定。宏在 A case 运行、结果写进 B case—— 根因ActiveDocument 随焦点变化第 2 篇机制。解法Documents 遍历显式绑定。跨版本属性名失效—— 现象V7.3 手册里的属性名在 V15 报错。根因手册现实版本声明块已声明。解法本机 dir() 自查未证实处标注以本机实测为准。四、动手练习启用与第一个宏按 2.1 完成。判定标准启用前后菜单状态对照存档宏输出与 GUI 一致 1e-6Handler 触发一次并记录错误文本。边界实验同一任务批量改 5 个流股温度分别用 VBA 和 pywin32 实现。判定标准两路径结果一致写出哪条能部署成定时服务的结论及依据1.3 表。思考题无标准答案为什么 COM 异常处理要分两类失败验证要点清单① 区分代码错误属性不存在与业务失败未收敛② 各给一个典型报错文本形态③ 说明把两者混在一个 try/except 里的后果假阳性进报表——第 14 篇。五、小结与下一篇预告本篇把 VBA 环境启用钉死为默认禁用不是 bug给出进程内/外能力边界表。下一篇 pywin32 最小脚本位数一致铁律铁律 3与 Dispatch 失败的第一性排查——之后第 5 篇进入属性读写的完整模式。本篇认知问题回显FAQQ1Aspen HYSYS 的 VBA support 默认是什么状态如何启用A默认禁用——须 File→Options→VBA 勾选 Enable VBA support之后 Tools→VBA 才可用这不是安装缺陷而是默认状态铁律 4。Q2CreateObject 和 GetObject 在 HYSYS 自动化里分别用于什么场景ACreateObject(“HYSYS.Application”) 创建新实例无 GUI 批处理/独立服务GetObject(, “HYSYS.Application”) 连接已运行实例界面内操作当前会话——实例不存在时 GetObject 报错。Q3VBA进程内和 pywin32进程外的能力边界分别是什么AVBA 在进程内可访问 GUI 对象与对话框但不能独立部署成服务pywin32 在进程外只能走文档/数据对象但可部署成 Windows 服务或定时任务异常处理粒度更好——两者调用同一个 COM 服务器。Q4HYSYS VBA 宏的错误处理为什么比 Excel VBA 更麻烦ACOM 对象异常属性不支持与业务失败求解未收敛是两类失败——前者靠 On Error/Handler后者必须检查运行状态混在一个 handler 里会把假阳性写进报表系列口径。Q5跨版本分发 HYSYS VBA 宏的最小注意事项是什么A脚本头注释写启用步骤、运行版本aspenONE V15与对象名约定属性名用本机 dir()/对象浏览器自查——V7.3 手册时代的名称在新版本可能不存在铁律 7。