用途:通过 TIA Portal V21 的 Teamcenter Gateway 完成与 Teamcenter 的连接、受管项目或库的搜索与下载、数据集锁定,以及保存/检入等工作流操作。
主要能力与入口:V21 API 按 provider 划分。门户范围的服务包括 TeamcenterConnectionProvider、TcGatewayLockProvider、TcGatewaySearchAndDownloadProvider,使用 tiaPortal.GetService<T>() 获取;保存工作流 provider 属于已打开的项目或全局库,使用 project.GetService<TcGatewayWorkflowProvider>() 获取,即 TcGatewayWorkflowProvider。
参考文件:references/workflows-and-safety.md 覆盖 provider 获取、凭据、连接归属、搜索下载、检出/检入、保存工作流、缓存覆盖与远程写入安全;references/v21-api-surface.md 为已安装 V21 类型与成员的完整表面。仅按任务加载相关文件。
安全与限制:需明确端点、Teamcenter 实例、用户/组/角色或 SSO 身份及预期条目/修订/数据集身份;密码用 SecureString,SessionToken 视为机密不得记录或序列化;检出、检入、取消检出、覆盖下载及所有保存/新建条目/新建修订操作需显式远程写入授权;LocalCacheOption.Overwrite 具破坏性,仅用于已精确清点的缓存目标;搜索结果须解析为唯一预期条目与修订,不得用 .First() 或 [0] 选择;仅在当前操作建立连接时于 finally 断开,不得终止调用方拥有的会话;取消检出不等于回滚,不丢弃本地更改;未检查返回结果或重读权威状态前不得声称保存、检入、下载或断开成功。
证据边界:已安装 V21 程序集与 XML 文档可证明 provider 名称、签名、类型和枚举成员;端点可达性、许可、凭据、权限、数据集锁、缓存行为与远程持久化需经授权的实时 Teamcenter Gateway 测试验证。具体安装命令、价格与平台要求暂未提供。