tia-project-general
Scope
Project and portal 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).
Reference files
Load ONLY the reference file(s) relevant to the task. Do not load all files at once.
| Reference file | Load when the task involves |
|---|---|
references/project-lifecycle.md |
Open, OpenWithUpgrade, Create, Save, SaveAs, Close, Archive, Retrieve, RetrieveWithUpgrade, delete, copy |
references/project-attributes.md |
Reading project metadata (Author, Name, Version, Path, Size, dates), history entries, used products, simulation/virtual PLC properties |
references/language-settings.md |
Project languages, active/editing/reference language, multilingual text (MultilingualText, MultilingualTextItem), CommentML on devices |
references/umac-and-auth.md |
UMAC-protected project open, UmacDelegate, Authentication event, ProjectOpenMode (Primary/Secondary), UMAC user type |
references/compile.md |
Compiling any object (PlcSoftware, HmiTarget, Device, CodeBlock, PlcBlockGroup, PlcType, etc.) via ICompilable, reading CompilerResult |
references/portal-settings.md |
TiaPortalSettingsFolder (UI language, search index), ObjectIdentifierProvider, SystemDiagnostics settings export/import, read-only project access |
For tasks spanning multiple areas, load all relevant reference files before generating code.
Execution pattern
- Create or attach to
TiaPortalinstance (seetia-csharp-common) - Open, create, or retrieve
Project - Use
ExclusiveAccess/Transactionwhere needed (seetia-csharp-common) - Perform project-level Openness operations
- Save / archive / close at the correct synchronisation point
- Dispose the TIA Portal session