tia-project-general

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

tia-project-general

Scope

适用范围

Project, portal, and project/global library lifecycle — full C# Openness implementation.

When the roadmap routes here, the entire solution is C#. Do not mix with Python wrapper calls. Always load

tia-csharp-common

first (done by roadmap).

项目、门户及项目/全局库的生命周期——完整的C# Openness实现。

当路线图指向此处时，整个解决方案采用C#实现。请勿与Python包装器调用混合使用。始终优先加载

tia-csharp-common

（由路线图自动完成）。

Reference files

参考文件

Load ONLY the reference file(s) relevant to the task. Do not load all files at once.

Reference file	When to use
`references/project-lifecycle.md`	Load when the task involves project-level lifecycle operations: Open, OpenWithUpgrade, Create, Save, SaveAs, Close, Archive, Retrieve, RetrieveWithUpgrade, delete, or copy.
`references/library-operations.md`	Load when the task involves project/global libraries, library folders, master copies, library types or versions, type instances, release/default/discard, update/harmonize/cleanup, or library comparison.
`references/project-attributes.md`	Load when the task involves reading project metadata (Author, Name, Version, Path, Size, dates), project history entries, used products, simulation/virtual PLC properties, or accessing the VCI service entry point.
`references/language-settings.md`	Load when the task involves project languages, active/editing/reference languages, multilingual text (MultilingualText, MultilingualTextItem), CommentML on devices, or VCI language import options.
`references/umac-and-auth.md`	Load when the task involves UMAC-protected project operations, UmacDelegate, Authentication events, ProjectOpenMode (Primary/Secondary), or UMAC user types.
`references/compile.md`	Load when the task involves compiling any object (PlcSoftware, HmiTarget, Device, CodeBlock, etc.) via ICompilable or reading CompilerResult.
`references/portal-settings.md`	Load when the task involves TiaPortalSettingsFolder (UI language, search index), ObjectIdentifierProvider, SystemDiagnostics settings export/import, or read-only project access.
`references/vci-management.md`	Load when the task involves managing VCI workspaces, workspace groups, creating user groups, or connecting/exporting objects to a VCI workspace.
`references/vci-operations.md`	Load when the task involves VCI mapped objects, synchronizing changes between project and workspace, or performing object comparisons.

For tasks spanning multiple areas, load all relevant reference files before generating code.

仅加载与任务相关的参考文件，请勿一次性加载所有文件。

参考文件	使用场景
`references/project-lifecycle.md`	当任务涉及项目级生命周期操作时加载：打开、升级打开、创建、保存、另存为、关闭、归档、恢复、升级恢复、删除或复制。
`references/library-operations.md`	当任务涉及项目/全局库、库文件夹、主副本、库类型或版本、类型实例、发布/默认/弃用、更新/协调/清理或库对比时加载。
`references/project-attributes.md`	当任务涉及读取项目元数据（作者、名称、版本、路径、大小、日期）、项目历史记录条目、已用产品、仿真/虚拟PLC属性或访问VCI服务入口点时加载。
`references/language-settings.md`	当任务涉及项目语言、活动/编辑/参考语言、多语言文本（MultilingualText、MultilingualTextItem）、设备上的CommentML或VCI语言导入选项时加载。
`references/umac-and-auth.md`	当任务涉及受UMAC保护的项目操作、UmacDelegate、认证事件、ProjectOpenMode（主/次）或UMAC用户类型时加载。
`references/compile.md`	当任务涉及通过ICompilable编译任何对象（PlcSoftware、HmiTarget、Device、CodeBlock等）或读取CompilerResult时加载。
`references/portal-settings.md`	当任务涉及TiaPortalSettingsFolder（UI语言、搜索索引）、ObjectIdentifierProvider、SystemDiagnostics设置导出/导入或只读项目访问时加载。
`references/vci-management.md`	当任务涉及管理VCI工作区、工作区组、创建用户组或连接/导出对象到VCI工作区时加载。
`references/vci-operations.md`	当任务涉及VCI映射对象、同步项目与工作区之间的变更或执行对象对比时加载。

若任务涉及多个领域，请在生成代码前加载所有相关参考文件。

Execution pattern

执行模式

Create or attach to
```
TiaPortal
```
instance (see
```
tia-csharp-common
```
)
Open, create, or retrieve
```
Project
```

Use

ExclusiveAccess

Transaction

where needed (see

tia-csharp-common

)

Perform project-level or library operations; require explicit authorization before any library/project mutation
Save / archive / close at the correct synchronisation point
Dispose the TIA Portal session

创建或连接到
```
TiaPortal
```
实例（详见
```
tia-csharp-common
```
）
打开、创建或获取
```
Project
```

按需使用

ExclusiveAccess

Transaction

（详见

tia-csharp-common

）

执行项目级或库操作；在进行任何库/项目变更前需明确授权
在正确的同步点执行保存/归档/关闭操作
释放TIA Portal会话