tia-teamcenter ยท diff
git:20260624.61b126a to git:20260806.2ea77f3
43 added, 16 removed. Audit A to A.
---
name: tia-teamcenter
description: >
- TIA Portal Teamcenter Integration operations. Use for managing Teamcenter
- storage and interacting with Teamcenter managed projects.
+ TIA Portal V21 Teamcenter Gateway operations. Use for connecting to Teamcenter,
+ searching/downloading managed projects or libraries, dataset locking, and
+ saving projects or global libraries through the installed provider APIs.
license: MIT
---
- # TIA Portal Teamcenter Integration
+ # TIA Portal Teamcenter Gateway
## Scope
- Teamcenter Integration workflows using the TIA Portal Openness API.
- Covers Teamcenter storage access and service management.
-
- ---
+ Teamcenter Gateway workflows exposed by `Siemens.Engineering.TeamcenterGateway`.
+ The V21 API is provider-based: connection, lock, search/download, and workflow
+ operations are separate services.
## Reference files
Load ONLY the reference file(s) relevant to the task.
| Reference file | Load when the task involves |
|---|---|
- | `references/v21-api-surface.md` | Comprehensive reference for `Siemens.Engineering.Teamcenter` (TeamcenterService, TeamcenterStorage). |
+ | `references/workflows-and-safety.md` | Provider acquisition, credentials, connection ownership, search/download, checkout/check-in, save workflows, cache overwrite, and remote-write safety. |
+ | `references/v21-api-surface.md` | Complete installed V21 `Siemens.Engineering.TeamcenterGateway` type and member surface. |
- ---
+ ## Installed V21 entry points
- ## Key Workflows
+ Portal-scoped providers:
- ### Teamcenter Storage
+ ```csharp
+ TeamcenterConnectionProvider connections =
+ tiaPortal.GetService<TeamcenterConnectionProvider>();
+ TcGatewayLockProvider locks =
+ tiaPortal.GetService<TcGatewayLockProvider>();
+ TcGatewaySearchAndDownloadProvider searchAndDownload =
+ tiaPortal.GetService<TcGatewaySearchAndDownloadProvider>();
+ ```
- 1. Locate the `TeamcenterService` on the Project.
- 2. Access `TeamcenterStorage` composition.
- 3. Manage storage objects and project associations.
+ The save provider belongs to the opened project or global library:
+ ```csharp
+ TcGatewayWorkflowProvider workflow =
+ project.GetService<TcGatewayWorkflowProvider>();
+ ```
+
+ Do not introduce an intermediate service or storage composition that is absent
+ from these installed entry points.
+
## Enforcement
- 1. Ensure the `TeamcenterService` is available before attempting storage operations.
- 2. Handle Teamcenter-specific exceptions for connection or permission issues.
+ 1. Require the exact endpoint, Teamcenter instance, user/group/role or SSO application identity, and expected item/revision/dataset identity.
+ 2. Keep passwords in `SecureString`; treat `TcGatewayConnectionInfo.SessionToken` as a secret and never log or serialize it.
+ 3. Require explicit remote-write authorization for checkout, check-in, checkout cancellation, overwrite download, and every save/new-item/new-revision operation.
+ 4. Treat `LocalCacheOption.Overwrite` as destructive. Use it only for an exact, pre-inventoried cache target.
+ 5. Resolve search results to exactly one expected item and revision. Never use `.First()` or `[0]` as selection logic.
+ 6. Disconnect in `finally` only when the current operation established the connection; do not terminate a caller-owned Teamcenter session.
+ 7. Checkout cancellation is not rollback and does not discard local project/library changes. Do not use it as unconditional cleanup.
+ 8. Do not claim a save, check-in, download, or disconnect succeeded without checking the returned result and/or re-reading authoritative Teamcenter state.
+
+ ## Evidence boundary
+
+ Installed V21 assemblies and XML documentation prove provider names, signatures,
+ types, and enum members. Endpoint reachability, license, credentials, permissions,
+ dataset locks, cache behavior, and remote persistence require an authorized live
+ Teamcenter Gateway test.