SuperAPI AI 工具集

tia-multiuser

部署与运维

查看项目

更新于 10-15 20:30

技能介绍

用途:该技能面向 TIA Portal 多用户工程(Multiuser Engineering)工作流,基于 TIA Portal Openness API,覆盖本地会话(Local Sessions)、服务器项目(Server Projects)与多用户调试(Multiuser Commissioning)。

主要能力:通过 tiaPortal.ProjectServers 与 tiaPortal.LocalSessions 两个组合根操作。可从 ProjectServers 按精确别名解析项目服务器连接,用 ProjectServer.GetServerProjects() 解析返回的 ServerProjectInfo,创建 LocalSessionInfo 并通过 LocalSessions 打开。会话支持 LocalSession.Save()、Close()、IsUptoDate()、MarkingService,以及仅在受支持的服务器/独占会话下使用的 CloseAndCommit(comment)。

参考文件:references/v21-api-surface.md 提供 Siemens.Engineering.Multiuser 类型的完整已安装接口面;references/workflows-and-safety.md 提供 V21 根、项目服务器/会话工作流、标记、锁定、保存/关闭/提交语义与远程写入门控。仅加载与任务相关的参考文件。

使用限制与安全要求:创建/删除连接或会话、添加项目、更改主机/协议/端口、保存、丢弃式关闭或提交服务器修订前,必须获得明确的远程写入授权。必须精确解析服务器别名、项目、组、会话 ID/路径与目标模式,禁止使用 .First() 或 [0]。变更前需检查服务器锁定状态、会话新鲜度、标记/冲突、活动用户及路径/版本前提。签入/更新前须停止活动的监控或强制作业;不可标记的编辑在调试工作流中可能丢失。Close() 会丢弃待处理更改,CloseAndCommit() 执行远程提交并返回创建的修订,二者均不可无条件当作清理调用。未明确要求时不得保存或提交;未读取返回的修订/当前服务器状态前,不得声称远程操作成功。

适用场景:需要以编程方式管理 TIA Portal 多用户服务器项目、本地会话及调试签入/提交的自动化任务。