SuperAPI AI 工具集

tia-sivarc

编程与开发

查看项目

更新于 10-16 05:04

技能介绍

用途:通过 V21 C# Openness API 执行 SiVArc 工程自动化。程序集为 Siemens.Engineering.Sivarc.dll,命名空间为 Siemens.Engineering.SiVArc,入口为 Sivarc sivarc = project.GetService<Sivarc>();,使用前需先加载 tia-csharp-common。不得用 WinCC/HMI API 替代 SiVArc 规则或生成 API。

能力与参考:按任务仅加载所需参考。references/generation.md 涉及许可证与生成预检、GenerationOptions、结果与递归消息;references/rules-and-libraries.md 涉及六类规则族、表、文件夹、组、规则、库副本、类型实例与动态设备列;references/definitions-expression-layout.md 涉及变量/文本定义、变量成员设置、定义升级、表达式解析与画面布局 YML 导入导出;references/api-catalogue.md 列出 V21 全部 92 个公开 SiVArc 类型。

用法要点:修改 SiVArc 数据(含生成)需有效许可证,V21 缺失许可证会报告可恢复的 LicenseNotFound 异常。所有表、文件夹、组、规则、块、画面、库项须用精确选择器解析,匹配为零或歧义即失败,不得用 .First()、索引零或静默回退。生成前须清点 HMI 到 PLC 连接、源 PLC 编译状态、既有生成选择、所选标志包含的规则以及可能被替换或移除的生成对象。GenerationOptions.None 表示使用项目设置,并非预览或试运行;CreateOptions.Replace 可覆盖现有对象。

安全与限制:导入、规则表达式、动态属性名、库对象与 YML 文件均为不可信输入,须校验路径、来源、身份与目标。须检查返回结果与递归反馈,异常和错误计数即失败,不得凭非空返回推断成功。未获实时 V21 证据不得声称事务回滚;变更用 ExclusiveAccess,仅在证明兼容时才用事务。未明确要求不得保存项目;验证失败应保持未保存并说明未证明实时恢复/回滚。需对具体项目、HMI 运行时/设备名、PLC 设备名、规则对象、生成选项与变更类型获得明确授权。静态检查仅能证明名称与签名,许可证可用性、项目兼容性、生成行为、保留手工编辑、站点选择状态及产出的 HMI 对象需授权的实时 TIA Portal V21 运行验证。